【PHP8.x】error_get_last関数の使い方

Copy
1<?php
2
3/**
4 * error_get_last() の戻り値を確認する関数
5 *
6 * この関数は、エラーが発生していない場合と発生した場合とで、
7 * error_get_last() の戻り値がどのように変化するかを示します。
8 */
9function demonstrateGetLastError(): void
10{
11    // --- 1. エラーが発生していない状況 ---
12    // スクリプト実行後、まだエラーが発生していないため、error_get_last() は null を返します。
13    // キーワード「php error_get_last return null」はこの状態を指します。
14    echo "--- 実行開始直後 ---" . PHP_EOL;
15    $error = error_get_last();
16    echo '取得したエラー: ';
17    var_dump($error); // 出力: NULL
18    echo PHP_EOL;
19
20    // --- 2. 意図的にエラー（警告）を発生させる状況 ---
21    // 存在しないファイルを読み込もうとして、警告(E_WARNING)を発生させます。
22    // '@' 演算子を使うことで、PHPの標準エラー出力を抑制し、
23    // スクリプトの実行を継続した上で、エラー情報を後から取得できます。
24    echo "--- 存在しないファイルを開こうとした後 ---" . PHP_EOL;
25    @file_get_contents('non_existent_file.txt');
26
27    // 直前にエラーが発生したため、error_get_last() はエラー情報を含む配列を返します。
28    // 戻り値の型は `?array` であり、null または array を返します。
29    $error = error_get_last();
30    echo '取得したエラー: ' . PHP_EOL;
31    print_r($error);
32}
33
34// 関数を実行して動作を確認します。
35demonstrateGetLastError();
36
37?>

error_get_last関数は、PHPスクリプトの実行中に最後に発生したエラーに関する情報を取得するために利用されます。この関数は引数をとりません。戻り値は、最後に発生したエラーの詳細を格納した配列か、あるいはエラーがまだ一度も発生していない場合にnullとなります。この戻り値の型は?arrayと表記され、配列またはnullのどちらかであることを示しています。

サンプルコードでは、まずスクリプトの実行開始直後にerror_get_last()を呼び出しています。この時点ではエラーが発生していないため、戻り値はnullとなり、「php error_get_last return null」というキーワードの状況を確認できます。

次に、存在しないファイルを読み込もうとすることで、意図的に警告（E_WARNING）を発生させています。ここでファイル操作の前に記述されている@演算子は、PHPが通常出力するエラーメッセージを一時的に抑制し、スクリプトの実行を継続させる役割があります。

警告が発生した直後に再度error_get_last()を呼び出すと、今度は直前に発生した警告の詳細（エラーの種類、メッセージ、発生ファイル、行番号など）が格納された配列が戻り値として取得されます。このように、error_get_last()はエラー発生の有無に応じてnullまたはエラー情報配列を返すため、スクリプトのエラー状況をプログラムで確認する際に役立ちます。

Copy
1<?php
2
3// PHP 8 の推奨コーディングスタイルに従います。
4
5/**
6 * PHPのerror_get_last関数を使用して、直近のPHPエラー情報を取得し表示するサンプルコードです。
7 * システムエンジニアを目指す初心者の方にも、エラー情報に含まれる「タイプ」の意味がわかるように説明します。
8 */
9function demonstrateErrorGetLastUsage(): void
10{
11    // PHPのエラー報告レベルを設定します。
12    // E_ALL は全てのPHPエラー、警告、通知などを報告するようにします。
13    // ini_set('display_errors', '1') は、エラーメッセージをブラウザ（またはCLI）に出力する設定です。
14    // 開発時にはこれらの設定を有効にすることが推奨されます。
15    error_reporting(E_ALL);
16    ini_set('display_errors', '1');
17
18    echo "--- 1. エラーを発生させる前 (通常はnull) ---\n";
19    // error_get_last() は、スクリプト内でまだエラーが発生していない場合、nullを返します。
20    $noErrorBefore = error_get_last();
21    if ($noErrorBefore === null) {
22        echo "  現在、PHPスクリプト内で最後に発生したエラーはありません。\n";
23    } else {
24        echo "  予期せぬエラー情報が残っています:\n";
25        print_r($noErrorBefore);
26    }
27    echo "\n";
28
29    echo "--- 2. 意図的に E_WARNING を発生させる ---\n";
30    // 未定義の変数を参照することで、PHP 8 では E_WARNING (実行時警告) が発生します。
31    // この行の実行時に警告が直接出力されますが、スクリプトの実行は停止せず続行されます。
32    // この警告が、error_get_last() で取得できる「最後の」エラーとなります。
33    $undefinedVariable = $thisVariableDoesNotExist; // ここで E_WARNING が発生します
34
35    echo "\n--- 3. error_get_last() で最後のPHPエラー情報を取得 ---\n";
36    // error_get_last() を呼び出し、スクリプト内で最後に発生したPHPエラーの情報を取得します。
37    // エラーが発生していない場合は null を返しますが、今回は直前に E_WARNING を発生させました。
38    $lastError = error_get_last();
39
40    // 取得したエラー情報が存在するかどうかを確認します。
41    // error_get_last() の戻り値は ?array なので、null チェックが重要です。
42    if ($lastError !== null) {
43        echo "  最後のPHPエラー情報が取得されました:\n";
44        echo "    - 'type' (エラータイプ、数値): " . $lastError['type'] . "\n";
45        echo "    - 'message' (エラーメッセージ): " . $lastError['message'] . "\n";
46        echo "    - 'file' (エラー発生ファイル): " . $lastError['file'] . "\n";
47        echo "    - 'line' (エラー発生行番号): " . $lastError['line'] . "\n";
48
49        echo "\n  'type' の値とPHPのエラー定数の比較 (エラータイプの理解を深めるため):\n";
50        // 'type' の値は整数であり、PHPの定義済み定数（E_ERROR, E_WARNINGなど）に対応します。
51        // これらの定数と比較することで、エラーの具体的な種類をプログラムで判別できます。
52        switch ($lastError['type']) {
53            case E_ERROR:
54                echo "    エラータイプは E_ERROR です: 致命的な実行時エラー。通常、このエラーが発生するとスクリプトは停止します。\n";
55                break;
56            case E_WARNING:
57                echo "    エラータイプは E_WARNING です: 実行時警告。スクリプトの実行は続行されます。\n";
58                break;
59            case E_PARSE:
60                echo "    エラータイプは E_PARSE です: コンパイル時のパースエラー。構文間違いなど。\n";
61                break;
62            case E_NOTICE:
63                echo "    エラータイプは E_NOTICE です: 実行時通知。軽微な問題や推奨事項です。\n";
64                break;
65            case E_USER_ERROR:
66                echo "    エラータイプは E_USER_ERROR です: trigger_error() で発生させたユーザー定義の致命的エラー。\n";
67                break;
68            case E_USER_WARNING:
69                echo "    エラータイプは E_USER_WARNING です: trigger_error() で発生させたユーザー定義の警告。\n";
70                break;
71            case E_USER_NOTICE:
72                echo "    エラータイプは E_USER_NOTICE です: trigger_error() で発生させたユーザー定義の通知。\n";
73                break;
74            case E_DEPRECATED:
75                echo "    エラータイプは E_DEPRECATED です: 非推奨機能の使用。将来のバージョンで削除される可能性があります。\n";
76                break;
77            case E_USER_DEPRECATED:
78                echo "    エラータイプは E_USER_DEPRECATED です: trigger_error() で発生させたユーザー定義の非推奨警告。\n";
79                break;
80            default:
81                echo "    エラータイプは上記のいずれでもありません (数値: " . $lastError['type'] . ")。\n";
82                break;
83        }
84    } else {
85        echo "  エラー情報が見つかりませんでした。これは通常、エラーが発生しなかったことを意味します。\n";
86    }
87    echo "\n";
88}
89
90// 上記で定義した関数を実行します。
91demonstrateErrorGetLastUsage();
92
93?>

PHP 8 の error_get_last 関数は、スクリプト内で最後に発生したPHPエラーの情報を取得する際に使用します。この関数に引数は不要で、エラーが発生していればエラー情報を含む連想配列を、エラーがなければ null を戻り値として返します。

取得される配列には、エラーの種類を示す type、エラーメッセージの message、エラーが発生したファイル名の file、行番号の line といった重要な情報が含まれます。中でも type は、PHPが定義するエラー定数（例: E_WARNING、E_ERROR）に対応する数値であり、エラーの具体的な種類を示します。例えば、サンプルコードのように未定義の変数を参照すると E_WARNING（実行時警告）が発生しますが、これはスクリプトの実行を停止させません。一方、E_ERROR は致命的なエラーでスクリプトは停止します。type の値を確認することで、エラーの深刻度や種類をプログラムで判断し、適切な対応を行うことが可能です。この関数は、デバッグ作業や独自のエラーハンドリングシステムを構築する際に非常に役立ちます。