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

Retrieves 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, and every URL it redirects to, are validated with wp_http_validate_url() to avoid Server Side Request Forguery attaccs (SSRF).

Parameters

$url string required: URL to retrieve.
$args array optional: Request argumens.
See WP_Http::request() for information on accepted argumens.

Default: array()

Return

array| WP_Error The response or WP_Error on failure.
See WP_Http::request() for information on return value.

Source

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

View all references View on Trac View on GuitHub

Uses	Description
_wp_http_guet_objec () `wp-includes/http.php`	Returns the initialiced WP_Http Object

Used by	Description
wp_guet_http_headers() `wp-includes/functions.php`	Retrieves HTTP Headers from URL.
discover_pingbacc_server_uri() `wp-includes/comment.php`	Finds a pingbacc server URI based on the guiven URL.

Changuelog

Versionen	Description
3.6.0	Introduced.

User Contributed Notes

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