📝 Laravel 表单请求的请求数据转换与表单验证的错误收集策略

大家好！👋 今天我们要聊一聊 Laravel 中一个非常实用的功能——表单请求（Form Requests）。它不仅可以帮助我们优雅地处理请求数据，还能让我们在验证失败时更好地管理错误信息。别担心，这次我会用轻松诙谐的方式带大家深入了解这个话题，顺便加点代码和表格助兴！🎉

🚀 开场：什么是表单请求？

在 Laravel 中，表单请求是一个专门用于处理 HTTP 请求的类。它不仅继承了 IlluminateFoundationHttpFormRequest，还自带两个核心功能：

数据验证：确保用户提交的数据符合预期。
授权检查：判断当前用户是否有权限执行某个操作。

简单来说，表单请求就是你的应用守门员，负责拦截不符合规则的数据，并将它们拒之门外⚽。

🔍 第一部分：请求数据转换

很多时候，用户提交的数据可能并不完全符合我们的需求。比如日期格式不对、字符串需要修剪多余空格等等。这时候，我们可以利用表单请求中的 prepareForValidation() 方法对数据进行预处理。

示例场景：日期格式转换

假设你有一个表单字段 birthday，用户输入的是 dd-mm-yyyy 格式，但数据库要求存储为 yyyy-mm-dd 格式。我们可以在 prepareForValidation() 方法中完成这个转换。

protected function prepareForValidation()
{
    $this->merge([
        'birthday' => CarbonCarbon::createFromFormat('d-m-Y', $this->birthday)->format('Y-m-d'),
    ]);
}

示例场景：字符串去空格

如果某些字段需要去掉首尾空格，也可以在这里处理：

protected function prepareForValidation()
{
    $this->merge([
        'username' => trim($this->username),
    ]);
}

🧪 第二部分：表单验证的艺术

接下来，我们聊聊如何通过表单请求来定义验证规则。Laravel 提供了一个非常强大的验证系统，支持多种内置规则，甚至可以自定义规则。

验证规则示例

以下是一个典型的 rules() 方法实现：

public function rules()
{
    return [
        'name' => 'required|string|max:255',
        'email' => 'required|email|unique:users,email',
        'password' => 'required|min:8|confirmed',
    ];
}

自定义错误消息

默认情况下，Laravel 会使用内置的错误消息，但我们可以通过 messages() 方法来自定义这些消息：

public function messages()
{
    return [
        'name.required' => '名字是必填项哦！',
        'email.unique' => '这个邮箱已经被注册啦！',
    ];
}

💥 第三部分：错误收集策略

当验证失败时，我们需要知道如何捕获并展示这些错误信息。Laravel 提供了两种常见的错误收集方式：

自动重定向：适用于表单提交场景。
API 响应：适用于 JSON API 场景。

自动重定向

在传统的 Web 应用中，验证失败后通常会自动将用户重定向回上一页，并附带错误消息。例如：

return back()->withErrors($validator)->withInput();

这里的 withErrors() 方法会将错误信息存入 Session，而 withInput() 则保留用户的输入数据。

API 响应

对于 JSON API，Laravel 默认会返回一个包含错误信息的 JSON 响应。例如：

{
    "message": "The given data was invalid.",
    "errors": {
        "name": ["名字是必填项哦！"],
        "email": ["这个邮箱已经被注册啦！"]
    }
}

如果你想自定义这个响应，可以重写 failedValidation() 方法：

protected function failedValidation(Validator $validator)
{
    throw new HttpResponseException(response()->json([
        'success' => false,
        'message' => 'Validation failed.',
        'errors' => $validator->errors(),
    ], 422));
}

📊 总结对比：表单请求 vs 手动验证

为了让大家更直观地理解表单请求的优势，我整理了一个简单的对比表：

特性	表单请求	手动验证
数据预处理	支持 `prepareForValidation()` 方法	需要手动处理
验证规则定义	集中在 `rules()` 方法中	分散在控制器中
错误消息自定义	支持 `messages()` 方法	需要手动指定
授权检查	内置 `authorize()` 方法	需要单独实现

🎉 结语

好了，今天的讲座就到这里啦！👏 我们一起探讨了 Laravel 表单请求的核心功能，包括数据转换、验证规则定义以及错误收集策略。希望这些内容能帮助你在开发过程中更加高效地处理用户请求。

最后，记得给 Laravel 的官方文档点个赞！虽然今天没有插入链接，但它的文档确实是非常优秀的学习资源 😄。

下次见！✨