TYPO3 7.x升级8.x：EXT:form的.layout弃用问题咨询

1. EXT:form 是什么？ #

EXT:form 是 TYPO3 核心自带的官方表单扩展，并非第三方自定义扩展，所以你不会在 typo3conf/ext/ 目录下找到它。从 TYPO3 7.x 版本开始，它就被整合进了系统核心，负责提供表单的创建、渲染、数据处理等全套功能——包括后台的表单编辑器、前端的表单渲染逻辑，以及表单提交后的验证和数据存储机制。

2. "layout." 具体指什么？ #

这里的 layout. 是 EXT:form 在 TYPO3 7.x 及更早版本中使用的旧布局引用前缀，主要出现在两个场景：

• TypoScript 配置：比如旧的配置中会用 plugin.tx_form.settings.layout.xxx 来定义表单的全局布局、元素样式等相关参数；
• Fluid 模板/视图助手调用：在自定义的表单模板里，可能会通过带 layout. 前缀的变量或视图助手参数来引用布局相关的设置。

TYPO3 官方在 7.x 版本标记这个前缀为弃用，8.x 版本彻底移除，目的是替换成更结构化的布局管理机制。

3. 重构该场景的具体指导 #

我整理了升级时重构这个问题的核心实战步骤：

• 第一步：定位所有使用 layout. 的位置
  全局搜索项目代码（包括 TypoScript 文件、Fluid 模板、表单配置 XML 文件），找出所有包含 layout. 的代码片段。
• 第二步：替换 TypoScript 中的旧配置
  把旧的 plugin.tx_form.settings.layout. 开头的配置，迁移到新的 plugin.tx_form.settings.layouts 结构下。比如原来的 layout.templateRootPath 要换成 layouts.default.templateRootPath（具体对应关系可参考 TYPO3 8.x 核心 EXT:form 的官方配置文档）。
• 第三步：更新 Fluid 模板中的引用
  如果你的项目有自定义的 EXT:form 模板，要把模板中带 layout. 的变量调用，替换成新的布局变量或视图助手。比如旧的 {layout.settings} 要调整为符合新布局结构的变量，或者直接使用新的表单布局渲染逻辑。
• 第四步：适配新的表单布局结构
  TYPO3 8.x 的 EXT:form 采用了更灵活的布局定义方式，你可以在表单的 XML 配置中直接指定布局，或者通过 TypoScript 为不同表单分配不同布局，替代原来单一的 layout. 全局配置。
• 第五步：测试验证
  重构完成后，逐个测试项目中的所有表单，确保渲染正常、样式正确、提交功能不受影响。

内容的提问来源于stack exchange，提问作者netzding