【PHP8.x】E_RECOVERABLE_ERROR定数の使い方

Copy
1<?php
2
3/**
4 * カスタムエラーハンドラ関数
5 * E_RECOVERABLE_ERROR などのエラーを捕捉し、処理します。
6 *
7 * @param int    $errno   エラーレベル（例: E_RECOVERABLE_ERROR）
8 * @param string $errstr  エラーメッセージ
9 * @param string $errfile エラーが発生したファイルパス
10 * @param int    $errline エラーが発生した行番号
11 * @return bool  trueを返すとPHPの標準エラーハンドラには処理を渡さない、falseを返すと渡す
12 */
13function handleRecoverableError(int $errno, string $errstr, string $errfile, int $errline): bool
14{
15    // 捕捉したエラーが E_RECOVERABLE_ERROR であるかを確認
16    if ($errno === E_RECOVERABLE_ERROR) {
17        echo "リカバリ可能なエラーを捕捉しました！\n";
18        echo "  エラーレベル: " . $errno . " (E_RECOVERABLE_ERROR)\n";
19        echo "  メッセージ: '" . $errstr . "'\n";
20        echo "  発生ファイル: " . $errfile . "\n";
21        echo "  発生行: " . $errline . "\n";
22        echo "  このエラーはカスタムハンドラによって処理されました。\n\n";
23        // trueを返すことで、PHPの標準エラーハンドラによる追加処理を防ぎます。
24        return true;
25    }
26
27    // E_RECOVERABLE_ERROR 以外の場合、PHPの標準エラーハンドラに処理を渡します。
28    // ここで独自にログ記録などを行っても良いでしょう。
29    return false;
30}
31
32// カスタムエラーハンドラを設定します。
33// E_ALL を指定することで、E_RECOVERABLE_ERROR を含む全てのエラーを捕捉対象とします。
34set_error_handler("handleRecoverableError", E_ALL);
35
36echo "--- サンプルコード開始 ---\n\n";
37
38// E_RECOVERABLE_ERROR を意図的に発生させます。
39// trigger_error 関数は、指定されたエラーレベルでエラーを発生させるために使用されます。
40echo "E_RECOVERABLE_ERROR を発生させます...\n";
41trigger_error("これは意図的に発生させたリカバリ可能なエラーです。", E_RECOVERABLE_ERROR);
42echo "E_RECOVERABLE_ERROR の発生後。\n\n";
43
44// その他のエラーも捕捉されることを示す例 (例えば警告)
45echo "E_WARNING を発生させます...\n";
46trigger_error("これは意図的に発生させた警告です。", E_USER_WARNING);
47echo "E_WARNING の発生後。\n\n";
48
49// エラーハンドラを元の状態に戻します (オプション)。
50// これにより、以降のエラーはPHPのデフォルトハンドラで処理されます。
51restore_error_handler();
52
53echo "--- サンプルコード終了 ---\n";

PHPのE_RECOVERABLE_ERRORは、プログラムの実行を完全に停止させることなく、エラーハンドラで捕捉し回復処理を行える「リカバリ可能なエラー」を示す内部定数です。これは、型宣言の不一致など、PHPが回復を試みる可能性のある重大なエラーレベルで発生します。

サンプルコードは、このE_RECOVERABLE_ERRORを含む特定のエラーを、独自に定義した関数で処理するカスタムエラーハンドラの仕組みを示しています。set_error_handler関数により、エラー発生時に呼び出されるhandleRecoverableError関数を設定しています。このハンドラ関数は、エラーレベル（$errno）、メッセージ（$errstr）、発生ファイル（$errfile）、行番号（$errline）を引数として受け取ります。

handleRecoverableError関数内部では、$errnoがE_RECOVERABLE_ERRORと一致するかを確認し、一致すれば独自のメッセージを出力して処理を行います。この関数がtrueを返すと、PHPの標準エラーハンドラはこれ以上処理を行いません。falseを返した場合は、PHPの標準エラーハンドラに処理が引き継がれます。

trigger_error関数は、意図的にエラーを発生させるために使用され、サンプルではE_RECOVERABLE_ERRORを指定してカスタムハンドラが動作する様子を確認しています。これにより、PHPアプリケーションにおいて、特定の回復可能なエラーに対して細やかな制御やログ記録などを実装できるようになります。最後にrestore_error_handlerで元のエラーハンドラに戻しています。

Copy
1<?php
2
3/**
4 * E_RECOVERABLE_ERROR の発生とカスタムエラーハンドラによる捕捉をデモンストレーションします。
5 *
6 * E_RECOVERABLE_ERROR は「リカバリ可能な致命的エラー」を意味し、
7 * PHPが実行を継続できるものの、通常は致命的とみなされるべき問題が発生したことを示します。
8 * PHP 8 では多くの型関連のエラーは TypeError 例外となりましたが、
9 * set_error_handler() を使用することで捕捉し、独自の処理を実行できます。
10 */
11function demonstrateRecoverableError(): void
12{
13    // カスタムエラーハンドラを設定
14    // E_RECOVERABLE_ERROR を捕捉し、詳細メッセージを表示してスクリプトの継続を許可します。
15    set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline): bool {
16        // 発生したエラーが E_RECOVERABLE_ERROR であるかを確認
17        if ($errno === E_RECOVERABLE_ERROR) {
18            echo "--- カスタムエラーハンドラが E_RECOVERABLE_ERROR を捕捉しました ---\n";
19            echo "エラータイプ: E_RECOVERABLE_ERROR\n";
20            echo "メッセージ: {$errstr}\n";
21            echo "発生元ファイル: {$errfile} (行: {$errline})\n";
22            echo "---------------------------------------------------------\n";
23            // true を返すと、PHP の標準エラーハンドラは実行されず、
24            // スクリプトはエラー発生箇所から処理を継続します。
25            return true;
26        }
27        // その他のエラーは PHP の標準エラーハンドラに任せるため false を返します。
28        return false;
29    });
30
31    echo "--- E_RECOVERABLE_ERROR のデモンストレーション開始 ---\n";
32
33    try {
34        echo "意図的に E_RECOVERABLE_ERROR を発生させます。\n";
35        // trigger_error() を使用して E_RECOVERABLE_ERROR を明示的に発生させます。
36        // これは、PHP が内部で発生させる E_RECOVERABLE_ERROR と同様に扱われます。
37        trigger_error('これは、ユーザーが意図的に発生させたリカバリ可能な致命的エラーの例です。', E_RECOVERABLE_ERROR);
38
39        echo "カスタムエラーハンドラがエラーを処理した後、スクリプトは正常に継続しています。\n";
40        echo "これは、E_RECOVERABLE_ERROR が致命的であっても「リカバリ可能」であることを示します。\n";
41    } catch (Throwable $e) {
42        // E_RECOVERABLE_ERROR はデフォルトでは例外ではないため、
43        // ここでは捕捉されません（カスタムハンドラが例外をスローしない限り）。
44        echo "捕捉された例外: " . $e->getMessage() . "\n";
45    } finally {
46        // デモンストレーションの終了時にエラーハンドラを元の状態に戻します。（オプション）
47        restore_error_handler();
48    }
49
50    echo "--- E_RECOVERABLE_ERROR のデモンストレーション終了 ---\n";
51}
52
53// デモンストレーション関数を実行します。
54demonstrateRecoverableError();

PHPの定数E_RECOVERABLE_ERRORは、「リカバリ可能な致命的エラー」を示す組み込み定数です。これは、PHPの実行が継続できるものの、通常であればプログラムが停止するような致命的な問題が発生した際に使用されます。PHP 8では、多くの型関連のエラーはTypeError例外として扱われるようになりましたが、この定数によって示されるタイプのエラーは、set_error_handler()関数を用いることで、その発生を捕捉し、開発者が独自の処理を行うことが可能です。

提供されたサンプルコードでは、まずset_error_handler()を使ってカスタムエラーハンドラを設定しています。このハンドラは、エラー番号（$errno）、エラーメッセージ（$errstr）、発生元のファイル名（$errfile）、行番号（$errline）を引数として受け取り、詳細なエラー情報にアクセスできます。E_RECOVERABLE_ERRORが発生した場合、このカスタムハンドラがその情報を表示し、trueを返すことでPHPの標準エラー処理を抑制し、スクリプトの実行を継続させています。

trigger_error()関数にE_RECOVERABLE_ERROR定数を指定してエラーを意図的に発生させると、設定したカスタムエラーハンドラがこれを捕捉します。エラーが処理された後もスクリプトは中断せずに実行を継続し、E_RECOVERABLE_ERRORが「リカバリ可能」であることの挙動を示しています。これにより、エラー発生時でも柔軟なエラー処理を実装できることを理解できます。