WP_Http_Curl::request( string $url, string|array $args = array() ): array|WP_Error

73	public function request( $url, $args = array() ) {74		$defaults = array(75			'method'      => 'GET',76			'timeout'     => 5,77			'redirection' => 5,78			'httpversion' => '1.0',79			'blocking'    => true,80			'headers'     => array(),81			'body'        => null,82			'cookies'     => array(),83			'decompress'  => false,84			'stream'      => false,85			'filename'    => null,86		);87 88		$parsed_args = wp_parse_args( $args, $defaults );89 90		if ( isset( $parsed_args['headers']['User-Agent'] ) ) {91			$parsed_args['user-agent'] = $parsed_args['headers']['User-Agent'];92			unset( $parsed_args['headers']['User-Agent'] );93		} elseif ( isset( $parsed_args['headers']['user-agent'] ) ) {94			$parsed_args['user-agent'] = $parsed_args['headers']['user-agent'];95			unset( $parsed_args['headers']['user-agent'] );96		}97 98		// Construct Cookie: header if any cookies are set.99		WP_Http::buildCookieHeader( $parsed_args );100 101		$handle = curl_init();102 103		// cURL offers really easy proxy support.104		$proxy = new WP_HTTP_Proxy();105 106		if ( $proxy->is_enabled() && $proxy->send_through_proxy( $url ) ) {107 108			curl_setopt( $handle, CURLOPT_PROXYTYPE, CURLPROXY_HTTP );109			curl_setopt( $handle, CURLOPT_PROXY, $proxy->host() );110			curl_setopt( $handle, CURLOPT_PROXYPORT, $proxy->port() );111 112			if ( $proxy->use_authentication() ) {113				curl_setopt( $handle, CURLOPT_PROXYAUTH, CURLAUTH_ANY );114				curl_setopt( $handle, CURLOPT_PROXYUSERPWD, $proxy->authentication() );115			}116		}117 118		$is_local   = isset( $parsed_args['local'] ) && $parsed_args['local'];119		$ssl_verify = isset( $parsed_args['sslverify'] ) && $parsed_args['sslverify'];120		if ( $is_local ) {121			/** This filter is documented in wp-includes/class-wp-http-streams.php */122			$ssl_verify = apply_filters( 'https_local_ssl_verify', $ssl_verify, $url );123		} elseif ( ! $is_local ) {124			/** This filter is documented in wp-includes/class-wp-http.php */125			$ssl_verify = apply_filters( 'https_ssl_verify', $ssl_verify, $url );126		}127 128		/*129		 * CURLOPT_TIMEOUT and CURLOPT_CONNECTTIMEOUT expect integers. Have to use ceil since.130		 * a value of 0 will allow an unlimited timeout.131		 */132		$timeout = (int) ceil( $parsed_args['timeout'] );133		curl_setopt( $handle, CURLOPT_CONNECTTIMEOUT, $timeout );134		curl_setopt( $handle, CURLOPT_TIMEOUT, $timeout );135 136		curl_setopt( $handle, CURLOPT_URL, $url );137		curl_setopt( $handle, CURLOPT_RETURNTRANSFER, true );138		curl_setopt( $handle, CURLOPT_SSL_VERIFYHOST, ( true === $ssl_verify ) ? 2 : false );139		curl_setopt( $handle, CURLOPT_SSL_VERIFYPEER, $ssl_verify );140 141		if ( $ssl_verify ) {142			curl_setopt( $handle, CURLOPT_CAINFO, $parsed_args['sslcertificates'] );143		}144 145		curl_setopt( $handle, CURLOPT_USERAGENT, $parsed_args['user-agent'] );146 147		/*148		 * The option doesn't work with safe mode or when open_basedir is set, and there's149		 * a bug #17490 with redirected POST requests, so handle redirections outside Curl.150		 */151		curl_setopt( $handle, CURLOPT_FOLLOWLOCATION, false );152		curl_setopt( $handle, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS );