PHPエラー表示の基本と設定方法について解説

PHPのエラー表示は、開発中に問題箇所を素早く把握するために重要な機能です。

本記事では、初期設定で非表示になっているエラーを表示する方法や、環境ごとの最適な設定例を解説します。

エラー対策の基本から実運用時に配慮すべき点まで、具体的な例を交えながら説明します。

PHPエラー表示の基本設定

php.iniによる設定変更

display_errorsディレクティブの設定

PHPがエラーメッセージを画面に表示するかどうかは、display_errorsディレクティブで決定されます。

開発環境ではエラー内容を確認する必要があるため、Onに設定すると便利です。

ただし、本番環境では情報漏洩のリスクがあるため、Offに変更することが推奨されます。

具体的には、php.iniファイル内で以下の設定を確認してください。

; エラー表示を有効にする設定例(開発環境用)
display_errors = On

; PHPがエラーメッセージを画面に出力する設定が有効になります。

error_reportingの設定値調整

error_reportingは、どのレベルのエラーを報告するかを指定するディレクティブです。

開発中は全てのエラーを把握するため、E_ALLを設定するのが一般的です。

エラーメッセージには注意したい内容が含まれるため、レベルの調整によって不要な警告の表示を抑制することも可能です。

php.ini内での設定例は以下の通りです。

; 全てのエラー、警告、通知を表示する設定例
error_reporting = E_ALL

; PHPが全ての種類のエラーを報告する設定となります。

コード内でのエラー表示設定

ini_set関数の活用方法

php.iniファイルを変更できない場合や、動的に設定を切り替えたい場合には、ini_set関数を活用する方法があります。

ini_setを利用することで、スクリプト実行時に一時的に設定を上書きできます。

以下は、display_errorsをオンにするサンプルコードです。

<?php
// display_errorsをオンに設定するサンプル
ini_set('display_errors', '1'); // エラー表示を有効化する
?>

; このコード実行時にPHPがエラー情報を画面に表示するようになります。

error_reporting関数の利用例

コード内でエラーレベルを動的に調整する場合、error_reporting関数を利用する方法もあります。

例えば、すべてのエラーを報告する設定を行う場合は、以下のように編集できます。

<?php
// error_reportingで全エラーを報告する設定サンプル
error_reporting(E_ALL); // 全てのエラーを表示する
?>

; この設定により、PHPがスクリプト内の全エラー、警告、通知を出力します。

エラー表示のトラブルシューティング

設定が反映されない場合の確認事項

php.iniファイルの再読み込み

php.iniの設定変更後は、サーバー側でphp.iniファイルの再読み込みやWebサーバーの再起動が必要です。

変更が反映されない場合は、以下の手順を確認してください。

• Webサーバーの再起動(Apacheならsudo systemctl restart apache2やhttpdコマンド)
• CLIとWeb環境で使用されるphp.iniが異なる可能性の確認

キャッシュの影響確認

PHPの設定変更後、キャッシュが原因で古い設定が使われる場合があります。

以下の点を点検してください。

• PHPのオペコードキャッシュ(例: OPCache)の無効化や再起動
• ブラウザのキャッシュをクリアする

これにより、最新の設定が正しく適用されるようになります。

PHPバージョン別の注意点

設定変更の互換性チェック

PHPのバージョンが異なると、設定ディレクティブの挙動や対応する定数の内容も変化する場合があります。

以下の点について確認するとよいです。

• 各バージョンのPHPマニュアルを見比べ、error_reportingで指定できるエラー定数に違いがないか確認する
• display_errorsやその他の設定ディレクティブのデフォルト値を公式ドキュメントでチェックする

また、バージョンアップに伴い、一部の設定が非推奨となった場合、その変更に注意してください。

エラー表示の検証方法

テストコードによるエラー発生確認

シンプルなエラー出力例

エラー表示設定が正しく反映されているかどうかを確認するために、意図的にエラーを発生させるテストコードを実行するとよいです。

以下はシンプルなエラー出力例です。

<?php
// 未定義の関数を呼び出してエラーを発生させるサンプル
undefinedFunction(); // この関数は存在しないため、エラーが出力される
?>

Fatal error: Uncaught Error: Call to undefined function undefinedFunction() in /path/to/file.php on line 3

エラーメッセージの内容確認

メッセージパターンと対処方法

エラーメッセージには、エラーの種類や原因が含まれているため、パターンの確認を行うことで迅速な対処が可能になります。

主なエラーダイアグノスティックの指標は以下の通りです。

• ランタイムエラー：発生箇所とエラー内容が明記されるので、コードの該当部分を見直す
• パースエラー：構文に誤りがあることが示されるため、コードの構文チェックを行う
• 警告・通知：致命的な問題ではないが、潜在的なバグの可能性を示すので、必要に応じて設定変更や修正を行う

これらの情報をもとに、コードを慎重に確認することでエラーの根本原因にたどり着くことが可能です。

まとめ

この記事では、PHPエラー表示の基本設定、php.iniの設定変更、コード内でのエラー表示設定、トラブルシューティング、および検証方法について解説しました。

エラー設定の要点や各種確認手順、バージョン差異の注意点が整理され、PHP開発上の問題解決に役立つ知識を得られる内容でした。

ぜひ、提示した設定方法や検証手順を実際に試し、環境の安定性向上に活用してみてください。