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

Copy
1<?php
2
3/**
4 * Pdo\Sqlite::PARAM_INT 定数の使用例を示す関数です。
5 *
6 * この定数は、PDOのプリペアドステートメントでSQLのプレースホルダに
7 * 整数値をバインドする際に、そのデータ型を明示的に指定するために使用されます。
8 * リファレンス情報にある Pdo\Sqlite::PARAM_INT は、
9 * 実際には PDO::PARAM_INT と同じ意味を持つ定数です。
10 * これにより、データベースに値が正確な型で渡されることが保証されます。
11 */
12function demonstratePdoParamIntUsage(): void
13{
14    try {
15        // 1. SQLiteのインメモリデータベースに接続します。
16        // ':memory:' を指定することで、プログラム実行中のみ存在する一時的なデータベースを作成します。
17        $pdo = new PDO('sqlite::memory:');
18        // エラーモードを例外に設定し、データベース操作でエラーが発生した場合に
19        // PDOException をスローするようにします。これによりエラー処理が容易になります。
20        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
21
22        echo "SQLiteデータベースに接続しました。\n\n";
23
24        // 2. 'users' テーブルを作成します。
25        // id は主キーであり自動的に増加する整数、age は整数型として定義します。
26        $pdo->exec("CREATE TABLE users (
27            id INTEGER PRIMARY KEY AUTOINCREMENT,
28            name TEXT NOT NULL,
29            age INTEGER NOT NULL
30        )");
31        echo "usersテーブルを作成しました。\n\n";
32
33        // 3. プリペアドステートメントを使用してINSERT文を実行し、整数値をバインドします。
34        // プリペアドステートメントは、SQLインジェクション攻撃を防ぐための重要なセキュリティ機能です。
35        // ':name' と ':age' はプレースホルダです。
36        $stmt = $pdo->prepare("INSERT INTO users (name, age) VALUES (:name, :age)");
37
38        // 最初のユーザーデータを準備
39        $userName1 = 'Alice';
40        $userAge1 = 30; // この値が整数型としてデータベースに渡されます
41
42        // :name プレースホルダに文字列をバインドします。PDO::PARAM_STR は文字列型を意味します。
43        $stmt->bindValue(':name', $userName1, PDO::PARAM_STR);
44        // :age プレースホルダに整数をバインドします。
45        // ここで PDO::PARAM_INT (Pdo\Sqlite::PARAM_INT と同義) を使用して、
46        // age が整数であることを明示的に指定します。
47        $stmt->bindValue(':age', $userAge1, PDO::PARAM_INT);
48
49        $stmt->execute(); // ステートメントを実行
50        echo "ユーザー '" . $userName1 . "' (年齢: " . $userAge1 . ") を挿入しました。\n";
51
52        // 2番目のユーザーデータを準備
53        $userName2 = 'Bob';
54        $userAge2 = 25;
55
56        // プレースホルダに新しい値をバインドし直して、再びステートメントを実行します。
57        $stmt->bindValue(':name', $userName2, PDO::PARAM_STR);
58        $stmt->bindValue(':age', $userAge2, PDO::PARAM_INT); // ここでも整数型を指定
59        $stmt->execute();
60        echo "ユーザー '" . $userName2 . "' (年齢: " . $userAge2 . ") を挿入しました。\n\n";
61
62        // 4. 登録されたデータを取得して表示します。
63        echo "--- 登録されたユーザー一覧 ---\n";
64        $selectStmt = $pdo->query("SELECT id, name, age FROM users");
65        // fetch(PDO::FETCH_ASSOC) は、結果セットをカラム名をキーとする連想配列として取得します。
66        while ($row = $selectStmt->fetch(PDO::FETCH_ASSOC)) {
67            echo "ID: " . $row['id'] . ", 名前: " . $row['name'] . ", 年齢: " . $row['age'] . "\n";
68        }
69        echo "---------------------------\n";
70
71    } catch (PDOException $e) {
72        // データベース関連のエラーが発生した場合に、そのメッセージを表示します。
73        echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
74    } catch (Exception $e) {
75        // PDOException 以外の予期せぬエラーが発生した場合に、そのメッセージを表示します。
76        echo "予期せぬエラーが発生しました: " . $e->getMessage() . "\n";
77    } finally {
78        // データベース接続を閉じる（PHPではスクリプト終了時に自動的に閉じられますが、明示的にnullを代入することもできます）
79        $pdo = null;
80    }
81}
82
83// 上記の関数を実行して、Pdo\Sqlite::PARAM_INT (PDO::PARAM_INT) の使用例を確認します。
84demonstratePdoParamIntUsage();
85
86?>

このサンプルコードは、PHPのPDO（PHP Data Objects）拡張機能において、データベースのプリペアドステートメントに整数値を安全にバインドする方法を示しています。具体的には、Pdo\Sqlite::PARAM_INT（実際にはPDO::PARAM_INTとして一般的に使用されます）定数の利用例です。この定数は、SQLのプレースホルダに値をバインドする際、その値が整数型であることを明示的にデータベースへ伝えるために使用されます。これにより、SQLインジェクションのリスクを軽減し、データの整合性を保つことができます。

コードではまず、SQLiteのインメモリデータベースに接続し、usersテーブルを作成します。次に、INSERT文のプリペアドステートメントを準備し、bindValueメソッドを使ってユーザーの名前（文字列）と年齢（整数）をプレースホルダにバインドしています。特に年齢をバインドする際にPDO::PARAM_INTを指定することで、PHPの数値がデータベースの整数型として正確に扱われます。この定数自体は、内部的に整数値を表しており、型指定の識別子として機能します。最後に、挿入されたデータが正しく取得・表示されることを確認し、エラーが発生した場合は例外処理を行います。この一連の処理を通じて、安全かつ正確なデータ操作におけるPDO::PARAM_INTの重要性を理解することができます。