Función PHP curl_getinfo

Manual de referencia de PHP cURL

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — Obtiene información sobre un identificador de recurso de conexión cURL

Descripción

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

Obtiene información sobre la última transferencia.

Parámetros

ch

El identificador de cURL devuelto por curl_init().

opt

Este parámetro puede ser una de las siguientes constantes:

• CURLINFO_EFFECTIVE_URL- La última dirección URL válida
• CURLINFO_HTTP_CODE- El último código HTTP recibido
• CURLINFO_FILETIME- El tiempo de obtención remota del documento; si no se puede obtener, el valor devuelto es "-1"
• CURLINFO_TOTAL_TIME- Tiempo total de la última transferencia
• CURLINFO_NAMELOOKUP_TIME- Tiempo de resolución de nombres
• CURLINFO_CONNECT_TIME- Tiempo de establecimiento de conexión
• CURLINFO_PRETRANSFER_TIME- Tiempo empleado desde el establecimiento de la conexión hasta la preparación de la transferencia
• CURLINFO_STARTTRANSFER_TIME- Tiempo empleado desde el establecimiento de la conexión hasta el inicio de la transferencia
• CURLINFO_REDIRECT_TIME- Tiempo de redirección utilizado antes de que comience la transferencia de la transacción
• CURLINFO_SIZE_UPLOAD- Cantidad total de datos subidos
• CURLINFO_SIZE_DOWNLOAD- Cantidad total de datos descargados
• CURLINFO_SPEED_DOWNLOAD- Velocidad media de descarga
• CURLINFO_SPEED_UPLOAD- Velocidad media de subida
• CURLINFO_HEADER_SIZE- Tamaño de la parte del encabezado (header)
• CURLINFO_HEADER_OUT- Cadena de la solicitud enviada
• CURLINFO_REQUEST_SIZE- Tamaño de la solicitud problemática en la solicitud HTTP
• CURLINFO_SSL_VERIFYRESULT- Mediante la configuraciónCURLOPT_SSL_VERIFYPEER- Resultado de la solicitud de verificación del certificado SSL devuelto
• CURLINFO_CONTENT_LENGTH_DOWNLOAD- DesdeContent-Length:- Longitud del contenido descargado leído desde el campo
• CURLINFO_CONTENT_LENGTH_UPLOAD- Descripción del tamaño del contenido subido
• CURLINFO_CONTENT_TYPE- Del contenido descargadoContent-Type:- Valor; NULL indica que el servidor no ha enviado un valor válidoContent-Type: header

Valores de retorno

Si se establece opt, devuelve su valor como cadena. De lo contrario, devuelve un array asociativo que contiene los siguientes elementos (que corresponden respectivamente a opt):

• "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"

Registro de cambios

Ejemplos

<?php
// 创建一个cURL句柄
$ch = curl_init('http://www.yahoo.com/');

// 执行
curl_exec($ch);

// 检查是否有错误发生
if(!curl_errno($ch))
{
 $info = curl_getinfo($ch);

 echo 'Took ' . $info['total_time'] . ' seconds to send a request to ' . $info['url'];
}

// Close handle
curl_close($ch);
?>

Manual de referencia de PHP cURL