TYPO3 v11.0移除的XML-based标签解析功能含义与用法咨询
TYPO3 v11 移除的自定义XML格式标签解析功能说明
功能具体定义
这是TYPO3早期版本内置的一套非通用多语言标签解析能力,只识别TYPO3自己私定规则的XML格式语言包文件,和后来跟进国际通用标准的XLIFF多语言格式完全不兼容。从v11版本开始,核心代码直接把这套老解析逻辑整个删除,系统再也不认、不读取符合这套老规则的XML语言文件。
原有设计目的
- 这套逻辑最早是TYPO3 4.x甚至更早版本推出的,那时候PHP生态里根本没什么统一、好用的多语言文件标准,团队自己定XML规则主要是为了快速落地多语言能力,不用被第三方规范卡限制
- 专门适配TYPO3自身的语言回退机制,当用户选择的语言缺少对应文案时,可以自动匹配默认语言的内容,当时现成的通用解析器很难直接适配这套定制化逻辑
- 这套自定义XML格式结构非常简单,早期扩展开发者不需要学习复杂的多语言规范,照着示例写就能给自己开发的插件、模板做多语言适配,拉低了扩展开发的入门门槛
原有具体使用方式
- 开发者需要按TYPO3定死的固定结构编写XML语言文件,通常命名为
locallang.xml,存放在扩展的语言资源目录下。文件根节点必须是<T3locallang>,内部靠带languageKey属性的节点区分不同语言版本,每条多语言文案用自定义字符串做索引名,节点内容就是对应语言显示的文案 - 代码或者模板里调用文案时,统一用
LLL:前缀加文件路径加标签索引的格式引用,比如LLL:EXT:my_demo_ext/Resources/Private/Language/locallang.xml:login_button_text,老版本核心解析器识别到这个格式的引用,就会自动加载对应的XML文件,匹配当前站点/后台的语言设置输出对应文案 - 支持在XML的文案内容里写简单占位符,解析时会自动替换成传入的动态参数,除了前端展示文案,后端表单的字段名、字段说明、操作提示这类内容也都是用这套方式加载的
升级提示:升级到v11及以上版本前,必须把所有老的自定义XML格式语言文件转换成TYPO3现在默认支持的XLIFF格式(后缀为
.xlf),否则对应位置的文案会直接显示成原始的LLL:引用字符串,无法正常渲染。
内容的提问来源于stack exchange,提问作者Ens
相关产品推荐
相关产品推荐

