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

getTraceAsStringメソッドは、例外がスローされた時点でのプログラムの実行履歴（スタックトレース）を、整形された文字列として取得するメソッドです。スタックトレースとは、例外が発生するまでに、どのような関数やメソッドがどのファイルや行番号で呼び出されてきたかを示す一連の記録です。このメソッドを使用することで、エラーの原因を特定する際の重要な手がかりを得ることができます。例えば、OverflowExceptionが発生した場合、どの計算処理で値のオーバーフローが起きたのか、またその処理がどのような順序で呼び出されたのかを追跡することが可能になります。返される文字列には、各呼び出しステップのファイル名、行番号、関数名、そしてもしあればクラス名やオブジェクトの種別が含まれます。この情報は、ログファイルへの出力やデバッグ時の画面表示に利用されることが多く、プログラムの問題解決を効率的に進めるために不可欠な機能です。このメソッドはPHPの基本的なExceptionクラスで定義されているため、OverflowExceptionを含む全ての例外クラスのインスタンスから呼び出すことができます。

Copy
1<?php
2try {
3    throw new OverflowException("An example overflow error occurred.");
4} catch (OverflowException $e) {
5    echo $e->getTraceAsString();
6}
7?>

引数なし

引数はありません

string

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