暂无菜单项

Yii2国际化(i18n)多语言站点搭建指南

发布于
11

环境准备与配置

在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', // 使用默认缓存组件
        ],
    ],
],

注意事项

  1. 语言代码遵循ISO 639-1(语言)和ISO 3166-1(地区)标准,如zh-CN、en-US

  2. 翻译文件编码统一使用UTF-8无BOM格式

  3. 避免在翻译文本中硬编码HTML标签,保持文本纯净

  4. 定期使用yii message/extract命令提取待翻译文本

  5. 测试时覆盖所有支持的语言,确保布局适配不同长度文本

通过以上步骤,可构建完整的Yii2多语言站点。实际部署中,建议结合翻译管理平台(如Crowdin、POEditor)实现翻译流程自动化,提升多语言内容维护效率。

0 点赞
0 收藏
分享
0 讨论
反馈

FAQ

如何在Yii2中启用国际化组件?
在config/web.php文件中,在components数组中添加'i18n'配置,例如:'i18n' => [ 'translations' => [ 'app*' => [ 'class' => 'yiii18nPhpMessageSource', 'basePath' => '@app/messages', 'sourceLanguage' => 'en-US', ], ], ]。
翻译文件应该存储在哪里?
在app/messages目录下,按语言代码创建子目录,如zh-CN、ja-JP。每个目录中存放对应语言的翻译文件,如app.php,使用键值对格式。
如何在视图中调用翻译函数?
使用Yii::t()方法,例如:echo Yii::t('app', 'Home'); 对于带占位符的文本,使用数组传递参数,如echo Yii::t('app', 'Welcome, {username}!', ['username' => $username])。
语言切换是如何实现的?
通过URL参数或会话存储偏好。在SiteController中添加actionLanguage方法处理语言设置,并在布局中添加切换链接,如Html::a('中文', ['site/language', 'lang' => 'zh-CN'])。
数据库内容如何支持多语言?
采用分表方案,创建post表存储基础数据,post_lang表存储多语言内容,通过关联查询获取对应语言的记录,例如:$post = Post::find()->with(['lang' => function($query) { $query->where(['language' => Yii::$app->language]); }])->one();
0 / 600
0 讨论
热门最新
总结
暂无总结