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_VERIFYPEERSSL証明書検証リクエストの結果を返します

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

更新ログ

オンラインサンプル

<?php
//　CURLハンドルを生成します
$ch　=　curl_init('http://ja.oldtoolbag.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'];
}
//ハンドルを閉じます
curl_close($ch);
?>

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