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

Copy
1<?php
2
3/**
4 * PDO::PARAM_INT を使用したプリペアドステートメントのサンプルコード。
5 *
6 * この関数は、SQLite データベースに接続し、テーブルを作成（存在しない場合）、
7 * プリペアドステートメントと PDO::PARAM_INT を用いてデータを安全に挿入し、
8 * その後、挿入したデータを取得して表示します。
9 * システムエンジニアを目指す初心者向けに、PDOを使ったデータベース操作の基本と、
10 * パラメータの型を明示的に指定する重要性を示します。
11 */
12function demonstratePdoParamInt(): void
13{
14    // SQLite データベースファイルのパスを定義
15    $dbFile = 'my_database.sqlite';
16    // PDO のデータソース名 (DSN) を構成
17    $dsn = 'sqlite:' . $dbFile;
18
19    try {
20        // データベースに接続
21        // エラーモードを例外に設定し、エラー発生時に PDOException をスローさせる
22        $pdo = new PDO($dsn);
23        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
24
25        echo "データベース接続成功。\n";
26
27        // テーブルが存在しない場合に作成
28        // AUTOINCREMENT により、id は自動的に増加する
29        $pdo->exec("CREATE TABLE IF NOT EXISTS users (
30            id INTEGER PRIMARY KEY AUTOINCREMENT,
31            name TEXT NOT NULL,
32            age INTEGER NOT NULL
33        )");
34        echo "テーブル 'users' の準備完了。\n";
35
36        // プリペアドステートメントを準備
37        // SQLインジェクションを防ぐため、プレースホルダ（:name, :age）を使用
38        $stmt = $pdo->prepare("INSERT INTO users (name, age) VALUES (:name, :age)");
39
40        // ----------------------------------------------------
41        // パラメータをバインドし、型を PDO::PARAM_STR と PDO::PARAM_INT で明示的に指定
42        // PDO::PARAM_INT は、このパラメータが整数型であることを PDO に伝えます
43        // ----------------------------------------------------
44
45        // 1人目のユーザーデータを挿入
46        $name1 = "Alice";
47        $age1 = 30;
48        $stmt->bindParam(':name', $name1, PDO::PARAM_STR); // 名前は文字列型
49        $stmt->bindParam(':age', $age1, PDO::PARAM_INT);   // 年齢は整数型
50        $stmt->execute();
51        echo "ユーザー '{$name1}' (年齢: {$age1}) を挿入しました。\n";
52
53        // 2人目のユーザーデータを挿入
54        $name2 = "Bob";
55        $age2 = 25;
56        $stmt->bindParam(':name', $name2, PDO::PARAM_STR); // 同じプリペアドステートメントを再利用
57        $stmt->bindParam(':age', $age2, PDO::PARAM_INT);
58        $stmt->execute();
59        echo "ユーザー '{$name2}' (年齢: {$age2}) を挿入しました。\n";
60        
61        // 挿入したデータを取得して表示
62        echo "\n--- ユーザーリスト ---\n";
63        $stmt = $pdo->query("SELECT id, name, age FROM users ORDER BY id");
64        while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
65            echo "ID: {$row['id']}, 名前: {$row['name']}, 年齢: {$row['age']}\n";
66        }
67        echo "----------------------\n";
68
69    } catch (PDOException $e) {
70        // データベース関連のエラーをキャッチし表示
71        echo "データベースエラー: " . $e->getMessage() . "\n";
72    } catch (Exception $e) {
73        // その他の予期せぬエラーをキャッチし表示
74        echo "一般エラー: " . $e->getMessage() . "\n";
75    } finally {
76        // データベース接続を閉じる (PHPではスクリプト終了時に自動的に閉じられるが、明示的にnullを設定することも可能)
77        $pdo = null;
78        echo "\nデータベース接続を閉じました。\n";
79
80        // デモンストレーション後にデータベースファイルを削除する場合 (オプション)
81        // unlink($dbFile);
82        // echo "データベースファイルを削除しました。\n";
83    }
84}
85
86// 関数を実行してサンプルコードの動作を確認
87demonstratePdoParamInt();
88

このサンプルコードは、PHPのPDO（PHP Data Objects）拡張機能と定数PDO::PARAM_INTを使用して、データベース操作の基本を学べるように設計されています。PDO::PARAM_INTは、プリペアドステートメントでプレースホルダにバインドする値が整数型であることを明示的に指定するための定数です。この定数自体に引数や戻り値はありませんが、その役割はデータベースへのデータ挿入において、値の型を正確に伝えることで、SQLインジェクション攻撃を防ぎ、データの整合性を保つことにあります。

コードではまず、SQLiteデータベースに接続し、「users」テーブルが存在しない場合に作成します。次に、INSERT文を用いてデータを挿入する際、bindParamメソッドで「age」カラムに渡す値がPDO::PARAM_INT、つまり整数型であることを明確に指定しています。また、名前などの文字列型にはPDO::PARAM_STRを使用し、型を厳密に管理する重要性を示しています。このようにパラメータの型を明示的に指定することで、予期せぬ型変換エラーやセキュリティリスクを低減し、より堅牢なアプリケーションを開発できます。最後に、挿入されたデータをSELECT文で取得・表示し、一連のデータベース操作がどのように行われるかを具体的に示しています。

Copy
1<?php
2
3/**
4 * データベースにユーザー情報を挿入するサンプル関数。
5 * PDO::PARAM_STR を使用して文字列型のパラメータを安全にバインドする方法を示します。
6 *
7 * このコードはSQLiteのインメモリデータベースを使用するため、
8 * 追加のデータベース設定なしでPHPが動作する環境で単体で実行可能です。
9 * スクリプト終了時にデータベースは自動的に破棄されます。
10 *
11 * @return void
12 */
13function insertUserWithParamStr(): void
14{
15    // データベース接続情報 (SQLiteのインメモリデータベースを使用)
16    // 初心者でもすぐに試せるように、ファイルを作成しないインメモリDBを選択しています。
17    $dsn = 'sqlite::memory:';
18    $username = null; // SQLiteでは通常ユーザー名・パスワードは不要
19    $password = null; // SQLiteでは通常ユーザー名・パスワードは不要
20    $options = [
21        PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION, // エラー発生時にPDOExceptionをスローする
22        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,       // 結果を連想配列で取得する
23        PDO::ATTR_EMULATE_PREPARES   => false,                  // プリペアドステートメントのエミュレーションを無効にする (推奨)
24    ];
25
26    try {
27        // データベースに接続
28        $pdo = new PDO($dsn, $username, $password, $options);
29        echo "データベースに接続しました。\n";
30
31        // サンプルとして'users'テーブルを作成
32        // このテーブルはスクリプト実行中にメモリ上に作成され、終了時に消滅します。
33        $pdo->exec("
34            CREATE TABLE IF NOT EXISTS users (
35                id INTEGER PRIMARY KEY AUTOINCREMENT,
36                name TEXT NOT NULL,
37                email TEXT NOT NULL UNIQUE
38            );
39        ");
40        echo "usersテーブルを作成しました。\n";
41
42        // INSERT文の準備 (プリペアドステートメント)
43        // SQLインジェクション攻撃を防ぐために、値を直接SQLに埋め込まずプレースホルダ（:name, :email）を使用します。
44        $stmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (:name, :email)");
45
46        // 1人目のユーザーデータを設定
47        $name1 = '山田 太郎';
48        $email1 = 'taro.yamada@example.com';
49
50        // パラメータをバインドし、型をPDO::PARAM_STR (文字列型) として明示的に指定します。
51        // これにより、データベースが受け取る値の型が保証され、セキュリティが向上します。
52        $stmt->bindParam(':name', $name1, PDO::PARAM_STR);
53        $stmt->bindParam(':email', $email1, PDO::PARAM_STR);
54
55        // SQLを実行
56        $stmt->execute();
57        echo "ユーザー '{$name1}' を挿入しました。\n";
58
59        // 2人目のユーザーデータを設定
60        $name2 = '佐藤 花子';
61        $email2 = 'hanako.sato@example.com';
62
63        // bindValue() を使った別のバインド方法
64        // bindParam() は参照をバインドするのに対し、bindValue() は値をバインドします。
65        $stmt->bindValue(':name', $name2, PDO::PARAM_STR);
66        $stmt->bindValue(':email', $email2, PDO::PARAM_STR);
67
68        // SQLを実行
69        $stmt->execute();
70        echo "ユーザー '{$name2}' を挿入しました。\n";
71
72        // 挿入されたすべてのユーザーデータを取得して表示
73        echo "\n--- 挿入されたユーザー一覧 ---\n";
74        $selectStmt = $pdo->query("SELECT id, name, email FROM users");
75        $users = $selectStmt->fetchAll(); // すべての行を取得
76
77        if (empty($users)) {
78            echo "ユーザーが見つかりませんでした。\n";
79        } else {
80            foreach ($users as $user) {
81                echo "ID: {$user['id']}, 名前: {$user['name']}, メール: {$user['email']}\n";
82            }
83        }
84
85    } catch (PDOException $e) {
86        // データベース関連のエラーが発生した場合
87        echo "データベースエラー: " . $e->getMessage() . "\n";
88    } catch (Exception $e) {
89        // その他の予期せぬエラーが発生した場合
90        echo "エラー: " . $e->getMessage() . "\n";
91    } finally {
92        // データベース接続を閉じる (PHPではスクリプト終了時に自動的に閉じられますが、明示的にnullを設定することも可能)
93        $pdo = null;
94        echo "\nデータベース接続を閉じました。\n";
95    }
96}
97
98// 関数を実行して、サンプルコードの動作を確認します。
99insertUserWithParamStr();

PHPのPDO::PARAM_STRは、PHP 8で利用可能なPDO（PHP Data Objects）拡張機能に属する定数です。この定数は、データベースに値を渡す際に、その値が「文字列」であることを明示的に指定するために使用されます。

主に、SQLインジェクション攻撃を防ぐための「プリペアドステートメント」という安全なデータベース操作において、PDOStatement::bindParam()やPDOStatement::bindValue()メソッドの第三引数として利用されます。PDO::PARAM_STRを指定することで、データベースが受け取る値の型が文字列であることが保証され、データの整合性を保ちながらセキュリティを向上させることができます。

サンプルコードでは、SQLiteのインメモリデータベースにユーザー情報を挿入する例を通じて、この定数の具体的な使い方を示しています。bindParam()やbindValue()メソッドでユーザーの名前やメールアドレスといった文字列データをバインドする際にPDO::PARAM_STRを指定することで、安全かつ正確にデータベースへ値を渡している様子が確認できます。

この定数自体は引数を取らず、内部的には整数値（int）として定義されており、プログラム内で特定のデータ型を表す識別子として機能します。システムエンジニアを目指す初心者の方にとって、データベースと安全に連携するための基礎として重要な概念の一つです。