Hyperf连接池预热怎么配置？-php教程-PHP中文网

Hyperf 连接池预热通过设置 min_connections＞0 实现，服务启动时自动创建并维持指定数量空闲连接；Swow 环境需满足版本≥1.5.0、使用同级 pool 结构、清空 runtime/container 并重启。

hyperf连接池预热怎么配置？

Hyperf 连接池预热不是靠某个开关一键开启，而是通过启动时主动触发连接创建 + 合理配置最小连接数（min_connections）来实现的。它本质是让服务刚启动就建立一批可用连接，避免首波请求因建连延迟而变慢。

预热的核心机制是 `min_connections`

这个参数表示连接池初始化时主动创建并保持的最少空闲连接数。只要设为大于 0 的值，Hyperf（配合 Swow 或 Swoole）在服务启动、连接池首次被加载时，就会同步创建对应数量的连接，并维持它们处于 idle 状态，随时可取。

例如，在 config/autoload/databases.php 中：

'default' => [
    'driver' => 'mysql',
    // ... 其他数据库配置
    'pool' => [
        'min_connections' => 8,   // ✅ 启动即建 8 个连接，完成“预热”
        'max_connections' => 64,
        'wait_timeout' => 3.0,
        'max_idle_time' => 60.0,
    ],
],

Redis 同理，在 config/autoload/redis.php 中设置：

'default' => [
    'host' => '127.0.0.1',
    // ... 其他配置
    'pool' => [
        'min_connections' => 5,   // 启动时预建 5 个 Redis 连接
        'max_connections' => 30,
        'wait_timeout' => 2.0,
    ],
],

注意 Swow 下的特殊要求

如果你使用的是 Swow 协程引擎（推荐且主流），必须满足以下条件，预热才真正生效：

hyperframes-超帧视频

HTML 驱动的视频合成——GSAP 动画、TTS 字幕、音频响应、着色器转场

下载

Swow 版本 ≥ 1.5.0，且 server.php 中已设 'mode' => SWOW_BASE
删除旧版 pool 的顶层写法（如 pool => [ 'min_connections' => ... ] 写在 driver 外层），改用 Swow 专用结构：pool 必须与 driver、host 等同级
修改后务必清空 runtime/container/ 并重启服务：
rm -rf runtime/container && php bin/hyperf.php start
否则旧 Pool 实例残留，min_connections 不会触发新建

不需要额外代码，但可主动验证

预热过程是自动的，无需写 foreach 循环去 borrow 连接。但你可以加一段简单验证逻辑（如在 Command 或 Boot 阶段），确认连接是否就绪：

use Hyperf\DbConnection\Pool\PoolFactory;
use Hyperf\Di\Annotation\Inject;

class WarmupCommand extends Command
{
    #[Inject]
    protected PoolFactory $poolFactory;

    public function handle()
    {
        $pool = $this->poolFactory->getPool('default');
        echo "当前连接数: {$pool->getCurrentConnections()}\n"; // 启动后应 ≈ min_connections
        echo "空闲连接数: {$pool->getConnectionsInChannel()}\n";
    }
}

运行 php bin/hyperf.php warmup 即可查看效果。