PHP8.4MySQLi如何启用异步查询提升吞吐-php教程-PHP中文网

mysqli::reap_async_query() 用于收割已执行的异步查询结果，必须配合 mysqli::real_query() 和 mysqli_async 才生效；若未调用，后续查询将因连接阻塞而失败。

php8.4mysqli如何启用异步查询提升吞吐

mysqli 在 PHP 8.4 中本身不支持异步查询——它仍是同步阻塞式 API。真正提供异步能力的是底层驱动 mysqlnd，且必须配合特定调用模式（非 mysqli::query() 直接调用），否则根本不会进入异步流程。

你看到的 MYSQLI_ASYNC 标志、mysqli_poll()、reap_async_query() 等，全部依赖 mysqlnd 驱动 + 手动连接管理 + 多连接并发，不是“给 query 加个 flag 就变异步”。

mysqli::query() 传 MYSQLI_ASYNC 没用

这是最常见的误解。以下代码看似启用异步，实则完全无效：

$mysqli->query("SELECT 1", MYSQLI_ASYNC); // ❌ 不会异步，MYSQLI_ASYNC 在 query() 中被忽略

mysqli::query() 的第二个参数 result_mode 只接受 MYSQLI_STORE_RESULT、MYSQLI_USE_RESULT 或 MYSQLI_ASYNC —— 但 MYSQLI_ASYNC 在该方法中**无实现逻辑**，会被静默丢弃。官方文档也明确标注：此常量仅用于 mysqlnd 内部，不作用于 query()。

真正触发异步行为的是 mysqli::real_query()（或过程式 mysqli_real_query()）
MYSQLI_ASYNC 必须和 real_query() 搭配使用，且后续必须手动轮询+收割
直接调用 query() 即使传了 MYSQLI_ASYNC，仍走同步路径，连接被阻塞

正确启用 mysqlnd 异步的三步硬要求

缺一不可，否则连接卡死、mysqli_poll() 返回 0、或抛出 Commands out of sync 错误。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

驱动必须是 mysqlnd：运行 php -i | grep mysqlnd，确认输出含 mysqlnd；若显示 libmysqlclient（尤其在旧 CentOS 或编译安装时），异步功能完全不可用
每个异步查询必须独占一个 mysqli 连接：不能复用同一 $mysqli 实例发多个 real_query(..., MYSQLI_ASYNC) —— mysqlnd 不支持单连接多异步请求
必须用 mysqli_poll() 等待就绪，再用 reap_async_query() 获取结果：跳过 mysqli_poll() 直接调 reap_async_query() 会返回 false；不调 reap_async_query() 就执行下一个 real_query()，触发 Commands out of sync

实际能跑通的最小异步示例（PHP 8.4）

注意：这不是“一行开启异步”，而是显式管理连接、轮询、收割的完整闭环。

$links = [];
foreach ([1, 2, 3] as $i) {
    $link = new mysqli('localhost', 'user', 'pass', 'db');
    $link->real_query("SELECT SLEEP(2) AS n", MYSQLI_ASYNC); // ✅ 正确入口
    $links[] = $link;
}
<p>$read = $errors = $reject = $links;
while (count($links)) {
$n = mysqli_poll($read, $errors, $reject, 5); // 最多等 5 秒
if ($n > 0) {
foreach ($read as $link) {
$result = $link->reap_async_query(); // ✅ 必须调用
if ($result) {
var_dump($result->fetch_row());
$result->free();
$link->close();
$links = array_filter($links, fn($l) => $l !== $link);
}
}
$read = $errors = $reject = array_values($links); // 重置数组索引
}
}</p>

关键点：