Laravel如何实现本地化和多语言支持？（i18n教程）

Laravel 原生支持多语言，通过配置 config/app.php 的 'locale' 和 'fallback_locale'、组织 resources/lang/xx/ 下的语言文件、使用 __() 和 @lang 翻译函数、结合中间件动态设置 App::setLocale() 实现本地化。

在 Laravel 中实现本地化（i18n）和多语言支持，核心是利用其内置的 语言文件管理、本地化辅助函数 和 请求语言自动识别机制。不需要第三方包就能开箱即用，关键在于组织好语言资源、正确设置语言上下文，并在视图与逻辑中统一调用。

配置语言环境和默认语言

Laravel 默认使用 en 作为应用语言，配置位于 config/app.php 的 'locale' 项。你可以按需修改：

• 将 'locale' => 'en' 改为 'locale' => 'zh' 或 'locale' => 'ja'
• 同时设置备用语言（回退语言）：'fallback_locale' => 'en'，当某条翻译缺失时自动降级
• 确保 APP_LOCALE 环境变量（如在 .env 中）与配置一致，便于部署时灵活切换

组织语言文件结构

所有翻译文本存放在 resources/lang 目录下，按语言代码分文件夹：

• resources/lang/en/messages.php —— 英文翻译，返回关联数组：return ['welcome' => 'Welcome to our site!'];
• resources/lang/zh/messages.php —— 中文翻译，键名保持一致：return ['welcome' => '欢迎来到我们的网站！'];
• 支持嵌套键：如 'auth.failed' => 'These credentials do not match our records.'，对应调用 __('auth.failed')
• 推荐按功能模块拆分文件（如 auth.php、validation.php、messages.php），避免单文件臃肿

在代码中使用翻译函数

Laravel 提供多个全局辅助函数，最常用的是 __() 和 @lang Blade 指令：

标签： php laravel cookie 浏览器 app session ai 路由 环境变量 多语言 本地化 red