php 异步curl实战教程：从入门到精通看这篇！

发布日期： 2025-09-26 阅读量： 作者： admin

最近手头有个活儿，需要同时请求好几个外部接口拿数据。我就是老老实实地用 PHP 的 cURL 一个一个去请求，写了个循环，第一个请求完了再请求第二个，以此类推。跑起来倒也没啥大问题，就是慢，特别慢。你想，要是每个接口都要等个一两秒，那七八个接口下来，用户就得等十几秒甚至更久，这体验肯定不行。

我就琢磨着，这不能同步等着，得想办法让这些请求一块儿跑起来，谁先回来就先处理谁的数据。以前也模模糊糊听过 PHP 好像有个啥 `curl_multi` 的东西，能搞定这事儿，就去翻了翻手册，又搜了点资料。

开始动手搞异步 cURL

决定了就开干。主要思路就是用 PHP 提供的那一套 `curl_multi_` 函数。

第一步，初始化一个“大总管”。

这个“大总管”就是 `curl_multi_init()`，它负责管理后面所有单个的 cURL 请求。代码大概就是 `$mh = curl_multi_init();` 这样，简单。

第二步，准备一堆“小兵”。

就是要请求多少个接口，就得准备多少个普通的 cURL 句柄。我搞了个数组，循环遍历我要请求的那些 URL 地址：

在循环里，用 `curl_init()` 创建一个普通的 cURL 句柄，比如 `$ch = curl_init();`。
然后就是设置这个小兵要去哪儿、干什么，用 `curl_setopt()` 设置 URL、请求方式（GET 还是 POST）、要不要返回结果而不是直接输出、超时时间等等。这些跟平时用单个 cURL 没啥区别。
关键一步，把这个设置好的“小兵” `$ch` 扔给“大总管” `$mh` 管理，用的是 `curl_multi_add_handle($mh, $ch);`。
为了后面方便取结果，我还把每个 `$ch` 存到了一个数组里，类似 `$handles[(int)$ch] = $ch;`，用句柄的整数值做键名，这样不容易混。

第三步，让“大总管”带着“小兵”们出发。

这是核心环节。得用一个循环来不断执行这些请求，直到所有请求都完成。

我先用 `curl_multi_exec($mh, $active);` 启动一下。这个 `$active` 参数会被 `curl_multi_exec` 函数更新，表示当前还有多少个请求在跑着。

然后就搞个 `while ($active > 0)` 循环。只要还有请求在跑，循环就继续。

在 `while` 循环里面：

先调用 `curl_multi_select($mh);`。这个函数挺有意思，它会等着，直到某个 cURL 请求有活动（比如完成了，或者出错了），或者等到超时。这样可以避免 CPU 空转，挺
然后，再次调用 `curl_multi_exec($mh, $active);`。这回调用是为了处理刚才 `curl_multi_select` 等到的那个活动，并且继续执行其他还在跑的请求，同时更新 `$active` 的值。
就得检查是不是有哪个“小兵”跑完了。用 `curl_multi_info_read($mh)` 这个函数。它会告诉你哪个请求完成了，以及结果是我通常会再加个 `while ($info = curl_multi_info_read($mh))` 的小循环，因为一次 `curl_multi_exec` 调用后可能不止一个请求完成了。
在小循环里拿到完成信息 `$info` 后，就能通过 `$info['handle']` 知道是哪个句柄完成了。
用 `curl_multi_getcontent($info['handle'])` 就能拿到这个请求返回的具体内容了。这时候就可以处理数据了，比如存到数据库，或者放到结果数组里。
别忘了！ 处理完一个请求后，得把它从“大总管”那里移除，用 `curl_multi_remove_handle($mh, $info['handle']);`。
也得把这个单独的 cURL 句柄关掉，`curl_close($info['handle']);`。
还得把这个句柄从我之前存句柄的那个数组里删掉，`unset($handles[(int)$info['handle']]);`，保持干净。

第四步，收尾工作。

等最外面的 `while ($active > 0)` 循环结束了，说明所有请求都跑完了。把“大总管”也关掉，`curl_multi_close($mh);`。齐活儿！

整个过程跑下来，确实比之前同步请求快了太多了，效果很明显。不过中间也遇到点小问题。

错误处理： 单个 cURL 请求可能会失败，比如超时、目标地址不通。用 `curl_multi_info_read` 返回的 `$info['result']` 可以判断状态码，不是 `CURLE_OK` 就说明有错了。得单独处理这些失败的请求，不能因为一个挂了就全停了。
结果对应： 因为是异步的，返回结果的顺序跟发起请求的顺序不一定一样。在发起请求时就得想好怎么把返回结果跟对应的请求关联起来。我用的是把句柄存到数组里，完成时通过句柄找回信息，这才没搞混。
`curl_multi_select` 的作用： 一开始没加 `curl_multi_select`，直接在 `while` 里循环 `curl_multi_exec`，发现 CPU 占用有点高。加上 `curl_multi_select` 后就好了很多，它能让程序在没啥事干的时候歇会儿。

折腾完这一套，原来需要十几秒甚至几十秒才能完成的任务，现在基本上就取决于最慢的那个接口需要多少时间了，通常几秒内就能搞定所有请求。页面响应速度大大提升，用户体验好了不少。

虽然 `curl_multi_` 这套东西写起来比单个 cURL 稍微复杂点，多了些管理句柄、循环检查状态的步骤，但对于需要并发执行多个 HTTP 请求的场景来说，效果是实打实的，非常值得投入时间去搞定它。这回实践下来，感觉对 PHP 处理并发请求的能力又有了新的认识。