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

『__toStringメソッドは、OutOfBoundsExceptionオブジェクトが持つ情報を、人間が読みやすい形式の文字列に変換して返す処理を実行するメソッドです。このメソッドはPHPの「マジックメソッド」と呼ばれる特殊なメソッドの一つで、オブジェクトをechoで出力したり、文字列と連結したりするなど、オブジェクトが文字列として扱われる文脈で自動的に呼び出されます。このメソッドによって返される文字列には、例外のクラス名(OutOfBoundsException)、設定されたエラーメッセージ、例外が発生したソースコードのファイル名と行番号、そして例外発生に至るまでの関数の呼び出し履歴（スタックトレース）といった、デバッグに役立つ詳細情報が含まれています。これにより、開発者は配列などのインデックスが範囲外になった問題が、プログラムのどこで、どのような経緯で発生したのかを迅速に把握することができます。この機能は、親クラスであるExceptionクラスから継承されたもので、OutOfBoundsExceptionにおいても同様の動作を提供します。

Copy
1<?php
2try {
3    // 意図的に例外を発生させます
4    throw new OutOfBoundsException("指定されたインデックスは範囲外です。", 404);
5} catch (OutOfBoundsException $e) {
6    // 例外オブジェクトを文字列として出力する際に __toString() が自動的に呼び出されます
7    echo $e;
8}
9?>

引数なし

引数はありません

string

このメソッドは、例外が発生した際の情報を文字列として返します。