加载中...

验证规则


验证规则的定义通常有两种方式,如果你使用了验证器的话,通常通过rule属性定义验证规则,而如果使用的是独立验证的话,则是通过rule方法进行定义。

属性定义

属性定义方式仅限于验证器,通常类似于下面的方式:

  1. <?php
  2. namespace app\index\validate;
  3. use think\Validate;
  4. class User extends Validate
  5. {
  6. protected $rule = [
  7. 'name' => 'require|max:25',
  8. 'age' => 'number|between:1,120',
  9. 'email' => 'email',
  10. ];
  11. }

系统内置了一些常用的验证规则可以满足大部分的验证需求,具体每个规则的含义参考内置规则一节。

因为一个字段可以使用多个验证规则(如上面的age字段定义了numberbetween两个验证规则),在一些特殊的情况下,为了避免混淆可以在rule属性中使用数组定义规则。

  1. <?php
  2. namespace app\index\validate;
  3. use think\Validate;
  4. class User extends Validate
  5. {
  6. protected $rule = [
  7. 'name' => ['require', 'max' => 25, 'regex' => '/^[\w|\d]\w+/'],
  8. 'age' => ['number', 'between' => '1,120'],
  9. 'email' => 'email',
  10. ];
  11. }

方法定义

如果使用的是独立验证(即手动调用验证类进行验证)方式的话,通常使用rule方法进行验证规则的设置,举例说明如下。

  1. $validate = new \think\Validate;
  2. $validate->rule('age', 'number|between:1,120')
  3. ->rule([
  4. 'name' => 'require|max:25',
  5. 'email' => 'email'
  6. ]);
  7. $data = [
  8. 'name' => 'thinkphp',
  9. 'email' => 'thinkphp@qq.com'
  10. ];
  11. if (!$validate->check($data)) {
  12. dump($validate->getError());
  13. }

rule方法传入数组表示批量设置规则。

rule方法还可以支持使用对象化的规则定义,这是5.1版本新增的特性。

我们把上面的验证代码改为

  1. use think\validate\ValidateRule as Rule;
  2. $validate = new \think\Validate;
  3. $validate->rule('age', Rule::isNumber()->between([1,120]))
  4. ->rule([
  5. 'name' => Rule::isRequire()->max(25),
  6. 'email' => Rule::isEmail(),
  7. ]);
  8. $data = [
  9. 'name' => 'thinkphp',
  10. 'email' => 'thinkphp@qq.com'
  11. ];
  12. if (!$validate->check($data)) {
  13. dump($validate->getError());
  14. }

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

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

闭包支持传入两个参数,第一个参数是当前字段的值(必须),第二个参数是所有数据(可选)。

如果使用了闭包进行验证,则不再支持对该字段使用多个验证规则。

闭包函数如果返回true则表示验证通过,返回false表示验证失败并使用系统的错误信息,如果返回字符串,则表示验证失败并且以返回值作为错误提示信息。

  1. $validate = new \think\Validate;
  2. $validate->rule([
  3. 'name' => function($value) {
  4. return 'thinkphp' == strtolower($value) ? true : '用户名错误';
  5. },
  6. ]);

属性方式定义验证规则不支持使用对象化规则定义和闭包定义


还没有评论.