enmi-conf.org: comparison wp/wp-includes/http.php

equal deleted inserted replaced

-:48c4eec2b7e6
+:8c2e4d02f4ef
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
 * @return array|WP_Error The response or WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
 */
 function wp_safe_remote_request( $url, $args = array() ) {
 	$args['reject_unsafe_urls'] = true;
 	$http                       = _wp_http_get_object();
 	return $http->request( $url, $args );
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
 * @return array|WP_Error The response or WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
 */
 function wp_safe_remote_get( $url, $args = array() ) {
 	$args['reject_unsafe_urls'] = true;
 	$http                       = _wp_http_get_object();
 	return $http->get( $url, $args );
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
 * @return array|WP_Error The response or WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
 */
 function wp_safe_remote_post( $url, $args = array() ) {
 	$args['reject_unsafe_urls'] = true;
 	$http                       = _wp_http_get_object();
 	return $http->post( $url, $args );
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
 * @return array|WP_Error The response or WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
 */
 function wp_safe_remote_head( $url, $args = array() ) {
 	$args['reject_unsafe_urls'] = true;
 	$http                       = _wp_http_get_object();
 	return $http->head( $url, $args );
 * @see WP_Http::request() For information on default arguments.
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
-* @return array|WP_Error {
+* @return array|WP_Error The response array or a WP_Error on failure.
-*     The response array or a WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
-*
-*     @type string[]                       $headers       Array of response headers keyed by their name.
-*     @type string                         $body          Response body.
-*     @type array                          $response      {
-*         Data about the HTTP response.
-*
-*         @type int|false    $code    HTTP response code.
-*         @type string|false $message HTTP response message.
-*     }
-*     @type WP_HTTP_Cookie[]               $cookies       Array of response cookies.
-*     @type WP_HTTP_Requests_Response|null $http_response Raw HTTP response object.
-* }
 */
 function wp_remote_request( $url, $args = array() ) {
 	$http = _wp_http_get_object();
 	return $http->request( $url, $args );
 }
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
 * @return array|WP_Error The response or WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
 */
 function wp_remote_get( $url, $args = array() ) {
 	$http = _wp_http_get_object();
 	return $http->get( $url, $args );
 }
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
 * @return array|WP_Error The response or WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
 */
 function wp_remote_post( $url, $args = array() ) {
 	$http = _wp_http_get_object();
 	return $http->post( $url, $args );
 }
 *
 * @param string $url  URL to retrieve.
 * @param array  $args Optional. Request arguments. Default empty array.
 *                     See WP_Http::request() for information on accepted arguments.
 * @return array|WP_Error The response or WP_Error on failure.
+*                        See WP_Http::request() for information on return value.
 */
 function wp_remote_head( $url, $args = array() ) {
 	$http = _wp_http_get_object();
 	return $http->head( $url, $args );
 }
 *                             that requirement to the capabilities array.
 *
 * @return bool
 */
 function wp_http_supports( $capabilities = array(), $url = null ) {
-	$http = _wp_http_get_object();
 	$capabilities = wp_parse_args( $capabilities );
 	$count = count( $capabilities );
 	// If we have a numeric $capabilities array, spoof a wp_remote_request() associative $args array.
 		if ( 'https' === $scheme || 'ssl' === $scheme ) {
 			$capabilities['ssl'] = true;
 		}
 	}
-	return (bool) $http->_get_first_available_transport( $capabilities );
+	return WpOrg\Requests\Requests::has_capabilities( $capabilities );
 }
 /**
 * Gets the HTTP Origin of the current request.
 *
 * Examples of URLs that are considered unsafe:
 *
 * - ftp://example.com/caniload.php - Invalid protocol - only http and https are allowed.
 * - http:///example.com/caniload.php - Malformed URL.
 * - http://user:pass@example.com/caniload.php - Login information.
-* - http://exampleeeee.com/caniload.php - Invalid hostname, as the IP cannot be looked up in DNS.
+* - http://example.invalid/caniload.php - Invalid hostname, as the IP cannot be looked up in DNS.
 *
 * Examples of URLs that are considered unsafe by default:
 *
 * - http://192.168.0.1/caniload.php - IPs from LAN networks.
 *   This can be changed with the {@see 'http_request_host_is_external'} filter.
 /**
 * A wrapper for PHP's parse_url() function that handles consistency in the return values
 * across PHP versions.
 *
-* PHP 5.4.7 expanded parse_url()'s ability to handle non-absolute URLs, including
+* Across various PHP versions, schemeless URLs containing a ":" in the query
-* schemeless and relative URLs with "://" in the path. This function works around
+* are being handled inconsistently. This function works around those differences.
-* those limitations providing a standard output on PHP 5.2~5.4+.
-*
-* Secondly, across various PHP versions, schemeless URLs containing a ":" in the query
-* are being handled inconsistently. This function works around those differences as well.
 *
 * @since 4.4.0
 * @since 4.7.0 The `$component` parameter was added for parity with PHP's `parse_url()`.
 *
 * @link https://www.php.net/manual/en/function.parse-url.php

changeset 22	8c2e4d02f4ef
parent 21	48c4eec2b7e6