WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_get_http_headers()

wp_get_http_headers( string $url, bool $deprecated = false ): WpOrgRequestsUtilityCaseInsensitiveDictionary|false

In this article

Back to top

Retrieves HTTP Headers from URL.

Parameters

$urlstringrequired
URL to retrieve HTTP headers from.
$deprecatedbooloptional
Not Used.

Default:false

Return

WpOrgRequestsUtilityCaseInsensitiveDictionary|false Headers on success, false on failure.

Source

function wp_get_http_headers( $url, $deprecated = false ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '2.7.0' );
	}

	$response = wp_safe_remote_head( $url );

	if ( is_wp_error( $response ) ) {
		return false;
	}

	return wp_remote_retrieve_headers( $response );
}

View all references View on Trac View on GitHub

UsesDescription
wp_remote_retrieve_headers()wp-includes/http.php

Retrieves only the headers from the raw response.

wp_safe_remote_head()wp-includes/http.php

Retrieves the raw response from a safe HTTP request using the HEAD method.

_deprecated_argument()wp-includes/functions.php

Marks a function argument as deprecated and inform when it has been used.

is_wp_error()wp-includes/load.php

Checks whether the given variable is a WordPress Error.

Show 2 moreShow less
Used byDescription
do_enclose()wp-includes/functions.php

Checks content for video and audio links to add as enclosures.

Changelog

VersionDescription
1.5.1Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Sergio Scabuzzo
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Use the returned class’ (WpOrgRequestsUtilityCaseInsensitiveDictionary) methods to get usable data:

    $response = wp_get_http_headers( 'https://wordpress.org' );
print_r( $response->getAll() );

    Array
    (
    [server] => nginx
    [date] => Sat, 09 Sep 2023 04:27:52 GMT
    [content-type] => text/html; charset=UTF-8
    [vary] => Accept-Encoding
    [strict-transport-security] => max-age=3600
    [x-olaf] => ⛄[link] => Array
    (
    [0] => ; rel=”https://api.w.org/”
    [1] => ; rel=”alternate”; type=”application/json”
    [2] => ; rel=shortlink
    )

    [x-frame-options] => SAMEORIGIN
    [content-encoding] => gzip
    [x-nc] => EXPIRED ord 1
    )

    print_r($response->offsetGet('server'));

    nginx

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