Laravel多语言本地化通过语言文件、动态切换和中间件实现。1. 在resources/lang下创建en/zh语言文件返回键值对;2. 配置app.php的default_locale;3. 使用__()`或@lang获取翻译;4. 用App::setLocale()动态切换语言并存入session;5. 创建SetLocale中间件自动设置用户偏好;6. 可选路由语言前缀支持。需注意复数与占位符处理。

在 Laravel 中实现多语言本地化(Localization)非常方便,框架提供了完整的语言文件管理和动态切换语言的功能。下面详细介绍如何配置和使用 Laravel 的多语言支持。
1. 创建语言文件
Laravel 的语言文件存放在 resources/lang 目录下。每个语言对应一个子目录,例如:
/resources/lang/en/messages.php /resources/lang/zh/messages.php
在这些文件中返回一个键值数组,例如英文版 en/messages.php:
return [
'welcome' => 'Welcome to our website',
'about' => 'About Us'
];
中文版 zh/messages.php:
return [
'welcome' => '欢迎访问我们的网站',
'about' => '关于我们'
];
2. 配置默认语言和可选语言
打开 config/app.php 文件,设置默认语言和可用语言:
'default_locale' => 'en', 'fallback_locale' => 'en',
你可以在运行时动态更改当前语言,无需修改配置文件。
3. 在代码中使用语言文件
使用 __() 辅助函数或 @lang 模板指令来获取翻译内容。
控制器中使用:
echo __('messages.welcome');
// 输出:Welcome to our website(当前语言为 en 时)
Blade 模板中使用:
@lang('messages.welcome')
4. 动态切换语言
通过 App::setLocale($lang) 方法动态设置当前请求的语言。
例如,在中间件或控制器中根据用户选择切换语言:
use Illuminate\Support\Facades\App;
public function setLanguage($locale)
{
if (in_array($locale, ['en', 'zh'])) {
App::setLocale($locale);
session(['applocale' => $locale]);
}
return redirect()->back();
}
可以结合 Session 或 URL 参数保存用户偏好语言。
5. 使用中间件自动设置语言
创建中间件自动读取用户语言偏好:
php artisan make:middleware SetLocale
在中间件的 handle 方法中添加:
if (session()->has('applocale') && in_array(session('applocale'), ['en', 'zh'])) {
app()->setLocale(session('applocale'));
}
注册中间件后,每次请求都会自动应用用户选择的语言。
6. 路由中支持语言前缀(可选)
你可以为不同语言设置带前缀的路由:
Route::get('/en/home', function () {
app()->setLocale('en');
return view('home');
});
Route::get('/zh/home', function () {
app()->setLocale('zh');
return view('home');
});
也可以使用参数化方式简化:
Route::get('/{locale}/home', function ($locale) {
if (in_array($locale, ['en', 'zh'])) {
app()->setLocale($locale);
}
return view('home');
});
基本上就这些。Laravel 的本地化机制简洁实用,配合语言文件、辅助函数和动态切换,能快速实现多语言网站。关键是组织好语言文件结构,并合理管理用户语言偏好。不复杂但容易忽略细节,比如复数形式或占位符替换,需要时可查阅官方文档进一步扩展。










