讲师中心 微信公众号
AI工具推荐 视频效率加速

Yii2的国际化怎么实现动态翻译_从数据库读取翻译【避坑】

云浩吖_8616

云浩吖_8616

发布时间:2026-03-29 12:51:12

|

350人浏览过

|

来源于php中文网

原创

需自定义继承 yii\i18n\MessageSource 的类并重写 loadMessages(),配置 i18n 组件指向该类,建联合索引 (language, category, message),手动缓存结果,确保语言码格式统一(如 zh-CN),trim 原文避免匹配失败。

yii2的国际化怎么实现动态翻译_从数据库读取翻译【避坑】

怎么让 Yii2 的 I18N 从数据库加载翻译?

Yii2 默认只支持 PHP 文件或 MO/PO 文件的静态翻译,要动态读取数据库,必须自定义 MessageSource 类,不能只改配置就生效。

  • 必须继承 yii\i18n\MessageSource,重写 loadMessages() 方法
  • 数据库表结构至少包含 language、category、message(原文)、translation(译文)字段
  • 别直接在 messages 表里加索引却不加 (language, category, message) 联合索引——查得慢还容易漏匹配
  • 缓存必须手动处理:loadMessages() 返回前建议用 Yii::$app->cache->set() 存,否则每次 Yii::t() 都查库

Yii::t() 不触发数据库查询?检查这三处

常见现象是改了数据库里的翻译,页面没变,不是缓存没清,而是根本没走到你的自定义 MessageSource。

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
  • config/web.php 中 i18n 组件的 class 没指向你写的类,还是默认的 yii\i18n\PhpMessageSource
  • components['i18n']['translations'] 配置里用了 * 通配但漏写了 class,导致 fallback 到默认行为
  • 调用 Yii::t('app', 'Hello') 时,'app' 这个 category 没在 translations 配置里显式声明,Yii 直接跳过你的源

数据库翻译和文件翻译混用时,优先级怎么定?

Yii2 不会自动合并数据库和 PHP 文件的翻译结果,它按 translations 配置顺序逐个尝试,第一个返回非 null 的就用那个。

  • 想优先数据库:把数据库 MessageSource 的配置放在 translations 数组前面,例如 'app*' => ['class' => 'common\components\DbMessageSource']
  • 想 fallback 到文件:确保数据库源的 loadMessages() 在查不到时 明确 return [](空数组),而不是 null 或抛异常,否则 Yii 会中断查找链
  • 注意 sourceLanguage 和 language 必须一致,否则即使数据库有记录,loadMessages() 也可能被跳过

为什么中文翻译显示成英文?字符集或语言码不匹配

最常踩的坑不是逻辑错,是语言码写成了 zh-CN,但数据库里存的是 zh 或 zh_CN —— Yii2 对语言码大小写和分隔符敏感。

  • 查 Yii::$app->language 实际值,用 var_dump() 确认,别只看配置
  • 数据库字段存语言码时统一用小写 + 短横(zh-CN),避免 zh_cn 或 ZH-CN
  • 如果用 gettext 工具导出 PO 文件再入库,注意有些工具会把 Language: 字段写成 zh_CN,入库前得转换
  • MySQL 表字符集要是 utf8mb4,字段排序规则用 utf8mb4_unicode_ci,否则带 emoji 或生僻字的翻译可能乱码或查不到
实际跑起来后,最容易被忽略的是:数据库源的 loadMessages() 方法里没做 trim() 处理——前后空格会让 message 匹配失败,而这个错误既不报错也不提示。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2293

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

1399

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

815

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3172

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

5388

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

1199

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

5651

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

4942

2023.08.14

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

0

2026.10.21

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn