Yii 2: The Fast, Secure and Professional PHP Framework 多语言支持：让应用走向世界
项目地址: https://gitcode.com/gh_mirrors/yi/yii2 在全球化时代，让应用支持多种语言已成为开发者的必备技能。Yii 2作为一款高效、安全的PHP框架，提供了完善的国际化（Internationalization，简称I18N）解决方案，帮助开发者轻松构建面向全球用户的应用。本文将详细介绍Yii 2的多语言支持功能，从基础配置到高级应用，助你快速掌握国际化开发技巧。
区域与语言基础
区域（Locale）
区域设置是一组参数，定义了用户的语言、国家和特殊偏好，通常由语言代码和国家代码组成，格式为ll-CC，其中ll是ISO-639语言代码，CC是ISO-3166国家代码。例如，en-US代表美国英语，zh-CN代表简体中文。
语言（Language）
Yii 2应用使用两种语言：
- 源语言（Source Language）：代码中编写的语言，默认值为
en-US。 - 目标语言（Target Language）：显示给用户的语言，可以动态设置。
你可以在应用配置文件中设置默认语言：
return [
// 设置目标语言为中文
'language' => 'zh-CN',
// 设置源语言为英语
'sourceLanguage' => 'en-US',
// 其他配置...
];
也可以在运行时动态更改目标语言：
// 改变目标语言为日文
\Yii::$app->language = 'ja-JP';
消息翻译
消息翻译原理
消息翻译服务用于将文本信息从源语言翻译成目标语言。Yii 2通过Yii::t()方法实现消息翻译，其基本用法如下：
echo \Yii::t('app', 'This is a string to translate!');
其中，app是消息类别，'This is a string to translate!'是需要翻译的消息。
配置消息源
要使用消息翻译，需配置i18n组件。Yii 2支持多种消息源，如PHP文件、Gettext文件和数据库等。以下是使用PHP文件作为消息源的配置示例：
'components' => [
'i18n' => [
'translations' => [
'app*' => [
'class' => 'yii\i18n\PhpMessageSource',
'fileMap' => [
'app' => 'app.php',
'app/error' => 'error.php',
],
],
],
],
],
上述配置表示，所有以app开头的消息类别都使用PhpMessageSource，并将app类别映射到app.php文件，app/error类别映射到error.php文件。
创建翻译文件
翻译文件通常存储在@app/messages目录下，目录结构如下：
messages/
zh-CN/
app.php
error.php
ja-JP/
app.php
error.php
例如，messages/zh-CN/app.php文件内容如下：
<?php
return [
'This is a string to translate!' => '这是一个需要翻译的字符串！',
'Hello, {username}!' => '你好，{username}！',
];
消息格式化
Yii 2支持丰富的消息格式化功能，包括参数替换、数字、日期、复数等格式化。
参数替换
可以在消息中嵌入占位符，并通过参数动态替换：
$username = '张三';
echo \Yii::t('app', 'Hello, {username}!', ['username' => $username]);
// 输出：你好，张三！
复数格式化
不同语言有不同的复数规则，Yii 2支持复杂的复数格式化：
// 当 $n = 0 时，输出："没有消息"
// 当 $n = 1 时，输出："1条消息"
// 当 $n > 1 时，输出："n条消息"
echo \Yii::t('app', 'There {n, plural, =0{are no messages} =1{is one message} other{are # messages}}!', ['n' => $n]);
日期和时间格式化
需要安装intl PHP扩展，可以格式化日期和时间：
echo \Yii::t('app', 'Today is {0, date, short}', time());
// 输出：今天是23-10-12
echo \Yii::t('app', 'It is {0, time, short}', time());
// 输出：现在是08:30
使用message命令管理翻译
Yii 2提供了message命令，帮助你自动提取和管理翻译消息。
生成配置文件
首先，生成消息配置文件：
./yii message/config path/to/config.php
编辑配置文件
打开生成的配置文件，设置需要翻译的语言和消息路径：
return [
'languages' => ['zh-CN', 'ja-JP', 'en-GB'],
'messagePath' => '@app/messages',
'sourcePath' => '@app',
// 其他配置...
];
提取消息
运行以下命令提取消息并生成翻译文件：
./yii message path/to/config.php
该命令会扫描指定目录下的代码，提取所有Yii::t()调用的消息，并生成对应的翻译文件。
高级应用
翻译模块和小部件消息
对于模块和小部件，可以通过注册翻译组件来管理其专属消息。例如，模块的翻译注册：
namespace app\modules\users;
use Yii;
class Module extends \yii\base\Module
{
public function init()
{
parent::init();
$this->registerTranslations();
}
public function registerTranslations()
{
Yii::$app->i18n->translations['modules/users/*'] = [
'class' => 'yii\i18n\PhpMessageSource',
'sourceLanguage' => 'en-US',
'basePath' => '@app/modules/users/messages',
'fileMap' => [
'modules/users/validation' => 'validation.php',
],
];
}
public static function t($category, $message, $params = [], $language = null)
{
return Yii::t('modules/users/' . $category, $message, $params, $language);
}
}
翻译框架消息
Yii 2框架本身的消息（如验证错误消息）也可以翻译。配置如下：
'i18n' => [
'translations' => [
'yii' => [
'class' => 'yii\i18n\PhpMessageSource',
'sourceLanguage' => 'en-US',
'basePath' => '@app/messages'
],
],
],
然后，创建@app/messages/zh-CN/yii.php文件，添加框架消息的翻译。
处理缺失的翻译
当消息没有找到对应的翻译时，可以通过missingTranslation事件处理。例如，标记缺失的翻译：
'components' => [
'i18n' => [
'translations' => [
'app*' => [
'class' => 'yii\i18n\PhpMessageSource',
'on missingTranslation' => ['app\components\TranslationEventHandler', 'handleMissingTranslation']
],
],
],
],
事件处理类：
namespace app\components;
use yii\i18n\MissingTranslationEvent;
class TranslationEventHandler
{
public static function handleMissingTranslation(MissingTranslationEvent $event)
{
$event->translatedMessage = "@MISSING: {$event->category}.{$event->message} FOR LANGUAGE {$event->language} @";
}
}
视图翻译
除了消息翻译，Yii 2还支持视图文件的翻译。只需将翻译后的视图文件放在对应语言的子目录下即可。例如，原始视图views/site/index.php的中文翻译视图为views/site/zh-CN/index.php。
当目标语言为zh-CN时，Yii 2会自动加载views/site/zh-CN/index.php视图文件。
格式化日期和数字
Yii 2的Formatter类提供了丰富的日期、时间和数字格式化方法，支持根据当前语言环境自动调整格式：
// 格式化日期
echo Yii::$app->formatter->asDate('2025-10-12', 'long'); // 2025年10月12日
// 格式化数字
echo Yii::$app->formatter->asCurrency(1000, 'CNY'); // ¥1,000.00
设置PHP环境
Yii 2的国际化功能依赖于PHP intl扩展。确保你的PHP环境已安装并启用该扩展。可以通过以下脚本检查ICU版本：
<?php
echo "PHP: " . PHP_VERSION . "\n";
echo "ICU: " . INTL_ICU_VERSION . "\n";
echo "ICU Data: " . INTL_ICU_DATA_VERSION . "\n";
建议ICU版本不低于49，以确保所有功能正常工作。
总结
Yii 2提供了强大而灵活的多语言支持，从基础的消息翻译到复杂的复数规则和视图翻译，满足了全球化应用开发的各种需求。通过本文的介绍，你可以掌握Yii 2国际化开发的核心技巧，让你的应用轻松走向世界。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
