驗證規則
| 版本 | 新增功能 |
|---|---|
| 5.0.4 |
支持傳入field參數批量設置驗證字段的描述信息 |
設置規則
可以在實例化Validate類的時(shi)候傳入驗證規則(ze),例如:
$rules = [
'name' => 'require|max:25',
'age' => 'number|between:1,120',
];
$validate = new Validate($rules);
也可以使用rule方法動態添(tian)加規則,例如:
$rules = [
'name' => 'require|max:25',
'age' => 'number|between:1,120',
];
$validate = new Validate($rules);
$validate->rule('zip', '/^\d{6}$/');
$validate->rule([
'email' => 'email',
]);
規則定義
規則定義支持下面(mian)兩種方(fang)式:
$rules = [
'name' => 'require|max:25',
'age' => 'number|between:1,120',
];
$validate = new Validate($rules);
對于一個字段可以設置多個驗證規則,使用|分割。
或者采用數組方式定義多個規則(適用于你的驗證規則中有|的情況)
$rules = [
'name' => ['require','max'=>25],
'age' => ['number','between'=>'1,120'],
];
$validate = new Validate($rules);
屬性定義
通(tong)常情況下,我(wo)們實際在定義(yi)驗證類的(de)時候,可以(yi)通(tong)過屬性的(de)方式直(zhi)接定義(yi)驗證規則等信息(xi),例如(ru):
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' => '名稱最多不能(neng)超(chao)過25個字(zi)符',
'age.number' => '年齡必須是數字',
'age.between' => '年齡只能在1-120之(zhi)間',
'email' => '郵箱(xiang)格(ge)式錯誤(wu)',
];
}
驗證數據
下面是一(yi)個典型的驗證數據的例子(zi):
$rule = [
'name' => 'require|max:25',
'age' => 'number|between:1,120',
'email' => 'email',
];
$msg = [
'name.require' => '名(ming)稱必(bi)須',
'name.max' => '名稱最多不能超過(guo)25個字符',
'age.number' => '年(nian)齡必(bi)須是數(shu)字',
'age.between' => '年齡只(zhi)能在(zai)1-120之間',
'email' => '郵箱格(ge)式錯(cuo)誤',
];
$data = [
'name' => 'thinkphp',
'age' => 10,
'email' => 'thinkphp@qq.com',
];
$validate = new Validate($rule, $msg);
$result = $validate->check($data);
如果需(xu)要批量驗(yan)證,可以(yi)使(shi)用:
$validate = new Validate($rule, $msg);
$result = $validate->batch()->check($data);
批量驗證如果驗證不通過,返(fan)回的(de)是一個(ge)錯誤信息的(de)數組。
如果你定義了User驗證器類的話,可(ke)以使(shi)用(yong)下(xia)面(mian)的驗證代(dai)碼:
$data = [
'name' => 'thinkphp',
'age' => 10,
'email' => 'thinkphp@qq.com',
];
$validate = Loader::validate('User');
if(!$validate->check($data)){
dump($validate->getError());
}
閉包函數驗證
可以對某個(ge)字(zi)段使用閉包驗證,例(li)如:
$validate = new \think\Validate([
'name' => function($value,$data) {
return 'thinkphp'==$value ? true : false;
},
]);
第一個(ge)參數是當(dang)前字(zi)段(duan)的值(zhi),第二個(ge)參數是全部數據
自定義驗證規則
系(xi)統內(nei)置了一些常(chang)用的規則(ze),如果還不夠(gou)用,可以自己擴展驗證規則(ze)。
如(ru)果(guo)使用(yong)了(le)驗(yan)證器(qi)的(de)話,可以直(zhi)接在驗(yan)證器(qi)類添加自(zi)己(ji)的(de)驗(yan)證方法(fa),例如(ru):
namespace app\index\validate;
use think\Validate;
class User extends Validate
{
protected $rule = [
'name' => 'checkName:thinkphp',
'email' => 'email',
];
protected $message = [
'name' => '用戶名必須',
'email' => '郵箱格式錯誤',
];
// 自定義驗證(zheng)規則
protected function checkName($value,$rule,$data)
{
return $rule == $value ? true : '名稱錯誤';
}
}
驗證方法可以傳入的參數共有5個(ge)(后(hou)面三(san)個(ge)根據情況選用(yong)),依次(ci)為:
- 驗證數據
- 驗證規則
- 全部數據(數組)
- 字段名
- 字段描述
并且需要注意的是,自定(ding)義的驗證規(gui)則方法名(ming)不能和已有的規(gui)則沖突。
接下來,就可以這樣進行驗證:
$validate = Loader::validate('User');
if(!$validate->check($data)){
dump($validate->getError());
}
如果沒有使用驗證器類,則支持使用extend方(fang)法(fa)擴(kuo)展驗證規則,例如:
$validate = new Validate(['name' => 'checkName:1']);
$validate->extend('checkName', function ($value, $rule) {
return $rule == $value ? true : '名稱錯誤';
});
$data = ['name' => 1];
$result = $validate->check($data);
支(zhi)持(chi)批量注(zhu)冊驗證規則(ze),例如(ru):
$validate = new Validate(['name' => 'checkName:1']);
$validate->extend([
'checkName'=> function ($value, $rule) {
return $rule == $value ? true : '名(ming)稱(cheng)錯誤';
},
'checkStatus'=> [$this,'checkStatus']
]);
$data = ['name' => 1];
$result = $validate->check($data);
設置字段信息
V5.0.4+版本開始,驗證類的架構方法支持傳入field參數批量設置字段的描(miao)述信息,例如:
$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);
