laravel通过 resources/lang 目录管理多语言文件，支持 php 数组和 jsON 格式，使用app::setLocale() 设置语言，结合 中间件 、 路由 前缀实现语言切换，利用__()函数或 @lang 指令输出翻译，支持复数形式 trans_choice 及生产环境配置缓存优化性能。
在 Laravel 中实现多语言支持（国际化与本地化，i18n）非常方便。Laravel 提供了强大的语言文件管理机制，可以轻松地为不同语言的用户提供对应的语言内容。下面详细介绍如何配置和使用 Laravel 的多语言功能。
配置语言文件目录
Laravel 默认将语言文件存放在 resources/lang 目录下。每个语言对应一个子目录，例如：
你可以根据项目需要创建多个语言目录。推荐使用语言代码命名，如 en、zh、ja 等。
定义语言文件内容
语言文件支持两种格式：PHP 数组 和 json 文件。
使用 PHP 数组（messages.php）：
// resources/lang/zh/messages.php return ['welcome' => '欢迎', 'hello' => '你好，:name',];
使用 JSON 文件（推荐用于短语较多的场景）：
// resources/lang/en.json {"welcome": "Welcome", "hello": "Hello, :name"}
JSON 方式适合管理大量翻译文本，尤其是 前端 也需要读取时更方便。
设置当前应用语言
可以通过 App::setLocale() 设置当前请求的语言：
use IlluminateSupportFacadesApp; App::setLocale('zh'); // 设置为中文
通常你会根据用户选择、URL 路径或 浏览器 Accept-Language 自动切换语言。例如在中间件中判断：
class SetLocaleMiddleware {public function handle($request, $next) {$locale = $request->get('lang', 'en'); // 或从 session、header 获取 if (in_array($locale, ['en', 'zh'])) {App::setLocale($locale); } return $next($request); } }
在视图和代码中输出翻译
使用辅助函数 __() 或 @lang 指令获取翻译内容：
// PHP 中 echo __('messages.welcome'); echo __('Hello, :name', ['name' => 'Tom']); // Blade 模板中 @lang('messages.welcome') {{__('messages.hello', ['name' => '小明']) }}
如果使用的是 JSON 根级别翻译，可以直接用键名：
// en.json 中有 "save" => "Save" __('save') // 输出 "Save"
路由 中的多语言支持
你可以在路由中加入语言前缀来区分不同语言版本：
Route::group(['prefix' => '{locale}', 'where' => ['locale' => 'en|zh']], function () { Route::get('/welcome', function ($locale) {App::setLocale($locale); return view('welcome'); }); });
这样访问 /en/welcome 和 /zh/welcome 就能自动切换语言。
处理复数与语言选项
Laravel 还支持根据数量显示不同翻译，使用 trans_choice：
// 语言文件中 'apples.one' => '有一个 苹果', 'apples.other' => '有 :count 个苹果', // 使用 echo trans_choice('messages.apples', 2); // 输出：有 2 个苹果
缓存语言文件（生产环境优化）
在生产环境中，可以运行以下命令缓存语言文件以提升性能：
php artisan config:cache
注意：修改语言文件后需重新缓存。
基本上就这些。Laravel 的多语言系统简洁实用，结合路由、中间件和视图指令，可以快速构建支持多语言的 Web 应用。不复杂但容易忽略细节，比如语言键的命名规范和 JSON 文件的 编码 问题（必须是 UTF-8）。
以上就是 Laravel 如何实现多语言支持_Laravel 本地化与国际化 (i18n) 配置教程的详细内容，更多请关注 php 中文网其它相关文章！
