wp_remote_request( string $url, array $args = array() )
Performs an HTTP request and returns its response.
Description
There are other API functions available which abstract away the HTTP method:
- Default ‘GET’ for wp_remote_get()
- Default ‘POST’ for wp_remote_post()
- Default ‘HEAD’ for wp_remote_head()
See also
WP_Http::request(): For information on default arguments.
Parameters
- $url
-
(Required) URL to retrieve.
- $args
-
(Optional) Request arguments.
Default value: array()
Return
(array|WP_Error) The response array or a WP_Error on failure.<br>
- 'headers'
(string[]) Array of response headers keyed by their name.<br> - 'body'
(string) Response body.<br> - 'response'
(array) Data about the HTTP response.<br>- 'code'
(int|false) HTTP response code.<br> - 'message'
(string|false) HTTP response message.<br>
- 'code'
- 'cookies'
(WP_HTTP_Cookie[]) Array of response cookies.<br> - 'http_response'
(WP_HTTP_Requests_Response|null) Raw HTTP response object.<br>
Source
File: wp-includes/http.php
function wp_remote_request($url, $args = array()) {
$http = _wp_http_get_object();
return $http->request( $url, $args );
}
Changelog
| Version | Description |
|---|---|
| 2.7.0 | Introduced. |