WP_Http::_get_first_available_transport( array $args, string $url = null ): string|false

This method has been deprecated. Use WpOrgRequestsRequests::get_transport_class() instead.

Tests which transports are capable of supporting the request.

Description

See also

Parameters

$argsarrayrequired
Request arguments.
$urlstringoptional
URL to request.

Default:null

Return

string|false Class name for the first transport that claims to support the request.
False if no transport claims to support the request.

Source

public function _get_first_available_transport( $args, $url = null ) {
	$transports = array( 'curl', 'streams' );

	/**
	 * Filters which HTTP transports are available and in what order.
	 *
	 * @since 3.7.0
	 * @deprecated 6.4.0 Use WpOrg\Requests\Requests::get_transport_class()
	 *
	 * @param string[] $transports Array of HTTP transports to check. Default array contains
	 *                             'curl' and 'streams', in that order.
	 * @param array    $args       HTTP request arguments.
	 * @param string   $url        The URL to request.
	 */
	$request_order = apply_filters_deprecated( 'http_api_transports', array( $transports, $args, $url ), '6.4.0' );

	// Loop over each transport on each HTTP request looking for one which will serve this request's needs.
	foreach ( $request_order as $transport ) {
		if ( in_array( $transport, $transports, true ) ) {
			$transport = ucfirst( $transport );
		}
		$class = 'WP_Http_' . $transport;

		// Check to see if this transport is a possibility, calls the transport statically.
		if ( ! call_user_func( array( $class, 'test' ), $args, $url ) ) {
			continue;
		}

		return $class;
	}

	return false;
}

Hooks

apply_filters_deprecated( ‘http_api_transports’, string[] $transports, array $args, string $url )

Filters which HTTP transports are available and in what order.

Changelog

VersionDescription
6.4.0Use WpOrgRequestsRequests::get_transport_class()
3.2.0Introduced.

User Contributed Notes

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