跳到内容

NotEqualTo

编辑此页

验证一个值等于另一个值,该值在选项中定义。要强制一个值相等,请参阅EqualTo

警告

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

基本用法

如果您想确保 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\NotEqualTo('Mary')]
    protected string $firstName;

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

选项

groups

类型array | string 默认值null

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

message

类型string 默认值此值不应等于 {{ compared_value }}。

这是当值相等时将显示的消息。

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

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

payload

类型mixed 默认值null

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

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

propertyPath

类型string 默认值null

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

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

提示

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

value

类型mixed [默认选项]

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

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