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
)。