ThinkPHP5.1推荐使用验证器进行数据验证（也支持使用thinkValidate类进行独立验证）。

验证器定义

为具体的验证场景或数据表定义好验证器类 直接调用验证类的check方法即可完成验证 下面是个例子：

定义个appindexvalidateUser验证器类用于User的验证。

namespace appindexvalidate;

use thinkValidate;

class User extends Validate
{
    protected $rule = [
        'name'  =>  'require|max:25',
        'email' =>  'email',
    ];

}

V5.1.15+版本开始 可以使用下面的指令快速生成User验证器。

php think make:validate index/User

可以直接在验证器类中使用message属性定义错误提示信息 例如：

namespace appindexvalidate;

use thinkValidate;

class User extends Validate
{
    protected $rule =   [
        'name'  => 'require|max:25',
        'age'   => 'number|between:1,120',
        'email' => 'email',    
    ];
    
    protected $message  =   [
        'name.require' => '名称必须',
        'name.max'     => '名称最多不能超过25个字符',
        'age.number'   => '年龄必须是数字',
        'age.between'  => '年龄只能在1-120之间',
        'email'        => '邮箱格式错误',    
    ];
    
}

如果没有定义错误提示信息 则使用系统默认的提示信息

数据验证

在需要进行User验证的控制器方法中 添加如下代码即可：

namespace appindexcontroller;

use thinkController;

class Index extends Controller
{
    public function index()
    {
        $data = [
            'name'  => 'thinkphp',
            'email' => 'thinkphp@qq.com',
        ];

        $validate = new appindexvalidateUser;

        if (!$validate->check($data)) {
            dump($validate->getError());
        }
    }
}

事实上控制器类提供了个validate方法可以更方便的进行验证 如下：

namespace appindexcontroller;

use thinkController;

class Index extends Controller
{
    public function index()
    {
        $result = $this->validate(
            [
                'name'  => 'thinkphp',
                'email' => 'thinkphp@qq.com',
            ],
            'appindexvalidateUser');

        if (true !== $result) {
            // 验证失败 输出错误信息
            dump($result);
        }
    }
}

批量验证

默认情况下 一旦有某个数据的验证规则不符合 就会停止后续数据及规则的验证 如果希望批量进行验证 可以设置：

namespace appindexcontroller;

use thinkController;

class Index extends Controller
{
    // 是否批量验证
    protected $batchValidate = true;

    public function index()
    {
        $result = $this->validate(
            [
                'name'  => 'thinkphp',
                'email' => 'thinkphp@qq.com',
            ],
            'appindexvalidateUser');

        if (true !== $result) {
            // 验证失败 输出错误信息
            dump($result);
        }
    }
}

批量验证如果验证不通过 返回的是个错误信息的数组。

抛出验证异常

默认情况下验证失败后不会抛出异常 如果希望验证失败自动抛出异常 可以在控制器类中添加设置：

namespace appindexcontroller;

use thinkController;

class Index extends Controller
{
    // 验证失败是否抛出异常
    protected $failException = true;

    public function index()
    {
        $result = $this->validate(
            [
                'name'  => 'thinkphp',
                'email' => 'thinkphp@qq.com',
            ],
            'appindexvalidateUser');
    }
}

设置开启了验证失败后抛出异常的话 无需手动获取错误信息 会自动抛出thinkexceptionValidateException异常或自己捕获处理。

自定义验证规则

系统内置了一些常用的规则（参考后面的内置规则） 如果不能满足需求 可以在验证器重添加额外的验证方法 例如：

namespace appindexvalidate;

use thinkValidate;

class User extends Validate
{
    protected $rule = [
        'name'  =>  'checkName:thinkphp',
        'email' =>  'email',
    ];
    
    protected $message = [
        'name'  =>  '用户名必须',
        'email' =>  '邮箱格式错误',
    ];
    
    // 自定义验证规则
    protected function checkName($value,$rule,$data=[])
    {
        return $rule == $value ? true : '名称错误';
    }
}

验证方法可以传入的参数共有5个（后面三个根据情况选用） 依次为：

• 验证数据
• 验证规则
• 全部数据（数组）
• 字段名
• 字段描述

自定义的验证规则方法名不能和已有的规则冲突。