[Validator] Add attributes documentation of composite constraints

alexandre-daubois · alexandre-daubois · commit ed56590eeb88 · 2021-07-22T08:37:00.000+02:00
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
@@ -39,6 +39,26 @@ entry in that array:
             protected $favoriteColors = [];
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: the code of this class requires using PHP 8.1 or higher, because of the use of nested attributes
+
+        class User
+        {
+            #[
+                Assert\All([
+                    new Assert\NotBlank,
+                    new Assert\Length(min: 5),
+                ])
+            ]
+            protected $favoriteColors = [];
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
@@ -60,6 +60,36 @@ The following constraints ensure that:
             protected $grades;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Student.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: the code of this class requires using PHP 8.1 or higher, because of the use of nested attributes
+
+        class Student
+        {
+            #[
+                Assert\AtLeastOneOf([
+                    new Assert\Regex('/#/'),
+                    new Assert\Length(min: 10),
+                ])
+            ]
+            protected $plainPassword;
+
+            #[
+                Assert\AtLeastOneOf([
+                    new Assert\Count(min: 3),
+                    new Assert\All(
+                        new Assert\GreaterThanOrEqual(5)
+                    ),
+                ])
+            ]
+            protected $grades;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
@@ -88,6 +88,38 @@ following:
             ];
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: the code of this class requires using PHP 8.1 or higher, because of the use of nested attributes
+
+        class Author
+        {
+            #[
+                Assert\Collection(
+                    fields: [
+                        'personal_email' => new Assert\Email,
+                        'short_bio' => [
+                            new Assert\NotBlank,
+                            new Assert\Length(
+                                max: 100,
+                                maxMessage: 'Your short bio is too long!'
+                            )
+                        ]
+                    ],
+                    allowMissingFields: true,
+                )
+            ]
+            protected $profileData = [
+                'personal_email' => '...',
+                'short_bio' => '...',
+            ];
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
@@ -67,6 +67,30 @@ You can validate each of these constraints sequentially to solve these issues:
             public $address;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Localization/Place.php
+        namespace App\Localization;
+
+        use App\Validator\Constraints as AcmeAssert;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: the code of this class requires using PHP 8.1 or higher, because of the use of nested attributes
+
+        class Place
+        {
+            #[
+                Assert\Sequentially([
+                    new Assert\NotNull,
+                    new Assert\Type('string'),
+                    new Assert\Length(min: 10),
+                    new Assert\Regex(Place::ADDRESS_REGEX),
+                    new AcmeAssert\Geolocalizable,
+                ])
+            ]
+            public $address;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
