curl_multi_info_read

(PHP 5, PHP 7, PHP 8)

curl_multi_info_read — Ottiene informazioni sui trasferimenti correnti

Descrizione

curl_multi_info_read(CurlMultiHandle $multi_handle, int &$queued_messages = null): array|false

Chiede all'handle multiplo se c'è qualche messaggio o informazione dai trasferimenti individuali. I messaggi possono includere informazioni come un codice di errore dal trasferimento o solo il fatto che il trasferimento è completato.

Chiamate ripetute a questa funzione restituiranno un nuovo risultato ogni volta, finchè non viene restituito un false come segnale che non c'è più nulla da ottenere a quel punto. L'intero a cui punterà queued_messages conterrà il numero dei messaggi rimanenti dopo che questa funzione è stata chiamata.

Avviso

I dati a cui la risorsa restituita punta non sopravviveranno chiamando curl_multi_remove_handle().

Elenco dei parametri

mh: Un identificativo multiplo rstituito da curl_multi_init().
queued_messages: Il numero di messaggi che sono ancora in coda

Valori restituiti

In caso di successo, restituisce un array associativo per il messaggio, false in caso di fallimento.

**Contenuto dell'array restituito**
Chiave:	Valore:
`msg`	La costante `CURLMSG_DONE`. Altri valori restituiti non sono attualmente disponibili.
`result`	Una delle costanti *`CURLE_`. Se tutto è OK, il risultato sarà `CURLE_OK`**.
`handle`	Risorsa di tipo curl indica l'handle a cui è associato.

Log delle modifiche

Versione	Descrizione
8.0.0	`multi_handle` expects a CurlMultiHandle instance now; previously, a resource was expected.

Esempi

Example #1 Un esempio di curl_multi_info_read()

<?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);
    if ($active) {
        curl_multi_select($mh);
    }
    while (false !== ($info = curl_multi_info_read($mh))) {
        var_dump($info);
    }
} while ($active && $status == CURLM_OK);

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

var_dump(curl_multi_info_read($mh));

?>

Il precedente esempio visualizzerà qualcosa simile a:

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)

Vedere anche:

curl_multi_init() - Restituisce un nuovo handle multiplo cURL

add a note

User Contributed Notes 1 note

down

-1

Nick Smith ¶

14 years ago


Just to let others who might be struggling to get it to work, curl_multi_info_read() doesn't work in PHP versions before 5.2.0, and instead returns NULL immediately.

add a note