SuperAPI AI 工具集

typo3-project-upgrade

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:指导已部署的 TYPO3 项目/实例升级到新 LTS 版本,当前目标为 v14.3 LTS。流程分为清单、基础设施、Site Sets、视觉一致性、审查五个阶段,v14 目标另加第六阶段。

主要能力:阶段一查询 sys_template、tt_content 的 CType 分布与扩展列表,记录所有 root=1 模板及其 TypoScript 常量与配置。阶段二处理基础设施,要求安装 ImageMagick,否则所有图片以未处理原图输出(体积大 10-30 倍);需在 Docker 中安装、在 config/system/settings.php 配置 GFX 处理器,然后 TRUNCATE sys_file_processedfile、rm -rf public/fileadmin/processed/*、cache:flush。阶段三将 sys_template 迁移到 Site Sets(v13+),结构为 packages/my-site/Configuration/Sets/MySite/,含 config.yaml、settings.yaml、setup.typoscript;站点配置需添加 dependencies: [vendor/my-site];关键点是 DELETE FROM sys_template 删除全部记录,残留 root=1 模板会覆盖 site sets 并导致 “No page configured for type=0”。settings.yaml 直接映射旧常量。SCSS 变量注入优先于 CSS 覆盖,例如 plugin.bootstrap_package.settings.scss.primary 等。逐页行为用 TypoScript 条件替代逐页 sys_template。阶段四处理 BS Package v12-v16 / BS4-BS5 差异,如对比度、卡片文字颜色、导航拆分、滚动闪烁等。阶段五用 curl 对比新旧站点并分类差异。阶段六处理 v14 升级后事项,如升级向导、composer.json、HMAC 轮换等。

限制:资料未提供安装命令、价格、平台支持范围与效果保证;部分细节需参考其 references/v13-to-v14-project-upgrade.md。