get_headers

(PHP 5, PHP 7)

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

Beschreibung

get_headers ( string $url [, int $format = 0 [, resource $context ]] ) : array

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

Parameter-Liste

url

Der Ziel-URL.

format

Wenn der optionale Parameter format auf einen Wert ungleich 0 gesetzt wird, parst get_headers() die Serverantwort und setzt entsprechende Arrayschlüssel.

context

Eine gültige Context-Ressource, die mit stream_context_create() erstellt wurde.

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
7.1.0 Der context Parameter wurde hinzugefügt.
5.1.3 Die Funktion verwendet nun den Standard-Streamkontext, der mittels stream_context_set_default() gesetzt respektive verändert werden kann.

Beispiele

Beispiel #1 get_headers()-Beispiel

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

print_r(get_headers($url));

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

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() using HEAD example

<?php
// Standardmäßig verwendet get_headers einen GET-Request um die Header zu holen.
// Wenn statt dessen ein HEAD-Request durchgeführt werden soll, muss ein
// Stream-Kontext verwendet werden:
stream_context_set_default(
    array(
        'http' => array(
            'method' => 'HEAD'
        )
    )
);
$headers = get_headers('http://example.com');
?>

Siehe auch