本文详细介绍了如何在laravel应用中，通过重写`formrequest`的`messages()`方法，实现验证错误消息的多语言并行输出。文章将指导开发者为每个验证规则定义包含多种语言的错误消息，并正确处理占位符替换，从而在不修改应用全局语言环境的前提下，为前端提供结构化的多语言验证响应。
在Laravel中，验证是处理用户输入数据完整性和有效性的关键环节。FormRequest类是Laravel提供的一种优雅方式，用于将验证逻辑从控制器中解耦出来，使其更易于管理和复用。当使用FormRequest时，通常会在其中定义rules()方法来指定验证规则。
如果验证失败，FormRequest会自动抛出一个HttpResponseException，其中包含由Validator生成的错误消息。默认情况下，这些错误消息是根据当前应用的语言环境（Locale）生成的。开发者可以通过重写FormRequest中的failedValidation方法来自定义验证失败时的响应逻辑。
class ApiRequest extends FormRequest
{
// ...
protected function failedValidation(Validator $validator)
{
// 默认情况下，这里会获取到当前语言环境的错误消息
throw new HttpResponseException($this->response($validator->getMessageBag()->toArray()));
}
}在某些特定的业务场景中，我们可能需要同时向客户端返回某个字段在多种语言下的验证错误消息，而不是仅仅返回当前语言环境下的错误。例如，前端可能需要在一个界面上展示两种语言的错误提示。
传统的做法是在failedValidation中通过切换App::setLocale()来循环获取不同语言的错误，但这会涉及多次验证或复杂的逻辑，且可能影响应用的全局语言环境。理想的输出结构可能如下所示，每个字段的错误都包含不同语言的版本：
{
"message":"The given data was invalid.",
"errors":{
"email":[
{
"nl":"E-mailadres is verplicht.",
"en":"The email field is required."
}
],
"first_name":[
{
"nl":"Voornaam moet minimaal 5 karakters lang zijn.",
"en":"The first name must be at least 5 characters."
}
]
}
}Laravel的FormRequest提供了一个messages()方法，允许我们为特定的验证规则定制错误消息。这个方法是实现多语言并行输出的关键。通过重写此方法，我们可以为每个验证规则定义一个包含多语言键值对的数组，从而让Validator在验证失败时直接返回这些预定义的多语言消息。
核心思想：
在messages()方法中，为每个需要多语言支持的验证规则（例如email.required、email.unique），不再直接返回一个字符串，而是返回一个关联数组，其中键是语言代码（如en、fr、nl），值是该语言下的错误消息。
实现步骤：
定义验证规则 (rules() 方法) 首先，像往常一样在FormRequest中定义你的验证规则。
// app/Http/Requests/SystemUserStoreRequest.php
class SystemUserStoreRequest extends ApiRequest
{
public function rules()
{
return [
'email' => 'required|unique:users,email,' . $this->id,
'first_name' => 'required|min:5',
];
}
// ... 其他方法
}定制多语言错误消息 (messages() 方法) 在同一个SystemUserStoreRequest类中，重写messages()方法。在这里，我们将为每个验证规则（如email.required、email.unique）定义多语言的错误消息。
// app/Http/Requests/SystemUserStoreRequest.php
class SystemUserStoreRequest extends ApiRequest
{
// ... rules() 方法
public function messages()
{
return [
'email.required' => [
'en' => __('validation.required', ['attribute' => __('portal.email', [], 'en')], 'en'),
'fr' => __('validation.required', ['attribute' => __('portal.email', [], 'fr')], 'fr'),
'nl' => __('validation.required', ['attribute' => __('portal.email', [], 'nl')], 'nl'),
],
'email.unique' => [
'en' => __('validation.unique', ['attribute' => __('portal.email', [], 'en')], 'en'),
'fr' => __('validation.unique', ['attribute' => __('portal.email', [], 'fr')], 'fr'),
'nl' => __('validation.unique', ['attribute' => __('portal.email', [], 'nl')], 'nl'),
],
'first_name.required' => [
'en' => __('validation.required', ['attribute' => __('portal.first_name', [], 'en')], 'en'),
'fr' => __('validation.required', ['attribute' => __('portal.first_name', [], 'fr')], 'fr'),
'nl' => __('validation.required', ['attribute' => __('portal.first_name', [], 'nl')], 'nl'),
],
'first_name.min' => [
'en' => __('validation.min.string', ['attribute' => __('portal.first_name', [], 'en'), 'min' => 5], 'en'),
'fr' => __('validation.min.string', ['attribute' => __('portal.first_name', [], 'fr'), 'min' => 5], 'fr'),
'nl' => __('validation.min.string', ['attribute' => __('portal.first_name', [], 'nl'), 'min' => 5], 'nl'),
],
];
}
}代码解析：
语言文件配置 确保你的resources/lang目录下有所有需要的语言文件夹（如en, fr, nl），并且每个文件夹中包含：
例如，resources/lang/nl/portal.php：
<?php
return [
'email' => 'E-mailadres',
'first_name' => 'Voornaam',
];resources/lang/nl/validation.php：
<?php
return [
'required' => ':attribute is verplicht.',
'unique' => ':attribute is al in gebruik.',
'min' => [
'string' => ':attribute moet minimaal :min karakters lang zijn.',
// ...
],
// ...
];通过重写Laravel FormRequest的messages()方法，并巧妙地利用__辅助函数嵌套调用，我们能够优雅地实现验证错误消息的多语言并行输出。这种方法避免了在failedValidation中进行复杂的语言环境切换逻辑，使得代码更简洁、更易于维护，并能直接为前端提供结构化的多语言错误响应，极大地提升了多语言应用的开发效率和用户体验。
以上就是Laravel FormRequest 多语言验证错误定制与输出的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
852
收藏
