【PHP8.x】getMessageメソッドの使い方

getMessageメソッドは、RangeExceptionオブジェクトに設定された例外メッセージを取得するために実行するメソッドです。このメソッドは、PHPの基本的な例外クラスであるExceptionクラスから継承されているため、RangeExceptionだけでなく、他の多くの例外クラスでも共通して利用できます。プログラムの実行中に、ある値が期待される有効範囲を超えた場合などにRangeExceptionがスローされます。このスローされた例外をtry...catch構文で捕捉した際に、getMessageメソッドを呼び出すことで、その例外がなぜ発生したのかを示す具体的なエラーメッセージを文字列として取得することが可能です。返される文字列は、通常、new RangeException("メッセージ")のように例外オブジェクトを生成する際のコンストラクタに渡されたものです。この機能により、開発者はエラーの原因を正確に把握し、デバッグ作業を効率的に進めたり、エラーログに詳細な情報を記録したりすることができるため、堅牢なエラーハンドリングを実装する上で非常に重要な役割を果たします。

Copy
1<?php
2try {
3    // 有効範囲外の値で例外を意図的に発生させる
4    throw new RangeException("指定された値は範囲外です。");
5} catch (RangeException $e) {
6    // catchした例外オブジェクトからエラーメッセージを取得する
7    $message = $e->getMessage();
8    echo $message;
9}
10?>

引数なし

引数はありません

string

このメソッドは、例外が発生した原因を示すメッセージ文字列を返します。