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

getTraceメソッドは、例外のスロー時点におけるスタックトレースを取得するメソッドです。このメソッドは、LogicExceptionがスローされた際に、そこに至るまでにどのような関数やメソッドがどのような順序で呼び出されたかという、プログラムの実行経路の履歴を追跡するために使用されます。スタックトレースは、プログラムの論理的な誤り、つまりバグの原因を特定しデバッグを行う上で極めて重要な情報源となります。メソッドの返り値は、スタックトレースの各フレームを要素とする配列です。配列の各要素は連想配列となっており、呼び出し元のファイル名を示す file キー、行番号を示す line キー、呼び出された関数名やメソッド名を示す function キーなど、デバッグに役立つ詳細な情報を含んでいます。この情報を利用することで、開発者は問題が発生した根本原因を正確に特定し、修正することが可能になります。エラーログにスタックトレースを記録することは、アプリケーションの保守性向上に不可欠な手法です。

Copy
1<?php
2
3function causeLogicError()
4{
5    throw new LogicException("意図的なロジックエラーです。");
6}
7
8try {
9    causeLogicError();
10} catch (LogicException $e) {
11    // 例外のバックトレースを配列として取得します。
12    $trace = $e->getTrace();
13    print_r($trace);
14}

引数なし

引数はありません

array

例外が発生した際のコールスタック（実行履歴）を配列形式で返します。