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

作成日: 更新日:

messageプロパティは、PHPプログラムの実行中に発生したエラーに関する詳細な説明文を保持するプロパティです。このプロパティは、Error クラス、およびその子クラス(例えば TypeErrorParseError など)のインスタンスが持つ基本的な情報の一つであり、エラーの具体的な内容を文字列として提供します。

システムエンジニアにとって、プログラムが意図しない動作をした際に、何が問題であったのかを正確に把握することは非常に重要です。message プロパティに格納された説明文は、エラーの原因を特定し、デバッグを行うための重要な手がかりとなります。例えば、型が合わない引数を関数に渡した場合に発生する TypeErrormessage プロパティは、「引数1はint型である必要がありますが、string型が渡されました」といった具体的な情報を含んでいます。

このプロパティの値は、通常、try-catch ブロックでエラーを捕捉した際に、Error オブジェクトから取得されます。PHPの例外処理の基盤である Throwable インターフェースが提供する getMessage() メソッドを使用することで、このプロパティの内容を安全かつ標準的な方法で取得できます。これにより、エラー発生時にユーザーに適切なフィードバックを提供したり、ログに詳細なエラー情報を記録したりすることが可能となり、プログラムの堅牢性と保守性を高める上で不可欠な要素となっています。

基本的な使い方

構文(syntax)

1try {
2    // 例: 未定義の関数を呼び出すことで内部的にErrorが発生
3    undefined_function();
4} catch (Error $e) {
5    // 捕捉したErrorオブジェクトのmessageプロパティにアクセス
6    echo $e->message;
7}

引数(parameters)

戻り値(return)

戻り値なし

戻り値はありません

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