函数文档

wp_get_server_protocol()

💡 云策文档标注

概述

wp_get_server_protocol() 函数用于获取服务器发送的 HTTP 协议版本。它检查 $_SERVER['SERVER_PROTOCOL'] 变量,并返回有效的协议字符串,默认回退为 HTTP/1.0。

关键要点

  • 函数返回服务器发送的 HTTP 协议字符串,如 HTTP/1.1、HTTP/2 或 HTTP/3。
  • 如果 $_SERVER['SERVER_PROTOCOL'] 未设置或不是有效协议(HTTP/1.1、HTTP/2、HTTP/2.0、HTTP/3),则默认返回 HTTP/1.0。
  • 该函数自 WordPress 4.4.0 版本引入,常用于设置 HTTP 状态头或检查服务器需求。

代码示例

function wp_get_server_protocol() {
    $protocol = isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : '';

    if ( ! in_array( $protocol, array( 'HTTP/1.1', 'HTTP/2', 'HTTP/2.0', 'HTTP/3' ), true ) ) {
        $protocol = 'HTTP/1.0';
    }

    return $protocol;
}

📄 原文内容

Returns the HTTP protocol sent by the server.

Return

string The HTTP protocol. Default: HTTP/1.0.

Source

function wp_get_server_protocol() {
	$protocol = isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : '';

	if ( ! in_array( $protocol, array( 'HTTP/1.1', 'HTTP/2', 'HTTP/2.0', 'HTTP/3' ), true ) ) {
		$protocol = 'HTTP/1.0';
	}

	return $protocol;
}

Changelog

Version Description
4.4.0 Introduced.