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

messageプロパティは、例外に関する説明文（エラーメッセージ）を保持するプロパティです。このプロパティは、値が定義された有効な範囲、すなわちデータドメインに属していないことを示すためにスローされるDomainExceptionクラスに属しています。例えば、特定の関数が引数として正の整数のみを受け付ける仕様であるにもかかわらず、負の数が渡された場合などにDomainExceptionが使用されます。その際、messageプロパティには「引数は正の数でなければなりません」といった、エラーの原因を具体的に説明する文字列が格納されます。このエラーメッセージは、プログラムのデバッグやエラーログの記録において非常に重要な役割を果たします。開発者はこのメッセージを読むことで、問題の発生箇所と原因を迅速に特定できます。messageプロパティの値は、DomainExceptionのインスタンスが生成される際にコンストラクタの引数として設定され、getMessage()メソッドを通じて取得するのが一般的です。このプロパティは、PHPの全ての例外クラスの基底となるExceptionクラスから継承されたものであり、例外処理における基本的な要素の一つです。

Copy
1<?php
2
3try {
4    // DomainExceptionを意図的にスローする
5    throw new DomainException("値が有効なドメインの範囲外です。");
6} catch (DomainException $e) {
7    // 継承されたgetMessage()メソッドでメッセージを取得する
8    echo $e->getMessage();
9}
10
11?>

引数なし

引数はありません

string

このプロパティは、例外が発生した際の詳細なメッセージを文字列で返します。