【PHP8.x】PDO::ERRMODE_WARNING定数の使い方

Copy
1<?php
2
3/**
4 * PDO::ERRMODE_WARNING の使用例を示す関数。
5 * データベース接続エラーが発生した場合や、SQLクエリ実行エラーが発生した場合の
6 * PHPスクリプトの挙動をシステムエンジニア初心者が理解するのに役立ちます。
7 */
8function demonstratePdoErrModeWarning(): void
9{
10    // データベース接続設定
11    // 実際の環境に合わせてDSN、ユーザー名、パスワードを適宜変更してください。
12    // ここではMySQLを想定しています。
13    // 'testdb' は実際に存在するデータベース名に置き換える必要があります。
14    $dsn = 'mysql:host=localhost;dbname=testdb;charset=utf8mb4';
15    $user = 'root';
16    $password = ''; // データベースのパスワード (XAMPP/MAMPなどでは空の場合が多い)
17
18    try {
19        // 1. PDOオブジェクトを生成し、データベースに接続します。
20        //    接続に失敗した場合は、PDOExceptionがここでスローされます。
21        $pdo = new PDO($dsn, $user, $password);
22
23        // 2. PDOのエラーモードを PDO::ERRMODE_WARNING に設定します。
24        //    この設定により、SQLクエリの実行中にエラーが発生した場合、
25        //    PHPの警告 (E_WARNING) として報告されますが、スクリプトの実行は中断されず、続行されます。
26        //    例外はスローされません。
27        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);
28
29        echo "データベース接続に成功しました。エラーモードは 'WARNING' に設定されています。\n";
30
31        // 3. 意図的に存在しないテーブルへのクエリを実行し、SQLエラーを発生させます。
32        echo "不正なクエリ (存在しないテーブルへのアクセス) を実行します...\n";
33        $stmt = $pdo->query("SELECT id, name FROM non_existent_table");
34
35        // 4. ERRMODE_WARNING の場合、上記クエリで警告が発生してもスクリプトは続行されます。
36        //    $stmt 変数は、エラーが発生した場合は false になることがあります。
37        if ($stmt === false) {
38            echo "クエリの実行に失敗しましたが、スクリプトは続行されます。\n";
39            echo "PHPの警告メッセージが標準エラー出力に出力されているはずです。\n";
40        } else {
41            echo "クエリが正常に実行されました。\n"; // この行は不正なクエリの場合は通常実行されません
42            // ここで結果セットからデータを取得するなどの後続処理が可能ですが、
43            // エラー挙動のデモンストレーションのため省略します。
44        }
45
46        echo "スクリプトの残りの処理が実行されます。\n";
47
48    } catch (PDOException $e) {
49        // 5. データベース接続自体に失敗した場合（例: 間違ったDSN、ユーザー名、パスワード、DBサーバ停止など）に
50        //    PDOException がここでキャッチされます。
51        //    ERRMODE_WARNING の設定は、クエリ実行時のエラーハンドリングに影響するため、
52        //    接続自体が失敗した場合は、PDOExceptionとしてスローされます。
53        echo "データベース接続エラーが発生しました: " . $e->getMessage() . "\n";
54        // 接続エラーの場合はスクリプトを終了するのが一般的です。
55        exit(1);
56    }
57
58    // 6. スクリプトの実行が最後まで到達したことを示します。
59    echo "スクリプトの実行が終了しました。\n";
60}
61
62// 関数を実行します。
63demonstratePdoErrModeWarning();
64

PHPのPDO::ERRMODE_WARNINGは、PHPからデータベースを操作するPDO拡張機能において、SQLクエリの実行中に発生するエラーの挙動を制御するための定数です。この定数自体は引数を取らず、戻り値もありません。

PDO::ATTR_ERRMODE属性にPDO::ERRMODE_WARNINGを設定すると、SQLクエリの実行中にエラーが発生しても、PHPスクリプトの実行は中断されません。代わりに、PHPの警告（E_WARNING）としてエラーが報告され、スクリプトは次の処理に進みます。これにより、開発者はエラーの有無を検出して対応しながら、プログラムの流れを継続させることが可能です。

サンプルコードでは、まずデータベースに接続した後、エラーモードをPDO::ERRMODE_WARNINGに設定しています。意図的に存在しないテーブルに対するクエリを実行すると、SQLエラーが発生しますが、この設定によりPHPの警告が表示されるだけで、スクリプトは中断されずに残りの処理を続行します。クエリが失敗したかどうかは、queryメソッドの戻り値がfalseであるかで判断できます。ただし、データベースへの接続自体が失敗した場合には、PDOExceptionがスローされます。この定数は、エラーが発生しても即座にスクリプトを停止させず、警告として処理を継続したい場合に役立ちます。

Copy
1<?php
2
3function demonstratePdoErrorModeWarning(): void
4{
5    // データベース接続情報 (各自の環境に合わせて変更してください)
6    // 例: 'mysql:host=localhost;dbname=your_database_name;charset=utf8'
7    // ユーザー名とパスワードも適切に設定してください。
8    $dsn = 'mysql:host=localhost;dbname=test_db;charset=utf8';
9    $user = 'dbuser';
10    $password = 'dbpass';
11
12    try {
13        $pdo = new PDO($dsn, $user, $password);
14        echo "データベースに接続しました。\n";
15
16        // PDO::ERRMODE_WARNING を設定
17        // SQL実行時にエラーが発生した場合、PHPの警告(E_WARNING)として報告されます。
18        // スクリプトの実行は停止せず、警告が出力された後も処理が継続されます。
19        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);
20        echo "PDOエラーモードを 'WARNING' に設定しました。\n";
21
22        // --- 意図的にエラーを発生させる例1: 存在しないテーブルへのクエリ ---
23        echo "\n--- 意図的にエラーを発生させるSQL (存在しないテーブル) ---\n";
24        // SELECT文でエラーが発生した場合、query()メソッドはfalseを返します。
25        // PHPは警告を出力します。
26        $stmt_query_error = $pdo->query("SELECT * FROM non_existent_table");
27        if ($stmt_query_error === false) {
28            // エラー情報は $pdo->errorInfo() で取得できます。
29            $errorInfo = $pdo->errorInfo();
30            echo "query()メソッドの実行に失敗しました。\n";
31            echo "エラー情報: [SQLSTATE] " . $errorInfo[0] . ", [Driver code] " . $errorInfo[1] . ", [Message] " . $errorInfo[2] . "\n";
32        } else {
33            echo "query()メソッドが成功しましたが、これは通常発生しません。\n";
34        }
35
36        // --- 意図的にエラーを発生させる例2: 構文エラーを含むプリペアドステートメント ---
37        echo "\n--- 意図的にエラーを発生させるSQL (構文エラー) ---\n";
38        // 'INSERT' を 'INSRT' と誤植
39        $stmt_prepare_error = $pdo->prepare("INSRT INTO users (name) VALUES (?)");
40        if ($stmt_prepare_error === false) {
41            // prepare()でエラーが発生した場合、falseを返します。
42            // PHPは警告を出力します。
43            $errorInfo = $pdo->errorInfo();
44            echo "prepare()メソッドの実行に失敗しました。\n";
45            echo "エラー情報: [SQLSTATE] " . $errorInfo[0] . ", [Driver code] " . $errorInfo[1] . ", [Message] " . $errorInfo[2] . "\n";
46        } else {
47            // prepare()が成功しても、execute()で失敗する可能性もあります。
48            // (この例ではprepare()で失敗するため、ここに到達しません)
49            echo "prepare()メソッドは成功しました。\n";
50        }
51
52        // --- 成功するSQLの例 ---
53        echo "\n--- 成功するSQLの例 ---\n";
54        // サンプル用のテーブルを作成 (既存なら削除して再作成)
55        $pdo->exec("DROP TABLE IF EXISTS sample_users");
56        $pdo->exec("CREATE TABLE sample_users (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(255) NOT NULL)");
57        echo "テーブル 'sample_users' を作成しました。\n";
58
59        $stmt_success = $pdo->prepare("INSERT INTO sample_users (name) VALUES (?)");
60        if ($stmt_success->execute(['Alice'])) {
61            echo "データの挿入に成功しました。\n";
62            echo "挿入されたID: " . $pdo->lastInsertId() . "\n";
63        } else {
64            // 実行に失敗した場合も $stmt->errorInfo() で詳細が取れます。
65            $errorInfo = $stmt_success->errorInfo();
66            echo "データの挿入に失敗しました。\n";
67            echo "エラー情報: [SQLSTATE] " . $errorInfo[0] . ", [Driver code] " . $errorInfo[1] . ", [Message] " . $errorInfo[2] . "\n";
68        }
69
70        echo "\n--- スクリプトの実行継続 --- \n";
71        echo "PDO::ERRMODE_WARNING の設定により、上記のエラーが発生してもスクリプトの実行は停止せず、ここまで到達しました。\n";
72        echo "注意: 開発やデバッグ用途を除き、通常の本番環境ではエラーを例外として捕捉し、\n";
73        echo "プログラムの流れを制御できる " . "PDO::ERRMODE_EXCEPTION" . " の使用が強く推奨されます。\n";
74        echo "(キーワード: pdo errmode_exception)\n";
75
76    } catch (PDOException $e) {
77        // データベース接続自体が失敗した場合にこのブロックに到達します。
78        // SQL実行時のエラー（ERRMODE_WARNINGで処理されるもの）とは異なります。
79        echo "データベース接続エラー: " . $e->getMessage() . "\n";
80    } finally {
81        // 接続を閉じる (PHPスクリプト終了時に自動的に閉じられることが多いですが、明示的にnullを代入することも可能)
82        $pdo = null;
83        echo "\nデータベース接続を閉じました。\n";
84    }
85}
86
87// 関数を実行
88demonstratePdoErrorModeWarning();
89
90?>

PHPのPDO::ERRMODE_WARNINGは、PDO（PHP Data Objects）を使用してデータベースを操作する際のエラー処理モードを定義する定数です。この定数自体に引数や戻り値はありませんが、PDO::setAttribute()メソッドと組み合わせて利用することで、データベースエラー発生時のPHPの振る舞いを設定します。

サンプルコードでは、$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);と設定しています。この設定により、SQLの実行中にエラー（例えば存在しないテーブルへのアクセスやSQL構文エラー）が発生した場合、PHPはE_WARNINGレベルの警告を出力します。重要な点として、警告が出力されてもスクリプトの実行は中断されず、その後の処理は継続されます。

コード内の例のように、query()やprepare()メソッドがエラーによってfalseを返した場合、$pdo->errorInfo()メソッドを使って、より詳細なエラーコードやメッセージを取得できます。これにより、エラーの原因をプログラム的に確認し、対応することが可能です。成功するSQLの実行例も示されており、正常な動作とエラー時の動作の違いを理解できます。

このモードは、開発時のデバッグなどでエラーを可視化しつつ、スクリプト全体の実行を止めずに確認したい場合に有効です。しかし、本番環境ではエラーが発生した際に例外を発生させ、プログラムで確実に捕捉して対処できるPDO::ERRMODE_EXCEPTIONの使用が強く推奨されます。これは、予期せぬエラーがシステム全体に影響を及ぼすのを防ぐためです。