Yii2多语言设置全攻略

Yii2 国际化是实现多语言支持的关键，本文将详细介绍 Yii2 框架下的 i18n 模块配置与应用。通过配置 `language` 和 `sourceLanguage`，并结合 `PhpMessageSource` 管理翻译文件，将不同语言文本存储于 `@app/messages` 目录下，利用 `Yii::t()` 方法轻松调用翻译。此外，Yii2 还支持日期、数字的本地化格式，以及动态切换语言功能，建议将语言设置保存在 session 或 cookie 中。更可使用 `message` 命令自动提取翻译文本，简化多语言维护工作，助你快速完成 Yii2 应用的国际化适配。掌握这些技巧，让你的应用轻松支持多种语言，提升用户体验。

Yii2通过i18n模块实现多语言支持，需配置language和sourceLanguage，使用PhpMessageSource管理翻译文件，将不同语言文本存于@app/messages对应目录，并通过Yii::t()调用；结合formatter可本地化日期、数字格式，支持动态切换语言并建议存储于session或cookie，还可利用message命令自动提取翻译文本，完成国际化适配。

Yii2 的国际化（Internationalization）和本地化（Localization）功能非常强大，能帮助开发者轻松实现多语言支持。核心是通过 Yii2 内置的 i18n 模块，结合消息翻译、日期时间格式、数字格式等机制，让应用适配不同语言和地区。

配置语言与源语言

在应用配置中设置 language（当前显示语言）和 sourceLanguage（原始语言，通常是英文或中文）：

return [
    'components' => [
        'i18n' => [
            'translations' => [
                '*' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'basePath' => '@app/messages',
                    'fileMap' => [
                        'app' => 'app.php',
                        'common' => 'common.php',
                    ],
                ],
            ],
        ],
    ],
    'language' => 'zh-CN', // 当前语言
    'sourceLanguage' => 'en-US', // 原始语言
];

这里将所有消息映射到 @app/messages 目录下的对应 PHP 文件，比如英文原文放在 @app/messages/en-US/app.php，中文翻译放在 @app/messages/zh-CN/app.php。

编写翻译文件

在 @app/messages/zh-CN/app.php 中定义翻译内容：

return [
    'Hello world!' => '你好世界！',
    'Welcome to our website' => '欢迎访问我们的网站',
];

使用 Yii::t() 方法调用翻译：

echo \Yii::t('app', 'Hello world!');
echo \Yii::t('common', 'Welcome to our website');

第一个参数是分类（category），对应 fileMap 中的键名，第二个是待翻译的原文。

支持动态语言切换

允许用户切换语言时，可以在控制器或行为中更改应用语言：

if (isset($_GET['lang'])) {
    \Yii::$app->language = $_GET['lang']; // 如 'zh-CN' 或 'en-US'
}

建议将语言保存在 session 或 cookie 中，避免每次请求都传参。

日期、时间和数字本地化

Yii2 使用 ICU 格式支持本地化的格式输出。确保系统安装了 intl 扩展。

示例：

echo Yii::$app->formatter->asDate('2025-04-05'); // 根据 language 自动格式化
echo Yii::$app->formatter->asDecimal(1234.56);

例如，在 zh-CN 下，数字可能显示为“1,234.56”，日期为“2025年4月5日”。

生成翻译文件（可选工具）

可以使用 message command 自动提取代码中的 Yii::t() 文本：

yii message/config /path/to/message-config.php
yii message /path/to/message-config.php

配置文件可指定扫描目录、输出路径、语言列表等，提升多语言维护效率。

基本上就这些。只要配置好路径、写好翻译文件，再用 Yii::t() 替换硬编码文本，就能实现完整的多语言支持。不复杂但容易忽略细节，比如文件路径大小写、分类匹配等。

今天关于《Yii2多语言设置全攻略》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！