cURL Funzioni
PHP Manual

curl_getinfo

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — Ottiene informazioni riguardo ad uno specifico trasferimento

Descrizione

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

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
  • CURLINFO_REDIRECT_TIME - Il tempo in secondi di tutti le fasi di reindirizzamento prima che la transazione finale non venga avviata
  • 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

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:

Log delle modifiche

Versione Descrizione
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.

cURL Funzioni
PHP Manual