0

0

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

看不見的法師

看不見的法師

发布时间:2025-09-29 09:20:02

|

463人浏览过

|

来源于php中文网

原创

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 中的键名,第二个是待翻译的原文。

支持动态语言切换

允许用户切换语言时,可以在控制器或行为中更改应用语言:

紫东太初
紫东太初

中科院和武汉AI研究院推出的新一代大模型

下载
if (isset($_GET['lang'])) {
    \Yii::$app->language = $_GET['lang']; // 如 'zh-CN' 或 'en-US'
}

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

日期、时间和数字本地化

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6500

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

368

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

446

2024.02.23

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

97

2025.08.19

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

334

2023.10.17

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

776

2023.10.18

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

97

2025.08.19

PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

88

2025.09.04

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.4万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

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