Weiße Seite bei PHP Fehler statt Bildergalerie erkennen

Du rufst deine Bildergalerie auf und bekommst nur eine leere, weiße Fläche. Kein Bild, kein Text, keine Fehlermeldung. Eine Weiße Seite bei PHP Fehler entsteht, wenn das Script auf einen schweren Fehler stößt und die Verarbeitung abbricht, die Meldung dazu aber unterdrückt wird. Auf den ersten Blick wirkt das ratlos machend, doch der Weg zur Ursache ist klar vorgezeichnet.

WeiÃŸe Seite statt Bildergalerie: PHP-Fehler erkennen: Leeres weisses Browserfenster auf einem Laptop neben einer Log-Schriftrolle, in der eine Lupe ei

Warum eine weiße Seite bei PHP Fehler bleibt

PHP baut die Seite Zeile für Zeile auf. Tritt mittendrin ein fataler Fehler auf, stoppt die Verarbeitung sofort. Ist die Anzeige von Fehlern auf dem Server abgeschaltet, wird auch keine Meldung gesendet. Der Browser erhält dann eine fast leere Antwort und stellt sie als weiße Fläche dar. Wichtig: Ein fataler Fehler kann das Script schon vor der ersten Ausgabe beenden, sodass im Browser nichts ankommt, die Meldung aber trotzdem im Logfile steht. Deshalb lohnt der Blick ins Log immer.

Weiße Seite bei PHP Fehler: Ausgabe sichtbar machen

Der erste Schritt ist, die verborgene Meldung ans Licht zu holen. Schreibe dafür ganz oben in die aufgerufene PHP-Datei, direkt nach dem öffnenden Tag, diese beiden Zeilen:

ini_set('display_errors', 1);

error_reporting(E_ALL);

Die erste Zeile schaltet die Anzeige im Browser ein, die zweite sorgt dafür, dass wirklich alle Fehlerarten gemeldet werden. Lade die Seite danach neu. Statt der weißen Fläche erscheint nun die Fehlermeldung mit Dateiname und Zeilennummer. Tritt der Fehler allerdings schon beim Laden einer eingebundenen Datei auf, bevor diese Zeilen greifen, bleibt der Browser leer und du musst direkt ins Logfile schauen.

Das Logfile heißt meist error_log und liegt im selben Ordner wie die aufgerufene Datei oder zentral im Konto deines Hosters. Es notiert jeden schweren Fehler mit Datum, Dateiname und Zeilennummer. Allein diese Angaben führen oft direkt zur fehlerhaften Stelle.

Die häufigsten Auslöser für weiße Seite bei PHP Fehler

Hinter einer weißen Seite stecken meist nur wenige Fehlerarten. Die Tabelle ordnet sie der jeweiligen Meldung im Logfile zu, so wie sie dort wörtlich auftaucht.

Fehlerart	Hinweis im Logfile
Tippfehler im Code	Parse error: syntax error
Fehlende oder falsch verlinkte Datei	Failed to open required
Zu wenig Arbeitsspeicher	Allowed memory size of ... bytes exhausted
Unpassende PHP-Version	Call to undefined function

Ein Parse error entsteht oft durch ein vergessenes Semikolon oder eine fehlende Klammer nach einer eigenen Änderung am Quelltext. Bearbeite Code-Dateien deshalb nur mit einem Editor für Webdateien, der die Syntax farblich hervorhebt, dann fallen solche Tippfehler eher auf. Die Meldung "Failed to open required" deutet auf einen falschen Pfad oder eine gelöschte Datei hin; beide lassen sich an der genannten Zeile schnell beheben.

Speicher und PHP-Version prüfen

Bricht die Galerie erst beim Anzeigen vieler oder großer Bilder ab, ist meist der Arbeitsspeicher erschöpft. Im Logfile steht dann "Allowed memory size ... exhausted". Hebe das Limit an, indem du in der aufgerufenen Datei ergänzt:

ini_set('memory_limit', '256M');

256M ist ein praxistauglicher Wert für eine Galerie mit großen Fotos; manche Hoster erlauben die Änderung nur über die php.ini oder das Kundenmenü, nicht per ini_set. Erscheint dagegen "Call to undefined function", läuft womöglich eine zu alte oder zu neue PHP-Version. Stelle im Kundenmenü die vom Script empfohlene Version ein und rufe die Seite erneut auf.

Fehleranzeige danach wieder ausschalten

Sobald die Galerie wieder läuft, entferne die Zeile mit display_errors oder setze sie auf 0. Auf einer öffentlichen Seite sollen Besucher keine Pfade, Dateinamen oder Code-Auszüge sehen, denn solche Details erleichtern Angriffe. Schalte die Ausgabe also nur zur Fehlersuche ein und für den laufenden Betrieb wieder aus. Die Meldungen landen dann weiterhin im error_log, falls du später nachsehen musst.

So vermeidest du eine weiße Seite bei PHP Fehler

Die meisten weißen Seiten entstehen direkt nach einer Änderung am Quelltext. Wer ein paar Vorsichtsmaßnahmen beachtet, fängt Fehler ab, bevor sie die ganze Galerie lahmlegen. Diese Schritte haben sich bewährt.

Bearbeite Dateien zuerst auf einer Testkopie statt direkt am laufenden System.
Sichere eine funktionierende Fassung, bevor du größere Änderungen vornimmst.
Ändere wenige Zeilen auf einmal und rufe die Seite nach jeder Änderung neu auf.

Geht doch etwas schief, spielst du die letzte funktionierende Sicherung zurück und die Galerie läuft sofort wieder. Bleibt die Seite trotz richtigem Code leer und steht im Log eine Datenbankmeldung, prüfe zusätzlich, ob die Datenbank erreichbar ist und die Zugangsdaten in der Konfiguration stimmen. So bleibt der Schaden klein, und du suchst nicht unter Zeitdruck nach einem vergessenen Semikolon, während die Seite für Besucher leer bleibt.

Häufige Fragen

Bei der weißen Seite geht es vor allem darum, die versteckte Meldung sichtbar zu machen, das Logfile zu finden und die Anzeige danach wieder zu schließen.

Wie mache ich bei einer weißen Seite die Fehlermeldung sichtbar?

Schalte die Anzeige im Script kurz ein, indem du am Dateianfang ini_set('display_errors', 1); und error_reporting(E_ALL); ergänzt und die Seite neu lädst. Dann erscheint die bisher unterdrückte Meldung mit Dateiname und Zeilennummer im Browser.

Wo finde ich das error_log mit den PHP-Fehlern?

Die Datei error_log liegt meist im selben Ordner wie die aufgerufene Datei und notiert jeden schweren Fehler mit Datum, Dateiname und Zeilennummer. Steht dort Allowed memory size exhausted, hilft ein höheres memory_limit, zum Beispiel 256M, das du beim Hoster oder in der Konfiguration setzt.

Wie schalte ich die Fehleranzeige danach wieder aus?

Setze display_errors zurück auf 0 oder entferne die zuvor eingefügte ini_set-Zeile wieder, sobald du die Ursache gefunden hast. So sehen Besucher keine technischen Details mehr, während die schweren Fehler weiterhin im error_log landen.