PHP ��U
前一頁 |  | 下一頁

# http_get

(PECL)

http_get -- Perform GET request

## Description

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

Performs an HTTP GET request on the supplied url.

The second parameter, if set, is expected to be an associative array where the following options will be recognized:

表格 1. HTTP request options

Name | Type | Description
--- | --- | ---
redirect | int | whether and how many redirects to follow
unrestrictedauth | bool | whether to continue sending credentials on redirects to a different host
proxyhost | string | proxy host in "host[:port]" format
proxyport | int | use another proxy port as specified in proxyhost
proxytype | int | `HTTP_PROXY_HTTP`, `HTTP_PROXY_SOCKS4` or `HTTP_PROXY_SOCKS5`
proxyauth | string | proxy credentials in "user:pass" format
proxyauthtype | int | `HTTP_AUTH_BASIC` and/or `HTTP_AUTH_NTLM`
httpauth | string | http credentials in "user:pass" format
httpauthtype | int | `HTTP_AUTH_BASIC`, `HTTP_AUTH_DIGEST` and/or `HTTP_AUTH_NTLM`
compress | bool | whether to allow gzip/deflate content encoding
port | int | use another port as specified in the url
referer | string | the referer to send
useragent | string | the user agent to send (defaults to PECL::HTTP/version (PHP/version))
headers | array | list of custom headers as associative array like array("header" => "value")
cookies | array | list of cookies as associative array like array("cookie" => "value")
encodecookies | bool | whether to urlencode the cookies (default: true)
cookiestore | string | path to a file where cookies are/will be stored
cookiesession | bool | don't load session cookies from cookiestore if TRUE
resume | int | byte offset to start the download from; if the server supports ranges
range | array | array of arrays, each containing two integers, specifying the ranges to download if server support is given; only recognized if the resume option is empty
maxfilesize | int | maximum file size that should be downloaded; has no effect, if the size of the requested entity is
lastmodified | int | timestamp for If-(Un)Modified-Since header
etag | string | quoted etag for If-(None-)Match header
timeout | int | seconds the request may take
connecttimeout | int | seconds the connect may take
onprogress | mixed | progress callback
interface | string | outgoing network interface (ifname, ip or hostname)
portrange | array | 2 integers specifying outgoing portrange to try

ssl

array

表格 2. with the following options:

Name | Type | Description
cert | string | path to certificate
certtype | string | type of certificate
certpasswd | string | password for certificate
key | string | path to key
keytype | string | type of key
keypasswd | string | pasword for key
engine | string | ssl engine to use
version | int | ssl version to use
verifypeer | bool | whether to verify the peer
verifyhost | bool | whether to verify the host
cipher_list | string | list of allowed ciphers
cainfo | string |
capath | string |
random_file | string |
egdsocket | string |

## Parameters

url

  URL

options

  HTTP request options

info

  Will be filled with request/response information

      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' => '',
      )

## Return Values

Returns the HTTP response(s) as string on success, or FALSE on failure.

前一頁 | 內容 | 下一頁
http_parse_params | 上一層 | http_head