symfony · weaverryan · Jan 3, 2013 · Dec 31, 2012 · Dec 31, 2012 · Dec 31, 2012
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
@@ -34,21 +34,21 @@ entry in that array:
 
     .. code-block:: php-annotations
 
-       // src/Acme/UserBundle/Entity/User.php
-       namespace Acme\UserBundle\Entity;
-
-       use Symfony\Component\Validator\Constraints as Assert;
-
-       class User
-       {
-           /**
-            * @Assert\All({
-            *     @Assert\NotBlank
-            *     @Assert\MinLength(5),
-            * })
-            */
-            protected $favoriteColors = array();
-       }
+        // src/Acme/UserBundle/Entity/User.php
+        namespace Acme\UserBundle\Entity;
+        
+        use Symfony\Component\Validator\Constraints as Assert;
+  
+        class User
+        {
+            /**
+             * @Assert\All({
+             *     @Assert\NotBlank
+             *     @Assert\MinLength(5),
+             * })
+             */
+             protected $favoriteColors = array();
+        }
 
     .. code-block:: xml
 
@@ -58,14 +58,35 @@ entry in that array:
                 <constraint name="All">
                     <option name="constraints">
                         <constraint name="NotBlank" />
-                        <constraint name="Length">
-                            <option name="min">5</option>
+                        <constraint name="MinLength">
+                            <option name="limit">5</option>
                         </constraint>
                     </option>
                 </constraint>
             </property>
         </class>
 
+    .. code-block:: php
+
+        // src/Acme/UserBundle/Enttiy/User.php
+        namespace Acme\UserBundle\Entity;
+
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('favoriteColors', new Assert\All(array(
+                    'constraints' => array(
+                        new Assert\NotBlank(),
+                        new Assert\MinLength(array('limit' => 5)),
+                    ),
+                )));
+            }
+        }
+
 Now, each entry in the ``favoriteColors`` array will be validated to not
 be blank and to be at least 5 characters long.
 

diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
@@ -26,13 +26,17 @@ of an ``Author`` class were blank, you could do the following:
 
     .. code-block:: yaml
 
-        properties:
-            firstName:
-                - Blank: ~
+        # src/BlogBundle/Resources/config/validation.yml
+        Acme\BlogBundle\Entity\Author:
+            properties:
+                firstName:
+                    - Blank: ~
 
     .. code-block:: php-annotations
 
         // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
@@ -52,6 +56,22 @@ of an ``Author`` class were blank, you could do the following:
             </property>
         </class>
 
+    .. code-block:: php
+
+        // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('firstName', new Assetc\Blank());
+            }
+        }
+
 Options
 -------
 

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
@@ -43,6 +43,8 @@ Setup
     .. code-block:: php-annotations
 
         // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
         use Symfony\Component\Validator\Constraints as Assert;
 
         /**
@@ -63,6 +65,24 @@ Setup
             </constraint>
         </class>
 
+    .. code-block:: php
+
+        // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
+        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(array(
+                    'methods' => array('isAuthorValid'),
+                )));
+            }
+        }
+
 The Callback Method
 -------------------
 

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
@@ -64,6 +64,8 @@ If your valid choice list is simple, you can pass them in directly via the
     .. code-block:: php-annotations
 
         // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
@@ -77,16 +79,18 @@ If your valid choice list is simple, you can pass them in directly via the
     .. code-block:: php
 
         // src/Acme/BlogBundle/EntityAuthor.php
+        namespace Acme\BlogBundle\Entity;
+
         use Symfony\Component\Validator\Mapping\ClassMetadata;
-        use Symfony\Component\Validator\Constraints\Choice;
+        use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
         {
             protected $gender;
 
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('gender', new Choice(array(
+                $metadata->addPropertyConstraint('gender', new Assert\Choice(array(
                     'choices' => array('male', 'female'),
                     'message' => 'Choose a valid gender',
                 )));
@@ -280,4 +284,4 @@ strict
 
 If true, the validator will also check the type of the input value. Specifically,
 this value is passed to as the third argument to the PHP :phpfunction:`in_array` method
-when checking to see if a value is in the valid choices array.
+when checking to see if a value is in the valid choices array.
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
@@ -53,21 +53,25 @@ blank but is no longer than 100 characters in length, you would do the following
 
     .. code-block:: yaml
 
-        properties:
-            profileData:
-                - Collection:
-                    fields:
-                        personal_email: Email
-                        short_bio:
-                            - NotBlank
-                            - MaxLength:
-                                limit:   100
-                                message: Your short bio is too long!
-                    allowMissingFields: true
+        # src/BlogBundle/Resources/config/validation.yml
+        Acme\BlogBundle\Entity\Author:
+            properties:
+                profileData:
+                    - Collection:
+                        fields:
+                            personal_email: Email
+                            short_bio:
+                                - NotBlank
+                                - MaxLength:
+                                    limit:   100
+                                    message: Your short bio is too long!
+                        allowMissingFields: true
 
     .. code-block:: php-annotations
 
         // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
@@ -119,21 +123,21 @@ blank but is no longer than 100 characters in length, you would do the following
     .. code-block:: php
 
         // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
         use Symfony\Component\Validator\Mapping\ClassMetadata;
-        use Symfony\Component\Validator\Constraints\Collection;
-        use Symfony\Component\Validator\Constraints\Email;
-        use Symfony\Component\Validator\Constraints\MaxLength;
+        use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
         {
             private $options = array();
 
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('profileData', new Collection(array(
+                $metadata->addPropertyConstraint('profileData', new Assert\Collection(array(
                     'fields' => array(
-                        'personal_email' => new Email(),
-                        'lastName' => array(new NotBlank(), new MaxLength(100)),
+                        'personal_email' => new Assert\Email(),
+                        'lastName' => array(new Assert\NotBlank(), new Assert\MaxLength(100)),
                     ),
                     'allowMissingFields' => true,
                 )));

diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
@@ -28,18 +28,18 @@ Basic Usage
 
     .. code-block:: php-annotations
 
-       // src/Acme/UserBundle/Entity/User.php
-       namespace Acme\UserBundle\Entity;
-       
-       use Symfony\Component\Validator\Constraints as Assert;
-
-       class User
-       {
-           /**
-            * @Assert\Country
-            */
-            protected $country;
-       }
+        // src/Acme/UserBundle/Entity/User.php
+        namespace Acme\UserBundle\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            /**
+             * @Assert\Country
+             */
+             protected $country;
+        }
 
     .. code-block:: xml
 
@@ -50,6 +50,22 @@ Basic Usage
             </property>
         </class>
 
+    .. code-block:: php
+
+        // src/Acme/UserBundle/Entity/User.php
+        namespace Acme\UserBundle\Entity;
+
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            public static function loadValidationMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('country', new Assert\Country());
+            }
+        }
+
 Options
 -------
 

diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
@@ -31,6 +31,8 @@ Basic Usage
     .. code-block:: php-annotations
 
         // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
@@ -50,6 +52,22 @@ Basic Usage
             </property>
         </class>
 
+    .. code-block:: php
+
+        // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('birthday', new Assert\Date());
+            }
+        }
+
 Options
 -------
 

diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
@@ -52,6 +52,22 @@ Basic Usage
             </property>
         </class>
 
+    .. code-block:: php
+
+        // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('createdAt', new Assert\DataTime());
+            }
+        }
+
 Options
 -------
 

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
@@ -65,6 +65,25 @@ Basic Usage
              protected $email;
         }
 
+    .. code-block:: php
+
+        // src/Acme/BlogBundle/Entity/Author.php
+        namespace Acme\BlogBundle\Entity;
+
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('email', new Assert\Email(array(
+                    'message' => 'The email "{{ value }}" is not a valid email.',
+                    'check'   => true,
+                )));
+            }
+        }
+
 Options
 -------
 
@@ -83,4 +102,4 @@ checkMX
 If true, then the `checkdnsrr`_ PHP function will be used to check the validity
 of the MX record of the host of the given email.
 
-.. _`checkdnsrr`: http://www.php.net/manual/en/function.checkdnsrr.php
+.. _`checkdnsrr`: http://www.php.net/manual/en/function.checkdnsrr.php