求助：适配TYPO3 8转12 LTS的自定义扩展安装后不显示

• 检查扩展目录结构与命名规范

  • 确认扩展目录放在typo3conf/ext/下，目录名必须是小写字母加下划线的格式，不能有特殊字符
  • 核心文件必须齐全：ext_emconf.php是必备项，ext_localconf.php/ext_tables.php按需存在，且ext_emconf.php里的extensionKey要和目录名完全一致

• 验证ext_emconf.php的兼容性配置

  • 重点看constraints里的depends字段，确保TYPO3版本范围包含当前用的12 LTS，示例配置：

    'constraints' => [
        'depends' => [
            'typo3' => '8.7.0-12.4.99',
            'php' => '7.2.0-8.2.99'
        ],
    ],
    

  • 把state字段设为stable或beta，experimental状态的扩展可能会被后台过滤掉

• 清除缓存并更新扩展信息

  • 命令行执行缓存清理：typo3cms cache:flush
  • 后台进入「系统」>「维护」>「清除缓存」，选「全部缓存」
  • 执行扩展信息更新：typo3cms extension:setup

• 检查PHP版本与依赖

  • 确认当前PHP版本符合ext_emconf.php中php的版本要求
  • 查看ext_emconf.php的depends字段，确保扩展依赖的其他TYPO3扩展已经安装并启用

• 查看错误日志

  • 后台「系统」>「日志」里筛选「扩展」相关的错误条目
  • 检查服务器的PHP错误日志，看扩展加载时有没有语法错误或致命错误

• 适配TYPO3 10+的注册规范

  • 如果用Composer安装，确保composer.json里的type设为typo3-cms-extension
  • 手动安装的话，ext_tables.php/ext_localconf.php里的代码要符合TYPO3 12的规范，别用已经废弃的API

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