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_headers()`wp-includes/functions.php`	Retrieves HTTP Headers from URL.
wp_get_http()`wp-includes/deprecated.php`	Perform a HTTP HEAD or GET request.
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 7 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