PHP: http_get - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

http_head http_parse_params

Last updated: Fri, 26 Jan 2007

view this page in

# http_get

(PECL)

http_get -- Perform GET request

## Описание

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 |

## Список параметров

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

## Возвращаемые значения

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

add a note User Contributed Notes
http_get
tjerk dot meesters at muvee dot com
13-Dec-2006 08:16
`To change the request protocol use the option "protocol". The allowed values are:
* HTTP_VERSION_NONE (integer)
* HTTP_VERSION_1_0 (integer)
* HTTP_VERSION_1_1 (integer)`
tac at smokescreen dot org
10-Nov-2006 06:41
`The hard work of parsing out the response is done in <a href='http://us2.php.net/http_parse_message'>http_parse_message</a>.
To replace the relatively weak file_get_contents(), using
$body = http_parse_message(http_get($url))->body;
The advantages to using http_get include getting back headers and controlling timeouts.`
add a note
http_head http_parse_params

Last updated: Fri, 26 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 09:32:46 2007 PST