验证

编辑该页面

警告:你浏览的文档欧宝体育电话<一个href="//www.oldmanjams.com/releases/5.1">欧宝娱乐app下载地址Symfony 5.1,不再维护。

读<一个href="//www.oldmanjams.com/doc/current/validation.html">这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。

安装< /李><李><一个href="#the-basics-of-validation">基本的验证
使用验证器服务< /李>< /ul>< /李><李>配置< /李><李><一个href="#constraints">约束
支持限制< /李><李><一个href="#basic-constraints">基本的约束< /李><李><一个href="#string-constraints">字符串约束< /李><李><一个href="#comparison-constraints">比较约束< /李><李><一个href="#number-constraints">数量限制< /李><李><一个href="#date-constraints">日期限制< /李><李><一个href="#choice-constraints">选择限制条件< /李><李><一个href="#file-constraints">文件限制< /李><李><一个href="#financial-and-other-number-constraints">金融和其他数量限制< /李><李><一个href="#other-constraints">其他约束< /李><李><一个href="#constraint-configuration">约束的配置< /李>< /ul>< /李><李>约束形式类< /李><李><一个href="#constraint-targets">约束的目标
属性< /李><李><一个href="#getters">getter< /李><李><一个href="#classes">类< /李>< /ul>< /李><李>最终的想法< /李><李><一个href="#learn-more">了解更多< /李>< /ul>< /div>
验证< /h1>
验证在web应用程序中是很常见的任务。数据输入表单需要验证。数据还需要验证之前写入数据库或传递给web服务。

欧宝娱乐app下载地址Symfony提供了一个<一个href="https://github.com/symfony/validator" class="reference external" rel="external noopener noreferrer" target="_blank">验证器组件为你处理这个问题。该组件是基于<一个href="https://jcp.org/en/jsr/detail?id=303" class="reference external" rel="external noopener noreferrer" target="_blank">JSR303 Bean验证规范。
安装< /h2>
在应用程序中使用<一个href="//www.oldmanjams.com/doc/5.1/setup.html" class="reference internal">欧宝娱乐app下载地址Symfony Flex运行这个命令,安装在使用前验证器:

1

`美元作曲家要求symfony / va欧宝娱乐app下载地址lidator教义/注释`
基本的验证< /h2>
最好的方式来理解验证是看它的实际应用。首先,假设您已经创建了一个plain-old-PHP对象,您需要使用在您的应用程序:

1 2 3 4 5 6 7

`/ / src /实体/ Author.php名称空间应用程序\实体;类作者{私人美元的名字;}`

到目前为止,这是一个普通的类,在您的应用程序提供一些目的。验证的目的是告诉你如果一个对象的数据是有效的。为此,您将配置一个规则(称为列表<一个href="//www.oldmanjams.com/doc/5.1/validation.html" class="reference internal">约束)对象必须遵循的是有效的。这些规则通常使用PHP代码定义或注释,但他们也可以被定义为`.yaml`或`. xml`文件里面的`配置/验证器/`目录:

例如,为了保证`美元的名字`财产不是空的,添加以下:

注释

YAML

XML

PHP

1 2 3 4 5 6 7 8 9 10 11 12 13

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;类作者{/ * * @Assert\ NotBlank /私人美元的名字;}`

1 2 3 4 5

`#配置/验证器/ validation.yaml应用实体\ \作者:属性:名称:- - - - - -NotBlank:~`

1 2 3 4 5 6 7 8 9 10 11 12 13

< !- - - - - -- - - - - -配置/验证器/有效的一个tion.xml -->< /span>< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><constraint-mappingxmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xsi: schemaLocation=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping //www.oldmanjams.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd”><类的名字=“应用程序作者\实体\”><财产的名字=“名称”><约束的名字=“NotBlank”/ >< /财产>< /类>< /constraint-mapping>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束\NotBlank;使用欧宝娱乐app下载地址\组件\验证器\映射\ClassMetadata;类作者{私人美元的名字;公共静态函数loadValidatorMetadata(ClassMetadata美元元数据){美元元数据- >addPropertyConstraint (“名字”,新NotBlank ());}}`

提示

欧宝娱乐app下载地址Symfony的验证器使用PHP反射,以及“getter”方法,得到任何财产的价值,所以他们可以公共,私人或保护(见<一个href="//www.oldmanjams.com/doc/5.1/validation.html" class="reference internal">验证)。

使用验证器服务< /h3>
接下来,验证一个`作者`对象,使用`validate ()`方法`验证器`服务(它实现<一个href="https://github.com/symfony/symfony/blob/5.1/src/Symfony/Component/Validator/Validator/ValidatorInterface.php" class="reference external" title="ValidatorInterface" rel="external noopener noreferrer" target="_blank">ValidatorInterface)。的工作`验证器`阅读类的约束(即规则)和验证数据对象满足这些约束。如果验证失败,一个非空列表错误(<一个href="https://github.com/symfony/symfony/blob/5.1/src/Symfony/Component/Validator/ConstraintViolationList.php" class="reference external" title="ConstraintViolationList" rel="external noopener noreferrer" target="_blank">ConstraintViolationList返回类)。这个简单的例子从一个控制器:

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

/ /……使用应用程序\实体\作者;使用欧宝娱乐app下载地址\组件\HttpFoundation\响应;使用欧宝娱乐app下载地址\组件\验证器\验证器\ValidatorInterface;/ /……公共函数作者(ValidatorInterface美元验证器){美元作者=新作者();/ /……做一些美元作者对象美元错误=美元验证器- >validate (美元作者);如果(数(美元错误)>0){/ * 使用__toString方法$错误变量 ConstraintViolationList对象。这给了我们一个很好的字符串进行调试。 /美元errorsString=(字符串)美元错误;返回新响应(美元errorsString);}返回新响应(“作者是有效的!是的!”);}

如果`美元的名字`属性是空的,您将看到以下错误消息:

1 2

`对象(应用程序\实体\作者). name:这个值不能空白`

如果你将一个值插入到`的名字`财产,快乐的成功消息将出现。

提示

大多数时候,你不会直接与互动`验证器`服务或需要担心打印出错误。大多数时候,您将使用验证间接在处理所提交的表单数据。有关更多信息,请参见<一个href="//www.oldmanjams.com/doc/5.1/forms.html" class="reference internal">如何验证Symfony形式欧宝娱乐app下载地址。

你也可以通过错误的集合为一个模板:

1 2 3 4 5

`如果(数(美元错误)>0){返回美元这- >呈现(“作者/ validation.html.twig”,(“错误”= >美元错误]);}`

在模板,您可以根据需要输出完全错误的列表:

1 2 3 4 5 6 7

`{/作者/ validation.html #模板。树枝#}<h3>作者有以下错误< /h3><ul>{%为错误的错误%}<李>{{错误。消息}}< /李>{%endfor%}< /ul>`

请注意

每个验证错误(称为“约束违反”),是由一个表示<一个href="https://github.com/symfony/symfony/blob/5.1/src/Symfony/Component/Validator/ConstraintViolation.php" class="reference external" title="ConstraintViolation" rel="external noopener noreferrer" target="_blank">ConstraintViolation对象。
配置< /h2>
在使用Symfony验证器之前,确欧宝娱乐app下载地址保它是启用的主要配置文件:

YAML

XML

PHP

1 2 3

`#配置/包/ framework.yaml框架:验证:{启用:真正的}`

1 2 3 4 5 6 7 8 9 10 11 12 13

< !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><容器xmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:验证启用=“真正的”/ >< /框架:配置>< /容器>

1 2 3 4 5 6

`/ /配置/包/ framework.php美元容器- >loadFromExtension (“框架”,(“验证”= > [“启用”= >真正的、]]);`

除此之外,如果你打算使用注释来配置验证,取代先前的配置如下:

YAML

XML

PHP

1 2 3

`#配置/包/ framework.yaml框架:验证:{enable_annotations:真正的}`

1 2 3 4 5 6 7 8 9 10 11 12 13

< !- - - - - -- - - - - -config/packages/framework.xml -->< /span>< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><容器xmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xmlns:框架=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/symfony”xsi: schemaLocation=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services //www.oldmanjams.com/schema/dic/services/services-1.0.xsd //www.oldmanjams.com/schema/dic/symfony //www.oldmanjams.com/schema/dic/symfony/symfony-1.0.xsd”><框架:配置><框架:验证enable-annotations=“真正的”/ >< /框架:配置>< /容器>

1 2 3 4 5 6

`/ /配置/包/ framework.php美元容器- >loadFromExtension (“框架”,(“验证”= > [“enable_annotations”= >真正的、]]);`

提示

当使用PHP、YAML和XML文件而不是注释,Symfony查找默认的欧宝娱乐app下载地址`配置/验证器/`目录,但是您可以配置其他目录<一个href="//www.oldmanjams.com/doc/5.1/reference/configuration/framework.html" class="reference internal">validation.mapping.paths选择。
约束< /h2>
的`验证器`目的是验证对象反对约束(即规则)。为了验证对象,只需将一个或多个约束映射到它的类,然后通过它`验证器`服务。

在幕后,约束是一个简单的PHP对象,一个自信的声明。在现实生活中,一个约束可能是:“蛋糕不能烧”。在Sy欧宝娱乐app下载地址mfony,约束是类似的:他们断言一个条件是正确的。给定一个值,约束会告诉你如果坚持价值的规则约束。

支持限制< /h3>
欧宝娱乐app下载地址Symfony包很多最常用的限制:

基本的约束< /h3>
这些是基本的限制:坚持使用它们非常基本的东西的价值属性或对象上的方法的返回值。

NotBlank< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Blank.html" class="reference internal">空白< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/NotNull.html" class="reference internal">NotNull< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/IsNull.html" class="reference internal">IsNull< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/IsTrue.html" class="reference internal">IsTrue< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/IsFalse.html" class="reference internal">IsFalse< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Type.html" class="reference internal">类型< /李>< /ul>< /div>

字符串约束< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Email.html" class="reference internal">电子邮件< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/ExpressionLanguageSyntax.html" class="reference internal">ExpressionLanguageSyntax< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Length.html" class="reference internal">长度< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Url.html" class="reference internal">Url< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Regex.html" class="reference internal">正则表达式< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Hostname.html" class="reference internal">主机名< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Ip.html" class="reference internal">知识产权< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Json.html" class="reference internal">Json< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Uuid.html" class="reference internal">Uuid< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/UserPassword.html" class="reference internal">UserPassword< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/NotCompromisedPassword.html" class="reference internal">NotCompromisedPassword< /李>< /ul>< /div>

比较约束< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/EqualTo.html" class="reference internal">等于< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/NotEqualTo.html" class="reference internal">NotEqualTo< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/IdenticalTo.html" class="reference internal">IdenticalTo< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/NotIdenticalTo.html" class="reference internal">NotIdenticalTo< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/LessThan.html" class="reference internal">不超过< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/LessThanOrEqual.html" class="reference internal">LessThanOrEqual< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/GreaterThan.html" class="reference internal">GreaterThan< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/GreaterThanOrEqual.html" class="reference internal">GreaterThanOrEqual< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Range.html" class="reference internal">范围< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/DivisibleBy.html" class="reference internal">DivisibleBy< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Unique.html" class="reference internal">独特的< /李>< /ul>< /div>

数量限制< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Positive.html" class="reference internal">积极的< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/PositiveOrZero.html" class="reference internal">PositiveOrZero< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Negative.html" class="reference internal">负< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/NegativeOrZero.html" class="reference internal">NegativeOrZero< /李>< /ul>< /div>

日期限制< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Date.html" class="reference internal">日期< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/DateTime.html" class="reference internal">DateTime< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Time.html" class="reference internal">时间< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Timezone.html" class="reference internal">时区< /李>< /ul>< /div>

选择限制条件< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Choice.html" class="reference internal">选择< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Language.html" class="reference internal">语言< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Locale.html" class="reference internal">语言环境< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Country.html" class="reference internal">国家< /李>< /ul>< /div>

文件限制< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/File.html" class="reference internal">文件< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Image.html" class="reference internal">图像< /李>< /ul>< /div>

金融和其他数量限制< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Bic.html" class="reference internal">Bic< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/CardScheme.html" class="reference internal">CardScheme< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Currency.html" class="reference internal">货币< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Luhn.html" class="reference internal">Luhn< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Iban.html" class="reference internal">伊班人< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Isbn.html" class="reference internal">国际标准图书编号< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Issn.html" class="reference internal">石头< /李>< /ul>< /div>

其他约束< /h3>
<李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/AtLeastOneOf.html" class="reference internal">AtLeastOneOf< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Sequentially.html" class="reference internal">按顺序< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Compound.html" class="reference internal">复合< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Callback.html" class="reference internal">回调< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Expression.html" class="reference internal">表达式< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/All.html" class="reference internal">所有< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Valid.html" class="reference internal">有效的< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Traverse.html" class="reference internal">遍历< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Collection.html" class="reference internal">集合< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Count.html" class="reference internal">数< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/UniqueEntity.html" class="reference internal">UniqueEntity< /李>< /ul>
您还可以创建自己的自定义约束。这一主题的覆盖<一个href="//www.oldmanjams.com/doc/5.1/validation/custom_constraint.html" class="reference internal">如何创建一个定制的验证约束篇文章。

约束的配置< /h3>
一些限制,比如<一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/NotBlank.html" class="reference internal">NotBlank,很简单,而另一些,如<一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Choice.html" class="reference internal">选择约束,有几个配置选项可用。假设`作者`类有另一个属性`类型`定义相关的文学流派主要作者,也可以设置为“小说”或“非小说”:

注释

YAML

XML

PHP

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;类作者{/ * * @Assert\选择(选择={“小说”,“非小说”},消息=“选择一个有效的类型。” ) /< /span>私人美元类型;/ /……}`

1 2 3 4 5 6

`#配置/验证器/ validation.yaml应用实体\ \作者:属性:类型:- - - - - -选择:{选择:(小说,非小说类),信息:选择一个有效的体裁。}#……`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

< !- - - - - -- - - - - -配置/验证器/有效的一个tion.xml -->< /span>< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><constraint-mappingxmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xsi: schemaLocation=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping //www.oldmanjams.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd”><类的名字=“应用程序作者\实体\”><财产的名字=“类型”><约束的名字=“选择”><选项的名字=“选择”><价值>小说< /价值><价值>非小说类< /价值>< /选项><选项的名字=“消息”>选择一个有效的类型。< /选项>< /约束>< /财产>< !- - - - - -- - - - - -。。。- - >< /类>< /constraint-mapping>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日

/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;使用欧宝娱乐app下载地址\组件\验证器\映射\ClassMetadata;类作者{私人美元类型;/ /……公共静态函数loadValidatorMetadata(ClassMetadata美元元数据){/ /……美元元数据- >addPropertyConstraint (“类型”,新维护\选择([“选择”= > [“小说”,“非小说”),“消息”= >“选择一个有效的类型。”)));}}

约束的选择总是可以通过数组。然而,一些约束还允许您通过一个的价值,“默认的”,选择的数组。在的情况下`选择`约束,`选择`以这种方式可以指定选项。

注释

YAML

XML

PHP

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;类作者{/ * @Assert\选择({“小说”,“非小说”}) /私人美元类型;/ /……}`

1 2 3 4 5 6

`#配置/验证器/ validation.yaml应用实体\ \作者:属性:类型:- - - - - -选择:(小说,非小说类)#……`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

< !- - - - - -- - - - - -配置/验证器/有效的一个tion.xml -->< /span>< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><constraint-mappingxmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xsi: schemaLocation=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping //www.oldmanjams.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd”><类的名字=“应用程序作者\实体\”><财产的名字=“类型”><约束的名字=“选择”><价值>小说< /价值><价值>非小说类< /价值>< /约束>< /财产>< !- - - - - -- - - - - -。。。- - >< /类>< /constraint-mapping>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;使用欧宝娱乐app下载地址\组件\验证器\映射\ClassMetadata;类作者{私人美元类型;公共静态函数loadValidatorMetadata(ClassMetadata美元元数据){/ /……美元元数据- >addPropertyConstraint (“类型”,新维护\选择([“小说”,“非小说”)));}}`

这纯粹是为了使最常见的配置选项的约束越来越快。

如果你不确定如何指定一个选择,要么检查名称空间`欧宝娱乐app下载地址Symfony \组件\验证器\约束`约束或为了保险起见,总是在一个数组传递选项(第一个方法如上所示)。

约束形式类< /h2>
约束可以被定义在建筑形式通过`约束`表单字段的选项:

1 2 3 4 5 6 7 8 9

`公共函数buildForm(FormBuilderInterface美元构建器数组,美元选项){美元构建器- >add (“myField”,TextType::类,“要求”= >真正的,“约束”= > [新长度([“最小值”= >3]]]);}`

约束的目标< /h2>
约束可以应用于一个类属性(如。`的名字`(如),一个公共的getter方法。`getFullName ()`)或整个类。产权约束是最常见的和容易使用。Getter约束允许您指定更复杂的验证规则。最后,类约束是用于场景你想验证一个类作为一个整体。

属性< /h3>
验证类属性是最基本的验证技术。欧宝娱乐app下载地址Symfony允许您验证私有、保护或公共属性。下一个清单向您展示如何配置`firstName美元`财产的`作者`类有至少3个字符。

注释

YAML

XML

PHP

1 2 3 4 5 6 7 8 9 10 11 12 13

`/ / src /实体/ Author.php/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;类作者{/ * * @Assert\ NotBlank @Assert\ (min = 3)长度* /私人美元firstName;}`

1 2 3 4 5 6 7

`#配置/验证器/ validation.yaml应用实体\ \作者:属性:名字:- - - - - -NotBlank:~- - - - - -长度:分钟:3`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

< !- - - - - -- - - - - -配置/验证器/有效的一个tion.xml -->< /span>< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><constraint-mappingxmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xsi: schemaLocation=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping //www.oldmanjams.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd”><类的名字=“应用程序作者\实体\”><财产的名字=“firstName”><约束的名字=“NotBlank”/ ><约束的名字=“长度”><选项的名字=“最小值”>3< /选项>< /约束>< /财产>< /类>< /constraint-mapping>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;使用欧宝娱乐app下载地址\组件\验证器\映射\ClassMetadata;类作者{私人美元firstName;公共静态函数loadValidatorMetadata(ClassMetadata美元元数据){美元元数据- >addPropertyConstraint (“firstName”,新维护\ NotBlank ());美元元数据- >addPropertyConstraint (“firstName”,新维护\长度([“最小值”= >3)));}}`

谨慎

验证器将使用一个值`零`如果一个类型的属性是未初始化的。这可能会导致意外的行为如果属性初始化时持有价值。为了避免这种情况,确保所有属性初始化之前验证它们。

getter< /h3>
约束也可以应用于一个方法的返回值。欧宝娱乐app下载地址Symfony允许您添加一个约束任何公共方法的名字从“获得”开始,“是”或“有”。在本指南中,这些类型的方法被称为“getter”。

这种技术的优点是,它允许您验证您的动态对象。例如,假设您希望确保密码字段不匹配用户的名字(出于安全原因)。为此,您可以创建一个`isPasswordSafe ()`方法,然后声称这种方法必须返回`真正的`:

注释

YAML

XML

PHP

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;类作者{/ * * @Assert\ IsTrue(消息=“密码不能匹配你的名字”) /公共函数isPasswordSafe(){/ /……返回真或假}}`

1 2 3 4 5

`#配置/验证器/ validation.yaml应用实体\ \作者:getter方法:passwordSafe:- - - - - -“IsTrue”:{信息:“密码不能匹配你的名字”}`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

< !- - - - - -- - - - - -配置/验证器/有效的一个tion.xml -->< /span>< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><constraint-mappingxmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xsi: schemaLocation=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/constraint-mapping //www.oldmanjams.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd”><类的名字=“应用程序作者\实体\”><getter财产=“passwordSafe”><约束的名字=“IsTrue”><选项的名字=“消息”>密码不能匹配你的名字< /选项>< /约束>< /getter>< /类>< /constraint-mapping>

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

`/ / src /实体/ Author.php名称空间应用程序\实体;/ /……使用欧宝娱乐app下载地址\组件\验证器\约束作为断言;使用欧宝娱乐app下载地址\组件\验证器\映射\ClassMetadata;类作者{公共静态函数loadValidatorMetadata(ClassMetadata美元元数据){美元元数据- >addGetterConstraint (“passwordSafe”,新维护\ IsTrue ([“消息”= >“密码不能匹配你的名字”)));}}`

现在,创建`isPasswordSafe ()`方法,包括你所需要的逻辑:

1 2 3 4

`公共函数isPasswordSafe(){返回美元这- >firstName = = !美元这- >密码;}`

请注意

的眼光锐利的你会注意到getter的前缀(“得到”,“是”或“有”)省略在YAML的映射,XML和PHP格式。这允许您将约束以后具有相同名称的属性(反之亦然),而不改变你的验证逻辑。

类< /h3>
一些限制条件适用于整个类验证。例如,<一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Callback.html" class="reference internal">回调约束是一个通用的约束应用于类本身。验证该类时,指定的方法约束只是执行,以便每个可以提供更多的自定义验证。

最终的想法< /h2>
Symf欧宝娱乐app下载地址ony的`验证器`是一个功能强大的工具,可用于保证数据的对象是“有效的”。验证背后的权力在于“约束”,这是规定,可以适用于你的对象的属性或getter方法。虽然你会最常使用间接验证框架使用表单时,请记住,它可以在任何地方使用来验证任何对象。

了解更多< /h2>

如何创建一个定制的验证约束< /李><李><一个href="//www.oldmanjams.com/doc/5.1/validation/groups.html">如何应用只有一个子集的验证约束(验证组)< /李><李><一个href="//www.oldmanjams.com/doc/5.1/validation/raw_values.html">如何验证原始值(标量值和数组)< /李><李><一个href="//www.oldmanjams.com/doc/5.1/validation/sequence_provider.html">如何按顺序应用验证组吗< /李><李><一个href="//www.oldmanjams.com/doc/5.1/validation/severity.html">如何处理不同的误差水平< /李><李><一个href="//www.oldmanjams.com/doc/5.1/validation/translations.html">如何翻译验证约束消息< /李>< /ul>< /div>

这项工作,包括代码示例,许可下<一个rel="license" href="https://creativecommons.org/licenses/by-sa/3.0/">Creative Commons冲锋队3.0许可证。

欧宝下载链接

部署在

遵循Symfo欧宝娱乐app下载地址ny

验证

安装< /h2>
在应用程序中使用<一个href="//www.oldmanjams.com/doc/5.1/setup.html" class="reference internal">欧宝娱乐app下载地址Symfony Flex运行这个命令,安装在使用前验证器:

1

`美元作曲家要求symfony / va欧宝娱乐app下载地址lidator教义/注释`

支持限制< /h3>
欧宝娱乐app下载地址Symfony包很多最常用的限制:

验证

文件限制< /h3><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/File.html" class="reference internal">文件< /李><李><一个href="//www.oldmanjams.com/doc/5.1/reference/constraints/Image.html" class="reference internal">图像< /李>< /ul>< /div>

部署在

遵循Symfo欧宝娱乐app下载地址ny