PHPでエラーを表示する方法をわかりやすく解説

PHPアプリケーションは、スクリプトの実行中にさまざまなレベルのエラーを発生させます。本記事では、それらのエラーや警告メッセージをすべて表示する方法について詳しく解説します。

最も手軽なエラー表示の方法

PHPのすべてのエラーと警告を表示する最も簡単な方法は、PHPコードファイルに以下の行を追加することです。

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

各関数の役割

ini_set() 関数は、php.ini ファイルに記述された設定をコード側から上書きするための関数です。php.ini で display_errors が無効になっている場合でも、この関数を使えばコード内で有効化できます。また、display_startup_errors を true に設定することで、起動時のエラーメッセージも表示されるようになります。

error_reporting() は、PHPに組み込まれているネイティブ関数で、どのレベルのエラーを報告するかを指定します。E_ALL を渡すことで、発生したすべてのエラーを表示対象にできます。

E_ALLとは？エラーレベルの種類

「E_ALLとは何か？」という疑問が生じるかもしれません。答えはシンプルで、PHPのコードでは複数のレベルのエラーが発生し、E_ALLはそのすべてを表す定数だからです。ここで、PHPで発生する主なエラーの種類を見ていきましょう。

• E_ERROR：致命的なランタイムエラー。スクリプトの実行が中断されます。
• E_WARNING：致命的ではないランタイムエラー。スクリプトの実行は継続されます。
• E_PARSE：コンパイル時（パース時）エラー。パーサーによって生成されます。
• E_NOTICE：スクリプトがエラーの可能性があるものを検出した際に発生する通知です。
• E_CORE_ERROR：スクリプトの初期起動時に発生した致命的なエラーです。
• E_CORE_WARNING：スクリプトの初期起動時に発生した致命的ではないエラーです。
• E_ALL：上記を含む、すべてのエラーと警告を意味します。

パースエラーが表示されない場合の対処法

残念ながら、上記のコードだけではパースエラー（構文エラー）を表示できない場合があります。例えば、セミコロンの抜けや波括弧（中括弧）の閉じ忘れなどが該当します。これは、構文エラーが発生した時点ではスクリプト自体が実行されないため、ini_set() 関数が呼ばれる前に処理が止まってしまうからです。

このような場合は、php.ini の設定を直接変更する必要があります。

display_errors = On

php.ini ファイル内で display_errors ディレクティブを「On」に設定してください。これにより、構文エラーやパースエラーを含むすべてのエラーが表示されるようになります。

まとめ

開発環境では ini_set() と error_reporting(E_ALL) を使えば手軽にエラーを確認できますが、パースエラーまで確実に表示したい場合は php.ini の設定変更が必要です。なお、本番環境で display_errors を有効にすると、エラーメッセージを通じてシステム情報が漏洩するリスクがあるため、本番環境ではログへの出力（log_errors）を利用するのが安全です。