本文介绍了在 Laravel 项目中如何利用通用类实现多个字段的选择性验证，并返回所有验证错误。通过 Form Request Validation，将验证规则集中管理，简化控制器逻辑，并利用 Laravel 内置的密码验证规则，提高代码的可读性和可维护性。
在 Laravel 项目开发中，经常会遇到需要在多个控制器中复用同一套验证规则的情况。直接在控制器中编写验证逻辑会导致代码冗余，不易维护。本教程将介绍如何利用 Laravel 的 Form Request Validation 特性，将验证逻辑集中管理，并返回所有验证错误。
Form Request Validation 的优势
Form Request Validation 是 Laravel 提供的强大的验证机制，它具有以下优势：
- 代码复用性高：可以将验证规则定义在一个 Form Request 类中，并在多个控制器中复用。
- 逻辑清晰：将验证逻辑从控制器中分离出来，使控制器代码更加简洁易懂。
- 错误处理方便：Laravel 会自动处理验证失败的情况，并将错误信息返回给前端。
- 可定制性强：可以自定义验证规则和错误信息，满足各种复杂的验证需求。
实现步骤
- 创建 Form Request 类
使用 Artisan 命令创建一个 Form Request 类：
php artisan make:request MyFormRequest
该命令会在 app/Http/Requests 目录下生成 MyFormRequest.php 文件。
- 定义验证规则
在 MyFormRequest.php 文件中，重写 rules() 方法，定义验证规则。
<?php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rules\Password;
class MyFormRequest extends FormRequest
{
/**
* Get the validation rules that apply to the request.
*/
public function rules(): array
{
return [
'email' => ['required', 'email', 'unique:users'],
'password' => [
'required',
Password::min(8)->mixedCase()->numbers()->symbols()
],
'usrid' => ['required', 'unique:users'],
];
}
}在上面的代码中，我们定义了三个字段的验证规则：
- email：必填，必须是有效的电子邮件地址，并且在 users 表中必须是唯一的。
- password：必填，密码长度至少为 8 个字符，并且必须包含大小写字母、数字和符号。这里使用了 Laravel 内置的 Password 验证规则，可以方便地定义复杂的密码验证规则。
- usrid：必填，并且在 users 表中必须是唯一的。
- 在控制器中使用 Form Request 类
在控制器方法中，使用 MyFormRequest 类代替 Request 类。
public function store(MyFormRequest $request)
{
// $request has been validated, no further checking needed
// 可以通过 $request->input('email') 等方式获取验证后的数据
}当请求到达控制器时，Laravel 会自动执行 Form Request 类中定义的验证规则。如果验证失败，Laravel 会自动将错误信息返回给前端。如果验证成功，则可以像使用普通的 Request 对象一样使用 $request 对象。
注意事项
-
确保在 MyFormRequest 类中重写了 authorize() 方法，并返回 true，以允许所有用户访问该请求。如果需要进行权限验证，可以在该方法中编写相应的逻辑。
/** * Determine if the user is authorized to make this request. * * @return bool */ public function authorize() { return true; } -
可以在 MyFormRequest 类中自定义错误信息。重写 messages() 方法，返回一个包含字段名和错误信息的数组。
/** * Get the error messages for the defined validation rules. * * @return array */ public function messages() { return [ 'email.required' => '邮箱不能为空', 'email.email' => '邮箱格式不正确', 'email.unique' => '该邮箱已被注册', 'password.required' => '密码不能为空', 'password.min' => '密码长度不能少于 8 位', 'usrid.required' => '用户 ID 不能为空', 'usrid.unique' => '该用户 ID 已被注册', ]; }
总结
使用 Form Request Validation 可以有效地管理 Laravel 项目中的验证逻辑，提高代码的可复用性和可维护性。通过定义验证规则和错误信息，可以轻松地实现各种复杂的验证需求。同时，Laravel 内置的密码验证规则可以帮助开发者快速构建安全的密码验证机制。通过本教程的学习，相信您已经掌握了在 Laravel 项目中使用 Form Request Validation 的方法，并可以在实际项目中灵活运用。
