php 한글 메뉴얼 도움말 검색 사이트 Get information about the current transfers [function.curl-multi-info-read]

설명

array curl_multi_info_read ( resource $mh [, int &$msgs_in_queue = NULL ] )

Ask the multi handle if there are any messages or information from the individual transfers. Messages may include information such as an error code from the transfer or just the fact that a transfer is completed.

Repeated calls to this function will return a new result each time, until a FALSE is returned as a signal that there is no more to get at this point. The integer pointed to with msgs_in_queue will contain the number of remaining messages after this function was called.

Warning

The data the returned resource points to will not survive calling curl_multi_remove_handle().

인수

mh: curl_multi_init()가 반환한 curl 다중 핸들입니다.
msgs_in_queue: Number of messages that are still in the queue

반환값

On success, returns an associative array for the message, FALSE on failure.

**Contents of the returned array**
Key:	Value:
msg	The `CURLMSG_DONE` constant. Other return values are currently not available.
result	One of the *`CURLE_` constants. If everything is OK, the `CURLE_OK`** will be the result.
handle	Resource of type curl indicates the handle which it concerns.

예제

Example #1 A curl_multi_info_read() example


<?php

$urls = array(
   "http://www.cnn.com/",
   "http://www.bbc.co.uk/",
   "http://www.yahoo.com/"
);

$mh = curl_multi_init();

foreach ($urls as $i => $url) {
    $conn[$i] = curl_init($url);
    curl_setopt($conn[$i], CURLOPT_RETURNTRANSFER, 1);
    curl_multi_add_handle($mh, $conn[$i]);
}

do {
    $status = curl_multi_exec($mh, $active);
    $info = curl_multi_info_read($mh);
    if (false !== $info) {
        var_dump($info);
    }
} while ($status === CURLM_CALL_MULTI_PERFORM || $active);

foreach ($urls as $i => $url) {
    $res[$i] = curl_multi_getcontent($conn[$i]);
    curl_close($conn[$i]);
}

var_dump(curl_multi_info_read($mh));

?>

위 예제의 출력 예시:

array(3) {
  ["msg"]=>
  int(1)
  ["result"]=>
  int(0)
  ["handle"]=>
  resource(5) of type (curl)
}
array(3) {
  ["msg"]=>
  int(1)
  ["result"]=>
  int(0)
  ["handle"]=>
  resource(7) of type (curl)
}
array(3) {
  ["msg"]=>
  int(1)
  ["result"]=>
  int(0)
  ["handle"]=>
  resource(6) of type (curl)
}
bool(false)

변경점

버전	설명
5.2.0	`msgs_in_queue` was added.

참고

curl_multi_init() - Returns a new cURL multi handle