PHP-Fehler debuggen und beheben: kompletter Leitfaden

PHP-Fehler wirken oft kryptisch, aber fast jede Fehlermeldung weist direkt auf die Ursache hin, wenn man weiß, wo man hinschauen muss. Aktivieren Sie zunächst die Fehlerberichterstattung, um Fehler sichtbar zu machen, werfen Sie dann einen Blick in die passende Logdatei und gehen Sie die häufigsten Fehlerarten Schritt für Schritt an. Mit den richtigen Einstellungen in PHP und Plesk lösen Sie die meisten Probleme innerhalb weniger Minuten.

Arten von PHP-Fehlern erkennen

PHP kennt verschiedene Fehlerstufen, und die Art des Fehlers bestimmt, wie dringend Sie handeln müssen.

• Parse Error: ein Syntaxfehler, zum Beispiel ein vergessenes Semikolon oder eine fehlende geschweifte Klammer. Die Website funktioniert meist gar nicht mehr.
• Fatal Error: eine Funktion oder Klasse existiert nicht, oder eine Datei kann nicht geladen werden. Häufig die Ursache für eine weiße Seite.
• Warning: etwas läuft schief, aber das Skript läuft weiter. Zum Beispiel ein fehlender Array-Wert.
• Notice/Deprecated: weniger schwerwiegend, weist aber oft auf veralteten Code hin, der bei einer neueren PHP-Version Probleme verursachen kann.

Eine Meldung wie Fatal error: Uncaught Error: Call to undefined function bedeutet wörtlich, dass PHP eine Funktion nicht kennt, zum Beispiel weil ein Plugin oder Modul fehlt.

Error Reporting und Logging einrichten

Um Fehler beheben zu können, müssen Sie sie zunächst sehen können. Standardmäßig ist die Anzeige von Fehlern auf einer Live-Website oft deaktiviert, und das zu Recht: Sie möchten Besuchern keine Fehlermeldungen mit Serverpfaden anzeigen. Stattdessen protokollieren Sie Fehler in einer Datei.

Setzen Sie in Ihrer php.ini oder über eine .user.ini Folgendes:

• display_errors = Off (auf Produktion)
• log_errors = On
• error_reporting = E_ALL
• error_log = /pfad/zu/php_errors.log

In Plesk finden Sie pro Domain einfach die PHP-Einstellungen und das zugehörige Fehlerprotokoll unter dem Bereich „PHP-Einstellungen“ und „Logdateien“, sodass Sie nicht selbst in Konfigurationsdateien suchen müssen.

Häufige Fehler beheben

Die meisten PHP-Fehler fallen in eine begrenzte Anzahl von Kategorien:

• Undefined function/class: Prüfen Sie, ob die richtige PHP-Erweiterung aktiviert ist, oder ob eine Datei mit require/include nicht geladen wurde.
• Undefined variable/array key: Prüfen Sie, ob eine Variable existiert, bevor Sie sie verwenden, zum Beispiel mit isset().
• Memory limit exceeded: Erhöhen Sie das memory_limit in der php.ini, finden Sie aber auch heraus, warum ein Skript so viel Speicher benötigt.
• Maximum execution time exceeded: Ein Skript dauert zu lange, oft durch eine aufwendige Abfrage oder einen externen Aufruf ohne Timeout.
• Class not found: meist ein fehlender Autoloader, zum Beispiel weil composer install vergessen wurde.

Nach einem Update Ihrer Website oder einem Wechsel der PHP-Version können plötzlich neue Fehlermeldungen auftauchen, weil veralteter Code nicht mehr kompatibel ist. Testen Sie daher nach jedem PHP-Versionswechsel die wichtigsten Seiten Ihrer Website.

Schritt-für-Schritt-Plan bei weißer Seite oder 500er Fehler

Eine weiße Seite (‚White Screen of Death‘) oder ein interner Serverfehler zeigt oft keine direkte Fehlermeldung auf dem Bildschirm an. Folgen Sie diesem Schritt-für-Schritt-Plan, um die Ursache schnell zu finden.

Für E-Mail-bezogene PHP-Skripte, wie Kontaktformulare, die E-Mails versenden, ist es auch ratsam zu prüfen, ob Ihre geschäftliche E-Mail korrekt konfiguriert ist, damit Fehlermeldungen nicht versehentlich im Spamfilter verschwinden. Zweifeln Sie, ob Ihr Hosting gut für die Fehlersuche eingerichtet ist, dann werfen Sie einen Blick auf die Möglichkeiten von Webhosting mit Plesk und Logzugang. Kommen Sie nicht weiter, finden Sie weitere Erklärungen in der Wissensdatenbank.