登录注册

当前位置：首页 > 文章列表 > 文章 > php教程 > Laravel多语言验证错误返回方法

Laravel多语言验证错误返回方法

2025-12-09 22:36:42 0浏览 收藏

小伙伴们有没有觉得学习文章很有意思？有意思就对了！今天就给大家带来《Laravel多语言验证错误返回教程》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

Laravel表单请求中同时返回多语言验证错误教程

本教程详细介绍了如何在Laravel应用程序中实现同时返回多种语言的验证错误。通过自定义`FormRequest`的`messages()`方法来定义包含多语言信息的验证消息，并进一步在`failedValidation`方法中处理这些信息，以生成符合特定多语言输出结构的API响应，从而满足复杂的多语言API接口需求。

在构建国际化的Web应用或API时，经常会遇到需要同时向客户端返回多种语言的验证错误信息。Laravel的默认验证机制通常只返回当前应用语言环境下的错误消息。当需求是为每个字段的每个错误同时提供多种语言版本时，就需要对默认行为进行定制。本教程将指导您如何通过扩展FormRequest类来实现这一目标，生成如以下结构的多语言验证错误响应：

{
  "detail": {
      "email": {
        "en-CA" : [
          "The email has already been taken."
        ],
        "fr-CA" : [
          "The french text."
        ]
      },
      "first_name": {
        "en-CA" : [
          "The first name must be at least 5.",
          "The first name must be an integer."
        ],
        "fr-CA" : [
          "The french text",
          "The french text."
        ]
      }
  }
}

理解Laravel验证与多语言需求

Laravel的FormRequest提供了一种方便的方式来封装验证逻辑。当验证失败时，它会触发failedValidation方法，并注入一个包含错误信息的Validator实例。默认情况下，$validator->getMessageBag()->toArray()会根据当前应用的locale返回错误消息。为了同时获取多种语言的错误，我们需要在消息定义阶段就嵌入这些多语言信息。

核心策略：定制FormRequest的messages()方法

实现多语言验证错误的关键在于重写FormRequest中的messages()方法。这个方法允许您为特定的验证规则和字段定义自定义的错误消息。不同于简单的字符串，我们可以为每个规则定义一个包含多语言键值对的数组。

以下是一个SystemUserStoreRequest的示例，展示了如何为email字段的required和unique规则定义en-CA和fr-CA两种语言的错误消息：

// app/Http/Requests/SystemUserStoreRequest.php
id 用于在更新时排除当前用户
        $userId = $this->route('user') ? $this->route('user')->id : null;
        return [
            'email'      => 'required|email|unique:users,email,' . $userId,
            'first_name' => 'required|string|min:5',
            // ... 其他验证规则
        ];
    }

    /**
     * Get the error messages for the defined validation rules.
     *
     * @return array
     */
    public function messages()
    {
        return [
            'email.required' => [
               'en-CA' => __('validation.required', ['attribute' => __('attributes.email', [], 'en-CA')], 'en-CA'),
               'fr-CA' => __('validation.required', ['attribute' => __('attributes.email', [], 'fr-CA')], 'fr-CA'),
            ],
            'email.email' => [
               'en-CA' => __('validation.email', ['attribute' => __('attributes.email', [], 'en-CA')], 'en-CA'),
               'fr-CA' => __('validation.email', ['attribute' => __('attributes.email', [], 'fr-CA')], 'fr-CA'),
            ],
            'email.unique' => [
               'en-CA' => __('validation.unique', ['attribute' => __('attributes.email', [], 'en-CA')], 'en-CA'),
               'fr-CA' => __('validation.unique', ['attribute' => __('attributes.email', [], 'fr-CA')], 'fr-CA'),
            ],
            'first_name.required' => [
                'en-CA' => __('validation.required', ['attribute' => __('attributes.first_name', [], 'en-CA')], 'en-CA'),
                'fr-CA' => __('validation.required', ['attribute' => __('attributes.first_name', [], 'fr-CA')], 'fr-CA'),
            ],
            'first_name.min' => [
                'en-CA' => __('validation.min.string', ['attribute' => __('attributes.first_name', [], 'en-CA'), 'min' => 5], 'en-CA'),
                'fr-CA' => __('validation.min.string', ['attribute' => __('attributes.first_name', [], 'fr-CA'), 'min' => 5], 'fr-CA'),
            ],
            // ... 其他字段和规则的多语言消息
        ];
    }
}

在上面的messages()方法中：

  1. 我们为每个验证规则（如email.required）返回一个关联数组。
  2. 这个数组的键是语言环境代码（例如en-CA, fr-CA），值是对应语言的错误消息。
  3. 我们使用Laravel的__辅助函数来获取翻译字符串。
    • __('validation.required', ['attribute' => ...], 'en-CA')：这会从lang/en-CA/validation.php文件中获取required规则的翻译。
    • ['attribute' => __('attributes.email', [], 'en-CA')]：这是关键！它解决了占位符替换的问题。我们通过再次调用__辅助函数来翻译:attribute占位符本身（例如，将email翻译成"Email Address"或"Adresse e-mail"），并指定目标语言。
    • attributes.email表示从lang/en-CA/attributes.php（或您自定义的翻译文件，如portal.php）中获取email字段的翻译。

关于翻译文件：

为了使上述代码正常工作，您需要在resources/lang目录下创建相应的语言文件，例如：

  • resources/lang/en-CA/validation.php
  • resources/lang/fr-CA/validation.php
  • resources/lang/en-CA/attributes.php (或 portal.php)
  • resources/lang/fr-CA/attributes.php (或 portal.php)

validation.php文件应包含标准验证规则的翻译，而attributes.php（或portal.php）文件则应包含字段名的翻译。

示例 resources/lang/en-CA/attributes.php:

 'Email Address',
    'first_name' => 'First Name',
];

示例 resources/lang/fr-CA/attributes.php:

 'Adresse e-mail',
    'first_name' => 'Prénom',
];

在failedValidation中构建多语言响应结构

现在，当SystemUserStoreRequest验证失败时，$validator->getMessageBag()->toArray()将返回一个包含我们定义的这种多语言结构（例如['email.required' => ['en-CA' => '...', 'fr-CA' => '...']]）的数组。我们需要在ApiRequest（或直接在SystemUserStoreRequest中）重写的failedValidation方法中，将这个结构转换为我们期望的最终API响应格式。

假设您的ApiRequest基类如下：

// app/Http/Requests/ApiRequest.php
getMessageBag()->toArray();
        $transformedErrors = [];

        foreach ($rawErrors as $fieldRule => $messages) {
            // $fieldRule 可能是 "email.required", "first_name.min" 等
            // $messages 是一个包含多语言消息的数组，例如：
            // [0 => ['en-CA' => '...', 'fr-CA' => '...']]

            // 提取字段名，例如从 "email.required" 中获取 "email"
            $field = explode('.', $fieldRule)[0];

            foreach ($messages as $messageItem) {
                // $messageItem 现在是 ['en-CA' => '...', 'fr-CA' => '...']
                foreach ($messageItem as $locale => $message) {
                    if (!isset($transformedErrors[$field])) {
                        $transformedErrors[$field] = [];
                    }
                    if (!isset($transformedErrors[$field][$locale])) {
                        $transformedErrors[$field][$locale] = [];
                    }
                    $transformedErrors[$field][$locale][] = $message;
                }
            }
        }

        // 抛出包含自定义响应的 HttpResponseException
        throw new HttpResponseException(response()->json([
            'message' => 'The given data was invalid.',
            'detail' => $transformedErrors,
        ], 422));
    }
}

在上述failedValidation方法中：

  1. 我们首先通过$validator->getMessageBag()->toArray()获取包含多语言信息的原始错误数组。
  2. 然后，我们遍历这个rawErrors数组。$fieldRule会是email.required、first_name.min等，而$messages则是一个包含多语言消息的数组（例如[0 => ['en-CA' => '...', 'fr-CA' => '...']]）。
  3. 我们从$fieldRule中解析出实际的字段名（例如email）。
  4. 接着，我们再次遍历$messages数组，处理每个语言环境的消息，并将其添加到$transformedErrors中，构建出期望的嵌套结构。
  5. 最后，我们抛出一个HttpResponseException，其中包含自定义的JSON响应，其detail字段就是我们精心构造的多语言错误信息。

完整代码示例

app/Http/Requests/ApiRequest.php (基类)

getMessageBag()->toArray();
        $transformedErrors = [];

        foreach ($rawErrors as $fieldRule => $messages) {
            $field = explode('.', $fieldRule)[0]; // 提取字段名

            foreach ($messages as $messageItem) {
                foreach ($messageItem as $locale => $message) {
                    if (!isset($transformedErrors[$field])) {
                        $transformedErrors[$field] = [];
                    }
                    if (!isset($transformedErrors[$field][$locale])) {
                        $transformedErrors[$field][$locale] = [];
                    }
                    $transformedErrors[$field][$locale][] = $message;
                }
            }
        }

        throw new HttpResponseException(response()->json([
            'message' => 'The given data was invalid.',
            'detail' => $transformedErrors,
        ], 422));
    }
}

app/Http/Requests/SystemUserStoreRequest.php (具体的请求类)

route('user') ? $this->route('user')->id : null;
        return [
            'email'      => 'required|email|unique:users,email,' . $userId,
            'first_name' => 'required|string|min:5',
        ];
    }

    public function messages()
    {
        return [
            'email.required' => [
               'en-CA' => __('validation.required', ['attribute' => __('attributes.email', [], 'en-CA')], 'en-CA'),
               'fr-CA' => __('validation.required', ['attribute' => __('attributes.email', [], 'fr-CA')],

终于介绍完啦！小伙伴们，这篇关于《Laravel多语言验证错误返回方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！

罗技GHUB驱动故障解决方法罗技GHUB驱动故障解决方法
上一篇
罗技GHUB驱动故障解决方法
PDF密码破解技巧与安全防护方法
下一篇
PDF密码破解技巧与安全防护方法
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案，代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景，打造一站式知识长龙服务，适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例，全面具体可落地，从理论到实践，一步一步将GO核心编程技术、编程思想、底层实现融会贯通，使学习者贴近时代脉搏，做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信：Le-studyg；在课程中，我们将首先介绍MySQL8的新特性，包括性能优化、安全增强、新数据类型等，帮助学生快速熟悉MySQL8的最新功能。接着，我们将深入解析MySQL的网络通信机制，包括协议、连接管理、数据传输等，让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网，分为导航，轮播，关于我们，成功案例，服务流程，团队介绍，数据部分，公司动态，底部信息等内容区块。网站整体采用CSSGrid布局，支持响应式，有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解：生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集，涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用，助力提升NLP模型性能。
    465次使用
  • H2O EvalGPT：开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台，提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能，助您快速选择最适合项目的高性能大语言模型。
    527次使用
  • LMArena是什么？伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制，用户可对比不同大模型回答并生成实时排行榜，助力开发者优化模型及用户选择最佳AI工具。
    545次使用
  • 斯坦福HELM：大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM（Holistic Evaluation of Language Models）大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景，涵盖准确性、公平性、鲁棒性等多维度指标，助力开发者全面优化语言模型性能。
    495次使用
  • MMBench详解：多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台，提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景，助力开发者全面评估多模态模型性能。
    314次使用
查看更多
相关文章
关于我们 免责声明 意见反馈 联系我们 内容提交 手册
Golang学习网：公益在线Go学习平台，帮助Go学习者快速成长！
技术交流群
Copyright 2023 http://www.17golang.com/ All Rights Reserved ｜ 湘ICP备19018815号-4
  • Golang学习网
    关注公众号
    Golang学习网
微信登录更方便
  • 密码登录
  • 注册账号
忘记密码
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码
发送验证码