HTTP 上下文选项
HTTP 上下文选项 — HTTP 上下文选项列表
描述
用于 http:// 和 https:// 传输的上下文选项。
选项
-
method 字符串
-
GET、POST 或远程服务器支持的任何其他 HTTP 方法。
默认为 GET。
-
请求期间要发送的其他标头。此选项中的值将覆盖其他值(例如 User-agent:、Host: 和 Authentication:),即使在遵循 Location: 重定向时也是如此。因此,如果启用了 follow_location,则不建议设置 Host: 标头。
-
user_agent 字符串
-
要与 User-Agent: 标头一起发送的值。仅当上述 header 上下文选项中未指定 user-agent 时,才会使用此值。
默认情况下,使用 user_agent php.ini 设置。
-
content 字符串
-
在标头之后发送的其他数据。通常与 POST 或 PUT 请求一起使用。
-
proxy 字符串
-
指定代理服务器地址的 URI(例如 tcp://proxy.example.com:5100)。
-
request_fulluri 布尔值
-
设置为 true 时,在构造请求时将使用整个 URI(例如 GET http://www.example.com/path/to/file.html HTTP/1.0)。虽然这是一种非标准的请求格式,但某些代理服务器需要它。
默认为 false。
-
follow_location 整数
-
遵循 Location 标头重定向。设置为 0 以禁用。
默认为 1。
-
max_redirects 整数
-
要遵循的最大重定向次数。值 1 或更小表示不遵循任何重定向。
默认为 20。
-
protocol_version 浮点数
-
HTTP 协议版本。
从 PHP 8.0.0 开始默认为 1.1;在此版本之前,默认为 1.0。
-
timeout 浮点数
-
以秒为单位的读取超时,由 浮点数 指定(例如 10.5)。
默认情况下,使用 default_socket_timeout php.ini 设置。
-
ignore_errors 布尔值
-
即使在失败的状态码上也获取内容。
默认为 false。
示例
示例 #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);
?>
示例 #2 忽略重定向但获取标头和内容
<?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);
// 标头信息以及有关流的元数据
// 关于流
var_dump(stream_get_meta_data($stream));
// $url 处的实际数据
var_dump(stream_get_contents($stream));
fclose($stream);
?>
注意
注意:底层套接字流上下文选项
底层传输可能支持其他上下文选项。对于 http:// 流,请参阅 tcp:// 传输的上下文选项。对于 https:// 流,请参阅 ssl:// 传输的上下文选项。
注意:HTTP 状态行
当此流包装器遵循重定向时,stream_get_meta_data() 返回的 wrapper_data 可能不一定包含实际应用于索引 0 处内容数据的 HTTP 状态行。
array (
'wrapper_data' =>
array (
0 => 'HTTP/1.0 301 Moved Permanently',
1 => 'Cache-Control: no-cache',
2 => 'Connection: close',
3 => 'Location: http://example.com/foo.jpg',
4 => 'HTTP/1.1 200 OK',
...
第一个请求返回了 301(永久重定向),因此流包装器自动遵循重定向以获取 200 响应(索引 = 4)。