Merge branch 'symfony:6.4' into Chris53897-patch-1

Author: Chris53897

_images/components/var_dumper/10-uninitialized.png

@@ -224,11 +224,12 @@ 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.

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

bundles/best_practices.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
 ~~~~~~~~~~~~~~~~
 

components/browser_kit.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,

components/config/resources.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

components/console/events.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

components/dom_crawler.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

components/http_kernel.rst

@@ -179,6 +179,41 @@ You may convert codes between two-letter alpha2 and three-letter alpha3 codes::
 
     $alpha2Code = Countries::getAlpha2Code($alpha3Code);
 
+Numeric Country Codes
+~~~~~~~~~~~~~~~~~~~~~
+
+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;
+
+    \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 +470,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

components/intl.rst

@@ -470,16 +470,16 @@ avoid stalled locks::
 
 The ``MongoDbStore`` takes the following ``$options`` (depending on the first parameter type):
 
-=============  ================================================================================================
-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`_
-=============  ================================================================================================
+==============  ================================================================================================
+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