Merge branch '5.3' into 5.4

* 5.3:
  Remove PoEditor Provider
  Adding opcache.preload_user
  Fixing code sample
  Minor rewording
  Adding FQCN
  Minor rewording

Author: javiereguiluz

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

performance.rst

@@ -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:
 
@@ -115,6 +115,9 @@ 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
 
 If this file is missing, run this command to reinstall the Symfony Flex recipe:
 ``composer recipes:install symfony/framework-bundle --force -v``.

reference/configuration/framework.rst

@@ -1645,7 +1645,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)

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

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