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

getMessageメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

getMessageメソッドは、DateMalformedPeriodStringExceptionクラスに属し、発生した例外に関する詳細なエラーメッセージを取得するために実行するメソッドです。 DateMalformedPeriodStringExceptionは、PHP 8で導入された例外クラスの一つで、DatePeriodオブジェクトの生成や操作において、期間を表す文字列が期待されるフォーマットに合致しない場合にスローされます。例えば、「P1Y2M3D」のように期間を定義する文字列が、文法的に誤っていたり、認識できない文字を含んでいたりする場合にこの例外が発生します。 getMessageメソッドを呼び出すことで、プログラマは、何が問題だったのか、具体的にどの部分が不正であったのかといった情報を含むエラーメッセージを文字列として受け取ることができます。これにより、開発者は例外を捕捉した際に、エラーの原因を素早く特定し、適切なデバッグやエラーハンドリングを行うための手がかりを得られます。 このメソッドは引数を必要とせず、常に例外オブジェクト内に格納された説明的なエラーメッセージを文字列として返します。getMessageは、PHPにおける多くの例外クラスで共通して利用される標準的なメソッドであり、プログラムの安定性を高め、問題解決を効率的に進める上で非常に重要な役割を果たします。

構文(syntax)

1<?php
2
3try {
4    new DatePeriod('P1Y2M3DT4H5M6S/INVALID');
5} catch (DateMalformedPeriodStringException $e) {
6    echo $e->getMessage();
7}
8
9?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

このメソッドは、例外が発生した原因となった不正な期間文字列を返します。

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