(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
curl_getinfo — Lee las informaciones detallando una transferencia cURL
curl_getinfo() lee las informaciones
concernientes al manejador de transferencia handle
.
Si option
es proporcionado, el valor será devuelto.
De lo contrario, será un array asociativo conteniendo los siguientes elementos
(que corresponden a option
), o false
si ocurre un error:
CURLINFO_HEADER_OUT
es utilizado mediante una llamada a curl_setopt())
CURLINFO_PRIVATE
.
Versión | Descripción |
---|---|
8.4.0 |
Introducción de la constante CURLINFO_POSTTRANSFER_TIME_T y de posttransfer_time_us (cURL 8.10.0 o versión posterior).
|
8.3.0 |
Introdujo CURLINFO_CAINFO
y CURLINFO_CAPATH .
|
8.2.0 |
Introducción de las nuevas constantes CURLINFO_PROXY_ERROR ,
CURLINFO_REFERER ,
CURLINFO_RETRY_AFTER .
|
8.0.0 |
handle expects a CurlHandle
instance now; previously, a resource was expected.
|
8.0.0 |
option ahora es nullable;
anteriormente, el valor por omisión era 0 .
|
7.3.0 |
Añadido 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 ,
CURLINFO_TOTAL_TIME_T .
|
Ejemplo #1 Ejemplo con curl_getinfo()
<?php
// Creación de un manejador cURL
$ch = curl_init('http://www.example.com/');
// Ejecución
curl_exec($ch);
// Verificación si ocurrió un error
if(!curl_errno($ch))
{
$info = curl_getinfo($ch);
echo 'La petición tardó ' . $info['total_time'] . ' segundos en ser enviada a ' . $info['url'];
}
// Cierre del manejador
curl_close($ch);
?>
Ejemplo #2 Ejemplo de curl_getinfo() con el parámetro option
<?php
// Creación de un manejador cURL
$ch = curl_init('http://www.example.com/');
// Ejecución
curl_exec($ch);
// Verificación del código de estado 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";
}
}
// Cierre del manejador
curl_close($ch);
?>
Nota:
Las informaciones proporcionadas por esta función se conservan si la conexión es reutilizada. Los datos previamente utilizados son por lo tanto devueltos a menos que sean sobrescritos internamente entre tanto.