wp_safe_remote_head()WP 3.6.0

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

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.

No Hooks.

Return

Array|WP_Error. The response or WP_Error on failure.

Usage

wp_safe_remote_head( $url, $args );
$url(string) (required)
URL to retrieve.
$args(array)
Request arguments.
Default: empty array

Notes

Changelog

Since 3.6.0 Introduced.

Code of wp_safe_remote_head() WP 6.1.1

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