PHP curl_multi_info_read Funktion

PHP Calendar 参考手册PHP cURL-Referenzhandbuch

(PHP 5)

curl_multi_info_read — Ruft die relevanten Transferinformationen des aktuellen cURL ab


Beschreibung

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

Fragt ab, ob das Batch-Handle Nachrichten oder Informationen enthält, die von einzelnen Transfer-Threads zurückgegeben wurden. Nachrichten können Berichte wie Fehlercodes enthalten, die von einzelnen Transfer-Threads zurückgegeben wurden, oder einfach Berichte darüber, ob die Transfer-Threads abgeschlossen wurden.

Wiederholtes Aufrufen dieser Funktion liefert jedes Mal ein neues Ergebnis, bis keine weiteren Informationen mehr zurückgegeben werden können; an diesem Punkt wird FALSE als Signal zurückgegeben. Die über msgs_in_queue zurückgegebene Ganzzahl gibt die Anzahl der Nachrichten an, die nach diesem Funktionsaufruf verbleiben.

Hinweis:Die Daten, auf die die zurückgegebene Ressource zeigt, existieren nach dem Aufruf von curl_multi_remove_handle() nicht mehr.


Parameters

mh

Das von curl_multi_init() zurückgegebene cURL-Multi-Handle.

msgs_in_queue

Die Anzahl der noch in der Warteschlange befindlichen Nachrichten.


Rückgabewerte

Gibt bei Erfolg ein Array mit relevanten Informationen zurück, bei Fehlschlag FALSE.

Inhalt des Rückgabewerts (Inhalt des zurückgegebenen Arrays)

Taste Wert
msg CURLMSG_DONEEine Konstante. Andere Rückgabewerte sind derzeit nicht verfügbar.
result CURLE_*Eine der Konstanten. Wenn alles problemlos funktioniert, wird es zurückgebenCURLE_OKKonstante.
handle Ein cURL-Ressourcentyp, der angibt, auf welches Handle er sich bezieht.

Beispiele

<?php

$urls = array(
   "http://www.baidu.com/",
   "http://www.google.com.hk/",
   "http://www.w3cschool.cc/"
);

$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));

?>

Die Ausgabe des obigen Beispiels ist ähnlich wie:

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)

Änderungsprotokoll

Version Beschreibung
5.2.0 msgs_in_queueHinzugefügt.

PHP Calendar 参考手册PHP cURL-Referenzhandbuch

Andere Erweiterungen