怎样在ThinkPHP中实现数据库连接池优化【优化】

ThinkPHP无内置数据库连接池，FPM下仅支持deploy=>1的PDO实例复用，真连接池仅在Swoole协程中通过Db::pool()显式调用生效；配置必须放在config/swoole.php中，且需满足版本和环境要求。

ThinkPHP 本身没有内置数据库连接池，所谓“实现连接池优化”，本质是根据运行环境选择匹配的复用机制——FPM 下只能靠 deploy => 1 做单请求内 PDO 实例复用；真连接池只在 Swoole 协程环境下生效，且必须走 Db::pool() 显式入口。

Db::pool() 必须显式调用，否则配置全是摆设

很多人配了 config/swoole.php 里的 db_pool 参数，但 show processlist 里连接数照涨不误。原因就一个：代码里还在用 Db::table('user')->select()，它压根不走池子。

• Db::table('user')->select() → 每次新建 PDO 连接（短连接）
• Db::pool()->table('user')->select() → 从池中取空闲连接，用完自动归还
• Db::transaction() 默认绕过池子；必须写成 Db::pool()->transaction(function () { ... })
• 模型类（如 UserModel）不自动继承池行为，需重写 db() 方法返回 Db::pool() 实例

config/swoole.php 才是唯一有效的池配置位置

config/database.php 里任何 pool、max_connections、pool_size 字段全被忽略——TP5/TP6/TP8 均不解析这些键。真正起作用的只有 config/swoole.php 中的 db_pool 配置段。

• 必须确保已安装 topthink/think-swoole >= 3.1.0 且 swoole >= 4.8.0
• 典型配置：'db_pool' => ['max_active' => 8, 'max_idle' => 2, 'wait_timeout' => 2000, 'idle_timeout' => 60]
• max_active 是硬上限，不是并发数，而是池中最多存在的连接总数
• wait_timeout 是获取连接的排队超时（毫秒），设太小（如 100）会导致大量 PoolTimeoutException，设太大（如 5000）会让请求卡死
• FPM 模式下该配置完全无效，只对 php think swoole 启动的协程进程生效

deploy => 1 是 FPM 和 Swoole 都能用的复用基础

这不是连接池，但它是所有复用的前提。它让相同数据库配置（host/port/database/user/password 完全一致）共享同一个 PDO 实例，避免重复创建对象。

立即学习“PHP免费学习笔记（深入）”；

• 必须显式配置 'deploy' => 1，默认是 0（关闭）
• 漏写 'type' => 'mysql' 或把 'hostname' 写成 'host'，都会导致复用失效
• 'pool_size' => 20 仅在 deploy => 1 开启时限制同配置 PDO 实例数量，不控制底层 TCP 连接数
• CLI 脚本末尾必须手动调 Db::close()，否则连接常驻内存；Swoole 下同样不能依赖自动回收
• 开启 'debug' => true 会强制禁用所有复用逻辑，每次查询都新建 PDO

Swoole 环境下连接泄漏比配置错误更致命

协程连接不会随请求结束自动释放，一个没关的 Db::connect() 或未提交的事务，就能让连接永久卡在池里或 MySQL 的 Sleep 状态。

• 事务必须包裹在同一个协程内：go(function () { Db::pool()->transaction(...); });，跨协程执行会导致连接丢失
• MySQL 的 wait_timeout 默认仅 8 秒，闲置连接会被服务端 kill；需同步配置 'options' => ['heartbeat' => 3] 并调大服务端值（SET GLOBAL wait_timeout = 300）
• 禁止在 __construct、中间件或定时任务回调中提前调 Db::connect()，应在 go() 内按需获取
• 用 spl_object_id($connection) 打日志验证是否真复用：同一 worker + 同一协程内两次查询 ID 相同，才算进了池

最易被忽略的点：二级域名、多环境变量、动态传参都会破坏配置一致性，让 deploy => 1 和池复用全部失效；别盯着 pool 字段改，先统一 hostname、database、username 的拼写和大小写。