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

codeプロパティは、DateExceptionクラスで発生した日付/時刻関連のエラーを識別するための数値コードを保持するプロパティです。

PHPでは、プログラムの実行中に予期せぬ問題が発生した際に「例外（Exception）」と呼ばれる特別な仕組みを使ってエラーを通知します。DateExceptionは、特に日付や時刻の操作において、無効な日付形式を解析しようとしたり、存在しない日付（例えば2月30日）を指定したりするなど、日付処理に関連する問題が起きたときにスローされる例外です。

このcodeプロパティには、発生した特定のエラーを示す整数値が格納されています。システム開発において、エラーの種類を数値で区別することは非常に重要です。このプロパティの値を確認することで、プログラムはどのような種類の日付関連エラーが発生したのかを詳細に判別できます。これにより、エラーの種類に応じて異なる処理を実行したり、より具体的なエラーメッセージをユーザーに表示したりすることが可能になります。例えば、try-catchブロックでDateExceptionを捕捉した際に、例外オブジェクトから$exception->getCode()のようにしてこのプロパティの値を取得し、その後の処理に活用することができます。

Copy
1<?php
2
3try {
4    // 日付処理でDateExceptionが発生する可能性のあるコード
5    // 例としてDateExceptionをスロー
6    throw new DateException("無効な日付形式です。", 5001);
7} catch (DateException $e) {
8    $errorCode = $e->code;
9}

int

DateException クラスの code プロパティは、発生した例外のエラーコードを表す整数値を返します。