【ThinkPHP】5.1 完全开发手册 / 验证场景

验证场景

验证器重支持定义场景,并且验证不同场景的数据,例如:

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'     => '名称最多不能超过25个字符',
'age.number'   => '年龄必须是数字',
'age.between'  => '年龄只能在1-120之间',
'email'        => '邮箱格式错误',    
];

protected $scene = [
'edit'  =>  ['name','age'],
];

}

然后可以在验证方法中制定验证的场景

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

$result = $this->validate($data,'app\index\validate\User.edit');

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

如果你直接调用验证器类的话直接使用 scene 方法指定验证场景。

namespace app\index\controller;

use app\index\validate\User as UserValidate;
use think\Controller;

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

$validate = new UserValidate;

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

可以单独为某个场景定义方法(方法的命名规范是scene+场景名),并且对某些字段的规则重新设置,例如:

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'     => '名称最多不能超过25个字符',
'age.number'   => '年龄必须是数字',
'age.between'  => '年龄只能在1-120之间',
'email'        => '邮箱格式错误',    
];

// edit 验证场景定义
public function sceneEdit()
{
return $this->only(['name','age'])
->append('name', 'min:5')
->remove('age', 'between')
->append('age', 'require|max:100');
}    
}

主要方法说明如下:

方法名 描述
only 场景需要验证的字段
remove 移除场景中的字段的部分验证规则
append 给场景中的字段需要追加验证规则

如果对同一个字段进行多次规则补充(包括移除和追加),必须使用下面的方式:

remove('field', ['rule1','rule2'])
// 或者
remove('field', 'rule1|rule2')

下面的方式会导致rule1规则remove不成功

remove('field', 'rule1')
->remove('field', 'rule2')