Yii2通过i18n模块实现多语言支持,需配置language和sourceLanguage,使用PhpMessageSource管理翻译文件,将不同语言文本存于@app/messages对应目录,并通过Yii::t()调用;结合formatter可本地化日期、数字格式,支持动态切换语言并建议存储于session或cookie,还可利用message命令自动提取翻译文本,完成国际化适配。

Yii2 的国际化(Internationalization)和本地化(Localization)功能非常强大,能帮助开发者轻松实现多语言支持。核心是通过 Yii2 内置的 i18n 模块,结合消息翻译、日期时间格式、数字格式等机制,让应用适配不同语言和地区。
在应用配置中设置 language(当前显示语言)和 sourceLanguage(原始语言,通常是英文或中文):
return [
'components' => [
'i18n' => [
'translations' => [
'*' => [
'class' => 'yii\i18n\PhpMessageSource',
'basePath' => '@app/messages',
'fileMap' => [
'app' => 'app.php',
'common' => 'common.php',
],
],
],
],
],
'language' => 'zh-CN', // 当前语言
'sourceLanguage' => 'en-US', // 原始语言
];
这里将所有消息映射到 @app/messages 目录下的对应 PHP 文件,比如英文原文放在 @app/messages/en-US/app.php,中文翻译放在 @app/messages/zh-CN/app.php。
在 @app/messages/zh-CN/app.php 中定义翻译内容:
return [
'Hello world!' => '你好世界!',
'Welcome to our website' => '欢迎访问我们的网站',
];
使用 Yii::t() 方法调用翻译:
echo \Yii::t('app', 'Hello world!');
echo \Yii::t('common', 'Welcome to our website');
第一个参数是分类(category),对应 fileMap 中的键名,第二个是待翻译的原文。
允许用户切换语言时,可以在控制器或行为中更改应用语言:
if (isset($_GET['lang'])) {
\Yii::$app->language = $_GET['lang']; // 如 'zh-CN' 或 'en-US'
}
建议将语言保存在 session 或 cookie 中,避免每次请求都传参。
Yii2 使用 ICU 格式支持本地化的格式输出。确保系统安装了 intl 扩展。
示例:
echo Yii::$app->formatter->asDate('2025-04-05'); // 根据 language 自动格式化
echo Yii::$app->formatter->asDecimal(1234.56);
例如,在 zh-CN 下,数字可能显示为“1,234.56”,日期为“2025年4月5日”。
可以使用 message command 自动提取代码中的 Yii::t() 文本:
yii message/config /path/to/message-config.php yii message /path/to/message-config.php
配置文件可指定扫描目录、输出路径、语言列表等,提升多语言维护效率。
基本上就这些。只要配置好路径、写好翻译文件,再用 Yii::t() 替换硬编码文本,就能实现完整的多语言支持。不复杂但容易忽略细节,比如文件路径大小写、分类匹配等。
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号