HTTP context 选项
HTTP context 选项 — HTTP context 的选项列表
说明
提供给 http:// 和 https:// 传输协议的 context 选项。
transports.
可选项
method
string
远程服务器支持的 GET,POST 或其它 HTTP 方法。
默认值是 GET。
header
array 或 string
请求期间发送的附加 header 。此选项中的值将覆盖其他值
(如 User-agent:, Host: 和
Authentication:),
即使在执行 Location: 重定向时也是如此。
所以,如果启用了 follow_location
就不建议设置 Host: header。
字符串值是以 \r\n 分隔的 Key: value,例如 "Content-Type:
application/json\r\nConnection: close"。数组值应为 Key: value
的列表,例如 ["Content-Type: application/json", "Connection: close"]。
user_agent
string
要发送的 header User-Agent: 的值。如果在上面的
header context 选项中没有指定 user-agent,此值将被使用。
默认使用 php.ini 中设置的 user_agent。
content
string
在 header 后面要发送的额外数据。通常使用POST或PUT请求。
proxy
string
URI 指定的代理服务器的地址(例如:
tcp://proxy.example.com:5100)。
request_fulluri
bool
当设置为 true 时,在构建请求时将使用整个 URI(例如:
GET http://www.example.com/path/to/file.html HTTP/1.0)。
虽然这是一个非标准的请求格式,但某些代理服务器需要它。
默认值是 false.
follow_location
int
跟随 Location header 的重定向。设置为 0 以禁用。
默认值是 1。
max_redirects
int
跟随重定向的最大次数。值为 1 或更少则意味不跟随重定向。
默认值是 20。
protocol_version
float
HTTP 协议版本。
PHP 8.0.0 起默认值是 1.1。在此之前默认值是 1.0。
timeout
float
读取超时时间,单位为秒(s),用 float 指定(例如:10.5)。
默认使用 php.ini 中设置的 default_socket_timeout。
ignore_errors
bool
即使是故障状态码依然获取内容。
默认值为 false.
示例
示例 #1 获取一个页面并发送 POST 数据
<?php
$postdata = http_build_query(
[
'var1' => 'some content',
'var2' => 'doh',
]
);
$opts = [
'http' => [
'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 忽略重定向并获取 header 和内容
<?php
$url = "http://www.example.org/header.php";
$opts = [
'http' => [
'method' => 'GET',
'max_redirects' => '0',
'ignore_errors' => '1',
]
];
$context = stream_context_create($opts);
$stream = fopen($url, 'r', false, $context);
// header 信息和 stream 的元数据一样
var_dump(stream_get_meta_data($stream));
// $url 的实际数据
var_dump(stream_get_contents($stream));
fclose($stream);
?>注释
注意: 底层 socket 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(永久重定向), 因此 stream 包装器自动跟随重定向到获得200响应(index =4)。
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
