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

Copy
1<?php
2
3// ErrorException クラスの severity プロパティの例
4try {
5    // E_USER_NOTICE を発生させる
6    trigger_error("これはユーザー定義の通知です。", E_USER_NOTICE);
7} catch (ErrorException $e) {
8    // ErrorException がキャッチされた場合、severity プロパティの値を出力する
9    echo "エラーの重要度: " . $e->severity . PHP_EOL;
10
11    // severity プロパティの値が 8192 (E_USER_NOTICE) であるか確認
12    if ($e->severity === E_USER_NOTICE) {
13        echo "エラーの重要度は E_USER_NOTICE (8192) です。" . PHP_EOL;
14    }
15}
16
17?>

このサンプルコードは、PHP 8における ErrorException クラスの severity プロパティの使い方を示しています。ErrorException は、PHPのエラーを例外として扱うためのクラスです。

まず、trigger_error() 関数を使用して、E_USER_NOTICE レベルのユーザー定義のエラーを発生させています。このエラーは try-catch ブロックで ErrorException としてキャッチされます。

ErrorException オブジェクトの severity プロパティは、発生したエラーの重要度を表す整数値です。この例では、E_USER_NOTICE が発生しているため、$e->severity は E_USER_NOTICE に対応する値、つまり 8192 を持ちます。

サンプルコードでは、echo "エラーの重要度: " . $e->severity . PHP_EOL; によって、この重要度を出力しています。

さらに、if ($e->severity === E_USER_NOTICE) という条件分岐によって、severity プロパティの値が E_USER_NOTICE (8192) であるかどうかを確認し、その結果に応じてメッセージを出力しています。

このように、severity プロパティを参照することで、発生したエラーの種類をプログラム内で判別し、適切な処理を行うことができます。システムエンジニアを目指す上で、エラーの種類に応じた処理を記述することは重要です。

Copy
1<?php
2
3// エラーハンドラ関数を定義します。
4function errorHandler(int $severity, string $message, string $file, int $line): bool
5{
6    if (error_reporting() & $severity) {
7        // ErrorException をスローします。
8        throw new ErrorException($message, 0, $severity, $file, $line);
9    }
10
11    // PHP の組み込みエラーハンドラを実行しません。
12    return true;
13}
14
15// エラーハンドラを設定します。
16set_error_handler('errorHandler');
17
18try {
19    // 意図的に警告を発生させます。
20    $result = 10 / 0; // Warning: Division by zero
21
22} catch (ErrorException $e) {
23    // ErrorException をキャッチし、severity プロパティの値を取得します。
24    echo "Caught ErrorException: " . $e->getMessage() . PHP_EOL;
25    echo "Severity: " . $e->severity . PHP_EOL;
26} finally {
27    // エラーハンドラをリセットします。
28    restore_error_handler();
29}
30
31?>

このPHPのサンプルコードは、ErrorExceptionクラスのseverityプロパティの役割を示すものです。 ErrorExceptionは、PHPのエラーを例外として扱うためのクラスです。

まず、set_error_handler()関数を使って、独自のエラーハンドラ関数errorHandler()を登録します。この関数は、PHPがエラーを検出した際に呼び出されます。 errorHandler()内では、エラーの種類（$severity）に基づいてErrorExceptionをスローしています。$severity引数には、発生したエラーの種類を表す整数値が渡されます。（例：E_WARNING, E_NOTICE）

try...catchブロックの中で、意図的にゼロ除算を行い警告を発生させます。この警告は、設定したエラーハンドラによってErrorExceptionとしてキャッチされます。

catchブロック内では、キャッチしたErrorExceptionオブジェクトのseverityプロパティにアクセスしています。$e->severityとすることで、例外が発生した際のエラーレベル（severity）の値を取得できます。severityプロパティは整数値を返し、発生したエラーの種類（警告、通知など）を示します。

最後に、restore_error_handler()関数を使って、エラーハンドラをデフォルトの状態に戻します。これは、スクリプトの他の部分に影響を与えないようにするためです。 このサンプルコードは、エラーハンドリングの基本的な流れと、ErrorExceptionオブジェクトが保持するエラーレベル情報をseverityプロパティを通じて取得する方法を示しています。