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

『__toStringメソッドは、OverflowExceptionオブジェクトの文字列表現を生成して返すメソッドです』

このメソッドは、PHPに組み込まれている「マジックメソッド」の一つであり、オブジェクトが文字列として扱われる状況で自動的に呼び出されます。例えば、echo文でOverflowExceptionオブジェクトを直接出力しようとしたり、文字列と連結したりする場合に、このメソッドが内部的に使用されます。OverflowExceptionはPHPの基本的なExceptionクラスを継承しており、この__toStringメソッドの機能もExceptionクラスから引き継いでいます。

メソッドが返す文字列には、例外に関する詳細な情報が人間が読みやすい形式でまとめられています。具体的には、例外のクラス名であるOverflowException、コンストラクタで設定された例外メッセージ、例外コード、そして例外がスローされたファイル名と行番号です。さらに、例外が発生するまでの関数呼び出しの履歴を示すスタックトレースも含まれるため、エラーの追跡が容易になります。この機能は、主にデバッグ時の情報表示や、ログファイルへの例外情報の記録といった目的で利用され、問題の原因究明を効率化するために不可欠です。

Copy
1<?php
2
3try {
4    // OverflowExceptionが発生する状況をシミュレート
5    throw new OverflowException("計算結果が許容範囲を超えました。", 500);
6} catch (OverflowException $e) {
7    // 例外オブジェクトを文字列として扱うと、__toString() メソッドが自動的に呼び出される
8    echo $e;
9}
10
11?>

引数なし

引数はありません

string

OverflowExceptionクラスの__toStringメソッドは、例外オブジェクトを文字列として表現したものを返します。これにより、例外発生時の詳細な情報を取得できます。