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

『getTraceメソッドは…を実行するメソッドです』

getTraceメソッドは、例外がスローされた時点までのプログラムの実行経路、すなわち「バックトレース」を取得するために実行するメソッドです。バックトレースとは、例外が発生するまでに、どのファイルの何行目で、どの関数やメソッドが、どのような順番で呼び出されたかを示す呼び出し履歴のことです。この情報は、プログラムのどこで予期せぬ問題が起きたのかを特定するための非常に重要な手がかりとなり、デバッグ作業において不可欠な役割を果たします。このメソッドが返す値は配列であり、各要素には呼び出しに関する詳細情報（ファイル名、行番号、関数名、引数など）が連想配列として格納されています。例えば、配列の範囲外のインデックスにアクセスしてOutOfRangeExceptionが発生した場合、このメソッドを利用することで、どの関数のどの部分で不正なアクセスが試みられたのかを正確に追跡し、問題の根本原因を効率的に突き止めることが可能になります。

Copy
1<?php
2
3function checkValue(int $value) {
4    if ($value < 0 || $value > 100) {
5        throw new OutOfRangeException("The value is out of the valid range (0-100).");
6    }
7}
8
9try {
10    checkValue(150);
11} catch (OutOfRangeException $e) {
12    $trace = $e->getTrace();
13    print_r($trace);
14}

引数なし

引数はありません

array

例外発生時のトレース情報が格納された配列を返します。