PHP项目中,做MySQL连接池

AI摘要
PHP-FPM因进程隔离无法实现跨进程连接池,PDO/mysqli持久连接仅为单进程缓存,非真正多路复用。文章系统梳理四种MySQL连接池方案:ProxySQL代理层(FPM老项目首选,改配置即可)、Swoole协程连接池(常驻服务与CLI任务推荐,附PDOPool及Channel手写示例)、持久连接(低并发场景,存在脏连接与断连风险)、自研pcntl跨进程池(强烈不推荐,易句柄错乱死锁)。文末给出选型对照表及池大小、ping校验、超时、短持有等最佳实践。属知识分享。

先讲核心结论

PHP-FPM 天然无法实现跨进程共享的连接池:FPM 是进程隔离、请求结束后资源销毁;PDO::ATTR_PERSISTENT / mysqli p: 只是单进程内持久缓存,不是真正意义上的多路复用连接池,一个FPM worker最多对应一条长连接到MySQL,FPM进程多了,MySQL连接数照样线性上涨。

PHP里MySQL连接池一共4种方案,按选型优先级:

  1. ProxySQL(代理层连接池,传统FPM项目首选,不改业务代码)✅
  2. Swoole/OpenSwoole 常驻进程 + 协程连接池(常驻服务、CLI消费脚本、pcntl多进程任务)✅
  3. PDO/mysqli持久连接(简单低并发场景,坑很多,谨慎)
  4. 自己手写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');

⚠️ 巨大坑:

  1. 只是单进程缓存,不是多路复用:pm.max_children=100,MySQL最少100条连接
  2. PDO不会自动清理会话状态:残留事务、锁、临时表、session变量,下一个请求拿到脏连接,偶发诡异bug;mysqli会自动重置会话,相对好一点
  3. 连接空闲超时被MySQL断开后,PHP不会自动重连,报 2006 MySQL server has gone away
  4. 适合:低并发内网脚本,不适合线上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跨进程池 几乎没有生产场景 无 极易句柄错乱、死锁、维护成本爆炸

配套最佳实践

  1. 池大小设置原则:池最大连接数 ≤ MySQL max_connections,预留一部分给运维、其他业务;
  2. 连接归还前校验:ping(),失效连接直接丢弃重建;
  3. 池获取连接加超时时间,避免无限阻塞;
  4. 事务不要跨借出/归还;尽量拿到连接 → 执行 → 立刻归还;
  5. 如果你是pcntl多进程任务:禁止父进程预创建MySQL连接,子进程内部初始化连接或者连ProxySQL;
  6. 不要在连接池里混用长事务、大锁,持有连接时间越短越好。
六月的风
Junwind
讨论数量: 0
(= ̄ω ̄=)··· 暂无内容!

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!