【PHP8.x】Pdo\Sqlite::ERR_NONE定数の使い方

Copy
1<?php
2
3/**
4 * PDOを使ったデータベース操作で、エラーがない状態（PDO::ERR_NONE）を確認するサンプルコードです。
5 *
6 * システムエンジニアを目指す初心者向けに、
7 * - データベース接続
8 * - 正常な操作とエラーがないことの確認
9 * - 意図的にエラーを発生させ、エラーコードを確認する
10 * の流れを示します。
11 *
12 * PDO::ERR_NONE は、エラーがないことを示す定数（値は 0）ですが、
13 * PDO::errorCode() メソッドはSQLSTATEコード（文字列）を返すため、
14 * 通常は '00000' という文字列と比較してエラーがないことを判断します。
15 * このサンプルでは、PDO::ERR_NONE の存在と値を理解するために参照として表示します。
16 */
17function demonstratePdoErrorNone(): void
18{
19    // SQLiteデータベースをメモリ上で作成します。
20    // ファイルとして作成する場合は "sqlite:./test.db" のようにパスを指定します。
21    $dsn = 'sqlite::memory:';
22
23    try {
24        // PDO (PHP Data Objects) を使用してデータベースに接続します。
25        // PDO::ATTR_ERRMODE を PDO::ERRMODE_EXCEPTION に設定することで、
26        // データベースエラーが発生した場合に PDOException がスローされるようになります。
27        $pdo = new PDO($dsn);
28        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
29
30        echo "データベース接続に成功しました。\n\n";
31
32        // --- 正常な操作の例 ---
33        echo "--- 正常な操作: テーブル作成 ---\n";
34        // テーブルを作成します。
35        $pdo->exec('CREATE TABLE IF NOT EXISTS users (
36            id INTEGER PRIMARY KEY AUTOINCREMENT,
37            name TEXT NOT NULL UNIQUE
38        )');
39        echo "テーブル 'users' を作成しました。\n";
40
41        // 直前のPDO操作のエラーコードを取得します。
42        // エラーがない場合、PDO::errorCode() は文字列 '00000' を返します。
43        $pdoErrorCode = $pdo->errorCode();
44        echo "PDO::errorCode() (テーブル作成後): $pdoErrorCode\n";
45
46        // PDO::ERR_NONE はエラーがないことを示す定数で、値は 0 (int) です。
47        // PDO::errorCode() の戻り値（文字列）とは型が異なるため、直接比較はしませんが、
48        // エラーがない状態の数値的な表現として参照できます。
49        if ($pdoErrorCode === '00000') {
50            echo "  -> エラーは発生しませんでした (SQLSTATE '00000')\n";
51            echo "  -> PDO::ERR_NONE の値は " . PDO::ERR_NONE . " です。\n\n";
52        } else {
53            echo "  -> エラーが発生しました。\n\n";
54        }
55
56        echo "--- 正常な操作: データ挿入 ---\n";
57        // プリペアドステートメントを使ってデータを挿入します。
58        $stmt = $pdo->prepare('INSERT INTO users (name) VALUES (?)');
59        $stmt->execute(['Alice']);
60        echo "ユーザー 'Alice' を挿入しました。\n";
61
62        // 直前のPDOStatement操作のエラーコードを取得します。
63        $stmtErrorCode = $stmt->errorCode();
64        echo "PDOStatement::errorCode() (データ挿入後): $stmtErrorCode\n";
65        if ($stmtErrorCode === '00000') {
66            echo "  -> エラーは発生しませんでした (SQLSTATE '00000')\n";
67            echo "  -> PDO::ERR_NONE の値は " . PDO::ERR_NONE . " です。\n\n";
68        } else {
69            echo "  -> エラーが発生しました。\n\n";
70        }
71
72        // --- 異常な操作の例: UNIQUE 制約違反 ---
73        echo "--- 異常な操作: UNIQUE 制約違反 (意図的なエラー) ---\n";
74        try {
75            // 同じ名前 'Alice' を再度挿入し、UNIQUE 制約違反を発生させます。
76            $stmt->execute(['Alice']);
77            echo "このメッセージは表示されないはずです。\n";
78        } catch (PDOException $e) {
79            echo "エラーが発生しました: " . $e->getMessage() . "\n";
80
81            // 例外が捕捉された後でも、PDOStatementのエラーコードを取得できます。
82            $errorInfo = $stmt->errorInfo();
83            // $errorInfo[0] が SQLSTATE コードです。
84            $stmtErrorCodeAfterError = $errorInfo[0];
85            echo "PDOStatement::errorCode() (制約違反後): $stmtErrorCodeAfterError\n";
86
87            // エラーが発生したため、'00000' ではないエラーコードが返されます。
88            if ($stmtErrorCodeAfterError !== '00000') {
89                echo "  -> エラーコードは '00000' ではありませんでした。エラーが発生したことを示しています。\n";
90                echo "  -> PDO::ERR_NONE の値は " . PDO::ERR_NONE . " です。\n\n";
91            }
92        }
93
94    } catch (PDOException $e) {
95        // データベース接続自体が失敗した場合の例外を捕捉します。
96        echo "データベース接続エラーが発生しました: " . $e->getMessage() . "\n";
97        // 接続エラー時には PDO::ERR_NONE は直接関係ありません。
98    }
99}
100
101// サンプル関数を実行します。
102demonstratePdoErrorNone();

PHP 8のPDO拡張機能において、データベース操作でエラーがない状態を示す定数がPDO::ERR_NONEです。この定数は引数を取らず、整数型（int）の0という値を返します。システムエンジニアの学習においては、データベースとのやり取りで何らかの問題が発生しない「正常」な状態を理解するために役立ちます。

通常、PDO::errorCode()メソッドは、直前のデータベース操作のSQLSTATEコードという文字列を返します。エラーがない場合、このSQLSTATEコードは'00000'となりますが、PDO::ERR_NONEはその数値的な表現として0が存在します。サンプルコードでは、まずデータベースに正常に接続し、テーブル作成やデータ挿入といった操作がエラーなく完了した場合に、PDO::errorCode()が'00000'を返すことを確認します。次に、意図的にUNIQUE制約違反のようなエラーを発生させ、PDO::errorCode()が'00000'以外のエラーコードを返す様子も示します。PDO::ERR_NONEは、このようにPDO::errorCode()の戻り値とは型が異なるため直接比較には使いませんが、エラーのない状態を数値0で表すことで、PDOのエラーハンドリングの仕組みを理解する上で重要な定数です。この定数は、PDOの汎用的なエラー定数として利用されます。

Copy
1<?php
2
3/**
4 * PDO_SQLite を使用したデータベース操作におけるエラーハンドリングの基本を示します。
5 * Pdo\Sqlite::ERR_NONE (PDO::ERR_NONE と同等) 定数を使って、データベース操作が成功したかを確認します。
6 * システムエンジニアを目指す初心者向けに、エラーチェックの重要性を強調します。
7 *
8 * この関数は、SQLite データベースに接続し、テーブル作成、データ挿入、データ選択を行い、
9 * 各操作の後にエラーがないかを確認します。
10 */
11function demonstratePdoSqliteErrorHandling(): void
12{
13    // SQLite データベースファイルのパス
14    $dbFile = 'test_database.sqlite';
15
16    // 以前の実行で残ったデータベースファイルを削除し、クリーンな状態から開始
17    if (file_exists($dbFile)) {
18        unlink($dbFile);
19    }
20
21    $pdo = null; // PDO オブジェクトを初期化
22
23    try {
24        // SQLite データベースに接続
25        // PDO::ATTR_ERRMODE を PDO::ERRMODE_SILENT に設定することで、
26        // エラーが発生しても例外はスローされず、errorCode() メソッドでエラーコードをチェックできるようになります。
27        $pdo = new PDO('sqlite:' . $dbFile, null, null, [
28            PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT,         // エラーを errorCode() で手動確認するモード
29            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // 結果を連想配列で取得するよう設定
30        ]);
31
32        echo "SQLiteデータベースに接続しました。\n";
33
34        // 1. テーブル作成操作
35        $createTableSql = 'CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL)';
36        $pdo->exec($createTableSql);
37
38        // PDO::ERR_NONE は '00000' という文字列で、エラーがないことを示します。
39        // errorCode() メソッドは、SQLSTATE エラーコードを文字列として返します。
40        if ($pdo->errorCode() === PDO::ERR_NONE) {
41            echo "テーブル 'users' が正常に作成されました。\n";
42        } else {
43            // errorInfo() メソッドでエラーの詳細情報を取得できます。
44            $errorInfo = $pdo->errorInfo();
45            echo "エラー: テーブル作成に失敗しました: " . $errorInfo[2] . "\n";
46            return; // 致命的なエラーのため、以降の処理を中断
47        }
48
49        // 2. データ挿入操作 (成功例)
50        $insertSql = 'INSERT INTO users (name) VALUES (?)';
51        $stmt = $pdo->prepare($insertSql);
52        $stmt->execute(['Alice']);
53
54        // プリペアドステートメントのエラーコードは、そのステートメントオブジェクトから取得します。
55        if ($stmt->errorCode() === PDO::ERR_NONE) {
56            echo "データ 'Alice' を正常に挿入しました。\n";
57        } else {
58            $errorInfo = $stmt->errorInfo();
59            echo "エラー: データ 'Alice' の挿入に失敗しました: " . $errorInfo[2] . "\n";
60            return;
61        }
62
63        // 3. データ挿入操作 (別の成功例)
64        $stmt->execute(['Bob']);
65        if ($stmt->errorCode() === PDO::ERR_NONE) {
66            echo "データ 'Bob' を正常に挿入しました。\n";
67        } else {
68            $errorInfo = $stmt->errorInfo();
69            echo "エラー: データ 'Bob' の挿入に失敗しました: " . $errorInfo[2] . "\n";
70            return;
71        }
72
73        // 4. データ選択操作
74        $selectSql = 'SELECT id, name FROM users';
75        $stmt = $pdo->query($selectSql);
76
77        // query() メソッドが失敗した場合、false を返すことがあります。
78        // その場合、エラー情報は PDO オブジェクトから取得します。
79        if ($stmt !== false && $stmt->errorCode() === PDO::ERR_NONE) {
80            echo "データ選択を正常に実行しました。\n";
81            $users = $stmt->fetchAll();
82            echo "--- 取得したデータ ---\n";
83            foreach ($users as $user) {
84                echo "  ID: " . $user['id'] . ", Name: " . $user['name'] . "\n";
85            }
86            echo "--------------------\n";
87        } else {
88            $errorInfo = $pdo->errorInfo(); // query() メソッドのエラーは PDO オブジェクトに紐づく
89            if ($stmt === false) {
90                 echo "エラー: データ選択ステートメントの準備または実行に失敗しました。\n";
91            }
92            echo "エラー: データ選択に失敗しました: " . $errorInfo[2] . "\n";
93        }
94
95    } catch (PDOException $e) {
96        // データベース接続自体が失敗した場合の例外をキャッチ
97        echo "致命的なデータベース接続エラー: " . $e->getMessage() . "\n";
98    } finally {
99        // データベース接続を閉じる (PHPスクリプト終了時に自動的に閉じられるが、明示的にnullを設定することも可能)
100        $pdo = null;
101
102        // クリーンアップ: 作成したデータベースファイルを削除
103        if (file_exists($dbFile)) {
104            unlink($dbFile);
105            echo "データベースファイル '{$dbFile}' を削除しました。\n";
106        }
107    }
108}
109
110// サンプル関数の実行
111demonstratePdoSqliteErrorHandling();

Pdo\Sqlite::ERR_NONEは、PHPでSQLiteデータベースを操作した際に、その操作がエラーなく成功したことを示す定数です。この定数に引数はなく、リファレンス上は整数を返すとされていますが、実際にはSQLSTATEコード「00000」という文字列でエラーがない状態を表します。サンプルコードでは、PHPのPDO拡張機能を用いてSQLiteデータベースに接続し、テーブルの作成、データの挿入、データの選択といった一連の基本的な操作を実行しています。各データベース操作の直後には、PDOオブジェクトやプリペアドステートメントのerrorCode()メソッドを呼び出し、その結果がPdo\Sqlite::ERR_NONEと一致するかを確認することで、エラーが発生していないかを詳細にチェックしています。PDO::ATTR_ERRMODEをPDO::ERRMODE_SILENTに設定しているため、エラーが発生しても自動で例外はスローされず、開発者がerrorCode()を手動で確認して適切なエラー処理を実装することが可能です。システム開発において、データベース操作のエラーを確実に検出し、適切に対処するエラーハンドリングは非常に重要であり、このサンプルコードはその基本的な手法を学ぶ良い出発点となります。