### [Yii2国际化(i18n)多语言站点搭建指南](https://www.huociguo.com/article/789) **Published:** 2026-08-19T06:37:21 **Author:** 米了 **Excerpt:** 环境准备与配置在Yii2项目中启用国际化支持,首先需确认 组件已集成。打开 ,在 配置项中添加 组件配置: 定… ![](https://api.huociguo.com/wp-content/uploads/2026/08/20260819143635363-190680ceea-1.png "20260819143635363-190680ceea-1") ## 环境准备与配置 在Yii2项目中启用国际化支持,首先需确认`yii2-i18n`组件已集成。打开`config/web.php`,在`components`配置项中添加`i18n`组件配置: ```php '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`: ```php // messages/zh-CN/app.php return [ 'Home' => '首页', 'About' => '关于', 'Contact' => '联系', 'Login' => '登录', 'Logout' => '退出', ]; ``` 翻译文件采用键值对格式,键为源语言文本,值为目标语言翻译。对于包含变量的文本,可使用占位符: ```php // 源语言 'Welcome, {username}!' => '欢迎,{username}!', ``` ## 视图中的国际化调用 在视图文件中,通过`Yii::t()`方法实现文本翻译: ```php // 基础用法 echo Yii::t('app', 'Home'); // 带占位符 echo Yii::t('app', 'Welcome, {username}!', ['username' => $username]); // 分类调用(对应fileMap配置) echo Yii::t('app/error', 'Page not found'); ``` ## 语言切换实现 通过URL参数或会话存储用户语言偏好。在`SiteController`中添加语言切换动作: ```php 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); } ``` 在布局文件中添加语言切换链接: ```php 'zh-CN']) ?> 'en-US']) ?> ``` ## URL路由优化 为支持多语言URL,可配置URL管理器: ```php 'urlManager' => [ 'enablePrettyUrl' => true, 'showScriptName' => false, 'rules' => [ '//' => '/', '' => 'site/index', ], ], ``` 在控制器基类中重写`init()`方法,自动解析URL中的语言参数: ```php 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`表存储多语言内容: ```sql 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) ); ``` 通过关联查询获取对应语言的内容: ```php $post = Post::find() ->with(['lang' => function($query) { $query->where(['language' => Yii::$app->language]); }]) ->one(); ``` ## 日期与数字格式化 Yii2内置国际化格式化组件,可自动适配目标语言格式: ```php // 日期格式化 echo Yii::$app->formatter->asDate(time(), 'long'); // 数字格式化 echo Yii::$app->formatter->asDecimal(1234.56); // 货币格式化 echo Yii::$app->formatter->asCurrency(1000, 'CNY'); ``` ## 缓存优化 为提高多语言站点性能,可启用翻译缓存: ```php '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)实现翻译流程自动化,提升多语言内容维护效率。 **Categories:** PHP框架 ---