Merge branch '6.2' into 6.3

* 6.2:
  Remove unneeded versionadded directives
  [HttpClient] Mention list of callbacks for `MockHttpClient`
  [Validator] Add `Cascade` constraint documentation

Author: javiereguiluz

http_client.rst

@@ -1839,6 +1839,28 @@ 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);
+
+    // ...
+
 .. tip::
 
     Instead of using the first argument, you can also set the (list of)

reference/constraints/Cascade.rst

@@ -0,0 +1,90 @@
+Cascade
+=======
+
+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>`
+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 properties of the class, including
+constraints that are set in the child classes ``BookMetadata`` and
+``Author``:
+
+.. configuration-block::
+
+    .. 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

reference/constraints/map.rst.inc

@@ -97,6 +97,7 @@ Other Constraints
 * :doc:`When </reference/constraints/When>`
 * :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>`