デバッグモードを有効にするには、WordPressインストール内の1つのファイルを編集する必要があります。簡単ですが、サイトを壊さないように注意して行う必要があります。以下に正しく設定するための手順を示します。
有効にすると、エラーをログに記録し、訪問者には非表示にし、WordPressがデバッグ情報をどのように処理するかを制御できます。これは、エラーを記録したいが公開表示は避けたい本番環境のサイトでは特に重要です。
wp-config.phpファイルの場所を確認する
デバッグモードを有効にする最初のステップは、wp-config.phpファイルを探すことです。このファイルはWordPressインストールのルートフォルダにあり、wp-content、wp-includes、wp-adminと同じ場所にあります。FTPソフト、ホスティングのコントロールパネルのファイルマネージャー、または開発サーバーで作業している場合はローカルアクセスで開けます。
変更を加える前にこのファイルのバックアップを作成することをお勧めします。1文字欠けただけでサイトが動かなくなる可能性があるため、バックアップがあればすぐに復元できます。ファイルを見つけたらテキストエディタで開き、設定を変更する準備をします。
WP_DEBUGを有効化する
wp-config.phpファイル内で、次のような行を探してください: define( 'WP_DEBUG', false );。この行はデバッグモードが有効かどうかを制御します。WordPressはセキュリティとパフォーマンスの理由からデフォルトでデバッグを無効にしています。有効にするには、値をfalseからtrueに変更するだけです。
正しい行は次のようになります: define( 'WP_DEBUG', true );。ファイルを保存すると、WordPressはすぐにサイト全体でPHPの警告、通知、エラーメッセージを表示し始めます。これにより、問題のあるプラグイン、テーマ、またはカスタムコードを特定できます。
エラーログのためのWP_DEBUG_LOGを使用する
画面にエラーを表示することは開発中に便利ですが、常に実用的とは限りません。長期的な監視のためには、WP_DEBUG_LOGを有効にできます。そのためには、WP_DEBUG定数のすぐ下に次の行を追加します: define( 'WP_DEBUG_LOG', true );。これにより、すべてのエラーがwp-contentディレクトリ内のdebug.logファイルに保存されます。
ログファイルがあると、特定のタイミングで発生するエラーや、画面上で直接再現できないエラーを追跡する際に特に便利です。また、開発者やサポートチームにサイトへの直接アクセスを与えずにファイルを共有することも可能です。
訪問者からエラーを隠す
WordPressサイトが本番環境にある場合、訪問者にエラーメッセージをそのまま見せたくないでしょう。その場合は、フロントエンドでの表示を無効化するために次の設定を追加できます: define( 'WP_DEBUG_DISPLAY', false );。これにより、エラーはログに記録され続けますが、ユーザーには表示されません。
さらに、@ini_set( 'display_errors', 0 );を追加してこの動作を強化できます。この組み合わせにより、サイトをプロフェッショナルかつ安全に保ちながら、管理者や開発者には必要な情報をデバッグログで提供できます。
SCRIPT_DEBUGを使った高度なデバッグ
JavaScriptやCSSを扱う開発者向けに、WordPressは追加の定数を提供しています: define( 'SCRIPT_DEBUG', true );。デフォルトでは、WordPressは縮小版（minified）のスクリプトやスタイルを読み込みます。スクリプトデバッグを有効にすると、WordPressは非縮小版の完全なファイルを読み込み、調査やデバッグが容易になります。
この設定は、テーマやプラグインを開発していてスクリプトやスタイルの動作を追跡する必要がある場合に特に有用です。一般ユーザーにはあまり必要ありませんが、フロントエンドの問題を解決しようとしている開発者にとって大きな助けとなります。
まとめると、WordPressでデバッグモードを有効にすることは、サイトの診断と保守を行うためのシンプルながら強力な方法です。wp-config.phpファイルを編集することで、エラーを表示し、ログに保存し、問題が発生してもサイトをプロフェッショナルに見せ続けることができます。正しく使えば、デバッグモードはWordPressを安全で安定し、開発者に優しい状態に保つための最も重要なツールの一つです。
