跳到内容

ULID

编辑此页

验证一个值是否为有效的通用唯一词典排序标识符 (ULID)。

适用于 属性或方法
Ulid
验证器 UlidValidator

基本用法

1
2
3
4
5
6
7
8
9
10
// src/Entity/File.php
namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class File
{
    #[Assert\Ulid]
    protected string $identifier;
}

注意

与其他大多数约束一样,null 和空字符串被认为是有效值。这是为了允许它们成为可选值。如果该值是强制性的,一个常见的解决方案是将此约束与 NotBlank 结合使用。

选项

format

类型: string 默认值: Ulid::FORMAT_BASE_32

要验证的 ULID 格式。以下格式可用

  • Ulid::FORMAT_BASE_32: ULID 以 base32 编码 (默认)
  • Ulid::FORMAT_BASE_58: ULID 以 base58 编码
  • Ulid::FORMAT_RFC4122: ULID 以 RFC 4122 格式 编码

7.2

format 选项在 Symfony 7.2 中引入。

groups

类型: array | string 默认值: null

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

message

类型: string 默认值: This is not a valid ULID.

如果字符串不是有效的 ULID,则显示此消息。

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

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

normalizer

类型: 一个 PHP 可调用对象 默认值: null

此选项允许定义在检查给定值是否有效之前应用于该值的 PHP 可调用对象。

例如,您可能希望传递 'trim' 字符串来应用 trim PHP 函数,以便在验证期间忽略前导和尾随空格。

payload

类型: mixed 默认值: null

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

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

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