Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion bundles/best_practices.rst
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 allows you to 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
2 changes: 1 addition & 1 deletion bundles/configuration.rst
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 allows you to import the
configuration definition from one or more files::

// src/AcmeSocialBundle.php
Expand Down
4 changes: 2 additions & 2 deletions components/asset.rst
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 allows you to 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 Down Expand 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 allows you to 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
2 changes: 1 addition & 1 deletion components/browser_kit.rst
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 allows you to send additional information like headers when clicking
on a link::

use Acme\Client;
Expand Down
2 changes: 1 addition & 1 deletion components/clock.rst
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
allows you to use any `PSR-20`_ compatible implementation as a global clock in your
application::

use Symfony\Component\Clock\Clock;
Expand Down
2 changes: 1 addition & 1 deletion components/event_dispatcher.rst
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
allows you 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``::
Expand Down
2 changes: 1 addition & 1 deletion components/http_foundation.rst
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` allows you to
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
2 changes: 1 addition & 1 deletion components/http_kernel.rst
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 allows you 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``.
Expand Down
2 changes: 1 addition & 1 deletion components/mime.rst
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 allows you to guess the MIME type of any given file::

use Symfony\Component\Mime\MimeTypes;

Expand Down
2 changes: 1 addition & 1 deletion components/phpunit_bridge.rst
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 allows you to 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
2 changes: 1 addition & 1 deletion components/property_access.rst
Original file line number Diff line number Diff line change
Expand Up @@ -420,7 +420,7 @@ see `Enable other Features`_::
Writing to Array Properties
~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

// ...
Expand Down
4 changes: 2 additions & 2 deletions components/string.rst
Original file line number Diff line number Diff line change
Expand Up @@ -440,7 +440,7 @@ different sequences of code points represent the same character. For example,
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 allows you to pick the normalization mode::

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

use Symfony\Component\String\LazyString;

Expand Down
4 changes: 2 additions & 2 deletions components/var_exporter.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ The VarExporter Component
=========================

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 allows you to instantiate and populate objects without
calling their constructors.

Installation
Expand Down Expand Up @@ -231,7 +231,7 @@ initialized::
``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 allows you to
convert non-lazy classes to lazy ones::

namespace App\Hash;
Expand Down
2 changes: 1 addition & 1 deletion configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -478,12 +478,12 @@
webpack_encore:
strict_mode: false

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

Check failure on line 486 in configuration.rst

View workflow job for this annotation

GitHub Actions / Code Blocks

[Cache Warmup] In FileLoader.php line 182: The file "/home/runner/work/symfony-docs/symfony-docs/_sf_app/config/packag es/webpack_encore.yaml" does not contain valid YAML: Duplicate key "when@pr od" detected at line 20 (near " # ...") in /home/runner/work/symfony -docs/symfony-docs/_sf_app/config/packages/webpack_encore.yaml (which is be ing imported from "/home/runner/work/symfony-docs/symfony-docs/_sf_app/src/ Kernel.php"). In YamlFileLoader.php line 781: The file "/home/runner/work/symfony-docs/symfony-docs/_sf_app/config/packag es/webpack_encore.yaml" does not contain valid YAML: Duplicate key "when@pr od" detected at line 20 (near " # ..."). In Parser.php line 337: Duplicate key "when@prod" detected at line 20 (near " # ..."). 2025-11-22T18:09:35+00:00 [info] User Deprecated: Method "Symfony\Component\HttpKernel\Bundle\Bundle::build()" might add "void" as a native return type declaration in the future. Do the same in child class "Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle" now to avoid errors or add an explicit @return annotation to suppress this message.

.. code-block:: xml

Expand Down
10 changes: 5 additions & 5 deletions console.rst
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@ 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
``setDescription()`` method allows you to get the command description without
instantiating its class. This makes the ``php bin/console list`` command run
much faster.

Expand Down Expand Up @@ -620,13 +620,13 @@ 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
When a command is running, many events are dispatched, one of them allows you to
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 allows you 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:

Expand Down Expand Up @@ -675,7 +675,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 ``DebugFormatterHelper``
* :doc:`/components/console/helpers/cursor`: allows to manipulate the cursor in the terminal
* :doc:`/components/console/helpers/processhelper`: allows you to run processes using ``DebugFormatterHelper``
* :doc:`/components/console/helpers/cursor`: allows you to manipulate the cursor in the terminal

.. _`exit status`: https://en.wikipedia.org/wiki/Exit_status
2 changes: 1 addition & 1 deletion console/calling_commands.rst
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ method)::

.. note::

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

Also, using ``$this->getApplication()->doRun()`` instead of
Expand Down
2 changes: 1 addition & 1 deletion console/input.rst
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ how many times in a row the message should be printed::
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 allow you to pass values)
1
)
;
Expand Down
2 changes: 1 addition & 1 deletion console/style.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ unnecessarily.

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 allow you to create *semantic* commands and forget about their styling.

Basic Usage
-----------
Expand Down
4 changes: 2 additions & 2 deletions controller/value_resolver.rst
Original file line number Diff line number Diff line change
Expand Up @@ -231,7 +231,7 @@ 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`` will be called before the
``DefaultValueResolver`` because its priority is higher. This allows to write e.g.
``DefaultValueResolver`` because its priority is higher. This allows you to write e.g.
``SessionInterface $session = null`` to get the session if there is one, or ``null``
if there is none.

Expand Down Expand Up @@ -276,7 +276,7 @@ You can target a resolver by passing its name as ``ValueResolver``'s first argum
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 allows you to disable the
EntityValueResolver for a specific controller <doctrine-entity-value-resolver>`.
Yes, ``MapEntity`` extends ``ValueResolver``!

Expand Down
2 changes: 1 addition & 1 deletion form/bootstrap5.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
Bootstrap 5 allows you to render checkboxes as `switches`_. You can enable this
feature on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch``
class to the label:

Expand Down
4 changes: 2 additions & 2 deletions frontend/encore/advanced-config.rst
Original file line number Diff line number Diff line change
Expand Up @@ -317,7 +317,7 @@ The following loaders are configurable with ``configureLoaderRule()``:
Configuring Aliases When Importing or Requiring Modules
-------------------------------------------------------

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

Expand All @@ -338,7 +338,7 @@ With the above config, you could now import certain modules more concisely:
Excluding Some Dependencies from Output Bundles
-----------------------------------------------

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

Expand Down
6 changes: 3 additions & 3 deletions http_client.rst
Original file line number Diff line number Diff line change
Expand Up @@ -743,7 +743,7 @@ 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
Symfony's HttpClient allows you to 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
Expand Down Expand Up @@ -1053,7 +1053,7 @@ is installed and enabled, and will fall back as explained above.
Configuring CurlHttpClient Options
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

Expand Down
2 changes: 1 addition & 1 deletion mailer.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1700,7 +1700,7 @@ MessageEvent

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

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

use Symfony\Component\EventDispatcher\EventSubscriberInterface;
Expand Down
2 changes: 1 addition & 1 deletion mercure.rst
Original file line number Diff line number Diff line change
Expand Up @@ -622,7 +622,7 @@ hypermedia API, and automatic update broadcasting through the Mercure hub::
}

As showcased `in this recording`_, the API Platform Client Generator also
allows to scaffold complete React and React Native applications from this API.
allows you to 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
Expand Down
10 changes: 5 additions & 5 deletions reference/configuration/framework.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2663,7 +2663,7 @@ paths

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

This option allows to define an array of paths where the component will look
This option allows you 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
Expand All @@ -2676,7 +2676,7 @@ default_path

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

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

.. _reference-translator-providers:
Expand Down Expand Up @@ -2878,7 +2878,7 @@ endpoint

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
allows you 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.

Expand Down Expand Up @@ -2919,7 +2919,7 @@ paths

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

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

.. configuration-block::
Expand Down Expand Up @@ -3085,7 +3085,7 @@ paths

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

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

default_context
Expand Down
2 changes: 1 addition & 1 deletion reference/configuration/security.rst
Original file line number Diff line number Diff line change
Expand Up @@ -499,7 +499,7 @@ By default, when users log out from any firewall, their sessions are invalidated
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 allows you 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.

Expand Down
2 changes: 1 addition & 1 deletion reference/configuration/twig.rst
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ 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
This option allows you to define the Symfony service which will be used to determine
the default escaping applied to the template.

autoescape_service_method
Expand Down
4 changes: 2 additions & 2 deletions reference/constraints/DisableAutoMapping.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
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 allows you to disable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
on a class or a property. Automapping allows you to 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.
Expand Down
4 changes: 2 additions & 2 deletions reference/constraints/EnableAutoMapping.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
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 allows you to enable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
on a class or a property. Automapping allows you to 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.
Expand Down
Loading
Loading