PHP项目中,做MySQL连接池
先讲核心结论
PHP-FPM 天然无法实现跨进程共享的连接池:FPM 是进程隔离、请求结束后资源销毁;PDO::ATTR_PERSISTENT / mysqli p: 只是单进程内持久缓存,不是真正意义上的多路复用连接池,一个FPM worker最多对应一条长连接到MySQL,FPM进程多了,MySQL连接数照样线性上涨。
PHP里MySQL连接池一共4种方案,按选型优先级:
- ProxySQL(代理层连接池,传统FPM项目首选,不改业务代码)✅
- Swoole/OpenSwoole 常驻进程 + 协程连接池(常驻服务、CLI消费脚本、pcntl多进程任务)✅
- PDO/mysqli持久连接(简单低并发场景,坑很多,谨慎)
- 自己手写pcntl多进程共享连接池:不推荐,实现复杂、容易死锁、句柄错乱
你前面问的 pcntl 多进程任务场景:优先用 Swoole 协程池,或者 ProxySQL;不要自己写跨进程共享连接池。fork之后内存隔离,连接句柄共享很容易报文错乱。
方案1:ProxySQL(FPM老项目最优,生产最常用)
架构:PHP-FPM → ProxySQL(6033) → MySQL(3306) ProxySQL 自己维护连接池,成千上百个FPM worker 只复用少量真实MySQL连接,实现连接多路复用,业务代码几乎不用改,只改数据库host/port指向ProxySQL。
特点:
- 支持读写分离、连接池、限流、SQL路由
- 事务级/会话级池,解决
Too many connections - 所有PHP框架(Laravel/ThinkPHP)无缝接入
简单配置思路:
-- 登录 proxysql admin 端口 6032
INSERT INTO mysql_servers (hostgroup_id,hostname,port) VALUES (0,'127.0.0.1',3306);
INSERT INTO mysql_users (username,password,default_hostgroup) VALUES ('root','xxx',0);
LOAD MYSQL SERVERS TO RUNTIME; SAVE MYSQL SERVERS TO DISK;
PHP配置:host=127.0.0.1 port=6033,其他不变。
同类:阿里云RDS数据库代理、AWS RDS Proxy,原理一致。
方案2:Swoole / OpenSwoole 协程连接池(常驻内存、CLI多进程任务推荐)
适合:swoole http服务、定时消费脚本、pcntl常驻任务、队列worker;同一个worker进程内,多个协程共享一套连接池,worker之间池隔离。 Swoole 内置
Swoole\Database\PDOPool,开箱即用,不需要自己造轮子。
官方PDOPool示例
<?php
declare(strict_types=1);
use Swoole\Database\PDOConfig;
use Swoole\Database\PDOPool;
use Swoole\Coroutine;
Co\run(function () {
// 连接池配置
$config = (new PDOConfig())
->withHost('127.0.0.1')
->withPort(3306)
->withDbName('test')
->withUsername('root')
->withPassword('123456')
->withCharset('utf8mb4');
// 池大小:根据MySQL最大连接数设置,比如10
$pool = new PDOPool($config, 10);
// 从池借出连接
$pdo = $pool->get();
try {
$stmt = $pdo->query("SELECT 1");
var_dump($stmt->fetch());
} catch (\Throwable $e) {
echo $e->getMessage();
} finally {
// 归还连接!必须归还,否则池耗尽
$pool->put($pdo);
}
});
手写简易协程池(Channel实现,理解原理)
<?php
declare(strict_types=1);
use Swoole\Coroutine;
use Swoole\Coroutine\Channel;
use Swoole\Coroutine\MySQL;
class MysqlPool
{
private Channel $chan;
private array $config;
public function __construct(array $config, int $size = 5)
{
$this->config = $config;
$this->chan = new Channel($size);
for ($i = 0; $i < $size; $i++) {
$this->chan->push($this->createConn());
}
}
private function createConn(): MySQL
{
$db = new MySQL();
$db->connect($this->config);
return $db;
}
// 借出,带超时
public function get(float $timeout = 3): ?MySQL
{
return $this->chan->pop($timeout);
}
// 归还;先ping校验,坏连接直接丢弃重建
public function put(MySQL $db)
{
if ($db->ping()) {
$this->chan->push($db);
} else {
$db = $this->createConn();
$this->chan->push($db);
}
}
}
// 使用
Co\run(function () {
$pool = new MysqlPool([
'host' => '127.0.0.1',
'user' => 'root',
'password' => '123456',
'database' => 'test',
'charset' => 'utf8mb4',
], 5);
$db = $pool->get();
$res = $db->query('select version()');
var_dump($res);
$pool->put($db);
});
重点:
- 每个Swoole Worker进程独立一个连接池,worker之间不能共享连接
- 用完必须put归还;一定要做ping心跳检测,防止
MySQL has gone away - 结合你前面pcntl多进程任务:不要在父进程预创建连接池,每个子进程内部初始化自己的池(和之前说的fork后建连接原则一致)
方案3:PDO / mysqli 持久连接(不推荐高并发)
PDO 持久连接写法
$dsn = "mysql:host=127.0.0.1;dbname=test;charset=utf8mb4";
$opt = [
PDO::ATTR_PERSISTENT => true, // 持久连接,必须在构造时传入
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
];
$pdo = new PDO($dsn, 'root', '123456', $opt);
mysqli 持久连接写法:主机加 p:
$mysqli = new mysqli('p:127.0.0.1', 'root', '123456', 'test');
⚠️ 巨大坑:
- 只是单进程缓存,不是多路复用:pm.max_children=100,MySQL最少100条连接
- PDO不会自动清理会话状态:残留事务、锁、临时表、session变量,下一个请求拿到脏连接,偶发诡异bug;mysqli会自动重置会话,相对好一点
- 连接空闲超时被MySQL断开后,PHP不会自动重连,报
2006 MySQL server has gone away - 适合:低并发内网脚本,不适合线上FPM业务
方案4:pcntl多进程自己实现跨进程连接池(强烈不推荐)
很多人想:父进程建一堆连接,fork给子进程共享 → 绝对不要这么干
- fork时句柄复制,多个进程共用同一个socket fd,读写报文错乱、丢包、死锁(就是你上一问的资源竞争场景)
- 想要跨进程共享连接,本质必须走IPC(unix socket/管道)做代理,等于自己手写一个微型ProxySQL,复杂度极高,生产没必要造轮子。
pcntl多进程任务的正确做法: ① 每个子进程内部独立创建连接(简单);或者 ② 子进程连ProxySQL(最优);或者 ③ 改用Swoole常驻协程池,不再频繁fork。
选型对照表
| 方案 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| ProxySQL | PHP-FPM、传统Web项目、存量Laravel | 改配置即可,多路复用,降MySQL连接数 | 多一层代理,需要运维部署 |
| Swoole PDOPool | 常驻服务、CLI消费、队列任务 | 原生协程池、可控、高性能 | 需要改造常驻模式,不能FPM |
| PDO持久连接 | 低并发脚本、内部工具 | 零依赖、简单 | 1worker:1连接,脏连接风险大 |
| 自研pcntl跨进程池 | 几乎没有生产场景 | 无 | 极易句柄错乱、死锁、维护成本爆炸 |
配套最佳实践
- 池大小设置原则:池最大连接数 ≤ MySQL
max_connections,预留一部分给运维、其他业务; - 连接归还前校验:
ping(),失效连接直接丢弃重建; - 池获取连接加超时时间,避免无限阻塞;
- 事务不要跨借出/归还;尽量拿到连接 → 执行 → 立刻归还;
- 如果你是pcntl多进程任务:禁止父进程预创建MySQL连接,子进程内部初始化连接或者连ProxySQL;
- 不要在连接池里混用长事务、大锁,持有连接时间越短越好。
关于 LearnKu