【PHP8.x】bindValueメソッドの使い方

Copy
1<?php
2
3// データベースファイル名を定義
4$dbFile = 'my_database.db';
5
6// SQLite3 データベースに接続（ファイルが存在しない場合は新規作成されます）
7$db = new SQLite3($dbFile);
8
9// データベース接続エラーのチェック
10if (!$db) {
11    die("データベース接続エラー: " . $db->lastErrorMsg());
12}
13
14// users テーブルが存在しない場合のみ作成
15$db->exec('CREATE TABLE IF NOT EXISTS users (
16    id INTEGER PRIMARY KEY AUTOINCREMENT,
17    name TEXT NOT NULL,
18    age INTEGER
19)');
20
21// INSERT プリペアドステートメントを準備
22// 名前付きプレースホルダ (:name, :age) を使用します
23$stmt = $db->prepare('INSERT INTO users (name, age) VALUES (:name, :age)');
24
25// プリペアドステートメント準備のエラーチェック
26if (!$stmt) {
27    die("プリペアドステートメントの準備エラー: " . $db->lastErrorMsg());
28}
29
30// 最初のユーザーデータを定義
31$userName1 = 'Alice';
32$userAge1 = 30;
33
34// bindValue メソッドを使用してプレースホルダに値をバインドします
35// 第1引数: プレースホルダの名前 (またはインデックス)
36// 第2引数: バインドする値
37// 第3引数: バインドする値のデータ型 (SQLITE3_TEXT, SQLITE3_INTEGER など)
38$stmt->bindValue(':name', $userName1, SQLITE3_TEXT);
39$stmt->bindValue(':age', $userAge1, SQLITE3_INTEGER);
40
41// ステートメントを実行してデータを挿入
42if ($stmt->execute()) {
43    echo "ユーザー '{$userName1}' を正常に挿入しました。" . PHP_EOL;
44} else {
45    echo "ユーザー '{$userName1}' の挿入に失敗しました: " . $db->lastErrorMsg() . PHP_EOL;
46}
47
48// ステートメントをリセットし、異なる値をバインドして再利用
49$stmt->reset();
50
51// 二人目のユーザーデータを定義
52$userName2 = 'Bob';
53$userAge2 = 25;
54
55$stmt->bindValue(':name', $userName2, SQLITE3_TEXT);
56$stmt->bindValue(':age', $userAge2, SQLITE3_INTEGER);
57
58// ステートメントを実行してデータを挿入
59if ($stmt->execute()) {
60    echo "ユーザー '{$userName2}' を正常に挿入しました。" . PHP_EOL;
61} else {
62    echo "ユーザー '{$userName2}' の挿入に失敗しました: " . $db->lastErrorMsg() . PHP_EOL;
63}
64
65// プリペアドステートメントをクローズし、関連するリソースを解放
66$stmt->close();
67
68// 挿入されたデータを確認するための SELECT 文を実行
69echo PHP_EOL . "--- 挿入されたユーザー一覧 ---" . PHP_EOL;
70$results = $db->query('SELECT id, name, age FROM users');
71
72if ($results) {
73    while ($row = $results->fetchArray(SQLITE3_ASSOC)) {
74        echo "ID: {$row['id']}, 名前: {$row['name']}, 年齢: {$row['age']}" . PHP_EOL;
75    }
76    // 結果セットのリソースを解放
77    $results->finalize();
78} else {
79    echo "データ取得エラー: " . $db->lastErrorMsg() . PHP_EOL;
80}
81
82// データベース接続を閉じる
83$db->close();
84echo PHP_EOL . "データベース接続を閉じました。" . PHP_EOL;
85
86// オプション: 実行後にデータベースファイルを削除する場合 (開発/テスト用)
87// if (file_exists($dbFile)) {
88//     unlink($dbFile);
89//     echo "データベースファイルを削除しました: " . $dbFile . PHP_EOL;
90// }
91
92?>

SQLite3Stmt::bindValue メソッドは、PHPでSQLiteデータベースを操作する際、プリペアドステートメントのプレースホルダに具体的な値を安全に紐づけるために使用されます。この方法を用いることで、SQLインジェクション攻撃を防ぎ、同じSQLクエリを異なる値で繰り返し効率的に実行できるようになります。

このメソッドは3つの引数を取ります。最初の $param は、SQL文中のプレースホルダを特定するためのもので、例えば :name のような名前付きプレースホルダ名、あるいはクエスチョンマークプレースホルダの1から始まるインデックスを文字列または整数で指定します。次に $value は、そのプレースホルダに設定したい実際のデータを指定します。最後の $type は、バインドするデータの型を SQLITE3_TEXT や SQLITE3_INTEGER のような定数で明示的に指定し、データベースに正しい型で値が渡るようにします。この $type 引数は省略可能で、省略された場合は SQLITE3_TEXT と見なされます。

bindValue メソッドは、値のバインドが常に成功するため、戻り値は true となります。

サンプルコードでは、INSERT 文の :name と :age という名前付きプレースホルダに、ユーザー名と年齢を変数から取得し、それぞれ SQLITE3_TEXT 型と SQLITE3_INTEGER 型として bindValue でバインドしています。これにより、安全にデータをデータベースに挿入し、さらに reset メソッドでバインドを解除した後、異なるユーザーデータでステートメントを再利用しています。このように bindValue を活用することで、データベース操作の安全性と効率性を高めることができます。

Copy
1<?php
2
3/**
4 * SQLite3 データベースに接続し、プリペアドステートメントと bindValue を使用して
5 * 複数のパラメータを持つデータを挿入するサンプルコードです。
6 * bindValue メソッドを使って、異なるデータ型を持つ複数のプレースホルダに値をバインドします。
7 */
8
9// データベースファイル名を定義
10$dbFile = 'my_database.db';
11
12// 1. SQLite3 データベースに接続
13// データベースファイルが存在しない場合は新規作成されます。
14try {
15    $db = new SQLite3($dbFile);
16    $db->enableExceptions(true); // エラー発生時に例外をスローするように設定
17} catch (Exception $e) {
18    echo "データベース接続エラー: " . $e->getMessage() . "\n";
19    exit();
20}
21
22// 2. テーブルが存在しない場合に作成
23// 'users' テーブルを定義します。idは自動採番、nameはテキスト、ageは整数、cityはテキストです。
24$createTableSql = 'CREATE TABLE IF NOT EXISTS users (
25    id INTEGER PRIMARY KEY AUTOINCREMENT,
26    name TEXT NOT NULL,
27    age INTEGER,
28    city TEXT
29)';
30
31try {
32    $db->exec($createTableSql);
33    echo "テーブル 'users' が正常に作成または既に存在します。\n";
34} catch (Exception $e) {
35    echo "テーブル作成エラー: " . $e->getMessage() . "\n";
36    $db->close();
37    exit();
38}
39
40// 3. データを挿入するためのプリペアドステートメントを準備
41// 複数の名前付きプレースホルダ (:name, :age, :city) を持つINSERT文を使用します。
42$insertSql = 'INSERT INTO users (name, age, city) VALUES (:name, :age, :city)';
43try {
44    $stmt = $db->prepare($insertSql);
45} catch (Exception $e) {
46    echo "プリペアドステートメント準備エラー: " . $e->getMessage() . "\n";
47    $db->close();
48    exit();
49}
50
51// 4. bindValue を使用してパラメータに値をバインドし、ステートメントを実行
52
53// --- 最初のユーザーデータ ---
54echo "最初のユーザーを挿入します。\n";
55// :name プレースホルダに文字列 'Alice' をバインド
56$stmt->bindValue(':name', 'Alice', SQLITE3_TEXT);
57// :age プレースホルダに整数 30 をバインド
58$stmt->bindValue(':age', 30, SQLITE3_INTEGER);
59// :city プレースホルダに文字列 'New York' をバインド
60$stmt->bindValue(':city', 'New York', SQLITE3_TEXT);
61
62try {
63    $stmt->execute(); // ステートメントを実行し、データを挿入
64    echo "ユーザー 'Alice' が正常に追加されました。\n";
65} catch (Exception $e) {
66    echo "ユーザー挿入エラー (Alice): " . $e->getMessage() . "\n";
67}
68
69// --- 2番目のユーザーデータ ---
70// bindValue は値を上書きできるため、同じプリペアドステートメントを再利用できます。
71echo "2番目のユーザーを挿入します。\n";
72// :name プレースホルダに文字列 'Bob' をバインド
73$stmt->bindValue(':name', 'Bob', SQLITE3_TEXT);
74// :age プレースホルダに整数 25 をバインド
75$stmt->bindValue(':age', 25, SQLITE3_INTEGER);
76// :city プレースホルダに文字列 'London' をバインド
77$stmt->bindValue(':city', 'London', SQLITE3_TEXT);
78
79try {
80    $stmt->execute(); // ステートメントを再度実行し、別のデータを挿入
81    echo "ユーザー 'Bob' が正常に追加されました。\n";
82} catch (Exception $e) {
83    echo "ユーザー挿入エラー (Bob): " . $e->getMessage() . "\n";
84}
85
86// 5. 挿入されたデータを確認 (オプション)
87echo "\n挿入されたユーザーデータ:\n";
88try {
89    $results = $db->query('SELECT id, name, age, city FROM users');
90    while ($row = $results->fetchArray(SQLITE3_ASSOC)) {
91        echo "ID: " . $row['id'] . ", Name: " . $row['name'] . ", Age: " . $row['age'] . ", City: " . $row['city'] . "\n";
92    }
93} catch (Exception $e) {
94    echo "データ取得エラー: " . $e->getMessage() . "\n";
95}
96
97
98// 6. ステートメントとデータベース接続を閉じる
99$stmt->close();
100$db->close();
101echo "\nデータベース接続が閉じられました。\n";
102
103?>

PHPのSQLite3Stmt::bindValueメソッドは、SQLite3データベースでプリペアドステートメントを扱う際に、SQLインジェクション攻撃を防ぎながら安全に値を割り当てるために使用されます。このメソッドは、特にデータを挿入したり更新したりする際に、複数のプレースホルダに値をバインドする場面で非常に役立ちます。

引数$paramには、SQL文中で定義したプレースホルダの名前（例: :name）または数値による位置を指定します。$valueには、そのプレースホルダに設定したい実際のデータを指定してください。$type引数では、バインドする値のデータ型をSQLITE3_TEXTやSQLITE3_INTEGERといった定数で明示的に指定でき、データベースのデータ整合性を保つ上で重要です。この$typeを省略した場合、デフォルトでSQLITE3_TEXTとして扱われます。

bindValueメソッドは、値をバインドするたびに常にtrueを返します。一度準備したプリペアドステートメントに対して、このメソッドで異なる値を何度でもバインドし、繰り返し実行できる点が大きな特徴です。これにより、SQL文を再解析するオーバーヘッドを減らし、複数データを効率的かつ安全に処理できます。

サンプルコードでは、ユーザー情報をデータベースに挿入するために、名前、年齢、都市といった複数のプレースホルダにbindValueを使って値を割り当て、異なるユーザーデータを安全に登録するプロセスを示しています。