use named arguments to configure validation constraints

Author: xabbuh

reference/constraints/Collection.rst

@@ -196,13 +196,13 @@ you can do the following:
         {
             #[Assert\Collection(
                 fields: [
-                    'personal_email' => new Assert\Required([
+                    'personal_email' => new Assert\Required(constraints: [
                         new Assert\NotBlank,
                         new Assert\Email,
                     ]),
-                    'alternate_email' => new Assert\Optional(
+                    'alternate_email' => new Assert\Optional(constraints: [
                         new Assert\Email
-                    ),
+                    ]),
                 ],
             )]
             protected array $profileData = ['personal_email' => 'email@example.com'];
@@ -218,11 +218,13 @@ you can do the following:
                         fields:
                             personal_email:
                                 - Required:
-                                    - NotBlank: ~
-                                    - Email: ~
+                                    constraints:
+                                        - NotBlank: ~
+                                        - Email: ~
                             alternate_email:
                                 - Optional:
-                                    - Email: ~
+                                    constraints:
+                                        - Email: ~
 
     .. code-block:: xml
 
@@ -238,13 +240,17 @@ you can do the following:
                         <option name="fields">
                             <value key="personal_email">
                                 <constraint name="Required">
-                                    <constraint name="NotBlank"/>
-                                    <constraint name="Email"/>
+                                    <option name="constraints">
+                                        <constraint name="NotBlank"/>
+                                        <constraint name="Email"/>
+                                    </option>
                                 </constraint>
                             </value>
                             <value key="alternate_email">
                                 <constraint name="Optional">
-                                    <constraint name="Email"/>
+                                    <option name="constraints">
+                                        <constraint name="Email"/>
+                                    </option>
                                 </constraint>
                             </value>
                         </option>
@@ -269,11 +275,11 @@ you can do the following:
             {
                 $metadata->addPropertyConstraint('profileData', new Assert\Collection(
                     fields: [
-                        'personal_email'  => new Assert\Required([
+                        'personal_email'  => new Assert\Required(constraints: [
                             new Assert\NotBlank(),
                             new Assert\Email(),
                         ]),
-                        'alternate_email' => new Assert\Optional(new Assert\Email()),
+                        'alternate_email' => new Assert\Optional(constraints: [new Assert\Email()]),
                     ],
                 ));
             }

validation/raw_values.rst

@@ -67,22 +67,22 @@ Validation of arrays is possible using the ``Collection`` constraint::
 
     $groups = new Assert\GroupSequence(['Default', 'custom']);
 
-    $constraint = new Assert\Collection([
+    $constraint = new Assert\Collection(fields: [
         // the keys correspond to the keys in the input array
-        'name' => new Assert\Collection([
-            'first_name' => new Assert\Length(['min' => 101]),
-            'last_name' => new Assert\Length(['min' => 1]),
+        'name' => new Assert\Collection(fields: [
+            'first_name' => new Assert\Length(min: 101),
+            'last_name' => new Assert\Length(min: 1),
         ]),
         'email' => new Assert\Email(),
-        'simple' => new Assert\Length(['min' => 102]),
+        'simple' => new Assert\Length(min: 102),
         'eye_color' => new Assert\Choice(choices: [3, 4]),
         'file' => new Assert\File(),
-        'password' => new Assert\Length(['min' => 60]),
-        'tags' => new Assert\Optional([
-            new Assert\Type('array'),
-            new Assert\Count(['min' => 1]),
+        'password' => new Assert\Length(min: 60),
+        'tags' => new Assert\Optional(constraints: [
+            new Assert\Type(type: 'array'),
+            new Assert\Count(min: 1),
             new Assert\All([
-                new Assert\Collection([
+                new Assert\Collection(constraints: [
                     'slug' => [
                         new Assert\NotBlank(),
                         new Assert\Type(['type' => 'string']),
@@ -91,7 +91,7 @@ Validation of arrays is possible using the ``Collection`` constraint::
                         new Assert\NotBlank(),
                     ],
                 ]),
-                new CustomUniqueTagValidator(['groups' => 'custom']),
+                new CustomUniqueTagValidator(groups: ['custom']),
             ]),
         ]),
     ]);