php扩展ZF——Validate扩展

基础验证例子

之前写了一片文章关于如何在ZF0.6版本下扩展ZF的。这篇应该说是类似的文章,但环境换成ZF1.0RC1版本了。

复制代码 代码如下:
$validator = Validator::make(
array(‘name’ => ‘Dayle’),
array(‘name’ => ‘required|min:5’)
);

     在开始ZF扩展之前,推荐先看看ZF手册中的一些命令规范(ZF推荐使用),同时希望读者对ZF有较好的理解。如果没有,可以先上PHPCHIAN的ZF版本详细了解,或者到phpeye查找相关资料。

传递给 make
函数的第一个参数是待验证的数据,第二个参数是对该数据需要应用的验证规则。

      ZF的validator提供了强大的验证功能,但在实际的操作中还是过于烦琐。比如说验证邮件,是用ZF的代码如下

多个验证规则可以通过 “|” 字符进行隔开,或者作为数组的一个单独的元素。

<?php 

通过数组指定验证规则

require_once ‘Zend/Validate/EmailAddress.php’; 
$validator = new Zend_Validate_EmailAddress(); 
if ($validator->isValid($email)) { 
    // email appears to be valid 
} else { 
    // email is invalid; print the reasons 
    foreach ($validator->getMessages() as $message) { 
        echo “$messagen”; 
    } 

?> 

复制代码 代码如下:
$validator = Validator::make(
array(‘name’ => ‘Dayle’),
array(‘name’ => array(‘required’, ‘min:5’))
);

    有没有发现,还是很类似我们不使用ZF的验证方式。只不过ZF帮我们把邮件验证的细节封装好了。那么我们如何简化成这样效果呢?(下面是我扩展后的调用方式)

一旦一个 Validator 实例被创建,可以使用 fails (或者
passes)函数执行这个验证。

<?php 
$validate = new Phpbean_Validate(); 
        $validate -> set_breakOnFailure(false); 
        $validate -> add(’email’,new Zend_Validate_EmailAddress(),’邮件地址不正确!’); 
        $validate -> add(‘username’,new Zend_Validate_StringLength(3,15),’用户名长度必须在3到15之间!’%value%’不满足条件’); 
        $validate -> add(‘password’,new Zend_Validate_StringLength(6,20),’密码长度必须在6到20之间!’); 
        $validate -> add(‘password’,new Phpbean_Validate_isEqual($_POST[‘repassword’]),’两次输入密码不匹配’); 
澳门新葡萄京官网注册,        $authcode = new Phpbean_Img_Code(); 
        $validate -> add(‘yanxue8_authcode’,new Phpbean_Validate_isEqual($authcode->authcode($_POST[‘yanxue8_authcode_mdcode’],’DECODE’)),’验证码不匹配!’); 
        if( !$validate -> validator($_POST) ){ 
            error_page(‘注册失败’,$validate->getMessageText()); 
        } 
?> 

复制代码 代码如下:
if ($validator->fails())
{
// The given data did not pass validation
}
如果验证失败,您可以从验证器中获取错误消息。
复制代码 代码如下:
$messages = $validator->messages();

    用上面这种方式一方面代码清晰,另一方面也有利同意的出错处理。那么如何做到这样呢?
    关键是Phpbean_Validate这个类。
    其实实现起来很简单,Phpbean_Validate::add()方法是把一条条的验证规则加入进来。然后调用Phpbean_Validate::validator()来验证就OK了。
    具体实现步骤如下:
    首先,在zend的同级目录中增加一个phpbean文件夹,然后在里面增加一个Validator.php文件。
    然后,在validator.php文件加入Phpbean_Validate这个类的定义。注意(你可以修改成自己的文件名和路径名,但注意一定要和类的名称保持一致)。
    这里,我给出我的Phpbean_Validate类的实现过程,仅供参考。

您也可以使用 failed 函数得到不带错误消息的没有通过验证的规则的数组。
复制代码 代码如下:
$failed = $validator->failed();

<? 
class Phpbean_Validate{ 

文件验证

    protected $_fileds =array(); 

Validator 类提供了一些验证规则用于验证文件,比如
size、mimes等。在验证文件的时候,您可以和其他验证一样传递给验证器。

    protected $_message = array(); 

附带错误消息

    protected $_breakOnFailure = true; 

在一个 Validator 实例上调用 messages 函数之后,将会得到一个 MessageBag
实例,该实例拥有很多处理错误消息的方便的函数。

    public function set_breakOnFailure($value){ 
        $this->_breakOnFailure = $value; 
    } 

获取一个域的第一个错误消息

    public function add($key,$validate,$message=”,$breakOnFailure=”){ 
        if( empty($breakOnFailure) ) $breakOnFailure = $this->_breakOnFailure;  
        $this->_fileds[] = array($key,$validate,$message,$breakOnFailure); 
        return $this; 
    } 

复制代码 代码如下:
echo $messages->first(’email’);

    public function validator($array = array()){ 
        if(empty($array)) $array = $_POST; 
        if (is_array($this->_fileds)) { 
            foreach ($this->_fileds as $filed){ 
                list($key,$validate,$message,$breakOnFailure) = $filed; 

获取一个域的全部错误消息

                if(empty($key)){ 
                    if(!$validate){ 
                        $this->_message[][] = $message; 
                        if($breakOnFailure) break;  
                    } 
                    continue; 
                } 

复制代码 代码如下:
foreach ($messages->get(’email’) as $message)
{
//
}

                if(!empty($message)) $validate->setMessage($message); 
                if( !$validate->isValid($array[$key]) ){ 
                    $this->_message[$key][] = $validate->getMessages(); 
                    if($breakOnFailure) break;  
                } 
            } 
            if(!empty($this->_message))return false; 
            return true; 
        } 
        return true; 
    } 

获取全部域的全部错误消息
复制代码 代码如下:
foreach ($messages->all() as $message)
{
//
}

    public function getMessage(){ 
        return $this->_message; 
    } 
    public function getMessageText(){ 
        $str = ”; 
        foreach ($this->_message as $ms){ 
            foreach ($ms as $m) $str .= $m[0].”n”; 
        } 
        return $str; 
    } 

?> 

检查一个域是否存在消息
复制代码 代码如下:
if ($messages->has(’email’))
{
//
}

   另外你还可以直接扩展一些验证规则类。下篇我再详细说。 

以某种格式获取一条错误消息

复制代码 代码如下:
echo $messages->first(’email’, ‘

:message

‘);

  注意: 默认情况下,消息将使用与 Bootstrap 兼容的语法进行格式化。

  以某种格式获取所有错误消息
复制代码 代码如下:
  foreach ($messages->all(‘

:message

‘) as $message)
  {
  //
  }

错误消息 & 视图

一旦您执行了验证,您需要一种简单的方法向视图反馈错误消息。这在 Lavavel
中能够方便的处理。以下面的路由作为例子:

复制代码 代码如下:
Route::get(‘register’, function()
{
return View::make(‘user.register’);
});
Route::post(‘register’, function()
{
$rules = array(…);
$validator = Validator::make(Input::all(), $rules);
if ($validator->fails())
{
return Redirect::to(‘register’)->withErrors($validator);
}
});

注意当验证失败,我们使用 withErrors 函数把 Validator 实例传递给
Redirect。这个函数将刷新 Session
中保存的错误消息,使得在下次请求中能够可用。

然而,注意我们没有必要明确的在 GET 路由中绑定错误消息到路由。这是因为
Laravel 总会检查 Session
中的错误,并自动绑定它们到视图如果它们是可用的。所以,对于每个请求,一个
$errors 变量在所有视图中总是可用的,允许您方便的认为 $errors
总是被定义并可以安全使用的。$errors 变量将是一个 MessageBag 类的实例。

所以,在跳转之后,您可以在视图中使用自动绑定的 $errors 变量:

复制代码 代码如下:
first(’email’); ?>

  可用的验证规则

  下面是一个所有可用的验证规则的列表以及它们的功能:
复制代码 代码如下:
Accepted
 Active URL
 After (Date)
 Alpha
 Alpha Dash
 Alpha Numeric
 Before (Date)
 Between
 Confirmed
 Date
 Date Format
 Different
 E-Mail
 Exists (Database)
 Image (File)
 In
 Integer
 IP Address
 Max
 MIME Types
 Min
 Not In
 Numeric
 Regular Expression
 Required
 Required If
 Required With
 Required Without
 Same
 Size
 Unique (Database)

accepted

验证此规则的值必须是 yes、 on 或者是
1。这在验证是否同意”服务条款”的时候非常有用。

active_url

验证此规则的值必须是一个合法的 URL,根据 PHP 函数 checkdnsrr。

after:date

验证此规则的值必须在给定日期之后,日期将通过 PHP 函数 strtotime 传递。

alpha
  验证此规则的值必须全部由字母字符构成。

alpha_dash
  验证此规则的值必须全部由字母、数字、中划线或下划线字符构成。

alpha_num
  验证此规则的值必须全部由字母和数字构成。

before:date
  验证此规则的值必须在给定日期之前,日期将通过 PHP 函数 strtotime
传递。

between:min,max
  验证此规则的值必须在给定的 min 和 max
之间。字符串、数字以及文件都将使用大小规则进行比较。

confirmed
  验证此规则的值必须和 foo_confirmation
的值相同。比如,需要验证此规则的域是
password,那么在输入中必须有一个与之相同的 password_confirmation 域。

date
  验证此规则的值必须是一个合法的日期,根据 PHP 函数 strtotime。

date_format:format
  验证此规则的值必须符合给定的 format 的格式,根据 PHP 函数
date_parse_from_format。

different:field
  验证此规则的值必须与指定的 field 域的值不同。

email
  验证此规则的值必须是一个合法的电子邮件地址。

exists:table,column
  验证此规则的值必须在指定的数据库的表中存在。

  Exists 规则的基础使用

复制代码 代码如下:’state’ =>
‘exists:states’
指定列名
复制代码 代码如下:
‘state’ => ‘exists:states,abbreviation’

您也可以指定更多的条件,将以 “where” 的形式添加到查询。
复制代码 代码如下:
’email’ => ‘exists:staff,email,account_id,1’

image
  验证此规则的值必须是一个图片 (jpeg, png, bmp 或者 gif)。

  in:foo,bar,…

  验证此规则的值必须在给定的列表中存在。

  integer

  验证此规则的值必须是一个整数。

 
  验证此规则的值必须是一个合法的 IP 地址。

max:value

  验证此规则的值必须小于最大值
value。字符串、数字以及文件都将使用大小规则进行比较。

  mimes:foo,bar,…

  验证此规则的文件的 MIME 类型必须在给定的列表中。

  MIME 规则的基础使用

复制代码 代码如下:
‘photo’ => ‘mimes:jpeg,bmp,png’

min:value
  验证此规则的值必须大于最小值
value。字符串、数字以及文件都将使用大小规则进行比较。

not_in:foo,bar,…

  验证此规则的值必须在给定的列表中不存在。

numeric

  验证此规则的值必须是一个数字。

regex:pattern

  验证此规则的值必须符合给定的正则表达式。

  注意: 当使用 regex
模式的时候,有必要使用数组指定规则,而不是管道分隔符,特别是正则表达式中包含一个管道字符的时候。

required

  验证此规则的值必须在输入数据中存在。

required_if:field,value

  当指定的域为某个值的时候,验证此规则的值必须存在。

required_with:foo,bar,…

  仅当指定的域存在的时候,验证此规则的值必须存在。

required_without:foo,bar,…

  仅当指定的域不存在的时候,验证此规则的值必须存在。

same:field

  验证此规则的值必须与给定域的值相同。

size:value

验证此规则的值的大小必须与给定的 value 相同。对于字符串,value
代表字符的个数;对于数字,value 代表它的整数值,对于文件,value
代表文件以KB为单位的大小。

unique:table,column,except,idColumn

验证此规则的值必须在给定的数据库的表中唯一。如果 column
没有被指定,将使用该域的名字。

Unique 规则的基础使用
复制代码 代码如下:
’email’ => ‘unique:users’
指定列名
’email’ => ‘unique:users,email_address’
强制忽略一个给定的 ID
’email’ => ‘unique:users,email_address,10’

url

  验证此规则的值必须是一个合法的 URL。

  定制错误消息

  如果有需要,您可以使用定制的错误消息代替默认的消息。这里有好几种定制错误消息的方法。

  传递定制消息到验证器

复制代码 代码如下:
$messages = array(
 ’required’ => ‘The :attribute field is required.’,
 );
 $validator = Validator::make($input, $rules, $messages);

注意: :attribute
占位符将被实际的进行验证的域的名字代替,您也可以在错误消息中使用其他占位符。

其他验证占位符

复制代码 代码如下:
  $messages = array(
  ’same’ => ‘The :attribute and :other must match.’,
  ’size’ => ‘The :attribute must be exactly :size.’,
  ’between’ => ‘The :attribute must be between :min – :max.’,
  ’in’ => ‘The :attribute must be one of the following types:
:values’,
  );

  有些时候,您可能希望只对一个指定的域指定定制的错误消息:

  对一个指定的域指定定制的错误消息

复制代码 代码如下:
$messages = array(
’email.required’ => ‘We need to know your e-mail address!’,
);

在一些情况下,您可能希望在一个语言文件中指定错误消息而不是直接传递给
Validator。为了实现这个目的,请在 app/lang/xx/validation.php
文件中添加您的定制消息到 custom 数组。

在语言文件中指定错误消息

复制代码 代码如下:
‘custom’ => array(
’email’ => array(
‘required’ => ‘We need to know your e-mail address!’,
),
),

定制验证规则

Laravel
提供了一系列的有用的验证规则;但是,您可能希望添加自己的验证规则。其中一种方法是使用
Validator::extend 函数注册定制的验证规则:

注册一个定制的验证规则
复制代码 代码如下:
Validator::extend(‘foo’, function($attribute, $value, $parameters)
{
return $value == ‘foo’;
});

注意: 传递给 extend 函数的规则的名字必须符合 “snake cased” 命名规则。

  定制的验证器接受三个参数:待验证属性的名字、待验证属性的值以及传递给这个规则的参数。

  您也可以传递一个类的函数到 extend 函数,而不是使用闭包:
复制代码 代码如下:
  Validator::extend(‘foo’, ‘FooValidator@validate’);

  注意您需要为您的定制规则定义错误消息。您既可以使用一个行内的定制消息数组,也可以在验证语言文件中进行添加。

  您也可以扩展 Validator
类本身,而不是使用闭包回调扩展验证器。为了实现这个目的,添加一个继承自
IlluminateValidationValidator 的验证器类。您可以添加在类中添加以
validate 开头的验证函数:

扩展验证器类 复制代码 代码如下:
class CustomValidator extends IlluminateValidationValidator {
public function validateFoo($attribute, $value, $parameters)
{
return $value == ‘foo’;
}
}

下面,您需要注册定制的验证器扩展:

您需要注册定制的验证器扩展

复制代码 代码如下:
Validator::resolver(function($translator, $data, $rules, $messages)
{
return new CustomValidator($translator, $data, $rules, $messages);
});

  当创建一个定制的验证规则,您有时需要为错误消息定义一个定制的占位符。为了实现它,您可以像上面那样创建一个定制的验证器,并且在验证器中添加一个
replaceXXX 函数:
复制代码 代码如下:
protected function replaceFoo($message, $attribute, $rule,
$parameters)
{
return str_replace(‘:foo’, $parameters[0], $message);
}

发表评论

电子邮件地址不会被公开。 必填项已用*标注