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

getTraceAsStringメソッドは、例外のスタックトレースを文字列形式で取得するために実行するメソッドです。BadFunctionCallException、つまり無効な関数呼び出しが試みられた際に発生する例外オブジェクトからこのメソッドを呼び出すと、エラーが発生するまでの処理の経緯を詳細に知ることができます。ここでいうスタックトレースとは、プログラムが例外地点に到達するまでに、どのファイルのどの行で、どのような順番で関数やメソッドが呼び出されてきたかを示す一連の履歴情報です。このメソッドが返す文字列には、一連の呼び出しに関するファイル名、行番号、関数名、そして渡された引数の型などが含まれています。この情報を利用することで、開発者はエラーの原因となったコードの箇所や呼び出しの流れを正確に特定でき、デバッグ作業を効率的に進めることが可能になります。返される値は人間が読みやすいように整形されており、主にエラーログへの記録や、開発環境でのエラー詳細表示に用いられます。このメソッドはPHPの基本的なExceptionクラスで定義されているため、他の多くの例外クラスでも同様に使用できます。

Copy
1<?php
2
3try {
4    // 存在しない関数を呼び出そうとする
5    call_user_func('non_existent_function');
6} catch (BadFunctionCallException $e) {
7    // 例外のスタックトレースを文字列として取得する
8    $traceString = $e->getTraceAsString();
9    echo $traceString;
10}

引数なし

引数はありません

string

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