【PHP8.x】Pdo\Sqlite::errorCode()メソッドの使い方

Copy
1<?php
2
3/**
4 * Pdo\Sqlite::errorCode メソッドの利用例をデモンストレーションします。
5 *
6 * この関数は、PDOをSQLiteデータベースで使用し、意図的にエラーを発生させることで、
7 * errorCode メソッドがどのように機能するかをシステムエンジニアを目指す初心者にも分かるように示します。
8 */
9function demonstratePdoSqliteErrorCode(): void
10{
11    // メモリ上のSQLiteデータベースを使用します。ファイルは作成されません。
12    $dbPath = ':memory:';
13
14    try {
15        // PDOオブジェクトを作成し、SQLiteデータベースに接続します。
16        // PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT は、SQLエラーが発生しても
17        // 例外をスローせず、開発者が明示的にエラーをチェックできるようにします。
18        // これにより、Pdo\Sqlite::errorCode() の動作を直接確認できます。
19        $pdo = new PDO("sqlite:$dbPath", null, null, [
20            PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT,
21            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
22        ]);
23        echo "PDOオブジェクトが正常に作成され、SQLiteデータベースに接続しました。\n\n";
24
25        // --- 成功する操作の例 ---
26        // まず、テスト用のテーブルを作成します。
27        echo "テーブル 'users' を作成します...\n";
28        $createTableSql = "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL)";
29        $pdo->exec($createTableSql);
30        echo "テーブル 'users' が正常に作成されました。\n";
31
32        // 成功した操作の後のエラーコードを確認します。
33        // エラーが発生していない場合、errorCode() は '00000' を返します。
34        $errorCodeAfterSuccess = $pdo->errorCode();
35        echo "テーブル作成後のエラーコード: '" . $errorCodeAfterSuccess . "' ('00000' はエラーなしを意味します)\n\n";
36
37        // --- 意図的にエラーを発生させる操作の例 ---
38        // 存在しないテーブルにデータを挿入しようとすることでエラーを発生させます。
39        echo "存在しないテーブル 'non_existent_table' にデータを挿入しようとします...\n";
40        $insertErrorSql = "INSERT INTO non_existent_table (id, name) VALUES (1, 'Test User')";
41        $stmt = $pdo->prepare($insertErrorSql);
42        $result = $stmt->execute(); // この操作はデータベースエラーを引き起こします
43
44        if ($result === false) {
45            echo "挿入操作が失敗しました (期待される動作)。\n";
46            // Pdo\Sqlite::errorCode() は、直近の操作によって発生したSQLSTATEエラーコードを返します。
47            $errorCodeAfterError = $pdo->errorCode();
48            echo "エラー操作後のエラーコード: '" . $errorCodeAfterError . "'\n";
49
50            // より詳細なエラー情報を取得するには、errorInfo() を使用します。
51            // errorInfo() は、SQLSTATE、ドライバ固有のエラーコード、ドライバ固有のエラーメッセージを含む配列を返します。
52            $errorInfo = $pdo->errorInfo();
53            echo "エラー詳細情報:\n";
54            echo "  SQLSTATE (Generic Code): " . $errorInfo[0] . " (これは errorCode() と同じ値です)\n";
55            echo "  Driver Specific Code:    " . $errorInfo[1] . " (SQLite特有のエラーコード)\n";
56            echo "  Driver Specific Message: " . $errorInfo[2] . " (エラーメッセージ)\n\n";
57        } else {
58            echo "エラーが発生しませんでした (予期せぬ動作)。\n\n";
59        }
60
61        // --- 別の成功する操作の例 ---
62        // 存在するテーブルにデータを挿入します。
63        echo "テーブル 'users' に新しいユーザーを挿入します...\n";
64        $insertSuccessSql = "INSERT INTO users (name) VALUES ('Alice')";
65        $pdo->exec($insertSuccessSql);
66        echo "'Alice' が正常に挿入されました。\n";
67
68        // 成功した操作の後のエラーコードを再度確認します。
69        $errorCodeAfterAnotherSuccess = $pdo->errorCode();
70        echo "ユーザー挿入後のエラーコード: '" . $errorCodeAfterAnotherSuccess . "'\n\n";
71
72    } catch (PDOException $e) {
73        // 現在は PDO::ERRMODE_SILENT なので、このブロックは実行されません。
74        // もし PDO::ATTR_ERRMODE を PDO::ERRMODE_EXCEPTION に設定した場合、
75        // データベース操作のエラーはこのブロックで捕捉されます。
76        echo "データベース接続または操作エラー (PDOException): " . $e->getMessage() . "\n";
77    } catch (Exception $e) {
78        // その他の予期せぬエラーを捕捉します。
79        echo "予期せぬエラー: " . $e->getMessage() . "\n";
80    }
81}
82
83// 関数を実行してデモンストレーションを開始します。
84demonstratePdoSqliteErrorCode();

PHP 8のPdo\Sqlite::errorCodeメソッドは、直前のPDOデータベース操作によって発生したSQLSTATEエラーコードを取得するために使用されます。このメソッドは引数を取らず、操作が成功しエラーがない場合は '00000' という文字列を、何らかのエラーが発生した場合はそのエラーを示す固有のSQLSTATEコードを文字列として返します。

サンプルコードでは、まずテーブル作成という成功する操作を行った後にerrorCode()を呼び出し、「00000」が返されることを確認しています。次に、存在しないテーブルへデータを挿入しようとすることで意図的にエラーを発生させ、その後にerrorCode()を呼び出すことで、エラーを示すSQLSTATEコード（例えば 'HY000' など）が取得できることを示しています。

PDO::ATTR_ERRMODEをPDO::ERRMODE_SILENTに設定している場合、エラーが発生してもPHPが自動的に例外をスローしないため、このようにerrorCode()やerrorInfo()メソッドを使用して開発者が明示的にエラーをチェックすることが重要になります。errorCode()は一般的なエラー分類を返しますが、より詳細なドライバ固有のエラーコードやメッセージが必要な場合は、errorInfo()メソッドを利用することで追加情報を取得できます。このメソッドは、データベース操作のエラーハンドリングにおいて基本的なツールとなります。