curl_getinfo

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

curl_getinfo — Ottiene informazioni riguardo ad uno specifico trasferimento

Descrizione

curl_getinfo(resource $ch, int $opt = 0): mixed

Ottiene informazioni sull'ultimo trasferimento.

Elenco dei parametri

ch

Un identificativo cURL restituito da curl_init().

opt

Questo potrebbe essere una delle seguenti costanti:

CURLINFO_EFFECTIVE_URL - L'ultimo URL effettivo
CURLINFO_HTTP_CODE - L'ultimo codice HTTP ricevuto
CURLINFO_FILETIME - L'orario remoto del documento recuperato, se viene restituito -1 l'orario del documento è sconosciuto
CURLINFO_TOTAL_TIME - Il tempo totale in secondi della transazione per l'ultimo trasferimento
CURLINFO_NAMELOOKUP_TIME - Il tempo in secondi finchè la risoluzione dei nomi non è stata completata
CURLINFO_CONNECT_TIME - Il tempo in secondi impiegato per stabilire la connessione
CURLINFO_PRETRANSFER_TIME - Il tempo in secondi dall'inizio fino a poco prima che il trasferimento del file cominciasse
CURLINFO_STARTTRANSFER_TIME - Il tempo in secondi fino a quando il primo byte è in procinto di essere trasferito
CURLINFO_REDIRECT_COUNT - Il numero dei reindirizzamenti, con l'opzione CURLOPT_FOLLOWLOCATION abilitata
CURLINFO_REDIRECT_TIME - Il tempo in secondi di tutti le fasi di reindirizzamento prima che la transazione finale non venga avviata, con l'opzione CURLOPT_FOLLOWLOCATION abilitata
CURLINFO_REDIRECT_URL - Con l'opzione CURLOPT_FOLLOWLOCATION disabilitata: l'URL di reindirizzamento trovato nell'ultima transazione, che dovrebbe essere richiesto manualmente dopo. Con l'opzione CURLOPT_FOLLOWLOCATION abilitata: questo è vuoto. L'URL di reindirizzamento in questo caso è disponibile in CURLINFO_EFFECTIVE_URL
CURLINFO_PRIMARY_IP - L'indirizzo IP della connessione più recente
CURLINFO_PRIMARY_PORT - La porta di destinazione della connessione più recente
CURLINFO_LOCAL_IP - L'indirizzo IP locale (sorgente) della connessione più recente
CURLINFO_LOCAL_PORT - La porta locale (sorgente) della connessione più recente
CURLINFO_SIZE_UPLOAD - Numero totale di byte caricati (in upload)
CURLINFO_SIZE_DOWNLOAD - Numero totale di byte scaricati
CURLINFO_SPEED_DOWNLOAD - Velocità di download media
CURLINFO_SPEED_UPLOAD - Velocità di upload media
CURLINFO_HEADER_SIZE - Dimensione totale di tutti gli header ricevuti
CURLINFO_HEADER_OUT - La stringa di richiesta inviata. Per farlo funzionare, aggiungere l'opzione CURLINFO_HEADER_OUT al gestore chiamando curl_setopt()
CURLINFO_REQUEST_SIZE - Dimensione totale delle richieste effettuate, attualmente solo per le richieste HTTP
CURLINFO_SSL_VERIFYRESULT - Risultato della verifica del certificato SSL richiesto dall'impostazione CURLOPT_SSL_VERIFYPEER
CURLINFO_CONTENT_LENGTH_DOWNLOAD - dimensione-del-contenuto del download, letto dal campo Content-Length:
CURLINFO_CONTENT_LENGTH_UPLOAD - Dimensione specificata dell'upload
CURLINFO_CONTENT_TYPE - Il Content-Type: del documento richiesto, NULL indica che il server non ha inviato un header Content-Type: valido
CURLINFO_PRIVATE - Dati privati associati con questo gestore cURL, precedentemente impostati con l'opzione CURLOPT_PRIVATE di curl_setopt()

Valori restituiti

Se viene dato opt, viene restituito il suo valore. Altrimenti, restituisce un array associativo con i seguenti elementi (che corrispondono a opt), o false in caso di fallimento:

"url"
"content_type"
"http_code"
"header_size"
"request_size"
"filetime"
"ssl_verify_result"
"redirect_count"
"total_time"
"namelookup_time"
"connect_time"
"pretransfer_time"
"size_upload"
"size_download"
"speed_download"
"speed_upload"
"download_content_length"
"upload_content_length"
"starttransfer_time"
"redirect_time"
"certinfo"
"primary_ip"
"primary_port"
"local_ip"
"local_port"
"redirect_url"
"request_header" (Questo è impostato solo se CURLINFO_HEADER_OUT è stato impostato da una chiamata precedente a curl_setopt())

Notare che i dati privati non sono inclusi nell'array associativo e dovrebbero essere recuperati individualmente con l'opzione CURLINFO_PRIVATE.

Log delle modifiche

Versione Descrizione

5.4.7 Introdotte CURLINFO_PRIMARY_IP, CURLINFO_PRIMARY_PORT, CURLINFO_LOCAL_IP e CURLINFO_LOCAL_PORT.

5.3.7 Introdotto CURLINFO_REDIRECT_URL.

5.2.4 Introdotto CURLINFO_PRIVATE.

5.1.3 Introdotto CURLINFO_HEADER_OUT.

Versione	Descrizione
5.4.7	Introdotte `CURLINFO_PRIMARY_IP`, `CURLINFO_PRIMARY_PORT`, `CURLINFO_LOCAL_IP` e `CURLINFO_LOCAL_PORT`.
5.3.7	Introdotto `CURLINFO_REDIRECT_URL`.
5.2.4	Introdotto `CURLINFO_PRIVATE`.
5.1.3	Introdotto `CURLINFO_HEADER_OUT`.

Esempi

Example #1 Esempio di curl_getinfo()

<?php
// Crea un gestore curl
$ch = curl_init('http://www.yahoo.com/');

// Esegue
curl_exec($ch);

// Controlla se si sono verificati degli errori
if(!curl_errno($ch))
{
 $info = curl_getinfo($ch);

 echo 'Took ' . $info['total_time'] . ' seconds to send a request to ' . $info['url'];
}

// Chiude il gestore
curl_close($ch);
?>

Note

Nota:
Le informazioni raccolte da questa funzione vengono mantenute se il gestore viene riutilizzato. Questo significa che a meno che una statistica non venga sovrascritta internamente da questa funzione, viene restituita l'informazione precedente.