如何应对ThinkPHP不同版本配置文件加载逻辑的变更？

本文共计1185个文字，预计阅读时间需要5分钟。

TP5.1 在应用初始化阶段（App::init()）一次性合并所有 +config/ 下的 PHP 文件，而 TP6.x 改为按需加载+延迟解析：

这意味着在 TP6.x 中，如果你在 common.php 或服务提供者里提前写 config('database')，很可能拿到空值——因为此时配置还没加载。TP5.1 不会这样。

• TP5.1：配置加载是“启动即完成”，适合早期依赖配置做判断的逻辑
• TP6.x：配置加载是“首次访问触发”，更轻量但要求你避开类构造、静态属性初始化等早于请求生命周期的场景
• TP6.x 默认关闭了 APP_DEBUG 下的配置缓存自动刷新，改配置后要手动删 runtime/config/ 目录才能生效

自定义配置文件不被加载？检查 config/autoload.php 是否注册

TP6.x 移除了全局自动扫描机制，新增的配置文件（比如 config/alipay.php）不会自动合并进配置池，必须显式告诉框架它该被加载。

做法是在 config/autoload.php 中返回一个数组，列出你要加载的文件名（不含 .php 后缀）：

立即学习“PHP免费学习笔记（深入）”；

return [ 'alipay', 'oss', 'wechat', ];

注意不是路径，也不是完整文件名；写成 'alipay.php' 或 'config/alipay' 都无效。