ThinkPHP配置读取先加载、再缓存、最后查表，非实时读文件；自定义配置需在app.php的extra中声明，键名支持点号分隔但大小写敏感，模板中须用{:config()}，缓存需手动清空或生成优化文件。
ThinkPHP 读取配置不是“调用一次就去读一次文件”，而是先加载、再缓存、最后查表。理解这个流程，才能避免 config() 返回 null、值没更新、模板里读不到等常见问题。
配置加载时机：启动阶段一次性合并
框架在应用初始化时（如入口文件 index.php 执行后）会扫描 config/ 目录，按固定顺序加载预设文件（app.php、database.php、cache.php 等），再加载 .env 和运行时配置。这个过程只发生一次，所有配置被合并进内存中的全局配置数组。
- 自定义配置文件（如
wechat.php）不会自动加载，必须在config/app.php的'extra' => ['wechat']中声明 - 多应用模式下，每个应用的
config/目录独立，需确认当前应用是否包含目标配置文件 - 如果修改了
config_path()或提前调用了Config::set('path', ...)，可能导致extra加载失效
读取方式：统一接口，但写法有讲究
无论用 config() 函数还是 Config::get() 静态方法，底层都是查同一个缓存数组。关键在键名格式和作用域。
- 支持点号分隔的路径语法：
config('database.connections.mysql.host')✅ - 不支持数组下标写法：
config('database')['connections']['mysql']['host']❌（会报错或返回 null） - 大小写敏感：
config('app_debug')和config('APP_DEBUG')是两个不同键 - 读整个配置段：末尾加点号，如
config('database.')返回所有以database.开头的键组成的数组 - 模板中必须用
{:config('app_name')}，冒号不能少；{config('app_name')}不执行，只当普通字符串输出
缓存机制：不是实时文件读取
config() 每次调用都不重新 include 文件，而是直接从内存缓存中查找。所以改完配置文件不重启服务，是看不到变化的。
立即学习“PHP免费学习笔记（深入）”；
- 开发期想临时刷新：在代码开头加
config(null, true)清空缓存（仅限调试，禁止上生产） - 正式环境建议运行
php think optimize:config，生成合并后的runtime/cache/config.php，大幅提升读取效率 - 确保
runtime/cache/目录可写，否则优化命令静默失败 - APP_DEBUG = true 时，配置编译缓存默认关闭，关掉调试模式或仅在 CLI 下启用可显著提速
常见失效原因与对应检查点
config() 返回 null 或空值，通常不是函数写错了，而是加载或路径环节出了问题。
- 自定义文件没注册：检查
config/app.php的extra数组是否包含文件名（不含 .php 后缀） - 键名层级不对：配置文件返回的是
return ['wechat' => [...]]，就得用config('wechat.app_id')，不能漏掉根键 - 命令行/定时任务中报
Call to undefined function config()：这些场景不自动加载助手函数，改用use think\facade\Config;+Config::get() - 配置值含冒号（:）或斜杠（/）：ThinkPHP 会尝试类型转换或路径解析，必要时用单引号包裹原始字符串，如
'https://api.example.com:8080'
