IdenticalTo

编辑此页

验证一个值与选项中定义的另一个值是否完全相同。要强制验证一个值 *不* 完全相同，请参阅 NotIdenticalTo。

警告

此约束使用 === 进行比较，因此 3 和 "3" *不* 被认为是相等的。使用 EqualTo 以 == 进行比较。

应用于	属性或方法
类	IdenticalTo
验证器	IdenticalToValidator

基本用法

以下约束确保

Person 类的 firstName 属性等于 Mary *并且* 是一个字符串
age 属性等于 20 *并且* 是整数类型

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
        // src/Entity/Person.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Person
{
    #[Assert\IdenticalTo('Mary')]
    protected string $firstName;

    #[Assert\IdenticalTo(
        value: 20,
    )]
    protected int $age;
}
    

        1
2
3
4
5
6
7
8
        # config/validator/validation.yaml
App\Entity\Person:
    properties:
        firstName:
            - IdenticalTo: Mary
        age:
            - IdenticalTo:
                value: 20
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
        <!-- config/validator/validation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.ac.cn/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.ac.cn/schema/dic/constraint-mapping http://symfony.ac.cn/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

    <class name="App\Entity\Person">
        <property name="firstName">
            <constraint name="IdenticalTo">
                Mary
            </constraint>
        </property>
        <property name="age">
            <constraint name="IdenticalTo">
                <option name="value">20</option>
            </constraint>
        </property>
    </class>
</constraint-mapping>
    

        1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
        // src/Entity/Person.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\Validator\Mapping\ClassMetadata;

class Person
{
    // ...

    public static function loadValidatorMetadata(ClassMetadata $metadata): void
    {
        $metadata->addPropertyConstraint('firstName', new Assert\IdenticalTo('Mary'));

        $metadata->addPropertyConstraint('age', new Assert\IdenticalTo([
            'value' => 20,
        ]));
    }
}
    