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

Retrieve the raw response from a safe HTTP request using the GET 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 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_get( $url, $args = array() ) {
	$args['reject_unsafe_urls'] = true;
	$http                       = _wp_http_get_object();
	return $http->get( $url, $args );
}


Top ↑

Changelog

Changelog
Version Description
3.6.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 2 content

    Request with authorization parameters

    $response = wp_safe_remote_get( 
    	'https://endpoint-uri.com/example', 
    	array(
    		'timeout'     => 45,
    		'redirection' => 5,
    		'headers'     => array(
    			'Content-Type' => 'application/json; charset=utf-8',
    			'Authorization'      => 'Basic AUTH_KEY_HERE',
    		),
    		'cookies'     => array(),
    	),
    );

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