WP_DEBUG_LOG: Fehlermeldungen für produktive WordPress-Seiten ausgeben

WP_DEBUG_LOG: Fehlermeldungen für produktive WordPress-Seiten ausgeben 1

Wer kennt das nicht? Irgendwas läuft schief mit WordPress, mit einer Konfiguration, einem Plugin oder Theme, und im Support fragt man nach etwaigen Fehlermeldungen.

Um Fehlermeldungen in WordPress zu aktivieren, gibt es die Konstante WP_DEBUG. Auf den Wert TRUE gesetzt, sorgt sie dafür, dass WordPress (bzw. PHP) auftretende Fehler mit entsprechenden Meldungen im Browser dokumentiert.

Auf einer produktiven Website sieht das in der Regel – hm – unvorteilhaft aus. Was tun?

Fehlermeldungen loggen

Mit folgenden Zeilen in der wp-config.php loggst du die Fehlermeldungen, anstatt dass sie im Browser die Nutzererfahrung auf deiner Webiste ruinieren:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'WP_DEBUG_LOG', true );

Ergebnis

  • Du bist im Debug-Modus.
  • Es wird kein Fehler im Browser angezeigt.
  • Alle Fehlermeldungen wandern in /wp-content/debug.log.

Obacht!

Vorsicht ist auch hier die Mutter der Porzellankiste, denn WP_DEBUG_LOG hat nicht umsonst den voreingestellten Wert FALSE. WP_DEBUG schreibt wirklich alles mit (Errors und Warnings) und WP_DEBUG_LOG übernimmt die Meldungen komplett in die Log-Datei. Die entsprechenden Zeilen im Core (load.php, wp_debug_mode()):

if ( WP_DEBUG ) {
 error_reporting( E_ALL );
 if ( WP_DEBUG_DISPLAY )
  ini_set( 'display_errors', 1 );
 elseif ( null !== WP_DEBUG_DISPLAY )
  ini_set( 'display_errors', 0 );
 if ( WP_DEBUG_LOG ) {
  ini_set( 'log_errors', 1 );
  ini_set( 'error_log', WP_CONTENT_DIR . '/debug.log' );
  }
 }

Je nachdem, was auf deiner Site gerade passiert, kann die Log-Datei also leicht in kürzester Zeit exorbitante Ausmaße annehmen, bis hin zu Gigabyte-Größen!

Verwende WP_DEBUG_LOG daher besser nur punktuell und lasse die Anweisungen keinesfalls einfach in der wp-config.php stehen.

Newsletter abonnieren

Das könnte dich auch interessieren

Lokale Installation von WordPress und WooCommerce

Über eine lokale Installation von WordPress auf deinem Computer kannst du WooCommerce testen, Updates einspielen und Anpassungen durchführen - alles r ...

Mehr erfahren

WooCommerce einrichten Teil 1 - Grundeinstellungen & Produkte

Aktualisiert am 18.09.2020 Die Onlineshop-Erweiterung WooCommerce ist ein mächtiges Werkzeug mit unzähligen Einstellungsmöglichkeiten. Der nachfolgen ...

Mehr erfahren

Online-Kurse mit WordPress erstellen und mit WooCommerce verkaufen

Online-Kurse sind zeitgemäß und vermitteln ortsunabhängiges Wissen an Lernende. Über den Verkauf von Online-Kursen mit WooCommerce kannst du dein eigen ...

Mehr erfahren

Kommentare

9 Kommentare

  1. klasse 🙂
    wusste ich noch nicht…

    hab das bisher immer so gelöst:
    @ini_set(‚log_errors‘,’On‘);
    @ini_set(‚display_errors‘,’On‘);
    @ini_set(‚error_log‘,’/path/wp_logs/php_error.log‘);

  2. @Markus Frank Bültge hat in seinem WordPress-Starter auch eine Implementierung mit ini_set(), noch ein wenig ausführlicher: https://github.com/bueltge/WordPress-Starter/blob/master/wp-config.php

  3. Danke für den Tipp! Das Snippet habe ich mir abgeheftet. 🙂

    Aber ich bin so ein Kandidat, der gerne vergisst, den Debug-mode wieder auszuschalten. Wie wäre es also, wenn man der Funktion so eine Art Zeitbegrenzung für das Loging mitgibt?. Das könnte man ja auf z.B. 5 min. einstellen. Dann könnte man das im Admin-Backend per Knopfdruck starten und laufen lassen. Wäre doch mal was für ein Plugin…

  4. @Heiko Mamerow Stimmt, ich würde das auch gerne mit einem Zeitfenster versehen wissen. Vielleicht mag sich jemand an ein Plugin wagen?

  5. Hallo zusammen,

    danke für den Response! Erst einmal zu den WordPress-Starter: Ich weiß nicht ob es Sinn macht WP_DEBUG_DISPLAY und WP_DEBUG_LOG gleichzeitig zu aktivieren, aber es ist auch nur ein Snippet. 🙂
    Das ini_set( ‚error_log‘, … ) wird von WordPress in der load.php seit Version 3.0.0 gesetzt, d.h. es würde das ini_set aus der wp-config.php wieder überschreiben.

    Generell würde ich den debug.log nicht aufheben, sondern sofort wieder löschen. Immerhin hat man über die URL auch Zugriff auf diese Datei und könnte als potentieller Angreifer fehlerhafte Plugins identifizieren.

    Ob ein Plugin Sinn macht um diese Log-Datei z.B. tagweise abzuspeichern, ist fraglich, denn die Action plugins_loaded/muplugins_loaded wird ja auch erst nach vielen anderen Includes / Logiken ausgeführt, welche dann nicht geloggt werden (siehe wp-settings.php).

    Gute wäre es vllt, wenn WordPress hier eine Überprüfung („Ist error_log schon gesetzt?“) oder eine weitere Konstante (jaja Konstanten sind evil) für die Log-Datei einführen würde.

    Viele Grüße,
    Chris

  6. […] Brückner hat im MarketPres-Blog beschrieben, wie du Fehlermeldungen in einer Datei loggen kannst, anstatt sie direkt in den Browser zu […]

  7. metricalart

    Hallo Chris,
    ich habe die einstellungen in der wp-config.php vorgenommen, wie beschrieben.
    es erscheint aber keine log-datei.

    legt sich die log-datei automatisch an? oder muss ich diese separat anlegen?
    Liebe Grüße, Andrea

  8. Hallöchen Andrea,

    vielen Dank für die Rückfrage. Generell sollte – wenn die Seite Fehler hat – die Datei automatisch angelegt werden. In deinem Fall kann das drei mögliche Gründe haben, wieso diese nicht erscheint:

    1. Deine Seite hat keine Fehler und erzeugt deshalb keine Ausgaben (super! :))
    2. Die Ordnerberechtigungen sind nicht korrekt (teste mal 755 auf wp-content)
    3. Ein anderes Plugin überschreibt hart den Ort für die Ausgabe der Datei (mal nach ini_set() suchen), oder eventuell sogar die komplette Fehlerausgabe (mal nach error_reporting() suchen).

    Ich hoffe es ist ersteres! 🙂

    Viele Grüße,
    Chris

  9. hallo und guten Abend

    sehr interessanter Beitrag – Sehr hilfreich:

    hab ein Plugin gefunden: https://wordpress.org/plugins/debug/
    wurde vor 2 Wochen neu released:

    Debug can help you to find errors in your wordpress website via editing wp-config.php file. you may enable error reporting by debug plugin. enable email notification on any run time bug in wordpress CMS/website.
    A brief Debug

    Ordered list:

    Debug in wordpress rewrite wp-config.php file via error_log function in php.
    if you don’t have file write permission. so don’t use this plugin.
    keep backup your wp-config file before save plugin setting.

    vg

Schreibe eine Antwort

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.

Du kannst folgende HTML Tags verwenden: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>