【PHP8.x】getTraceAsStringメソッドの使い方

getTraceAsStringメソッドは、エラー発生時のスタックトレースを文字列として取得する処理を実行するメソッドです。スタックトレースとは、エラーが起きるまでにプログラムがどのような順序で関数やメソッドを呼び出してきたかの履歴情報です。このメソッドを呼び出すと、どのファイルの何行目でどの関数が呼び出されたか、といった一連の実行経路が、人間が読みやすい形式の文字列として返されます。主に、プログラムのデバッグ時にこのメソッドが利用されます。予期せぬエラーが発生した際、その原因を特定するために、このメソッドが返す文字列情報を確認することで、エラー発生地点に至るまでのコードの呼び出し履歴を正確に追跡できます。これにより、問題箇所の特定と修正作業を効率的に進めることが可能になります。同じくスタックトレースを取得するgetTrace()メソッドが情報を配列で返すのに対し、getTraceAsString()は整形済みの文字列を返すため、ログファイルへの記録や画面への直接的な表示に適しています。このように、本メソッドはエラーハンドリングとデバッグ作業において非常に重要な役割を果たします。

Copy
1<?php
2
3try {
4    // 存在しない関数を呼び出し、Errorを発生させる
5    nonExistentFunction();
6} catch (Error $e) {
7    // 発生したErrorのスタックトレースを文字列として取得し、出力する
8    echo $e->getTraceAsString();
9}

引数なし

引数はありません

string

このメソッドは、発生したエラーのトレース情報を、文字列として返します。トレース情報には、エラーが発生したファイル名、行番号、および関数の呼び出し履歴が含まれます。