ThinkPHP 5.1 无原生数据库连接池，需通过PDO持久连接、Swoole协程池、Hyperf Pool组件或ProxySQL代理四种方式实现；直接在database.php配pool无效。
ThinkPHP 5.1 本身不提供原生的数据库连接池实现，它没有内置连接队列、最大活跃数限制、空闲连接自动回收等池化核心能力。所谓“配置连接池参数”，在 TP5.1 中实际是指通过不同运行环境和扩展手段，模拟或接入真正的连接池机制。直接在 database.php 里加 pool => [...] 是无效的——框架会忽略该配置。
要让 TP5.1 支持可控、可监控、防打爆 MySQL 的连接复用，需按运行模型选择对应方案：
启用 PDO 持久连接（仅适用于 PHP-FPM 环境）
这是最轻量、无需额外扩展的方式，本质是进程级复用，非真正池化，但能缓解高频短连接压力。
- 打开
config/database.php - 在目标数据库连接（如
mysql）的params数组中加入：'params' => [ \PDO::ATTR_PERSISTENT => true, ], - 确保 Web 服务器使用 PHP-FPM（非 CGI/CLI），且
max_children设置合理 - ⚠️ 注意：
wait_timeout（MySQL 默认 8 小时）与 PHP 请求生命周期不匹配时，可能触发MySQL server has gone away；建议同时开启断线重连：'break_reconnect' => true,
接入 Swoole 协程连接池（需常驻内存服务）
TP5.1 可配合 think-swoole 扩展（v3.1.0+）在 Swoole 环境下启用真正的协程 MySQL 连接池。
立即学习“PHP免费学习笔记（深入）”；
- 安装依赖：
composer require topthink/think-swoole pecl install swoole # 确保 Swoole ≥ 4.8.0
- 在
config/swoole.php中添加数据库池配置（不是database.php）：'db_pool' => [ 'max_idle_time' => 60, // 连接最大空闲秒数 'max_active' => 30, // 最大并发连接数 'min_idle' => 5, // 最小空闲连接数 'wait_timeout' => 3.0, // 获取连接超时（秒） ], - 业务中必须改用池化调用方式：
$db = Db::pool()->connect(); // 获取池中连接 $db->table('user')->select(); // 不再用 Db::table() 或 Db::connect('mysql') —— 那些绕过池子
复用 Hyperf Pool 组件（解耦引入）
若项目已引入 Hyperf 生态组件，可手动集成 hyperf/pool + hyperf/database 构建独立池实例。
- 安装：
composer require hyperf/pool hyperf/database
- 创建连接池类（如
app/Pool/MySqlConnectionPool.php）：class MySqlConnectionPool extends AbstractPool { protected function createConnection(): ConnectionInterface { $pdo = new \PDO( 'mysql:host=127.0.0.1;dbname=test', 'root', '', [ \PDO::ATTR_EMULATE_PREPARES => false, \PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION, ] ); return new PDOConnection($pdo); } } - 在容器中绑定，并在控制器中通过
$this->pool->get()获取连接
使用 ProxySQL 做外部连接池代理（零代码改造）
部署 ProxySQL（≥2.4）作为中间层，所有 TP5.1 请求统一走 ProxySQL 地址，由其管理真实连接池、读写分离、故障转移。
- 修改
database.php中hostname为127.0.0.1，端口改为 ProxySQL 监听端口（如6033） - ProxySQL 配置后，TP 完全无感，也无需改任何 PHP 代码
不复杂但容易忽略
