Функция PHP curl_getinfo

PHP Calendar 参考手册Справочное руководство по PHP cURL

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — Получение информации о дескрипторе ресурса соединения cURL


Описание

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

Получает информацию о последней передаче.


Parameters

ch

Дескриптор cURL, возвращаемый curl_init().

opt

Этот параметр может быть одной из следующих констант:

  • CURLINFO_EFFECTIVE_URL- Последний действительный URL-адрес
  • CURLINFO_HTTP_CODE- Последний полученный HTTP-код
  • CURLINFO_FILETIME- Время получения удалённого документа; возвращает "-1", если его не удаётся получить
  • CURLINFO_TOTAL_TIME- Время, затраченное на последнюю передачу
  • CURLINFO_NAMELOOKUP_TIME- Время, затраченное на разрешение имени
  • CURLINFO_CONNECT_TIME- Время, затраченное на установку соединения
  • CURLINFO_PRETRANSFER_TIME- Время, затраченное от установки соединения до подготовки к передаче
  • CURLINFO_STARTTRANSFER_TIME- Время, затраченное от установки соединения до начала передачи
  • CURLINFO_REDIRECT_TIME- Время, затраченное на перенаправления до начала передачи
  • CURLINFO_SIZE_UPLOAD- Общий объем отправленных данных
  • CURLINFO_SIZE_DOWNLOAD- Общий объем скачанных данных
  • CURLINFO_SPEED_DOWNLOAD- Средняя скорость скачивания
  • CURLINFO_SPEED_UPLOAD- Средняя скорость отправки
  • CURLINFO_HEADER_SIZE- Размер части заголовка
  • CURLINFO_HEADER_OUT- Строка отправленного запроса
  • CURLINFO_REQUEST_SIZE- Размер проблемного запроса в HTTP-запросе
  • CURLINFO_SSL_VERIFYRESULT- При установкеCURLOPT_SSL_VERIFYPEER- Возвращаемый результат запроса проверки SSL-сертификата
  • CURLINFO_CONTENT_LENGTH_DOWNLOAD- Из поляContent-Length:- Длина скачиваемого содержимого, прочитанная из поля
  • CURLINFO_CONTENT_LENGTH_UPLOAD- Описание размера загружаемого содержимого
  • CURLINFO_CONTENT_TYPE- ЗначениеContent-Type:- для скачанного содержимого; NULL означает, что сервер не отправил допустимыйContent-Type: заголовок

Возвращаемые значения

Если opt задан, возвращает его значение в виде строки. В противном случае возвращает ассоциативный массив, содержащий следующие элементы (которые соответствуют 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"

История изменений

Version Описание
5.1.3 ВведеноCURLINFO_HEADER_OUT.

Примеры

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

PHP Calendar 参考手册Справочное руководство по PHP cURL

Другие расширения