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

getTraceメソッドは、例外がスローされた時点でのスタックトレースを取得するために実行するメソッドです。このメソッドは、DateInvalidTimeZoneExceptionクラスが基底クラスであるExceptionから継承している機能の一つです。スタックトレースとは、プログラムが例外の発生地点に到達するまでに、どのファイルのどの行で、どのような関数やメソッドがどのような順番で呼び出されたかという実行経路の履歴情報であり、デバッグ作業において非常に重要です。getTraceメソッドは、このスタックトレースを配列として返します。配列の各要素は、関数呼び出し一つ分に相当するフレーム情報を格納した連想配列です。この連想配列には、ファイル名を示すfileキー、行番号を示すlineキー、関数名を示すfunctionキーなどが含まれています。DateInvalidTimeZoneExceptionが発生した際にこのメソッドを利用することで、無効なタイムゾーンが指定されたコードの箇所を正確に特定し、エラー原因の調査と修正を迅速に行うことができます。

Copy
1<?php
2
3try {
4    // 存在しないタイムゾーンを指定して DateInvalidTimeZoneException を発生させる
5    new DateTimeZone('Invalid/TimeZone');
6} catch (DateInvalidTimeZoneException $e) {
7    // 例外オブジェクトからスタックトレースを取得する
8    $trace = $e->getTrace();
9    // $trace には、例外が発生した時点でのスタックトレースが配列として格納される
10}

引数なし

引数はありません

array

このメソッドは、例外が発生した際のコールスタック（関数の呼び出し履歴）を配列形式で返します。