HTTP and HTTPS
PHP 3, PHP 4. https:// since PHP 4.3.0
Allows read-only access to files/resources via HTTP 1.0,
using the HTTP GET method. A Host: header is sent with the request
to handle name-based virtual hosts. If you have configured
a user_agent string using
your ini file or the stream context, it will also be included
in the request.
Warning |
Some non-standard compliant
webservers, such as IIS, send data in a way that causes PHP to raise warnings.
When working with such servers you should lower your
error_reporting level not to include warnings. |
Redirects have been supported since PHP 4.0.5; if you are using
an earlier version you will need to include trailing slashes in
your URLs. If it's important to know the URL of the resource where
your document came from (after all redirects have been processed),
you'll need to process the series of response headers returned by the
stream.
The stream allows access to the body of
the resource; the headers are stored in the
$http_response_header variable.
Since PHP 4.3.0, the headers are available using
stream_get_meta_data().
HTTP connections are read-only; you cannot write data or copy
files to an HTTP resource.
Note: HTTPS is supported starting from PHP 4.3.0, if you
have compiled in support for OpenSSL.
Table J-2. Wrapper Summary
Attribute | Supported |
---|
Restricted by allow_url_fopen. | Yes |
Allows Reading | Yes |
Allows Writing | No |
Allows Appending | No |
Allows Simultaneous Reading and Writing | N/A |
Supports stat() | No |
Supports unlink() | No |
Supports rename() | No |
Supports mkdir() | No |
Supports rmdir() | No |
Table J-3. Context options (as of PHP 5.0.0)
Name | Usage | Default |
---|
method |
GET, POST, or
any other HTTP method supported by the remote server.
| GET |
header | Additional headers to be sent during request. Values
in this option will override other values (such as
User-agent:, Host:,
and Authentication:).
| |
user_agent | Value to send with User-Agent: header. This value will
only be used if user-agent is not specified
in the header context option above.
|
php.ini setting: user_agent
|
content |
Additional data to be sent after the headers. Typically used
with POST or PUT requests.
| |
proxy |
URI specifying address of proxy server. (e.g.
tcp://proxy.example.com:5100 ).
| |
request_fulluri |
When set to TRUE, the entire URI will be used when
constructing the request. (i.e.
GET http://www.example.com/path/to/file.html HTTP/1.0).
While this is a non-standard request format, some
proxy servers require it.
| FALSE |
Underlying socket stream context options:
Additional context options may be supported by the
underlying transport
For http:// streams, refer to context
options for the tcp:// transport. For
https:// streams, refer to context options
for the ssl:// transport.