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

messageプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

messageプロパティは、エラーに関する詳細な説明文を文字列として保持するプロパティです。このプロパティは、所属するDateRangeErrorクラスのインスタンスが生成された際に、なぜエラーが発生したのかという具体的な理由を格納します。DateRangeErrorは、DatePeriodクラスなどで日付や時刻の範囲を指定する際に、その範囲が無効である場合にスローされる例外です。例えば、開始日時が終了日時よりも後になっている状況などが該当します。その際、messageプロパティには「Start date cannot be after end date」のような、人間が読んで理解できるメッセージが設定されます。このプロパティは、PHPの例外の基本となるExceptionクラスから継承されたものであり、多くの例外クラスで共通して利用できます。開発者は、try-catchブロックでDateRangeErrorを捕捉した際にこのプロパティの値を確認することで、エラーの原因を特定し、デバッグやログ記録、あるいは利用者に適切なエラー情報を提示するために役立てることができます。

構文(syntax)

1<?php
2$error = new DateRangeError('指定された日付範囲は無効です。');
3echo $error->message;
4?>

引数(parameters)

戻り値(return)

string

DateRangeError クラスで発生したエラーメッセージを表す文字列です。

【PHP8.x】messageプロパティの使い方 | いっしー@Webエンジニア