🎤 Laravel 表单请求的转换策略与验证错误处理机制：一场轻松愉快的技术讲座
大家好！👋 今天我们要聊一聊 Laravel 中表单请求（Form Request）的那些事儿。如果你经常和 Laravel 打交道，那你一定对表单请求不陌生。它就像一个贴心的管家，帮你处理用户提交的数据，确保它们符合你的要求，并且还能在需要的时候对数据进行一些小调整。
不过呢，表单请求可不是只会“点头”的小跟班，它还有自己的脾气和规则。所以今天我们就来深入探讨一下它的两个核心技能：请求数据的转换策略 和 表单验证的错误处理机制。准备好了吗？让我们开始吧！
🌟 第一部分：请求数据的转换策略
1.1 什么是请求数据的转换？
简单来说，就是把用户提交的原始数据变成你想要的样子。比如，用户可能提交了一个字符串 "true"，但你希望它是布尔值 true；或者用户提交了一个日期格式不对的字符串，你需要把它转换成标准的日期格式。
Laravel 的表单请求类通过 prepareForValidation() 方法为我们提供了这样的能力。这个方法会在验证之前运行，允许我们对输入数据进行预处理。
1.2 示例代码
假设我们有一个注册表单，用户需要填写他们的生日。但是他们可能以不同的格式提交日期（如 01/15/1990 或 1990-01-15），而我们希望统一存储为 Y-m-d 格式。
namespace AppHttpRequests;
use IlluminateFoundationHttpFormRequest;
class RegisterRequest extends FormRequest
{
public function prepareForValidation()
{
$this->merge([
'birthday' => $this->convertDate($this->input('birthday')),
]);
}
protected function convertDate($date)
{
// 尝试将日期转换为 Y-m-d 格式
if (preg_match('/^d{1,2}/d{1,2}/d{4}$/', $date)) {
return date('Y-m-d', strtotime($date));
}
return $date; // 如果格式不符合，直接返回原值
}
public function rules()
{
return [
'name' => 'required|string|max:255',
'email' => 'required|email|unique:users',
'password' => 'required|min:8',
'birthday' => 'required|date', // 验证时已经是 Y-m-d 格式了
];
}
}💡 关键点：
prepareForValidation()是在验证之前执行的。- 使用
$this->merge()可以修改或添加请求中的数据。 - 数据转换完成后，再交给
rules()方法进行验证。
1.3 常见的转换场景
以下是几个常见的转换需求及其解决方案：
| 场景 | 解决方案 |
|---|---|
| 字符串转布尔值 | 使用 filter_var($value, FILTER_VALIDATE_BOOLEAN) |
| 数组转逗号分隔字符串 | 使用 implode(',', $array) |
| 逗号分隔字符串转数组 | 使用 explode(',', $string) |
| 转换日期格式 | 使用 strtotime() 和 date() |
🚨 第二部分：表单验证的错误处理机制
2.1 验证失败时会发生什么？
当表单验证失败时，Laravel 默认会将用户重定向回上一页，并附带一个包含错误信息的 $errors 变量。这听起来很简单，但实际上有很多细节可以定制。
2.2 自定义错误消息
默认情况下，Laravel 会根据验证规则生成通用的错误消息。但有时候这些消息不够友好，我们可以自定义它们。
public function messages()
{
return [
'name.required' => '名字是必填项哦！😊',
'email.email' => '请提供一个有效的电子邮件地址。',
'password.min' => '密码至少需要 8 个字符。',
];
}💡 技巧：如果你有多个语言版本的应用程序，可以将这些消息放入语言文件中（如 resources/lang/en/validation.php）。
2.3 修改失败后的重定向行为
有时候我们不希望用户被重定向回上一页，而是希望跳转到其他页面，或者返回 JSON 响应（比如在 API 中）。可以通过重写 failedValidation() 方法实现：
protected function failedValidation(IlluminateContractsValidationValidator $validator)
{
if ($this->expectsJson()) {
return response()->json([
'success' => false,
'message' => 'Validation failed.',
'errors' => $validator->errors(),
], 422);
}
parent::failedValidation($validator); // 回到默认行为
}💡 注意：$this->expectsJson() 用于判断当前请求是否为 JSON 请求。
2.4 全局错误处理
如果不想在每个表单请求类中重复定义错误处理逻辑，可以在 AppExceptionsHandler 中全局捕获验证异常。
use IlluminateValidationValidationException;
public function render($request, Throwable $exception)
{
if ($exception instanceof ValidationException) {
return response()->json([
'success' => false,
'message' => 'Validation failed.',
'errors' => $exception->validator->errors(),
], 422);
}
return parent::render($request, $exception);
}🎉 总结
今天的讲座就到这里啦！👏 我们一起学习了 Laravel 表单请求的两大核心技能：
- 请求数据的转换策略：通过
prepareForValidation()方法对用户提交的数据进行预处理，确保它们符合我们的期望。 - 表单验证的错误处理机制：通过自定义错误消息、修改重定向行为以及全局捕获验证异常，让我们的应用更加健壮和用户友好。
希望这篇文章能帮到你！如果觉得有用，别忘了给我点个赞哦 😊
