跳到内容

NotIdenticalTo

编辑此页

验证一个值与另一个在选项中定义的值完全相同。要强制一个值完全相同,请参阅 IdenticalTo

警告

此约束使用 !== 进行比较,因此 3"3" 被认为不相等。使用 NotEqualTo 以使用 != 进行比较。

基本用法

以下约束确保

  • PersonfirstName 不等于 Mary 或类型不同
  • Person 类的 age 不等于 15 或类型不同
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\NotIdenticalTo('Mary')]
    protected string $firstName;

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

选项

groups

类型: array | string 默认值: null

它定义了此约束的验证组。阅读更多关于 验证组 的信息。

message

类型: string 默认值: 该值不应与 {{ compared_value_type }} {{ compared_value }} 完全相同。

这是当值完全相同时将显示的消息。

你可以在此消息中使用以下参数

参数 描述
{{ compared_value }} 期望的值
{{ compared_value_type }} 期望的值类型
{{ value }} 当前(无效)值

payload

类型: mixed 默认值: null

此选项可用于将任意特定于域的数据附加到约束。配置的 payload 不会被 Validator 组件使用,但其处理完全取决于你。

例如,你可能想要使用 多个错误级别,以便根据错误严重性在前端以不同方式呈现失败的约束。

propertyPath

类型: string 默认值: null

它定义了用于进行比较的对象属性的值。

例如,如果你想相对于同一对象的 $startDate 属性比较某个对象的 $endDate 属性,请在 $endDate 的比较约束中使用 propertyPath="startDate"

提示

当使用此选项时,其值在错误消息中作为 {{ compared_value_path }} 占位符可用。虽然不打算将其包含在向最终用户显示的错误消息中,但在使用 API 在客户端进行任何映射逻辑时,它很有用。

value

类型: mixed [默认选项]

此选项是必需的。它定义了比较值。它可以是字符串、数字或对象。

本作品,包括代码示例,根据 Creative Commons BY-SA 3.0 许可获得许可。
目录
    版本