驗(yàn)證規(guī)則

設(shè)置規(guī)則

可以在實(shí)例化Validate類的時(shí)候傳入驗(yàn)證規(guī)則，例如：

$rules = [
    'name'  => 'require|max:25',
    'age'   => 'number|between:1,120',
];
$validate = new Validate($rules);

也可以使用rule方法動(dòng)態(tài)添加規(guī)則，例如：

$rules = [
    'name'  => 'require|max:25',
    'age'   => 'number|between:1,120',
];
$validate = new Validate($rules);
$validate->rule('zip', '/^\d{6}$/');
$validate->rule([
    'email'   => 'email',
]);

規(guī)則定義

規(guī)則定義支持下面兩種方式：

$rules = [
    'name'  => 'require|max:25',
    'age'   => 'number|between:1,120',
];
$validate = new Validate($rules);

對(duì)于一個(gè)字段可以設(shè)置多個(gè)驗(yàn)證規(guī)則，使用|分割。

或者采用數(shù)組方式定義多個(gè)規(guī)則（適用于你的驗(yàn)證規(guī)則中有|的情況）

$rules = [
    'name'  => ['require','max'=>25],
    'age'   => ['number','between'=>'1,120'],
];
$validate = new Validate($rules);

屬性定義

通常情況下，我們實(shí)際在定義驗(yàn)證類的時(shí)候，可以通過(guò)屬性的方式直接定義驗(yàn)證規(guī)則等信息，例如：

namespace app\index\validate;

use think\Validate;

class User extends Validate
{
    protected $rule =   [
        'name'  => 'require|max:25',
        'age'   => 'number|between:1,120',
        'email' => 'email',    
    ];
    
    protected $message  =   [
        'name.require' => '名稱必須',
        'name.max'     => '名稱最多不能超過(guò)25個(gè)字符',
        'age.number'   => '年齡必須是數(shù)字',
        'age.between'  => '年齡只能在1-120之間',
        'email'        => '郵箱格式錯(cuò)誤',    
    ];
    
}

驗(yàn)證數(shù)據(jù)

下面是一個(gè)典型的驗(yàn)證數(shù)據(jù)的例子：

$rule = [
    'name'  => 'require|max:25',
    'age'   => 'number|between:1,120',
    'email' => 'email',
];

$msg = [
    'name.require' => '名稱必須',
    'name.max'     => '名稱最多不能超過(guò)25個(gè)字符',
    'age.number'   => '年齡必須是數(shù)字',
    'age.between'  => '年齡只能在1-120之間',
    'email'        => '郵箱格式錯(cuò)誤',
];

$data = [
    'name'  => 'thinkphp',
    'age'   => 10,
    'email' => 'thinkphp@qq.com',
];

$validate = new Validate($rule, $msg);
$result   = $validate->check($data);

如果需要批量驗(yàn)證，可以使用：

$validate = new Validate($rule, $msg);
$result   = $validate->batch()->check($data);

批量驗(yàn)證如果驗(yàn)證不通過(guò)，返回的是一個(gè)錯(cuò)誤信息的數(shù)組。

如果你定義了User驗(yàn)證器類的話，可以使用下面的驗(yàn)證代碼：

$data = [
    'name'  => 'thinkphp',
    'age'   => 10,
    'email' => 'thinkphp@qq.com',
];
$validate = Loader::validate('User');
if(!$validate->check($data)){
    dump($validate->getError());
}

閉包函數(shù)驗(yàn)證

可以對(duì)某個(gè)字段使用閉包驗(yàn)證，例如：

$validate = new \think\Validate([
    'name'  => function($value,$data) { 
        return 'thinkphp'==$value ? true : false;
    },
]);

第一個(gè)參數(shù)是當(dāng)前字段的值，第二個(gè)參數(shù)是全部數(shù)據(jù)

自定義驗(yàn)證規(guī)則

系統(tǒng)內(nèi)置了一些常用的規(guī)則，如果還不夠用，可以自己擴(kuò)展驗(yàn)證規(guī)則。

如果使用了驗(yàn)證器的話，可以直接在驗(yàn)證器類添加自己的驗(yàn)證方法，例如：

namespace app\index\validate;

use think\Validate;

class User extends Validate
{
    protected $rule = [
        'name'  =>  'checkName:thinkphp',
        'email' =>  'email',
    ];
    
    protected $message = [
        'name'  =>  '用戶名必須',
        'email' =>  '郵箱格式錯(cuò)誤',
    ];
    
    // 自定義驗(yàn)證規(guī)則
    protected function checkName($value,$rule,$data)
    {
        return $rule == $value ? true : '名稱錯(cuò)誤';
    }
}

驗(yàn)證方法可以傳入的參數(shù)共有5個(gè)（后面三個(gè)根據(jù)情況選用），依次為：

• 驗(yàn)證數(shù)據(jù)
• 驗(yàn)證規(guī)則
• 全部數(shù)據(jù)（數(shù)組）
• 字段名
• 字段描述

并且需要注意的是，自定義的驗(yàn)證規(guī)則方法名不能和已有的規(guī)則沖突。

接下來(lái)，就可以這樣進(jìn)行驗(yàn)證：

$validate = Loader::validate('User');
if(!$validate->check($data)){
    dump($validate->getError());
}

如果沒有使用驗(yàn)證器類，則支持使用extend方法擴(kuò)展驗(yàn)證規(guī)則，例如：

$validate = new Validate(['name' => 'checkName:1']);
$validate->extend('checkName', function ($value, $rule) {
    return $rule == $value ? true : '名稱錯(cuò)誤';
});
$data   = ['name' => 1];
$result = $validate->check($data);

支持批量注冊(cè)驗(yàn)證規(guī)則，例如：

$validate = new Validate(['name' => 'checkName:1']);
$validate->extend([
    'checkName'=> function ($value, $rule) {
    return $rule == $value ? true : '名稱錯(cuò)誤';
},
    'checkStatus'=> [$this,'checkStatus']
]);
$data   = ['name' => 1];
$result = $validate->check($data);

設(shè)置字段信息

V5.0.4+版本開始，驗(yàn)證類的架構(gòu)方法支持傳入field參數(shù)批量設(shè)置字段的描述信息，例如：

$rule = [
    'name'  => 'require|max:25',
    'age'   => 'number|between:1,120',
    'email' => 'email',
];

$field = [
    'name'  => '名稱',
    'age'   => '年齡',
    'email' => '郵箱',	
];

$data = [
    'name'  => 'thinkphp',
    'age'   => 10,
    'email' => 'thinkphp@qq.com',
];

$validate = new Validate($rule, [] , $field);
$result   = $validate->check($data);