Typo3 12站点public/typo3conf目录为空,需明确所需文件
TYPO3 12中public/typo3conf目录所需文件说明
在TYPO3 12里,public/typo3conf目录的内容和作用取决于你采用的安装模式(Composer模式/非Composer模式),以下是详细说明:
非Composer模式下的必需文件
如果你的站点是手动下载安装包搭建的非Composer模式,public/typo3conf必须包含以下内容:
LocalConfiguration.php:TYPO3核心配置文件,存储数据库连接信息、站点基础设置、系统核心参数等,是系统启动的必要条件。AdditionalConfiguration.php:可选但强烈推荐,用于覆盖LocalConfiguration.php中的配置(比如生产环境的敏感密钥、调试开关),通常不纳入版本控制,部署时单独添加到服务器。ext/目录:存放手动安装的第三方扩展或自定义扩展(未通过Composer安装的扩展)。
Composer模式下的特殊情况
TYPO3 12默认推荐使用Composer模式安装,此时public/typo3conf为空是正常现象:
- 核心配置文件迁移到了项目根目录的
config/system/下,对应settings.php(替代原LocalConfiguration.php)和additional.php(替代原AdditionalConfiguration.php)。 - 所有扩展都安装在项目根目录的
vendor/目录中,无需存放在public/typo3conf/ext下。
部署注意事项
- 若为Composer模式:部署时需同步项目根目录的
config/目录,并确保config/system/additional.php包含生产环境专属配置(如关闭$GLOBALS['TYPO3_CONF_VARS']['BE']['debug'])。 - 若为非Composer模式:
public/typo3conf为空说明安装过程中配置文件生成失败,需重新运行安装向导,或手动创建LocalConfiguration.php并填入正确的数据库等参数。 - 无论哪种模式,都要确保服务器上
public/typo3conf目录的权限正确(通常为运行Web服务的用户可读可写),避免后续扩展安装、配置修改时出现权限问题。
内容的提问来源于stack exchange,提问作者GameOverflow
相关产品推荐
相关产品推荐

