【PHP8.x】getTraceメソッドの使い方
getTraceメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
getTraceメソッドは、例外がスローされた時点のスタックトレースを配列として取得するメソッドです。スタックトレースとは、プログラムが例外の発生地点に至るまでに、どの関数やメソッドがどの順番で呼び出されたかの履歴情報です。このメソッドを利用することで、エラーの原因を特定するための重要な手がかりを得ることができます。戻り値は配列であり、その各要素は呼び出しスタックの1ステップを表す連想配列です。この連想配列には、呼び出しが行われたファイル名、行番号、関数名やメソッド名、クラス名、渡された引数といったデバッグに役立つ詳細な情報が含まれています。例えば、RangeExceptionが発生した際にこのメソッドを使用すると、不正な値が使用されたコードがどのファイルの何行目にあり、そこに至るまでにどのような処理の連鎖があったのかを正確に追跡することが可能になります。このメソッドはThrowableインターフェースで定義され、Exceptionクラスを通じて継承されているため、RangeExceptionだけでなくPHPの全ての例外オブジェクトで共通して利用できます。
構文(syntax)
1final public function getTrace(): array
引数(parameters)
引数なし
引数はありません
戻り値(return)
array
例外発生時のトレース情報（スタックトレース）を配列形式で返します。この配列には、例外が発生した場所や、その例外を呼び出した関数の履歴などが含まれています。