PHP MySQLi数据库连接池实现求助：规避最大用户连接数限制

首先得指出你代码里的核心问题：你定义的$connect是函数内部的局部变量，每次调用getConnection()的时候，这个变量都会重新初始化，所以if ($connect)永远都是false，自然每次都走else分支新建连接，根本没做到复用。

接下来给你一步步梳理解决方案：

1. 修复连接复用的基础逻辑 #

要让连接能在多次函数调用间保留，得把$connect改成静态变量，这样它会在函数第一次调用时初始化，之后的调用都会沿用之前的值。同时还要加个连接存活检查，避免返回已经断开的无效连接：

<?php
function getConnection() {
    // 用static关键字让变量在函数调用间保留状态
    static $connect = null;
    
    // 先检查连接是否存在且可用
    if ($connect && $connect->ping()) {
        return $connect;
    }
    
    // 持久连接要在主机地址前加p:前缀
    $connect = new mysqli('p:xxxx', 'yyy', 'zzz', 'aaaa');
    
    // 错误处理要放在return前面，不然代码永远走不到这里
    if (mysqli_connect_errno($connect)) {
        error_log("数据库连接失败: " . mysqli_connect_error());
        die("Server Busy");
    }
    
    return $connect;
}
?>

2. 搞懂PHP持久连接的工作逻辑 #

你说用了持久连接还是新建连接，这是因为PHP的持久连接是进程/线程级的：

• 每个PHP-FPM进程会维护自己的独立持久连接
• 如果你的FPM进程数超过了数据库最大连接数（15），还是会出现连接耗尽的情况
• 持久连接不会自动释放，除非FPM进程被回收，所以要给FPM配置合理的进程回收策略，比如pm.max_requests，让进程处理一定数量的请求后自动重启，避免连接长期占用。

3. 进一步控制连接数的方案 #

如果你的FPM进程数确实超过了15，光靠持久连接不够，还可以做这些调整：

• 把FPM的pm.max_children降到不超过14（留1个连接给其他用户），这样每个进程对应一个持久连接，刚好不触碰数据库的连接上限
• 如果是CLI脚本这类单进程场景，可以实现一个简单的连接池，维护一批可用连接，用完放回池里：

<?php
class SimpleConnectionPool {
    private static $pool = [];
    private static $maxConnections = 14; // 预留1个连接给其他业务
    
    public static function getConnection() {
        // 先从池子里找可用的存活连接
        foreach (self::$pool as $key => $conn) {
            if ($conn->ping()) {
                unset(self::$pool[$key]);
                return $conn;
            }
        }
        
        // 池子里没可用连接，检查是否还能新建
        if (count(self::$pool) < self::$maxConnections) {
            $conn = new mysqli('p:xxxx', 'yyy', 'zzz', 'aaaa');
            if (mysqli_connect_errno($conn)) {
                error_log("数据库连接失败: " . mysqli_connect_error());
                die("Server Busy");
            }
            return $conn;
        }
        
        // 连接数已满，返回忙状态
        die("Server Busy");
    }
    
    // 用完连接后放回池子里
    public static function releaseConnection($conn) {
        if ($conn && $conn->ping()) {
            self::$pool[] = $conn;
        }
    }
}
?>

使用示例：

$conn = SimpleConnectionPool::getConnection();
// 执行你的数据库操作
// ...
// 用完记得放回池子
SimpleConnectionPool::releaseConnection($conn);

4. 解决睡眠连接的问题 #

数据库里的睡眠连接大多是持久连接没被及时回收导致的：

• 给FPM设置pm.max_requests（比如设为1000），让进程处理一定请求后重启，对应的持久连接会被数据库自动关闭
• 在数据库端设置wait_timeout和interactive_timeout（比如设为300秒），让长时间睡眠的连接自动断开

内容的提问来源于stack exchange，提问作者Aroon