Added PHP config format

Author: wouterj

reference/constraints/All.rst

@@ -58,14 +58,33 @@ 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
+ 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.
 

reference/constraints/Blank.rst

@@ -52,6 +52,20 @@ of an ``Author`` class were blank, you could do the following:
  </property>
  </class>
 
+ .. code-block:: php
+
+ // src/Acme/BlogBundle/Entity/Author.php
+ 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
 -------
 

reference/constraints/Callback.rst

@@ -63,6 +63,22 @@ Setup
  </constraint>
  </class>
 
+ .. code-block:: php
+
+ // src/Acme/BlogBundle/Entity/Author.php
+ 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
 -------------------
 

reference/constraints/Choice.rst

@@ -78,15 +78,15 @@ If your valid choice list is simple, you can pass them in directly via the
 
  // src/Acme/BlogBundle/EntityAuthor.php
  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',
  )));

reference/constraints/Collection.rst

@@ -120,20 +120,18 @@ blank but is no longer than 100 characters in length, you would do the following
 
  // src/Acme/BlogBundle/Entity/Author.php
  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,
  )));

reference/constraints/Country.rst

@@ -50,6 +50,20 @@ Basic Usage
  </property>
  </class>
 
+ .. code-block:: php
+
+ // src/Acme/UserBundle/Entity/User.php
+ 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
 -------
 

reference/constraints/Date.rst

@@ -50,6 +50,20 @@ Basic Usage
  </property>
  </class>
 
+ .. code-block:: php
+
+ // src/Acme/BlogBundle/Entity/Author.php
+ 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
 -------
 

reference/constraints/DateTime.rst

@@ -52,6 +52,20 @@ Basic Usage
  </property>
  </class>
 
+ .. code-block:: php
+
+ // src/Acme/BlogBundle/Entity/Author.php
+ 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
 -------
 

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
 -------
 

reference/constraints/False.rst

@@ -75,6 +75,20 @@ method returns **false**:
  }
  }
 
+ .. code-block:: php
+
+ // src/Acme/BlogBundle/Entity/Author.php
+ use Symfony\Component\Validator\Mapping\ClassMetadata;
+ use Symfony\Component\Validator\Constraints as Assert;
+
+ class Author
+ {
+ public static function loadValidatorMetadata(ClassMetadata $metadata)
+ {
+ $metadata->addGetterConstraint('stateInvalid', new Assert\False());
+ }
+ }
+
 .. caution::
 
  When using YAML, be sure to surround ``False`` with quotes (``"False"``)