ThinkPHP6升级到ThinkPHP8配置优先级变了吗-ThinkPHP-PHP中文网

thinkphp 8 重构配置流程：.env仅字面量覆盖一级键（如database_hostname）、php配置只加载config/下预设模块文件、自定义配置须显式注册并清缓存；键名不匹配、未注册或未执行php think clear:config均导致配置失效。

thinkphp6升级到thinkphp8配置优先级变了吗

ThinkPHP 8 的配置加载顺序和覆盖规则变了

不是“变没变”，是 TP8 彻底重构了配置解析流程：环境变量（.env）只覆盖一级键，且必须严格匹配 PHP 配置里的键名结构；PHP 配置文件不再自动合并任意文件，只加载 config/ 目录下预设模块名的文件；自定义配置不显式注册就完全不可见。

`env()` 只能覆盖一级键，`database.hostname` ≠ `DATABASE_HOST`

常见错误是写了 DATABASE_HOST=127.0.0.1，但 PHP 配置里写的是 'hostname' => env('DATABASE_HOSTNAME', '127.0.0.1')，结果 Config::get('database.hostname') 始终返回默认值——因为 TP8 的 env() 不做键名推导，只做字面量映射。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

.env 中必须写 DATABASE_HOSTNAME=127.0.0.1 才能生效
config/database.php 中必须用 env('DATABASE_HOSTNAME')，不能漏掉 NAME 后缀
写成 DATABASE_HOST 或 database.host 都不会被识别
修改 .env 后必须运行 php think clear:config，否则缓存不刷新

自定义配置文件（如 `config/custom.php`）默认不加载

TP6 可能靠自动扫描或全局 include 加载业务配置，TP8 下这招失效。如果你把支付密钥、API 地址塞进 config/custom.php 却没注册，Config::get('custom.pay_key') 永远返回 null，且无任何警告。

新建 config/custom.php，返回纯数组：return ['pay_key' => env('PAY_KEY', '')];
在 app/bootstrap.php 开头添加：think\facade\Config::load(__DIR__ . '/../config/custom.php', 'custom');
PAY_KEY 必须全大写、下划线分隔，否则 env('PAY_KEY') 读不到
不执行 Config::load()，框架启动时根本不会碰这个文件

配置缓存机制更敏感，改完不清理 = 白改

TP8 的配置合并发生在容器初始化早期，且缓存粒度更细。你改了 .env、改了 config/database.php、甚至重跑了 composer dump-autoload，只要没清配置缓存，所有改动都不生效。

每次修改配置后，必须执行 php think clear:config
若用 opcache.enable=1，还需确认 opcache.revalidate_freq=0，否则 PHP 文件变更可能被 opcache 缓存住
CI/CD 流程中容易漏掉这步，导致测试环境和生产环境配置不一致

配置优先级本身没加新层级，但“覆盖条件”变苛刻了：键名必须一字不差、文件必须显式加载、缓存必须手动刷新——任何一个环节断掉，你就以为配置没生效，其实它压根没进加载流水线。