エラーを修正するためにWordPressデバッグモードを有効にする方法

WordPressでデバッグモードを有効にするにはどうすればよいですか？または、ウェブブラウザに表示されるWordPressのエラーに関する詳細情報をどうやって取得できますか？もしあなたがWordPressのユーザーまたは開発者であり、これらの質問をしているのであれば、あなたは正しいリソースにたどり着きました。このガイドでは、WordPressのデバッグ機能を有効にする方法を示します。

WordPress は、開発者やプログラマーでない一般ユーザーのために、利用可能な設定オプションを使用して有効にできる強力なデバッグツールをいくつか提供しています。これらのオプションは、一度有効になると、詳細なエラー情報を表示することでエラーを迅速に特定し解決するのに役立ちます。

テスト目的のダミーサイトを設定中に遭遇した以下のエラーを使用して説明します。

このエラーを見ると、それに伴う情報はあまりありません。原因は多く考えられます：データベースサーバーがダウンしているか、wp-config.php 設定ファイルに定義されたデータベース接続設定（つまり、データベース名、データベースユーザー、ユーザーのパスワード）が誤っている可能性があります。

では、上記のエラーに関する詳細情報をどうやって得ることができますか？WP_DEBUGオプションは、WordPress全体で「debug」モードを有効にするPHPの永続的なグローバル変数であり、これによりすべてのPHPエラー、通知、および警告がブラウザに表示されます。

この「debug」機能は、WordPress バージョン 2.3.1 で追加され、wp-config.php に設定されます。これは、あなたの WordPress インストールで最も重要なファイルの一つです。

デフォルトでは、「debug」機能は、任意のWordPressインストールでfalseに設定されています。WP_DEBUGを有効にするには、trueに設定してください。

まず、あなたのウェブサイトのインストールディレクトリ（例：/var/www/html/mysite.com）に移動し、次にお気に入りのテキストエディタを使ってwp-config.phpファイルを開きます。

$ cd /var/www/html/mysite.com
sudo vim wp-config.php

このラインを探してください。

define( 'WP_DEBUG',  false );

そしてそれを変更する

define( 'WP_DEBUG', true );

ファイルを保存して閉じてください。

現在、デバッグモードがトリガーされました。エラーを表示していたページを再読み込みすると、以下のスクリーンショットに示されているように、詳細なエラー情報を確認できます。

WordPressのプラグインやテーマ、またはその他のコンポーネントを作成する開発者に特に便利な、WP_DEBUGを拡張する追加のデバッグオプションがあります。それらはWP_DEBUG_LOGとWP_DEBUG_DISPLAYです。

WP_DEBUG_LOGオプションがtrueに設定されると、すべてのエラーがデフォルトで/wp-content/ディレクトリ内のdebug.logログファイルに保存されます。これは後で分析や処理を行うのに便利です。

define( 'WP_DEBUG_LOG', true );

ただし、カスタムログファイルを指定できます。例：/var/log/nginx/mysite.com_wp-errors.log:

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

そしてWP_DEBUG_DISPLAYは、デバッグメッセージがページのHTML内に表示されるかどうかを制御します。デフォルトでは、これはtrueに設定されています。無効にするには、falseに設定してください。

define( 'WP_DEBUG_DISPLAY', false );

プラグインを使用してWordPressでデバッグモードを有効にする

共有ホスティングを使用している場合、wp-config.phpファイルを編集するためにサーバーのバックエンドにアクセスできない可能性があります。

または、管理ダッシュボードから設定を変更するのを好む場合は、管理ダッシュボードからツールバーのクリック一つでWP_DEBUGを簡単に有効化/無効化できる「Debug Bar」というプラグインをインストールして使用することができます。

このプラグインの強力な特徴は、フェイルセーフかつ賢いことで、エラーが発生した場合にWP_DEBUGモードを自動的に終了することです。

参考：WordPressのデバッグ。