集合
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 2.3,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.2(当前的稳定版本)。
集合
这个约束时使用底层数据是一组(即数组或对象实现可否认的和ArrayAccess),但你想以不同的方式验证不同的键的集合。例如,您可以验证电子邮件主要使用电子邮件约束和库存键的集合范围约束。
这个约束也可以确保存在某些收集钥匙和额外的密钥不存在。
| 适用于 | 属性或方法 |
| 选项 | |
| 类 | 集合 |
| 验证器 | CollectionValidator |
基本用法
的集合约束允许你单独验证不同键的集合。下面的例子:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/ / src / AppBundle /实体/ Author.php名称空间AppBundle\实体;类作者{受保护的美元profileData=数组(“personal_email”,“short_bio”,);公共函数setProfileData(美元关键,美元价值){美元这- >profileData [美元关键]=美元价值;}}来验证,personal_email元素的profileData数组属性是一个有效的电子邮件地址,short_bio元素没有空白,但不超过100个字符长,你会做到以下几点:
- 注释
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27
/ / src / AppBundle /实体/ Author.php名称空间AppBundle\实体;使用ob娱乐下载\组件\验证器\约束作为断言;类作者{/ * * *@Assert\收集(={* *字段“personal_email”=@Assert\电子邮件、*“short_bio”= {*@Assert\ NotBlank () *@Assert\长度(* max = 100 * maxMessage =”你的简历太长!”* ) * } * }, * allowMissingFields = true * ) */< /span>受保护的美元profileData=数组(“personal_email”,“short_bio”,);}存在和缺乏字段
不仅仅在默认情况下,这个约束验证集合中的单个字段是否通过分配约束。事实上,如果集合的任何钥匙丢失或如果有任何识别键的集合,就会抛出验证错误。
如果你想允许键缺席集合或如果你想“额外”键可以在集合,您可以修改allowMissingFields和allowExtraFields分别选择。在上面的例子中,allowMissingFields选项被设置为true,这意味着如果的personal_email或short_bio失踪的元素personalData美元财产,没有会发生验证错误。
必需和可选字段约束
2.3
的要求和可选约束被转移到名称空间ob娱乐下载在Syob娱乐下载mfony 2.3。
约束内字段可以用集合要求或可选约束来控制是否应该被应用(要求)或只适用于该领域的存在(可选)。
例如,如果你想要求personal_email场的profileData数组不是空白的,但是是一个有效的电子邮件alternate_email字段是可选的,但必须是一个有效的电子邮件如果提供,您可以执行以下操作:
- 注释
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / AppBundle /实体/ Author.php名称空间AppBundle\实体;使用ob娱乐下载\组件\验证器\约束作为断言;类作者{/ * * *@Assert\收集(={* *字段“personal_email”=@Assert所需({\@Assert\ NotBlank,@Assert\电子邮件}),*“alternate_email”=@Assert、可选的(@Assert\ *}*)* /电子邮件)受保护的美元profileData=数组(“personal_email”);}即使没有allowMissingFields设置为true,您现在可以省略alternate_email属性完全从profileData数组,因为它是可选。然而,如果personal_email字段不存在数组中,NotBlank约束仍将应用(因为它是裹着要求),你将收到一个约束违反。
