范围

编辑该页面

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

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

范围

给定数字或验证DateTime对象是之间的最小值和最大值。

适用于 属性或方法
范围
验证器 RangeValidator

基本用法

来验证高度字段之间的类120年180年,你可能会添加以下:

  • 注释
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
/ / src /实体/ Participant.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;参与者{/ * * *@Assert\范围(*分钟= 120,* max = 180 * notInRangeMessage =“你必须在{{分钟}}厘米之间,{{马克斯}}厘米高的进入“,*)* /受保护的美元高度;}

日期范围

这个约束可以用来比较DateTime对象的日期范围。最小和最大日期范围应给予的任何日期字符串接受的DateTime构造函数。例如,您可以检查日期必须位于当前的一年是这样的:

  • 注释
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/ / src /实体/ Event.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;事件{/ * * *@Assert\范围(*分钟= 1月的第一天,* max =“明年一月的第一天”*)* /受保护的美元startDate可以;}

请注意,PHP配置将使用服务器的时区来解释这些日期。如果你想解决这个时区,将它添加到日期字符串:

  • 注释
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/ / src /实体/ Event.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;事件{/ * * *@Assert\范围(*分钟= 1月的第一天UTC, * max =“明年一月的第一天UTC”*) * /受保护的美元startDate可以;}

DateTime类还接受相对日期或时间。例如,您可以检查一个交货日期开始在接下来的5个小时是这样的:

  • 注释
  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/ / src /实体/ Order.php名称空间应用程序\实体;使用ob娱乐下载\组件\验证器\约束作为断言;订单{/ * * *@Assert\范围(*分钟=“现在”,* max =“+ 5小时”*)* /受保护的美元deliveryDate;}

选项

类型:数组|字符串

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

invalidMessage

类型:字符串默认的:这个值应该是一个有效的号码。

的信息将显示如果底层值不是一个数字(每is_numericPHP函数)。

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

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

马克斯

类型:数量字符串(日期格式)

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

maxMessage

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

将显示的信息潜在价值比马克斯选项,没有最小值选项(如果两个定义,定义使用notInRangeMessage)。

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

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

maxPropertyPath

类型:字符串

4.4

maxPropertyPath选项是在Symfony 4.4中引入的。ob娱乐下载

它定义了对象属性的值用作马克斯选择。

例如,如果你想比较submittedDate美元关于属性的对象美元的最后期限性质相同的对象,使用maxPropertyPath =“最后期限”在约束的范围submittedDate美元

提示

使用此选项时,它的值是在错误消息{{max_limit_path}}占位符。虽然它不是打算包括错误消息显示给最终用户,使用api时是很有用的对客户端做任何映射逻辑。

最小值

类型:数量字符串(日期格式)

这需要选择是“最小值”值。验证将会失败如果给定值比这个最小值。

minMessage

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

消息将显示如果小于潜在的价值最小值选项,没有马克斯选项(如果两个定义,定义使用notInRangeMessage)。

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

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

minPropertyPath

类型:字符串

4.4

minPropertyPath选项是在Symfony 4.4中引入的。ob娱乐下载

它定义了对象属性的值用作最小值选择。

例如,如果你想比较endDate美元关于属性的对象美元startDate可以性质相同的对象,使用minPropertyPath = " startDate可以"在约束的范围endDate美元

提示

使用此选项时,它的值是在错误消息{{min_limit_path}}占位符。虽然它不是打算包括错误消息显示给最终用户,使用api时是很有用的对客户端做任何映射逻辑。

notInRangeMessage

类型:字符串默认的:这个值应该在{{分钟}},{{马克斯}}。

4.4

notInRangeMessage选项是在Symfony 4.4中引入的。ob娱乐下载

消息将显示如果小于潜在的价值最小值选项或大于马克斯选择。

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

参数 描述
{{马克斯}} 上限
{{分钟}} 下限
{{value}} 当前(无效)值

有效载荷

类型:混合默认的:

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

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

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