HTTP context 选项
HTTP context 选项 — HTTP context 的选项列表
说明
提供给 http:// 和 // 传输协议的 context 选项。 transports.
可选项
-
method string -
远程服务器支持的 GET，POST 或其它 HTTP 方法。
默认值是 GET。
-
请求期间发送的额外 header 。在此选项的值将覆盖其他值 （诸如 User-agent:， Host: 和 Authentication:）。
-
user_agent string -
要发送的 header User-Agent: 的值。如果在上面的 header context 选项中没有指定 user-agent，此值将被使用。
默认使用 php.ini 中设置的 user_agent。
-
content string -
在 header 后面要发送的额外数据。通常使用POST或PUT请求。
-
proxy string -
URI 指定的代理服务器的地址。(e.g. tcp://proxy.example.com:5100).
-
request_fulluri boolean -
当设置为 TRUE 时，在构建请求时将使用整个 URI 。(i.e. GET http://www.example.com/path/to/file.html HTTP/1.0)。 虽然这是一个非标准的请求格式，但某些代理服务器需要它。
默认值是 FALSE.
-
follow_location integer -
跟随 Location header 的重定向。设置为 0 以禁用。
默认值是 1。
-
max_redirects integer -
跟随重定向的最大次数。值为 1 或更少则意味不跟随重定向。
默认值是 20。
-
protocol_version float -
HTTP 协议版本。
默认值是 1.0。
Note:
PHP 5.3.0 以前的版本没有实现分块传输解码。 如果此值设置为 1.1 ，与 1.1 的兼容将是你的责任。
-
timeout float -
读取超时时间，单位为秒（s），用 float 指定(e.g. 10.5)。
默认使用 php.ini 中设置的 default_socket_timeout。
-
ignore_errors boolean -
即使是故障状态码依然获取内容。
默认值为 FALSE.
范例
Example #1 获取一个页面并发送 POST 数据
<?php
$postdata = http_build_query(
array(
'var1' => 'some content',
'var2' => 'doh'
)
);
$opts = array('http' =>
array(
'method' => 'POST',
'header' => 'Content-type: application/x-www-form-urlencoded',
'content' => $postdata
)
);
$context = stream_context_create($opts);
$result = file_get_contents('http://example.com/submit.php', false, $context);
?>
Example #2 忽略重定向并获取 header 和内容
<?php
$url = "http://www.example.org/header.php";
$opts = array('http' =>
array(
'method' => 'GET',
'max_redirects' => '0',
'ignore_errors' => '1'
)
);
$context = stream_context_create($opts);
$stream = fopen($url, 'r', false, $context);
// header information as well as meta data
// about the stream
var_dump(stream_get_meta_data($stream));
// actual data at $url
var_dump(stream_get_contents($stream));
fclose($stream);
?>
注释
Note: 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 // streams, refer to context options for the ssl:// transport.
Note: HTTP status line
When this stream wrapper follows a redirect, the wrapper_data returned by stream_get_meta_data() might not necessarily contain the HTTP status line that actually applies to the content data at index 0.
array ( 'wrapper_data' => array ( 0 => 'HTTP/1.0 301 Moved Permantenly', 1 => 'Cache-Control: no-cache', 2 => 'Connection: close', 3 => 'Location: http://example.com/foo.jpg', 4 => 'HTTP/1.1 200 OK', ...