(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
curl_getinfo — Ottiene informazioni riguardo ad uno specifico trasferimento
Ottiene informazioni sull'ultimo trasferimento.
ch
Un identificativo cURL restituito da curl_init().
optQuesto 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()
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:
CURLINFO_HEADER_OUT
è stato impostato da una chiamata precedente a curl_setopt())
CURLINFO_PRIVATE.
| 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.
|
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);
?>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.