http_get
http_get — GET リクエストを実行する
説明
string http_get ( [string url [, array options [, array &info]]] )指定した url に対して HTTP GET リクエストを実行します。
二番目のパラメータが設定されている場合、 その連想配列では以下のオプションが使用できます。
表 114. 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 |
表 115. 以下のオプションを指定します
|
パラメータ
- 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_getのページへのリンク