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

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


Description 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 Parameters

$url

(string) (Required) Site URL to retrieve.

$args

(array) (Optional) Request arguments.

Default value: array()


Top ↑

Return Return

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


Top ↑

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

Top ↑

Changelog Changelog

Changelog
Version Description
3.6.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

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