介護ヘルパーからITエンジニアになった話
PHPで画面が真っ白になったときの対処法|原因の見つけ方を初心者向けに解説
プログラミング学習

エックスサーバーで動かすPHP入門  09 / 12

PHPで画面が真っ白になったときの対処法|原因の見つけ方を初心者向けに解説

※この記事にはプロモーション(広告)を含みます

コードを書いて保存して、ブラウザで開いたら……画面が真っ白。エラーのメッセージも何も出ていない。

エラーが出ていれば、2本目からやってきたように「書かれている行」を見に行けます。でも真っ白だと、手がかりがなくて、どこから手をつければいいのかわかりませんよね。

実は、画面が真っ白になる原因は、大きく分けて3つのパターンしかありません。この記事では、どのパターンなのかを見分ける方法と、それぞれの直し方を、順番に紹介します。

この記事は「エックスサーバーで動かすPHP入門」シリーズの9本目です。前回は、データベースに保存したお問い合わせを一覧で表示しました。

👉 PHPでデータベースの中身を一覧表示する|PDOのSELECTでお問い合わせ一覧を作り、パスワードで守る方法を初心者向けに解説

この記事でやること

画面が真っ白になる原因は、次の3つのどれかです。

  1. エラーは出ているのに、見えない場所に出ている
  2. エラーを画面に出さない設定になっている
  3. エラーではなく、PHPが何も表示していない

どれなのかは、「ページのソース」を見ればだいたいわかります。まずはソースの見方から始めて、パターンごとに直し方を見ていきます。

この記事では、練習用にpublic_htmlにwhite.phpというファイルを作って、わざと真っ白な画面を作りながら進めます。ファイルの作り方は、2本目と同じです。

まず「ページのソース」を見る

画面が真っ白になったら、最初にやることは1つです。真っ白な画面で右クリックして、「ページのソースを表示」を選びます(Chromeなら、キーボードのCtrlを押しながらUでも開けます)。

2本目で説明したとおり、ページのソースにはPHPが実行された結果、ブラウザに届いたものが全部のっています。画面では見えなくても、ソースを見れば、ブラウザに何が届いたのかがわかります。

ソースの中身は、次の3つのどれかになっているはずです。

ソースの中身 考えられるパターン
Fatal errorやWarningなどの英語の文がある 1. エラーが見えない場所に出ている
何も書かれていない(空っぽ) 2. エラーを画面に出さない設定になっている
HTMLのタグはあるのに、表示したい文がない 3. PHPが何も表示していない

ソースが長くてエラーの文を見つけにくいときは、ソースの画面でCtrlを押しながらFを押すと、ページの中の文字を探せます。errorやWarningと入力して探してみてください。

ここから、パターンごとに見ていきます。

パターン1:エラーが見えない場所に出ている

わざと真っ白にしてみる

white.phpに次のコードを入力して保存してください。8行目のhtmlspecialcharは、わざと最後のsをぬいています。

<?php
$title = 'たろうのページ';
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title><?php echo htmlspecialchar($title, ENT_QUOTES, 'UTF-8'); ?></title>
</head>
<body>
  <h1>ようこそ</h1>
  <p>たろうのページです。</p>
</body>
</html>
  • 1行目: ここからPHPです
  • 2行目: $title(タイトル)に「たろうのページ」を入れる
  • 3行目: PHPの終わり
  • 4〜7行目: ふつうのHTML
  • 8行目: <title>(ブラウザのタブに出るページの名前)に、$titleをhtmlspecialcharsを通して表示する……つもりが、sが足りない
  • 9〜14行目: ふつうのHTML。見出しと文

ブラウザでサーバー名.xsrv.jp/white.phpを開くと、画面は真っ白になります。「ようこそ」も出ません。

ソースを見ると、エラーはちゃんと出ている

右クリックして「ページのソースを表示」を見ると、次のようになっています(…のところには、ファイルの場所が入ります)。

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title><br />
<b>Fatal error</b>:  Uncaught Error: Call to undefined function htmlspecialchar() in /home/…/white.php:8
Stack trace:
#0 {main}
  thrown in <b>/home/…/white.php</b> on line <b>8</b><br />

エラーは出ていました。それなのに画面が真っ白なのは、次の2つが重なったからです。

  • Fatal errorでPHPが止まった … 3本目で説明したとおり、Fatal errorが出ると、そこから下は実行されません。なので、9行目より下の「ようこそ」などのHTMLは、ブラウザに届いていません(ソースにもありません)
  • エラーの文が<title>の中に出た … <title>の中に書いたものは、画面ではなくブラウザのタブに出ます。なので、エラーの文は画面には表示されず、タブに少し見えるだけです

つまり、「エラーが出ていない」のではなく、エラーが画面の外に出ていて、見えていなかったのです。

エラーの文を読んで直す

エラーの文さえ見つかれば、あとはいつもどおりです。

  • Fatal error … 「重大なエラー」。ここでPHPが止まった
  • Call to undefined function htmlspecialchar() … 「htmlspecialchar()という命令は、ありません」という意味(undefined=決められていない、function=命令)
  • on line 8 … 8行目でうまくいかなかった

8行目を見ると、htmlspecialcharsのsがぬけています。直して保存し、再読み込みすると、「ようこそ」が表示され、タブには「たろうのページ」と出ます。

Call to undefined functionは、命令の名前のつづりまちがいでよく出るエラーです。htmlspecialcharsのほかにも、mb_send_mailやnl2brなど、長い名前の命令で起きやすいので、1文字ずつ見比べてみてください。

ほかにも「見えない場所」はある

<title>のほかに、5本目から使っているcontact.phpの<textarea>の中もそうです。

<textarea name="message" rows="5" cols="40"><?php echo htmlspecialchars($message, ENT_QUOTES, 'UTF-8'); ?></textarea>

この行でFatal errorが出ると、エラーの文は入力欄(テキストエリア)の中に、ただの文字として入ります。そしてPHPが止まるので、その下の「送信する」ボタンなどは表示されません。画面は「お問い合わせ内容の欄までで、ページが途中で切れている」ように見えます。

「真っ白」「途中で切れている」「なぜか一部だけ出ない」――どれも、まずソースを見て、エラーの文を探すのが近道です。

パターン2:エラーを画面に出さない設定になっている

display_errors =「エラーを画面に出すかどうか」

PHPには、display_errors(ディスプレイ・エラーズ)という設定があります。display=表示する、errors=エラーたち、で、「エラーの文を画面に出すかどうか」を決める設定です。

  • ON … エラーの文が画面(ページのソース)に出る
  • OFF … エラーの文は画面に出ない

エックスサーバーの公式マニュアル「php.ini設定で設定可能な項目」によると、display_errorsの初期値はONです。2本目でParse errorが画面に出たのは、このおかげです。なので、このシリーズのとおりに進めてきた方は、ふつうはONのままのはずです。

ただし、同じマニュアルには「PHPプログラムの設置後、運用中はOffに変更することをお勧めします。」とも書かれています。マニュアルを見てOFFにしたことがある方や、ブログなどの手順でOFFにした方は、OFFになっているかもしれません。

OFFだと、どう見えるか

display_errorsがOFFのときに、さっきと同じFatal errorやParse errorが起きると、エラーの文は出ずに、PHPはそこで止まります。

  • 2本目の「セミコロン忘れ」のようなParse errorは、ファイルが1行も実行されないので、ソースも空っぽになります
  • ブラウザによっては、真っ白ではなく「このページは動作していません」「HTTP ERROR 500」のような画面になります

「500」は、ブラウザに返される番号で、「サーバーの中でうまくいかなかった」という意味です(5本目の「送信すると 404 Not Found」の「404」の仲間です)。エックスサーバーの公式マニュアルでも、500 Internal Server Errorの原因の1つに「プログラムの文法(CGI/PHPのソースコード)に誤りがある」が挙げられています。

また、OFFだとWarningも画面に出なくなります。WarningではPHPは止まらないので、真っ白にはなりませんが、「なぜか一部だけ表示されない」のに、何も教えてくれない状態になります。

エックスサーバーで display_errors を確かめる

display_errorsは、サーバーパネルの「php.ini設定」で確かめたり、変えたりできます。設定はドメインごとです。

  1. サーバーパネルにログインして、「php.ini設定」を押す(2本目の「PHP Ver.切替」のすぐ下にあります)
  2. 練習しているドメイン(サーバー名.xsrv.jp)を選ぶ
  3. 「php.ini設定変更」の中のdisplay_errorsを見る
  4. OFFになっていたらONにして、設定を保存する

ONにしたら、真っ白だったページを再読み込みしてみてください。エラーの文が出てきたら、あとはパターン1と同じく、エラーの文を読んで直します。

なお、マニュアルにあるとおり、ONはエラーを調べるための設定です。エラーの文には、ファイルの場所(/home/…)など、ほかの人に見せなくていい情報も入っています。勉強しているあいだはONのままでかまいませんが、本当にお客さんが使うサイトを公開するときは、OFFにすることを考えましょう。

エラーログでエラーを見る

OFFにしたサイトでエラーが起きたときは、エラーログで調べます。エラーログは、サーバーで起きたエラーを書きためておくファイルです(log=記録)。

エックスサーバーの公式マニュアル「エラーログ」の手順は、次のとおりです。

  1. サーバーパネルにログインして、「エラーログ」を押す
  2. 「表示」を押すと、ログが表示される(「ダウンロードする」を押すと、ファイルで保存できる)

エックスサーバーの「よくある質問」でも、PHPで500 Internal Server Errorが出たときは、サーバーパネルの「エラーログ」でエラー内容を確認するよう案内されています。

ただし、マニュアルによると、エラーログのファイルは「毎日午前3時頃に、過去7日分のログファイルを日別に生成」するしくみです。今まさに起きたエラーが、すぐにログに出てくるとは限りません。勉強中に「今のエラーを知りたい」ときは、display_errorsをONにして画面で見るほうが早いです。

パターン3:PHPが何も表示していない

ソースを見ると、<html>や<body>などのHTMLはあるのに、表示したかった文がない。エラーの文もない。このときは、エラーではありません。PHPはちゃんと最後まで動いていて、「何も表示しない」という結果になったのです。

よくある原因は、次の3つです。

原因1:if の条件に当てはまらず、表示する行を通っていない

white.phpを次のように書きかえて保存してください。4本目の「送料無料」の例です。

<?php
$total = 560;
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>お会計</title>
</head>
<body>
  <?php if ($total >= 1000): ?>
    <h1>送料無料です</h1>
    <p>合計は<?php echo $total; ?>円です。</p>
  <?php endif; ?>
</body>
</html>
  • 2行目: $total(合計)に560を入れる
  • 11行目: もし$totalが1000以上なら
  • 12〜13行目: 「送料無料です」と合計を表示する
  • 14行目: if文の終わり

開くと、画面は真っ白です。ソースを見ると、次のようになっています。

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>お会計</title>
</head>
<body>
  </body>
</html>

合計が560円で、1000以上ではないので、11行目の条件に当てはまらず、12〜13行目がとばされました。表示する行が全部if文の中にあったので、何も表示されなかったわけです。

この例は短いのですぐ気づけますが、contact.phpのように長くなると、「どのifで、どちらに進んだのか」がわからなくなります。そんなときに使うのが、次の2つの調べ方です。

調べ方1:目印の echo で「どこまで来たか」を見る

あやしいところに、目印のechoを書きます。たとえば、if文の前と中に1つずつ入れます。

<body>
  <?php echo '目印1:ifの前'; ?>
  <?php if ($total >= 1000): ?>
    <?php echo '目印2:ifの中'; ?>
    <h1>送料無料です</h1>
    <p>合計は<?php echo $total; ?>円です。</p>
  <?php endif; ?>
</body>

開くと、画面には「目印1:ifの前」だけが出ます。目印1は出たのに目印2は出ないので、「ifの前までは来ているけれど、ifの中には入っていない」とわかります。あとは、ifの条件と、条件に使っている変数($total)をあやしいと思って見ればいいわけです。

目印には、echo '1';、echo '2';のような番号でもかまいません。どの目印まで出たかで、どこまでPHPが進んだかがわかります。

調べ方2:var_dump で変数の中身を見る

次は、変数の中身を確かめます。3本目ではprint_rを使いましたが、ここではvar_dump(ヴァー・ダンプ)という命令を紹介します。var=変数(variable)、dump=中身を全部出す、という意味で、変数の中身を、種類(文字・数字など)といっしょに表示してくれます。

white.phpを、いったん次のコードだけにして保存してください。

<?php
$name = 'たろう';
$total = 560;
$message = '';
echo '<pre>';
var_dump($name);
var_dump($total);
var_dump($message);
var_dump($total >= 1000);
echo '</pre>';
  • 2〜4行目: 3つの変数を作る。$messageには空の文字('')を入れる
  • 5行目と10行目: 3本目のprint_rのときと同じく、<pre>で囲んで見やすくする
  • 6〜8行目: 3つの変数の中身をvar_dumpで表示する
  • 9行目: if文の条件$total >= 1000が、当てはまるかどうかを表示する

表示はこうなります。

string(9) "たろう"
int(560)
string(0) ""
bool(false)
  • string(9) "たろう" … string(ストリング)は「文字」。"の中が中身です。(9)は文字の大きさで、日本語は1文字が3つ分として数えられるので、「たろう」の3文字で9になります
  • int(560) … int(イント)は「数字(整数)」。中身は560
  • string(0) "" … 文字だけど、中身が空っぽ(大きさ0)
  • bool(false) … bool(ブール)は「当てはまる(true)か、当てはまらない(false)か」。4本目で説明した、if文の条件の結果です。falseなので、if文の中には入りません

var_dumpのいいところは、空っぽでも「空っぽ」と教えてくれることです。echo $message;やprint_r($message);だと、空の文字は何も表示されないので、「中身が空っぽなのか、そもそもその行まで来ていないのか」の区別がつきません。var_dumpならstring(0) ""と出るので、「行には来ているけど、中身が空っぽ」とはっきりわかります。

たとえばcontact.phpで、入力したはずのお名前が表示されないときは、$name = trim($_POST['name'] ?? '');の下にvar_dump($name);を書いて送信してみます。string(0) ""と出たら、5本目の「よくあるつまずき」で説明したname="…"と$_POST['…']のつづりのちがいをうたがいます。

原因2:echo を書き忘れている

次の2行は、どちらも何も表示されません。エラーも出ません。

<p><?php $name; ?></p>
<p><?php htmlspecialchars($name, ENT_QUOTES, 'UTF-8'); ?></p>

ソースを見ると、<p></p>が2つ並んでいるだけです。htmlspecialcharsは「表示用に変えた文字を作る」だけで、表示するのはechoの仕事です。<?phpのすぐあとにechoがあるか、確認してください。

原因3:exit で PHP が終わっている

6本目で、header('Location: …');とexit;を2行セットで使いました。exitは「ここでPHPを終わらせる」命令なので、exitより下のHTMLは、1行も表示されません。

Locationのつづりをまちがえて移動できなかったときや、exit;を思ったのとちがう場所に書いてしまったときは、真っ白になります。くわしくは、6本目の「送信すると画面が真っ白になる」を見てください。

👉 PHPでお問い合わせフォームからメールを送る|mb_send_mailの使い方とエックスサーバーでの注意点を初心者向けに解説

調べ終わったら、目印と var_dump は必ず消す

目印のechoとvar_dumpは、調べるためだけの一時的なものです。原因がわかって直したら、必ず消してください。

  • 消し忘れると、お客さんの画面に「目印1」やstring(9) "たろう"が出てしまいます
  • contact.phpのheaderより前に残っていると、6本目で説明したWarning: Cannot modify header information - headers already sentの原因になります。echoもvar_dumpも「表示」なので、headerより前にあってはいけないのです

直したのに、真っ白のまま・変わらない

原因を見つけて直したはずなのに、表示が変わらないときは、次のことを確かめてください。

  • 保存したか … ファイルマネージャの編集画面で、保存してから閉じたか。保存しないまま閉じると、前のファイルのままです
  • 開いているファイルと、直したファイルが同じか … たとえばadmin/inquiries.phpを開いているのに、public_htmlの直下にある別のinquiries.phpを直していないか。ファイルマネージャの上のほうに出ている「今いるフォルダ」と、ブラウザのURLを見比べてみましょう
  • 再読み込みしたか … 直したあとは、ブラウザで再読み込み(F5キー)をします。それでも変わらないときは、Ctrlを押しながらF5を押すと、ブラウザが覚えている古い表示を使わずに読み込み直します

真っ白になったときの確認の順番(まとめ)

  1. ページのソースを見る(右クリック→「ページのソースを表示」)
  2. エラーの文がある → <title>や<textarea>の中など、見えない場所に出ていた。Fatal errorの行(on line ○)を見て直す
  3. ソースが空っぽ → サーバーパネルの「php.ini設定」でdisplay_errorsがONか確かめる。ONにして、もう一度開く
  4. HTMLはあるのに中身がない → エラーではない。if文の条件、echoの書き忘れ、exitを見る。わからなければ、目印のechoとvar_dumpでどこまで動いたか調べる
  5. 直したのに変わらない → 保存したか、同じファイルか、再読み込みしたか

まとめ|真っ白でも、ソースを見れば手がかりがある

  • 画面が真っ白になる原因は、「エラーが見えない場所に出ている」「エラーを画面に出さない設定」「PHPが何も表示していない」の3つ
  • まずページのソースを見る。Ctrl+FでerrorやWarningを探す
  • Fatal errorが出ると、そこから下は表示されない。<title>の中で起きると、エラーの文はタブに出て、画面は真っ白になる
  • display_errorsは「エラーを画面に出すかどうか」の設定。エックスサーバーの初期値はONで、サーバーパネルの「php.ini設定」で変えられる
  • エラーログはサーバーパネルの「エラーログ」で見られる。ただし、今起きたエラーがすぐに出るとは限らない
  • エラーがないのに何も出ないときは、目印のechoで「どこまで来たか」、var_dumpで「変数の中身」を調べる。調べ終わったら必ず消す

真っ白な画面は、はじめはこわく感じます。でも、PHPは何かしらの手がかりを必ず残しています。ソース、設定、目印――この順番で見ていけば、落ち着いて原因にたどりつけます。

前回の一覧ページを作る記事は、こちらです。

👉 PHPでデータベースの中身を一覧表示する|PDOのSELECTでお問い合わせ一覧を作り、パスワードで守る方法を初心者向けに解説

次の記事では、このシリーズで出てきたエラーの文をまとめて、よくあるエラーのメッセージの読み方と直し方を一覧にします。

👉 よくあるPHPエラーの読み方と直し方|エラー文の一覧を初心者向けに解説

今すぐエックスサーバーを試してみよう

10日間の無料お試し期間あり。使い勝手を確かめてから、料金を払うかどうか決められます。

無料で試してみる →

関連記事