Symfony數(shù)據(jù)校驗(yàn)方法實(shí)例分析

更新時(shí)間：2015年01月26日 10:21:38 投稿：shichen2014

這篇文章主要介紹了Symfony數(shù)據(jù)校驗(yàn)方法,實(shí)例分析了Symfony數(shù)據(jù)校驗(yàn)的常見(jiàn)技巧與注意事項(xiàng),具有一定參考借鑒價(jià)值,需要的朋友可以參考下

本文實(shí)例講述了Symfony數(shù)據(jù)校驗(yàn)方法。分享給大家供大家參考。具體分析如下：

校驗(yàn)在web應(yīng)用程序中是一個(gè)常見(jiàn)的任務(wù)。數(shù)據(jù)輸入到表單需要被校驗(yàn)。數(shù)據(jù)在被寫(xiě)入數(shù)據(jù)庫(kù)之前或者傳入一個(gè)webservice時(shí)也需要被校驗(yàn)。

Symfony2 配備了一個(gè)Validator 組件，它讓校驗(yàn)工作變得簡(jiǎn)單易懂。該組件是基于JSR303 Bean校驗(yàn)規(guī)范。一個(gè)Java規(guī)范用在PHP中。

基本驗(yàn)證

理解校驗(yàn)的最好方法是看它的表現(xiàn)。首先，假設(shè)你已經(jīng)創(chuàng)建了一個(gè)用于你應(yīng)用程序某個(gè)地方的PHP對(duì)象。

復(fù)制代碼代碼如下:

//src/Acme/BlogBundle/Entity/Author.php
namespace Acme\BlogBundle\Entity;

class Author
{
public $name;
}

到現(xiàn)在為止，它只是個(gè)服務(wù)于你應(yīng)用程序的某些目的的普通的類(lèi)。而校驗(yàn)的目的就是要告訴你對(duì)象的數(shù)據(jù)是否合法。為了這個(gè)目的，你需要配置一個(gè)對(duì)象必須遵守規(guī)則或者約束列表來(lái)讓自己的數(shù)據(jù)合法。這些規(guī)則可以被描述成多種不同的格式的（比如，YAML，XML，類(lèi)聲明或者PHP）。比如，我們保證屬性$name不能為空，來(lái)添加下面的規(guī)則：

YAML格式：

復(fù)制代碼代碼如下:

# src/Acme/BlogBundle/Resources/config/validation.yml

Acme\BlogBundle\Entity\Author:

    properties:

         name:

            - NotBlank: ~

類(lèi)聲明格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Constraints as Assert;

class Author
{
   /**
    * @Assert\NotBlank()
    */
    public $name;
}

XML格式：

復(fù)制代碼代碼如下:

<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

PHP代碼格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php

use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\NotBlank;

class Author
{
   public $name;

   public static function loadValidatorMetadata(ClassMetadata $metadata)
   {
       $metadata->addPropertyConstraint('name', new NotBlank());
   }
}

Protected和private屬性以及getter方法也都可以被校驗(yàn)。

使用validator服務(wù)：

接下來(lái)，使用validator服務(wù)的validate方法來(lái)真正的校驗(yàn)Author對(duì)象。 validator的工作很簡(jiǎn)單：讀取一個(gè)類(lèi)的約束規(guī)則來(lái)校驗(yàn)一個(gè)對(duì)象的數(shù)據(jù)是否符合這些規(guī)則約束。如果校驗(yàn)失敗，一個(gè)錯(cuò)誤數(shù)組將被返回。現(xiàn)在我們?cè)谝粋€(gè)controller中來(lái)執(zhí)行它：

復(fù)制代碼代碼如下:

use Symfony\Component\HttpFoundation\Response;
use Acme\BlogBundle\Entity\Author;
//...

public function indexAction()
{
   $author = new Author();
   //... 對(duì)$auother對(duì)象做些什么

   $validator = $this->get('validator');
   $errors = $validator->validate($author);

   if(count($errors) >0){
     return new Response(print_r($errors, true));
   }else{
     return new Response('The author is valid! Yes!');
   }
}

如果$name 屬性為空，你將看到下面的錯(cuò)誤信息：

Acme\BlogBundle\Author.name:
This value should not be blank

如果你為$name屬性插入一個(gè)值，那么你會(huì)獲得快樂(lè)的成功信息。

大多數(shù)時(shí)候，你不需要直接跟validator服務(wù)交流或者根本不需要擔(dān)心打印出錯(cuò)誤來(lái)。

大多數(shù)情況下，你將在處理提交表單數(shù)據(jù)時(shí)間接使用校驗(yàn)。

你也可以傳遞一個(gè)錯(cuò)誤信息集合到一個(gè)模版：

復(fù)制代碼代碼如下:

if(count($errors)>0){

   return $this->render('AcmeBlogBundle:Author:validate.html.twig',array(

        'errors' => $errors,

   ));

}else{

  //...

}

在模版中，你可以根據(jù)需要精確的輸出錯(cuò)誤列表：

Twig格式：

復(fù)制代碼代碼如下:

{# src/Acme/BlogBundle/Resources/views/Author/validate.html.twig #}

<h3>The author has the following errros</h3>

<ul>

{% for error in errors %}

    <li>{{ error.message }}</li>

{% endfor %}

</ul>

校驗(yàn)和表單

validator服務(wù)可以被用于任何時(shí)候校驗(yàn)任何對(duì)象。事實(shí)上，你將經(jīng)常在處理表單時(shí)間接使用validator。Symfony的表單類(lèi)庫(kù)間接使用validator服務(wù)來(lái)在數(shù)據(jù)被提交和綁定后校驗(yàn)底層對(duì)象。對(duì)象違反約束信息將被轉(zhuǎn)化到FieldError對(duì)象，該對(duì)象可以很容易的被展示在你的表單中。在一個(gè)controller中的傳統(tǒng)表單提交流程如下：

復(fù)制代碼代碼如下:

use Acme\BlogBundle\Entity\Author;
use Acme\BlogBundle\Form\AuthorType;
use Acme\Component\HttpFoundation\Request;
//...

public function updateAction(Request $request)
{
$author = new Acme\BlogBundle\Entity\Author();
$form = $this->createForm(new AuthorType(),$author);

    if($request->getMethod() =='POST'){
       $form->bindRequest($request);

       if($form->isvalid()){
          //對(duì)$author做一些操作
          return $this->redirect($this->generateUrl('...'));
       }
     }

     return $this->render('BlogBundle:Author:form.html.twig',array(
         'form' => $form->createView(),
     ));
}

配置：

Symfony2 的validator默認(rèn)情況下是可用的。但是如果你使用了生命方法來(lái)指定你的約束，那么你需要顯式的開(kāi)啟聲明功能：

YAML格式：

復(fù)制代碼代碼如下:

# app/config/config.yml

framework:

   validation: {enable_annotations: true }

XML格式：

復(fù)制代碼代碼如下:

<!-- app/config/config.xml -->

<framework:config>

   <framework:validation enable-annotations="true" />

</framework:config>

PHP代碼格式：

復(fù)制代碼代碼如下:

// app/config/config.php

$contianer->loadFromExtension('framework',array('validation'=> array(

     'enable_annotations'=>true,

)));

約束規(guī)則

Validator是設(shè)計(jì)了用來(lái)按照約束規(guī)則校驗(yàn)對(duì)象的。為了校驗(yàn)一個(gè)對(duì)象，只需要映射一個(gè)或者多個(gè)約束到它要校驗(yàn)的類(lèi)然后把它傳遞給validator服務(wù)即可。

本質(zhì)上，一個(gè)約束就是一個(gè)簡(jiǎn)單的PHP對(duì)象，它可以生成一個(gè)決斷語(yǔ)句。在現(xiàn)實(shí)生活中，一個(gè)約束可以是"蛋糕不能烤焦了" 這樣的規(guī)則約束。在Symfony2中，約束都差不多：他們決斷某個(gè)條件是否成立。給定一個(gè)值，約束會(huì)告訴你這個(gè)值是否遵守了你的約束規(guī)則。

Symfony2 支持的約束規(guī)則

首先是基礎(chǔ)約束規(guī)則：使用他們來(lái)決斷非?；镜氖拢热缒銓?duì)象屬性的值或者方法的返回值。

NotBlank，Blank，NotNull，Null，True,False,Type

　　字符串約束：Email,MinLength,MaxLength,Url,Regex,Ip等
　　數(shù)字約束：Max，Min
　　日期約束：Date,DateTime和Time
　　集合約束：Choice，Collection，UniqueEntity，Language，Locale和Country等。
　　文件約束：File,Image
　　其它約束：Callback,All,Valid

你也可以創(chuàng)建自己的自定義約束。

約束配置：

一些約束，比如NotBlank,很簡(jiǎn)單，但是其它的比如Choice約束，有許多配置項(xiàng)需要設(shè)置。假設(shè)Author類(lèi)有另外一個(gè)屬性，gener可以被設(shè)置為”male"或者"female":

YAML格式：

復(fù)制代碼代碼如下:

# src/Acme/BlogBundle/Resources/config/validation.yml

Acme\BlogBundle\Entity\Author:

    properties:

         gener:

            - Choice: { choices: [male, female], message: Choos a valid gender. }

類(lèi)聲明格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Constraints as Assert;

class Author
{
   /**
    * @Assert\Choice(
    *     choices = {"male","female"},
    *     message = "Choose a valid gender."
    * )
    */
    public $gender;
}

XML格式：

復(fù)制代碼代碼如下:

    <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代碼格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\NotBlank;

class Author
{
public $gender;

    public static function loadValidatorMetadata(ClassMetadata $metadata)
    {
        $metadata->addPropertyConstraint('gender', new Choice(array(
            'choices' => array('male', 'female'),
            'message' => 'Choose a valid gender.',
        )));
    }
}

一個(gè)約束的選項(xiàng)通常都是通過(guò)一個(gè)數(shù)組來(lái)傳遞的。有些約束也允許你傳遞一個(gè)值。"default"在數(shù)組中是可選的。在Choice約束時(shí)，choices選項(xiàng)就可以通過(guò)這種方式指定。

YAML格式：

復(fù)制代碼代碼如下:

# src/Acme/BlogBundle/Resources/config/validation.yml

Acme\BlogBundle\Entity\Author:

    properties:

        gender:

            - Choice: [male, female]

類(lèi)聲明格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Constraints as Assert;

class Author
{
    /**
     * @Assert\Choice({"male", "female"})
     */
    protected $gender;
}

XML格式：

復(fù)制代碼代碼如下:

    <class name="Acme\BlogBundle\Entity\Author">
        <property name="gender">
            <constraint name="Choice">
                <value>male</value>
                <value>female</value>
            </constraint>
        </property>
    </class>
</constraint-mapping>

PHP格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\Choice;

class Author
{
protected $gender;

    public static function loadValidatorMetadata(ClassMetadata $metadata)
    {
        $metadata->addPropertyConstraint('gender', new Choice(array('male', 'female')));
    }
}

約束目標(biāo)

約束可以被用于一個(gè)類(lèi)的屬性或者一個(gè)公共的getter方法。屬性約束最常用也最簡(jiǎn)單，而公共的getter方法約束則允許你指定一個(gè)復(fù)雜的約束規(guī)則。

屬性約束：

校驗(yàn)類(lèi)的屬性石一個(gè)最常規(guī)的校驗(yàn)技術(shù)。Symfony2允許你校驗(yàn)private,protected或者public屬性。下面代碼顯示如何配置Author對(duì)象的$firstName屬性至少有3個(gè)字符：

YAML格式：

復(fù)制代碼代碼如下:

# src/Acme/BlogBundle/Resources/config/validation.yml

Acme\BlogBundle\Entity\Author:

    properties:

        firstName:

            - NotBlank: ~

            - MinLength: 3

類(lèi)聲明格式：

復(fù)制代碼代碼如下:

// Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Constraints as Assert;

class Author
{
    /**
     * @Assert\NotBlank()
     * @Assert\MinLength(3)
     */
    private $firstName;
}

XML格式：

復(fù)制代碼代碼如下:

<!-- src/Acme/BlogBundle/Resources/config/validation.xml -->

<class name="Acme\BlogBundle\Entity\Author">

    <property name="firstName">

        <constraint name="NotBlank" />

        <constraint name="MinLength">3</constraint>

    </property>

</class>

PHP代碼格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\NotBlank;
use Symfony\Component\Validator\Constraints\MinLength;

class Author
{
private $firstName;

    public static function loadValidatorMetadata(ClassMetadata $metadata)
    {
        $metadata->addPropertyConstraint('firstName', new NotBlank());
        $metadata->addPropertyConstraint('firstName', new MinLength(3));
    }
}

Getters

約束也可以應(yīng)用于一個(gè)方法的返回值。Symfony2 允許你添加一個(gè)約束到任何"get"或者 "is"開(kāi)頭的public方法。該技術(shù)的好處是允許你動(dòng)態(tài)的校驗(yàn)?zāi)愕膶?duì)象。比如，假設(shè)你想確認(rèn)密碼字段不匹配用戶(hù)的first name(因?yàn)榘踩?。你可以通過(guò)創(chuàng)建一個(gè)idPasswordLegal 方法，然后決斷這個(gè)方法必須返回true:

YAML格式：

復(fù)制代碼代碼如下:

# src/Acme/BlogBundle/Resources/config/validation.yml

Acme\BlogBundle\Entity\Author:

    getters:

        passwordLegal:

            - "True": { message: "The password cannot match your first name" }

類(lèi)聲明格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Constraints as Assert;

class Author
{
    /**
     * @Assert\True(message = "The password cannot match your first name")
     */
    public function isPasswordLegal()
    {
        // return true or false
    }
}

XML格式:

復(fù)制代碼代碼如下:

<!-- src/Acme/BlogBundle/Resources/config/validation.xml -->

<class name="Acme\BlogBundle\Entity\Author">

    <getter property="passwordLegal">

        <constraint name="True">

            <option name="message">The password cannot match your first name</option>

        </constraint>

    </getter>

</class>

PHP代碼格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/Author.php
use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\True;

class Author
{
    public static function loadValidatorMetadata(ClassMetadata $metadata)
    {
        $metadata->addGetterConstraint('passwordLegal', new True(array(
            'message' => 'The password cannot match your first name',
        )));
    }
}

現(xiàn)在我們創(chuàng)建一個(gè)isPasswordLegal()方法，并且包含你需要邏輯：

復(fù)制代碼代碼如下:

public function isPasswordLegal()

{

   return ($this->firstName != $this->password);

}

眼尖的人可能會(huì)注意到getter的前綴("get"或者"is")在映射時(shí)被忽略了。這允許你在不改變校驗(yàn)規(guī)則的前提下，把一個(gè)約束移動(dòng)到一個(gè)具有同名屬性上，反之亦然。

類(lèi)：

一些約束應(yīng)用到整個(gè)類(lèi)被校驗(yàn)上面。比如，Callback約束是一個(gè)通用約束，它可以應(yīng)用到類(lèi)自身。當(dāng)類(lèi)被校驗(yàn)時(shí)，被約束描述的方法只是被執(zhí)行這樣每一個(gè)可以提供更個(gè)性化的校驗(yàn)。

校驗(yàn)分組

到目前為止，你已經(jīng)能夠添加約束到類(lèi)并詢(xún)問(wèn)是否該類(lèi)傳入所有定義的約束規(guī)則。一些情況下，你只需要使用該類(lèi)的其中某些規(guī)則來(lái)校驗(yàn)一個(gè)對(duì)象。要做到這些，你可以組織每一個(gè)約束到一個(gè)或者多個(gè)校驗(yàn)組中，然后應(yīng)用使用其中一組校驗(yàn)。比如，假設(shè)你有一個(gè)User類(lèi)，它會(huì)在用戶(hù)注冊(cè)和用戶(hù)更新他們的聯(lián)系信息時(shí)使用。

YAML格式：

復(fù)制代碼代碼如下:

# src/Acme/BlogBundle/Resources/config/validation.yml

Acme\BlogBundle\Entity\User:

    properties:

        email:

            - Email: { groups: [registration] }

        password:

            - NotBlank: { groups: [registration] }

            - MinLength: { limit: 7, groups: [registration] }

        city:

            - MinLength: 2

類(lèi)聲明格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/User.php
namespace Acme\BlogBundle\Entity;

use Symfony\Component\Security\Core\User\UserInterface;
use Symfony\Component\Validator\Constraints as Assert;

class User implements UserInterface
{
    /**
    * @Assert\Email(groups={"registration"})
    */
    private $email;

    /**
    * @Assert\NotBlank(groups={"registration"})
    * @Assert\MinLength(limit=7, groups={"registration"})
    */
    private $password;

    /**
    * @Assert\MinLength(2)
    */
    private $city;
}

XML格式：

復(fù)制代碼代碼如下:

<!-- src/Acme/BlogBundle/Resources/config/validation.xml -->

<class name="Acme\BlogBundle\Entity\User">

    <property name="email">

        <constraint name="Email">

            <option name="groups">

                <value>registration</value>

            </option>

        </constraint>

    </property>

    <property name="password">

        <constraint name="NotBlank">

            <option name="groups">

                <value>registration</value>

            </option>

        </constraint>

        <constraint name="MinLength">

            <option name="limit">7</option>

            <option name="groups">

                <value>registration</value>

            </option>

        </constraint>

    </property>

    <property name="city">

        <constraint name="MinLength">7</constraint>

    </property>

</class>

PHP代碼格式：

復(fù)制代碼代碼如下:

// src/Acme/BlogBundle/Entity/User.php
namespace Acme\BlogBundle\Entity;

use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\Email;
use Symfony\Component\Validator\Constraints\NotBlank;
use Symfony\Component\Validator\Constraints\MinLength;

class User
{
    public static function loadValidatorMetadata(ClassMetadata $metadata)
    {
        $metadata->addPropertyConstraint('email', new Email(array(
            'groups' => array('registration')
        )));

        $metadata->addPropertyConstraint('password', new NotBlank(array(
            'groups' => array('registration')
        )));
        $metadata->addPropertyConstraint('password', new MinLength(array(
            'limit' => 7,
            'groups' => array('registration')
        )));

$metadata->addPropertyConstraint('city', new MinLength(3));
}
}

這里我們配置了兩個(gè)校驗(yàn)組：
default默認(rèn)組：包括所有沒(méi)有分配到任何組的約束規(guī)則
registration: 只包含了email和password字段的校驗(yàn)規(guī)則

告訴validator使用指定的校驗(yàn)組，傳一個(gè)或者多個(gè)組名作為validate()方法的第二個(gè)參數(shù)即可：

復(fù)制代碼代碼如下:

$errors = $validator->validate($author,array('registration'));

值和數(shù)組校驗(yàn)

到目前為止，我們已經(jīng)看了如何校驗(yàn)整個(gè)對(duì)象。但是有時(shí)候，我們可能想值校驗(yàn)一個(gè)單獨(dú)的值，比如校驗(yàn)一個(gè)字符串是不是一個(gè)合法的email地址。這非常簡(jiǎn)單，在Controller類(lèi)中進(jìn)行如下：

復(fù)制代碼代碼如下:

// 在controller類(lèi)前引用相應(yīng)的校驗(yàn)命名空間
use Symfony\Component\Validator\Constraints\Email;

public function addEmailAction($email)
{
    $emailConstraint = new Email();
    // 所有的校驗(yàn)選項(xiàng)（options）都可以這樣設(shè)置
    $emailConstraint->message = 'Invalid email address';

// 使用validator來(lái)校驗(yàn)一個(gè)值
$errorList = $this->get('validator')->validateValue($email, $emailConstraint);

    if (count($errorList) == 0) {
        // 這是一個(gè)合法的email地址，可以做些什么
    } else {
        // 這是一個(gè)非法的email地址
        $errorMessage = $errorList[0]->getMessage()

// 做一些錯(cuò)誤處理
}

// ...
}

通過(guò)調(diào)用validator的validateValue方法，你可以傳入一個(gè)原始值和一個(gè)你要使用的校驗(yàn)對(duì)象。該方法會(huì)返回一個(gè)ConstraintViolationList對(duì)象，它扮演的只是一個(gè)錯(cuò)誤信息數(shù)組的角色。集合中的每一個(gè)錯(cuò)誤是一個(gè)ConstraintViolation對(duì)象，使用對(duì)象的getMessage方法可以獲取錯(cuò)誤信息。

總結(jié)：

Symfony2 的validator是一個(gè)強(qiáng)大的工具，它可以被用來(lái)保證任何對(duì)象數(shù)據(jù)的合法性。它的強(qiáng)大來(lái)源于約束規(guī)則，你可以把它們應(yīng)用于你對(duì)象的屬性和getter方法。其實(shí)，你大多數(shù)情況下都是在使用表單時(shí)，間接的應(yīng)用了校驗(yàn)框架，記住它可以被應(yīng)用于任何地方校驗(yàn)任何對(duì)象。

希望本文所述對(duì)大家的Symfony框架程序設(shè)計(jì)有所幫助。

您可能感興趣的文章: