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

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

作成日: 更新日:

基本的な使い方

『messageプロパティは、例外が発生した際の詳細な説明文を保持するプロパティです。』このプロパティは、PHPの全ての例外クラスの基底となるExceptionクラスで定義されており、実行時エラーを表すRuntimeExceptionクラスはこれを継承しています。プロパティに格納される文字列は、なぜ例外がスローされたのかを開発者が理解するための重要な情報となります。messageプロパティの値は、RuntimeExceptionのインスタンスを生成する際のコンストラクタの第一引数で設定します。例えば、new RuntimeException("ファイルが見つかりません。")のように記述すると、「ファイルが見つかりません。」という文字列がこのプロパティに格納されます。このプロパティはprotectedとして宣言されているため、クラスの外部から直接アクセスすることはできません。値を取得するには、公開されているgetMessage()メソッドを使用します。try-catch構文で例外を捕捉した際に、$exception->getMessage()のように呼び出すことで、設定されたエラーメッセージを取得し、ログに出力したり、利用者に通知したりすることが可能です。この仕組みにより、プログラムの実行時に発生した予期せぬエラーの原因を特定し、デバッグ作業を効率化できます。

構文(syntax)

1<?php
2
3try {
4    throw new RuntimeException("これは実行時エラーのメッセージです。");
5} catch (RuntimeException $e) {
6    // RuntimeExceptionオブジェクトのメッセージを取得します
7    echo $e->getMessage();
8}
9

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

RuntimeExceptionクラスのmessageプロパティは、例外が発生した際の詳細なメッセージを文字列として返します。