EqualTo¶
2.3 新版功能: The EqualTo constraint was introduced in Symfony 2.3.
Validates that a value is equal to another value, defined in the options. To force that a value is not equal, see NotEqualTo.
警告
This constraint compares using ==, so 3 and "3" are considered equal. Use IdenticalTo to compare with ===.
Applies to | property or method |
Options | |
Class | EqualTo |
Validator | EqualToValidator |
Basic Usage¶
If you want to ensure that the age of a Person class is equal to 20, you could do the following:
- YAML
# src/Acme/SocialBundle/Resources/config/validation.yml Acme\SocialBundle\Entity\Person: properties: age: - EqualTo: value: 20
- Annotations
// src/Acme/SocialBundle/Entity/Person.php namespace Acme\SocialBundle\Entity; use Symfony\Component\Validator\Constraints as Assert; class Person { /** * @Assert\EqualTo( * value = 20 * ) */ protected $age; }
- XML
<!-- src/Acme/SocialBundle/Resources/config/validation.xml --> <?xml version="1.0" encoding="UTF-8" ?> <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd"> <class name="Acme\SocialBundle\Entity\Person"> <property name="age"> <constraint name="EqualTo"> <option name="value">20</option> </constraint> </property> </class> </constraint-mapping>
- PHP
// src/Acme/SocialBundle/Entity/Person.php namespace Acme\SocialBundle\Entity; use Symfony\Component\Validator\Mapping\ClassMetadata; use Symfony\Component\Validator\Constraints as Assert; class Person { public static function loadValidatorMetadata(ClassMetadata $metadata) { $metadata->addPropertyConstraint('age', new Assert\EqualTo(array( 'value' => 20, ))); } }
Options¶
value¶
type: mixed [default option]
This option is required. It defines the value to compare to. It can be a string, number or object.
message¶
type: string default: This value should be equal to {{ compared_value }}.
This is the message that will be shown if the value is not equal.