Hyperf 配置 MySQL 协程指通过 hyperf/database 组件启用 Swoole 协程 MySQL 客户端实现非阻塞访问，关键配置在 databases.php 中设 'driver' => 'mysql' 并合理配置 pool.min_connections、max_connections 等参数，禁用同步扩展如 pdo_mysql。

Hyperf 配置 MySQL 协程，指的是让 Hyperf 框架在 Swoole 协程环境下，以非阻塞、轻量级协程的方式访问 MySQL 数据库，而不是用传统 PHP 的同步阻塞方式（比如 PDO 或 mysqli 在 FPM 下的调用）。

这背后不是简单“加个扩展”或“换个驱动”，而是整套运行机制的切换：

• Hyperf 启动后常驻内存，每个请求在一个协程中执行；
• 当代码里调用 $user = User::find(1) 或 DB::table('users')->get() 时，底层实际走的是 Hyperf 封装的协程 MySQL 客户端；
• 这个客户端会从连接池取一个可用连接，发 SQL、等待响应——但等待过程不会卡住整个进程，而是自动让出 CPU，去跑别的协程；
• 响应回来后，协程自动恢复执行，代码看起来还是同步写法，实则全程异步非阻塞。

关键配置项说明

你在 config/autoload/databases.php 里看到的这些配置，就是为协程 MySQL 服务的：

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

• pool.min_connections：启动时就创建的最小连接数，避免首次请求冷启动等待
• pool.max_connections：最多允许多少个并发数据库连接，超了会排队等（受 wait_timeout 控制）
• pool.wait_timeout：协程在连接池里最多等多久，超时抛异常，防止请求挂死
• pool.max_idle_time：空闲连接存活多久就被回收，避免连着旧主库不释放（双主/故障转移场景尤其关键）
• driver => 'mysql'：必须设为 mysql，且依赖 hyperf/database 和 Swoole 的协程 MySQL 支持

为什么不能直接用普通 MySQL 扩展？

因为传统扩展（如 pdo_mysql）是同步阻塞的。在协程环境里调用它，会把整个协程线程卡住，失去并发优势，甚至拖垮整个服务。Hyperf 明确要求：

• ✅ 必须用 hyperf/database 提供的协程封装
• ❌ 禁止用 file_get_contents、curl_exec、原生 mysqli_connect 等阻塞操作

实际效果对比

场景	传统 FPM + PDO	Hyperf + 协程 MySQL
100 个并发查用户	100 个进程各自阻塞等 MySQL 返回，内存暴涨，QPS 上不去	100 个协程共享少量连接，IO 等待时自动调度，内存低、延迟稳、QPS 可破万

不复杂但容易忽略。