minor #15064 [Validator] Add PHP Attributes to validation groups (wkania)

This PR was merged into the 5.2 branch.

Discussion
----------

[Validator] Add PHP Attributes to validation groups

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/releases for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `5.x` for features of unreleased versions).

-->

Commits
-------

8a2e8d7 [Validator] Add PHP Attributes to validation groups

Author: javiereguiluz

validation/groups.rst

@@ -42,6 +42,27 @@ user registers and when a user updates their contact information later:
             private $city;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Security\Core\User\UserInterface;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User implements UserInterface
+        {
+            #[Assert\Email(groups: ['registration'])]
+            private $email;
+
+            #[Assert\NotBlank(groups: ['registration'])]
+            #[Assert\Length(min: 7, groups: ['registration'])]
+            private $password;
+
+            #[Assert\Length(min: 2)]
+            private $city;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

validation/sequence_provider.rst

@@ -47,6 +47,33 @@ username and the password are different only if all other validation passes
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Security\Core\User\UserInterface;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\GroupSequence(['User', 'Strict'])]
+        class User implements UserInterface
+        {
+            #[Assert\NotBlank]
+            private $username;
+
+            #[Assert\NotBlank]
+            private $password;
+
+            #[Assert\IsTrue(
+                message: 'The password cannot match your username',
+                groups: ['Strict'],
+            )]
+            public function isPasswordSafe()
+            {
+                return ($this->username !== $this->password);
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -151,7 +178,7 @@ You can also define a group sequence in the ``validation_groups`` form option::
 
     // src/Form/MyType.php
     namespace App\Form;
-    
+
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\OptionsResolver\OptionsResolver;
     use Symfony\Component\Validator\Constraints\GroupSequence;
@@ -204,6 +231,27 @@ entity and a new constraint group called ``Premium``:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NotBlank]
+            private $name;
+
+            #[Assert\CardScheme(
+                schemes: [Assert\CardScheme::VISA],
+                groups: ['Premium'],
+            )]
+            private $creditCard;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -263,7 +311,7 @@ entity and a new constraint group called ``Premium``:
             {
                 $metadata->addPropertyConstraint('name', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('creditCard', new Assert\CardScheme([
-                    'schemes' => ['VISA'],
+                    'schemes' => [Assert\CardScheme::VISA],
                     'groups'  => ['Premium'],
                 ]));
             }
@@ -319,6 +367,19 @@ provides a sequence of groups to be validated:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        // ...
+
+        #[Assert\GroupSequenceProvider]
+        class User implements GroupSequenceProviderInterface
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml