wp_safe_remote_post() WordPress Function

The wp_safe_remote_post() function is used to send data to a remote server using the HTTP POST method. The data is sent using the WordPress HTTP API, which is a safe and reliable way to transfer data to a remote server. This function is often used to send data to a payment gateway or to a remote API.

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

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