WP_DEBUG_LOG: Fehlermeldungen für produktive WordPress-Seiten ausgeben

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

Schaue unsere Datenschutzverordnung an

Das könnte dich auch interessieren

Anleitung: WooCommerce mit den Gutenberg Blocks verwenden

Seit WordPress 5.0 hast du die Möglichkeit, WooCommerce Produkte einfach per Drag & Drop in deine Beiträge und Seiten einzufügen - der neue Gutenberg Ed ...

Mehr erfahren

Neues Plugin: B2B Market für WooCommerce

B2B Market ist die erste deutschsprachige Lösung für B2B-Shops mit WooCommerce und WordPress. Verkaufe an B2B und an B2C, erfülle die gesetzlichen Anfor ...

Mehr erfahren

WooCommerce Projekte vorgestellt: Die Beer Ambassadors - Bierspezialitäten im Abo

Die Beer Ambassadors haben einen ganz besonderen Onlineshop auf die Beine gestellt - mit WooCommerce und German Market. Wir haben die beiden Gründer Thoma ...

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>