🎤 Laravel 表单请求的请求数据转换策略与表单验证错误处理机制：一场轻松愉快的技术讲座

大家好！👋 今天我们要聊一聊 Laravel 中非常重要的两个话题：表单请求的数据转换策略 和 表单验证的错误处理机制。如果你是一个 Laravel 新手，或者对这些概念还不是很熟悉，那么恭喜你！因为你即将进入一个充满乐趣和实用技巧的世界。

在开始之前，请允许我先做一个小比喻：
想象一下，你正在开一家餐厅（Laravel 应用）。顾客（用户）通过菜单（表单）下单（发送请求），但他们的订单可能有各种问题：比如点了不存在的菜、数量写错了，甚至写了奇怪的要求（非法数据）。作为厨师（开发者），你需要确保订单是正确的，并且能够优雅地处理任何问题。

所以，今天我们就来聊聊如何让“订单”变得更美味，同时避免“厨房混乱”！👩‍🍳👨‍🍳

---

第一部分：请求数据的转换策略 🔄

什么是表单请求？

在 Laravel 中，表单请求是一种特殊的请求类，它继承自 IlluminateFoundationHttpFormRequest。它的主要作用是：

1. 验证用户输入。
2. 自动返回错误响应。
3. 提供请求数据的预处理能力。

我们可以通过创建一个自定义的表单请求类来实现这些功能。例如：

php artisan make:request StoreProductRequest

这会生成一个类似以下结构的文件：

namespace AppHttpRequests;

use IlluminateFoundationHttpFormRequest;

class StoreProductRequest extends FormRequest
{
    public function authorize()
    {
        return true; // 是否允许该请求
    }

    public function rules()
    {
        return [
            'name' => 'required|string|max:255',
            'price' => 'required|numeric|min:0',
        ];
    }
}

数据转换的魔法 ✨

有时候，用户的输入并不完美。例如，他们可能提交了空格填充的字符串，或者数字格式不正确。我们可以利用 prepareForValidation 方法来清理和转换数据。

示例 1：去除多余空格

假设用户提交了一个产品名称，但前后有很多空格：

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

这样，无论用户输入了什么，name 字段都会被自动清理掉多余的空格。

示例 2：将价格转换为浮点数

如果用户提交的价格是字符串格式，我们可以将其转换为浮点数：

protected function prepareForValidation()
{
    $this->merge([
        'price' => (float) str_replace(',', '.', $this->price),
    ]);
}

示例 3：默认值填充

有些字段可能是可选的，但我们希望在它们为空时提供默认值：

protected function prepareForValidation()
{
    $this->merge([
        'description' => $this->input('description', 'No description provided'),
    ]);
}

---

第二部分：表单验证的错误处理机制 ❌➡️✅

验证失败时会发生什么？

当验证失败时，Laravel 会自动将用户重定向回之前的页面，并附带错误消息。如果你使用的是 API，则会返回一个 JSON 响应。

默认行为

对于 Web 请求，默认行为如下：

• 如果是 GET 请求，用户会被重定向到上一页。
• 如果是 POST/PUT/PATCH 请求，用户会被重定向到指定的 URL 或上一页。

自定义错误处理

有时候，我们希望更灵活地处理验证失败的情况。可以通过重写 failedValidation 方法来实现。

示例 1：抛出自定义异常

如果你想在验证失败时抛出一个异常，可以这样做：

protected function failedValidation(IlluminateContractsValidationValidator $validator)
{
    throw new Exception('Validation failed!');
}

示例 2：返回自定义 JSON 响应

如果你正在开发一个 API，可能需要返回一个更详细的 JSON 响应：

protected function failedValidation(IlluminateContractsValidationValidator $validator)
{
    $errors = $validator->errors();

    throw new IlluminateHttpExceptionsHttpResponseException(
        response()->json([
            'success' => false,
            'message' => 'Validation errors occurred.',
            'errors' => $errors,
        ], 422)
    );
}

示例 3：重定向到特定页面

如果你希望在验证失败时重定向到特定页面，可以这样做：

protected function failedValidation(IlluminateContractsValidationValidator $validator)
{
    $redirectUrl = route('home');

    throw new IlluminateValidationValidationException(
        $validator,
        redirect($redirectUrl)->withErrors($validator)->withInput()
    );
}

---

第三部分：总结与最佳实践 📝

总结

1. 数据转换：利用 prepareForValidation 方法清理和转换用户输入。
2. 错误处理：根据需求重写 failedValidation 方法，以实现更灵活的错误响应。
3. 保持代码整洁：将验证逻辑放在表单请求类中，而不是控制器中。

最佳实践

• 始终验证输入：不要相信用户提交的数据，即使它看起来很合理。
• 使用清晰的错误消息：让用户知道哪里出了问题。
• 复用表单请求类：如果你有多个地方需要相同的验证逻辑，考虑提取一个通用的表单请求类。

---

结语 ❤️

好了，今天的讲座就到这里啦！希望你能从中学到一些有用的东西。记住，Laravel 的强大之处在于它的灵活性和优雅性。无论是数据转换还是错误处理，都可以通过简单的配置和代码实现复杂的功能。

最后，送给大家一句话：
"编程就像烹饪，只有用心才能做出美味的菜肴。" 😋

如果你有任何问题或想法，欢迎在评论区留言！💬