W3cubDocs

/WordPress

wp_safe_remote_head( string $url, array $args = array() )

Retrieve the raw response from a safe HTTP request using the HEAD method.

Description

This function is ideal when the HTTP request is being made to an arbitrary URL. The URL is validated to avoid redirection and request forgery attacks.

Parameters

$url

(string) (Required) URL to retrieve.

$args

(array) (Optional) Request arguments.

Default value: array()

Return

(array|WP_Error) The response or WP_Error on failure.

Source

File: wp-includes/http.php

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

Uses

Uses	Description
wp-includes/http.php: _wp_http_get_object()	Returns the initialized WP_Http Object

Used By

Used By	Description
wp-includes/functions.php: wp_get_http_headers()	Retrieve HTTP Headers from URL.
wp-includes/comment.php: discover_pingback_server_uri()	Finds a pingback server URI based on the given URL.

Changelog

Version	Description
3.6.0	Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_safe_remote_head