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

getTraceAsStringメソッドは、例外がスローされた時点でのバックトレースを、整形された文字列として取得するメソッドです。バックトレースとは、スタックトレースとも呼ばれ、プログラムが例外の発生地点に至るまでに、どのファイルの何行目で、どの関数やメソッドがどのような順番で呼び出されたかを示す詳細な記録のことです。このメソッドが返す文字列には、これらの呼び出し履歴が人間が読みやすい形式で含まれており、主にプログラムのデバッグ時に使用されます。エラーが発生した直接的な原因だけでなく、そこに至るまでの処理の流れを追跡できるため、問題の特定と解決に非常に役立ちます。getTraceAsStringメソッドは引数を取らず、呼び出すだけでスタックトレース情報を文字列として返します。このメソッドはLengthExceptionクラスに属していますが、実際にはPHPのすべての例外やエラーの基底となるThrowableインターフェースで定義されているため、他の多くの例外オブジェクトでも同様に利用することが可能です。

Copy
1<?php
2try {
3    throw new LengthException("エラーメッセージ");
4} catch (LengthException $e) {
5    // 例外のスタックトレースを文字列として取得します。
6    $trace = $e->getTraceAsString();
7    echo $trace;
8}
9?>

引数なし

引数はありません

string

このメソッドは、例外が発生した際のコールスタック（処理の履歴）を文字列として返します。