Laravel如何实现多语言支持_Laravel本地化与国际化(i18n)配置教程_网络技术

Laravel通过resources/lang目录管理多语言文件，支持PHP数组和JSON格式，使用App::setLocale()设置语言，结合中间件、路由前缀实现语言切换，利用__()函数或@lang指令输出翻译，支持复数形式trans_choice及生产环境配置缓存优化性能。

在 Laravel 中实现多语言支持（国际化与本地化，i18n）非常方便。Laravel 提供了强大的语言文件管理机制，可以轻松地为不同语言的用户提供对应的语言内容。下面详细介绍如何配置和使用 Laravel 的多语言功能。

配置语言文件目录

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

resources/lang/zh/en.json
resources/lang/zh/cn.json
resources/lang/es/messages.php

你可以根据项目需要创建多个语言目录。推荐使用语言代码命名，如 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）。

# php # laravel # js # 前端 # json # cad # 编码 # 浏览器 # app # 苹果 # session # 路由 # apple # 中间件 # 多语言 # 你可以 # 的是 # 放在 # 尤其是 # 就能 # 多个 # 你会 # 两种 # 中有

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】