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

__toStringメソッドは、DateInvalidTimeZoneExceptionオブジェクトの文字列表現を生成して返すメソッドです。このメソッドは、オブジェクトを文字列として扱おうとした際に自動的に呼び出されるPHPの特殊なメソッド（マジックメソッド）です。例えば、echo文でオブジェクトを直接画面に出力しようとしたり、文字列と連結しようとしたりする場面で利用されます。DateInvalidTimeZoneExceptionは、無効なタイムゾーン識別子が指定された際にスローされる例外です。この例外オブジェクトに対して__toStringメソッドが実行されると、例外に関する詳細情報が整形された文字列として得られます。この文字列には、例外のクラス名、設定されたエラーメッセージ、例外が発生したファイル名と行番号、そして例外発生に至るまでの処理の呼び出し履歴を示すスタックトレースが含まれます。これにより、開発者はtry-catchブロックで捕捉した例外オブジェクトの情報を、デバッグやログ記録のために簡単かつ分かりやすい形式で取得することが可能です。

Copy
1<?php
2
3try {
4    new DateTimeZone('Invalid/TimeZone');
5} catch (DateInvalidTimeZoneException $e) {
6    // 例外オブジェクトを文字列として評価する際に __toString() が呼び出されます
7    echo $e;
8}

引数なし

引数はありません

string

このメソッドは、無効なタイムゾーンが原因で発生した例外に関する詳細情報を含む文字列を返します。