phpのエラーハンドリング

エラーを適切にキャッチし、記録し、対策することはどんな言語を使っていても重要です。 phpでこれらの処理を行うのによく使う関数やディレクティブを並べてみました。

関数

error_reporting

出力する PHP エラーの種類を設定する

ディレクティブ

error_reporting

error_reporting()関数同様の機能。ただし演算子の記述に制限あり

display_errors

エラーをHTML出力の一部として画面に出力するかどうかを定義する

log_errors

エラーメッセージを、サーバーのエラーログまたはerror_logに記録するかどうかを指定する

error_log

スクリプトエラーが記録されるファイル名を指定する

それぞれのおすすめ設定

error_reporting

E_NOTICEもログ出力しておくとバグに気づくことがあります。

display_errors

開発環境ではtrue、本番環境ではfalse（これは必須）

log_errors

開発環境、本番環境問わずtrue

error_log

省略するとapacheのエラーログに記録されます。アプリケーション個別のエラーログファイル名を決めて指定することを推奨。

まとめ

• 本番環境、開発環境問わずerror_reportingにはE_NOTICEも記録する
• 本番環境ではdisplay_errorsは必ずfalseを指定。開発環境ではお好みですが、trueを設定しておくと画面に表示されるので対応漏れを減らすことができます。
• エラーログはアプリケーションごとにファイルを分ける。これにより、監視するときもアプリケーション単位で行うことができます。

注意

error_reportingに設定するE_ALLの値がphpのバージョンで変わります。 このせいでphpのバージョンアップをしたとたんに大量のエラーログに見舞われることがあります。これについてはまた別の機会に。