《PHP实战：Symfony数据校验方法实例分析》要点：
本文介绍了PHP实战：Symfony数据校验方法实例分析，希望对您有用。如果有疑问，可以联系我们。
PHP应用本文实例讲述了Symfony数据校验办法.分享给大家供大家参考.具体分析如下：
PHP应用校验在web应用程序中是一个常见的任务.数据输入到表单需要被校验.数据在被写入数据库之前或者传入一个webservice时也需要被校验.
PHP应用Symfony2 配备了一个Validator 组件,它让校验工作变得简单易懂.该组件是基于JSR303 Bean校验规范.一个Java规范用在PHP中.
PHP应用基本验证
PHP应用理解校验的最好办法是看它的表现.首先,假设你已经创建了一个用于你应用程序某个地方的PHP对象.
PHP应用class Author
{
public $name;
}
PHP应用到现在为止,它只是个服务于你应用程序的某些目的的普通的类.而校验的目的就是要告诉你对象的数据是否合法.为了这个目的,你需要配置一个对象必须遵守规则或者约束列表来让自己的数据合法.这些规则可以被描述成多种不同的格式的(比如,YAML,XML,类声明或者PHP).比如,我们保证属性$name不能为空,来添加下面的规则：
PHP应用YAML格式：
PHP应用class Author
{
/**
* @Assert\NotBlank()
*/
public $name;
}
PHP应用XML格式：
PHP应用 <class name="Acme\BlogBundle\Entity\Author">
<property name="name">
<constraint name="NotBlank" />
</property>
</class>
</constraint-mapping>
PHP应用PHP代码格式：
PHP应用use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\NotBlank;
PHP应用class Author
{
public $name;
public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('name', new NotBlank());
}
}
PHP应用Protected和private属性以及getter办法也都可以被校验.
PHP应用使用validator服务：
PHP应用接下来,使用validator服务的validate办法来真正的校验Author对象. validator的工作很简单：读取一个类的约束规则来校验一个对象的数据是否符合这些规则约束.如果校验失败,一个错误数组将被返回.现在我们在一个controller中来执行它：
PHP应用public function indexAction()
{
$author = new Author();
//... 对$auother对象做些什么
$validator = $this->get('validator');
$errors = $validator->validate($author);
PHP应用 if(count($errors) >0){
return new Response(print_r($errors, true));
}else{
return new Response('The author is valid! Yes!');
}
}
PHP应用如果$name 属性为空,你将看到下面的错误信息：
PHP应用Acme\BlogBundle\Author.name:
This value should not be blank
PHP应用如果你为$name属性插入一个值,那么你会获得快乐的成功信息.
PHP应用大多数时候,你不需要直接跟validator服务交流或者根本不需要担心打印出错误来.
PHP应用大多数情况下,你将在处理提交表单数据时间接使用校验.
PHP应用你也可以传递一个错误信息集合到一个模版：
PHP应用在模版中,你可以根据需要精确的输出错误列表：
PHP应用Twig格式：
PHP应用校验和表单
PHP应用validator服务可以被用于任何时候校验任何对象. 事实上,你将经常在处理表单时间接使用validator.Symfony的表单类库间接使用validator服务来在数据被提交和绑定后校验底层对象.对象违反约束信息将被转化到FieldError对象,该对象可以很容易的被展示在你的表单中.在一个controller中的传统表单提交流程如下：
PHP应用public function updateAction(Request $request)
{
$author = new Acme\BlogBundle\Entity\Author();
$form = $this->createForm(new AuthorType(),$author);
PHP应用 if($request->getMethod() =='POST'){
$form->bindRequest($request);
if($form->isvalid()){
//对$author做一些操作
return $this->redirect($this->generateUrl('...'));
}
}
PHP应用 return $this->render('BlogBundle:Author:form.html.twig',array(
'form' => $form->createView(),
));
}
PHP应用配置：
PHP应用Symfony2 的validator默认情况下是可用的.但是如果你使用了生命办法来指定你的约束,那么你需要显式的开启声明功能：
PHP应用YAML格式：
PHP应用约束规则
PHP应用Validator是设计了用来依照约束规则校验对象的.为了校验一个对象,只需要映射一个或者多个约束到它要校验的类然后把它传递给validator服务即可.
PHP应用本质上,一个约束就是一个简单的PHP对象,它可以生成一个决断语句. 在现实生活中,一个约束可以是"蛋糕不能烤焦了" 这样的规则约束.在Symfony2中,约束都差不多：他们决断某个条件是否成立.给定一个值,约束会告诉你这个值是否遵守了你的约束规则.
PHP应用Symfony2 支持的约束规则
PHP应用首先是基础约束规则：使用他们来决断非常基本的事,比如你对象属性的值或者办法的返回值.
PHP应用NotBlank,Blank,NotNull,Null,True,False,Type
PHP应用 字符串约束：Email,MinLength,MaxLength,Url,Regex,Ip等
数字约束：Max,Min
日期约束：Date,DateTime和Time
集合约束：Choice,Collection,UniqueEntity,Language,Locale和Country等.
文件约束：File,Image
其它约束：Callback,All,Valid
PHP应用你也可以创建自己的自定义约束.
PHP应用约束配置：
PHP应用一些约束,比如NotBlank,很简单,但是其它的比如Choice约束,有许多配置项需要设置.假设Author类有另外一个属性,gener可以被设置为”male"或者"female":
PHP应用YAML格式：
PHP应用class Author
{
/**
* @Assert\Choice(
* choices = {"male","female"},
* message = "Choose a valid gender."
* )
*/
public $gender;
}
PHP应用XML格式：
PHP应用 <class name="Acme\BlogBundle\Entity\Author">
<property name="gender">
<constraint name="Choice">
<option name="choices">
<value>male</value>
<value>female</value>
</option>
<option name="message">Choose a valid gender.</option>
</constraint>
</property>
</class>
</constraint-mapping>
PHP应用PHP代码格式：
PHP应用class Author
{
public $gender;
PHP应用 public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('gender', new Choice(array(
'choices' => array('male', 'female'),
'message' => 'Choose a valid gender.',
)));
}
}
PHP应用一个约束的选项通常都是通过一个数组来传递的.有些约束也允许你传递一个值."default"在数组中是可选的.在Choice约束时,choices选项就可以通过这种方式指定.
PHP应用YAML格式：
PHP应用class Author
{
/**
* @Assert\Choice({"male", "female"})
*/
protected $gender;
}
PHP应用XML格式：
PHP应用 <class name="Acme\BlogBundle\Entity\Author">
<property name="gender">
<constraint name="Choice">
<value>male</value>
<value>female</value>
</constraint>
</property>
</class>
</constraint-mapping>
PHP应用PHP格式：
PHP应用class Author
{
protected $gender;
PHP应用 public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('gender', new Choice(array('male', 'female')));
}
}
PHP应用约束目标
PHP应用约束可以被用于一个类的属性或者一个公共的getter办法.属性约束最常用也最简单,而公共的getter办法约束则允许你指定一个复杂的约束规则.
PHP应用属性约束：
PHP应用校验类的属性石一个最常规的校验技术.Symfony2允许你校验private,protected或者public属性.下面代码显示如何配置Author对象的$firstName属性至少有3个字符：
PHP应用YAML格式：
PHP应用class Author
{
/**
* @Assert\NotBlank()
* @Assert\MinLength(3)
*/
private $firstName;
}
PHP应用XML格式：
PHP应用PHP代码格式：
PHP应用class Author
{
private $firstName;
PHP应用 public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('firstName', new NotBlank());
$metadata->addPropertyConstraint('firstName', new MinLength(3));
}
}
PHP应用Getters
PHP应用约束也可以应用于一个方法的返回值.Symfony2 允许你添加一个约束到任何"get"或者 "is"开头的public方法.该技术的好处是允许你动态的校验你的对象.比如,假设你想确认密码字段不匹配用户的first name(因为平安原因).你可以通过创建一个idPasswordLegal 方法,然后决断这个方法必须返回true:
PHP应用YAML格式：
PHP应用class Author
{
/**
* @Assert\True(message = "The password cannot match your first name")
*/
public function isPasswordLegal()
{
// return true or false
}
}
PHP应用XML格式:
PHP应用PHP代码格式：
PHP应用class Author
{
public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addGetterConstraint('passwordLegal', new True(array(
'message' => 'The password cannot match your first name',
)));
}
}
PHP应用现在我们创建一个isPasswordLegal()办法,并且包含你需要逻辑：
PHP应用类：
PHP应用一些约束应用到整个类被校验上面.比如,Callback约束是一个通用约束,它可以应用到类自身.当类被校验时,被约束描述的办法只是被执行这样每一个可以提供更个性化的校验.
PHP应用校验分组
PHP应用到目前为止,你已经能够添加约束到类并询问是否该类传入所有定义的约束规则.一些情况下,你只需要使用该类的其中某些规则来校验一个对象.要做到这些,你可以组织每一个约束到一个或者多个校验组中,然后应用使用其中一组校验.比如,假设你有一个User类,它会在用户注册和用户更新他们的联系信息时使用.
PHP应用YAML格式：
PHP应用类声明格式：
PHP应用use Symfony\Component\Security\Core\User\UserInterface;
use Symfony\Component\Validator\Constraints as Assert;
PHP应用class User implements UserInterface
{
/**
* @Assert\Email(groups={"registration"})
*/
private $email;
PHP应用 /**
* @Assert\NotBlank(groups={"registration"})
* @Assert\MinLength(limit=7, groups={"registration"})
*/
private $password;
PHP应用 /**
* @Assert\MinLength(2)
*/
private $city;
}
PHP应用XML格式：
PHP应用PHP代码格式：
PHP应用use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\Email;
use Symfony\Component\Validator\Constraints\NotBlank;
use Symfony\Component\Validator\Constraints\MinLength;
PHP应用class User
{
public static function loadValidatorMetadata(ClassMetadata $metadata)
{
$metadata->addPropertyConstraint('email', new Email(array(
'groups' => array('registration')
)));
PHP应用 $metadata->addPropertyConstraint('password', new NotBlank(array(
'groups' => array('registration')
)));
$metadata->addPropertyConstraint('password', new MinLength(array(
'limit' => 7,
'groups' => array('registration')
)));
PHP应用 $metadata->addPropertyConstraint('city', new MinLength(3));
}
}
PHP应用这里我们配置了两个校验组：
default默认组： 包括所有没有分配到任何组的约束规则
registration: 只包含了email和password字段的校验规则
PHP应用告诉validator使用指定的校验组,传一个或者多个组名作为validate()办法的第二个参数即可：
PHP应用值和数组校验
PHP应用到目前为止,我们已经看了如何校验整个对象.但是有时候,我们可能想值校验一个单独的值,比如校验一个字符串是不是一个合法的email地址.这非常简单,在Controller类中进行如下：
PHP应用public function addEmailAction($email)
{
$emailConstraint = new Email();
// 所有的校验选项(options)都可以这样设置
$emailConstraint->message = 'Invalid email address';
PHP应用 // 使用validator来校验一个值
$errorList = $this->get('validator')->validateValue($email, $emailConstraint);
PHP应用 if (count($errorList) == 0) {
// 这是一个合法的email地址,可以做些什么
} else {
// 这是一个非法的email地址
$errorMessage = $errorList[0]->getMessage()
PHP应用 // 做一些错误处理
}
PHP应用 // ...
}
PHP应用通过调用validator的validateValue办法,你可以传入一个原始值和一个你要使用的校验对象.该办法会返回一个ConstraintViolationList对象,它扮演的只是一个错误信息数组的角色.集合中的每一个错误是一个ConstraintViolation对象,使用对象的getMessage办法可以获取错误信息.
PHP应用总结：
PHP应用Symfony2 的validator是一个强大的工具,它可以被用来保证任何对象数据的合法性.它的强大来源于约束规则,你可以把它们应用于你对象的属性和getter办法.其实,你大多数情况下都是在使用表单时,间接的应用了校验框架,记住它可以被应用于任何地方校验任何对象.
PHP应用希望本文所述对大家的Symfony框架程序设计有所赞助.
欢迎参与《PHP实战：Symfony数据校验方法实例分析》讨论，分享您的想法，维易PHP学院为您提供专业教程。
