ThinkPHP 6 中必须显式调用 Config::load(完整路径, '分组名') 才能加载自定义配置文件，否则 config('分组名.key') 始终为 null；文件须为 return 数组的 PHP 格式，路径推荐用 app_path() 拼接，加载时机应在应用初始化早期（如 Bootstrap::boot）。
Config::load 必须显式调用，否则 config() 读不到
ThinkPHP 6 不会自动加载 config/ 目录以外的 PHP 配置文件。哪怕你把 app/config/api.php 写得再规范，不调用 Config::load()，config('api.timeout') 就永远是 null 或报错。
常见错误现象：config('sms.gateway') 返回 null，但文件存在、语法正确、路径也没拼错 —— 根本原因就是漏了这一步加载。
-
Config::load()第一个参数必须是「完整绝对路径」，推荐用app_path() . 'config/api.php'拼接，别硬写字符串 - 第二个参数是「分组名」，比如
'api'，后续所有键都通过config('api.xxx')访问 - 不能传相对路径或 URL，
Config::load('./config/api.php', 'api')会失败 - 文件内容必须是
return [...];形式的 PHP 数组，YAML/JSON/INI 都不支持
加载时机错了，配置就白加了
在控制器构造函数、__construct() 或某个 action 里反复调用 Config::load()，不仅低效，还可能被框架缓存机制绕过 —— 因为 ThinkPHP 的配置合并发生在应用初始化早期，运行时加载只是“追加”，且只对后续调用生效。
- 最佳位置是
app/common/Bootstrap.php的boot()方法中 - 或者
app/event.php中监听AppInit事件时加载 - 千万别在中间件
handle()里加载，此时部分组件（如数据库连接）可能已初始化，依赖该配置的功能会出错 - 同一分组多次
load()会合并数组，键冲突时后加载的值覆盖前一个
config() 函数为什么有时读不到刚 load 的配置？
因为 config() 默认只查「框架启动时一次性合并的静态配置」，而 Config::load() 加载的是运行时动态配置。它只在你明确指定了分组名的前提下才生效 —— 这不是 bug，是设计。
-
config('api.timeout')能读到，前提是Config::load(..., 'api')已执行 -
config('timeout')读不到，即使文件里写了'timeout' => 30—— 没分组名，就不进配置池 -
config()->has('api.timeout')返回false，大概率是加载没成功，或分组名拼错了（比如写成'API'） - 调试时可用
dump(config('api'))看整个分组是否加载成功
加密配置文件不能靠 Config::load 自动解密
想把 config/api.php.enc 用密码保护？别往 config.php 里塞解密逻辑 —— 此时 Crypt 或自定义解密器根本没注册，类找不到，直接报 Class not found。
- 必须在
public/index.php最顶部手动接管：用file_get_contents()读取加密文件 → 解密 →eval()或include执行 →Config::set()注入 - 不要 patch
think\Loader::loadConfig()，它是静态方法，改了容易引发连锁崩溃 - 加密后的文件不能是纯数组 PHP，得先解密成合法 PHP 代码再执行，否则
return语句解析失败
实际项目中最容易被忽略的点：分组名大小写敏感，路径没用 app_path() 拼接导致部署环境路径错乱，以及在错误生命周期里调用 load() 导致部分模块压根看不到新配置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
