Julio Montoya d7be3fbf43 Updating vendors 11 years ago
..
Constraints d7be3fbf43 Updating vendors 11 years ago
Exception 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
Mapping d7be3fbf43 Updating vendors 11 years ago
Resources 321ce65f18 Updating vendors 11 years ago
Tests d7be3fbf43 Updating vendors 11 years ago
CHANGELOG.md d7041815fc Updating vendors 11 years ago
ClassBasedInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
Constraint.php 32682a9ca8 Updating vendor 12 years ago
ConstraintValidator.php 06eb0a00e6 Updating vendors 12 years ago
ConstraintValidatorFactory.php 321ce65f18 Updating vendors 11 years ago
ConstraintValidatorFactoryInterface.php 32682a9ca8 Updating vendor 12 years ago
ConstraintValidatorInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
ConstraintViolation.php 800633e22a Updating vendors 11 years ago
ConstraintViolationInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
ConstraintViolationList.php 800633e22a Updating vendors 11 years ago
ConstraintViolationListInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
DefaultTranslator.php 35463e4880 Updating vendors 12 years ago
ExecutionContext.php 800633e22a Updating vendors 11 years ago
ExecutionContextInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
GlobalExecutionContextInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
GroupSequenceProviderInterface.php 32682a9ca8 Updating vendor 12 years ago
LICENSE 32682a9ca8 Updating vendor 12 years ago
MetadataFactoryInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
MetadataInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
ObjectInitializerInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
PropertyMetadataContainerInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
PropertyMetadataInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
README.md d7be3fbf43 Updating vendors 11 years ago
Validation.php 32682a9ca8 Updating vendor 12 years ago
ValidationVisitor.php 06eb0a00e6 Updating vendors 12 years ago
ValidationVisitorInterface.php 06eb0a00e6 Updating vendors 12 years ago
Validator.php 321ce65f18 Updating vendors 11 years ago
ValidatorBuilder.php 06eb0a00e6 Updating vendors 12 years ago
ValidatorBuilderInterface.php 06eb0a00e6 Updating vendors 12 years ago
ValidatorInterface.php 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago
composer.json 224a0e666e Updating vendors 11 years ago
phpunit.xml.dist 1ad9119c46 Updating vendors + adding doctrine bridge, and forms 12 years ago

README.md

Validator Component

This component is based on the JSR-303 Bean Validation specification and enables specifying validation rules for classes using XML, YAML, PHP or annotations, which can then be checked against instances of these classes.

Usage

The component provides "validation constraints", which are simple objects containing the rules for the validation. Let's validate a simple string as an example:

use Symfony\Component\Validator\Validation;
use Symfony\Component\Validator\Constraints\Length;

$validator = Validation::createValidator();

$violations = $validator->validateValue('Bernhard', new Length(array('min' => 10)));

This validation will fail because the given string is shorter than ten characters. The precise errors, here called "constraint violations", are returned by the validator. You can analyze these or return them to the user. If the violation list is empty, validation succeeded.

Validation of arrays is possible using the Collection constraint:

use Symfony\Component\Validator\Validation;
use Symfony\Component\Validator\Constraints as Assert;

$validator = Validation::createValidator();

$constraint = new Assert\Collection(array(
    'name' => new Assert\Collection(array(
        'first_name' => new Assert\Length(array('min' => 101)),
        'last_name'  => new Assert\Length(array('min' => 1)),
    )),
    'email'    => new Assert\Email(),
    'simple'   => new Assert\Length(array('min' => 102)),
    'gender'   => new Assert\Choice(array(3, 4)),
    'file'     => new Assert\File(),
    'password' => new Assert\Length(array('min' => 60)),
));

$violations = $validator->validateValue($input, $constraint);

Again, the validator returns the list of violations.

Validation of objects is possible using "constraint mapping". With such a mapping you can put constraints onto properties and objects of classes. Whenever an object of this class is validated, its properties and method results are matched against the constraints.

use Symfony\Component\Validator\Validation;
use Symfony\Component\Validator\Constraints as Assert;

class User
{
    /**
     * @Assert\Length(min = 3)
     * @Assert\NotBlank
     */
    private $name;

    /**
     * @Assert\Email
     * @Assert\NotBlank
     */
    private $email;

    public function __construct($name, $email)
    {
        $this->name = $name;
        $this->email = $email;
    }

    /**
     * @Assert\True(message = "The user should have a Google Mail account")
     */
    public function isGmailUser()
    {
        return false !== strpos($this->email, '@gmail.com');
    }
}

$validator = Validation::createValidatorBuilder()
    ->enableAnnotationMapping()
    ->getValidator();

$user = new User('John Doe', 'john@example.com');

$violations = $validator->validate($user);

This example uses the annotation support of Doctrine Common to map constraints to properties and methods. You can also map constraints using XML, YAML or plain PHP, if you dislike annotations or don't want to include Doctrine. Check the documentation for more information about these drivers.

Resources

Silex integration:

https://github.com/fabpot/Silex/blob/master/src/Silex/Provider/ValidatorServiceProvider.php

Documentation:

http://symfony.com/doc/2.3/book/validation.html

JSR-303 Specification:

http://jcp.org/en/jsr/detail?id=303

You can run the unit tests with the following command:

$ cd path/to/Symfony/Component/Validator/
$ composer.phar install
$ phpunit