W3cubDocs

/WordPress

WP_Http::_dispatch_request( string $url, array $args )

This method has been deprecated. Use WP_Http::request() instead.

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness. Use WP_Http::request() instead.

Dispatches a HTTP request to a supporting transport.

Description

Tests each transport in order to find a transport which matches the request arguments. Also caches the transport instance to be used later.

The order for requests is cURL, and then PHP Streams.

See also

Parameters

$url

(string) (Required) URL to request.

$args

(array) (Required) Request arguments.

Return

(array|WP_Error) Array containing 'headers', 'body', 'response', 'cookies', 'filename'. A WP_Error instance upon error.

Source

File: wp-includes/class-http.php 

private function _dispatch_request( $url, $args ) {
		static $transports = array();

		$class = $this->_get_first_available_transport( $args, $url );
		if ( ! $class ) {
			return new WP_Error( 'http_failure', __( 'There are no HTTP transports available which can complete the requested request.' ) );
		}

		// Transport claims to support request, instantiate it and give it a whirl.
		if ( empty( $transports[ $class ] ) ) {
			$transports[ $class ] = new $class;
		}

		$response = $transports[ $class ]->request( $url, $args );

		/** This action is documented in wp-includes/class-http.php */
		do_action( 'http_api_debug', $response, 'response', $class, $args, $url );

		if ( is_wp_error( $response ) ) {
			return $response;
		}

		/** This filter is documented in wp-includes/class-http.php */
		return apply_filters( 'http_response', $response, $args, $url );
	}

Uses

Uses Description
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/class-http.php: WP_Http::_get_first_available_transport()

Tests which transports are capable of supporting the request.
wp-includes/class-http.php: http_api_debug

Fires after an HTTP API response is received and before the response is returned.
wp-includes/class-http.php: http_response

Filters the HTTP API response immediately before the response is returned.
wp-includes/plugin.php: do_action()

Execute functions hooked on a specific action hook.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/load.php: is_wp_error()

Check whether variable is a WordPress Error.
wp-includes/class-wp-error.php: WP_Error::__construct()

Initialize the error.

Changelog

Version Description
5.1.0 Use WP_Http::request()
3.2.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_http/_dispatch_request