12.thinkphp验证

一．验证器定义

1. 验证器的使用，我们必须先定义它，系统提供了一条命令直接生成想要的类；

php think make:validate User

2. 这条命令会自动在应用目录下生成一个validate文件夹，并生成User.php类；

class User extends Validate

3. 自动生成了两个属性：$rule表示定义规则，$message表示错误提示信息；

protected $rule = [
 'name'
 =>
 'require|max:20',
 'price'
 =>
 //不得为空，不得大于20位
'number|between:1,100', //必须是数值，1-100 之间
'email'
 =>
 'email'
 ];

protected $message = [
 'name.require'
 =>
 '姓名不得为空',
 'name.max'
 =>
 '姓名不得大于20位',
 'price.number'
 =>
 '价格必须是数字',
 'price.between'
 =>
 '价格必须1-100之间',
 'email'
 =>
 '邮箱的格式错误'
 ];

4. 如果不设置$message定义的话，将提示默认的错误信息；

5. 验证器定义好了之后，我们需要进行调用测试，创建一个Verify.php控制器；

try {
 validate(User::class)->check([
 'name' => '蜡笔小新',
 'price' => 90,
 'email' => 'xiaoxin@163.com'
 ]);
 } catch (ValidateException $e) {
 dump($e->getError());
 }

6. 默认情况下，出现一个错误就会停止后面字段的验证，我们也可以设置批量验证；

validate(User::class)->batch(true)...

由于出现一个错误，后面就会停止，使用我们要应用batch：

只能显示一个错误，但是后面的两个也是错的。

下面这个图片的batch位置写错了：

正确写法：

7. 系统提供了常用的规则让开发者直接使用，也可以自行定义独有的特殊规则；

protected $rule = [
 'name'
 =>
 'require|max:20|checkName:李炎恢',
 ];
 //自定义规则，名称中不得是“李炎恢”
 protected function checkName($value, $rule)
 {
 return $rule != $value ? true : '名称存在非法称谓';
 }

8. 对于自定义规则中，一共可以有五个参数，我们分别了解一下；

protected function checkName($value, $rule, $data, $field, $title)
 {
 dump($data);
 //所有数据信息
dump($field);
 //当前字段名
dump($title);
 //字段描述，没有就是字段名
}

1. checkName方法参数传值

• $value：它代表的是被验证字段的实际值。例如，若要验证name字段，那么$value就是name字段在表单提交时所携带的值。
• $rule：此为验证规则中自定义规则之后的额外参数。就像'checkName:thinkphp'里，$rule的值就是thinkphp。
• $data：它是一个数组，包含了所有需要验证的数据。默认值为空数组[]，在验证时，整个待验证的数据数组会被传递给这个参数。

9. 如何设置字段描述，只要在字段名用|后设置即可： 'name|用户名' => 'require|max:20|checkName:李炎恢',

<?php
namespace app\validate;

use think\Validate;

class User extends Validate
{
    protected $rule = [
        'name'  =>  'checkName:thinkphp',
        'email' =>  'email',
    ];
    
    protected $message = [
        'name'  =>  '用户名必须',
        'email' =>  '邮箱格式错误',
    ];
    
    // 自定义验证规则
    protected function checkName($value, $rule, $data=[])
    {
        return $rule == $value ? true : '名称错误';
    }
}

// 调用验证类
$validate = new User();
$data = [
    'name' => 'thinkphp',
    'email' => 'test@example.com'
];

if (!$validate->check($data)) {
    dump($validate->getError());
} else {
    echo '验证通过';
}

代码解释

• 在上述代码中，当调用$validate->check($data)时，name字段的值'thinkphp'会被传递给checkName方法的$value参数。
• 'checkName:thinkphp'里的thinkphp会被传递给checkName方法的$rule参数。
• 整个$data数组会被传递给checkName方法的$data参数。

这样，在checkName方法中就能依据$value和$rule的值进行验证，并返回验证结果。

验证规则

有的时候只对数据进行局部的验证，而不是全局。

1.在上一节验证器定义的时候，我们采用的字符串模式，也支持数组模式；

protected $rule =[
 'name' => [
 'require',
 'max' => 10,
 'checkName' => '李炎恢'
 ],
 'price' => [
 'number',
 'between' => '1,100'
 ],
 'email' => 'email'
 ];

2.数组模式在验证规则很多很乱的情况下，更容易管理，可读性更高；

3.如果你想使用独立验证，就是手动调用验证类，而不是调用User.php验证类；

第一个是定义规则，第二个是验证规则：

4.这种调用方式，一般来说，就是独立、唯一，并不共享的调用方式；

$validate = Validate::rule([
 'name' => 'require|max:20',
 'price' => 'number|between:1,100',
 'email' => 'email'
 ]);
 $result =$validate->check([
 'name' => '李炎恢',
 'price' => 90,
 'email' => 'xiaoxin163.com'
 ]);
 if(!$result){
 dump($validate->getError());
 }

5. 独立验证默认也是返回一条错误信息，如果要批量返回所有错误使用batch()；

$result = $validate->batch(true)->check

6. 独立验支持对象化的定义方式，但不支持在属性方式的定义；

$validate = Validate::rule([
 'name'
 =>
 ValidateRule::isRequire()->max(20),
 'price'
 =>
 ValidateRule::isNumber()->between([1, 100]),
 'email'
 =>
 ValidateRule::isEmail()
 ]);

8. 独立验支持闭包的自定义方式，但这种方式会不支持字段的多规则；

$validate = Validate::rule([
 'name' => function ($value) {
 return $value != '' ? true : '姓名不得为空';
 },
 'price'=> function ($value) {
 return $value > 0 ? true : '价格不得小于零';
 }
 ]);

二．错误信息

1. 独立验证的自定义错误提示，可以在方法的第二参数，参数一是规则；

ValidateRule::isEmail(null, '邮箱格式不正确！');
 ValidateRule::isNumber()->between([1, 100], '价格范围1-100 之间')

2. 也可以独立使用message()方法，来设置相关错误信息；

$validate->message([
 'name.require' => '姓名不得为空',
 'name.max' =>'姓名不可以超过20个子'
 ]);


 'name.require'=>['code'=>1001, 'msg'=>'姓名不得为空']