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

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

发布时间 - 2025-12-15 00:00:00 点击率：次

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 】

上一篇：如何在阿里云虚拟主机上快速搭建个人网站？

下一篇：Laravel如何编写单元测试和功能测试？（PHPUnit示

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：如何在阿里云虚拟主机上快速搭建个人网站？

下一篇：Laravel如何编写单元测试和功能测试？（PHPUnit示