ThinkPHP 6 加载自定义配置需调用 Config::load(完整路径, '分组名') 显式载入，否则 config('分组名.key') 无法读取；文件须为返回数组的 PHP 格式，加载时机应早于依赖组件初始化。
ThinkPHP 6 如何加载自定义配置文件（非 config/ 目录下）
不能直接靠 config() 函数读取任意路径的 PHP 配置文件，必须先用 think\facade\Config::load() 显式载入，否则返回空或报错。
常见错误现象：config('myapp.api_timeout') 始终为 null，但文件明明存在、格式也对；根本原因是没触发加载逻辑。
- 自定义配置文件必须是返回数组的 PHP 文件（如
app/config/api.php），不能是 YAML/JSON - 调用
Config::load()时，第一个参数是完整路径（推荐用app_path()拼接），第二个参数是「配置分组名」，后续通过config('group.key')访问 - 同一分组多次调用
load()会合并而非覆盖，但键冲突时后加载的值生效 - 不建议在控制器构造函数里反复调用 —— 配置应尽早加载（如事件监听器、中间件或
boot()方法中）
示例：
// 在 app/common/Bootstrap.php 的 boot() 中 use think\facade\Config; Config::load(app_path() . 'config/api.php', 'api');
之后即可用 config('api.timeout') 或 config('api.base_url')。
立即学习“PHP免费学习笔记（深入）”；
Config 类 get() / set() / has() 方法的实际行为差异
get() 是安全读取，set() 是运行时写入内存（重启即丢），has() 判断的是当前已加载配置中是否存在该 key，不是检查文件是否存在。
使用场景：调试时临时改某个配置值做测试，或根据环境动态补全配置项（比如从数据库读取开关状态后塞进配置）。
-
config('database.hostname')和config()->get('database.hostname')效果一样，但前者更常用 -
config(['cache.default' => 'redis'])是批量写入，等价于多次set() -
config()->set('log.level', 'debug')不会影响config/log.php文件内容，只影响本次请求生命周期 -
config()->has('mail.host')返回false可能是因为没加载 mail 分组，不一定是配置缺失
为什么 config() 辅助函数有时读不到刚 load 的配置？
因为 ThinkPHP 的配置系统有两级缓存：一是框架启动时一次性合并的静态配置，二是运行时通过 Config::load() 动态追加的。但 config() 函数默认只查第一级，除非你明确指定了分组名。
典型错误：调用了 Config::load(..., 'sms')，却写 config('sms.gateway') —— 这样是读不到的，必须写成 config('sms.gateway')（注意这里没问题），但如果没指定分组名，就真读不到。
- 确认是否漏传了分组名：
Config::load($file, 'sms')→ 必须用config('sms.xxx') - 检查加载时机：如果在路由解析后才 load，部分早期初始化的组件（如数据库连接）已经读过配置，不会重新拉取
- 避免在模型的
initialize()中 load 配置 —— 此时 Config 单例可能还未完全就绪，易出Call to a member function load() on null
自定义配置文件被修改后不生效？热更新限制在哪
ThinkPHP 默认不监听配置文件变化，所有配置都在应用启动时加载进内存，运行中改文件不会自动重载。
开发阶段可以手动清缓存：php think clear:config；生产环境几乎从不启用热更新，因为涉及性能和一致性风险。
- 配置缓存文件位置：
runtime/cache/config.php，删它比清整个 cache 更精准 - 如果你硬要实现热更新（比如配置中心场景），得自己监听文件 mtime + 调用
Config::reset()再load()，但要注意并发请求下配置不一致问题 - 别把敏感配置（如密钥）写在可被 Web 访问的路径下，
app/config/是安全的，但public/config/就是重大隐患
真正麻烦的不是怎么加载，而是加载时机和作用域边界 —— 多数问题都出在“以为加载了，其实还没”或者“以为生效了，其实被早先的值覆盖了”。
