概述

wp_safe_remote_head() 函数用于通过安全的 HTTP HEAD 方法获取原始响应，适用于向任意 URL 发起请求的场景。该函数通过 wp_http_validate_url() 验证 URL 及其重定向，以防止服务器端请求伪造（SSRF）攻击，仅支持 http 和 https 协议。

关键要点

• 函数用途：执行安全的 HTTP HEAD 请求，返回响应数组或 WP_Error。
• 安全特性：自动设置 reject_unsafe_urls 参数为 true，并验证 URL 以避免 SSRF 攻击。
• 参数说明：接受 $url（必需）和 $args（可选，默认为空数组）参数，后者参考 WP_Http::request()。
• 返回值：响应数组或 WP_Error 对象，具体格式参考 WP_Http::request()。
• 相关函数：可参考 wp_remote_request()、WP_Http::request() 和 wp_http_validate_url() 了解更多细节。
• 引入版本：自 WordPress 3.6.0 起可用。

代码示例

function wp_safe_remote_head( $url, $args = array() ) {
	$args['reject_unsafe_urls'] = true;
	$http                       = _wp_http_get_object();
	return $http->head( $url, $args );
}

注意事项

• 仅支持 http 和 https 协议，确保 URL 验证安全。
• 内部使用 _wp_http_get_object() 获取 WP_Http 对象，并调用其 head 方法。
• 相关用途包括 wp_get_http_headers() 和 discover_pingback_server_uri() 函数。