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.

See also

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 );
}

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