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

Retrieve only the headers from the raw response.

Contents

Description

Top ↑

See also

Top ↑

Parameters

$response array|WP_Error Required
HTTP response.

Top ↑

Return

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

Top ↑

Source

File: wp-includes/http.php. View all references 

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

	return $response['headers'];
}

View on Trac View on GitHub

Top ↑

Top ↑

Uses

Uses
Uses Description
is_wp_error() wp-includes/load.php

Checks whether the given variable is a WordPress Error.

Top ↑

Changelog

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

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by vee —

    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).

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