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

messageプロパティは、例外に関する説明的なメッセージを保持するプロパティです。このプロパティはRangeExceptionクラスに属しますが、実際にはその親クラスであるExceptionクラスから継承されたものです。PHPにおける全ての組み込み例外はExceptionクラスを継承しているため、messageプロパティはほとんどの例外オブジェクトが共通して持つ基本的な要素となります。RangeExceptionは、プログラムのロジックにおいて、ある値が期待される有効な範囲を超えていた場合にスローされる例外です。その際、なぜ例外が発生したのかという具体的な理由を説明する文字列が、このmessageプロパティに格納されます。例えば、new RangeException("引数は1から10の間でなければなりません")のようにインスタンスを生成すると、指定した文字列がこのプロパティの値となります。この値は、getMessage()メソッドを通じて取得することができ、エラーログの記録やデバッグ時の原因特定に役立つ重要な情報源として利用されます。

Copy
1<?php
2try {
3    throw new RangeException("値が有効な範囲にありません。");
4} catch (RangeException $e) {
5    // 例外オブジェクトからメッセージを取得します。
6    echo $e->getMessage();
7}

引数なし

引数はありません

string

このプロパティは、例外が発生した原因を示す文字列を返します。