PHP curl_multi_select 返回 0 时如何继续轮询

在 PHP 的 cURL multi 并发循环里，curl_multi_select() 返回 0 并不表示请求失败，也不表示所有任务已经结束。它只说明本次等待窗口内没有可读写的文件描述符。正确处理方式是保持 still_running 作为主退出条件，短暂退让后再次调用 curl_multi_exec()，同时继续排空 curl_multi_info_read() 的完成消息。

官方文档：https://www.php.net/manual/en/function.curl-multi-select.php

先把返回 0 放回它真正的语义

curl_multi_select($mh, 1.0) 的职责是等待连接状态变化。返回正数时，表示有描述符活动；返回 0 时，表示等待时间到了但没有活动；返回 -1 时，表示底层 select 失败。这里的“没有活动”是一个瞬时观察结果，不是任务状态。

例如 DNS、连接建立或底层状态切换尚未产生可供 select 观察的事件时，返回 0 很正常。下一轮仍然要让 cURL 状态机继续运行。真正表示 multi 栈推进是否正常的是 curl_multi_exec() 的返回值；真正表示是否还要继续等的是引用参数 $stillRunning。

用三种状态组成稳定的轮询骨架

轮询要先推进，再等待，再推进。关键是把“等待没有事件”和“请求已经完成”分离开，并且处理兼容某些环境中 CURLM_CALL_MULTI_PERFORM 的情况：

 0) {
        // 0 只代表本次无事件；短暂退让后仍回到 curl_multi_exec。
        $ready = curl_multi_select($mh, 1.0);
        if ($ready === 0) {
            usleep(100000); // 100ms 仅用于防止无事件时 CPU 空转。
        } elseif ($ready === -1) {
            usleep(100000); // select 失败时保守退让，再继续推进 cURL。
        }
    }
} while ($stillRunning > 0);

// 释放 multi handle；业务代码还应在 finally 中兜底清理剩余句柄。
curl_multi_close($mh);
?>

这段骨架里，curl_multi_info_read() 要放在每次执行推进之后，并持续读到 false。它返回的是单个传输的完成消息，不能用“当前没有消息”替代 $stillRunning === 0。如果只判断 select 的返回值，最常见的后果是 0 时提前退出，或者 -1 时没有退让导致循环占满 CPU。

返回值、动作和退出条件要分开记录

排查时建议至少记录轮询次数、0 与 -1 的次数、完成句柄数、每个句柄的 cURL result、HTTP 状态以及最后一次 multi 栈错误。这样能区分“服务器响应慢”“没有文件描述符”“句柄没有被移除”和“multi 栈真正失败”。不要用一个总超时掩盖所有原因；可以额外设置业务截止时间，超时后统一取消剩余句柄并留下上下文。

常见问题

返回 0 后需要重新 curl_multi_init 吗？

通常不需要。0 是一次等待结果，保留原来的 multi handle，退让后继续调用 curl_multi_exec() 即可。

返回 -1 时直接退出是否更安全？

不一定。先记录底层环境和句柄数量；如果仍有任务，按固定短暂退让继续推进。只有达到业务截止时间或 multi 栈持续失败时，才按取消策略结束。

为什么 still_running 已经为 0 还要读完成消息？

完成消息需要从消息队列取出，still_running 只反映仍在传输的数量。退出前再排空一次队列，才能拿到每个请求的最终 result。

复查清单

• 0 没有被写成失败，也没有直接成为 break 条件。
• -1 有退让、日志和明确的业务截止时间。
• multi 栈错误、仍运行数量和单请求结果分别落日志。
• 所有完成句柄都读取结果并移除，最后关闭 multi handle。