《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學院為您提供專業教程。
