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

Copy
1<?php
2
3/**
4 * cURL操作とPHPのエラー情報を取得するサンプル関数。
5 *
6 * システムエンジニアを目指す初心者向けに、error_get_last関数と
7 * cURLのエラーハンドリングの違いを理解しやすく説明します。
8 */
9function handleCurlAndPhpErrors(): void
10{
11    // PHPのエラー報告レベルをE_ALLに設定し、エラー表示を有効にします。
12    // これにより、E_WARNINGなどのPHPレベルの警告も捕捉しやすくなります。
13    error_reporting(E_ALL);
14    ini_set('display_errors', '1');
15
16    echo "--- PHPのerror_get_last関数とcURLのエラーハンドリングの例 --- \n\n";
17
18    // 1. cURLリソースを初期化します。
19    $ch = curl_init();
20
21    if ($ch === false) {
22        echo "エラー: cURLの初期化に失敗しました。\n";
23        // curl_init()自体が失敗した場合にPHPエラーが発生することは稀ですが、
24        // 念のためerror_get_lastで確認できます。
25        $phpError = error_get_last();
26        if ($phpError !== null) {
27            echo "  PHPエラー (初期化時): " . $phpError['message'] . "\n";
28        }
29        return;
30    }
31
32    // 2. 意図的にPHPの警告(E_WARNING)が発生するようなcURLオプションを設定します。
33    //    CURLOPT_URLには文字列が必要ですが、ここでは誤って配列を渡してみます。
34    echo "不正なcURLオプションを設定し、PHP Warningを発生させます...\n";
35    // PHP 8では、この呼び出しで "curl_setopt(): Argument #3 ($value) must be of type string, array given"
36    // のような E_WARNING が発生します。
37    curl_setopt($ch, CURLOPT_URL, ['http://example.com']);
38
39    // 3. error_get_last() を呼び出して、直前に発生したPHPエラー情報を取得します。
40    //    この関数は、PHPスクリプトの実行中に発生した最後のPHPエラー（警告、通知、致命的なエラーなど）を返します。
41    //    cURL関数呼び出しによってPHPレベルの警告が発生した場合に役立ちます。
42    $lastPhpError = error_get_last();
43
44    if ($lastPhpError !== null) {
45        echo "\n--- error_get_last() で取得されたPHPエラー --- \n";
46        echo "  タイプ: " . $lastPhpError['type'] . " (E_WARNINGの定数値は2)\n";
47        echo "  メッセージ: " . $lastPhpError['message'] . "\n";
48        echo "  発生ファイル: " . $lastPhpError['file'] . "\n";
49        echo "  発生行: " . $lastPhpError['line'] . "\n";
50        echo "--------------------------------------------------\n";
51    } else {
52        echo "\n直前に発生したPHPエラーは見つかりませんでした。\n";
53    }
54
55    // 4. 正しいcURLオプションを設定し直し、実際に通信を行います。
56    //    ここでは存在しないURLを指定し、cURL通信エラーを発生させます。
57    echo "\n正しいcURLオプションを設定し、存在しないURLへアクセスします...\n";
58    curl_setopt($ch, CURLOPT_URL, 'http://this-domain-does-not-exist-12345.com');
59    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 結果を文字列で返す設定
60
61    $response = curl_exec($ch);
62
63    // 5. cURL通信自体のエラー情報を取得します。
64    //    cURLの通信エラーは、curl_errno() と curl_error() で取得するのが一般的です。
65    //    これらはPHPのエラーではなく、cURLライブラリが報告するエラーです。
66    if ($response === false) {
67        $curlErrorNo = curl_errno($ch);
68        $curlErrorMsg = curl_error($ch);
69        echo "\n--- cURL通信エラー --- \n";
70        echo "  cURLエラー番号: " . $curlErrorNo . "\n";
71        echo "  cURLエラーメッセージ: " . $curlErrorMsg . "\n";
72        echo "---------------------------\n";
73    } else {
74        echo "\ncURL通信は成功しました。レスポンスの長さ: " . strlen($response) . "バイト\n";
75    }
76
77    // cURLリソースを閉じます。
78    curl_close($ch);
79
80    echo "\nサンプル実行完了。\n";
81
82    // 補足: error_get_last() は、あくまでPHPスクリプト実行中に発生した最後のPHPエラーのみを報告します。
83    // cURL通信エラー（例: 存在しないドメインへのアクセス失敗）は、PHPエラーではなく、
84    // cURLライブラリが報告するエラーであるため、error_get_last() では捕捉されません。
85}
86
87// 関数を実行します。
88handleCurlAndPhpErrors();

error_get_last関数は、PHPスクリプトの実行中に直前に発生したPHPエラー（警告、通知、致命的なエラーなど）に関する情報を取得するために使用されます。この関数は引数を一切取りません。エラーが全く発生していなければnullを返し、エラーが発生している場合は、そのエラーのタイプ、メッセージ、発生ファイル、行番号を含む連想配列を戻り値として返します。

サンプルコードでは、まずcurl_setopt関数に本来文字列であるべきURLオプションとして誤って配列を渡すことで、PHPのE_WARNINGレベルの警告を意図的に発生させています。この直後にerror_get_last()を呼び出すと、発生したPHPの警告に関する詳細情報が取得でき、その内容を出力しています。これにより、PHPスクリプト内で発生したエラーを捕捉する仕組みを理解できます。

しかし、cURLが外部ネットワーク通信に失敗した場合（例えば、存在しないURLへのアクセス失敗など）は、それはPHPスクリプト自体のエラーではなく、cURLライブラリが報告する通信エラーです。このようなcURL通信エラーはerror_get_last()では捕捉されず、curl_errno()やcurl_error()といったcURL専用の関数で確認する必要があります。このサンプルコードは、PHPスクリプト内で発生するPHPレベルのエラーと、外部ライブラリ（ここではcURL）が報告するエラーの違いを明確に理解し、それぞれ適切な方法でエラーをハンドリングする方法を示すことを目的としています。

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 の値を確認することで、エラーの深刻度や種類をプログラムで判断し、適切な対応を行うことが可能です。この関数は、デバッグ作業や独自のエラーハンドリングシステムを構築する際に非常に役立ちます。

Copy
1<?php
2
3/**
4 * このサンプルコードは、PHPのerror_get_last()関数がどのように動作するかを、
5 * PDOのERRMODE_WARNING設定と組み合わせて示します。
6 *
7 * error_get_last() は、PHPスクリプトの実行中に最後に発生したPHPエラー（警告、通知、致命的なエラーなど）の情報を取得します。
8 * PDOにおける一般的なエラーハンドリングでは、通常 PDO::ERRMODE_EXCEPTION を使用して例外を捕捉しますが、
9 * この例では、PDOのSQLエラーがPHPの警告として発生した場合に error_get_last() でどのように捕捉できるかを示します。
10 *
11 * システムエンジニアを目指す初心者の方へ：
12 * error_get_last() はPHPの内部エラーに関するもので、PDOのSQLエラーを直接取得する主要な手段ではありません。
13 * PDOのエラーハンドリングは通常、PDOExceptionをtry-catchで捕捉するか、
14 * PDO::errorCode() や PDO::errorInfo() を使用します。
15 */
16function demonstratePdoErrorWithGetLast(): void
17{
18    // ダミーのデータベース接続情報です。
19    // 実際に動作させる場合は、お使いの環境に合わせて以下の値を変更してください。
20    // 例: host='localhost', dbname='your_database', user='your_user', password='your_password'
21    $dsn = 'mysql:host=localhost;dbname=test_db;charset=utf8mb4'; // 存在しないDB名を指定してエラーを発生させる可能性も
22    $user = 'root';
23    $password = 'password'; // セキュリティのため、本番環境では空のパスワードは避けてください
24
25    $pdo = null;
26
27    try {
28        // PDOオブジェクトを生成し、エラーモードを警告 (PDO::ERRMODE_WARNING) に設定します。
29        // この設定により、SQLエラーが発生した場合にPHPの警告 (E_WARNING) が生成され、
30        // error_get_last() でその警告情報を捕捉できるようになります。
31        $pdo = new PDO($dsn, $user, $password, [
32            PDO::ATTR_ERRMODE          => PDO::ERRMODE_WARNING,
33            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
34            PDO::ATTR_EMULATE_PREPARES => false, // プリペアドステートメントの有効活用を推奨
35        ]);
36        echo "データベースに接続しました。\n";
37
38        // 存在しないテーブル名を使った不正なSQLクエリを準備します。
39        // PDO::ERRMODE_WARNING の設定により、この操作はPHPの警告を引き起こします。
40        $stmt = $pdo->prepare("SELECT * FROM non_existent_table WHERE id = :id");
41
42        // クエリの実行を試みます。prepareでエラーが発生した場合は$stmtはfalseになる場合があります。
43        // この例では、executeで警告が発生することを目指します。
44        if ($stmt) {
45            $stmt->execute([':id' => 1]);
46            echo "不正なSQLクエリを実行しました。\n";
47        } else {
48            echo "プリペアドステートメントの準備に失敗しました。\n";
49        }
50
51    } catch (PDOException $e) {
52        // データベース接続自体が失敗した場合（例: ホストが見つからない、認証情報が不正）は、
53        // PDO::ERRMODE_WARNING の設定に関わらず PDOException がスローされます。
54        echo "PDO接続エラーが発生しました: " . $e->getMessage() . "\n";
55    }
56
57    // PDO操作後にPHPが最後に記録したエラー情報を取得します。
58    // PDO::ERRMODE_WARNING が有効な場合、不正なSQLクエリによる警告がここに捕捉される可能性があります。
59    $lastError = error_get_last();
60
61    if ($lastError !== null) {
62        echo "\n--- error_get_last() で取得されたPHPエラー情報 ---\n";
63        echo "タイプ: " . ($lastError['type'] ?? '不明') . " (E_WARNINGの値: " . E_WARNING . ")\n";
64        echo "メッセージ: " . ($lastError['message'] ?? 'なし') . "\n";
65        echo "ファイル: " . ($lastError['file'] ?? 'なし') . "\n";
66        echo "行: " . ($lastError['line'] ?? 'なし') . "\n";
67        echo "---------------------------------------------------\n";
68    } else {
69        echo "\nerror_get_last() はPHPエラーを検出しませんでした。\n";
70    }
71
72    // データベース接続を閉じる（PHPスクリプト終了時に自動的に閉じられますが、明示的にnullを代入することも可能です）
73    $pdo = null;
74}
75
76// 関数を実行します
77demonstratePdoErrorWithGetLast();

error_get_last関数は、PHPスクリプトの実行中に最後に発生したPHPエラー（警告、通知、致命的なエラーなど）の情報を取得する目的で使用されます。この関数は引数を取らず、最後に記録されたPHPエラーがない場合はnullを、エラーがある場合はそのエラータイプ、メッセージ、発生ファイル、行番号などを含む連想配列を戻り値として返します。

提示されたサンプルコードでは、PHP Data Objects (PDO) を使用してデータベース操作を行う際に、PDO::ATTR_ERRMODEをPDO::ERRMODE_WARNINGに設定した場合のerror_get_lastの挙動を示しています。この設定により、データベースで不正なSQLクエリが実行された際、そのSQLエラーがPHPの警告（E_WARNING）として扱われ、その警告情報をerror_get_last関数で捕捉できる様子が示されます。

システムエンジニアを目指す初心者の方へ。error_get_lastはPHPスクリプト全体の内部エラーを扱うものであり、PDOのSQLエラーを直接取得する主要な手段ではありません。PDOのエラーハンドリングでは通常、PDOExceptionをtry-catchで捕捉するか、PDO::errorCode()やPDO::errorInfo()メソッドを使用します。このサンプルは、あくまでerror_get_lastがどのような情報を取得し得るかを示す、特殊な設定と組み合わせたケースとして理解してください。