Yii2国际化怎么实现_Yii2框架国际化与本地化支持

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

yii2国际化怎么实现_yii2框架国际化与本地化支持

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'
}
登录后复制

建议将语言保存在 sessioncookie 中,避免每次请求都传参。

Trae国内版
Trae国内版

国内首款AI原生IDE,专为中国开发者打造

Trae国内版 815
查看详情 Trae国内版

日期、时间和数字本地化

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() 替换硬编码文本,就能实现完整的多语言支持。不复杂但容易忽略细节,比如文件路径大小写、分类匹配等。

以上就是Yii2国际化怎么实现_Yii2框架国际化与本地化支持的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号