(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.