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

Copy
1<?php
2
3// SQLite データベースファイルを開く
4$db = new SQLite3('test.db');
5
6// テーブルを作成 (存在しない場合)
7$db->exec('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)');
8
9// プリペアドステートメントを作成
10$stmt = $db->prepare('INSERT INTO users (name, age) VALUES (:name, :age)');
11
12// パラメータをバインド
13$stmt->bindValue(':name', 'John Doe', SQLITE3_TEXT);
14$stmt->bindValue(':age', 30, SQLITE3_INTEGER);
15
16// クエリを実行
17$result = $stmt->execute();
18
19// 結果を確認
20if ($result) {
21    echo "データ挿入成功\n";
22
23    // 挿入されたデータのidを取得
24    $lastInsertId = $db->lastInsertRowID();
25    echo "挿入されたID: " . $lastInsertId . "\n";
26
27    // 結果セットを解放
28    $result->finalize();
29} else {
30    echo "データ挿入失敗: " . $db->lastErrorMsg() . "\n";
31}
32
33// ステートメントを解放
34$stmt->close();
35
36// データベース接続を閉じる
37$db->close();
38
39?>

このPHPサンプルコードは、SQLite3データベースに対してプリペアドステートメントを使用してデータ挿入処理を行う方法を示しています。まず、SQLite3クラスのインスタンスを作成し、データベースファイル（この例では test.db）を開きます。データベースが存在しない場合は、CREATE TABLE IF NOT EXISTSを用いて users テーブルを作成します。

次に、$db->prepare() メソッドを使ってプリペアドステートメントを作成します。これにより、SQLインジェクション攻撃を防ぎつつ、同じクエリを効率的に再利用できます。プレースホルダー (:name, :age) を用いて、後から値をバインドできるようにします。

$stmt->bindValue() メソッドを使って、プレースホルダーに値をバインドします。SQLITE3_TEXT や SQLITE3_INTEGER は、それぞれの値のデータ型を指定するために使用します。

$stmt->execute() メソッドが、プリペアドステートメントを実行します。このメソッドは、クエリが成功した場合は SQLite3Result オブジェクトを、失敗した場合は false を返します。

SQLite3Result オブジェクトが返された場合、$db->lastInsertRowID() メソッドを使って最後に挿入された行のIDを取得できます。挿入処理の結果（$result）を使い終わったら、$result->finalize()で結果セットを解放します。

最後に、$stmt->close() でステートメントを閉じ、$db->close() でデータベース接続を閉じます。エラーが発生した場合は、$db->lastErrorMsg() メソッドでエラーメッセージを取得できます。このコードは、データベース操作の基本的な流れと、プリペアドステートメントを使用するメリットを理解するのに役立ちます。

Copy
1<?php
2
3/**
4 * SQLite3Stmt::execute の使用例を示す関数。
5 *
6 * この関数は、インメモリのSQLite3データベースを作成し、
7 * プリペアドステートメントを使用してデータを安全に検索する方法を示します。
8 * execute() メソッド自体に引数はありませんが、事前に bindValue() などで
9 * SQLクエリに渡す値を設定します。
10 */
11function demonstrateSqlite3StmtExecute(): void
12{
13    try {
14        // 1. インメモリデータベースへの接続
15        // :memory: を指定すると、ファイルを作成せずにメモリ上でデータベースを扱える
16        $db = new SQLite3(':memory:');
17
18        // 2. サンプル用のテーブルを作成し、データを挿入
19        $db->exec('CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, email TEXT)');
20        $db->exec("INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com')");
21        $db->exec("INSERT INTO users (name, email) VALUES ('Bob', 'bob@example.com')");
22
23        // 3. 検索するSQL文を準備 (プリペアドステートメント)
24        // SQLインジェクションを防ぐため、値はプレースホルダ(:name)にする
25        $sql = 'SELECT id, name, email FROM users WHERE name = :name';
26        $stmt = $db->prepare($sql);
27
28        // prepareが成功したか確認
29        if ($stmt === false) {
30            throw new Exception($db->lastErrorMsg());
31        }
32
33        // 4. プレースホルダに値をバインド（これが実質的な引数の設定）
34        // 第1引数: プレースホルダ名
35        // 第2引数: バインドする値
36        // 第3引数: 値のデータ型
37        $searchName = 'Alice';
38        $stmt->bindValue(':name', $searchName, SQLITE3_TEXT);
39
40        // 5. プリペアドステートメントを実行
41        // execute() メソッド自体には引数を渡さない
42        // 戻り値は SQLite3Result オブジェクト、失敗した場合は false
43        $result = $stmt->execute();
44
45        // 6. 実行結果を取得して表示
46        if ($result) {
47            echo "ユーザー '{$searchName}' の検索結果:\n";
48            // fetchArray() を使って結果を1行ずつ連想配列として取得
49            while ($row = $result->fetchArray(SQLITE3_ASSOC)) {
50                printf("  ID: %d, Name: %s, Email: %s\n", $row['id'], $row['name'], $row['email']);
51            }
52            // 結果セットのリソースを解放
53            $result->finalize();
54        } else {
55            echo "ステートメントの実行に失敗しました。\n";
56        }
57
58    } catch (Exception $e) {
59        // エラー処理
60        echo "エラーが発生しました: " . $e->getMessage() . "\n";
61    } finally {
62        // 7. ステートメントとデータベース接続を閉じる
63        if (isset($stmt) && $stmt instanceof SQLite3Stmt) {
64            $stmt->close();
65        }
66        if (isset($db) && $db instanceof SQLite3) {
67            $db->close();
68        }
69    }
70}
71
72// 作成した関数を実行
73demonstrateSqlite3StmtExecute();
74

SQLite3Stmt::execute()メソッドは、プリペアドステートメントを実行するために使用します。このメソッド自体には引数は不要です。ステートメントにバインドする値は、事前にbindValue()メソッドなどを使用して設定します。

このサンプルコードでは、まずインメモリのSQLite3データベースに接続し、usersテーブルを作成してサンプルデータを挿入します。次に、nameを条件にユーザーを検索するSQL文をプリペアドステートメントとして準備します。SQLインジェクションを防ぐために、プレースホルダーを使用します。bindValue()メソッドでプレースホルダーに検索する名前(Alice)をバインドし、データ型を指定します。

execute()メソッドを実行すると、SQLite3Resultオブジェクトが返されます。実行に失敗した場合はfalseが返されます。SQLite3ResultオブジェクトからfetchArray()メソッドを使って結果を1行ずつ取得し、ユーザー情報を表示します。最後に、ステートメントとデータベース接続をクローズし、リソースを解放します。