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

Copy
1<?php
2
3/**
4 * PHPのエラーレポート設定と、E_ERRORを含むエラーレベルについてデモンストレーションする関数。
5 *
6 * システムエンジニアを目指す初心者向けに、開発環境での一般的なエラーレポート設定、
7 * および様々なエラータイプ（通知、警告、致命的エラー）がどのように扱われるかを説明します。
8 */
9function demonstrateErrorReporting(): void
10{
11    // 開発環境では、通常、すべてのエラーを報告し、画面に表示する設定にします。
12    // E_ALL は、すべてのエラー、警告、注意、非推奨の通知などを含みます。
13    // E_ERROR は、E_ALL に含まれる最も深刻なエラーレベルの一つです。
14    error_reporting(E_ALL);
15
16    // エラーをブラウザに表示するかどうかを設定します。
17    // 開発中は '1' (表示) に設定し、本番環境では '0' (非表示) に設定するのが一般的です。
18    ini_set('display_errors', '1');
19
20    // エラーをログファイルに出力するかどうかを設定します。
21    // このデモンストレーションでは、画面表示に焦点を当てるためログ出力は無効にします。
22    ini_set('log_errors', '0');
23
24    echo "<h3>PHP エラーレポート設定のデモンストレーション</h3>";
25    echo "<p>現在のエラーレポートレベル: <b>" . error_reporting() . "</b> (E_ALL)</p>";
26    echo "<p>画面へのエラー表示: <b>" . ini_get('display_errors') . "</b> (有効)</p>";
27    echo "<p>これらの設定により、PHPは可能な限り多くの種類のエラーを報告し、画面に表示します。</p>";
28
29    echo "<h4>エラータイプの例：</h4>";
30
31    // 1. E_NOTICE (通知) の例
32    // 未定義変数へのアクセスは E_NOTICE を発生させます。
33    echo "<p><b>E_NOTICE (通知):</b> 未定義変数へのアクセス</p>";
34    // @ 演算子を使用すると、エラーが発生しても画面に出力されません。
35    // これはデモンストレーションのために一時的に出力を抑制する目的で使用します。
36    @$undefinedVariable;
37    echo "未定義変数にアクセスしました。@演算子がない場合、'Undefined variable: undefinedVariable' という通知が表示されます。<br><br>";
38
39    // 2. E_WARNING (警告) の例
40    // 存在しないファイルを `include` しようとすると E_WARNING を発生させます。
41    echo "<p><b>E_WARNING (警告):</b> 存在しないファイルのインクルード</p>";
42    @include 'non_existent_file.php';
43    echo "存在しないファイルをインクルードしようとしました。@演算子がない場合、'Failed to open stream: No such file or directory' という警告が表示されます。<br><br>";
44
45    // 3. E_ERROR (致命的なエラー) についての解説
46    // E_ERROR は、スクリプトの実行を即座に停止させる最も深刻なエラーです。
47    // このエラーが発生すると、それ以降のコードは実行されません。
48    echo "<p><b>E_ERROR (致命的なエラー):</b> スクリプトを停止させるエラー</p>";
49    echo "E_ERRORは、例えば存在しない関数を呼び出したり、構文エラーがあったりした場合に発生します。<br>";
50    echo "error_reporting(E_ALL) が設定されていれば、E_ERROR も報告対象に含まれます。<br>";
51    echo "このサンプルコードでは、スクリプトの停止を防ぐため、意図的に E_ERROR を発生させません。<br>";
52    echo "以下はE_ERRORが発生する可能性のあるコードの例ですが、実行するとこのスクリプトは停止します。<br>";
53    echo "<code>// nonExistentFunction(); // 存在しない関数を呼び出すと E_ERROR が発生し、スクリプトが停止します。</code><br>";
54    echo "<code>// new NonExistentClass(); // 存在しないクラスをインスタンス化すると E_ERROR が発生します。</code><br>";
55    echo "<code>// parse_error; // PHPの構文エラーも E_PARSE または E_ERROR に該当し、スクリプトの実行が停止します。</code><br><br>";
56
57    echo "<p>これらのエラーは、開発中に問題を発見し、修正するために非常に重要です。</p>";
58    echo "<p>本番環境では、ユーザーにエラー内容を表示せず、ログファイルにのみ記録するように設定することが推奨されます。</p>";
59}
60
61// 関数を実行してデモンストレーションを開始します。
62demonstrateErrorReporting();
63
64?>

PHPのE_ERRORは、スクリプトの実行を即座に停止させる最も深刻なエラーを示す定数です。この定数自体は引数を取らず、戻り値もありません。PHPのエラーレポートシステムにおいて、どのような種類のエラーを報告するかを設定する際に利用されます。

このサンプルコードは、システムエンジニアを目指す初心者向けに、PHPのエラーレポート設定と、各種エラーレベルの挙動をデモンストレーションしています。まず、error_reporting(E_ALL)で開発中に発生する可能性のあるすべてのエラー、警告、通知を報告するように設定し、ini_set('display_errors', '1')でこれらのエラーをブラウザ画面に表示するようにしています。E_ALLにはE_ERRORも含まれており、これによりPHPは可能な限り多くの問題を発見し報告します。

コード内では、未定義変数へのアクセスによるE_NOTICE（通知）や、存在しないファイルのインクルードによるE_WARNING（警告）の例が示されています。これらはスクリプトの実行を停止させない軽度な問題です。一方、E_ERRORは存在しない関数の呼び出しや致命的な構文エラーなどが発生した場合にスクリプトを強制的に停止させる、非常に深刻なエラーです。サンプルではスクリプト停止を防ぐためE_ERRORを意図的に発生させていませんが、その発生が後続のコード実行を妨げる重要な特性を説明しています。開発中はこれらのエラーを早期に発見し修正することが重要であり、本番環境ではユーザーへの表示を避けログに記録することが推奨されます。

Copy
1<?php
2
3/**
4 * カスタムエラーハンドラ関数
5 *
6 * この関数は、PHPで発生するエラー（特にtrigger_error()で発生させたユーザーエラー）を捕捉し、
7 * その内容を表示するために使用されます。
8 * システムエンジニアを目指す初心者の方のために、PHPのエラー処理の仕組みを理解する手助けとなるよう、
9 * 詳細な情報とコメントを提供します。
10 *
11 * @param int    $errno   エラーのレベル (例: E_USER_NOTICE, E_USER_WARNING, E_USER_ERROR など)。
12 *                        提供されたリファレンスにある E_ERROR はPHP内部の致命的なエラーを示しますが、
13 *                        ユーザーがtrigger_error()で発生させることができる致命的なエラーは E_USER_ERROR です。
14 * @param string $errstr  エラーメッセージ。
15 * @param string $errfile エラーが発生したファイル名。
16 * @param int    $errline エラーが発生した行番号。
17 * @return bool   true を返すと、PHPのデフォルトのエラーハンドラは呼び出されません。
18 *                false を返すと、カスタムハンドラで処理した後、デフォルトのエラーハンドラも呼び出されます。
19 *                E_USER_ERROR の場合、スクリプトの実行が停止するため、この戻り値はほとんどの場合関係ありません。
20 */
21function myErrorHandler(int $errno, string $errstr, string $errfile, int $errline): bool
22{
23    echo "--- カスタムエラーハンドラが捕捉しました ---\n";
24    echo "エラーレベル: " . $errno . " (";
25
26    switch ($errno) {
27        case E_USER_NOTICE:
28            echo "E_USER_NOTICE: ユーザー定義の通知";
29            break;
30        case E_USER_WARNING:
31            echo "E_USER_WARNING: ユーザー定義の警告";
32            break;
33        case E_USER_ERROR:
34            echo "E_USER_ERROR: ユーザー定義の致命的なエラー";
35            break;
36        default:
37            // E_ERRORのようなPHP内部の致命的なエラーは、通常このハンドラでは捕捉されません。
38            // 捕捉されるのはE_USER_*系のエラーや、parse error以外の通常の実行時エラーなどです。
39            echo "その他のエラーレベル";
40            break;
41    }
42    echo ")\n";
43    echo "メッセージ: {$errstr}\n";
44    echo "発生箇所: {$errfile} (行: {$errline})\n";
45
46    if ($errno === E_USER_ERROR) {
47        echo "致命的なユーザーエラー (E_USER_ERROR) が発生しました。\n";
48        echo "このエラーは、PHP内部で発生する E_ERROR と同様に、スクリプトの実行を停止させます。\n";
49        // E_USER_ERRORが発生した場合、PHPはスクリプトの実行を停止します。
50        // ここでの return true; は、スクリプトが停止する前にデフォルトハンドラへの制御を渡さないことを意味しますが、
51        // 実際にはスクリプトが即座に終了するため、この戻り値が影響することは稀です。
52    }
53
54    echo "------------------------------------------\n\n";
55
56    // true を返すことで、カスタムハンドラがエラーを完全に処理し、
57    // PHPのデフォルトのエラーハンドラが呼び出されるのを防ぎます。
58    return true;
59}
60
61// PHPのエラー処理をこのカスタム関数に委ねるように設定します。
62set_error_handler("myErrorHandler");
63
64echo "スクリプトを開始します。\n\n";
65
66// E_USER_NOTICE: 通知レベルのユーザーエラーを発生させます。
67// スクリプトの実行は継続します。
68trigger_error("これはユーザー定義の通知メッセージです。", E_USER_NOTICE);
69
70// E_USER_WARNING: 警告レベルのユーザーエラーを発生させます。
71// スクリプトの実行は継続します。
72trigger_error("これはユーザー定義の警告メッセージです。", E_USER_WARNING);
73
74echo "致命的なエラーを発生させる前に、ここまで実行されました。\n\n";
75
76// E_USER_ERROR: 致命的なユーザーエラーを発生させます。
77// このエラーが発生すると、提供されたリファレンスの E_ERROR と同様に、
78// PHPはスクリプトの実行を直ちに停止します。
79trigger_error("これはユーザー定義の致命的なエラーです！", E_USER_ERROR);
80
81// E_USER_ERROR が発生したため、この行以降のコードは実行されません。
82echo "このメッセージは表示されません。スクリプトは既に停止しています。\n";
83
84?>

このPHPコードは、システムエンジニアを目指す初心者の方がエラー処理の仕組みを理解するためのサンプルです。PHPの標準エラー処理ではなく、開発者が独自のエラー処理を行う「カスタムエラーハンドラ」を設定しています。

まず、set_error_handler関数を使って、myErrorHandlerというカスタム関数を登録します。これにより、PHP内でエラーが発生すると、このmyErrorHandler関数が自動的に呼び出されるようになります。

myErrorHandler関数は、発生したエラーのレベルを示す$errno、エラーメッセージの$errstr、エラーが発生したファイル名$errfile、行番号$errlineを引数として受け取ります。この関数がtrueを返すと、PHPのデフォルトのエラーハンドラは呼び出されず、カスタムハンドラでエラー処理が完結します。

コード内では、trigger_error関数を用いて、意図的にさまざまなレベルのユーザー定義エラーを発生させています。E_USER_NOTICEは通知、E_USER_WARNINGは警告を示し、スクリプトの実行は継続します。しかし、E_USER_ERRORが発生すると、リファレンスにあるPHP内部の致命的なエラー定数E_ERRORと同様に、スクリプトの実行は直ちに停止します。この挙動を通じて、エラーの種類によってシステムに与える影響が異なることを確認できます。