ThinkPHP连接外部数据库配置详解_跨环境多库连接设置方案-ThinkPHP-PHP中文网

thinkphp 运行时创建第二个数据库连接需用 db::connect($config) 显式初始化，配置须含 hostname、username、password、database、hostport、charset 等完整字段，推荐将外部库配置存于 config/database_ext.php 或通过 .env 环境变量动态加载，并手动复用连接对象避免频繁新建 pdo 实例。

thinkphp连接外部数据库配置详解_跨环境多库连接设置方案

ThinkPHP 默认只支持单数据库连接，要连外部数据库或同时用多个库，必须手动配置多个连接实例，不能只改 database.php 里的默认配置项。

如何在运行时创建第二个数据库连接（非默认）

ThinkPHP 的 Db 类不自动管理多连接，得用 Db::connect() 显式初始化。传入的配置数组必须包含完整连接参数，不能复用默认配置里的部分字段。

配置数组需包含 hostname、username、password、database、hostport（别漏，默认是 3306）、charset（建议显式设为 utf8mb4）
不要把外部库配置写进 config/database.php 的 connections.mysql 下——那是给默认连接用的，多库场景下它只会被 Db::name() 调用，不会自动识别新连接
推荐把外部库配置单独放在 config/database_ext.php，用 Config::load() 加载后传给 Db::connect()

$extConfig = Config::load('database_ext');
$extDb = Db::connect($extConfig);
$result = $extDb->table('user_log')->where('status', 1)->select();

跨环境（dev/test/prod）如何安全切换外部库地址

硬编码 IP 或账号密码在代码里极危险，尤其当外部库是第三方服务或测试库直连生产网段时。ThinkPHP 的环境变量机制（.env）是唯一靠谱方案。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

.env 文件中定义 EXT_DB_HOST、EXT_DB_NAME 等键，值按环境分别填写；确保 config/app.php 中 app_debug 关闭时仍能读取（ThinkPHP 6.0+ 默认支持）
配置数组里不要直接拼字符串，用 Env::get('EXT_DB_HOST', '127.0.0.1') 包一层，避免环境缺失时报错
敏感字段如 password 绝对禁止写进 Git，必须进 .gitignore；CI/CD 流水线里通过 secret 注入，而非覆盖 .env

为什么用 `Db::connect()` 后查不到数据或报连接超时

常见不是 SQL 写错，而是底层 PDO 实例没正确复用或释放，尤其在长生命周期脚本（如队列任务、Swoole Worker）中容易堆积连接。

每次 Db::connect($config) 都会新建 PDO 实例，即使配置完全相同——ThinkPHP 不做连接池，也不缓存连接对象
高频调用时务必手动复用连接对象：把 $extDb 存到静态属性或容器里（如 Container::set('ext_db', $extDb)），而不是每次 new
检查外部库是否开启远程访问（MySQL 的 bind-address 是否为 0.0.0.0）、防火墙端口（3306 或自定义端口）、用户 host 是否允许 %
错误信息如 PDOException: SQLSTATE[HY000] [2002] Connection refused 90% 是网络层问题，先 telnet ext-db-host 3306 确认通路