診断エラー

診断エラーは、従来からエラーと呼ばれてきたもので、 さまざまな状況を知らせるために使われます。 必要に応じて、画面に表示したりログに記録したりできます。 デフォルトでは、PHP はすべての診断エラーを報告します。 (PHP 8.0.0 より前のバージョンでは、E_NOTICE と E_DEPRECATED の診断エラーはデフォルトでは報告されませんでした)

Throwable エラーとは異なり、ほとんどの診断エラーは 通常の処理の流れを中断しません。 E_ERROR のような致命的な診断エラーは、スクリプトを終了させます。

どの診断エラーを報告し、どれを無視するのかを決めるのが、 error_reporting php.ini ディレクティブです。あるいは、実行時に error_reporting() をコールして設定することもできます。 スクリプトの実行が始まる前に発生するエラーもあるため、 ディレクティブで設定しておくことを強く推奨します。

注意:

開発環境では常に、 error_reporting を E_ALL にしておくべきです。 PHP が発する報告にすべて気づいて対応できるようにするためです。 一方、運用環境では、もう少しレベルを下げて E_ALL & ~E_NOTICE & ~E_DEPRECATED にすることもできますが、 多くの場合は E_ALL のままでも適切です。 潜在的な問題に早い段階で気づくことができるからです。

診断エラーが発生したときの PHP の挙動を決める php.ini ディレクティブが、あとふたつあります。 display_errors は、診断エラーの内容をスクリプトの出力に含めるかどうかを設定します。 このディレクティブは、運用環境では常に無効にしておくべきです。 エラーメッセージの中には、データベースのパスワードなどの機密情報が含まれることもありえるからです。 しかし、開発環境では有効にしておくと便利なことがよくあります。 どこに問題があるのかに、すぐに気づけるからです。

log_errors ディレクティブを有効にすると、PHP はエラーを表示するだけでなく、 診断エラーをログに記録することもできます。 発生したすべての診断エラーが、 error_log で定義したファイルまたは syslog に書き出されます。 これは運用環境で非常に役立ちます。 診断エラーが発生した時点で記録され、 後からそのログをもとにレポートを生成できるからです。

@ 演算子を使うと、個々の診断エラーを抑制できます。

注意:

PHP のバージョンが変わると、診断エラーの追加や削除、深刻度の変更や Throwable エラーへの昇格が行われることがあります。

<?php
function exceptions_error_handler($severity, $message, $filename, $lineno) {
    if (error_reporting() & $severity) {
        throw new ErrorException($message, 0, $severity, $filename, $lineno);
    }
}

set_error_handler('exceptions_error_handler');