get_headers

(PHP 5, PHP 7, PHP 8)

get_headers — Ruft alle Header ab, die der Server als Antwort auf einen HTTP-Request versendet

Beschreibung

get_headers(string $url, bool $associative = false, ?resource $context = null): array|false

get_headers() gibt ein Array zurück, das die vom Server in seiner Antwort auf eine HTTP-Anfrage gesendeten Header enthält.

Parameter-Liste

url

Die Ziel-URL.

associative

Wenn der optionale Parameter associative auf einen Wert ungleich 0 gesetzt wird, parst get_headers() die Serverantwort und setzt die entsprechenden Schlüssel des Arrays.

context

Eine gültige Kontextressource, die mit stream_context_create() erstellt wurde oder null um den Standard-Kontext zu verwenden.

Rückgabewerte

Gibt ein indexbasiertes oder ein assoziatives Array zurück, das die übermittelten Header enthält. Im Fehlerfall wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 Der Typ des Parameters associative wurde von int in bool geändert.
7.1.0 Der Parameter context wurde hinzugefügt.

Beispiele

Beispiel #1 get_headers()-Beispiel

<?php
$url = 'http://www.example.com';

print_r(get_headers($url));

print_r(get_headers($url, true));
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [0] => HTTP/1.1 200 OK
    [1] => Date: Sat, 29 May 2004 12:28:13 GMT
    [2] => Server: Apache/1.3.27 (Unix)  (Red-Hat/Linux)
    [3] => Last-Modified: Wed, 08 Jan 2003 23:11:55 GMT
    [4] => ETag: "3f80f-1b6-3e1cb03b"
    [5] => Accept-Ranges: bytes
    [6] => Content-Length: 438
    [7] => Connection: close
    [8] => Content-Type: text/html
)

Array
(
    [0] => HTTP/1.1 200 OK
    [Date] => Sat, 29 May 2004 12:28:14 GMT
    [Server] => Apache/1.3.27 (Unix)  (Red-Hat/Linux)
    [Last-Modified] => Wed, 08 Jan 2003 23:11:55 GMT
    [ETag] => "3f80f-1b6-3e1cb03b"
    [Accept-Ranges] => bytes
    [Content-Length] => 438
    [Connection] => close
    [Content-Type] => text/html
)

Beispiel #2 get_headers()-Beispiel unter Verwendung von HEAD

<?php
// Standardmäßig verwendet get_headers einen GET-Request um die Header
// abzurufen. Wenn stattdessen ein HEAD-Request durchgeführt werden soll,
// muss ein Stream-Kontext verwendet werden:
$context = stream_context_create(
[
'http' => array(
'method' => 'HEAD'
)
]
);
$headers = get_headers('http://example.com', false, $context);
?>

Siehe auch