wp_get_http_headers() の使い方｜説明・引数・注意点

HTTP・REST・Ajax

wp_get_http_headers() は、URLにアクセスし、レスポンスヘッダーだけを取得する関数です。

2026.10.03

説明

wp_get_http_headers() は、URLにアクセスし、レスポンスヘッダーだけを取得する関数です。

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

ヘッダー。取得できなければ false。

$headers = wp_get_http_headers( 'https://example.com/' );

wp_remote_head() に置き換えている。この関数は、内部で宛先を検証する wp_safe_remote_head() を使っている。ユーザー入力のURLで wp_remote_head() に置き換えると、安全性が下がる。
戻り値が、失敗の場合の、確認をしていない。
ユーザー入力のURLにも使える（宛先は検証される）。wp_remote_head() は、宛先を検証しない。

NG例

$headers = wp_get_http_headers( $url );
echo $headers['content-type']; // 失敗したときの、確認がない

OK例

$response = wp_remote_head( $url );
if ( ! is_wp_error( $response ) ) {
	$type = wp_remote_retrieve_header( $response, 'content-type' );
}