
环境准备与配置
在Yii2项目中启用国际化支持,首先需确认yii2-i18n组件已集成。打开config/web.php,在components配置项中添加i18n组件配置:
'i18n' => [
'translations' => [
'app*' => [
'class' => 'yii\i18n\PhpMessageSource',
'basePath' => '@app/messages',
'sourceLanguage' => 'en-US',
'fileMap' => [
'app' => 'app.php',
'app/error' => 'error.php',
],
],
],
],
sourceLanguage定义源语言(通常为开发时使用的语言),basePath指定翻译文件存储目录,fileMap用于映射不同分类的翻译文件。
翻译文件管理
在app/messages目录下按语言代码创建子目录,例如zh-CN(简体中文)、ja-JP(日语)。每个目录中存放对应语言的翻译文件,如app.php:
// messages/zh-CN/app.php
return [
'Home' => '首页',
'About' => '关于',
'Contact' => '联系',
'Login' => '登录',
'Logout' => '退出',
];
翻译文件采用键值对格式,键为源语言文本,值为目标语言翻译。对于包含变量的文本,可使用占位符:
// 源语言
'Welcome, {username}!' => '欢迎,{username}!',
视图中的国际化调用
在视图文件中,通过Yii::t()方法实现文本翻译:
// 基础用法
echo Yii::t('app', 'Home');
// 带占位符
echo Yii::t('app', 'Welcome, {username}!', ['username' => $username]);
// 分类调用(对应fileMap配置)
echo Yii::t('app/error', 'Page not found');
语言切换实现
通过URL参数或会话存储用户语言偏好。在SiteController中添加语言切换动作:
public function actionLanguage($lang)
{
Yii::$app->language = $lang;
$cookie = new yii\web\Cookie([
'name' => 'lang',
'value' => $lang,
'expire' => time() + 60 * 60 * 24 * 30, // 30天有效期
]);
Yii::$app->response->cookies->add($cookie);
return $this->redirect(Yii::$app->request->referrer);
}
在布局文件中添加语言切换链接:
<?= Html::a('中文', ['site/language', 'lang' => 'zh-CN']) ?>
<?= Html::a('English', ['site/language', 'lang' => 'en-US']) ?>
URL路由优化
为支持多语言URL,可配置URL管理器:
'urlManager' => [
'enablePrettyUrl' => true,
'showScriptName' => false,
'rules' => [
'<lang:[a-z-]{2,5}>/<controller>/<action>' => '<controller>/<action>',
'<lang:[a-z-]{2,5}>' => 'site/index',
],
],
在控制器基类中重写init()方法,自动解析URL中的语言参数:
public function init()
{
parent::init();
$lang = Yii::$app->request->get('lang', Yii::$app->request->cookies->getValue('lang', 'en-US'));
Yii::$app->language = $lang;
}
数据库内容国际化
对于动态内容,可采用分表或字段扩展方案。例如,创建post表存储公共字段,post_lang表存储多语言内容:
CREATE TABLE post (
id INT PRIMARY KEY AUTO_INCREMENT,
created_at INT
);
CREATE TABLE post_lang (
post_id INT,
language VARCHAR(5),
title VARCHAR(255),
content TEXT,
PRIMARY KEY (post_id, language)
);
通过关联查询获取对应语言的内容:
$post = Post::find()
->with(['lang' => function($query) {
$query->where(['language' => Yii::$app->language]);
}])
->one();
日期与数字格式化
Yii2内置国际化格式化组件,可自动适配目标语言格式:
// 日期格式化
echo Yii::$app->formatter->asDate(time(), 'long');
// 数字格式化
echo Yii::$app->formatter->asDecimal(1234.56);
// 货币格式化
echo Yii::$app->formatter->asCurrency(1000, 'CNY');
缓存优化
为提高多语言站点性能,可启用翻译缓存:
'i18n' => [
'translations' => [
'app*' => [
'class' => 'yii\i18n\PhpMessageSource',
'basePath' => '@app/messages',
'sourceLanguage' => 'en-US',
'cachingDuration' => 3600, // 缓存1小时
'cache' => 'cache', // 使用默认缓存组件
],
],
],
注意事项
-
语言代码遵循ISO 639-1(语言)和ISO 3166-1(地区)标准,如
zh-CN、en-US -
翻译文件编码统一使用UTF-8无BOM格式
-
避免在翻译文本中硬编码HTML标签,保持文本纯净
-
定期使用
yii message/extract命令提取待翻译文本 -
测试时覆盖所有支持的语言,确保布局适配不同长度文本
通过以上步骤,可构建完整的Yii2多语言站点。实际部署中,建议结合翻译管理平台(如Crowdin、POEditor)实现翻译流程自动化,提升多语言内容维护效率。






