【PHP8.x】messageプロパティの使い方

messageプロパティは、日付や時刻を表す文字列が不正な形式である場合に発生する例外の詳細なエラーメッセージを保持するプロパティです。

PHP 8で導入されたDateMalformedStringExceptionクラスに属するこのプロパティは、日付や時刻のパース（解析）処理において、期待される文字列形式と異なる入力が与えられた場合にスローされる例外オブジェクトの一部として提供されます。例えば、DateTimeImmutableクラスのコンストラクタに、日付として存在しない'2023-13-01'のような文字列や、全く解析できない'invalid-date-string'といった文字列を渡した場合に、この例外が発生します。

messageプロパティは、このような状況で「どのような入力が」「なぜ不正と判断されたのか」といった、具体的なエラーの内容を示す文字列を提供します。開発者は、例外をtry-catchブロックで捕捉した際に、このmessageプロパティにアクセスすることで、エラーの根本原因を正確に把握し、デバッグ作業を効率的に進めることができます。

このプロパティは、例外オブジェクトが生成されるときに一度設定され、その内容は読み取り専用です。したがって、プログラム実行中に外部からその値を変更することはできません。システムエンジニアを目指す方にとって、エラーハンドリングの際にこのmessageプロパティを活用することは、問題解決能力を高め、より堅牢なプログラムを構築するために非常に重要です。

Copy
1try {
2    new DateTimeImmutable('invalid date string');
3} catch (DateMalformedStringException $e) {
4    echo $e->message;
5}

string

DateMalformedStringExceptionクラスのmessageプロパティは、無効な日付文字列が原因で例外が発生した際の、エラーメッセージを文字列で返します。