PHP マニュアル
前のページ |  | 次のページ

# http_get

(PECL)

http_get -- GET リクエストを実行する

## 説明

string http_get ( [string url [, array options [, array &info]]] )

指定した url に対して HTTP GET リクエストを実行します。

二番目のパラメータが設定されている場合、 その連想配列では以下のオプションが使用できます。

表 1. HTTP リクエストオプション

名前 | 型 | 説明
--- | --- | ---
redirect | int | リダイレクトを何段階まで追いかけるか。
unrestrictedauth | bool | 異なるホストへのリダイレクトの際に認証情報を送り続けるかどうか。
proxyhost | string | "host[:port]" 形式で指定するプロキシホスト。
proxyport | int | proxyhost で指定したものとは異なるプロキシポートを指定します。
proxytype | int | `HTTP_PROXY_HTTP`、`HTTP_PROXY_SOCKS4` あるいは `HTTP_PROXY_SOCKS5`。
proxyauth | string | "user:pass" 形式のプロキシ認証情報。
proxyauthtype | int | `HTTP_AUTH_BASIC` あるいは `HTTP_AUTH_NTLM`。
httpauth | string | "user:pass" 形式の http 認証情報。
httpauthtype | int | `HTTP_AUTH_BASIC`、`HTTP_AUTH_DIGEST` あるいは `HTTP_AUTH_NTLM`。
compress | bool | gzip/deflate エンコーディングを許可するかどうか。
port | int | url で指定したものとは別のポートを使用します。
referer | string | 送信するリファラ。
useragent | string | 送信するユーザエージェント (デフォルトは PECL::HTTP/version (PHP/version))。
headers | array | 独自のヘッダの一覧を array("header" => "value") 形式の連想配列で指定します。
cookies | array | クッキーの一覧を array("cookie" => "value") 形式の連想配列で指定します。
encodecookies | bool | クッキーを urlencode するかどうか (デフォルト: true)。
cookiestore | string | クッキーを保存するファイルへのパス。
cookiesession | bool | TRUE にすると、cookiestore からセッションクッキーを読み込みません。
resume | int | ダウンロードを開始するバイトオフセット。サーバが range をサポートしている場合に使用します。
range | array | 配列の配列で、中にはふたつの整数値が含まれ、ダウンロードする範囲を指定します。サーバがサポートしている場合にのみ有効で、resume が設定されていない場合にのみ使用されます。
maxfilesize | int | ダウンロードするファイルサイズの最大値。リクエストされたエンティティのサイズがどうであるかには影響を及ぼしません。
lastmodified | int | If-(Un)Modified-Since ヘッダ用のタイムスタンプ。
etag | string | If-(None-)Match ヘッダ用の、クォートされた文字列。
timeout | int | リクエストが受け取る秒数。
connecttimeout | int | 接続が受け取る秒数。
onprogress | mixed | 進捗状況のコールバック。
interface | string | 送り出すネットワークインターフェイス (インターフェイス名、IP あるいはホスト名)。
portrange | array | 送信を試みるポートの範囲を、ふたつの整数で指定します。

ssl

array

表 2. 以下のオプションを指定します

名前 | 型 | 説明
cert | string | 証明書へのパス。
certtype | string | 証明書の型。
certpasswd | string | 証明書のパスワード。
key | string | キーへのパス。
keytype | string | キーの型。
keypasswd | string | キーのパスワード。
engine | string | 使用する ssl エンジン。
version | int | 使用する ssl のバージョン。
verifypeer | bool | 相手を検証するかどうか。
verifyhost | bool | ホストを検証するかどうか。
cipher_list | string | 使用できる暗号の一覧。
cainfo | string |
capath | string |
random_file | string |
egdsocket | string |

## パラメータ

`url`

  URL。

`options`

  HTTP リクエストオプション。

`info`

  リクエスト/レスポンスの情報が格納されます。

      array (
        'effective_url' => 'http://www.example.com/',
        'response_code' => 302,
        'connect_code' => 0,
        'filetime' => -1,
        'total_time' => 0.212348,
        'namelookup_time' => 0.038296,
        'connect_time' => 0.104144,
        'pretransfer_time' => 0.104307,
        'starttransfer_time' => 0.212077,
        'redirect_time' => 0,
        'redirect_count' => 0,
        'size_upload' => 0,
        'size_download' => 218,
        'speed_download' => 1026,
        'speed_upload' => 0,
        'header_size' => 307,
        'request_size' => 103,
        'ssl_verifyresult' => 0,
        'ssl_engines' =>
        array (
          0 => 'dynamic',
          1 => 'cswift',
          2 => 'chil',
          3 => 'atalla',
          4 => 'nuron',
          5 => 'ubsec',
          6 => 'aep',
          7 => 'sureware',
          8 => '4758cca',
        ),
        'content_length_download' => 218,
        'content_length_upload' => 0,
        'content_type' => 'text/html',
        'httpauth_avail' => 0,
        'proxyauth_avail' => 0,
        'num_connects' => 1,
        'os_errno' => 0,
        'error' => '',
      )

## 返り値

成功した場合は HTTP レスポンスを文字列で、失敗した場合は FALSE を返します。

前のページ | ホーム | 次のページ
http_parse_params | 上に戻る | http_head