wp_remote_retrieve_headers() – Function

Retrieves only the headers from the raw response.

Description

Parameters

$responsearray|WP_Errorrequired: HTTP response.

Return

WpOrgRequestsUtilityCaseInsensitiveDictionary|array The headers of the response, or empty array if incorrect parameter given.

Source

function wp_remote_retrieve_headers( $response ) {
	if ( is_wp_error( $response ) || ! isset( $response['headers'] ) ) {
		return array();
	}

	return $response['headers'];
}

View all references View on Trac View on GitHub

Uses	Description
is_wp_error()`wp-includes/load.php`	Checks whether the given variable is a WordPress Error.

Used by	Description
wp_get_http()`wp-includes/deprecated.php`	Perform a HTTP HEAD or GET request.
wp_get_http_headers()`wp-includes/functions.php`	Retrieves HTTP Headers from URL.
WP_SimplePie_File::__construct()`wp-includes/class-wp-simplepie-file.php`	Constructor.
_fetch_remote_file()`wp-includes/rss.php`	Retrieve URL headers and content using WP HTTP Request API.

Changelog

Version	Description
4.6.0	Return value changed from an array to an WpOrgRequestsUtilityCaseInsensitiveDictionary instance.
2.7.0	Introduced.

User Contributed Notes

vee 6 years ago

The returned value of wp_remote_retrieve_headers($response) will be something like this…

Requests_Utility_CaseInsensitiveDictionary::__set_state(array(
   'data' => 
  array (
    'server' => 'nginx/1.10.3 (Ubuntu)',
    'date' => 'Wed, 09 Jan 2019 07:25:38 GMT',
    'content-type' => 'application/octet-stream',
    'content-length' => '1438086',
    'last-modified' => 'Tue, 01 May 2018 04:56:08 GMT',
    'etag' => '"5ae7f368-15f186"',
    'accept-ranges' => 'bytes',
  ),
))

To access only one value:

$headerResult = wp_remote_retrieve_headers($response);
$headerResult['content-length'];

You can just type in the array key.

To get the whole array:

$headerResult = wp_remote_retrieve_headers($response);
$headerResultForPrint = (array)$headerResult;
print_r($headerResultForPrint);

You have to use type cast (array).

wp_remote_retrieve_headers( array|WP_Error $response ): WpOrgRequestsUtilityCaseInsensitiveDictionary|array

In this article