Laravel 多字段验证及错误返回方法

本文介绍了在 Laravel 项目中如何利用通用类实现多个字段的选择性验证，并返回所有验证错误。通过 Form Request Validation，将验证规则集中管理，简化控制器逻辑，并利用 Laravel 内置的密码验证规则，提高代码的可读性和可维护性。

在 Laravel 项目开发中，经常会遇到需要在多个控制器中复用同一套验证规则的情况。直接在控制器中编写验证逻辑会导致代码冗余，不易维护。本教程将介绍如何利用 Laravel 的 Form Request Validation 特性，将验证逻辑集中管理，并返回所有验证错误。

Form Request Validation 的优势

Form Request Validation 是 Laravel 提供的强大的验证机制，它具有以下优势：

• 代码复用性高：可以将验证规则定义在一个 Form Request 类中，并在多个控制器中复用。
• 逻辑清晰：将验证逻辑从控制器中分离出来，使控制器代码更加简洁易懂。
• 错误处理方便：Laravel 会自动处理验证失败的情况，并将错误信息返回给前端。
• 可定制性强：可以自定义验证规则和错误信息，满足各种复杂的验证需求。

实现步骤

1. 创建 Form Request 类

使用 Artisan 命令创建一个 Form Request 类：

php artisan make:request MyFormRequest

该命令会在 app/Http/Requests 目录下生成 MyFormRequest.php 文件。

2. 定义验证规则

在 MyFormRequest.php 文件中，重写 rules() 方法，定义验证规则。

 ['required', 'email', 'unique:users'],
            'password' => [
                'required',
                Password::min(8)->mixedCase()->numbers()->symbols()
            ],
            'usrid' => ['required', 'unique:users'],
        ];
    }
}

在上面的代码中，我们定义了三个字段的验证规则：

• email：必填，必须是有效的电子邮件地址，并且在 users 表中必须是唯一的。
• password：必填，密码长度至少为 8 个字符，并且必须包含大小写字母、数字和符号。这里使用了 Laravel 内置的 Password 验证规则，可以方便地定义复杂的密码验证规则。
• usrid：必填，并且在 users 表中必须是唯一的。

3. 在控制器中使用 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 的方法，并可以在实际项目中灵活运用。