YII框架的国际化是什么？YII框架如何支持多语言？-YII-PHP中文网

yii国际化核心概念包括sourcelanguage和language，前者是开发时的原始语言，后者是用户当前语言，只有两者不同时才会触发翻译；2. yii::t()是文本翻译的核心方法，通过消息类别和原文查找对应译文，并支持带占位符的动态替换；3. 消息类别用于对翻译文本进行逻辑分组，提升维护性和查找效率；4. 消息源（message sources）支持phpmessagesource、dbmessagesource及自定义源，决定翻译文件的存储方式；5. formatter组件负责日期、数字、货币等非文本内容的本地化格式化，确保符合各地文化习惯。这些机制共同实现yii应用的多语言支持，使应用能根据不同语言环境自动适配显示内容，完整支持国际化需求。

YII框架的国际化是什么？YII框架如何支持多语言？

YII框架的国际化（I18N）和多语言支持，说到底，就是让你的Web应用能够理解并适应不同国家和地区用户的语言和文化习惯。它远不止是界面文字的翻译那么简单，更深层次地，它触及日期、时间、数字、货币的格式化，甚至是文本方向（比如从左到右或从右到左）的适配。对我们这些写代码的人来说，这意味着我们不需要为每种语言都写一套独立的业务逻辑，而是通过一套统一的机制，让内容根据用户的偏好自动呈现。

解决方案

YII框架的多语言支持核心在于它的消息翻译机制。这套机制允许我们将应用程序中所有面向用户的文本字符串——无论是界面上的按钮文字、输入框的占位符，还是各种提示信息、错误消息——从业务逻辑代码中优雅地抽离出来，统一存放在专门的翻译文件中。当用户访问应用时，YII会根据其设定的语言环境，自动从对应的翻译文件中加载并显示相应的文本。

具体操作上，

Yii::t()

登录后复制

是这个机制的绝对核心。它就像一个智能翻译官，你只需要告诉它一个消息的“类别”和“原文”，它就能帮你找到当前语言对应的译文。举个例子，

Yii::t('app', 'Hello, world!')

登录后复制

。这里的

app

登录后复制

就是消息的类别，它帮助我们组织和管理大量的翻译文本，避免所有字符串都混在一起，让维护变得一团糟。

YII还通过

sourceLanguage

登录后复制

和

language

登录后复制

这两个关键的配置项来控制翻译行为。

sourceLanguage

登录后复制

是你开发应用时使用的默认语言，通常是中文或英文，这是你的“母语”。而

language

登录后复制

则是当前用户希望看到的语言。只有当

language

登录后复制

和

sourceLanguage

登录后复制

不同时，YII才会启动它的翻译查找过程。

除了文本翻译，YII的

Formatter

登录后复制

组件也扮演着不可或缺的角色。它负责处理数字、日期、货币等非文本内容的本地化显示。比如，同一个数字

1234.56

登录后复制

，在美国可能显示为

1,234.56

登录后复制

，而在德国则可能是

1.234,56

登录后复制

。这些看似微小却至关重要的文化差异，

Formatter

登录后复制

都能帮你妥善处理，让你的应用真正做到“入乡随俗”。

YII国际化中的核心概念有哪些？

理解YII的国际化，有几个概念是绕不开的，它们构成了整个多语言体系的基石。

首先是

sourceLanguage

登录后复制

和

language

登录后复制

。

sourceLanguage

登录后复制

定义了你应用中原始文本的语言，它通常是你的开发语言，比如

en-US

登录后复制

或

zh-CN

登录后复制

。这个设置非常重要，因为它告诉YII你的“源头”是什么。而

language

登录后复制

则代表当前用户希望看到的语言，它可以是动态变化的，根据用户的浏览器设置、URL参数或用户偏好来设定。YII只有在

language

登录后复制

与

sourceLanguage

登录后复制

不同时，才会去查找并应用翻译。如果两者相同，它就直接使用源文本，避免了不必要的翻译查找开销。

接着是

Yii::t()

登录后复制

方法。这是你在代码中进行文本翻译的入口。它的第一个参数是“消息类别”（message category），比如

app

登录后复制

、

user

登录后复制

、

common

登录后复制

等，用于对翻译文本进行逻辑分组。第二个参数是原始文本，也就是需要翻译的字符串。它还可以接受第三个参数，一个数组，用于替换翻译文本中的占位符，比如

Yii::t('app', 'Hello, {username}!', ['username' => 'Alice'])

登录后复制

，这让翻译变得更加灵活和动态。

消息类别（Message Categories）的设计，在我看来，是YII国际化一个很实用的点。它强制你对翻译文本进行分类，而不是把所有字符串都扔到一个文件里。这不仅让翻译文件结构清晰，便于团队协作，也提高了翻译查找的效率。你可以为不同的模块或功能定义不同的类别，比如

app

登录后复制

用于全局应用文本，

backend

登录后复制

用于后台管理文本，

frontend

登录后复制

用于前台用户界面文本等等。

再来是消息源（Message Sources）。YII默认提供了

PhpMessageSource

登录后复制

，也就是将翻译文本存储在PHP文件中，这是最常见也是最简单的做法。但如果你有大量翻译，或者需要让非开发人员也能管理翻译，

DbMessageSource

登录后复制

（将翻译存储在数据库中）会是更好的选择。当然，YII也支持自定义消息源，这意味着你可以从任何地方加载翻译，比如远程API或缓存系统，这给高级应用带来了极大的灵活性。

最后，别忘了

Formatter

登录后复制

组件。虽然它不直接处理文本翻译，但它负责处理数字、日期、货币等非文本数据的本地化显示。这对于构建一个真正国际化的应用至关重要。一个数字

1234.56

登录后复制

在不同文化中可能需要不同的千位分隔符和小数点符号；一个日期

2023-10-26

登录后复制

在美国可能是

10/26/2023

登录后复制

，在欧洲可能是

26.10.2023

登录后复制

。

Formatter

登录后复制

统一处理这些细节，让你的应用在任何语言环境下都能提供正确的文化体验。

如何在YII应用中配置和使用多语言功能？

在YII应用中配置和使用多语言功能，实际上是一个逐步深入的过程，从全局设置到具体代码实现。

首先，你需要修改应用的配置文件，通常是

config/web.php

登录后复制

或

config/main.php

登录后复制

。在这里，你会设置

language

登录后复制

和

sourceLanguage

登录后复制

。例如：

return [
    'id' => 'my-app',
    'basePath' => dirname(__DIR__),
    'bootstrap' => ['log'],
    'language' => 'zh-CN', // 默认语言，用户访问时会看到的语言
    'sourceLanguage' => 'en-US', // 你的代码中原始文本的语言
    'components' => [
        'i18n' => [
            'translations' => [
                'app*' => [ // 匹配所有以 'app' 开头的消息类别
                    'class' => 'yii\i18n\PhpMessageSource',
                    'basePath' => '@app/messages',
                    // 'sourceLanguage' => 'en-US', // 可以在这里覆盖全局的sourceLanguage
                    'fileMap' => [
                        'app' => 'app.php',
                        'app/error' => 'error.php',
                    ],
                ],
                // 还可以配置其他类别，比如 'user*'
            ],
        ],
        // ... 其他组件
    ],
    // ...
];

登录后复制

这里，

i18n

登录后复制

组件的

translations

登录后复制

配置项是关键，它告诉YII去哪里找不同类别的翻译文件。

basePath

登录后复制

指向你的翻译文件存放的根目录，通常是

@app/messages

登录后复制

。

fileMap

登录后复制

则定义了消息类别和实际PHP文件名之间的映射关系。

配置好后，下一步就是创建实际的翻译文件。在

@app/messages

登录后复制

目录下，你会根据你的

sourceLanguage

登录后复制

和

language

登录后复制

创建子目录。比如，如果你的

sourceLanguage

登录后复制

是

en-US

登录后复制

，

language

登录后复制

是

zh-CN

登录后复制

，那么你可能需要这样的目录结构：

messages/
├── en-US/
│   └── app.php
└── zh-CN/
    └── app.php

登录后复制

app.php

登录后复制

文件内部就是一个简单的PHP数组，键是原始文本（

sourceLanguage

登录后复制

对应的文本），值是翻译后的文本：

messages/en-US/app.php

登录后复制

<?php
return [
    'Hello, world!' => 'Hello, world!', // 源语言文件也最好有，方便对照
    'Welcome back, {username}!' => 'Welcome back, {username}!',
    'Save' => 'Save',
];

登录后复制

messages/zh-CN/app.php

登录后复制

<?php
return [
    'Hello, world!' => '你好，世界！',
    'Welcome back, {username}!' => '欢迎回来，{username}！',
    'Save' => '保存',
];

登录后复制

在你的视图文件（

.php

登录后复制

）或控制器中，就可以使用

Yii::t()

登录后复制

来获取翻译后的文本了：

<h1><?= Yii::t('app', 'Hello, world!') ?></h1>
<p><?= Yii::t('app', 'Welcome back, {username}!', ['username' => $user->username]) ?></p>
<button><?= Yii::t('app', 'Save') ?></button>

登录后复制

要实现动态切换语言，通常有几种做法。一种是通过URL参数，比如

example.com/index.php?r=site/index&lang=en-US

登录后复制

。你可以在

Bootstrap

登录后复制

阶段或者在

beforeAction

登录后复制

过滤器中，根据这个参数设置

Yii::$app->language

登录后复制

：

// 在 components/LanguageSelector.php 或类似的引导文件中
public function bootstrap($app)
{
    if (isset($_GET['lang'])) {
        $app->language = $_GET['lang'];
        // 也可以考虑将语言存入session或cookie，以便下次访问时记住
        // Yii::$app->session->set('language', $_GET['lang']);
    } elseif (Yii::$app->session->has('language')) {
        $app->language = Yii::$app->session->get('language');
    }
    // 否则，YII会使用配置文件中定义的默认语言
}

登录后复制

将这个