CI自定义工具类共享数据库连接池实现方法-php教程-PHP中文网

codeigniter默认无连接池，需将连接池独立于ci生命周期外管理以解决并发测试时mysql连接超限问题；可通过原生mysqli连接池或向ci 4.x注入已有连接实现复用。

ci自定义工具类共享数据库连接池实现方法

CI（CodeIgniter）默认不带连接池机制，所有数据库连接都是按需创建、用完即关——这在CI持续集成（CI/CD）流水线中跑大量单元测试或并发任务时，容易触发MySQL连接数超限、Too many connections 错误，或因频繁握手拖慢构建速度。解决办法不是换框架，而是让多个测试进程/任务复用同一组连接，核心是：**把连接池“拎出来”，脱离CI单例生命周期，交由外部进程或共享内存管理。**

为什么不能直接在CI的`$this->db`里加连接池

CI 3.x / 4.x 的数据库类设计基于“每次请求一个实例”，DB() 或 $this->db 返回的对象绑定在当前请求生命周期内，无法跨进程、跨PHP-FPM worker、跨CLI子进程复用。你在某个测试用例里调用 $this->db->close()，实际只是标记为可重用，但底层连接仍被PHP进程持有，不会返还给其他测试进程。

常见错误现象：
• 单个CI测试套件跑着没问题，但并行执行（如phpunit --process-isolation）时频繁报错 SQLSTATE[HY000] [1040] Too many connections
• CI流水线里多个Job同时启动，每个Job都初始化自己的CI实例，各自建满max_connections上限

CI的DB类本身没有returnConnection()或release()语义，归还操作隐式发生在脚本结束时
即使启用persistent连接（'pconnect' => TRUE），也只是在同一个PHP进程内复用，对多进程无意义
CI 4.x 的Database\Connection虽支持close()，但关闭后连接资源仍由该Connection对象独占，无法移交

用`mysqli`原生连接池替代CI DB类

绕过CI的DB封装层，在CI测试环境或CLI命令中，直接使用mysqli + 连接池管理器（如spiral/database或轻量级pooler），让连接在多个CI测试用例间真正共享。

关键点在于：连接池必须独立于CI生命周期存在，且支持fork安全（Linux下CLI多进程场景）：

不要在__construct()里初始化池，而是在setUpBeforeClass()静态方法中一次性创建，并存入static $pool
池返回的连接必须是mysqli原生对象，而非CI的Connection包装类，否则仍会触发CI内部的自动关闭逻辑
每个测试用例获取连接后，显式调用$pool->release($conn)，而不是依赖mysqli_close()

示例片段（PHPUnit + 自定义池）：

Voicepods

Voicepods是一款把文字转换为自然语音并用于内容朗读和配音的在线 TTS 工具。

下载

class UserTest extends TestCase
{
    protected static $pool;

    public static function setUpBeforeClass(): void
    {
        self::$pool = new \Pooler\Pool(
            fn() => new \mysqli('localhost', 'user', 'pass', 'db'),
            5 // 最大连接数
        );
    }

    public function testCreateUser()
    {
        $conn = self::$pool->acquire();
        $stmt = $conn->prepare("INSERT INTO users (name) VALUES (?)");
        $stmt->bind_param("s", $name);
        $name = "test";
        $stmt->execute();
        self::$pool->release($conn); // 必须手动归还
    }
}

CI 4.x 中复用已建立的`mysqli`连接

如果你仍想走CI的查询流程（比如复用$builder->insert()语法），又不想放弃连接池，可行路径是：**把池返回的mysqli对象塞进CI 4.x的Connection构造参数里，跳过它自己建连的逻辑。**

CI 4.x 的MySQLiConnection允许传入已有连接句柄：

构造时传['connection' => $existing_mysqli]，CI就不会再调用mysqli_connect()
但要注意：CI默认会在__destruct()里调用mysqli_close()，必须重写close()方法为空操作，否则连接会被真正关闭
连接有效性检查（ping()）需在归还前由池完成，CI不负责健康检测

示例：

$connFromPool = self::$pool->acquire();
$ciDb = new \CodeIgniter\Database\MySQLi\Connection([
    'DSN'          => '',
    'hostname'     => '',
    'username'     => '',
    'password'     => '',
    'database'     => '',
    'connection'   => $connFromPool, // 关键：注入已有连接
]);
// 禁用CI的自动关闭
$ciDb->close = function() {}; // 或继承后重写 close()

CI流水线中连接池的存活边界在哪

最容易被忽略的是：**连接池的生命周期必须覆盖整个CI Job，而不是单个测试文件或类。**

很多团队把池建在TestCase里，结果每个phpunit子进程都新建一个池，反而加剧连接耗尽。正确做法：

在CI脚本最顶层（如before_script）启动一个守护进程托管连接池（如用reactphp或amphp），通过Unix socket提供连接分发服务
或改用pcntl_fork + shmop共享内存存储连接句柄（仅限Linux CLI，注意mysqli资源不可跨进程直接传递，需用mysqlnd_ms等扩展支持）
若用Docker，可在CI容器内运行一个独立的mysql-proxy或proxySQL，让所有CI任务统一连它，由代理层做连接复用