ThinkPHP 数据库配置文件热更新不重启【技巧】

在PHP开发中，数据库配置的热更新一直是个让人头疼的问题。以ThinkPHP为例，它的配置文件（config/database.php）默认并不支持热更新——你改完配置保存后，旧进程依然会使用缓存的配置，必须重启服务才能生效。但如果我们在加载逻辑上花点心思，绕过框架的静态缓存机制，其实完全可以做到“不重启、实时生效”。

这里有一个常见的误解需要先澄清：热更新的关键不是“让框架重新加载配置文件”，而是让数据库连接实例在创建时主动获取最新配置。原因很简单——初始化时，框架会把配置文件整体塞进内存，随后每次调用 Db::connect() 或 config('database')，都会直接从缓存中取，不再重新解析配置源文件。

所以，推荐的做法是：不再依赖内置的 config('database')，改用自定义函数动态加载配置数组，并确保这个函数在每次新建数据库连接之前执行。

具体怎么实现？用 Cache + 文件监听替代硬编码配置

核心思路是把数据库配置从 config/database.php 中迁出，改为由外部源提供，比如 Redis、本地 JSON 文件或数据库表。在此基础上加一层轻量级缓存控制，避免每次请求都读取外部源，影响性能。

先创建一个配置读取的工具类 app/common/DatabaseConfig.php：

get('db_config');
        if ($cache !== null) {
            return $cache;
        }

        // 从本地 JSON 文件读取（例如：runtime/db_config.json，可由运维脚本或后台写入）
        $jsonFile = runtime_path() . 'db_config.json';
        if (is_file($jsonFile)) {
            $content = file_get_contents($jsonFile);
            $config = json_decode($content, true);
            if (json_last_error() === JSON_ERROR_NONE && !empty($config)) {
                // 缓存 5 秒，避免高频读文件
                Cache::store('redis')->set('db_config', $config, 5);
                return $config;
            }
        }

        // 兜底方案（开发环境使用）
        return [
            'default' => 'mysql',
            'connections' => [
                'mysql' => [
                    'type'     => 'mysql',
                    'hostname' => $_ENV['DB_HOST'] ?? '127.0.0.1',
                    'database' => $_ENV['DB_NAME'] ?? 'thinkphp',
                    'username' => $_ENV['DB_USER'] ?? 'root',
                    'password' => $_ENV['DB_PASS'] ?? '',
                    'hostport' => $_ENV['DB_PORT'] ?? '3306',
                ],
            ],
        ];
    }
}

然后，在需要创建数据库连接的地方，替换掉原来的默认配置引用。例如在模型或服务中：

use app\common\DatabaseConfig;
use think\db\Connection;

$customDb = new Connection(DatabaseConfig::get()['connections']['mysql']);

如果想全局替换默认连接，可以在 app/common.php 中这样处理：

\think\facade\Db::setConnect([
    'default' => function () {
        $config = DatabaseConfig::get();
        return new \think\db\Connection($config['connections'][$config['default']]);
    }
]);

如果坚持用本地 JSON 文件：配合 inotifywait 实现文件变更自动刷新缓存

在 Linux 环境下，可以部署一个监听脚本，检测 runtime/db_config.json 文件变更后主动清除相关缓存。

创建 bin/refresh-db-cache.sh：

#!/bin/bash
CONFIG_FILE="runtime/db_config.json"
inotifywait -m -e modify "$CONFIG_FILE" | while read; do
    echo "Detected change in $CONFIG_FILE, clearing db_config cache..."
    php think optimize:clear --type=config 2>/dev/null || true
    # 也可以直接调用 API 触发缓存清理（如果后台有相关接口）
done

然后赋予执行权限并在后台运行：chmod +x bin/refresh-db-cache.sh && nohup ./bin/refresh-db-cache.sh &

需要注意的几个关键问题

有些情况下热更新可能会失效，提前排查能避免不少麻烦：

• OPcache 缓存问题：即使配置文件变了，PHP 可能仍使用缓存的 opcode 执行旧逻辑。开发环境建议设置 opcache.validate_timestamps=1 且 opcache.revalidate_freq=0；生产环境如果使用文件方案，最好切换到 Redis，避免 OPcache 干扰。
• 连接池复用旧连接：在使用 Swoole 等常驻进程场景下，Db::connect() 可能会复用之前创建的连接实例。一定要确保新连接每次都基于 DatabaseConfig::get() 创建，不要在 onWorkerStart 中一次性初始化全局 DB 对象。
• 环境变量覆盖优先级：如果 .env 中定义了 DB_HOST 等变量，它们会优先于配置文件生效。热更新时需要同步更新 .env，或者干脆改用纯外部源（如 Redis），避免混合管理造成混乱。
• 事务与长连接的状态残留：配置热更新后，当前已开启的事务或活跃连接不会受影响。只有新请求才会使用新配置，已有连接会继续运行直到关闭。这一点在业务设计时需要留意。