PHP curl_getinfo関数

PHP cURLリファレンスマニュアル

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — cURL接続リソースハンドルの情報を取得する

説明

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

最後の転送に関する情報を取得します。

パラメータ

ch

curl_init() が返す cURL ハンドル。

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:- field 内から読み取ったダウンロードコンテンツの長さ
• CURLINFO_CONTENT_LENGTH_UPLOAD- アップロードコンテンツのサイズの説明
• CURLINFO_CONTENT_TYPE- ダウンロードコンテンツのContent-Type:- Content-Type 値。NULLは、サーバーが有効な Content-Type を送信しなかったことを示します。Content-Type: header

戻り値

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"

更新履歴

例

<?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 cURLリファレンスマニュアル