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

getTraceメソッドは、例外がスローされた時点のバックトレース（スタックトレース）を取得するために実行するメソッドです。このメソッドは、UnexpectedValueExceptionクラスがその親クラスであるExceptionクラスから継承しています。UnexpectedValueExceptionは、変数の値が期待される値のセットと一致しない、予期しない値であった場合に発生する例外です。getTraceメソッドを呼び出すと、例外が発生した箇所からプログラムの実行開始点に至るまで、どのような関数やメソッドがどのような順序で呼び出されたかの履歴が配列として返されます。返される配列の各要素は、呼び出しスタックの各ステップを表す連想配列となっており、ファイル名、行番号、関数名、クラス名、そして関数に渡された引数といった詳細な情報が含まれています。この情報を利用することで、開発者は予期しない値がプログラムのどの経路をたどって渡されてきたのかを正確に追跡でき、問題の原因を効率的に特定するための重要な手がかりを得ることができます。したがって、このメソッドはデバッグ作業において非常に役立ちます。

Copy
1<?php
2try {
3    throw new UnexpectedValueException("予期しない値が検出されました。");
4} catch (UnexpectedValueException $e) {
5    $stackTrace = $e->getTrace();
6}

引数なし

引数はありません

array

例外発生時のトレース情報（スタックトレース）を配列形式で返します。この配列には、例外が発生した場所や、そこに至るまでの関数の呼び出し履歴などが含まれます。