PHP curl_multi_info_read Funktion
(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. |
Andere Erweiterungen
PHP cURL-Referenzhandbuch