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

getTraceAsStringメソッドは、例外がスローされた時点でのスタックトレースを、整形された文字列として取得するメソッドです。スタックトレースとは、プログラムが例外の発生箇所に至るまでに、どのファイルのどの行で、どの関数やメソッドがどのような順番で呼び出されたかを示す一連の履歴情報です。この情報は、エラーの原因を特定し修正するデバッグ作業において極めて重要な役割を果たします。このメソッドを呼び出すと、例外オブジェクトが内部に保持している複雑なトレース情報が、人間が読みやすく、ログファイルへの記録にも適した形式の文字列に変換されて返されます。例えば、try...catchブロックでDomainExceptionのような例外を捕捉した際に、このメソッドの結果をエラーログに出力することで、開発者は問題が発生した正確な場所と、そこに至るまでのプログラムの実行経路を迅速に把握できます。このメソッドは引数を必要とせず、スタックトレース全体を表す一つの文字列を戻り値として返します。

Copy
1<?php
2try {
3    throw new DomainException('エラーが発生しました。');
4} catch (DomainException $e) {
5    // スタックトレースを文字列として取得し、出力します。
6    echo $e->getTraceAsString();
7}
8?>

引数なし

引数はありません

string

例外発生時のコールスタック（関数呼び出し履歴）を文字列形式で取得します。