【PHP8.x】__toStringメソッドの使い方
作成日: 更新日:
__toStringメソッドは、ErrorExceptionオブジェクトの内容を人間が読みやすい形式の文字列に変換して返す処理を実行するメソッドです。このメソッドは、オブジェクトが文字列として扱われる場面、例えばecho
文で直接出力しようとしたり、文字列と連結したりした場合に自動的に呼び出されます。返される文字列には、例外に関する包括的な情報が含まれており、デバッグ作業に非常に役立ちます。具体的には、親クラスであるExceptionから継承した例外メッセージ、コード、例外が発生したファイル名と行番号に加え、ErrorExceptionクラス固有のプロパティであるエラーの重大度(severity)が整形されて含まれます。さらに、例外発生地点までのコードの実行経路を示すスタックトレースも末尾に追加されます。これにより、エラーの原因を特定するための詳細な情報を一つの文字列として簡単に取得でき、ログファイルへの記録やエラー画面への表示を容易にします。
基本的な使い方
構文(syntax)
1<?php 2$error = new ErrorException("システムエラーが発生しました", 0, E_ERROR, __FILE__, __LINE__); 3echo $error; 4?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
このメソッドは、例外オブジェクトを文字列形式で表現したものを返します。この文字列には、エラーコード、エラーメッセージ、エラーが発生したファイル名、行番号などの詳細情報が含まれます。