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

__toStringメソッドは、BadFunctionCallExceptionオブジェクトの情報を人間が読みやすい形式の文字列として生成するメソッドです。このメソッドは、PHPの基本的な例外クラスであるExceptionクラスから継承されたマジックメソッドであり、オブジェクトが文字列として扱われる状況で自動的に呼び出されます。例えば、catchブロック内で例外オブジェクトを直接echoで出力しようとしたり、ログファイルに記録したりすると、内部的にこの__toStringメソッドが実行されます。返される文字列には、例外のクラス名、コンストラクタで設定されたエラーメッセージ、例外が発生したソースコードのファイル名と行番号、そして例外発生箇所に至るまでの関数の呼び出し履歴を示すスタックトレースが含まれています。これにより、開発者は無効なコールバック関数の呼び出しや引数の間違いといったエラーが発生した際に、その原因を特定するための詳細な情報を容易に取得できます。通常、このメソッドを明示的に呼び出す必要はなく、例外処理のデバッグ過程で暗黙的に利用されることがほとんどです。

Copy
1$exception = new BadFunctionCallException('エラーメッセージ', 123);
2$errorString = $exception->__toString();

引数なし

引数はありません

string

このメソッドは、例外が発生した状況を説明する文字列を返します。