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

getTraceメソッドは、DomainExceptionオブジェクトがスローされた時点でのバックトレースを取得するために実行するメソッドです。このメソッドは、DomainExceptionクラスが直接定義しているものではなく、基底クラスであるExceptionクラスから継承されています。バックトレースとは、プログラムの実行が例外の発生地点に至るまでの、関数の呼び出し履歴を指します。このメソッドを呼び出すと、関数の呼び出し履歴が配列として返されます。配列の各要素は、呼び出しに関する詳細情報を含む連想配列となっており、具体的にはファイル名、行番号、呼び出された関数名やクラス名、そしてその際に渡された引数などの情報が含まれています。システム開発におけるデバッグ作業では、この情報を利用して、どのファイルのどの行で、どのような処理の流れを経て例外が発生したのかを正確に追跡できます。これにより、DomainExceptionが発生した根本的な原因を効率的に特定し、問題を解決するための重要な手がかりを得ることが可能になります。

Copy
1<?php
2
3try {
4    // DomainExceptionを意図的にスローします。
5    throw new DomainException("無効な値が指定されました。");
6} catch (DomainException $e) {
7    // 例外がスローされた時点のバックトレースを配列として取得します。
8    $trace = $e->getTrace();
9    
10    // 取得したバックトレース配列の内容を確認します。
11    print_r($trace);
12}

引数なし

引数はありません

array

例外発生時のスタックトレース情報を配列形式で返します。