如何创建自定义验证约束
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.3，现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
如何创建自定义验证约束
您可以通过扩展基约束类来创建自定义约束，约束．作为示例，您将创建一个简单的验证器，用于检查字符串是否只包含字母数字字符。
创建约束类
首先，您需要创建一个Constraint类并进行扩展约束：
12 3 4 5 6 7 8 9 10 11 12
/ / src / AppBundle /验证器/约束/ ContainsAlphanumeric.php名称空间AppBundle＼验证器＼约束；使用ob娱乐下载＼组件＼验证器＼约束；/ * * *@Annotation* /类ContainsAlphanumeric扩展约束｛公共＄消息＝字符串“%string%”包含非法字符:它只能包含字母或数字。；｝请注意
的@Annotation注释对于这个新约束来说是必要的，以便可以通过注释在类中使用它。约束的选项在约束类上表示为公共属性。
创建验证器本身
如您所见，约束类是相当小的。实际的验证由另一个“约束验证器”类执行。约束验证器类由约束的类指定validatedBy ()方法，其中包括一些简单的默认逻辑:
1 2 3 4 5
//在Symfony基本的\Cob娱乐下载omponent\Validator\Constraint类公共函数validatedBy（）｛返回get_class (＄这）.“验证”；｝换句话说，如果您创建了一个自定义约束(如。MyConstraint)， ob娱乐下载Symfony会自动寻找另一个类，MyConstraintValidator在实际执行验证时。
验证器类也很简单，只有一个必需的方法validate ()：
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
/ / src / AppBundle /验证器/约束/ ContainsAlphanumericValidator.php名称空间AppBundle＼验证器＼约束；使用ob娱乐下载＼组件＼验证器＼约束；使用ob娱乐下载＼组件＼验证器＼ConstraintValidator；类ContainsAlphanumericValidator扩展ConstraintValidator｛公共函数验证（＄价值、约束＄约束）｛如果(!preg_match (' / ^ [a-zA-Z0-9] + $ / '，＄价值，＄匹配)) {＄这->上下文->addViolation (＄约束->消息,数组（“%字符串%”= >＄价值));}}}请注意
的验证方法不返回值;相反，它在验证器中添加了违例上下文属性addViolation方法调用。因此，如果一个值没有导致向上下文中添加任何违反，就可以认为它是有效的。的第一个参数addViolation调用是用于该违反的错误消息。
使用新的验证器
使用自定义验证器非常简单，就像Symfony本身提供的那样:ob娱乐下载
- 注释
- YAML
- XML
- PHP
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16
/ / src / AppBundle /实体/ AcmeEntity.php使用ob娱乐下载＼组件＼验证器＼约束作为断言；使用AppBundle＼验证器＼约束作为AcmeAssert；类AcmeEntity｛/ /……/ * * *@Assert\ NotBlank *@AcmeAssert\ ContainsAlphanumeric * /受保护的＄的名字；/ /……｝如果约束包含选项，那么它们应该是前面创建的自定义constraint类上的公共属性。这些选项可以像Symfony核心约束上的选项一样配置。ob娱乐下载
带有依赖项的约束验证器
如果约束验证器具有依赖项，例如数据库连接，则需要将其配置为依赖项注入容器中的服务。此服务必须包括validator.constraint_validator标记，可以包括别名属性:
- YAML
- XML
- PHP
1 2 3 4 5 6
# app / config / services.yml服务:validator.unique.your_validator_name:类:完全限定\ \验证器类\ \的名字标签:-｛名称:validator.constraint_validator,别名:alias_name｝如上所述，Symfony将自动查找以约束ob娱乐下载命名的类验证器附加。你可以在你的约束类中重写这个:
1 2 3 4
公共函数validatedBy（）｛返回的完全限定\ \ ConstraintValidator \类\名称”；//或'alias_name'如果提供｝类约束验证器
除了验证类属性外，约束还可以通过在类属性中提供目标来具有类作用域约束类:
1 2 3 4
公共函数getTargets（）｛返回自我：：CLASS_CONSTRAINT;｝有了这个，验证器validate ()方法获取一个对象作为其第一个参数:
12 3 4 5 6 7 8 9 10 11 12 13 14
类ProtocolClassValidator扩展ConstraintValidator｛公共函数验证（＄协议、约束＄约束）｛如果（＄协议->getFoo () ! =＄协议->getBar ()) {＄这->上下文->addViolationAt (“foo”，＄约束->消息,数组（），零）;}}}注意，类约束验证器应用于类本身，而不是属性:
- 注释
- YAML
- XML
1 2 3 4 5 6 7
/ * * *@AcmeAssert\ ContainsAlphanumeric * /类AcmeEntity｛/ /……｝
