版本新增功能
5.0.4支持传入field参数批量设置验证字段的描述信息

设置规则

可以在实例化Validate类的时候传入验证规则,例如:

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

也可以使用rule方法动态添加规则,例如:

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

规则定义

规则定义支持下面两种方式:

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

对于一个字段可以设置多个验证规则,使用|分割。

或者采用数组方式定义多个规则(适用于你的验证规则中有|的情况)

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

属性定义

通常情况下,我们实际在定义验证类的时候,可以通过属性的方式直接定义验证规则等信息,例如:

  1. namespace app\index\validate;
  2. use think\Validate;
  3. class User extends Validate
  4. {
  5. protected $rule = [
  6. 'name' => 'require|max:25',
  7. 'age' => 'number|between:1,120',
  8. 'email' => 'email',
  9. ];
  10. protected $message = [
  11. 'name.require' => '名称必须',
  12. 'name.max' => '名称最多不能超过25个字符',
  13. 'age.number' => '年龄必须是数字',
  14. 'age.between' => '年龄只能在1-120之间',
  15. 'email' => '邮箱格式错误',
  16. ];
  17. }

验证数据

下面是一个典型的验证数据的例子:

  1. $rule = [
  2. 'name' => 'require|max:25',
  3. 'age' => 'number|between:1,120',
  4. 'email' => 'email',
  5. ];
  6. $msg = [
  7. 'name.require' => '名称必须',
  8. 'name.max' => '名称最多不能超过25个字符',
  9. 'age.number' => '年龄必须是数字',
  10. 'age.between' => '年龄只能在1-120之间',
  11. 'email' => '邮箱格式错误',
  12. ];
  13. $data = [
  14. 'name' => 'thinkphp',
  15. 'age' => 10,
  16. 'email' => 'thinkphp@qq.com',
  17. ];
  18. $validate = new Validate($rule, $msg);
  19. $result = $validate->check($data);

如果需要批量验证,可以使用:

  1. $validate = new Validate($rule, $msg);
  2. $result = $validate->batch()->check($data);
批量验证如果验证不通过,返回的是一个错误信息的数组。

如果你定义了User验证器类的话,可以使用下面的验证代码:

  1. $data = [
  2. 'name' => 'thinkphp',
  3. 'age' => 10,
  4. 'email' => 'thinkphp@qq.com',
  5. ];
  6. $validate = Loader::validate('User');
  7. if(!$validate->check($data)){
  8. dump($validate->getError());
  9. }

闭包函数验证

可以对某个字段使用闭包验证,例如:

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

第一个参数是当前字段的值,第二个参数是全部数据

自定义验证规则

系统内置了一些常用的规则,如果还不够用,可以自己扩展验证规则。

如果使用了验证器的话,可以直接在验证器类添加自己的验证方法,例如:

  1. namespace app\index\validate;
  2. use think\Validate;
  3. class User extends Validate
  4. {
  5. protected $rule = [
  6. 'name' => 'checkName:thinkphp',
  7. 'email' => 'email',
  8. ];
  9. protected $message = [
  10. 'name' => '用户名必须',
  11. 'email' => '邮箱格式错误',
  12. ];
  13. // 自定义验证规则
  14. protected function checkName($value,$rule,$data)
  15. {
  16. return $rule == $value ? true : '名称错误';
  17. }
  18. }

验证方法可以传入的参数共有5个(后面三个根据情况选用),依次为:

  • 验证数据
  • 验证规则
  • 全部数据(数组)
  • 字段名
  • 字段描述
并且需要注意的是,自定义的验证规则方法名不能和已有的规则冲突。

接下来,就可以这样进行验证:

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

如果没有使用验证器类,则支持使用extend方法扩展验证规则,例如:

  1. $validate = new Validate(['name' => 'checkName:1']);
  2. $validate->extend('checkName', function ($value, $rule) {
  3. return $rule == $value ? true : '名称错误';
  4. });
  5. $data = ['name' => 1];
  6. $result = $validate->check($data);

支持批量注册验证规则,例如:

  1. $validate = new Validate(['name' => 'checkName:1']);
  2. $validate->extend([
  3. 'checkName'=> function ($value, $rule) {
  4. return $rule == $value ? true : '名称错误';
  5. },
  6. 'checkStatus'=> [$this,'checkStatus']
  7. ]);
  8. $data = ['name' => 1];
  9. $result = $validate->check($data);

设置字段信息

V5.0.4+版本开始,验证类的架构方法支持传入field参数批量设置字段的描述信息,例如:

  1. $rule = [
  2. 'name' => 'require|max:25',
  3. 'age' => 'number|between:1,120',
  4. 'email' => 'email',
  5. ];
  6. $field = [
  7. 'name' => '名称',
  8. 'age' => '年龄',
  9. 'email' => '邮箱',
  10. ];
  11. $data = [
  12. 'name' => 'thinkphp',
  13. 'age' => 10,
  14. 'email' => 'thinkphp@qq.com',
  15. ];
  16. $validate = new Validate($rule, [] , $field);
  17. $result = $validate->check($data);