ThinkPHP系统配置管理教程-ThinkPHP-PHP中文网

thinkphp配置加载优先级为.env环境变量＞运行时动态设置＞php配置文件＞框架默认值，.env中db_host等键会覆盖config/database.php对应项，且修改后需清除runtime/config.php缓存才生效。

thinkphp系统配置管理教程

ThinkPHP 的配置不是“写完就跑”，而是有明确优先级和加载路径的系统行为。直接改 config/database.php 却发现数据库连不上？大概率是 .env 里同名键覆盖了它，或者 runtime/config.php 缓存没清。

为什么改了 config/database.php 还不生效

ThinkPHP 配置加载有固定顺序：环境变量（.env） > 动态设置（代码中 config() 调用） > PHP 配置文件（config/*.php） > 框架默认值。这意味着：

.env 中只要定义了 DB_HOST、DB_NAME 等键，就会完全覆盖 config/database.php 里对应的 'hostname' 或 'database'
.env 的键名是扁平的，比如 DB_HOST=127.0.0.1，不是嵌套格式 database.hostname=...
改完 .env 后必须清空 runtime/cache/ 和 runtime/config.php，否则旧缓存会继续生效
确认 .env 文件在项目根目录，且未被 gitignore 忽略导致上线后丢失

database.php 里主从配置总走主库的三个硬条件

启用读写分离不是加个 read 数组就行，TP6/TP8 要求同时满足：

'deploy' => 1 必须写在具体连接配置内部，例如 'connections.mysql.deploy' => 1，不能放在 'default' 顶层
'rw_separate' => true 必须与 deploy 同级，二者是绑定关系
'read' 必须是数组套数组（支持多个从库），'write' 必须是单层数组（只允许一个主库）；写成 'write' => [['hostname' => 'master']] 会直接抛出 Invalid write database config

典型安全写法：

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

'connections' => [
    'mysql' => [
        'deploy'       => 1,
        'rw_separate'  => true,
        'read'         => [
            ['hostname' => 'slave1', 'username' => 'ro', 'password' => 'xxx'],
            ['hostname' => 'slave2', 'username' => 'ro', 'password' => 'xxx']
        ],
        'write'        => ['hostname' => 'master', 'username' => 'rw', 'password' => 'xxx'],
        // 其他字段如 type/database/charset 等仍需补全
    ]
]

多应用模式下子应用配置不加载的常见原因

开启 app_multi => true 后，app/admin/config/app.php 这类子应用配置默认不会自动合并进全局配置。关键点在于：

子应用的配置文件只有在该应用被路由命中时才会加载，全局 config/app.php 不会预加载它们
子应用内要用 config('app.debug') 读取的是自己目录下的 app/config/app.php，不是根目录的
如果想让某个配置对所有子应用生效，必须写在根目录 config/ 下（如 config/cache.php），或通过 env() 注入
app_namespace 必须与实际目录结构一致，比如子应用在 app/api，则 app_namespace 应设为 'app'，控制器命名空间才可能是 app\api\controller\Index