新闻中心 分类>>

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

2025-11-16 00:00:00
浏览次数:
返回列表
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 头来判断语言偏好。

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,就能快速实现国际化支持。不复杂但容易忽略细节,比如目录命名和键名匹配。

搜索