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 可破万 |
不复杂但容易忽略。
