wp_safe_remote_request() WordPress Function

The wp_safe_remote_request function is a safe way to make a remote request and retrieve the response. The function takes three parameters: the URL to request, an array of args to pass to the request, and an array of options to pass to the request. The function returns an array of three items: the headers, the body, and the response code.

wp_safe_remote_request( string $url, array $args = array() ) #

Retrieve the raw response from a safe HTTP request.


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 value: array()


Top ↑

Return

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


Top ↑

Source

File: wp-includes/http.php

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


Top ↑

Changelog

Changelog
VersionDescription
3.6.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.