1. 導入
PHPアプリケーションの開発において、エラーハンドリングは避けて通れない重要なトピックです。標準のPHPエラー出力は開発環境では便利ですが、本番環境ではセキュリティ上のリスク（パスや変数の露出）や、ユーザー体験の低下を招きます。本稿では、PHP標準のエラー管理関数を駆使し、運用フェーズでも迅速にトラブルシューティングができる「カスタムエラーハンドラ」の実装方法を解説します。
2. 基礎知識
PHPには、エラーの報告レベルを制御する error_reporting や、エラーを補足して任意の処理（ログ出力や通知）を行わせる set_error_handler など、強力な機能が備わっています。
特に重要な概念が「ビット演算子」によるエラーレベルの管理です。PHPのエラー定数（E_NOTICE, E_WARNINGなど）はビットフラグで構成されており、これらを組み合わせることで、効率的に特定のレベルのエラーのみをフィルタリングすることが可能です。
3. 実装/解決策
実務では、エラーが発生した際に「ユーザーには汎用的なメッセージを表示し、管理者にはスタックトレースを含む詳細なログを送信する」という構成が一般的です。set_error_handler を使用して独自のハンドラを登録し、そこで debug_backtrace を活用することで、エラー発生時の呼び出し履歴を正確に追跡できます。
4. サンプルプログラム
以下は、実務でそのまま利用可能なカスタムエラーハンドラの雛形です。
/
function myCustomErrorHandler($errno, $errstr, $errfile, $errline)
{
// ビット演算子を使用して、現在のエラーレベルが対象かどうかを判定
if (!(error_reporting() & $errno)) {
return;
}
// ログ用の詳細メッセージを作成
$message = sprintf(
“[%s] Error: %s in %s on line %d”,
date(‘Y-m-d H:i:s’),
$errstr,
$errfile,
$errline
);
// バックトレースを取得してログに含める（デバッグ効率化）
$trace = debug_backtrace();
$logContent = $message . PHP_EOL . “Trace: ” . print_r($trace, true) . PHP_EOL;
// サーバーのログに出力
error_log($logContent);
// ユーザーには非公開のメッセージを表示して処理を安全に終了させる
http_response_code(500);
echo “申し訳ございません。システムエラーが発生しました。”;
exit;
}
// ハンドラをセット
set_error_handler(‘myCustomErrorHandler’);
// テスト用：未定義定数にアクセスしてエラーを発生させる
echo UNDEFINED_CONSTANT;
?>
5. 応用・注意点
・パフォーマンスの考慮: エラーハンドラ内で date() 関数などの重い処理を多用すると、エラーが多発した際にシステム全体の負荷が激増します。ログ出力は最小限の構成にしましょう。
・無限ループの回避: エラーハンドラ内でエラーが発生すると無限ループに陥ります。ハンドラ内のコードは、外部ライブラリに依存せず、極めてシンプルに保つことが鉄則です。
・ログの出力先: error_log の設定値は絶対パスで指定することを推奨します。相対パスだと実行ディレクトリに依存してしまい、ログが分散する原因となります。
・ビット演算の活用: エラーレベルの比較には in_array() を使うよりも、前述のサンプルにあるようなビット演算（$errno & $user_errors）を用いたほうが、高速かつコードも簡潔になります。