http_get

PHP関数リファレンス

http_get

(PECL)
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. 以下のオプションを指定します 名前 型 説明 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 を返します。