mitmario.dev

Wenn doch etwas durchkommt

PHP Sandbox 4 Min Lesezeit 4 BeispieleLektion 6 von 8

Eine Seitenfunktion wirft eine Ausnahme, und niemand fängt sie. Dann bricht die Seite mitten im Satz ab. Ob der Besucher dabei einen Stacktrace und den Status 200 bekommt, hängt an zwei Einstellungen. Auffangen kannst du das an einer Stelle, mit set_exception_handler() aus Lektion 7.5 im Front Controller. Durch den geht ja jede Anfrage.

Die 200 ist das Schlimmste daran

Ein Fehler mitten in der Seite
<?php

declare(strict_types=1);

// Eine ganz normale Seite. Die Funktion unten findet den Preis
// nicht und wirft. Gefangen wird nirgends.

function preisVon(string $artikel): int
{
    throw new RuntimeException("Kein Preis für " . $artikel);
}

echo "<!doctype html><html lang=\"de\"><head><meta charset=\"utf-8\">";
echo "<title>Preisliste</title></head><body>\n";
echo "<h1>Preisliste</h1>\n";
echo "<p>Kaffee: ", number_format(preisVon("kaffee") / 100, 2, ",", "."), " Euro</p>\n";
echo "<p>Diese Zeile kommt nie an.</p>\n";
echo "</body></html>";

Im ersten Beispiel steht die Überschrift da, dann fängt der Absatz an, und mitten im Satz ist Schluss. Dahinter kommt die Meldung mit Stacktrace und dem vollen Pfad der Datei auf dem Server, denn in diesem Kurs ist display_errors an. Der Status im Reiter Netzwerk ist 200.

Eine Überwachung, die die Seite jede Minute abruft, bekommt damit ein „alles in Ordnung“. Ein Browser legt die Antwort in seinen Zwischenspeicher, als wäre sie eine richtige Seite. Eine Suchmaschine nimmt die halbe Seite mit Stacktrace in ihren Bestand auf. Und wer sie dort findet, liest die Namen der Klassen, die Verzeichnisse und die Zeilennummer.

Mit display_errors = Off kommt es auf einen zweiten Schalter an. Ohne Ausgabepuffer, wie hier in der Sandbox mit output_buffering = 0, endet die Seite mitten im Satz, und der Status bleibt 200. Mit dem Puffer aus der php.ini-production, also output_buffering = 4096, setzt PHP bei einer kleinen Seite selbst eine 500. Die halbe Seite steht trotzdem darin.

Ein Handler ist die halbe Antwort

Der Handler allein reicht nicht
<?php

declare(strict_types=1);

// Derselbe Fehler, diesmal mit einem Handler. Seine Ausgabe landet
// hinter der halben Seite, und davor steht eine Warnung.

set_exception_handler(function (Throwable $fehler) {
    http_response_code(500);
    echo "<p>Da ist etwas schiefgegangen.</p>";
});

function preisVon(string $artikel): int
{
    throw new RuntimeException("Kein Preis für " . $artikel);
}

echo "<!doctype html><html lang=\"de\"><head><meta charset=\"utf-8\">";
echo "<title>Preisliste</title></head><body>\n";
echo "<h1>Preisliste</h1>\n";
echo "<p>Kaffee: ", number_format(preisVon("kaffee") / 100, 2, ",", "."), " Euro</p>\n";
echo "</body></html>";

Im zweiten Beispiel ist ein Handler eingehängt, gebaut wie der aus der Lektion über Fehler im Betrieb. Nur setzt er zuerst den Status 500. Gerufen wird er auch, und sein Satz steht auf der Seite, nur eben hinter der halben Seite und angeklebt an den Absatz, der nie fertig wurde.

Dazwischen steht eine Warnung, in der Sandbox mit PHP 8.5 http_response_code(): Cannot set response code - headers already sent, und dahinter in Klammern die Zeile, ab der die Ausgabe lief. Unter PHP 8.2 scheitert derselbe Aufruf ohne Meldung, und die Antwort bleibt eine 200.

Es ist derselbe Fehler wie bei header() nach der ersten Ausgabe. Kopfzeilen gehen vor dem Rumpf über die Leitung. Ohne Ausgabepuffer, wie hier mit output_buffering = 0, sind sie mit dem ersten echo weg, und damit steht auch der Status fest. Der Handler kommt mit seiner 500 zu spät. Die Antwort ist längst als 200 unterwegs, und unter der kaputten Seite steht jetzt auch noch ein beruhigender Satz.

Der Puffer hält die Antwort zurück

Mit Puffer fliegt die halbe Seite weg
<?php

declare(strict_types=1);

// Zwei Zeilen Unterschied zum Beispiel davor: ob_start() ganz oben
// und ob_end_clean() als erste Zeile im Handler.

ob_start();

set_exception_handler(function (Throwable $fehler) {
    ob_end_clean();
    http_response_code(500);

    error_log("[500] " . get_class($fehler) . ": " . $fehler->getMessage());

    echo "<!doctype html><html lang=\"de\"><head><meta charset=\"utf-8\">";
    echo "<title>Da ist etwas schiefgegangen</title></head><body>\n";
    echo "<h1>Da ist etwas schiefgegangen</h1>\n";
    echo "<p>Der Fehler ist notiert. Versuch es gleich noch einmal.</p>\n";
    echo "</body></html>";
});

function preisVon(string $artikel): int
{
    throw new RuntimeException("Kein Preis für " . $artikel);
}

echo "<!doctype html><html lang=\"de\"><head><meta charset=\"utf-8\">";
echo "<title>Preisliste</title></head><body>\n";
echo "<h1>Preisliste</h1>\n";
echo "<p>Kaffee: ", number_format(preisVon("kaffee") / 100, 2, ",", "."), " Euro</p>\n";
echo "</body></html>";

ob_start() ganz oben schaltet den Ausgabepuffer ein. Alles, was danach mit echo geschrieben wird, sammelt PHP erst im Speicher. Damit ist auch noch keine Kopfzeile unterwegs. Geht alles gut, schickt PHP den Puffer am Ende von selbst hinaus. Geht etwas schief, ruft der Handler als Erstes ob_end_clean(), das den Puffer wegwirft, ohne ihn auszugeben. Erst danach setzt er den Status und schreibt seine eigene Seite.

Beim dritten Beispiel steht im Reiter Netzwerk 500 Internal Server Error, und im Rumpf ist nur noch die Fehlerseite übrig. Von der Preisliste bleibt nichts.

Was in die Antwort gehört und was ins Protokoll

Auf der Fehlerseite im Beispiel steht weder Klassenname noch Meldung noch Zeilennummer, aus demselben Grund wie in Lektion 15.5. Für dich ist eine Meldung ein Hinweis. Für jemanden, der die Anwendung auseinandernehmen will, ist sie ein Bauplan.

Die Meldung selbst schreibt error_log() auf den Fehlerkanal, und bei einem laufenden Server ist das sein Protokoll. Nach dem dritten Beispiel holt tail -3 /tmp/lern-web.log eine Zeile heraus, die nach Datum und Uhrzeit mit [500] RuntimeException: Kein Preis für kaffee weitergeht.

Beim Entwickeln willst du die Meldung dagegen sehen, und dafür gibt es die Betriebsart aus der Konfiguration. In entwicklung darf der Handler die Meldung ausgeben, in betrieb bleibt es bei dem einen Satz. Der Handler ist beide Male derselbe, nur was er hinschreibt, hängt an einem if.

Was am Handler vorbeigeht

Was am Handler vorbeigeht
<?php

declare(strict_types=1);

// Derselbe Handler, und diesmal geht der Speicher aus. Das ist kein
// Throwable, der Handler wird also gar nicht erst gerufen.

ob_start();

set_exception_handler(function (Throwable $fehler) {
    ob_end_clean();
    http_response_code(500);
    echo "<h1>Da ist etwas schiefgegangen</h1>";
});

echo "<h1>Preisliste</h1>\n";

ini_set("memory_limit", "2M");

$riesig = str_repeat("Kaffee", 50000000);

echo "<p>Diese Zeile kommt nie an.</p>\n";

set_exception_handler() fängt alles, was ein Throwable ist. In PHP 8 sind das die meisten Abbrüche. Auch der Aufruf einer Funktion, die es nicht gibt, kommt dort als Error an. Eine Warnung dagegen nie, denn nach ihr läuft das Programm einfach weiter.

Im vierten Beispiel geht der Speicher aus, und das ist so wenig ein Throwable wie ein abgelaufenes Zeitlimit. Der Handler wird nicht gerufen, und im Reiter Netzwerk steht wieder 200. Der Besucher bekommt nur noch die Meldung selbst. Sogar die Überschrift aus dem Puffer ist weg, denn bei einem Speicherabbruch verwirft PHP alle Ausgabepuffer, statt sie auszugeben. Für diesen Rest gibt es register_shutdown_function(). In der Sandbox mit eingeschalteter Anzeige kommt aber auch die zu spät. Ein ob_end_clean() darin scheitert mit Failed to delete buffer. No buffer to delete, und der Status ist längst draußen.

Mit display_errors = Off setzt PHP bei diesem Abbruch selbst eine 500, und eine Shutdown-Funktion kann dann noch einen Satz für den Besucher schreiben. Die Meldung mit Pfad und Zeile bekommt er nicht zu sehen, obwohl der Handler nie gerufen wurde.

In der Aufgabe wirft die Preisliste einer kleinen Anwendung eine Ausnahme. Notizen gibt es dort keine, und Puffer und Handler fehlen noch ganz.

Zum Mitnehmen

Ein ob_start() ganz oben und ein Handler, der den Puffer zuerst wegwirft, machen aus einem ungefangenen Fehler eine 500 mit einer kurzen Seite. Was genau schiefging, steht nur im Protokoll. Einen Speicherabbruch fängt auch das nicht, dafür bleibt display_errors auf einem öffentlichen Server aus.

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.