PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    curl_getinfo

    (PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

    curl_getinfo — 指定した伝送に関する情報を得る

    説明

    curl_getinfo(CurlHandle $handle, ?int $option = null): mixed

    直近の転送に関する情報を取得します。

    パラメータ

    handle

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

    option

    CURLINFO_* 定数のうち、ひとつを指定できます。

    戻り値

    option を指定した場合は、その値を返します。 それ以外の場合は、以下の要素をもつ連想配列を返します (それぞれの要素が option に対応します)。 失敗した場合は false を返します。

    • "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"
    • "certinfo"
    • "primary_ip"
    • "primary_port"
    • "local_ip"
    • "local_port"
    • "redirect_url"
    • "request_header" (これが設定されるのは、事前に curl_setopt() をコールしたときに CURLINFO_HEADER_OUT を設定した場合のみです)
    プライベートデータはこの連想配列には含まれず、CURLINFO_PRIVATE オプションで個別に取得しなければいけないことに注意しましょう。

    変更履歴

    バージョン 説明
    8.3.0 CURLINFO_CAINFO と CURLINFO_CAPATH が追加されました。
    8.2.0 CURLINFO_PROXY_ERROR, CURLINFO_REFERER, CURLINFO_RETRY_AFTER が追加されました。
    8.0.0 handle は CurlHandle クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource を期待していました。
    8.0.0 option は nullable になりました。 これより前のバージョンでは、デフォルト値は 0 でした。
    7.3.0 CURLINFO_CONTENT_LENGTH_DOWNLOAD_T, CURLINFO_CONTENT_LENGTH_UPLOAD_T, CURLINFO_HTTP_VERSION, CURLINFO_PROTOCOL, CURLINFO_PROXY_SSL_VERIFYRESULT, CURLINFO_SCHEME, CURLINFO_SIZE_DOWNLOAD_T, CURLINFO_SIZE_UPLOAD_T, CURLINFO_SPEED_DOWNLOAD_T, CURLINFO_SPEED_UPLOAD_T, CURLINFO_APPCONNECT_TIME_T, CURLINFO_CONNECT_TIME_T, CURLINFO_FILETIME_T, CURLINFO_NAMELOOKUP_TIME_T, CURLINFO_PRETRANSFER_TIME_T, CURLINFO_REDIRECT_TIME_T, CURLINFO_STARTTRANSFER_TIME_T, CURLINFO_TOTAL_TIME_T が追加されました。

    例

    例1 curl_getinfo() の例

    <?php
    // cURL ハンドルを作成します
    $ch = curl_init('http://www.example.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'], "\n";
    }

    // ハンドルを閉じます
    curl_close($ch);
    ?>

    例2 curl_getinfo() で option パラメータを使う例

    <?php
    // cURL ハンドルを作成します
    $ch = curl_init('http://www.example.com/');

    // 実行します
    curl_exec($ch);

    // HTTP ステータスコードを調べます
    if (!curl_errno($ch)) {
    switch (    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE)) {
    case     200: # OK
    break;
    default:
    echo     'Unexpected HTTP code: ', $http_code, "\n";
    }
    }

    // ハンドルを閉じます
    curl_close($ch);
    ?>

    注意

    注意:

    この関数で収集した情報を、ハンドルを再利用するとそのまま保持されます。 つまり、この関数で内部的に統計情報を上書きしない限りは以前の情報が返されるということです。

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 15 notes

    up
    58
    ssttoo at hotmail dot com
    20 years ago
    Here are the response codes ready for pasting in an ini-style file. Can be used to provide more descriptive message, corresponding to 'http_code' index of the arrray returned by curl_getinfo().
    These are taken from the W3 consortium HTTP/1.1: Status Code Definitions, found at
    http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

    [Informational 1xx]
    100="Continue"
    101="Switching Protocols"

    [Successful 2xx]
    200="OK"
    201="Created"
    202="Accepted"
    203="Non-Authoritative Information"
    204="No Content"
    205="Reset Content"
    206="Partial Content"

    [Redirection 3xx]
    300="Multiple Choices"
    301="Moved Permanently"
    302="Found"
    303="See Other"
    304="Not Modified"
    305="Use Proxy"
    306="(Unused)"
    307="Temporary Redirect"

    [Client Error 4xx]
    400="Bad Request"
    401="Unauthorized"
    402="Payment Required"
    403="Forbidden"
    404="Not Found"
    405="Method Not Allowed"
    406="Not Acceptable"
    407="Proxy Authentication Required"
    408="Request Timeout"
    409="Conflict"
    410="Gone"
    411="Length Required"
    412="Precondition Failed"
    413="Request Entity Too Large"
    414="Request-URI Too Long"
    415="Unsupported Media Type"
    416="Requested Range Not Satisfiable"
    417="Expectation Failed"

    [Server Error 5xx]
    500="Internal Server Error"
    501="Not Implemented"
    502="Bad Gateway"
    503="Service Unavailable"
    504="Gateway Timeout"
    505="HTTP Version Not Supported"

    And an example usage:
    <?php
    $ch     = curl_init(); // create cURL handle (ch)
    if (!$ch) {
    die(    "Couldn't initialize a cURL handle");
    }
    // set some cURL options
    $ret = curl_setopt($ch, CURLOPT_URL, "http://mail.yahoo.com");
    $ret = curl_setopt($ch, CURLOPT_HEADER, 1);
    $ret = curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
    $ret = curl_setopt($ch, CURLOPT_RETURNTRANSFER, 0);
    $ret = curl_setopt($ch, CURLOPT_TIMEOUT, 30);

    // execute
    $ret = curl_exec($ch);

    if (empty(    $ret)) {
    // some kind of an error happened
    die(curl_error($ch));
    curl_close($ch); // close cURL handler
    } else {
    $info = curl_getinfo($ch);
    curl_close($ch); // close cURL handler

    if (empty($info['http_code'])) {
    die(    "No HTTP code was returned");
    } else {
    // load the HTTP codes
    $http_codes = parse_ini_file("path/to/the/ini/file/I/pasted/above");

    // echo results
    echo "The server responded: <br />";
    echo     $info['http_code'] . " " . $http_codes[$info['http_code']];
    }

    }
    ?>
    up
    23
    vince
    14 years ago
    CURLINFO_HTTP_CODE does not return a string, as the docs say, but rather an integer.

    <?php
    $c     = curl_init('http://www.example.com/');
    if(    curl_getinfo($c, CURLINFO_HTTP_CODE) === '200') echo "CURLINFO_HTTP_CODE returns a string.";
    if(    curl_getinfo($c, CURLINFO_HTTP_CODE) === 200) echo "CURLINFO_HTTP_CODE returns an integer.";
    curl_close($c);
    ?>

    returns

    "CURLINFO_HTTP_CODE returns an integer."
    up
    7
    public-mail at alekciy dot ru
    9 years ago
    Note, header_size include "\r\n\r\n". So if you use CURLOPT_FOLLOWLOCATION>0, CURLOPT_HEADER=true, CURLOPT_RETURNTRANSFER=true right way splite header/body:

    $response = curl_exec($ch);
    $curl_info = curl_getinfo($ch);
    curl_close($ch);
    $header_size = $curl_info['header_size'];
    $header = substr($response, 0, $header_size);
    $body = substr($response, $header_size);
    up
    15
    nikita dot bulatenko at gmail dot com
    11 years ago
    CURLINFO_SSL_VERIFYRESULT error codes:
    0: ok the operation was successful.
    2 : unable to get issuer certificate
    3: unable to get certificate CRL
    4: unable to decrypt certificate's signature
    5: unable to decrypt CRL's signature
    6: unable to decode issuer public key
    7: certificate signature failure
    8: CRL signature failure
    9: certificate is not yet valid
    10: certificate has expired
    11: CRL is not yet valid
    12:CRL has expired
    13: format error in certificate's notBefore field
    14: format error in certificate's notAfter field
    15: format error in CRL's lastUpdate field
    16: format error in CRL's nextUpdate field
    17: out of memory
    18: self signed certificate
    19: self signed certificate in certificate chain
    20: unable to get local issuer certificate
    21:unable to verify the first certificate
    22: certificate chain too long
    23: certificate revoked
    24: invalid CA certificate
    25: path length constraint exceeded
    26: unsupported certificate purpose
    27: certificate not trusted
    28: certificate rejected
    29: subject issuer mismatch
    30: authority and subject key identifier mismatch
    31: authority and issuer serial number mismatch
    32: key usage does not include certificate signing
    50: application verification failure
    details at http://www.openssl.org/docs/apps/verify.html#VERIFY_OPERATION
    up
    5
    qrworld.net
    10 years ago
    Here you have a function that I use to get the content of a URL using cURL. This uses curl_getinfo to know if it is a regular URL or maybe a redirection.

    I hope it would be useful for you:

    function getUrlContent($url){
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; .NET CLR 1.1.4322)');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
    curl_setopt($ch, CURLOPT_TIMEOUT, 5);
    $data = curl_exec($ch);
    $httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return ($httpcode>=200 && $httpcode<300) ? $data : false;
    }

    The source comes from this website:

    http://softontherocks.blogspot.com/2014/11/descargar-el-contenido-de-una-url.html
    up
    7
    nemetral
    16 years ago
    Just a quick note: if you want to use curl_getinfo() with option CURLINFO_HEADER_OUT in order to debug your cURL request, you must add curl_setopt($handle, CURLINFO_HEADER_OUT, true); first while specifying the options.
    up
    3
    bg at enativ dot com
    10 years ago
    curl_getinfo($ch) will also return 'redirect_url' if there is one (even if CURLOPT_FOLLOWLOCATION set to false).
    I don't know why it's not in the doc..
    up