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