1. 導入
PHPで開発を行っている際、予期せぬエラーが発生したときに「どのファイルで問題が起きたのか」を即座に把握することは、デバッグ時間を大幅に短縮するために極めて重要です。PHP 7以降導入されたErrorクラスのメソッド「getFile」は、例外発生時のソースファイルをプログラム側で動的に取得できます。ログ出力の自動化や、エラーモニタリングの精度向上を目指すエンジニアにとって、必須の知識といえます。
2. 基礎知識
PHP 7から、従来のExceptionクラスに加えて、エンジンの致命的なエラーをキャッチできる「Error」クラスが導入されました。Throwableインターフェースを実装しており、ExceptionとErrorの双方がこのインターフェースを継承しています。
「Error::getFile」は、その名の通り、エラーが発生したファイルの絶対パスを文字列として返します。単に画面にエラーを表示するだけでなく、構造化ログや通知システムへ情報を送る際に非常に有用なメソッドです。
3. 実装/解決策
実務では、単にキャッチするだけでなく、キャッチしたエラー情報をログクラス等に渡す際、どのファイルで何が起きたかを正確に記録するために使用します。特に、複数のファイルで構成される大規模プロジェクトや、ライブラリを使用している場合に、エラーの発生源を迅速に特定する「トレーサビリティ」を確保するために活用します。
4. サンプルプログラム
以下は、エラーをキャッチし、発生したファイル名と行番号をログに出力する実用的なコード例です。
/
try {
// 意図的に未定義の関数を呼び出してErrorを発生させる
nonExistentFunction();
} catch (Error $e) {
// エラーが発生したファイル名を取得
$fileName = $e->getFile();
// エラーが発生した行番号を取得
$lineNumber = $e->getLine();
// エラーメッセージを取得
$message = $e->getMessage();
// 実際の運用ではログファイルや監視ツール（Sentry等）へ送信する
$logOutput = sprintf(
“エラー発生: %s (ファイル: %s, 行: %d)”,
$message,
$fileName,
$lineNumber
);
// ログに出力
error_log($logOutput);
echo “システムエラーが発生しました。管理者に通知しました。”;
}
?>
5. 応用・注意点
注意点： getFileで取得されるパスは、サーバー上の絶対パスです。セキュリティ上の観点から、ユーザーに対してこのパスを直接ブラウザに出力しないように注意してください。公開すべきは「何が起きたか」という情報のみに留め、ファイルパスなどの内部構造はサーバーのログにのみ出力するのが定石です。
応用： Laravelなどのフレームワークを使用している場合、スタックトレースの一部として自動的に取得されますが、独自のフレームワークやレガシーな環境でエラーハンドラを自作する際には、このメソッドを必ずログのフォーマットに組み込むようにしてください。これにより、複雑なリクエスト処理の中でも、どのモジュールで障害が起きているかを一目で判断できるようになります。