エス技研

WordPress、CakePHP、PHP、baserCMSなどの Web系システムを中心に情報を提供します!


WordPress 画面が真っ白になる対応の一つ デバッグモード

      2017/03/08

WordPressの画面が真っ白になる不具合は PHPのエラーです

 

画面が真っ白になる原因の説明

 
WordPressの画面が真っ白になる不具合があった場合のほとんどは、PHPのエラーが発生している場合です。
 
ですが、phpのエラーメッセージの表示はセキュリティ上都合が悪い情報になりますので、一般的には PHPのエラーを表示しない設定になっています。
そのため、エラーが起こって画面表示の処理が実行されていないうえに、エラーメッセージも表示されないので、画面が真っ白になるという結果になるのです。
 
ですので、そういう場合は、エラーメッセージを表示させることで具体的にどんな不具合が起こっているのかを表示させることで解決するのですが、今回はその設定方法について説明します。
 
 
その前に、PHPのエラー表示については「WordPress 画面が真っ白になる不具合があった場合の対応の一つ」の方も合わせてご覧ください。
 
また、プラグインが原因で WordPressが起動しなくなったと分かっている場合、もしくは、それが原因じゃないかと疑わしい場合、簡単な方法で復旧させることを試せる方法もあります。
それを「プラグインが原因で起動しないWordPressを復旧させる方法解説」で記事にしていますので、そのような状況の方はあわせて参考にしてみてください。
 
 


 

WordPressのデバッグモード・画面にエラーを表示

 
WordPressには、デバッグモードが用意されています。
 
これの設定を「True」「false」で切り替えることでデバッグモードに変更し、PHPのエラーメッセージを表示できるようになります。
 
具体的には、WordPressをインストールしたフォルダにある「wp-config.php」ファイルに下記のような記述があります。
※「wp-config.php」は、WordPressのフォルダのルートフォルダにあります。(WordPressのドキュメントルートフォルダにあります。)
—————————-

—————————-
 
この記述の一番下の行の「false」を「true」に変えることで、デバッグモードに変わり、画面に PHPのエラーが表示されるようになります。
 
 

上記の設定でもエラーメッセージが表示されない場合

 
もし、上記の設定を変えるだけでは画面にエラー表示がされない場合は、下記の行を上記の行の下あたりに追加してみてください。
そうすると表示されるようになるでしょう。(この内容については、下の方に別途説明しています。)
—————————-

—————————-
 
 

WordPressのデバッグモード・ログファイルに出力

 
上記の設定は、エラーメッセージを処理するか、否かの設定です。
加えて、WordPressには、そのエラーメッセージを画面に表示するか、否かを設定することができます。
 
開発中の環境であれば問題ありませんが、すでに本番公開してるサイトでの不具合調整など、エラーメッセージを画面に表示させたくない場合も多々あります。
そんな場合は、エラーメッセージを画面には表示させずにエラーログファイルにエラーメッセージを出力させる方法が用意されています。
 
 
「wp-config.php」の「define(‘WP_DEBUG’, false);」の下に下記の行を追加することで画面には表示されなくなります。(「false」を「true」に変えることで画面にエラー表示されます。)
—————————-

—————————-
 
加えて、下記の行を追加することで、ログファイルを出力されるようになります。(ここも「true」を「false」にすることでログ出力を止めることができます。)
—————————-

—————————-
 
最終的には下記のような記述になります。
—————————-

—————————-
 
エラーログファイルが出力される場所は、デフォルトの設定では「/wp-content/debug.log」として出力されます。
 
ブラウザでエラーログを見る場合は、「http://……./wp-content/debug.log」でアクセスします。(もしくは、FTPでダウンロードするなどして確認します。)
 
 
ただ、この場所は「http://……./wp-content/debug.log」でアクセスできてしまいますので、一時的であれば問題ありませんが、数日間程度ログを出力させて確認したいというような場合などは、.htaccessでアクセス制限をしておく方がいいでしょう。
 
具体的には、「wp-content」フォルダの直下に下記の「.htaccess」ファイルを入れておきましょう。
 
/wp-content/.htaccess
—————————-

—————————-
 
※この設定をするとブラウザではファイルにアクセスできなくなりますので、ログを確認する際は ftpでファイルをダウンロードしてくる必要があります。
 そのため、場合によっては、Basic認証の設定を行う方がいいかもしれません。
 
※サーバによっては、「.htaccess」の制限がある場合がありますので、アクセス制限が効かない場合もあります。
 
また、エラーログ出力は、エラーがある限りエラーログファイルに出力を続けますので、ログの出力が必要なくなった時点でログ出力の設定を止めておきましょう。
そうしないとサーバを圧迫していく原因になってしまいます。
 
 


 

デバッグモードで実験してみたこと

 

WordPressデバッグモードの動きについて

 
お客さんの環境とローカルの PCに設定している XAMPP環境とでデバッグモードの設定と動作に違いがありましたので、それを調べてみました。
 
XAMPP環境
20140314_wp_01
 
XAMPP環境
20140314_wp_02
 
LAMP環境
20140314_wp_03
 
 

WordPressデバッグモードの動きについて

 
具体的に「WP_DEBUG」の処理として何が行われているかも確認してみました。
 
/wp-includes/load.php に下記の記述があります。
—————————-

—————————-
 
バージョンによって少しずつ記述内容が違うようですが、上記は、バージョン 3.8のものです。
 
実際に内部でやっていることは、設定されているフラグによって、「ini_set(‘display_errors’, ‘On’);」などのエラー処理をする、しないの処理をやっているだけでした。
 
ただ、上記を見ても分かるように、「WP_DEBUG」が「True」になった上で「WP_DEBUG_DISPLAY」が「True」になって初めて「ini_set( ‘display_errors’, 1 );」が設定されるようです。
 
そのため、「define(‘WP_DEBUG’, false);」の場合は、そもそものサーバの設定が優先されます。
 
また、WordPressのデバッグ処理を無視するなら、最初から「ini_set( ‘display_errors’, 1 );」を直書きしてもよさそうです。
 
 

サーバを移転したりPHPのバージョンを変えたりしたときに画面が真っ白に 2015.03.02追記

  • PHPのバージョンアップをした。
  • サーバを移転した。
  • ローカル環境から本番環境に移した。

 
といった感じで、PHPの設定そのものが変った可能性がある場合に画面が真っ白になるという不具合の場合は、PHPのショートタグの設定が原因の場合もあります。
 
ショートタグとは、PHPの宣言を「<? …… ?>」という省略形式で記述する方式のことですが、この設定を有効にするか否かのデフォルト設定が、PHPのバージョンによって違うため、動かなくなる可能性があります。
 
それについて「サーバ移転、PHPバージョンアップでPHPのソースコードが表示される・ショートタグのPHPが動かない」に記事を書いていますので、詳細はこちらを参照してみてください。

 - WordPress

GoogleAdwords

GoogleAdwords

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです!

Comment

  1. 馬場 より:

    デバックモード反応しません。
    W3 Total Cacheをプラグインするといきなり真っ白になりました。

    W3 Total Cacheを削除してももとにもどりません、

    http://omiairyoen.com/wp/wp-login.php

    プラグインは全て停止にしましたがもとにもどりません。

    wp-config.phpもデバックモード対応しません

    原因わかれば教えてくださいませ

    • エス技研 より:

      ご連絡の内容では不具合の原因や対応方法などは分かりかねますね。
      個別のプラグインの不具合については、情報提供はなかなか難しいものがあることをご理解ください。
      また、キャッシュ系のプラグインは、データベースのデータやテンプレートのデータを書き換えて処理する機能がありますので、設定ファイルの内容やデータベースの内容などを確認しながら不具合の内容を確認する必要があるようです。
      そのため、場合によっては復旧させることにすごく手間がかかる場合も多々あるようです。

Message

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

下記の空欄を埋めてください。 * Time limit is exhausted. Please reload CAPTCHA.

日本語が含まれない投稿は無視されますのでご注意ください。(スパム対策)

※入力いただいたコメントは管理者の承認後に掲載されます。

  関連記事

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

WordPressの投稿ページで PHPの処理を行うには add_shortcode関数を使ったショートコードという機能を利用します。

WordPressは危険?最新バージョンにアップデートして利用しよう

WordPress最新バージョン使ってますか?WordPressのバージョンアップをしないリスクを説明し、バージョンアップの手順、バックアップの重要性を解説しています。

WordPressのおすすめの確認画面付きお問い合わせフォームプラグイン・MW WP Form

MW WP Formは確認画面が付いているオススメのフォームプラグインです。企業サイトを CMSとして構築する際にも利用できる実力派です。

WordPressの一覧ページのテンプレートの種類とファイルの設定

ファイル名に従って一覧ページのテンプレートは選択される。ルールに従ってファイル名を付けることで任意のカテゴリ、タクソノミーごとのテンプレートを指定可能。

Google Code Prettifyの設定方法を解説。 Syntax Highlighterから乗換え、高速化にも最適

Google Code Prettifyでソースコードをきれいに編集する方法の解説。簡単設置とカスタマイズ設置の2つの方法を解説し、カスタマイズするポイントも解説。

WP Mail SMTP、WP SMTP、Easy WP SMTPでWordPressのメールのスパム判定を回避

WordPressから送信したメールがスパム判定される!そんな悩みを解決するプラグインを紹介。3種類にプラグインを比較しオススメを紹介。なぜスパム判定されるかの解説も。

Advanced Custom Fields管理画面の全項目完全解説・カスタムフィールド決定版!

カスタムフィールドを設定する最高のプラグイン。設定できる項目を全て網羅して解説。投稿の項目だけではなく、カテゴリやユーザ情報の項目を増やすことにも使えます。

WordPress csvインポート、エクスポートのプラグイン

WordPressから csvファイルをエクスポート、インポートする方法を紹介しています。

WP Mail SMTPはPHP5.6、7.0系ではメール送信時にエラーが発生。その対処方法。
WP Mail SMTPはPHP5.6、7.0系ではメール送信時にエラーが発生。その対処方法。

PHPのバージョンを5.6(7系含む)にアップデートしたらプラグイン WP Mail SMTPを利用してSMTPサーバ経由して送信していたメールが送信できなくなった。その原因と対処方法を詳細解説。

WordPressグローバルナビ・メニューの編集の方法解説

グローバルナビであるメニューの編集方法の解説です。メニューの管理画面の使い方の解説と設定のポイント、テーマによって設定する項目が違う点などを解説します。