【PHP8.x】SQLITE3_BOTH定数の使い方

Copy
1<?php
2
3/**
4 * SQLite3 データベースの基本的な操作と SQLITE3_BOTH 定数の使用例を示す関数。
5 *
6 * システムエンジニアを目指す初心者が、PHPでSQLite3を扱う方法と
7 * フェッチモードの指定方法を理解するのに役立ちます。
8 */
9function demonstrateSqlite3Usage(): void
10{
11    // データベースファイルの指定
12    $dbFile = 'my_database.db';
13    $db = null; // SQLite3 オブジェクトの初期化
14
15    try {
16        // 1. データベースに接続（ファイルが存在しない場合は新規作成される）
17        $db = new SQLite3($dbFile);
18        echo "データベース '{$dbFile}' に接続しました。\n\n";
19
20        // 2. テーブルを作成
21        // IF NOT EXISTS を使用することで、テーブルが既に存在する場合は作成をスキップします。
22        $db->exec('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, email TEXT)');
23        echo "テーブル 'users' を作成しました（または既に存在します）。\n\n";
24
25        // 3. データを挿入
26        // デモのため、データがまだ存在しない場合にのみ挿入します。
27        $stmt = $db->prepare('SELECT COUNT(*) FROM users WHERE name = :name');
28        $stmt->bindValue(':name', '山田太郎', SQLITE3_TEXT);
29        $result = $stmt->execute();
30        $count = $result->fetchArray(SQLITE3_NUM)[0];
31        $result->finalize();
32        $stmt->close();
33
34        if ($count == 0) {
35            $db->exec("INSERT INTO users (name, email) VALUES ('山田太郎', 'taro.yamada@example.com')");
36            $db->exec("INSERT INTO users (name, email) VALUES ('鈴木花子', 'hanako.suzuki@example.com')");
37            echo "2件のユーザーデータを挿入しました。\n\n";
38        } else {
39            echo "データは既に存在するため、挿入をスキップしました。\n\n";
40        }
41
42        // 4. SQLITE3_BOTH を使用してデータを取得
43        echo "--- SQLITE3_BOTH を使用したデータ取得 ---\n";
44        $results = $db->query('SELECT id, name, email FROM users');
45
46        if ($results) {
47            // fetchArray() の引数に SQLITE3_BOTH を指定します。
48            // これにより、結果行が連想配列（カラム名）と数値配列（0から始まるインデックス）の
49            // 両方で取得されるようになります。
50            while ($row = $results->fetchArray(SQLITE3_BOTH)) {
51                echo "取得データ:\n";
52                echo "  ID (数値インデックス): " . $row[0] . "\n";
53                echo "  ID (連想キー): " . $row['id'] . "\n";
54                echo "  名前 (数値インデックス): " . $row[1] . "\n";
55                echo "  名前 (連想キー): " . $row['name'] . "\n";
56                echo "  メール (数値インデックス): " . $row[2] . "\n";
57                echo "  メール (連想キー): " . $row['email'] . "\n";
58                echo "------------------------------------\n";
59            }
60            $results->finalize(); // 結果セットを解放
61        } else {
62            echo "データ取得中にエラーが発生しました: " . $db->lastErrorMsg() . "\n";
63        }
64
65    } catch (Exception $e) {
66        // データベース接続や操作でエラーが発生した場合の処理
67        echo "エラーが発生しました: " . $e->getMessage() . "\n";
68    } finally {
69        // 5. データベース接続を閉じる
70        if ($db) {
71            $db->close();
72            echo "\nデータベース接続を閉じました。\n";
73        }
74
75        // 6. 作成したデータベースファイルを削除（クリーンアップ）
76        // この処理はデモ用途であり、実際のアプリケーションでは通常行いません。
77        if (file_exists($dbFile)) {
78            unlink($dbFile);
79            echo "データベースファイル '{$dbFile}' を削除しました。\n";
80        }
81    }
82}
83
84// 関数の実行
85demonstrateSqlite3Usage();
86
87?>

このPHPサンプルコードは、システムエンジニアを目指す初心者がPHPでSQLite3データベースを扱う基本的な流れと、SQLITE3_BOTH定数の具体的な使い方を理解できるよう設計されています。

まず、データベースファイルへの接続、usersテーブルの作成、およびデモ用のデータ挿入を行います。次に、本コードの主題であるSQLITE3_BOTH定数を使用してデータを取得します。

SQLITE3_BOTHは、SQLite3拡張機能において、データベースからデータを取得する際のフェッチモードを指定するための定数です。この定数自体は引数を取らず、特定の値を戻り値として返すものではありません。代わりに、SQLite3Result::fetchArray()メソッドにこの定数を渡すと、データベースからフェッチされた1行のデータが、数値インデックス（例: row[0])とカラム名（例: row['id'])の両方をキーとする配列として返されます。これにより、取得したデータへのアクセスが柔軟に行える利点があります。

コードの最後では、データベース接続を閉じ、デモ用に作成したデータベースファイルを削除するクリーンアップ処理も含まれています。

Copy
1<?php
2
3/**
4 * SQLITE3_BOTH 定数を使用して SQLite3 データベースからデータをフェッチするサンプル関数。
5 *
6 * この関数は、SQLite3 データベースを作成し、データを挿入し、
7 * SELECT クエリの結果を数値インデックスとカラム名の両方で取得する方法を示します。
8 */
9function demonstrateSqlite3BothConstant(): void
10{
11    // データベースファイル名
12    $dbFile = 'my_sample_database.db';
13
14    // 既存のデータベースファイルを削除（テストの再現性を確保するため）
15    if (file_exists($dbFile)) {
16        unlink($dbFile);
17    }
18
19    // データベースに接続
20    // 指定したファイルが存在しない場合は新規作成されます。
21    try {
22        $db = new SQLite3($dbFile);
23        echo "データベース '{$dbFile}' に接続しました。\n";
24    } catch (Exception $e) {
25        echo "データベース接続エラー: " . $e->getMessage() . "\n";
26        return; // エラー時は処理を終了
27    }
28
29    // テーブルを作成するSQL文
30    $createTableSql = 'CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)';
31    // SQL文を実行
32    if ($db->exec($createTableSql)) {
33        echo "テーブル 'users' を作成しました。\n";
34    } else {
35        echo "テーブル作成エラー: " . $db->lastErrorMsg() . "\n";
36        $db->close();
37        return;
38    }
39
40    // データを挿入するSQL文
41    $insertDataSql = "INSERT INTO users (name, age) VALUES ('Alice', 30);";
42    $insertDataSql .= "INSERT INTO users (name, age) VALUES ('Bob', 24);";
43    // SQL文を実行
44    if ($db->exec($insertDataSql)) {
45        echo "データを挿入しました。\n";
46    } else {
47        echo "データ挿入エラー: " . $db->lastErrorMsg() . "\n";
48        $db->close();
49        return;
50    }
51
52    // SELECT クエリを実行し、SQLITE3_BOTH を使用してデータをフェッチ
53    echo "\nSQLITE3_BOTH を使用してデータをフェッチします:\n";
54    $results = $db->query('SELECT * FROM users');
55
56    if ($results) {
57        // fetchArray() メソッドに SQLITE3_BOTH を指定すると、
58        // 結果セットの各行を数値インデックスとカラム名の両方でアクセス可能な配列として取得できます。
59        while ($row = $results->fetchArray(SQLITE3_BOTH)) {
60            echo "--- レコード ---\n";
61            // 数値インデックスでデータにアクセス
62            echo "ID (数値インデックス): " . $row[0] . "\n";
63            echo "名前 (数値インデックス): " . $row[1] . "\n";
64            echo "年齢 (数値インデックス): " . $row[2] . "\n";
65
66            // カラム名でデータにアクセス
67            echo "ID (カラム名): " . $row['id'] . "\n";
68            echo "名前 (カラム名): " . $row['name'] . "\n";
69            echo "年齢 (カラム名): " . $row['age'] . "\n";
70            echo "----------------\n";
71        }
72        $results->finalize(); // 結果セットを解放し、メモリを節約
73    } else {
74        echo "クエリ実行エラー: " . $db->lastErrorMsg() . "\n";
75    }
76
77    // データベース接続を閉じる
78    $db->close();
79    echo "\nデータベース接続を閉じました。\n";
80
81    // テスト用のデータベースファイルを削除（クリーンアップのため）
82    if (file_exists($dbFile)) {
83        unlink($dbFile);
84    }
85}
86
87// 関数を実行
88demonstrateSqlite3BothConstant();
89

PHP 8のSQLITE3_BOTH定数は、PHPのSQLite3拡張機能でデータベースからデータを取得する際の形式を指定するための定数です。この定数には引数はなく、内部的に整数（int）値を保持しています。

このサンプルコードは、SQLITE3_BOTH定数を使用してSQLite3データベースからデータをフェッチする具体的な方法を示しています。まず、my_sample_database.dbというデータベースファイルを作成または接続し、以前のテストデータがあれば削除して環境を整えます。次に、usersというテーブルを作成し、AliceとBobの情報を挿入してサンプルデータを準備します。

重要なのは、SELECT * FROM usersというクエリを実行して結果を取得する部分です。取得した結果セットに対してfetchArray(SQLITE3_BOTH)メソッドを呼び出すことで、データベースから取り出した各行のデータを「数値インデックス」と「カラム名」の両方でアクセスできる配列として受け取ることができます。具体的には、$row[0]のように列の順序で値にアクセスすることも、$row['id']のように列名で値にアクセスすることも可能になります。サンプルコードでは、両方の方法でID、名前、年齢のデータを出力し、SQLITE3_BOTHの効果を確認しています。最後に、データベース接続を閉じ、作成したファイルをクリーンアップしています。