-}
-
-/**
- * HTTP request method uses Curl extension to retrieve the url.
- *
- * Requires the Curl extension to be installed.
- *
- * @package WordPress
- * @subpackage HTTP
- * @since 2.7
- */
-class WP_Http_Curl {
-
- /**
- * Temporary header storage for use with streaming to a file.
- *
- * @since 3.2.0
- * @access private
- * @var string
- */
- private $headers = '';
-
- /**
- * Send a HTTP request to a URI using cURL extension.
- *
- * @access public
- * @since 2.7.0
- *
- * @param string $url
- * @param str|array $args Optional. Override the defaults.
- * @return array 'headers', 'body', 'response', 'cookies' and 'filename' keys.
- */
- function request($url, $args = array()) {
- $defaults = array(
- 'method' => 'GET', 'timeout' => 5,
- 'redirection' => 5, 'httpversion' => '1.0',
- 'blocking' => true,
- 'headers' => array(), 'body' => null, 'cookies' => array()
- );
-
- $r = wp_parse_args( $args, $defaults );
-
- if ( isset($r['headers']['User-Agent']) ) {
- $r['user-agent'] = $r['headers']['User-Agent'];
- unset($r['headers']['User-Agent']);
- } else if ( isset($r['headers']['user-agent']) ) {
- $r['user-agent'] = $r['headers']['user-agent'];
- unset($r['headers']['user-agent']);
- }
-
- // Construct Cookie: header if any cookies are set.
- WP_Http::buildCookieHeader( $r );
-
- $handle = curl_init();
-
- // cURL offers really easy proxy support.
- $proxy = new WP_HTTP_Proxy();
-
- if ( $proxy->is_enabled() && $proxy->send_through_proxy( $url ) ) {
-
- curl_setopt( $handle, CURLOPT_PROXYTYPE, CURLPROXY_HTTP );
- curl_setopt( $handle, CURLOPT_PROXY, $proxy->host() );
- curl_setopt( $handle, CURLOPT_PROXYPORT, $proxy->port() );
-
- if ( $proxy->use_authentication() ) {
- curl_setopt( $handle, CURLOPT_PROXYAUTH, CURLAUTH_ANY );
- curl_setopt( $handle, CURLOPT_PROXYUSERPWD, $proxy->authentication() );
- }
- }
-
- $is_local = isset($args['local']) && $args['local'];
- $ssl_verify = isset($args['sslverify']) && $args['sslverify'];
- if ( $is_local )
- $ssl_verify = apply_filters('https_local_ssl_verify', $ssl_verify);
- elseif ( ! $is_local )
- $ssl_verify = apply_filters('https_ssl_verify', $ssl_verify);
-
-
- // CURLOPT_TIMEOUT and CURLOPT_CONNECTTIMEOUT expect integers. Have to use ceil since
- // a value of 0 will allow an ulimited timeout.
- $timeout = (int) ceil( $r['timeout'] );
- curl_setopt( $handle, CURLOPT_CONNECTTIMEOUT, $timeout );
- curl_setopt( $handle, CURLOPT_TIMEOUT, $timeout );
-
- curl_setopt( $handle, CURLOPT_URL, $url);
- curl_setopt( $handle, CURLOPT_RETURNTRANSFER, true );
- curl_setopt( $handle, CURLOPT_SSL_VERIFYHOST, ( $ssl_verify === true ) ? 2 : false );
- curl_setopt( $handle, CURLOPT_SSL_VERIFYPEER, $ssl_verify );
- curl_setopt( $handle, CURLOPT_USERAGENT, $r['user-agent'] );
- curl_setopt( $handle, CURLOPT_MAXREDIRS, $r['redirection'] );
-
- switch ( $r['method'] ) {
- case 'HEAD':
- curl_setopt( $handle, CURLOPT_NOBODY, true );
- break;
- case 'POST':
- curl_setopt( $handle, CURLOPT_POST, true );
- curl_setopt( $handle, CURLOPT_POSTFIELDS, $r['body'] );
- break;
- case 'PUT':
- curl_setopt( $handle, CURLOPT_CUSTOMREQUEST, 'PUT' );
- curl_setopt( $handle, CURLOPT_POSTFIELDS, $r['body'] );
- break;
- }
-
- if ( true === $r['blocking'] )
- curl_setopt( $handle, CURLOPT_HEADERFUNCTION, array( &$this, 'stream_headers' ) );
-
- curl_setopt( $handle, CURLOPT_HEADER, false );
-
- // If streaming to a file open a file handle, and setup our curl streaming handler
- if ( $r['stream'] ) {
- if ( ! WP_DEBUG )
- $stream_handle = @fopen( $r['filename'], 'w+' );
- else
- $stream_handle = fopen( $r['filename'], 'w+' );
- if ( ! $stream_handle )
- return new WP_Error( 'http_request_failed', sprintf( __( 'Could not open handle for fopen() to %s' ), $r['filename'] ) );
- curl_setopt( $handle, CURLOPT_FILE, $stream_handle );
- }
-
- // The option doesn't work with safe mode or when open_basedir is set.
- if ( !ini_get('safe_mode') && !ini_get('open_basedir') && 0 !== $r['_redirection'] )
- curl_setopt( $handle, CURLOPT_FOLLOWLOCATION, true );
-
- if ( !empty( $r['headers'] ) ) {
- // cURL expects full header strings in each element
- $headers = array();
- foreach ( $r['headers'] as $name => $value ) {
- $headers[] = "{$name}: $value";
- }
- curl_setopt( $handle, CURLOPT_HTTPHEADER, $headers );
- }
-
- if ( $r['httpversion'] == '1.0' )
- curl_setopt( $handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0 );
- else
- curl_setopt( $handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1 );
-
- // Cookies are not handled by the HTTP API currently. Allow for plugin authors to handle it
- // themselves... Although, it is somewhat pointless without some reference.
- do_action_ref_array( 'http_api_curl', array(&$handle) );
-
- // We don't need to return the body, so don't. Just execute request and return.
- if ( ! $r['blocking'] ) {
- curl_exec( $handle );
- curl_close( $handle );
- return array( 'headers' => array(), 'body' => '', 'response' => array('code' => false, 'message' => false), 'cookies' => array() );
- }
-
- $theResponse = curl_exec( $handle );
- $theBody = '';
- $theHeaders = WP_Http::processHeaders( $this->headers );
-
- if ( strlen($theResponse) > 0 && ! is_bool( $theResponse ) ) // is_bool: when using $args['stream'], curl_exec will return (bool)true
- $theBody = $theResponse;
-
- // If no response, and It's not a HEAD request with valid headers returned
- if ( 0 == strlen($theResponse) && ('HEAD' != $args['method'] || empty($this->headers)) ) {
- if ( $curl_error = curl_error($handle) )
- return new WP_Error('http_request_failed', $curl_error);
- if ( in_array( curl_getinfo( $handle, CURLINFO_HTTP_CODE ), array(301, 302) ) )
- return new WP_Error('http_request_failed', __('Too many redirects.'));
- }
-
- unset( $this->headers );
-
- $response = array();
- $response['code'] = curl_getinfo( $handle, CURLINFO_HTTP_CODE );
- $response['message'] = get_status_header_desc($response['code']);
-
- curl_close( $handle );
-
- if ( $r['stream'] )
- fclose( $stream_handle );
-
- // See #11305 - When running under safe mode, redirection is disabled above. Handle it manually.
- if ( ! empty( $theHeaders['headers']['location'] ) && ( ini_get( 'safe_mode' ) || ini_get( 'open_basedir' ) ) && 0 !== $r['_redirection'] ) {
- if ( $r['redirection']-- > 0 ) {
- return $this->request( $theHeaders['headers']['location'], $r );
- } else {
- return new WP_Error( 'http_request_failed', __( 'Too many redirects.' ) );
- }
- }
-
- if ( true === $r['decompress'] && true === WP_Http_Encoding::should_decode($theHeaders['headers']) )
- $theBody = WP_Http_Encoding::decompress( $theBody );
-
- return array( 'headers' => $theHeaders['headers'], 'body' => $theBody, 'response' => $response, 'cookies' => $theHeaders['cookies'], 'filename' => $r['filename'] );
- }
-
- /**
- * Grab the headers of the cURL request
- *
- * Each header is sent individually to this callback, so we append to the $header property for temporary storage
- *
- * @since 3.2.0
- * @access private
- * @return int
- */
- private function stream_headers( $handle, $headers ) {
- $this->headers .= $headers;
- return strlen( $headers );
- }
-
- /**
- * Whether this class can be used for retrieving an URL.
- *
- * @static
- * @since 2.7.0
- *
- * @return boolean False means this class can not be used, true means it can.
- */
- function test( $args = array() ) {
- if ( ! function_exists( 'curl_init' ) || ! function_exists( 'curl_exec' ) )
- return false;
-
- $is_ssl = isset( $args['ssl'] ) && $args['ssl'];
-
- if ( $is_ssl ) {
- $curl_version = curl_version();
- if ( ! (CURL_VERSION_SSL & $curl_version['features']) ) // Does this cURL version support SSL requests?
- return false;
- }
-
- return apply_filters( 'use_curl_transport', true, $args );
- }
-}
-
-/**
- * Adds Proxy support to the WordPress HTTP API.
- *
- * There are caveats to proxy support. It requires that defines be made in the wp-config.php file to
- * enable proxy support. There are also a few filters that plugins can hook into for some of the
- * constants.
- *
- * Please note that only BASIC authentication is supported by most transports.
- * cURL MAY support more methods (such as NTLM authentication) depending on your environment.
- *
- * The constants are as follows:
- * <ol>
- * <li>WP_PROXY_HOST - Enable proxy support and host for connecting.</li>
- * <li>WP_PROXY_PORT - Proxy port for connection. No default, must be defined.</li>
- * <li>WP_PROXY_USERNAME - Proxy username, if it requires authentication.</li>
- * <li>WP_PROXY_PASSWORD - Proxy password, if it requires authentication.</li>
- * <li>WP_PROXY_BYPASS_HOSTS - Will prevent the hosts in this list from going through the proxy.
- * You do not need to have localhost and the blog host in this list, because they will not be passed
- * through the proxy. The list should be presented in a comma separated list, wildcards using * are supported, eg. *.wordpress.org</li>
- * </ol>
- *
- * An example can be as seen below.
- * <code>
- * define('WP_PROXY_HOST', '192.168.84.101');
- * define('WP_PROXY_PORT', '8080');
- * define('WP_PROXY_BYPASS_HOSTS', 'localhost, www.example.com, *.wordpress.org');
- * </code>
- *
- * @link http://core.trac.wordpress.org/ticket/4011 Proxy support ticket in WordPress.
- * @link http://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_PROXY_BYPASS_HOSTS
- * @since 2.8
- */
-class WP_HTTP_Proxy {
-
- /**
- * Whether proxy connection should be used.
- *
- * @since 2.8
- * @use WP_PROXY_HOST
- * @use WP_PROXY_PORT
- *
- * @return bool
- */
- function is_enabled() {
- return defined('WP_PROXY_HOST') && defined('WP_PROXY_PORT');
- }
-
- /**
- * Whether authentication should be used.
- *
- * @since 2.8
- * @use WP_PROXY_USERNAME
- * @use WP_PROXY_PASSWORD
- *
- * @return bool
- */
- function use_authentication() {
- return defined('WP_PROXY_USERNAME') && defined('WP_PROXY_PASSWORD');
- }
-
- /**
- * Retrieve the host for the proxy server.
- *
- * @since 2.8
- *
- * @return string
- */
- function host() {
- if ( defined('WP_PROXY_HOST') )
- return WP_PROXY_HOST;
-
- return '';
- }
-
- /**
- * Retrieve the port for the proxy server.
- *
- * @since 2.8
- *
- * @return string
- */
- function port() {
- if ( defined('WP_PROXY_PORT') )
- return WP_PROXY_PORT;
-
- return '';
- }
-
- /**
- * Retrieve the username for proxy authentication.
- *
- * @since 2.8
- *
- * @return string
- */
- function username() {
- if ( defined('WP_PROXY_USERNAME') )
- return WP_PROXY_USERNAME;
-
- return '';
- }
-
- /**
- * Retrieve the password for proxy authentication.
- *
- * @since 2.8
- *
- * @return string
- */
- function password() {
- if ( defined('WP_PROXY_PASSWORD') )
- return WP_PROXY_PASSWORD;
-
- return '';
- }
-
- /**
- * Retrieve authentication string for proxy authentication.
- *
- * @since 2.8
- *
- * @return string
- */
- function authentication() {
- return $this->username() . ':' . $this->password();
- }
-
- /**
- * Retrieve header string for proxy authentication.
- *
- * @since 2.8
- *
- * @return string
- */
- function authentication_header() {
- return 'Proxy-Authorization: Basic ' . base64_encode( $this->authentication() );
- }
-
- /**
- * Whether URL should be sent through the proxy server.
- *
- * We want to keep localhost and the blog URL from being sent through the proxy server, because
- * some proxies can not handle this. We also have the constant available for defining other
- * hosts that won't be sent through the proxy.
- *
- * @uses WP_PROXY_BYPASS_HOSTS
- * @since 2.8.0
- *
- * @param string $uri URI to check.
- * @return bool True, to send through the proxy and false if, the proxy should not be used.
- */
- function send_through_proxy( $uri ) {
- // parse_url() only handles http, https type URLs, and will emit E_WARNING on failure.
- // This will be displayed on blogs, which is not reasonable.
- $check = @parse_url($uri);
-
- // Malformed URL, can not process, but this could mean ssl, so let through anyway.
- if ( $check === false )
- return true;
-
- $home = parse_url( get_option('siteurl') );