wp_remote_post( string $url, array $args = array() )
Performs an HTTP request using the POST method and returns its response.
Description
See also
- wp_remote_request(): For more information on the response array format.
- WP_Http::request(): For default arguments information.
Parameters
- $url
-
(string) (Required) URL to retrieve.
- $args
-
(array) (Optional) Request arguments.
Default value: array()
Return
Source
File: wp-includes/http.php
function wp_remote_post( $url, $args = array() ) {
$http = _wp_http_get_object();
return $http->post( $url, $args );
}
Changelog
| Version | Description |
|---|---|
| 2.7.0 | Introduced. |
Exemple of Basic Authentication:
$response = wp_remote_post( $url, array( 'body' => $data, 'headers' => array( 'Authorization' => 'Basic ' . base64_encode( $username . ':' . $password ), ), ) );Post data should be sent in the body as an array. Example passing post data:
$response = wp_remote_post( $url, array( 'method' => 'POST', 'timeout' => 45, 'redirection' => 5, 'httpversion' => '1.0', 'blocking' => true, 'headers' => array(), 'body' => array( 'username' => 'bob', 'password' => '1234xyz' ), 'cookies' => array() ) ); if ( is_wp_error( $response ) ) { $error_message = $response->get_error_message(); echo "Something went wrong: $error_message"; } else { echo 'Response:<pre>'; print_r( $response ); echo '</pre>'; }Expand full source codeCollapse full source code
In the example above,
$response['body']will contain the actual page content returned by the server.See also wp_safe_remote_post(), especially if you are using a dynamic URL call.