本文是PHP and curl_multi_exec的翻译
这篇文章阐述了如何从curl_multi
句柄获取数据。不久前,我将这段代码片段贴到了一个更大的示例代码中:
<?php
$active = NULL;
do {
$ret = curl_multi_exec($multi, $active);
} while ($ret == CURLM_CALL_MULTI_PERFORM);
while ($active && $ret == CURLM_OK) {
if (curl_multi_select($multi) != -1) {
do {
$mrc = curl_multi_exec($multi, $active);
} while ($mrc == CURLM_CALL_MULTI_PERFORM);
}
}
?>
我之前没有真的去查过文档试图理解过它。所以这段代码让我感到困惑。现在我来解释下它都做了什么。
首先,这里有两个外层的循环。第一个负责清除curl缓存。第二个负责等待更多的数据,并且获取到这些数据。这就是一个典型的阻塞I/O例子。我们阻塞住剩下程序的执行直到网络I/O的结束。尽管这不是处理网络I/O最合适的方法,但对于单进程、同步的PHP,这实际上是我们仅有的选择。
让我们先来看下第一层循环:
<?php
$active = NULL;
do {
$ret = curl_multi_exec($multi, $active);
} while ($ret == CURLM_CALL_MULTI_PERFORM);
?>
curl_multi_exec
尝试从multi句柄中获取写数据。$multi
是之前调用curl_multi_init()
方法产生的句柄,$active
和$ret
都是整型的值。
curl_multi_exec()
把$active
设为正在处理的句柄个数。换句话说,如果你正在用这个句柄请求5个URL,那么curl_multi_exec
将返回5当它正在处理所有的5个URL(应该是指curl_multi_exec
设$active
为5),然后当每个请求结束时,这个数字将会逐渐减少直到0。
$ret
是如下值的一种:
-
CURLM_CALL_MULTI_PERFORM
(-1):这意味着你需要再次调用curl_multi_exec()
,因为仍有数据可供处理。 -
CURLM_OK
(0):如文档中所说:“都好了”。这意味着可能有更多的数据,但还没有到呢。 - 错误码中的一个:
CURLM_BAD_HANDLE
,CURLM_OUT_OF_MEMORY
,CURLM_INTERNAL_ERROR
,CURLM_BAD_SOCKET
。所有这些表明我们需要停止处理。
所以当我们正在执行第一层循环,唯一需要我们继续迭代的情况就是CURLM_CALL_MULTI_PERFORM
。
现在,对于一些相当小的情况,第一层循环就是你所需要的。然而通常的情况是,第一层循环会返回CURL_OK
来表明还会有更多的数据,但是这些数据还没有在网络上传输过来呢。
我们需要wait。
这时候我们就需要第二层循环:
<?php
while ($active && $ret == CURLM_OK) {
if (curl_multi_select($multi) != -1) {
do {
$mrc = curl_multi_exec($multi, $active);
} while ($mrc == CURLM_CALL_MULTI_PERFORM);
}
}
?>
这层循环是说...
(while): 只要有活跃的连接,一切还看着都OK…
(if) 如果网络socket还有些数据…
(do/while) 只要系统告诉我们要一直去获取数据,我们就处理吧
所以第二层循环负责检查套接字直到一切就绪。
PHP手册对这些东西的细节有稍微的介绍,但是libcurl C的文档更加的完整。