curl_getinfo

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — Obtiene información relativa a una transferencia específica

Descripción

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

Obtiene información sobre la última transferencia.

Parámetros

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.

Valores devueltos

Si se indica el parámetro, opt, devolverá su valor. De lo contrario, devolverá un array asociativo con los siguientes elementos (que se corresponden a opt), o FALSE en caso de error:

  • "url"
  • "content_type"
  • "http_code"
  • "header_size"
  • "request_size"
  • "filetime"
  • "ssl_verify_result"
  • "redirect_count"
  • "total_time"
  • "namelookup_time"
  • "connect_time"
  • "pretransfer_time"
  • "size_upload"
  • "size_download"
  • "speed_download"
  • "speed_upload"
  • "download_content_length"
  • "upload_content_length"
  • "starttransfer_time"
  • "redirect_time"
  • "certinfo"
  • "request_header" (Solamente está definido si CURLINFO_HEADER_OUT está establecido por una llamada previa a curl_setopt())

Historial de cambios

Versión Descripción
5.1.3 Se introdujo CURLINFO_HEADER_OUT.

Ejemplos

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);
?>

Notas

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.