ThinkPHP配置必须严格解耦：config/目录只允许返回纯数组，禁止任何业务逻辑、if判断、环境分支或框架调用；敏感值统一走.env，多环境配置按需拆分，动态逻辑移至服务层或初始化流程。
ThinkPHP 项目里逻辑代码和业务配置混在一起，不是改个数据库密码就要 grep 全局，就是加个缓存开关得改三四个文件——这不是解耦，是埋雷。核心原则只有一条：config/ 目录必须只返回数组，且不能执行任何业务逻辑；所有带 if、new、Db:: 或环境判断的代码，一律禁止出现在配置文件中。
配置文件里写 if 判断？立刻删掉
常见错误：在 config/database.php 中写 if (APP_DEBUG) { ... } 或用 env() 做分支逻辑。这会导致配置无法被缓存（TP8 的配置缓存机制会跳过含动态语句的文件），还会让测试环境和生产环境行为不一致。
- 正确做法：把条件判断上移到初始化流程，比如在
app/provider/AppServiceProvider.php的register()方法里根据env('APP_ENV')绑定不同实例 - 敏感值统一走
.env，配置文件只做“取值+组装”，例如'port' => (int)env('DB_PORT', 3306) - 多环境差异大的配置（如 Redis host），单独拆成
config/redis.php和config/redis_prod.php，通过think config:cache按环境生成
业务逻辑别塞进 config/*.php
有人把微信支付参数校验规则、短信模板 ID 映射表、甚至订单状态流转图硬编码进 config/order.php，美其名曰“配置驱动”。结果改个文案要清缓存、加个状态要改数组键名、查 bug 得翻三个配置文件。
- 状态码、文案、模板这类**运行时可变数据**，应放入
app/model/或专用app/data/目录，用模型或数据类封装，支持数据库管理或热更新 - 支付、短信等第三方服务的**参数组合逻辑**（如签名拼接顺序、回调验签步骤），必须抽成
app/service/PayService.php或app/logic/WechatSignatureLogic.php，配置文件只提供原始凭证（app_id,secret） - 绝对禁止在配置文件里调用
Cache::get()、Config::get()或任何框架 Facade —— 配置加载阶段这些组件尚未初始化
目录结构怎么划才不打架
TP8 默认单应用结构下，app/ 是业务主战场，但很多人误把 config/ 当成“另一个 app”来组织，导致 app/config/ 和根目录 config/ 并存，最后连自己都分不清哪个配置生效。
立即学习“PHP免费学习笔记（深入）”；
-
config/是唯一合法配置目录，只放 PHP 数组文件；app/config/这种路径是反模式，删掉 - 模块级配置（如后台 admin 模块的菜单权限规则）不要塞进
config/admin.php，而应放在app/admin/config/menu.php，并在app/admin/Provider/AdminServiceProvider.php中显式加载 - 公共配置复用：把数据库连接池大小、日志级别等全局项留在
config/app.php；模块专属项（如 API 模块的限流阈值）放config/api/throttle.php，通过命名空间自动合并
为什么 config/*.php 不能 require 其他 PHP 文件
TP8 的配置缓存命令 php think config:cache 本质是把所有 config/*.php 的返回值序列化进 runtime/cache/ 下的一个 PHP 文件。一旦某个配置文件里 require 'xxx.php'，缓存生成时就会失败，或者缓存内容不完整。
- 想复用配置片段？用数组 +
array_merge()，例如return array_merge(require 'base.php', ['debug' => true]); - 需要动态生成配置？写个
app/command/BuildConfig.php命令，在部署时生成最终配置文件，而不是运行时计算 - 第三方 SDK 初始化参数（如阿里云 OSS 的
Client构造参数）必须剥离出配置文件，改由app/service/OssService.php在构造函数中组装
最常被忽略的一点：配置文件的加载顺序决定了覆盖优先级。.env > config/app.php > config/database.php，但如果你在 database.php 里又 require 'mysql_prod.php'，这个文件就脱离了框架的加载控制链——它不会被缓存，也不会受环境变量影响，成了隐形炸弹。
