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

Copy
1<?php
2
3/**
4 * PHP の PDO (PHP Data Objects) を使用して、SQLite データベースの操作を行うサンプルコードです。
5 * PDO::PARAM_STR を用いたプリペアドステートメントによる文字列パラメータのバインディング方法を示します。
6 * システムエンジニアを目指す初心者の方にも、セキュリティを考慮したデータベース操作の基本を理解してもらうことを目的としています。
7 */
8function handleDatabaseOperationsWithParamStr(): void
9{
10    // SQLite データベースファイルのパスを定義
11    // このスクリプトと同じディレクトリに 'example.db' というファイルが作成されます。
12    $databasePath = __DIR__ . '/example.db';
13    $dsn = 'sqlite:' . $databasePath; // DSN (Data Source Name)
14
15    $pdo = null; // PDO オブジェクトを初期化
16
17    try {
18        // データベースに接続
19        // PDO::ATTR_ERRMODE を PDO::ERRMODE_EXCEPTION に設定することで、
20        // SQL エラーが発生した場合に PDOException がスローされるようになります。
21        $pdo = new PDO($dsn, null, null, [
22            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
23            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // 結果を連想配列で取得するよう設定
24        ]);
25
26        echo "SQLite データベースに接続しました。\n";
27
28        // テーブルが存在しない場合に作成
29        // AUTOINCREMENT により ID が自動的に割り当てられます。
30        // UNIQUE 制約により email の重複を防ぎます。
31        $pdo->exec("
32            CREATE TABLE IF NOT EXISTS users (
33                id INTEGER PRIMARY KEY AUTOINCREMENT,
34                name TEXT NOT NULL,
35                email TEXT NOT NULL UNIQUE
36            );
37        ");
38        echo "users テーブルが準備されました。\n";
39
40        // データの挿入
41        $userName = 'Alice Smith';
42        $userEmail = 'alice.smith@example.com';
43
44        // プリペアドステートメントの準備
45        // プレースホルダ (:name, :email) を使用することで、SQL インジェクション攻撃を防ぎます。
46        $insertStmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (:name, :email)");
47
48        // パラメータのバインド
49        // PDO::PARAM_STR を使用して、バインドする値が文字列型であることを明示的に指定します。
50        // これにより、データベースドライバーが適切な型変換を行い、セキュリティと堅牢性が向上します。
51        $insertStmt->bindParam(':name', $userName, PDO::PARAM_STR);
52        $insertStmt->bindParam(':email', $userEmail, PDO::PARAM_STR);
53
54        // ステートメントの実行
55        $insertStmt->execute();
56        echo "ユーザー '{$userName}' が正常に挿入されました。\n";
57
58        // 意図的に重複するメールアドレスを挿入してエラーを確認
59        $duplicateName = 'Bob Johnson';
60        $duplicateEmail = 'alice.smith@example.com'; // 既に存在するメールアドレス
61        try {
62            $duplicateStmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (:name, :email)");
63            $duplicateStmt->bindParam(':name', $duplicateName, PDO::PARAM_STR);
64            $duplicateStmt->bindParam(':email', $duplicateEmail, PDO::PARAM_STR);
65            $duplicateStmt->execute();
66            echo "ユーザー '{$duplicateName}' が正常に挿入されました。\n";
67        } catch (PDOException $e) {
68            echo "エラー: ユーザー '{$duplicateName}' の挿入に失敗しました。(" . $e->getMessage() . ")\n";
69        }
70
71
72        // データの取得
73        $searchEmail = 'alice.smith@example.com';
74        $selectStmt = $pdo->prepare("SELECT id, name, email FROM users WHERE email = :email");
75
76        // 検索条件のパラメータをバインド
77        $selectStmt->bindParam(':email', $searchEmail, PDO::PARAM_STR);
78
79        // ステートメントの実行
80        $selectStmt->execute();
81
82        // 結果のフェッチ (取得)
83        $user = $selectStmt->fetch();
84
85        if ($user) {
86            echo "\n取得したユーザー情報:\n";
87            echo "ID: " . $user['id'] . "\n";
88            echo "名前: " . $user['name'] . "\n";
89            echo "メール: " . $user['email'] . "\n";
90        } else {
91            echo "\n指定されたメールアドレス '{$searchEmail}' のユーザーは見つかりませんでした。\n";
92        }
93
94    } catch (PDOException $e) {
95        // データベース関連のエラーが発生した場合
96        echo "データベースエラー: " . $e->getMessage() . "\n";
97    } finally {
98        // データベース接続を閉じる
99        // PDO オブジェクトを null に設定することで、接続がクローズされます。
100        $pdo = null;
101        echo "\nデータベース接続を閉じました。\n";
102
103        // 例として、テスト用に作成したデータベースファイルを削除したい場合は、以下のコメントを外してください。
104        // if (file_exists($databasePath)) {
105        //     unlink($databasePath);
106        //     echo "テストデータベースファイルを削除しました。\n";
107        // }
108    }
109}
110
111// 関数を実行
112handleDatabaseOperationsWithParamStr();

このサンプルコードは、PHPのPDO (PHP Data Objects) を使用し、SQLiteデータベースを安全に操作する基本的な方法を、システムエンジニアを目指す初心者の方にも分かりやすく解説しています。特に、SQLインジェクション攻撃を防ぐための「プリペアドステートメント」と、文字列型のパラメータを正確にバインドするための「PDO::PARAM_STR」定数の使い方に焦点を当てています。

まず、SQLiteデータベースファイルに接続し、エラー処理を明確にするためにPDOの属性を設定してから、usersテーブルを作成します。データの挿入や検索では、SQLインジェクションを防ぐため、値を直接SQL文に埋め込むのではなく、prepareメソッドでSQL文の骨格（プリペアドステートメント）を準備し、プレースホルダ（例：:name）を使用します。

次に、bindParamメソッドを使って、準備したプレースホルダに実際の値を紐付けます。ここで「PDO::PARAM_STR」を引数として指定することで、バインドする値が「文字列型」であることを明示的にデータベースドライバーへ伝えます。これにより、データベース側で適切な型変換が行われ、データの整合性が保たれるだけでなく、意図しない型によるエラーやセキュリティ上の脆弱性を未然に防ぎ、アプリケーションの堅牢性を高めることができます。bindParamは引数としてプレースホルダ、バインドする値の変数、そして型定数を受け取り、成功すればtrueを返します。

コードは、ユーザー情報の挿入、意図的な重複データ挿入によるエラーハンドリングの確認、そして特定のメールアドレスでのユーザー情報取得といった一連の操作を通じて、安全で堅牢なデータベース操作の基本を示しています。最後に、try-catch-finallyブロックにより、エラー発生時にも適切に処理し、データベース接続を確実に閉じる方法も学べます。

Copy
1<?php
2
3/**
4 * PDO::PARAM_INT を使用して SQLite データベースにデータを挿入するサンプル関数
5 *
6 * この関数は、システムエンジニアを目指す初心者向けに、プリペアドステートメントと
7 * PDO::PARAM_INT を用いた安全なデータ挿入方法を示します。
8 * SQLite データベースを使用することで、Pdo\Sqlite のコンテキストに関連付けます。
9 */
10function insertDataWithParamInt(): void
11{
12    // SQLite データベースに接続
13    // ':memory:' はインメモリデータベースを使用することを意味します。
14    // 実際のアプリケーションでは、ファイルパスを指定して永続化します (例: 'sqlite:/path/to/database.db')。
15    try {
16        $pdo = new PDO('sqlite::memory:');
17        // エラーモードを例外をスローする設定にすることで、エラー発生時に捕捉しやすくなります。
18        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
19        echo "SQLite データベースに接続しました。\n";
20    } catch (PDOException $e) {
21        echo "データベース接続エラー: " . $e->getMessage() . "\n";
22        return; // エラーが発生した場合は処理を終了
23    }
24
25    // ユーザー情報を保存するテーブルを作成
26    // INTEGER PRIMARY KEY AUTOINCREMENT は、SQLiteで自動増分IDを生成します。
27    try {
28        $pdo->exec(
29            "CREATE TABLE IF NOT EXISTS users (
30                id INTEGER PRIMARY KEY AUTOINCREMENT,
31                name TEXT NOT NULL,
32                age INTEGER NOT NULL
33            );"
34        );
35        echo "テーブル 'users' を作成しました。\n";
36    } catch (PDOException $e) {
37        echo "テーブル作成エラー: " . $e->getMessage() . "\n";
38        return;
39    }
40
41    // データを挿入するためのプリペアドステートメントを作成
42    // プレースホルダ (:name, :age) を使用することで、SQLインジェクション攻撃を防ぎます。
43    $stmt = $pdo->prepare("INSERT INTO users (name, age) VALUES (:name, :age);");
44
45    // 挿入するデータ
46    $userName1 = 'Alice';
47    $userAge1 = 30; // 整数値
48
49    // パラメータをバインド
50    // bindParam() は変数を参照渡しでバインドします。
51    // :name には文字列型 (PDO::PARAM_STR) をバインドします。
52    $stmt->bindParam(':name', $userName1, PDO::PARAM_STR);
53    // :age には整数型 (PDO::PARAM_INT) をバインドします。
54    // これがキーワード 'php param_int' に関連する主な部分です。
55    $stmt->bindParam(':age', $userAge1, PDO::PARAM_INT);
56
57    // ステートメントを実行し、データをデータベースに挿入
58    try {
59        $stmt->execute();
60        echo "ユーザー '{$userName1}' (年齢: {$userAge1}) を挿入しました。\n";
61    } catch (PDOException $e) {
62        echo "データ挿入エラー (Alice): " . $e->getMessage() . "\n";
63    }
64
65    // 別のデータを挿入する例
66    $userName2 = 'Bob';
67    $userAge2 = 25; // 別の整数値
68
69    // bindParam() は変数を参照しているので、変数の値を更新して再度 execute() するだけで再利用できます。
70    $userName1 = $userName2; // $userName1 を Bob に変更
71    $userAge1 = $userAge2;   // $userAge1 を 25 に変更
72    
73    try {
74        $stmt->execute();
75        echo "ユーザー '{$userName2}' (年齢: {$userAge2}) を挿入しました。\n";
76    } catch (PDOException $e) {
77        echo "データ挿入エラー (Bob): " . $e->getMessage() . "\n";
78    }
79
80    // 挿入されたすべてのデータを取得して表示
81    try {
82        $stmt = $pdo->query("SELECT id, name, age FROM users;");
83        echo "\n--- 挿入されたデータ一覧 ---\n";
84        while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
85            echo "ID: " . $row['id'] . ", 名前: " . $row['name'] . ", 年齢: " . $row['age'] . "\n";
86        }
87    } catch (PDOException $e) {
88        echo "データ取得エラー: " . $e->getMessage() . "\n";
89    }
90}
91
92// サンプル関数を実行
93insertDataWithParamInt();

このPHPサンプルコードは、PDO（PHP Data Objects）という機能を使って、SQLiteデータベースにデータを安全に挿入する方法を示しています。まず、new PDO('sqlite::memory:') で一時的なインメモリデータベースに接続し、エラー発生時に例外をスローする設定を行います。その後、CREATE TABLE IF NOT EXISTS users 文を実行して、ユーザー情報を格納するテーブルを作成します。

データ挿入の核心は、SQLインジェクション攻撃を防ぐための「プリペアドステートメント」と「パラメータバインド」です。$pdo->prepare("INSERT INTO users (name, age) VALUES (:name, :age);") でSQL文のひな形を作成し、bindParam() メソッドでプレースホルダ（:name, :age）に変数を割り当てます。

特に重要なのが PDO::PARAM_INT の使用です。これは bindParam() の第三引数として指定され、:age にバインドする値が整数型であることを明示的にデータベースに伝えます。これにより、PHP側で変数が整数型であっても、データベースがその値を確実に整数として扱い、予期せぬデータ型の変換やエラーを防ぎ、より安全で堅牢なコードになります。同様に、PDO::PARAM_STR は文字列型であることを示します。

変数に値をセットし、$stmt->execute() を実行することでデータが挿入されます。一度プリペアドステートメントを作成すれば、変数の値を更新して何度も実行できるため効率的です。最後に、SELECT 文で挿入された全データを取得し、画面に表示して操作の成功を確認します。この insertDataWithParamInt 関数自体は引数を受け取らず、void で戻り値もありません。