minor #9837 Added a missing validator example (javiereguiluz)

javiereguiluz · javiereguiluz · commit 4f119ad735b6 · 2018-05-28T13:14:08.000+02:00
This PR was merged into the 2.8 branch. Discussion ---------- Added a missing validator example This fixes #6738. @xabbuh is this what you had in mind when you asked for an example in this section? Thanks! Commits ------- fd75230 Added a missing validator example
diff --git a/components/validator/metadata.rst b/components/validator/metadata.rst
@@ -70,3 +70,28 @@ Classes
 Some constraints allow to validate the entire object. For example, the
 :doc:`Callback </reference/constraints/Callback>` constraint is a generic
 constraint that's applied to the class itself.
+
+Suppose that the class defines a ``validate()`` method to hold its custom
+validation logic::
+
+        // ...
+        use Symfony\Component\Validator\Context\ExecutionContextInterface;
+
+        public function validate(ExecutionContextInterface $context)
+        {
+            // ...
+        }
+
+Then, add the Validator component configuration to the class::
+
+    // ...
+    use Symfony\Component\Validator\Mapping\ClassMetadata;
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    class Author
+    {
+        public static function loadValidatorMetadata(ClassMetadata $metadata)
+        {
+            $metadata->addConstraint(new Assert\Callback('validate'));
+        }
+    }
