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' => 'yiii18nPhpMessageSource', '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.phpyii message /path/to/message-config.php
配置文件可指定扫描目录、输出路径、语言列表等,提升多语言维护效率。
基本上就这些。只要配置好路径、写好翻译文件,再用 Yii::t() 替换硬编码文本,就能实现完整的多语言支持。不复杂但容易忽略细节,比如文件路径大小写、分类匹配等。
以上就是Yii2国际化怎么实现_Yii2框架国际化与本地化支持的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1322870.html
微信扫一扫
支付宝扫一扫