Yii Framework2.0开发教程（8）输入验证

jerry Yii2 2015年11月23日收藏

validate() 方法，在幕后为执行验证操作。先看一个简单的例子，例子的代码在《Yii Framework2.0开发教程（2）使用表单Form》。

类ZhyoulunController中函数actionEntry() ，其中有一句$model->validate()，就是来判断输入的名字和电子邮件是否正确。

修改models/EntryForm.php

<?php
 
namespace app\models;
 
use yii\base\Model;
 
class EntryForm extends Model
{
    public $name;
    public $email;
 
    public function rules()
    {
        return [
            ['name', 'required','message'=>'名称不可缺省'],
            ['email', 'required','message'=>'邮件不能缺省'],
						['email', 'email','message'=>'电子邮件格式不正确'],
        ];
    }
}

可以看到如下表现

都不输入

邮件格式错误

输入都正确

很容易和我们修改后的代码对应。

validate() 方法，在幕后为执行验证操作，进行了以下步骤：

1、通过从 [[yii\base\Model::scenarios()]] 方法返回基于当前 [[yii\base\Model::scenario|场景（scenario）]] 的特性属性列表，算出哪些特性应该进行有效性验证。这些属性被称作active attributes（激活特性）。

2、通过从 [[yii\base\Model::rules()]] 方法返回基于当前 [[yii\base\Model::scenario|场景（scenario）]] 的验证规则列表，这些规则被称作active rules（激活规则）。

3、用每个激活规则去验证每个与之关联的激活特性。若失败，则记录下对应模型特性的错误信息。

rules()函数的语法

[
    // 必须项，用于指定那些模型特性需要通过此规则的验证。
    // 对于只有一个特性的情况，可以直接写特性名，而不必用数组包裹。
    ['attribute1', 'attribute2', ...],
 
    // 必填项，用于指定【规则的类型】。
    // 它可以是类名，验证器昵称，或者是验证方法的名称。
    'validator',
 
    // 可选项，用于指定在场景（scenario）中，需要启用该规则
    // 若不提供，则代表该规则适用于所有场景
    // 若你需要提供除了某些特定场景以外的所有其他场景，你也可以配置 "except" 选项
    'on' => ['scenario1', 'scenario2', ...],
 
    // 可选项，用于指定对该验证器对象的其他配置选项
    'property1' => 'value1', 'property2' => 'value2', ...
]

你可以指定以下的规则类型之一：

核心验证器的昵称，比如 required、in、date，等等。请参考【核心验证器章节】查看完整的核心验证器列表。

模型类中的某个验证方法的名称，或者一个匿名方法。请参考【行内验证器小节】了解更多。

验证器类的名称。请参考【独立验证器小节】了解更多。

一个规则可用于验证一个或多个模型特性，且一个特性可以被一个或多个规则所验证。

核心验证器https://github.com/yiisoft/yii2/blob/master/docs/guide-zh-CN/tutorial-core-validators.md

default

['age', 'default', 'value' => null],// 若 "age" 为空，则将其设为 null
['country', 'default', 'value' => 'USA'],// 若 "country" 为空，则将其设为 "USA"
// 若 "from" 和 "to" 为空，则分别给他们分配自今天起，3 天后和 6 天后的日期。
[['from', 'to'], 'default', 'value' => function ($model, $attribute) {
		return date('Y-m-d', strtotime($attribute === 'to' ? '+3 days' ：'+6 days'));
}],

trim

['name','trim'],//去掉输入信息的首尾空格

行内验证器

1、以匿名函数形式定义的行内验证器

['name', 
							function($attribute, $params) 
							{
                if (!ctype_alnum($this->$attribute)) 
								{
                    $this->addError($attribute, '令牌本身必须包含字母或数字。');
                }
							}
						],

2、以模型方法 validateCountry() 形式定义的行内验证器

<?php
 
namespace app\models;
 
use yii\base\Model;
 
class EntryForm extends Model
{
    public $name;
    public $email;
 
    public function rules()
    {
        return [
            ['name', 'required','message'=>'名称不可缺省'],						
            ['email', 'required','message'=>'邮件不能缺省'],
						['email', 'email','message'=>'电子邮件格式不正确'],
						
//						['name', 
//							function($attribute, $params) 
//							{
//                if (!ctype_alnum($this->$attribute)) 
//								{
//                    $this->addError($attribute, '令牌本身必须包含字母或数字。');
//                }
//							}
//						],
						
						['name', 'validateCountry'],
        ];
    }
		
		public function validateCountry($attribute, $params)
    {
        if (!in_array($this->$attribute, ['呵呵', '嘿嘿'])) {
            $this->addError($attribute, '必须为 "呵呵" 或 "嘿嘿" 中的一个。');
        }
    }
}