wp_safe_remote_head( string $url, array $args = array() ): array|WP_Error

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.

Top ↑

See also


Top ↑

Parameters

$url string Required
URL to retrieve.
$args array Optional
Request arguments.

Default: array()


Top ↑

Return

array|WP_Error The response or WP_Error on failure.


Top ↑

Source

File: wp-includes/http.php. View all references

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


Top ↑

Changelog

Changelog
Version Description
3.6.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.