独特的

编辑本页

独特的

验证给定集合的所有元素都是惟一的(没有一个元素出现超过一次)。默认情况下严格比较元素,因此“7”而且7被认为是不同的元素(分别是字符串和整数)。如果要应用任何其他比较逻辑,请使用标准化者选择。

另请参阅

如果希望对集合的元素应用不同的验证约束,或者希望确保存在某些集合键,请使用集合的约束

另请参阅

如果您想验证一个实体属性的值在相同类型的所有实体中是唯一的(例如,所有用户的注册电子邮件),请使用UniqueEntity约束

适用于 属性或方法
独特的
验证器 UniqueValidator

基本用法

此约束可以应用于type的任何属性数组\可反驳的。在下面的例子中,contactEmails美元是一个字符串数组:

  • 属性
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10
/ / src /实体/ Person.php名称空间应用程序实体使用ob娱乐下载组件验证器约束作为断言#(断言独特\]受保护的contactEmails;}

选项

字段

类型数组|字符串

6.1

字段选项在Symfony 6.1中引入。ob娱乐下载

这定义了集合中应该检查唯一性的一个或多个键。默认情况下,检查所有集合键的唯一性。

例如,假设您有一个包含项的集合纬度经度而且标签字段。默认情况下,只要标签不同,就可以有重复的坐标。通过设置字段选项,您可以强制纬度+经度在集合中是唯一的:

  • 属性
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10
/ / src /实体/ Poi.php名称空间应用程序实体使用ob娱乐下载组件验证器约束作为断言芋泥#[断言\独特(字段=[纬度,经度的]))受保护的坐标;}

类型数组|字符串

它定义了这个约束的一个或多个验证组。阅读更多验证组

消息

类型字符串默认的这个集合应该只包含唯一的元素。

如果集合中至少有一个元素重复,就会显示此消息。

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

参数 描述
{{value}} 当前(无效)值

标准化者

类型:一个PHP调用默认的

该选项定义了在检查集合是否有效之前应用于给定集合的每个元素的PHP可调用对象。

例如,您可以通过“修剪”字符串来应用修剪函数,以便在验证期间忽略前导和尾随空格。

有效载荷

类型混合默认的

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

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

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。
ob娱乐下载Symfony 6.2支持通过苏禄人
ob娱乐下载Symfony 6.2支持通过Les-Tilleuls.coop