Warning: This function has been deprecated. Use WP_Http() instead.

wp_get_http( string $url, string|bool $file_path = false, int $red = 1 )

Perform a HTTP HEAD or GET request.

Description Description

If $file_path is a writable filename, this will do a GET request and write the file to that path.

See also See also

Top ↑

Parameters Parameters


(string) (Required) URL to fetch.


(string|bool) (Optional) File path to write request to.

Default value: false


(int) (Optional) The number of Redirects followed, Upon 5 being hit, returns false.

Default value: 1

Top ↑

Return Return

(bool|string) False on failure and string of headers if HEAD request.

Top ↑

Source Source

File: wp-includes/deprecated.php

function wp_get_http( $url, $file_path = false, $red = 1 ) {
	_deprecated_function( __FUNCTION__, '4.4.0', 'WP_Http' );

	@set_time_limit( 60 );

	if ( $red > 5 )
		return false;

	$options = array();
	$options['redirection'] = 5;

	if ( false == $file_path )
		$options['method'] = 'HEAD';
		$options['method'] = 'GET';

	$response = wp_safe_remote_request( $url, $options );

	if ( is_wp_error( $response ) )
		return false;

	$headers = wp_remote_retrieve_headers( $response );
	$headers['response'] = wp_remote_retrieve_response_code( $response );

	// WP_HTTP no longer follows redirects for HEAD requests.
	if ( 'HEAD' == $options['method'] && in_array($headers['response'], array(301, 302)) && isset( $headers['location'] ) ) {
		return wp_get_http( $headers['location'], $file_path, ++$red );

	if ( false == $file_path )
		return $headers;

	// GET request - write it to the supplied filename
	$out_fp = fopen($file_path, 'w');
	if ( !$out_fp )
		return $headers;

	fwrite( $out_fp,  wp_remote_retrieve_body( $response ) );

	return $headers;

Top ↑

Changelog Changelog

Version Description
4.4.0 Use WP_Http
2.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by smartoarif

    “Return: (bool|string) False on failure and string of headers if HEAD request.” – this is said in above documentation.

    But, it never returns string; instead returns array containing header info. Noting it here, as i think this is not a wordpress code bug (according to code it should be array return in case of header and ofcourse array is more useful in the scrnario of get full header info), instead a documentation typo, may be.

    // Arif

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