用途:在整站 TYPO3 v12/v13 升级到 14.3 的过程中,执行图中授权的单个迁移节点,每次只改变一个已授权的原因,并向升级图返回可检查的证据。
主要能力:覆盖依赖规划与解析、13.4 兼容阶梯、机械迁移(Rector、Fractor、scanner)、手工迁移(移除的 API 与已存数据)、14.3 阶梯,以及各类恢复节点(rung13/mechanical/manual/rung14/content-recovery)。每个节点从 t3u node-brief --node <id> 开始,携带契约、路由与预算。有状态节点先执行 t3u snapshot-create --node <id>;代码节点以 --rollback-ref git:<sha> 开始。
使用方式:应用 PHP/Composer/TYPO3 命令通过 DDEV 运行。目标为 typo3/cms-core ^14.3、PHP 8.4 标准。优先使用原生工具与受支持 API,再考虑广泛使用的兼容工具。每次只处理一个原因,通常不超过 10 个文件或 400 行改动。Rector/Fractor/scanner 在注册表与缓存重建后需二次运行并保留原始输出。Schema 分析器输出视为隔离区,删除表/字段/索引需单独精确批准。
适用场景:TYPO3 整站升级中的依赖、代码、Schema、数据迁移与恢复节点;内容建模、PHP API、TypoScript/Fluid/YAML/XLIFF、资源构建、Solr、CKEditor、可视化编辑、Playwright 旅程等有专门路由。
限制:节点就绪、Baseline A 已封存验证、图定义/身份/指纹匹配是前置条件;破坏性范围需已获批准。证据保持精简(约 120 行),在简报预测时间或两倍时停止并返回已证明内容与未决问题。出现漂移、振荡、两次无进展、范围/目标变更或超预算时回滚,绝不重新基线化,绝不部署。完整源到目标证明需使用 typo3-upgrade-closure;Composer 更新成功不等于升级结论。