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

Copy
1<?php
2
3/**
4 * PDO操作後のエラー状態を確認する関数。
5 * PDO::ERR_NONE 定数を利用して、データベース操作でエラーが発生しなかったことを確認する方法を示します。
6 * システムエンジニアを目指す初心者向けに、エラーハンドリングの基本概念を簡潔に示します。
7 */
8function checkPdoOperationStatus(): void
9{
10    // SQLiteインメモリデータベースを使用し、外部ファイルやサーバーなしで動作可能にする
11    // DSN (Data Source Name) はデータベースの種類と接続情報を指定します
12    $dsn = 'sqlite::memory:';
13    // SQLiteインメモリデータベースではユーザー名とパスワードは不要です
14    $user = null;
15    $password = null;
16
17    try {
18        // PDO (PHP Data Objects) オブジェクトを作成し、データベースに接続を試みます
19        $pdo = new PDO($dsn, $user, $password);
20
21        // エラーモードをPDO::ERRMODE_SILENTに設定
22        // これにより、SQLエラーが発生してもPDOExceptionを投げず、
23        // errorCode() メソッドでエラーコード（SQLSTATE）を取得できるようになります。
24        // 初心者向けには、例外処理とエラーコード確認の両方があることを示す良い例です。
25        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
26
27        echo "PDOデータベースに接続しました。\n";
28
29        // 成功するSQLクエリを実行
30        // ここでは、エラーがない状況を作るためにシンプルなSELECT文を実行します。
31        $sql = 'SELECT "PHP Experts" AS message, "PDO::ERR_NONE Example" AS title';
32        $stmt = $pdo->query($sql);
33
34        // PDO::errorCode() は、直前のPDO操作で発生したエラーコード（SQLSTATE）を返します。
35        // エラーがない場合、このメソッドは PDO::ERR_NONE 定数と同じ値（"00000"）を返します。
36        // このエラーコードは、'php errorno' の概念に関連しています。
37        $errorCode = $pdo->errorCode();
38
39        // PDO::ERR_NONE と比較してエラーがないか確認します。
40        // '===' は型と値の両方を比較する厳密な比較演算子です。
41        if ($errorCode === PDO::ERR_NONE) {
42            echo "直前のSQL操作でエラーは発生しませんでした (エラーコード: {$errorCode})\n";
43            if ($stmt) {
44                $result = $stmt->fetch(PDO::FETCH_ASSOC);
45                echo "クエリ結果: " . var_export($result, true) . "\n";
46            }
47        } else {
48            // エラーが発生した場合の処理（このサンプルでは通常実行されません）
49            echo "直前のSQL操作でエラーが発生しました (エラーコード: {$errorCode})\n";
50            // 実際のエラーメッセージなどの詳細を取得するには、PDO::errorInfo() を使用します。
51            $errorInfo = $pdo->errorInfo();
52            echo "エラー情報: " . var_export($errorInfo, true) . "\n";
53        }
54
55    } catch (PDOException $e) {
56        // データベースへの接続自体に失敗した場合（例: DSNが不正など）の処理
57        // PDO::ERRMODE_EXCEPTION が設定されていなくても、PDOオブジェクトの構築自体はPDOExceptionを投げます。
58        echo "データベース接続エラー: " . $e->getMessage() . "\n";
59    }
60}
61
62// 定義した関数を実行し、PDOのエラー状態を確認します
63checkPdoOperationStatus();

このPHPサンプルコードは、データベースを操作する「PDO (PHP Data Objects)」において、処理が正常に完了し、エラーが発生しなかったことを確認する基本的な方法を、システムエンジニアを目指す初心者向けに示しています。特に「PDO::ERR_NONE」という定数を利用する点がポイントです。

PDO::ERR_NONE は、直前のPDO操作でエラーが発生していない状態を示す文字列型の特殊なコード（"00000"）を保持する定数です。引数はなく、常にこの「エラーなし」を示す値を返します。

コードではまず、PDOオブジェクトを生成してデータベースに接続を試みます。データベース接続自体に失敗した場合は、try-catchブロックでPDOExceptionを捕捉して対応します。次に、PDO::ERRMODE_SILENTを設定することで、SQL実行時のエラーを例外として投げずに、エラーコードとして取得できるようにしています。

SQLクエリの実行後、$pdo->errorCode()メソッドを使用して直前の操作で発生したエラーコードを取得します。この取得されたエラーコードがPDO::ERR_NONEと厳密に一致するかどうかをif文で確認することで、データベース操作が意図通りに成功したかを判断します。エラーがない場合、クエリ結果を表示し、エラーがある場合は詳細なエラー情報を取得するようになっています。このようなエラーコードの確認は、「php errorno」という概念と関連し、データベース操作におけるエラーハンドリングの基礎となります。

Copy
1<?php
2
3// データベース接続情報（環境に合わせて適宜変更してください）
4// このサンプルコードはMySQLデータベースへの接続を想定しています。
5// 実行前に、'testdb'というデータベースが存在し、'root'ユーザーが'password'でアクセスできることを確認してください。
6const DB_DSN = 'mysql:host=localhost;dbname=testdb;charset=utf8mb4';
7const DB_USER = 'root';
8const DB_PASS = 'password';
9
10/**
11 * PDO::ERR_NONE 定数を利用したエラーハンドリングのサンプル
12 *
13 * この関数は、PDOのサイレントモードでデータベース操作を行い、
14 * PDO::errorCode() および PDOStatement::errorCode() の戻り値を
15 * PDO::ERR_NONE と比較することで、エラーの有無を確認する方法を示します。
16 *
17 * システムエンジニアを目指す初心者が、データベース操作におけるエラー検出の基本を
18 * 理解するのに役立つよう、成功ケースと失敗ケースを両方含んでいます。
19 *
20 * 注意: PHPの推奨はPDO::ERRMODE_EXCEPTION（例外モード）です。
21 *      この例は、PDO::ERR_NONE定数の具体的な動作と利用方法を明確に示すために、
22 *      一時的にサイレントモードを使用しています。通常は例外モードを検討してください。
23 */
24function handlePdoErrorsWithErrNone(): void
25{
26    try {
27        // データベースに接続
28        // サイレントモードに設定し、errorCode() メソッドでエラーを明示的にチェックします。
29        $pdo = new PDO(DB_DSN, DB_USER, DB_PASS, [
30            PDO::ATTR_ERRMODE => PDO::ERRMODE_SILENT,          // エラーが発生しても例外を投げず、errorCode()で検出する
31            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,  // デフォルトのフェッチモードを連想配列に設定
32            PDO::ATTR_EMULATE_PREPARES => false,               // プリペアドステートメントのエミュレーションを無効化（より安全）
33        ]);
34
35        echo "データベース接続成功！\n";
36
37        // 接続直後のPDOオブジェクトのエラーコードを確認
38        // エラーがなければ PDO::ERR_NONE ('00000'という文字列) が返されます。
39        if ($pdo->errorCode() === PDO::ERR_NONE) {
40            echo "PDOオブジェクトにエラーなし (SQLSTATE: " . $pdo->errorCode() . ")\n";
41        } else {
42            // ここには通常到達しません（接続自体に失敗した場合はPDOExceptionがスローされるため）
43            $errorInfo = $pdo->errorInfo();
44            echo "PDOオブジェクトエラー: " . $errorInfo[2] . " (SQLSTATE: " . $pdo->errorCode() . ")\n";
45        }
46
47        // ----------------------------------------------------
48        // 成功するSQLクエリの実行 (プリペアドステートメントを使用)
49        // ----------------------------------------------------
50        echo "\n--- 成功するクエリの実行 ---\n";
51        $stmt = $pdo->prepare("SELECT 1 AS success_column");
52
53        // prepare() が失敗したかのエラーチェック
54        if ($stmt === false) {
55             $errorInfo = $pdo->errorInfo();
56             echo "プリペア失敗: " . $errorInfo[2] . " (SQLSTATE: " . $errorInfo[0] . ")\n";
57        } elseif ($stmt->execute()) { // execute() が成功した場合
58            // PDOStatementオブジェクトのエラーコードを確認
59            // ここでもエラーがなければ PDO::ERR_NONE が返されます。
60            if ($stmt->errorCode() === PDO::ERR_NONE) {
61                echo "クエリ成功！(SQLSTATE: " . $stmt->errorCode() . ")\n";
62                $result = $stmt->fetch();
63                print_r($result);
64            } else {
65                // execute() は成功したが、Statementオブジェクトにエラーがある場合（非常に稀なケース）
66                $errorInfo = $stmt->errorInfo();
67                echo "クエリ成功後、Statementエラー: " . $errorInfo[2] . " (SQLSTATE: " . $stmt->errorCode() . ")\n";
68            }
69        } else { // execute() が失敗した場合
70            $errorInfo = $stmt->errorInfo();
71            echo "クエリ実行失敗: " . $errorInfo[2] . " (SQLSTATE: " . $stmt->errorCode() . ")\n";
72        }
73
74        // ----------------------------------------------------
75        // 失敗するSQLクエリの実行 (存在しないテーブル名を指定)
76        // ----------------------------------------------------
77        echo "\n--- 失敗するクエリの実行 ---\n";
78        // 存在しないテーブル名を指定し、意図的にエラーを発生させます
79        $stmt = $pdo->prepare("SELECT * FROM non_existent_table");
80
81        // prepare() 自体が失敗したかのエラーチェック
82        if ($stmt === false) {
83            // prepare() が失敗すると $stmt は false を返します
84            $errorInfo = $pdo->errorInfo();
85            echo "プリペア失敗: (SQLSTATE: " . $errorInfo[0] . ", ドライバーエラーコード: " . $errorInfo[1] . ", エラーメッセージ: " . $errorInfo[2] . ")\n";
86        } elseif (!$stmt->execute()) { // execute() が失敗した場合
87            // PDOStatementオブジェクトのエラーコードを確認
88            // エラーが発生しているので、PDO::ERR_NONE ではないコードが返されます。
89            if ($stmt->errorCode() !== PDO::ERR_NONE) {
90                $errorInfo = $stmt->errorInfo();
91                echo "クエリ実行失敗！(SQLSTATE: " . $errorInfo[0] . ", ドライバーエラーコード: " . $errorInfo[1] . ", エラーメッセージ: " . $errorInfo[2] . ")\n";
92            } else {
93                // execute() が false を返したが errorCode() が ERR_NONE の場合（稀なケース）
94                echo "クエリ実行失敗 (詳細不明)！\n";
95            }
96        } else {
97            // ここには到達しません（クエリが失敗するため）
98            echo "クエリ成功(予期せず)！(SQLSTATE: " . $stmt->errorCode() . ")\n";
99        }
100
101    } catch (PDOException $e) {
102        // データベース接続に失敗した場合など、PDOExceptionをキャッチします。
103        // サイレントモードでも接続自体に失敗すると例外がスローされます。
104        echo "データベース接続エラー: " . $e->getMessage() . " (コード: " . $e->getCode() . ")\n";
105    } catch (Exception $e) {
106        // その他の予期せぬエラー
107        echo "予期せぬエラー: " . $e->getMessage() . "\n";
108    }
109}
110
111// 関数を実行します
112handlePdoErrorsWithErrNone();
113

PHP 8におけるPDO::ERR_NONEは、PDO（PHP Data Objects）を利用したデータベース操作において、エラーが発生していない状態を示す定数です。この定数は、SQLSTATEコードの国際標準に準拠しており、エラーがないことを意味する'00000'という文字列の値を持ちます。引数はなく、常にこの特定の文字列を返します。

この定数は、PDOオブジェクトやPDOStatementオブジェクトのerrorCode()メソッドの戻り値と比較することで、データベース操作が正常に完了したかどうかを判定する際に活用されます。サンプルコードでは、PDOの動作モードをPDO::ERRMODE_SILENT（サイレントモード）に設定しており、これによりエラーが発生してもPHPが自動的に例外をスローしないため、開発者が明示的にerrorCode()を呼び出してエラーの有無を確認する必要があります。

コード内の成功するクエリの例では、errorCode()がPDO::ERR_NONEと一致することで、処理が問題なく行われたことを示しています。一方で、意図的にエラーを発生させるために存在しないテーブルにアクセスするクエリの例では、errorCode()がPDO::ERR_NONEとは異なるエラーを示すSQLSTATEコードを返しているため、エラーが発生したと判断し、errorInfo()メソッドを通じて詳細なエラー情報を取得しています。

システムエンジニアを目指す初心者の方にとって、データベース操作におけるエラーハンドリングは重要な概念ですが、通常PHPではPDO::ERRMODE_EXCEPTION（例外モード）でのエラー処理が推奨されます。本サンプルは、PDO::ERR_NONE定数の具体的な役割と、サイレントモードでのエラー検出方法を理解するための一助となるでしょう。