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

Copy
1<?php
2
3/**
4 * PDO::ATTR_ERRMODE の動作例を示す関数
5 * データベース接続、エラーモードの設定、およびエラー発生時の挙動を確認します。
6 *
7 * システムエンジニアを目指す初心者向けに、データベース操作における
8 * エラーハンドリングの重要性を理解してもらうことを目的としています。
9 */
10function runPdoErrorModeExample(): void
11{
12    // データベース接続情報の設定
13    // 実際の環境に合わせて適宜変更してください。
14    // この例ではMySQLを使用していますが、他のDBでも同様に動作します。
15    // 'testdb' は存在しない、または空のデータベースでも動作します。
16    $dsn = 'mysql:host=localhost;dbname=testdb;charset=utf8mb4';
17    $user = 'root';
18    $password = ''; // 適切なパスワードを設定してください。
19
20    try {
21        // PDOインスタンスを作成し、データベースに接続します。
22        $pdo = new PDO($dsn, $user, $password);
23
24        echo "<h2>PDO::ATTR_ERRMODE の使用例</h2>\n";
25
26        // ============== PDO::ERRMODE_EXCEPTION の設定と動作例 ==============
27        echo "<h3>1. エラーモードを PDO::ERRMODE_EXCEPTION に設定</h3>\n";
28        echo "<p>これは推奨されるエラーハンドリングモードです。<br>\n";
29        echo "データベースエラーが発生すると、PDOExceptionがスローされ、try-catchブロックで捕捉できます。</p>\n";
30
31        // PDOのエラーモードを例外モードに設定します。
32        // これにより、SQLエラーが発生した場合にPDOExceptionがスローされます。
33        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
34        echo "<p>PDO::ATTR_ERRMODE を PDO::ERRMODE_EXCEPTION に設定しました。</p>\n";
35
36        try {
37            // 存在しないテーブルに対するクエリを実行し、意図的にエラーを発生させます。
38            echo "<p>存在しないテーブル 'non_existent_table' へのクエリを試行します...</p>\n";
39            $stmt = $pdo->query("SELECT * FROM non_existent_table");
40            echo "<p>クエリ成功 (このメッセージは通常表示されません)</p>\n"; // この行は実行されない
41        } catch (PDOException $e) {
42            // PDOException を捕捉し、エラーメッセージを表示します。
43            echo "<p style='color: red;'><strong>エラー捕捉 (PDO::ERRMODE_EXCEPTION):</strong> " . htmlspecialchars($e->getMessage()) . "</p>\n";
44            echo "<p>エラーコード: " . htmlspecialchars($e->getCode()) . " / SQLSTATE: " . htmlspecialchars($e->getSQLState()) . "</p>\n";
45        }
46
47        echo "<hr>\n";
48
49        // ============== PDO::ERRMODE_WARNING の設定と動作例 ==============
50        echo "<h3>2. エラーモードを PDO::ERRMODE_WARNING に設定</h3>\n";
51        echo "<p>データベースエラーが発生すると、PHPの警告 (E_WARNING) が発行されます。<br>\n";
52        echo "スクリプトの実行は継続されますが、エラーを見落としやすい可能性があります。</p>\n";
53
54        // PDOのエラーモードを警告モードに設定します。
55        // これにより、SQLエラーが発生した場合にPHPの警告が発行されます。
56        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);
57        echo "<p>PDO::ATTR_ERRMODE を PDO::ERRMODE_WARNING に設定しました。</p>\n";
58
59        // 存在しないテーブルに対するクエリを実行し、意図的にエラーを発生させます。
60        echo "<p>存在しないテーブル 'non_existent_table_2' へのクエリを試行します...</p>\n";
61        // 警告モードでは例外はスローされないため、try-catchは不要です。
62        // ただし、返り値はfalseとなり、エラー情報を手動で確認する必要があります。
63        $stmt = $pdo->query("SELECT * FROM non_existent_table_2");
64
65        if ($stmt === false) {
66            $errorInfo = $pdo->errorInfo();
67            echo "<p style='color: orange;'><strong>クエリ失敗 (PDO::ERRMODE_WARNING):</strong> </p>\n";
68            echo "<p>SQLSTATE: " . htmlspecialchars($errorInfo[0]) . "</p>\n";
69            echo "<p>エラーコード: " . htmlspecialchars($errorInfo[1]) . "</p>\n";
70            echo "<p>エラーメッセージ: " . htmlspecialchars($errorInfo[2]) . "</p>\n";
71        } else {
72            echo "<p>クエリ成功 (このメッセージは通常表示されません)</p>\n";
73        }
74
75        echo "<hr>\n";
76
77        // ============== PDO::ERRMODE_SILENT の設定と動作例 (デフォルト) ==============
78        echo "<h3>3. エラーモードを PDO::ERRMODE_SILENT に設定</h3>\n";
79        echo "<p>これはデフォルトのエラーハンドリングモードです。<br>\n";
80        echo "データベースエラーが発生しても、何も表示されず、警告も例外も発生しません。<br>\n";
81        echo "エラーを手動でチェックする必要があり、最もエラーを見落としやすいモードです。</p>\n";
82
83        // PDOのエラーモードをサイレントモードに設定します。
84        // これがデフォルトの挙動であり、エラーが発生しても何も表示されません。
85        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);
86        echo "<p>PDO::ATTR_ERRMODE を PDO::ERRMODE_SILENT に設定しました。</p>\n";
87
88        // 存在しないテーブルに対するクエリを実行し、意図的にエラーを発生させます。
89        echo "<p>存在しないテーブル 'non_existent_table_3' へのクエリを試行します...</p>\n";
90        $stmt = $pdo->query("SELECT * FROM non_existent_table_3");
91
92        if ($stmt === false) {
93            $errorInfo = $pdo->errorInfo();
94            echo "<p style='color: grey;'><strong>クエリ失敗 (PDO::ERRMODE_SILENT):</strong> </p>\n";
95            echo "<p>SQLSTATE: " . htmlspecialchars($errorInfo[0]) . "</p>\n";
96            echo "<p>エラーコード: " . htmlspecialchars($errorInfo[1]) . "</p>\n";
97            echo "<p>エラーメッセージ: " . htmlspecialchars($errorInfo[2]) . "</p>\n";
98        } else {
99            echo "<p>クエリ成功 (このメッセージは通常表示されません)</p>\n";
100        }
101
102    } catch (PDOException $e) {
103        // データベース接続自体に失敗した場合の処理
104        echo "<p style='color: red;'><strong>データベース接続エラー:</strong> " . htmlspecialchars($e->getMessage()) . "</p>\n";
105        exit(); // 接続エラーは致命的なのでスクリプトを終了
106    }
107
108    echo "<p>サンプルコードの実行が終了しました。</p>\n";
109}
110
111// 関数を実行
112runPdoErrorModeExample();

PDO::ATTR_ERRMODEは、PHPのデータベース接続抽象化レイヤーであるPDOにおいて、データベース操作中にエラーが発生した際の挙動を設定するための定数です。この定数自体に引数や戻り値はありませんが、PDOインスタンスのsetAttribute()メソッドの第一引数に指定することで、PDOオブジェクトのエラーハンドリングポリシーを制御します。

サンプルコードでは、主に以下の3つのエラーモードが示されています。

1. PDO::ERRMODE_EXCEPTION: このモードを設定すると、データベースエラーが発生した際にPDOExceptionがスローされます。これにより、try-catchブロックを用いてエラーを確実に捕捉し、適切なエラー処理を実装できるため、最も推奨されるエラーハンドリング方法です。

2. PDO::ERRMODE_WARNING: このモードでは、データベースエラーが発生するとPHPの警告（E_WARNING）が発行されます。スクリプトの実行は継続されますが、警告を見落とす可能性があり、エラーの詳細を手動でPDO::errorInfo()メソッドで確認する必要があります。

3. PDO::ERRMODE_SILENT: これはPDOのデフォルトのエラーモードです。エラーが発生しても警告や例外は一切発生しません。エラーの有無や詳細を知るためには、常にPDO::errorInfo()メソッドを呼び出して手動でチェックする必要があり、エラーを見落としやすいため注意が必要です。

システムエンジニアを目指す上で、データベース操作におけるエラーハンドリングは非常に重要であり、PDO::ERRMODE_EXCEPTIONの活用は堅牢なアプリケーション開発に不可欠です。

Copy
1<?php
2
3/**
4 * PDO::ATTR_EMULATE_PREPARES の使用例を示す関数。
5 *
6 * この属性は、PDO がプリペアドステートメントをエミュレートするかどうかを決定します。
7 * エミュレーションが有効な場合 (true)、PDO はプレースホルダをSQLクエリ内で直接置換し、
8 * その後クエリをデータベースに送信します。これにより、すべてのデータベースドライバで
9 * プリペアドステートメントの機能が利用できるようになりますが、ネイティブなプリペアに
10 * 比べて潜在的なセキュリティリスクやパフォーマンスの問題が発生する可能性があります。
11 *
12 * ネイティブなプリペアが利用できる場合 (false)、PDO はデータベースのネイティブな
13 * プリペアドステートメント機能を使用します。これにより、通常はセキュリティが向上し、
14 * パフォーマンスが最適化されます。多くの現代のデータベースドライバではネイティブな
15 * プリペアドステートメントをサポートしているため、通常は false に設定することが推奨されます。
16 */
17function demonstratePdoEmulatePrepares(): void
18{
19    // SQLiteデータベースをメモリ上で使用するDSN (Data Source Name)
20    // 実際のアプリケーションでは、ファイルパスやホスト名などを指定します。
21    $dsn = 'sqlite::memory:';
22
23    // ユーザーからの入力値の例（通常はフォーム入力などから取得）
24    $userIdToFind = 1;
25
26    try {
27        // PDO接続オプションを設定
28        $options = [
29            // エラーモードを例外に設定し、エラー発生時にPDOExceptionをスローする
30            PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
31
32            // ATTR_EMULATE_PREPARES を設定
33            // ネイティブプリペアドステートメントを使用 (推奨)
34            PDO::ATTR_EMULATE_PREPARES   => false,
35            // エミュレートされたプリペアドステートメントを使用したい場合は以下を使用:
36            // PDO::ATTR_EMULATE_PREPARES   => true,
37        ];
38
39        // データベースに接続
40        $pdo = new PDO($dsn, null, null, $options);
41        echo "データベースに接続しました。\n";
42
43        // テーブルを作成（例としてUsersテーブル）
44        $pdo->exec("
45            CREATE TABLE IF NOT EXISTS Users (
46                id INTEGER PRIMARY KEY AUTOINCREMENT,
47                name TEXT NOT NULL
48            );
49        ");
50        echo "Usersテーブルが作成されました。\n";
51
52        // データを挿入（プリペアドステートメントを使用）
53        $insertStmt = $pdo->prepare("INSERT INTO Users (name) VALUES (:name)");
54        $insertStmt->execute([':name' => 'Alice']);
55        $insertStmt->execute([':name' => 'Bob']);
56        $insertStmt->execute([':name' => 'Charlie']);
57        echo "サンプルデータを挿入しました。\n";
58
59        // プリペアドステートメントを使用してデータを取得
60        // プレースホルダに値をバインドすることで、SQLインジェクションを防ぎます。
61        $selectStmt = $pdo->prepare("SELECT id, name FROM Users WHERE id = :id");
62        $selectStmt->bindParam(':id', $userIdToFind, PDO::PARAM_INT); // 整数としてバインド
63        $selectStmt->execute();
64
65        $user = $selectStmt->fetch(PDO::FETCH_ASSOC);
66
67        if ($user) {
68            echo "ユーザー情報:\n";
69            echo "ID: " . $user['id'] . "\n";
70            echo "名前: " . $user['name'] . "\n";
71        } else {
72            echo "ID " . $userIdToFind . " のユーザーは見つかりませんでした。\n";
73        }
74
75        // PDO::ATTR_EMULATE_PREPARES の現在の設定値を確認
76        $emulatePreparesStatus = $pdo->getAttribute(PDO::ATTR_EMULATE_PREPARES);
77        echo "PDO::ATTR_EMULATE_PREPARES の現在の設定: " . ($emulatePreparesStatus ? 'true' : 'false') . "\n";
78
79    } catch (PDOException $e) {
80        // データベース接続またはクエリ実行エラーが発生した場合
81        echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
82        // 実際のアプリケーションでは、エラーの詳細をログに記録するなど、より詳細な処理を行います。
83    } finally {
84        // PDOオブジェクトがスコープ外に出ると接続は自動的に閉じられますが、
85        // 明示的にnullを代入して接続を閉じることも可能です。
86        $pdo = null;
87        echo "データベース接続を閉じました。\n";
88    }
89}
90
91// 関数を実行して、上記の使用例を表示
92demonstratePdoEmulatePrepares();

このPHPサンプルコードは、PDO拡張機能の定数PDO::ATTR_EMULATE_PREPARESの利用を示します。この定数は、SQLインジェクションを防ぐプリペアドステートメントの処理方法をPDOに設定するものです。

falseを設定すると、PDOはデータベース本来のプリペアドステートメント機能（ネイティブプリペア）を使用します。これはセキュリティとパフォーマンスに優れるため、多くの環境で推奨される設定です。サンプルコードでもこのfalse設定が使われています。

一方、true設定では、データベースがネイティブ機能を持たなくてもPDOがプリペアドステートメントをエミュレートします。これにより互換性は増しますが、ネイティブ利用に比べセキュリティリスクやパフォーマンス低下の可能性があります。

コードはPDO接続時にこの設定を適用し、ユーザー入力を含むデータ操作をプリペアドステートメントで安全に実行する例を示しています。