Nov 22, 2025
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst

 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
 ``config/doctrine/``. This allowsyouto override that mapping using the
 :doc:`standard Symfony mechanism to override bundle parts </bundles/override>`.
 This is not possible when using attributes to define the mapping.

diff --git a/bundles/configuration.rst b/bundles/configuration.rst

 .. tip::

    The ``AbstractBundle::configure()`` method also allows to import the
    The ``AbstractBundle::configure()`` method also allowsyouto import the
    configuration definition from one or more files::

        // src/AcmeSocialBundle.php
diff --git a/components/asset.rst b/components/asset.rst
  versioning strategies for each package;
 * **Moving assets' location** is cumbersome and error-prone: it requires you to
  carefully update the URLs of all assets included in all templates. The Asset
  component allows to move assets effortlessly just by changing the base path
  component allowsyouto move assets effortlessly just by changing the base path
  value associated with the package of assets;
 * **It's nearly impossible to use multiple CDNs**: this technique requires
  you to change the URL of the asset randomly for each request. The Asset component

    $packages = new Packages($defaultPackage, $namedPackages);

 The ``Packages`` class allows to define a default package, which will be applied
 The ``Packages`` class allowsyouto define a default package, which will be applied
 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
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
 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
 parameter allowsyouto send additional information like headers when clicking
 on a link::

    use Acme\Client;
diff --git a/components/clock.rst b/components/clock.rst
 -----

 The :class:`Symfony\\Component\\Clock\\Clock` class returns the current time and
 allows to use any `PSR-20`_ compatible implementation as a global clock in your
 allowsyouto use any `PSR-20`_ compatible implementation as a global clock in your
 application::

    use Symfony\Component\Clock\Clock;
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
            ->addTag('kernel.event_subscriber');

    ``RegisterListenersPass`` resolves aliased class names which for instance
    allows to refer to an event via the fully qualified class name (FQCN) of the
    allowsyouto 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``::
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
    The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class was
    introduced in Symfony 6.3.

 The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allows to
 The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allowsyouto
 stream large JSON responses using PHP generators to keep the used resources low.

 The class constructor expects an array which represents the JSON structure and
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
 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
 This allowsyouto 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``.
diff --git a/components/mime.rst b/components/mime.rst
 Guessing the MIME Type
 ~~~~~~~~~~~~~~~~~~~~~~

 Another useful utility allows to guess the MIME type of any given file::
 Another useful utility allowsyouto guess the MIME type of any given file::

    use Symfony\Component\Mime\MimeTypes;

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
  #. 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
 * It allowsyouto create tests that are compatible with multiple PHPUnit versions
  (because it provides polyfills for missing methods, namespaced aliases for
  non-namespaced classes, etc.).

diff --git a/components/property_access.rst b/components/property_access.rst
 Writing to Array Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

 The ``PropertyAccessor`` class allows to update the content of arrays stored in
 The ``PropertyAccessor`` class allowsyouto update the content of arrays stored in
 properties through *adder* and *remover* methods::

    // ...
diff --git a/components/string.rst b/components/string.rst
 the Swedish letter ``å`` can be a single code point (``U+00E5`` = *"latin small
 letter A with ring above"*) or a sequence of two code points (``U+0061`` =
 *"latin small letter A"* + ``U+030A`` = *"combining ring above"*). The
 ``normalize()`` method allows to pick the normalization mode::
 ``normalize()`` method allowsyouto pick the normalization mode::

    // these encode the letter as a single code point: U+00E5
    u('å')->normalize(UnicodeString::NFC);
 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::
 class that allowsyouto store a string whose value is only generated when you need it::

    use Symfony\Component\String\LazyString;

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
 =========================

    The VarExporter component exports any serializable PHP data structure to
    plain PHP code and allows to instantiate and populate objects without
    plain PHP code and allowsyouto instantiate and populate objects without
    calling their constructors.

 Installation
    ``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
 :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait` also allowsyouto
 convert non-lazy classes to lazy ones::

    namespace App\Hash;
diff --git a/configuration.rst b/configuration.rst
                webpack_encore:
                    strict_mode: false

            # YAML syntax allows to reuse contents using "anchors" (&some_name) and "aliases" (*some_name).
            # YAML syntax allowsyouto 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:
                    # ...
            when@test: *webpack_prod

        .. code-block:: xml

diff --git a/console.rst b/console.rst
 .. tip::

    Defining the ``$defaultDescription`` static property instead of using the
    ``setDescription()`` method allows to get the command description without
    ``setDescription()`` method allowsyouto get the command description without
    instantiating its class. This makes the ``php bin/console list`` command run
    much faster.

 Using Events And Handling Signals
 ---------------------------------

 When a command is running, many events are dispatched, one of them allows to
 When a command is running, many events are dispatched, one of them allowsyouto
 react to signals, read more in :doc:`this section </components/console/events>`.

 Profiling Commands
 ------------------

 Symfony allows to profile the execution of any command, including yours. First,
 Symfony allowsyouto 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:

 * :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 ``DebugFormatterHelper``
 * :doc:`/components/console/helpers/cursor`: allows to manipulate the cursor in the terminal
 * :doc:`/components/console/helpers/processhelper`: allowsyouto run processes using ``DebugFormatterHelper``
 * :doc:`/components/console/helpers/cursor`: allowsyouto 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

 .. note::

    Using ``doRun()`` instead of ``run()`` prevents autoexiting and allows to
    Using ``doRun()`` instead of ``run()`` prevents autoexiting and allowsyouto
    return the exit code instead.

    Also, using ``$this->getApplication()->doRun()`` instead of
diff --git a/console/input.rst b/console/input.rst
            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)
            // the default value of the option (for those which allowyouto pass values)
            1
        )
    ;
diff --git a/console/style.rst b/console/style.rst

 In order to reduce that boilerplate code, Symfony commands can optionally use the
 **Symfony Style Guide**. These styles are implemented as a set of helper methods
 which allow to create *semantic* commands and forget about their styling.
 which allowyouto create *semantic* commands and forget about their styling.

 Basic Usage
 -----------
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
 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`` will be called before the
 ``DefaultValueResolver`` because its priority is higher. This allows to write e.g.
 ``DefaultValueResolver`` because its priority is higher. This allowsyouto write e.g.
 ``SessionInterface $session = null`` to get the session if there is one, or ``null``
 if there is none.

 For convenience, built-in resolvers' name are their FQCN.

 A targeted resolver can also be disabled by passing ``ValueResolver``'s ``$disabled``
 argument to ``true``; this is how :ref:`MapEntity allows to disable the
 argument to ``true``; this is how :ref:`MapEntity allowsyouto disable the
 EntityValueResolver for a specific controller <doctrine-entity-value-resolver>`.
 Yes, ``MapEntity`` extends ``ValueResolver``!

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
 Switches
 ~~~~~~~~

 Bootstrap 5 allows to render checkboxes as `switches`_. You can enable this
 Bootstrap 5 allowsyouto render checkboxes as `switches`_. You can enable this
 feature on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch``
 class to the label:

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
 Configuring Aliases When Importing or Requiring Modules
 -------------------------------------------------------

 The `Webpack resolve.alias option`_ allows to create aliases to simplify the
 The `Webpack resolve.alias option`_ allowsyouto 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:

 Excluding Some Dependencies from Output Bundles
 -----------------------------------------------

 The `Webpack externals option`_ allows to prevent bundling of certain imported
 The `Webpack externals option`_ allowsyouto 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.

diff --git a/http_client.rst b/http_client.rst
 ~~~~~~~~~~~~~~~~~~~~~

 Sometimes, requests fail because of network issues or temporary server errors.
 Symfony's HttpClient allows to retry failed requests automatically using the
 Symfony's HttpClient allowsyouto retry failed requests automatically using the
 :ref:`retry_failed option <reference-http-client-retry-failed>`.

 By default, failed requests are retried up to 3 times, with an exponential delay
 Configuring CurlHttpClient Options
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 PHP allows to configure lots of `cURL options`_ via the :phpfunction:`curl_setopt`
 PHP allowsyouto configure lots of `cURL options`_ via the :phpfunction:`curl_setopt`
 function. In order to make the component more portable when not using cURL, the
 :class:`Symfony\\Component\\HttpClient\\CurlHttpClient` only uses some of those
 options (and they are ignored in the rest of clients).
    // 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
    // the special "pause_handler" info item is a callable that allowsyouto delay the request
    // for a given number of seconds; this allows you to delay retries, throttle streams, etc.
    $response->getInfo('pause_handler')(2);

diff --git a/mailer.rst b/mailer.rst

 **Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent`

 ``MessageEvent`` allows to change the Mailer message and the envelope before
 ``MessageEvent`` allowsyouto change the Mailer message and the envelope before
 the email is sent::

    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
diff --git a/mercure.rst b/mercure.rst
    }

 As showcased `in this recording`_, the API Platform Client Generator also
 allows to scaffold complete React and React Native applications from this API.
 allowsyouto scaffold complete React and React Native applications from this API.
 These applications will render the content of Mercure updates in real-time.

 Checkout `the dedicated API Platform documentation`_ to learn more about
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst

 **type**: ``array`` **default**: ``[]``

 This option allows to define an array of paths where the component will look
 This option allowsyouto 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

 **type**: ``string`` **default**: ``%kernel.project_dir%/translations``

 This option allows to define the path where the application translations files
 This option allowsyouto define the path where the application translations files
 are stored.

 .. _reference-translator-providers:

 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
 allowsyouto 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.


 **type**: ``array`` **default**: ``['config/validation/']``

 This option allows to define an array of paths with files or directories where
 This option allowsyouto define an array of paths with files or directories where
 the component will look for additional validation files:

 .. configuration-block::

 **type**: ``array`` **default**: ``[]``

 This option allows to define an array of paths with files or directories where
 This option allowsyouto define an array of paths with files or directories where
 the component will look for additional serialization files.

 default_context
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
 This means that logging out from one firewall automatically logs them out from
 all the other firewalls.

 The ``invalidate_session`` option allows to redefine this behavior. Set this
 The ``invalidate_session`` option allowsyouto 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.

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
 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
 This option allowsyouto define the Symfony service which will be used to determine
 the default escaping applied to the template.

 autoescape_service_method
diff --git a/reference/constraints/DisableAutoMapping.rst b/reference/constraints/DisableAutoMapping.rst
 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
 This constraint allowsyouto disable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
 on a class or a property. Automapping allowsyouto determine validation rules based
 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
 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
 This constraint allowsyouto enable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
 on a class or a property. Automapping allowsyouto determine validation rules based
 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.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -169,7 +169,7 @@ 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
		``config/doctrine/``. This allows to override that mapping using the
		``config/doctrine/``. This allowsyouto override that mapping using the
		:doc:`standard Symfony mechanism to override bundle parts </bundles/override>`.
		This is not possible when using attributes to define the mapping.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -111,7 +111,7 @@ class, you can add all the logic related to processing the configuration in that

		.. tip::

		The ``AbstractBundle::configure()`` method also allows to import the
		The ``AbstractBundle::configure()`` method also allowsyouto import the
		configuration definition from one or more files::

		// src/AcmeSocialBundle.php
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -28,7 +28,7 @@ simple. Hardcoding URLs can be a disadvantage because:
		versioning strategies for each package;
		* Moving assets' location is cumbersome and error-prone: it requires you to
		carefully update the URLs of all assets included in all templates. The Asset
		component allows to move assets effortlessly just by changing the base path
		component allowsyouto move assets effortlessly just by changing the base path
		value associated with the package of assets;
		* It's nearly impossible to use multiple CDNs: this technique requires
		you to change the URL of the asset randomly for each request. The Asset component
Expand DownExpand Up		@@ -382,7 +382,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
		The ``Packages`` class allowsyouto define a default package, which will be applied
		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
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -121,7 +121,7 @@ provides access to the link properties (e.g. ``$link->getMethod()``,
		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
		parameter allowsyouto send additional information like headers when clicking
		on a link::

		use Acme\Client;
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -36,7 +36,7 @@ Usage
		-----

		The :class:`Symfony\\Component\\Clock\\Clock` class returns the current time and
		allows to use any `PSR-20`_ compatible implementation as a global clock in your
		allowsyouto use any `PSR-20`_ compatible implementation as a global clock in your
		application::

		use Symfony\Component\Clock\Clock;
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -193,7 +193,7 @@ determine which instance is passed.
		->addTag('kernel.event_subscriber');

		``RegisterListenersPass`` resolves aliased class names which for instance
		allows to refer to an event via the fully qualified class name (FQCN) of the
		allowsyouto 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``::
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -726,7 +726,7 @@ Streaming a JSON Response
		The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class was
		introduced in Symfony 6.3.

		The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allows to
		The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allowsyouto
		stream large JSON responses using PHP generators to keep the used resources low.

		The class constructor expects an array which represents the JSON structure and
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -747,7 +747,7 @@ 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
		This allowsyouto 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``.
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -246,7 +246,7 @@ indicates its priority, so the first returned extension is the preferred one.
		Guessing the MIME Type
		~~~~~~~~~~~~~~~~~~~~~~

		Another useful utility allows to guess the MIME type of any given file::
		Another useful utility allowsyouto guess the MIME type of any given file::

		use Symfony\Component\Mime\MimeTypes;

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -25,7 +25,7 @@ It comes with the following features:
		#. 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
		* It allowsyouto create tests that are compatible with multiple PHPUnit versions
		(because it provides polyfills for missing methods, namespaced aliases for
		non-namespaced classes, etc.).

Expand Down