mitmario.dev

Kopfzeilen und Statuscodes

PHP Sandbox 4 Min Lesezeit 4 BeispieleLektion 4 von 7

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

Eine Kopfzeile, bevor etwas rausgeht
<?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

Zu spät ist zu spät
<?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

Eine eigene 404
<?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

Eine Antwort, die 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, kostenlos

Zu 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.