Laravel如何实现多语言(Localization)功能

Laravel通过语言文件和App::setLocale实现多语言，1. 在resources/lang下创建zh/en目录及messages.php；2. 使用__()`或@lang调用翻译；3. 用App::setLocale动态切换语言；4. 可在中间件中根据请求参数、Session或浏览器头自动检测语言；5. 支持路由语言前缀如/zh、/en。

Laravel 提供了强大的多语言支持，通过 本地化（Localization） 功能可以轻松实现网站的多语言切换。核心机制依赖于语言文件和 App::setLocale() 方法来动态加载对应语言的内容。

1. 创建语言文件

Laravel 的语言文件存放在 resources/lang 目录下，每个语言对应一个子目录，例如：

• resources/lang/zh/messages.php
• resources/lang/en/messages.php

在 messages.php 中返回一个键值数组：

// resources/lang/en/messages.php
return [
    'welcome' => 'Welcome to our site',
    'about'   => 'About Us'
];

// resources/lang/zh/messages.php
return [
    'welcome' => '欢迎来到我们的网站',
    'about'   => '关于我们'
];

2. 使用 Laravel 的 __() 函数或 @lang 指令

在代码或模板中调用翻译内容：

• 控制器或 PHP 代码中： __('messages.welcome')
• Blade 模板中： @lang('messages.welcome') 或 {{ __('messages.welcome') }}

输出结果会根据当前设置的语言环境自动选择对应翻译。

3. 设置当前语言环境

使用 App::setLocale() 来切换语言：

use Illuminate\Support\Facades\App;

// 切换为中文
App::setLocale('zh');

// 切换为英文
App::setLocale('en');

通常结合用户请求参数、Session 或浏览器 Accept-Language 头来判断语言偏好。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

4. 自动检测用户语言（可选）

可以在中间件中自动设置语言：

// app/Http/Middleware/SetLocale.php
public function handle($request, \Closure $next)
{
    $locale = $request->get('language') ?? 
              $request->session()->get('locale') ?? 
              $request->getPreferredLanguage(['zh', 'en']);

    app()->setLocale($locale);

    return $next($request);
}

注册该中间件后，系统将优先读取 URL 参数 language=zh，其次 Session，最后浏览器偏好。

5. 路由中支持语言前缀（可选）

为不同语言设置路由前缀：

Route::group(['prefix' => '{locale}', 'middleware' => 'set.locale'], function () {
    Route::get('/', 'HomeController@index');
});

访问 /zh 或 /en 自动切换语言。

基本上就这些。Laravel 的多语言功能结构清晰，配合语言文件、__() 函数和动态 setLocale，就能快速实现国际化支持。不复杂但容易忽略细节，比如目录命名和键名匹配。

以上就是Laravel如何实现多语言(Localization)功能的详细内容，更多请关注php中文网其它相关文章！