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

getTraceメソッドは、例外が発生した時点のバックトレース（関数の呼び出し履歴）を取得するメソッドです。OverflowExceptionのような例外がスローされた際にこのメソッドを呼び出すと、例外発生地点に至るまでにプログラムがどのような順序で関数やメソッドを呼び出してきたかの詳細な情報を得ることができます。この情報は、プログラムの不具合を修正するデバッグ作業において非常に重要であり、エラーの原因を特定するための強力な手がかりとなります。例えば、どの計算処理でオーバーフローが発生したのかを正確に追跡することが可能になります。getTraceメソッドが返す値は、トレース情報を格納した配列です。配列の各要素は、呼び出し階層の一段階分を表す連想配列となっており、その中にはファイル名、行番号、呼び出された関数名やクラス名、そして渡された引数などの情報が含まれています。このメソッドはOverflowExceptionクラスが親のExceptionクラスから継承している機能のため、PHPのほとんどの例外オブジェクトで共通して利用することができます。

Copy
1<?php
2
3try {
4    throw new OverflowException("An error occurred.");
5} catch (OverflowException $e) {
6    $trace = $e->getTrace();
7}

引数なし

引数はありません

array

例外発生時のコールスタック（処理の履歴）を配列形式で返します。