WP_DEBUG 設定ツール

本番サイトを壊さずにデバッグログを有効化

ブラウザ内で動きます。何もアップロードされません。

このサイトはどこにありますか？

これは文言だけでなく、推奨される設定内容そのものを変えます。本番サイトでの安全な設定は、手元のパソコンで役立つ設定とは本質的に異なります。

本番サイトローカル / ステージング

判定

—

オプション

WP_DEBUG — デバッグを有効化通常は表示されない PHP の notice・warning・非推奨（deprecation）を WordPress に出力させます。 WP_DEBUG_LOG — ファイルに記録エラーを画面ではなく wp-content/debug.log に出力します。本番サイトでも安全にデバッグできるようにする定数です。 WP_DEBUG_DISPLAY を false — 訪問者にエラーを表示しないこれがないと WP_DEBUG はページに PHP エラーを出力してしまいます。オフにすることがこのページで最も重要な設定です。ログをウェブルート外に書き出す多くのホストでは wp-content/debug.log は誰でも閲覧でき、そのまま取得されてしまいます。ウェブルートより上に移動すれば解決します。パスはお使いのサーバーに合わせて調整してください。 SAVEQUERIES — すべてのデータベースクエリを記録遅いページの原因究明に便利です。ただしすべてのリクエストでメモリを消費するため、終わったら必ずオフに戻してください。 SCRIPT_DEBUG — 未圧縮のコア JS/CSS を読み込むブロックエディターやコアスクリプトをデバッグする場合のみ役立ちます。

wp-config.php

これらは /* That's all, stop editing! */ と書かれた行より上に貼り付けてください。この行より下に書いた内容はすべて無視されます。WP_DEBUG が「何も効かない」と報告する人がこれほど多いのは、これが原因です。

WP_DEBUG 設定ツールについて

エラーを訪問者に表示するのではなく、ログファイルに書き出す WP_DEBUG 定数を生成します。多くのサイトがコピーする標準の WP_DEBUG スニペットは PHP エラーを公開してしまいますが、これはそうなりません。

こんなツールも役立つかもしれません

WordPress PHP 致命的エラー解読ツール

エラーを貼り付けるだけ。原因のプラグインを特定します。

wp-config.php ジェネレーター

2014年のブログ記事からコピペせずに、正しい wp-config.php を作成

よくある質問

稼働中のサイトで WP_DEBUG を有効にしても安全ですか？

WP_DEBUG_DISPLAY を false に設定した場合だけです。単体では、WP_DEBUG は PHP の通知や警告を、サーバーの絶対ファイルパスも含めて、訪問者が読み込むページに直接出力します。ほとんどのチュートリアルはあの一行だけを渡して終わりです。WP_DEBUG_LOG と WP_DEBUG_DISPLAY を false と組み合わせれば安全です。

WordPress のデバッグログはどこに出力されますか？

デフォルトでは wp-content/debug.log です。知っておくべきことがあります。多くのホストではそのファイルが公開状態で取得可能で、誰でもブラウザからリクエストできます。代わりに WP_DEBUG_LOG にパスを渡し、Web ルートより上にログを書き出すこともできます。これはこのツールが生成してくれます。

WP_DEBUG を true にしたのに何も起きません。なぜですか？

ほとんどの場合、その定数を wp-config.php の「編集が必要なのはここまでです！」の行より下に追加したためです。その行以降はすべて無視されます。上に移動してください。