(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
curl_getinfo — Obtém informação sobre uma transferência específica
Obtém informação sobre a última transferência.
handle
Um manipulador cURL retornado por curl_init().
option
Uma das constantes CURLINFO_*
.
Se o parâmetro option
for fornecido, retorna seu valor.
Caso contrário, retorna um array associativo com os elementos a seguir
(que correspondem a option
), ou false
em caso de falha:
CURLINFO_HEADER_OUT
for configurada por uma chamada prévia a curl_setopt())
CURLINFO_PRIVATE
.
Versão | Descrição |
---|---|
8.4.0 |
Introduzida a constante CURLINFO_POSTTRANSFER_TIME_T e a chave posttransfer_time_us (Curl 8.10.0 ou posterior).
|
8.3.0 |
Introduzidas as constantes CURLINFO_CAINFO
e CURLINFO_CAPATH .
|
8.2.0 |
Introduzidas as constantes CURLINFO_PROXY_ERROR ,
CURLINFO_REFERER e
CURLINFO_RETRY_AFTER .
|
8.0.0 |
O parâmetro handle agora espera uma instância de CurlHandle;
anteriormente, um resource era esperado.
|
8.0.0 |
option agora pode ser nulo;
anteriormente, o padrão era 0 .
|
7.3.0 |
Introduzidas as opções CURLINFO_CONTENT_LENGTH_DOWNLOAD_T ,
CURLINFO_CONTENT_LENGTH_UPLOAD_T ,
CURLINFO_HTTP_VERSION ,
CURLINFO_PROTOCOL ,
CURLINFO_PROXY_SSL_VERIFYRESULT ,
CURLINFO_SCHEME ,
CURLINFO_SIZE_DOWNLOAD_T ,
CURLINFO_SIZE_UPLOAD_T ,
CURLINFO_SPEED_DOWNLOAD_T ,
CURLINFO_SPEED_UPLOAD_T ,
CURLINFO_APPCONNECT_TIME_T ,
CURLINFO_CONNECT_TIME_T ,
CURLINFO_FILETIME_T ,
CURLINFO_NAMELOOKUP_TIME_T ,
CURLINFO_PRETRANSFER_TIME_T ,
CURLINFO_REDIRECT_TIME_T ,
CURLINFO_STARTTRANSFER_TIME_T e
CURLINFO_TOTAL_TIME_T .
|
Exemplo #1 Exemplo de curl_getinfo()
<?php
// Cria um manipulador cURL
$ch = curl_init('http://www.example.com/');
// Executa
curl_exec($ch);
// Verifica se algum erro ocorreu
if (!curl_errno($ch)) {
$info = curl_getinfo($ch);
echo 'Demorou ', $info['total_time'], ' segundos para enviar uma requisição a ', $info['url'], "\n";
}
// Fecha o manipulador
curl_close($ch);
?>
Exemplo #2 Exemplo de curl_getinfo() com parâmetro option
<?php
// Cria um identificador cURL
$ch = curl_init('http://www.example.com/');
// Executa
curl_exec($ch);
// Verifica o código de estado do HTTP
if (!curl_errno($ch)) {
switch ($http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE)) {
case 200: # OK
break;
default:
echo 'Código HTTP inesperado: ', $http_code, "\n";
}
}
// Fecha o identificador
curl_close($ch);
?>
Nota:
Informações obtidas por esta função são mantidas se o identificador for reutilizado. Isto significa que a menos que uma estatística seja substituída internamente por esta função, a informação anterior é retornada.