【PHP8.x】PDOStatement::bindValue()メソッドの使い方

Copy
1<?php
2
3/**
4 * PDOStatement::bindValue を使用してデータベースに新しいユーザーデータを挿入するサンプル関数。
5 *
6 * @param string $name ユーザーの名前
7 * @param int $age ユーザーの年齢
8 */
9function insertUserData(string $name, int $age): void
10{
11    // データベース接続情報（必要に応じて変更してください）
12    $dsn = 'mysql:host=localhost;dbname=testdb;charset=utf8mb4';
13    $user = 'root';
14    $password = 'password';
15
16    try {
17        // 1. PDOオブジェクトを作成し、データベースに接続します。
18        // PDO::ATTR_ERRMODE を PDO::ERRMODE_EXCEPTION に設定することで、エラー時に例外がスローされます。
19        // PDO::ATTR_EMULATE_PREPARES を false に設定することで、実際のプリペアドステートメントが使用され、セキュリティが向上します。
20        $pdo = new PDO($dsn, $user, $password, [
21            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
22            PDO::ATTR_EMULATE_PREPARES => false,
23        ]);
24
25        // 2. プリペアドステートメントを作成します。
26        // SQLインジェクションを防ぐため、値を直接埋め込まずプレースホルダ（:name, :age）を使用します。
27        $stmt = $pdo->prepare("INSERT INTO users (name, age) VALUES (:name, :age)");
28
29        // 3. bindValue() を使ってプレースホルダに値をバインドします。
30        // bindValue(プレースホルダ名またはインデックス, バインドする値, 値のデータ型)
31        // :name プレースホルダに $name 変数の値を文字列型 (PDO::PARAM_STR) としてバインド
32        $stmt->bindValue(':name', $name, PDO::PARAM_STR);
33
34        // :age プレースホルダに $age 変数の値を整数型 (PDO::PARAM_INT) としてバインド
35        $stmt->bindValue(':age', $age, PDO::PARAM_INT);
36
37        // 4. ステートメントを実行し、データベースにデータを挿入します。
38        $stmt->execute();
39
40        echo "ユーザーデータ '{$name}' (年齢: {$age}) が正常に挿入されました。\n";
41
42    } catch (PDOException $e) {
43        // PDO関連のエラーが発生した場合に捕捉します。
44        echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
45    } catch (Exception $e) {
46        // その他の予期せぬエラーが発生した場合に捕捉します。
47        echo "予期せぬエラーが発生しました: " . $e->getMessage() . "\n";
48    }
49}
50
51// 関数の実行例
52// 実際のデータベーステーブル 'users' が存在し、'name' (VARCHAR), 'age' (INT) カラムがあることを想定しています。
53// データベースが存在しない場合は、PDOExceptionが発生します。
54insertUserData("山田 太郎", 30);
55insertUserData("鈴木 花子", 25);
56insertUserData("田中 次郎", 40);
57
58// 存在しないテーブルへの挿入を試みる例 (エラー発生を確認できます)
59// insertUserData("エラーユーザー", 99);
60?>

PHPのPDOStatement::bindValueは、データベースへの安全なデータ操作に欠かせないメソッドです。これは、PDO::prepareで用意したSQL文の中にある「プレースホルダ」（例えば:nameや:ageのような仮の目印）に、実際にデータベースへ送る値を安全に結びつける（バインドする）ために使われます。

このメソッドは3つの引数を取ります。1つ目はプレースホルダの名前（例: ':name'）か、位置を示すインデックス番号です。2つ目はそのプレースホルダに割り当てる具体的な値です。3つ目は、その値がどのようなデータ型であるかを指定する定数（例: 文字列ならPDO::PARAM_STR、整数ならPDO::PARAM_INT）で、これは省略可能ですが、指定することで型が明確になり、より安全な処理が可能になります。メソッドは値のバインドに成功すればtrueを、失敗すればfalseを戻り値として返します。

提示されたサンプルコードでは、insertUserData関数内で、ユーザーの名前と年齢をデータベースのusersテーブルへ挿入しています。まず、PDOでデータベースへ接続し、prepareでINSERT文を準備します。次に$stmt->bindValue(':name', $name, PDO::PARAM_STR);で名前を文字列として、$stmt->bindValue(':age', $age, PDO::PARAM_INT);で年齢を整数としてそれぞれプレースホルダにバインドしています。これにより、悪意のあるSQLインジェクションから保護され、安全にデータがデータベースに挿入されます。

Copy
1<?php
2
3/**
4 * データベースへの接続と、PDOStatement::bindValue メソッドを使った
5 * 複数データの挿入例を示します。
6 * SQLite インメモリデータベースを使用しているため、ファイル生成はされず、
7 * スクリプトの実行が完了するとデータは失われます。
8 */
9
10// データベース接続情報 (SQLite インメモリデータベースを使用)
11$dsn = 'sqlite::memory:';
12// SQLiteではユーザー名とパスワードは通常不要です
13$username = null;
14$password = null;
15
16try {
17    // PDO (PHP Data Objects) インスタンスを作成し、データベースに接続します。
18    // エラーモードを例外に設定し、データベース操作中にエラーが発生した場合に
19    // PDOException がスローされるようにします。
20    $pdo = new PDO($dsn, $username, $password, [
21        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
22        // フェッチモードのデフォルトを連想配列に設定します
23        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
24    ]);
25
26    echo "データベースに接続しました。\n";
27
28    // users テーブルを作成します。
29    // IF NOT EXISTS は、テーブルが既に存在する場合は作成しないことを意味します。
30    $pdo->exec("
31        CREATE TABLE IF NOT EXISTS users (
32            id INTEGER PRIMARY KEY AUTOINCREMENT,
33            name VARCHAR(50) NOT NULL,
34            email VARCHAR(100) UNIQUE NOT NULL,
35            age INTEGER
36        );
37    ");
38    echo "users テーブルが作成（または既に存在）しています。\n";
39
40    // INSERT 文を準備します。値の代わりに名前付きプレースホルダ（例: :name）を使用します。
41    // これにより、SQLインジェクション攻撃を防ぎ、コードの可読性が向上します。
42    $stmt = $pdo->prepare("INSERT INTO users (name, email, age) VALUES (:name, :email, :age)");
43
44    echo "\n--- 最初のユーザーデータを挿入 ---\n";
45    // PDOStatement::bindValue メソッドを使って、各プレースホルダに値をバインドします。
46    // 第二引数には実際の値、第三引数にはデータの型を指定します（推奨）。
47    // PDO::PARAM_STR は文字列、PDO::PARAM_INT は整数を表します。
48    $stmt->bindValue(':name', 'アリス', PDO::PARAM_STR);
49    $stmt->bindValue(':email', 'alice@example.com', PDO::PARAM_STR);
50    $stmt->bindValue(':age', 30, PDO::PARAM_INT);
51
52    // 準備したステートメントを実行し、データをデータベースに挿入します。
53    $stmt->execute();
54    echo "アリスのデータが正常に挿入されました。\n";
55
56    echo "\n--- 次のユーザーデータを挿入 (同じステートメントを再利用) ---\n";
57    // 同じプリペアドステートメントを再利用し、異なる値をバインドして別のデータを挿入します。
58    $stmt->bindValue(':name', 'ボブ', PDO::PARAM_STR);
59    $stmt->bindValue(':email', 'bob@example.com', PDO::PARAM_STR);
60    $stmt->bindValue(':age', 25, PDO::PARAM_INT);
61
62    $stmt->execute();
63    echo "ボブのデータが正常に挿入されました。\n";
64
65    // 複数回の bindValue と execute をループ内で使用することもできます。
66    $newUsers = [
67        ['name' => 'チャーリー', 'email' => 'charlie@example.com', 'age' => 35],
68        ['name' => 'デイジー', 'email' => 'daisy@example.com', 'age' => 28],
69    ];
70
71    echo "\n--- ループを使ってさらに複数のユーザーデータを挿入 ---\n";
72    foreach ($newUsers as $user) {
73        $stmt->bindValue(':name', $user['name'], PDO::PARAM_STR);
74        $stmt->bindValue(':email', $user['email'], PDO::PARAM_STR);
75        $stmt->bindValue(':age', $user['age'], PDO::PARAM_INT);
76        $stmt->execute();
77        echo "{$user['name']} のデータが正常に挿入されました。\n";
78    }
79
80
81    // 挿入されたすべてのデータをデータベースから取得し、表示します。
82    echo "\n--- 現在のユーザー一覧 ---\n";
83    $selectStmt = $pdo->query("SELECT id, name, email, age FROM users");
84    $users = $selectStmt->fetchAll(); // 全ての行を連想配列としてフェッチします
85
86    if (empty($users)) {
87        echo "ユーザーデータが見つかりませんでした。\n";
88    } else {
89        foreach ($users as $user) {
90            echo "ID: {$user['id']}, 名前: {$user['name']}, メール: {$user['email']}, 年齢: {$user['age']}\n";
91        }
92    }
93
94} catch (PDOException $e) {
95    // データベース接続や操作中に発生した例外をキャッチし、エラーメッセージを表示します。
96    echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
97    // エラーが発生した場合はスクリプトの実行を終了します。
98    exit(1);
99} catch (Exception $e) {
100    // その他の予期せぬエラーをキャッチします。
101    echo "一般エラーが発生しました: " . $e->getMessage() . "\n";
102    exit(1);
103}
104
105// データベース接続はスクリプト終了時に自動的に閉じられます。
106// 明示的に閉じる場合は、$pdo = null; を実行します。
107
108?>

PHPのPDOStatement::bindValueは、データベースへ安全にデータを挿入する際に用いるメソッドです。このメソッドは、SQLインジェクション攻撃を防ぐため、プリペアドステートメント内のプレースホルダ（例: :name）に実際の値を紐付ける（バインドする）役割を果たします。

引数$paramはSQL文中のプレースホルダ、$valueはそこにバインドする実際のデータです。第三引数$typeでデータの型（PDO::PARAM_STRやPDO::PARAM_INTなど）を指定でき、これはデータの整合性向上に推奨されます。$typeは省略可能です。このメソッドの戻り値は、バインドが成功すればtrue、失敗すればfalseです。

サンプルコードが示すように、一度prepareしたSQL文を再利用し、bindValueで異なる値を設定しexecuteを繰り返すことで、複数のデータを効率的にデータベースへ挿入できます。ループ処理と組み合わせれば、さらに多くのデータをまとめて安全に格納することが可能となり、コードの再利用性と効率性を高めます。