基于Composer的生产环境TYPO3部署缓存清理操作咨询

生产环境需执行缓存清理的场景与常规操作 #

生产环境触发缓存清理的核心场景包括：

• 修改全局站点配置、路由规则、后端权限规则、扩展基础配置后
• 更新 Fluid 模板、静态 TypoScript 配置、页面渲染缓存规则后
• 完成核心补丁、自定义扩展、第三方扩展的代码版本更新后
• 调整数据库表结构、新增字段、更新数据库索引后

常规清理直接执行命令即可：
vendor/bin/typo3 cache:flush
该命令会完成 TYPO3 内置的页面缓存、数据缓存、配置缓存全量清理，和后台界面手动触发的缓存清理效果完全一致。

扩展更新、版本部署环节的命令行等效操作 #

非Composer安装模式下，旧版Extension Manager的内置逻辑是：安装、更新扩展时自动完成扩展注册信息同步、静态配置导入，并触发对应范围的缓存清理。
Composer模式下的等效全流程操作为：

• 完成扩展的Composer版本更新后（即执行完composer require/remove/update 对应扩展包动作后），先执行 vendor/bin/typo3 extension:setup，完成所有已安装扩展的初始化配置、静态TypoScript导入、路由规则同步，完全替代Extension Manager的自动配置同步逻辑
• 紧跟执行常规缓存清理命令 vendor/bin/typo3 cache:flush，等效替代Extension Manager触发的自动缓存清理动作

硬缓存清理的适用场景与推荐策略 #

硬缓存清理指跳过TYPO3内置的缓存操作权限校验，强制清空所有缓存存储的操作，对应命令为加--force参数的版本：vendor/bin/typo3 cache:flush --force

• 不推荐在日常运维、常规部署流程中使用硬缓存清理：该操作绕过权限校验逻辑，在生产环境存在误操作导致非预期缓存清空的风险
• 仅在两类特定场景下推荐使用硬缓存清理：
  1. 出现后端权限锁死、无法通过常规命令行访问TYPO3控制台的故障场景
  2. 缓存存储文件损坏、常规缓存清理操作无法生效的异常场景

命令行等效实现Install Tool维护模式下的全量缓存清理（含OPcache） #

Install Tool维护模式中的缓存清理动作，本质是组合触发两类操作：TYPO3内置全量缓存清空、PHP OPcache重置。
命令行环境下实现完全等效效果的操作步骤：

1. 执行TYPO3内置全量缓存清理命令：vendor/bin/typo3 cache:flush
2. 完成OPcache清理：
   • PHP-FPM运行环境下，可执行 php -r 'opcache_reset();' 触发OPcache重置
   • 若CLI进程与FPM进程的OPcache存储相互独立，需要在流程中加入FPM进程的平滑重启动作，确保OPcache完成全量刷新

自动化部署流程的配套补全操作 #

Deployer等自动化工具的典型基础流程为拉取Git仓库代码、执行composer install --no-dev，在此基础上需要按顺序补充以下配套操作：

• 执行composer命令时追加参数 --optimize-autoloader，生成生产环境优化的类自动加载映射，避免运行时性能损耗
• 依赖安装完成后，执行 vendor/bin/typo3 extension:setup 同步所有扩展的配置、静态脚本、路由规则
• 执行 vendor/bin/typo3 database:updateschema 完成数据库结构的增量更新，包括新增字段、调整字段类型、添加索引等动作，等效替代后台安装工具中的数据库结构更新操作
• 执行 vendor/bin/typo3 cache:flush 完成TYPO3内置缓存的全量清理
• 平滑重启PHP-FPM进程，触发OPcache重置

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