[Validator] Document Collection constraint in combination with Optional/Required

[webmozart]

As of 2.1, there are two new constraints that can be used with Collection: Optional and Required. They give more flexibility over the existing options allowExtraFields and allowMissingFields.

Usage:

use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\Validator\Constraints\Collection\Optional;
use Symfony\Component\Validator\Constraints\Collection\Required;

/**
 * @Assert\Collection({
 *     foo = @Required(),
 *     bar = @Optional(),
 *     baz = @Required(@Assert\Min(3)),
 *     bam = @Optional({@Assert\NotNull, @Assert\MinLength(7)})
 * )}
private $options = array(
    'foo' => null,
    'baz' => 10,
);

[weaverryan]

This will involve simply documenting these two new fields inside the Collection constraint reference section. The example given here is already great.

[webmozart]

Maybe you find some better array keys than me :)

[cordoval]

Berhard, lo puedo hacer yo? gracias! Y no te preocupes, Ryan tambien entiende muy bien :)

[mjuchli]

Already embedded in 2.1 now?
Fatal error: Class 'Symfony\Component\Validator\Constraints\Collection\OptionalValidator' not found in /vendor/symfony/symfony/src/Symfony/Bundle/FrameworkBundle/Validator/ConstraintValidatorFactory.php on line 67

[wouterj]

@backender they do exists: http://api.symfony.com/2.1/Symfony/Component/Validator/Constraints/Collection/Optional.html