(PHP 4 >= 4.0.4, PHP 5)
curl_getinfo — Obtiene información relativa a una transferencia específica
Obtiene información sobre la última transferencia.
ch
El recurso cURL devuelto por curl_init().
opt
Podría ser una de las siguientes constantes:
CURLINFO_EFFECTIVE_URL - Último URL efectivo
CURLINFO_HTTP_CODE - Último código HTTP recibido
CURLINFO_FILETIME - Hora del documento remoto obtenido, si devuelve -1, la hora del documento es desconocida
CURLINFO_TOTAL_TIME - Duración total en segundos de última transaferencia
CURLINFO_NAMELOOKUP_TIME - Tiempo en segundos en resolver el nombre
CURLINFO_CONNECT_TIME - Tiempo en segundos que tomó el establecimiento de la conexión
CURLINFO_PRETRANSFER_TIME - Tiempo en segundos desde el inicio hasta justo antes de que comience la transferencia del fichero
CURLINFO_STARTTRANSFER_TIME - Tiempo en sengudos hasta que el primer byte está a punto de transferirse
CURLINFO_REDIRECT_COUNT - Número de redireccionamientos
CURLINFO_REDIRECT_TIME - Tiempo en segundos de todos los pasos de redireción antes de que la última transación haya empezado
CURLINFO_SIZE_UPLOAD - Número total de bytes subidos
CURLINFO_SIZE_DOWNLOAD - Número total de bytes descargados
CURLINFO_SPEED_DOWNLOAD - Velocidad media de descarga
CURLINFO_SPEED_UPLOAD - Velocidad media de subida
CURLINFO_HEADER_SIZE - Tamaño total de los encabezados recibidos
CURLINFO_HEADER_OUT - El string de la petición enviada. Para que
funcione, se ha de añadir la opción CURLINFO_HEADER_OUT al gestor, llamando
a curl_setopt()
CURLINFO_REQUEST_SIZE - Tamaño total de las peticiones realizadas, actualmente solo para peticiones HTTP
CURLINFO_SSL_VERIFYRESULT - Resultado de la verificación del certificado SSL solicitado por la opción CURLOPT_SSL_VERIFYPEER
CURLINFO_CONTENT_LENGTH_DOWNLOAD - Logitud del contenido de la descarga, leída desde el campo Content-Length:
CURLINFO_CONTENT_LENGTH_UPLOAD - Tamaño especificado de subida
CURLINFO_CONTENT_TYPE - Content-Type: del documento solicitado, NULL indica que el servidor no envío un encabezado Content-Type: válido.
Si se indica el parámetro, opt, devolverá su valor como un string.
De lo contrario, devolverá un array asociativo con los siguientes elementos
(que se corresponden a opt), o FALSE en caso de error:
CURLINFO_HEADER_OUT
está establecido por una llamada previa a curl_setopt())
| Versión | Descripción |
|---|---|
| 5.1.3 |
Se introdujo CURLINFO_HEADER_OUT.
|
Ejemplo #1 Ejemplo de curl_getinfo()
<?php
// Crear un gestor curl
$ch = curl_init('http://www.yahoo.com/');
// Ejecutar
curl_exec($ch);
// Comprobar si ocurrió un error
if(!curl_errno($ch))
{
$info = curl_getinfo($ch);
echo 'Se tardó ' . $info['total_time'] . ' segundos en enviar la petición a ' . $info['url'];
}
// Cerrar manipulador
curl_close($ch);
?>
Nota:
La información obtenida por esta función se mantiene si se reutiliza el gestor. Esto significa que, a no ser que una estadística sea sobrescrita internamente por esta función, se devolverá la información previa.