Функция PHP curl_getinfo
Справочное руководство по 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);
?>
Другие расширения