curl_getinfo

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

curl_getinfoLee las informaciones detallando una transferencia cURL

Descripción

curl_getinfo(CurlHandle $handle, ?int $option = null): mixed

curl_getinfo() lee las informaciones concernientes al manejador de transferencia handle.

Parámetros

ch

El recurso cURL devuelto por curl_init().

option

Una de las constantes CURLINFO_*.

Valores devueltos

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:

  • "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"
  • "primary_ip"
  • "primary_port"
  • "local_ip"
  • "local_port"
  • "redirect_url"
  • "request_header" (Solo existe si CURLINFO_HEADER_OUT es utilizado mediante una llamada a curl_setopt())
  • "posttransfer_time_us" (Disponible a partir de PHP 8.4.0 y cURL 8.10.0)
Tenga en cuenta que los datos privados no están incluidos en el array asociativo y deben ser recuperados individualmente con la opción CURLINFO_PRIVATE.

Historial de cambios

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.

Ejemplos

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

Notas

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.