如何将TYPO3 V8 Composer安装转为经典安装以添加扩展？

需删除的文件/文件夹 #

• 根目录下的 composer.json、composer.lock 文件
• 根目录的 vendor 文件夹（Composer依赖管理目录，经典安装无需保留）
• 根目录的 public 文件夹（Composer标准安装的web根目录，经典安装将核心文件放在服务器根目录）
• 根目录的 autoload.php 文件（Composer生成的自动加载入口）

需调整的目录与配置 #

1. 恢复经典安装目录结构 #

• 将 public 文件夹内的 typo3、typo3conf、fileadmin、typo3temp、uploads、index.php 全部移动到服务器根目录
• 如果原Composer安装没有 typo3_src 文件夹，下载对应版本的TYPO3 V8经典安装包，将包内的 typo3_src 文件夹放到根目录，然后创建软链接 typo3 指向 typo3_src/typo3（也可直接复制 typo3_src/typo3 目录到根目录）

2. 修改核心配置文件 #

编辑 typo3conf/LocalConfiguration.php：

• 找到 $GLOBALS['TYPO3_CONF_VARS']['SYS']['composerMode']，将值改为 false，彻底关闭Composer模式
• 检查 $GLOBALS['TYPO3_CONF_VARS']['SYS']['sitePath']，调整为服务器根目录的相对路径（通常设置为 '' 或 '/' 即可）
• 确认 $GLOBALS['TYPO3_CONF_VARS']['SYS']['trustedHostsPattern'] 配置符合当前域名需求，避免访问报错

3. 清理Composer相关自动加载配置 #

• 打开 typo3conf/AdditionalConfiguration.php，删除所有引用 vendor/autoload.php 的代码段
• 确保 typo3conf/ext/ 目录权限正确（推荐设置为 755，web服务器用户需拥有读写权限），之后即可直接将扩展复制到该目录，在后台激活

4. 清理缓存生效 #

• 删除 typo3temp 文件夹下的所有缓存文件
• 登录TYPO3后台，进入「系统」>「清除缓存」，执行全量缓存清理

验证转换结果 #

• 访问网站前台，确认页面正常加载
• 进入后台扩展管理，尝试手动添加扩展到 typo3conf/ext/，确认可正常激活使用

内容的提问来源于stack exchange，提问作者Bernd Wilke πφ