用途:将已部署的 TYPO3 项目/实例升级到新 LTS 版本,当前目标为 v14.3 LTS(2026-04-21 发布)。流程分为阶段:清单 → 基础设施 → Site Sets → 视觉一致性 → 审查,v14 目标另有第 6 阶段。
主要能力与用法: 阶段 1 清单:查询 sys_template(uid、pid、root、include_static_file)、tt_content 的 CType 分布与扩展列表,记录所有 root=1 模板及其 TypoScript 常量/配置。 阶段 2 基础设施:需 ImageMagick,否则所有图片以未处理原图提供(体积 10-30 倍)。在 Docker 中安装,在 config/system/settings.php 配置 GFX 处理器,然后 TRUNCATE sys_file_processedfile、rm -rf public/fileadmin/processed/、cache:flush。 阶段 3 sys_template 转 Site Sets(v13+):结构为 packages/my-site/Configuration/Sets/MySite/,含 config.yaml、settings.yaml、setup.typoscript。config.yaml 写 name、label、dependencies;站点配置 config/sites/default/config.yaml 添加 dependencies: [vendor/my-site]。关键:DELETE FROM sys_template 删除全部记录,残留 root=1 且含 include_static_file 的模板会覆盖 site sets,导致 “No page configured for type=0”。settings.yaml 直接映射旧常量。SCSS 变量注入:BS Package 会注入所有 plugin.bootstrap_package.settings.scss.,优先于 CSS 覆盖。逐页行为用 TypoScript 条件 [traverse(page, "uid") == 99] 替代逐页 sys_template。 阶段 4 BS Package v12-v16 / BS4-BS5:颜色对比 min-contrast-ratio 默认 4.5 会改变文字颜色,设为 3 可恢复 v11 行为;彩色框架内卡片继承白字,用 CSS 自定义属性修复;导航拆分为 a.nav-link-main 与 button.nav-link-toggle;悬停下拉被移除,可用 :hover > .dropdown-menu { display: block } 恢复;滚动闪烁用 margin-bottom 补偿。 阶段 5 审查:用 curl 对比新旧站点,将差异归类为 MIGRATION GAP、BS5 CHANGE 或 CSS OVERRIDE;数据库修复如轮播自动播放。 阶段 6 v14 升级后:#109585 向导、classic 模式需 composer.json(#108310)、HMAC 由 SHA1 转 SHA256(#106307)、Camino 主题可选(v14.1+,#108539)。
限制:资料未提供安装命令、收费与平台信息;具体命令与代码需按项目实际执行。