Abschnitt 10 · Lektion 4
Kopfzeilen und Statuscodes
Ruft jemand eine Seite auf, die es gar nicht gibt, bekommt er von deinem Programm trotzdem eine 200
und text/html. Beides steht über dem Rumpf, in Statuszeile und Kopfzeilen. Für beides hat PHP eine
Funktion. header("Name: Wert") setzt eine Kopfzeile, http_response_code(404) den Statuscode.
Der Content-Type entscheidet, was der Browser daraus macht
<?php
declare(strict_types=1);
// Das header() steht vor der ersten Ausgabe, und darauf kommt es an.
header("Content-Type: text/plain; charset=UTF-8");
echo "Diese Antwort trägt text/plain.\n\n";
echo "Deshalb siehst du das hier als Zeichen und nicht als Überschrift:\n";
echo "<h1>Ich bin keine Überschrift</h1>\n"; Ohne dein Zutun schickt PHP Content-type: text/html; charset=UTF-8 mit, und deshalb hat der
Browser deine Ausgabe bisher als Markup gelesen und eine Seite daraus gebaut. Das kleine t stört
übrigens niemanden. Bei Namen von Kopfzeilen zählt Groß und Klein nicht.
Hier ist es umgekehrt. header() setzt text/plain, und plötzlich ist dieselbe Ausgabe nur noch
Text. Im Browser steht die Überschrift deshalb mit ihren spitzen Klammern da.
Auf demselben Weg erfährt der Browser, dass eine Antwort ein Bild ist, eine Textdatei zum
Herunterladen oder eine Antwort für ein anderes Programm. Dass deine Umlaute ankommen, liegt am
Zusatz charset=UTF-8. Er sagt, in welcher Kodierung die Zeichen gemeint sind.
Die Kopfzeile selbst siehst du auf zwei Wegen. Im Reiter Netzwerk steht bei jeder Seite die Antwort
mit ihren Kopfzeilen, darunter Content-Type. Die Antwort hier ist aber keine Seite, und dann
stehen dort nur Methode und Pfad. Ohne Seite reicht niemand die Kopfzeilen herüber. Dann hilft das
Terminal. curl -si localhost:3000/ holt dieselbe Antwort noch einmal vom Server und schreibt sie
so hin, wie sie über die Leitung geht, also Statuszeile, Kopfzeilen, Leerzeile, Rumpf. Das ist die
Form vom Anfang dieses Abschnitts, diesmal echt.
Kopfzeilen vor der ersten Ausgabe
<?php
declare(strict_types=1);
echo "<!doctype html>\n";
echo "<html lang=\"de\"><head><meta charset=\"utf-8\"><title>Zu spät</title></head>\n";
echo "<body>\n";
echo "<h1>Zu spät</h1>\n";
// Ab hier sind die Kopfzeilen der Antwort schon unterwegs.
header("Content-Type: text/plain; charset=UTF-8");
http_response_code(404);
echo "<p>Sind die Kopfzeilen schon raus? " . (headers_sent() ? "ja" : "nein") . "</p>\n";
echo "<p>Du liest das als Seite und nicht als Zeichen: text/plain kam nie an.</p>\n";
echo "</body></html>\n"; Kopfzeilen und Statuscode lassen sich nur setzen, bevor das erste Zeichen ausgegeben ist. Das liegt
am Aufbau der Antwort. Erst gehen Statuszeile und Kopfzeilen über die Leitung, dann die Leerzeile,
dann der Rumpf. Sobald dein erstes echo gelaufen ist, hat PHP die Kopfzeilen schon verschickt. Sie
sind weg, und zurückholen lässt sich nichts.
So ist es jedenfalls auf dem Server dieses Kurses, denn dort steht output_buffering auf 0. In den
php.ini-Vorlagen, die PHP mitbringt, steht dagegen output_buffering = 4096. Dann sammelt PHP die
ersten 4 KB der Ausgabe, bevor es etwas verschickt, und ein zu spätes header() geht gut, solange
die Seite klein ist. An dem Tag, an dem sie wächst, bricht es. Ich setze Kopfzeilen deshalb immer
vor die erste Ausgabe, auch wo es ohne Warnung durchginge.
Im Beispiel gibt headers_sent() ja zurück. Die Antwort trägt weiter text/html, und der
Statuscode ist 200 geblieben. Der Versuch hat also nichts bewirkt, und PHP sagt das auch. Es meldet
Cannot modify header information - headers already sent by und nennt dazu die Stelle, an der die
Ausgabe angefangen hat, und die Zeile, in der du es zu spät versucht hast. Mit diesen beiden Angaben
findest du die Stelle schnell.
Die Meldung steht mitten auf der Seite, zwischen deiner Überschrift und dem nächsten Absatz. Das
kommt vom -d display_errors=1 im Startbefehl des Servers. Der Server dieses Kurses zeigt Fehler
dort an, wo sie passieren, so wie man es beim Entwickeln haben will. Beim Prüfen steht dieselbe
Meldung zusätzlich im Terminal auf dem Fehlerkanal, und um diesen Kanal geht es in der letzten Zeile
jeder Prüfliste.
Auf einem Server im Betrieb steht display_errors auf Off, so wie in php.ini-production. Dort
landet die Meldung nur im Protokoll, und man sucht den Fehler oft lange. Hier siehst du ihn sofort.
Der Dateipfad in der Meldung ist der Ort, an dem deine Datei auf der Maschine liegt.
Die Meldung kommt auch bei etwas, das gar nicht wie Ausgabe aussieht, etwa bei einem Leerzeichen
hinter einem schließenden ?> oder einer Leerzeile danach. Einen einzelnen Umbruch direkt hinter
?> schluckt PHP noch, das steht in Lektion 1.3. Alles, was danach kommt, geht unverändert hinaus,
und dann sind die Kopfzeilen weg.
Einen Statuscode selbst setzen
<?php
declare(strict_types=1);
http_response_code(404);
echo "<!doctype html>\n";
echo "<html lang=\"de\"><head><meta charset=\"utf-8\"><title>Nicht gefunden</title></head>\n";
echo "<body>\n";
echo "<h1>Nicht gefunden</h1>\n";
echo "<p>Diese Seite antwortet mit 404 und sieht trotzdem aus wie jede andere.</p>\n";
echo "<p>Der Statuscode steht nicht im Text, sondern in der Statuszeile darüber.</p>\n";
echo "</body></html>\n"; http_response_code(404) macht aus einer ganz normalen Antwort eine, die „gibt es nicht“ bedeutet.
Der Text der Seite bleibt dabei gleich. Was ein Mensch liest, steht im Rumpf. Was ein Programm
liest, steht in der Statuszeile. Im Browser sieht die Seite aus wie jede andere, aber im Reiter
Netzwerk steht bei ihr eine 404 statt der 200, die bisher an jeder Zeile stand.
Warum das mehr ist als eine Textausgabe, sieht man an denen, die keine Augen haben. Eine Suchmaschine nimmt eine Seite mit 404 nicht in den Index. Ein Programm, das deine Seite abfragt, merkt am Statuscode, dass etwas fehlt, ohne den Text lesen zu müssen.
Eine Seite, die „Diese Seite gibt es nicht“ schreibt und dabei 200 sendet, sagt also zwei verschiedene Dinge an zwei verschiedene Leser. Man nennt das eine weiche 404.
Wenn die Antwort gar keine Seite ist
<?php
declare(strict_types=1);
$preise = ["kaffee" => 850, "brot" => 320, "aepfel" => 240];
header("Content-Type: application/json");
echo json_encode($preise, JSON_PRETTY_PRINT); Diesmal kommt JSON zurück, wie in Lektion 8.3, und dazu die passende Kopfzeile application/json.
So antwortet eine Schnittstelle (englisch API, kurz für application programming interface), die ein
anderes Programm abfragt.
Der Browser zeigt dabei den nackten Text. Er hat etwas bekommen, das keine Seite ist, und ohne
text/html lässt sich daraus keine Seite bauen. Die Kopfzeile dazu siehst du wie beim ersten
Beispiel im Terminal. curl -si localhost:3000/ schreibt Content-Type: application/json über die
Leerzeile und das JSON darunter.
Diese drei Zeilen sind schon eine kleine Schnittstelle. Was ihr noch fehlt, ist der Fall, in dem es die gewünschten Daten nicht gibt.
In der Aufgabe bekommt der Hofladen so eine kleine Schnittstelle für seine Seiten.
Zum Mitnehmen
Statuscode und Kopfzeilen gehen vor dem Rumpf hinaus, deshalb lassen sie sich nur vor der ersten Ausgabe setzen. Der Content-Type sagt dem Browser, ob er eine Seite bauen soll, und eine 404 steht in der Statuszeile, wo ein Programm sie liest.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.
Was in dieser Lektion steckt
-
Artikel mit 4 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.