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

作成日: 更新日:

getMessageメソッドは、ErrorExceptionオブジェクトに格納されているエラーメッセージを取得するメソッドです。ErrorExceptionは、PHPが通常発生させるエラー(例えば、存在しないファイルを開こうとした場合など)を、開発者が通常の例外処理(try-catch文など)で捕捉できるように、Exceptionクラスのインスタンスとしてラップするために使用される特別なクラスです。このメソッドを利用することで、プログラムの実行中に発生した特定のエラーについて、具体的にどのような問題が発生したのかを詳細な文字列として取得できます。

例えば、エラーが発生した際にその原因をログに記録したり、ユーザーに対して分かりやすいメッセージを表示したりする際に、getMessageメソッドが返すエラーメッセージが非常に役立ちます。このメソッドは引数を取らずに呼び出すことができ、常にエラー内容を表す文字列を返します。返される文字列は、ErrorExceptionオブジェクトが生成される際にコンストラクタで指定されたものです。システムエンジニアを目指す上で、プログラムの堅牢性を高めるためのエラーハンドリングは非常に重要であり、getMessageメソッドはその中心的な役割を担う基本的なツールの一つと言えるでしょう。

基本的な使い方

構文(syntax)

1<?php
2try {
3    // ErrorException のインスタンスを生成し、スローする例
4    throw new ErrorException("指定されたファイルが見つかりません。", 0, E_ERROR, __FILE__, __LINE__);
5} catch (ErrorException $e) {
6    // ErrorException::getMessage() を呼び出してエラーメッセージを取得する
7    echo $e->getMessage();
8}

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

このメソッドは、発生した例外のエラーメッセージを文字列として返します。

【PHP8.x】getMessageメソッドの使い方 | いっしー@Webエンジニア