IsFalse

编辑此页

验证一个值是否为 false。具体来说，这会检查该值是否完全等于 false、完全等于整数 0 或完全等于字符串 '0'。

另请参阅 IsTrue。

应用于 属性或方法
类 IsFalse
验证器 IsFalseValidator

基本用法

The IsFalse 约束可以应用于属性或 “getter” 方法，但在后一种情况下最有用。例如，假设你想保证某个 state 属性不在动态 invalidStates 数组中。首先，你需要创建一个 “getter” 方法

1
2
3
4
5
6
7
8
protected string $state;

protected array $invalidStates = [];

public function isStateInvalid(): bool
{
    return in_array($this->state, $this->invalidStates);
}

在这种情况下，只有当 isStateInvalid() 方法返回 false 时，底层对象才是有效的

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

use Symfony\Component\Validator\Constraints as Assert;

class Author
{
    #[Assert\IsFalse(
        message: "You've entered an invalid state."
    )]
    public function isStateInvalid(): bool
    {
        // ...
    }
}

注意

与大多数其他约束一样，null 被认为是有效值。这是为了允许使用可选值。如果该值是强制性的，一个常见的解决方案是将此约束与 NotNull 结合使用。

选项

groups

类型: array | string 默认值: null

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

message

类型: string 默认值: This value should be false.

如果底层数据不是 false，则显示此消息。

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

参数 描述
{{ value }} 当前（无效）值
{{ label }} 对应的表单字段标签

payload

类型: mixed 默认值: null

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

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

这项工作，包括代码示例，根据 Creative Commons BY-SA 3.0 许可协议获得许可。
目录
    版本