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 Illuminate\Support\Facades\App;
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）。
