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

Copy
1<?php
2
3/**
4 * SQLite3 データベースからデータを取得し、SQLITE3_NUM 定数を使用して
5 * 結果を数値添字配列として取得するプロセスと、取得した行数をカウントする方法を示します。
6 *
7 * この関数は、システムエンジニアを目指す初心者向けに、基本的なデータベース操作、
8 * 結果セットの扱い方、そして特定の取得形式の指定方法を簡潔に示します。
9 */
10function demonstrateSqliteNumAndRowCount(): void
11{
12    // データベースファイル名
13    $dbFile = 'sample_database_for_sqlite3_num.db';
14
15    // データベースに接続。ファイルが存在しない場合は新規作成されます。
16    try {
17        $db = new SQLite3($dbFile);
18        echo "データベース '{$dbFile}' に接続しました。\n";
19    } catch (Exception $e) {
20        die("データベース接続エラー: " . $e->getMessage());
21    }
22
23    // 'users' テーブルが存在しない場合に作成します。
24    // INTEGER PRIMARY KEY AUTOINCREMENT は、レコードが追加されるたびに
25    // 自動的に増加する一意のIDを生成します。
26    $createTableSql = 'CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL)';
27    $db->exec($createTableSql);
28    echo "テーブル 'users' の存在を確認または作成しました。\n";
29
30    // テーブルにデータが少ない場合に、いくつかサンプルデータを挿入します。
31    // すでにデータがある場合は挿入をスキップします。
32    $countSql = "SELECT COUNT(*) FROM users";
33    $currentUsersCount = $db->querySingle($countSql);
34
35    if ($currentUsersCount < 3) {
36        $db->exec("INSERT INTO users (name) VALUES ('Alice')");
37        $db->exec("INSERT INTO users (name) VALUES ('Bob')");
38        $db->exec("INSERT INTO users (name) VALUES ('Charlie')");
39        echo "サンプルデータをいくつか挿入しました。\n";
40    } else {
41        echo "十分なサンプルデータが存在するため、データ挿入はスキップしました。\n";
42    }
43
44    echo "\n--- データベースからデータを取得中 (SQLITE3_NUM を使用) ---\n";
45
46    // users テーブルから全てのidとnameを取得するクエリを実行します。
47    $selectSql = 'SELECT id, name FROM users';
48    $result = $db->query($selectSql);
49
50    if (!$result) {
51        die("クエリ実行エラー: " . $db->lastErrorMsg());
52    }
53
54    $rowCount = 0; // 取得した行数をカウントするための変数
55    // 結果セットから1行ずつデータを取り出します。
56    // SQLITE3_NUM を指定すると、結果は数値添字配列 ($row[0], $row[1]...) として返されます。
57    while ($row = $result->fetchArray(SQLITE3_NUM)) {
58        echo "取得データ - ID: {$row[0]}, 名前: {$row[1]}\n";
59        $rowCount++; // 1行取得するごとにカウントを増やします
60    }
61
62    echo "\n--- データ取得完了 ---\n";
63    echo "SQLITE3_NUM を使用してフェッチしながらカウントした行数: {$rowCount} 件\n";
64
65    // 補足: SQLクエリで直接データベース内の総行数を取得することも可能です。
66    // これは `num_rows` の概念をより直接的に示す方法の一つです。
67    $totalRowCountFromDb = $db->querySingle("SELECT COUNT(*) FROM users");
68    echo "SQL (SELECT COUNT(*)) で取得したデータベース内の総行数: {$totalRowCountFromDb} 件\n";
69
70    // データベース接続を閉じます。
71    $db->close();
72    echo "データベース接続を閉じました。\n";
73
74    // 必要であれば、データベースファイルを削除してクリーンアップできます。
75    // unlink($dbFile);
76    // echo "データベースファイル '{$dbFile}' を削除しました。\n";
77}
78
79// 関数を実行します。
80demonstrateSqliteNumAndRowCount();

PHPのこのサンプルコードは、SQLite3データベースからのデータ取得方法と、取得した行数を数える基本的なプロセスを、システムエンジニアを目指す初心者の方にわかりやすく示しています。

SQLITE3_NUMは、PHPのSQLite3拡張が提供する定数の一つです。この定数をfetchArray()メソッドの引数として指定すると、データベースから取得した結果行が、列名ではなく数値の添字（例: $row[0], $row[1]) を持つ配列として返されます。これにより、取得したデータの各項目に数値でアクセスできるようになります。SQLITE3_NUM自体は定数であるため、引数や戻り値はありません。

コードではまず、SQLite3データベースファイルに接続し、usersテーブルを作成または確認します。次に、もしデータが少ない場合は、サンプルデータをいくつか挿入します。その後、SELECT文でusersテーブルからデータを取得し、whileループ内でfetchArray(SQLITE3_NUM)を使用して1行ずつデータを取り出しています。このループ内で、$rowCount変数をインクリメントすることで、手動で取得した行数をカウントしています。

また、データベースから直接総行数を取得する方法として、SELECT COUNT(*)クエリの実行例も示されており、これはデータベース内のレコード数を正確に知るためによく用いられます。最終的にデータベース接続を閉じ、一連の操作を完了しています。このコードを通じて、PHPでのデータベース操作の基本と、SQLITE3_NUMを使ったデータ取得形式の指定、そして行数カウントの概念を学ぶことができます。