长度

编辑该页面

警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 5.2,不再维护。

这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。

长度

验证给定的字符串长度之间的一些最大和最小值。

基本用法

来验证firstName类的字段长度之间250,你可能会添加以下:

  • 注释
  • 属性
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src /实体/ Participant.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;参与者{/ * * *@Assert\长度(*分钟= 2 * max = 50 * minMessage =“你的名字必须至少{{极限}}字符”,* maxMessage =“你的名字不能超过{{极限}}字符“*)* /受保护的美元firstName;}

请注意

与大多数其他的约束,和空字符串被认为是有效值。这是为了让他们可选值。如果该值是强制性的,一个常见的解决方案是将这个约束NotBlank

选项

allowEmptyString

类型:布尔默认的:

5.2

allowEmptyString5.2选择弃用,因为Symfony。ob娱乐下载如果你想让空字符串,结合长度约束的空白的约束AtLeastOneOf约束

如果设置为真正的,空字符串被认为是有效的(这是以前的Symfony版本)一样的行为。ob娱乐下载默认的无效值认为空字符串。

谨慎

这个选项没有任何影响在没有最小长度。

字符集

类型:字符串默认的:utf - 8

要使用的字符集,当计算值的长度mb_check_encodingmb_strlenPHP函数。

charsetMessage

类型:字符串默认的:这个值不匹配预期的{{字符集}}字符集。

将显示的信息如果没有使用价值字符集

在这个信息:您可以使用以下参数

参数 描述
{{字符集}} 预期的字符集
{{value}} 当前(无效)值

exactMessage

类型:字符串默认的:这个值应该是{{极限}}字符。

的消息将显示如果min和max值相等和潜在价值的长度不是这个值。

在这个信息:您可以使用以下参数

参数 描述
{{极限}} 准确的预期长度
{{value}} 当前(无效)值

类型:数组|字符串

它定义了这个约束属于验证组或组。阅读更多关于验证组

马克斯

类型:整数

这个选项是“max”长度值。验证将会失败如果给定的值的长度更大的比这个最大价值。

这个选项时是必需的最小值选择是没有定义的。

maxMessage

类型:字符串默认的:这个值是太长了。它应该{{极限}}字符或更少。

的信息将显示如果潜在价值的长度比马克斯选择。

在这个信息:您可以使用以下参数

参数 描述
{{极限}} 预期的最大长度
{{value}} 当前(无效)值

最小值

类型:整数

这个选项是“min”长度值。验证将会失败如果给定的值的长度比这个最小值。

这个选项时是必需的马克斯选择是没有定义的。

重要的是要注意,无论NULL值和空字符串被认为是有效的约束所需的最小长度。验证器触发只有在值不是空白。

minMessage

类型:字符串默认的:这个值太短了。它应该{{极限}}字符或更多。

的信息将显示如果潜在价值的长度小于最小值选择。

在这个信息:您可以使用以下参数

参数 描述
{{极限}} 预期的最小长度
{{value}} 当前(无效)值

标准化者

类型:一个PHP调用默认的:

这个选项允许定义PHP调用应用到给定值之前检查如果它是有效的。

例如,您可能想要通过“修剪”字符串应用修剪PHP函数来验证期间忽略前导和尾随空白。

有效载荷

类型:混合默认的:

这个选项可以用来连接任意特定领域的数据约束。配置的有效载荷不使用验证器组件,但是它的处理是完全取决于你。

例如,您可能想要使用几个错误级别以不同的方式来呈现没有约束,在前端取决于错误的严重性。

这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。