理解 Polylang 在数据库层面如何管理多语言内容,对于正在构建高级翻译工具或排查翻译问题的开发者而言至关重要。在对 Polylang 的架构进行了大量研究之后,我们梳理出了这款流行的 WordPress 多语言插件究竟是如何组织语言数据以及翻译关联关系的。
基础:WordPress 分类法(Taxonomy)数据表
Polylang 以一种巧妙的方式利用了 WordPress 原生的 taxonomy 系统。它不创建自定义表,而是使用现有的 wp_term_relationships 和 wp_term_taxonomy 表来存储语言归属以及翻译关联关系。该方法在保持数据库结构精简的同时,仍能提供强大的功能。
文章如何与语言关联
当为一篇文章指定语言时,Polylang 会在 wp_term_relationships 表中创建记录。流程如下:

步骤 1:语言分配
一篇文章(例如 ID 为 7834)在 wp_term_relationships 中会有对应的 object_id,并且可能存在多行记录,每一行都有不同的 term_taxonomy_id。要识别其语言,你需要:
- 在
wp_term_taxonomy中找到 taxonomy 等于'language'的匹配行 - 提取
description列,其中包含序列化的语言数据
description 字段包含的数据类似于:
a:4:{s:9:"fallbacks";a:0:{}s:6:"locale";s:5:"en_US";s:3:"rtl";i:0;s:9:"flag_code";s:2:"us";}
要按语言筛选文章,只需检查 term_taxonomy_id 是否与特定语言的 term(例如英语为 140)匹配即可。
步骤 2:翻译关联关系
文章之间的翻译链接使用相同的表结构,但采用不同的 taxonomy:
- 查询
wp_term_taxonomy,其中 taxonomy 等于'post_translations' -
description列包含所有翻译文章的 ID
一个典型的结果如下所示:
a:3:{s:2:"en";i:7834;s:2:"de";i:7859;s:2:"nl";i:7860;}
这个序列化数组将语言代码映射到文章 ID,从而创建翻译分组。
分类项(分类/标签)如何处理语言
分类项(term)遵循类似但略有不同的模式:

为分类项分配语言
对于一个 ID 为 14850 的分类项:
- 在
wp_term_relationships中会存在多行记录,对应不同的term_taxonomy_id值 - 在
wp_term_taxonomy中,与之匹配的条目的 taxonomy 为'term_language'(注意:并非只是'language') - 用于分类项语言的
term_taxonomy_id通常是文章语言 ID + 1(例如,文章使用 140,则分类项使用 141)
分类项翻译关联关系
分类项的翻译关联关系使用:
-
wp_term_taxonomy中的分类法值'term_translations' -
description列中相同的序列化数组格式:
a:3:{s:2:"en";i:14850;s:2:"nl";i:15004;s:2:"de";i:15012;}
为什么这对高级翻译工具很重要
理解这种数据库结构对于构建复杂的翻译功能至关重要。当我们为 Polylang AI Automatic Translation 插件开发 polylang ai bulk translator 时,这些深入的知识使我们能够:
- 高效查询并处理大量尚未翻译的内容
- 在文章、页面和分类法之间维护正确的翻译关联关系
- 在保留 Polylang 数据完整性的同时,处理复杂的页面构建器结构
- 创建可与 Polylang 架构无缝协作的翻译任务
要点总结
- Polylang 使用 WordPress 原生的分类法系统来存储多语言数据
- 文章使用
'language'和'post_translations'分类法 - 分类项使用
'term_language'和'term_translations'分类法 - 所有语言与翻译数据都以序列化形式存储在
wp_term_taxonomy的description列中 -
term_taxonomy_id作为内容与其语言/翻译数据之间的关联链接
这种架构简洁而优雅,但要完全理解它,需要深入研究数据库结构。对于与 Polylang 一起开发插件的开发者而言,这些知识对于创建能够正确融入多语言生态的工具极为宝贵。