验证器定义
最后更新于:2022-04-02 07:07:21
## 验证器
MixPHP 的验证器结合了多个框架的优点,如下:
- 支持场景控制。
- 验证成功后字段将赋值为验证类的属性,文件则直接实例化为文件对象。
- 更细粒度的错误消息设置。
- 支持在 WebSocket 开发中使用。
## 组件
使用 [composer]([https://www.phpcomposer.com/](https://www.phpcomposer.com/)) 安装:
~~~
composer require mix/validate
~~~
## 验证器定义
我们定义一个 `UserForm` 验证器类用于 `User` 控制器的验证。
[>> UserForm::class <<](https://github.com/mix-php/mix-skeleton/tree/v2.1/app/Api/Forms/UserForm.php)
>[danger] 如果没有定义错误提示信息,则使用系统默认的提示信息
## 数据验证
在需要进行 `User` 验证的控制器方法中,添加如下代码即可:
[>> UserController::class <<](https://github.com/mix-php/mix-skeleton/tree/v2.1/app/Api/Controllers/UserController.php)
文件验证器还需在实例化时多传入一个 `$request->getUploadedFiles()` 参数:
[>> FileController::class <<](https://github.com/mix-php/mix-skeleton/tree/v2.1/app/Api/Controllers/FileController.php)
## 验证失败
验证失败可以通过以下方法获取错误消息:
- $model->getErrors() :获取全部错误信息,返回数组。
- $model->getError() :获取单条错误信息,返回字符串。
## 验证成功
验证成功后,验证规则中通过验证的字段,将会赋值到同名的验证类的属性中,未通过的字段则为 `null`。
这个功能有什么用?
>[success] 有了这个功能,我们就只需要把验证类的对象传入模型,就可以在模型里安全的使用这些属性操作数据库。
';