HTTP context 选项

    HTTP context 选项 — HTTP context 的选项列表

    说明

    提供给 http:// 和 https:// 传输协议的 context 选项。 transports.

    可选项

    methodstring

    远程服务器支持的 GET，POST 或其它 HTTP 方法。

    默认值是 GET。

    headerarray 或 string

    请求期间发送的附加 header 。此选项中的值将覆盖其他值 （如 User-agent:， Host: 和 Authentication:)， 即使在执行 Location: 重定向时也是如此。 所以，如果启用了 follow_location 就不建议设置 Host: header。

    user_agentstring

    要发送的 header User-Agent: 的值。如果在上面的 header context 选项中没有指定 user-agent，此值将被使用。

    默认使用 php.ini 中设置的 user_agent。

    contentstring

    在 header 后面要发送的额外数据。通常使用POST或PUT请求。

    proxystring

    URI 指定的代理服务器的地址。(e.g. tcp://proxy.example.com:5100).

    request_fulluribool

    当设置为 true 时，在构建请求时将使用整个 URI 。(例如： GET http://www.example.com/path/to/file.html HTTP/1.0)。 虽然这是一个非标准的请求格式，但某些代理服务器需要它。

    默认值是 false.

    follow_locationint

    跟随 Location header 的重定向。设置为 0 以禁用。

    默认值是 1。

    max_redirectsint

    跟随重定向的最大次数。值为 1 或更少则意味不跟随重定向。

    默认值是 20。

    protocol_versionfloat

    HTTP 协议版本。

    PHP 8.0.0 起默认值是 1.1。在此之前默认值是 1.0。

    timeoutfloat

    读取超时时间，单位为秒（s），用 float 指定(e.g. 10.5)。

    默认使用 php.ini 中设置的 default_socket_timeout。

    ignore_errorsbool

    即使是故障状态码依然获取内容。

    默认值为 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 忽略重定向并获取 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 信息和 stream 的元数据一样
    var_dump(stream_get_meta_data($stream));

    // $url 的实际数据
    var_dump(stream_get_contents($stream));
    fclose($stream);
    ?>

    注释

    注意: 底层 socket stream 上下文选项
    Additional context options may be supported by the underlying transport For http:// streams, refer to context options for the tcp:// transport. For https:// streams, refer to context options for the ssl:// transport.

    注意: HTTP 状态行
    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 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）。
    To Top