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

Copy
1<?php
2
3/**
4 * SQLite3データベースに新しいユーザー情報を挿入します。
5 *
6 * この関数は、指定されたデータベースファイルに接続し、
7 * 必要であれば 'users' テーブルを作成した後、
8 * ユーザー名と年齢を挿入します。
9 * プリペアドステートメントを使用し、SQLITE3_INTEGER定数で年齢の型を指定します。
10 *
11 * @param string $dbPath データベースファイルのパス (例: 'my_database.db')
12 * @param string $name 挿入するユーザーの名前
13 * @param int $age 挿入するユーザーの年齢
14 * @return bool 挿入が成功した場合は true、それ以外は false
15 */
16function insertUserToSqlite(string $dbPath, string $name, int $age): bool
17{
18    $db = null; // SQLite3オブジェクトを初期化
19    try {
20        // データベースに接続または新規作成を試みます。
21        // ファイルが存在しない場合は自動的に作成されます。
22        $db = new SQLite3($dbPath);
23
24        // 'users' テーブルが存在しない場合に作成します。
25        // idは自動採番の主キー、nameはテキスト型、ageは整数型として定義します。
26        $db->exec('CREATE TABLE IF NOT EXISTS users (
27            id INTEGER PRIMARY KEY AUTOINCREMENT,
28            name TEXT NOT NULL,
29            age INTEGER NOT NULL
30        )');
31
32        // INSERT文を準備します（プリペアドステートメント）。
33        // プレースホルダ (:name, :age) を使用することで、SQLインジェクション攻撃を防ぎます。
34        $stmt = $db->prepare('INSERT INTO users (name, age) VALUES (:name, :age)');
35        if (!$stmt) {
36            // プリペアドステートメントの準備に失敗した場合、例外をスローします。
37            throw new Exception("プリペアドステートメントの準備に失敗しました: " . $db->lastErrorMsg());
38        }
39
40        // プレースホルダに値をバインドします。
41        // :name にはユーザー名を TEXT 型 (SQLITE3_TEXT) としてバインドします。
42        $stmt->bindValue(':name', $name, SQLITE3_TEXT);
43        // :age には年齢を INTEGER 型 (SQLITE3_INTEGER) としてバインドします。
44        // ここでリファレンス情報にある SQLITE3_INTEGER 定数を使用します。
45        $stmt->bindValue(':age', $age, SQLITE3_INTEGER);
46
47        // ステートメントを実行し、データをデータベースに挿入します。
48        $result = $stmt->execute();
49        if (!$result) {
50            // 実行に失敗した場合、例外をスローします。
51            throw new Exception("INSERTの実行に失敗しました: " . $db->lastErrorMsg());
52        }
53
54        // 挿入成功メッセージと、新しく挿入された行のIDを表示します。
55        echo "ユーザー '{$name}' (年齢: {$age}) をデータベースに挿入しました。ID: " . $db->lastInsertRowID() . "\n";
56        return true; // 成功
57
58    } catch (Exception $e) {
59        // エラーが発生した場合、メッセージを表示し、falseを返します。
60        echo "エラーが発生しました: " . $e->getMessage() . "\n";
61        return false; // 失敗
62    } finally {
63        // データベース接続が確立されている場合、確実に接続を閉じます。
64        if ($db) {
65            $db->close();
66        }
67    }
68}
69
70// --- 関数の実行例 ---
71$databaseFile = 'my_users.db'; // 使用するデータベースファイル名を定義
72
73// ユーザーデータをデータベースに挿入します。
74insertUserToSqlite($databaseFile, '山田 太郎', 30);
75insertUserToSqlite($databaseFile, '鈴木 花子', 25);
76insertUserToSqlite($databaseFile, '田中 次郎', 40);
77
78// (このスクリプトを複数回実行しても、'users' テーブルは一度しか作成されません。)
79// (データは毎回追加されます。重複挿入を避ける場合は、事前に存在チェックなどが必要です。)
80
81// データベースファイルを削除したい場合（開発やテスト目的）
82// if (file_exists($databaseFile)) {
83//     unlink($databaseFile);
84//     echo "データベースファイル {$databaseFile} を削除しました。\n";
85// }
86
87?>

このPHPサンプルコードは、SQLite3データベースに新しいユーザー情報を安全に挿入する方法を示しています。insertUserToSqlite関数は、引数としてデータベースファイルのパス、挿入するユーザーの名前、そして年齢を受け取ります。処理が成功した場合はtrue、失敗した場合はfalseを戻り値として返します。

関数内では、まず指定されたデータベースファイルに接続し、もし存在しなければusersテーブルを作成します。このテーブルは、自動採番のID、テキスト型のユーザー名、そして整数型の年齢を保持します。

データの挿入には、セキュリティを高めるプリペアドステートメントが使用されています。これにより、SQLインジェクション攻撃を防ぎながら安全にデータを扱えます。特に、ユーザーの年齢データはbindValueメソッドを通じてSQLITE3_INTEGER定数を使用し、データベースに整数型として正確にバインドされる点が重要です。これにより、データの整合性が保たれます。

最終的に、ステートメントを実行してデータを挿入し、処理中に発生したエラーは適切に捕捉され、データベース接続は確実に閉じられる堅牢な設計となっています。

Copy
1<?php
2
3/**
4 * SQLite3 データベースを操作し、SQLITE3_INTEGER 定数を用いて
5 * カラムのデータ型を判定するサンプルコードです。
6 *
7 * システムエンジニアを目指す初心者の方向けに、
8 * データベース接続からデータ挿入、クエリ実行、結果の型判定までを
9 * 一連の流れで示します。
10 */
11function demonstrateSqliteIntegerTypeCheck(): void
12{
13    // 1. SQLite3 データベースへの接続
14    // ':memory:' は一時的なインメモリデータベースを作成することを意味します。
15    // スクリプトの終了とともにデータは失われます。
16    $db = new SQLite3(':memory:');
17
18    // 接続に失敗した場合はエラーメッセージを表示して終了
19    if (!$db) {
20        echo "データベースへの接続に失敗しました。\n";
21        return;
22    }
23    echo "データベースに接続しました。\n\n";
24
25    // 2. テーブルの作成
26    // 'id' カラムは INTEGER PRIMARY KEY (整数型の主キー) として定義します。
27    // 'name' カラムは TEXT (文字列型) です。
28    $createTableSql = 'CREATE TABLE IF NOT EXISTS users (
29        id INTEGER PRIMARY KEY AUTOINCREMENT,
30        name TEXT NOT NULL
31    )';
32    $db->exec($createTableSql);
33    echo "テーブル 'users' を作成しました。\n\n";
34
35    // 3. データの挿入
36    // 2件のユーザーデータをテーブルに挿入します。
37    $db->exec("INSERT INTO users (name) VALUES ('Alice')");
38    $db->exec("INSERT INTO users (name) VALUES ('Bob')");
39    echo "2件のデータを挿入しました。\n\n";
40
41    // 4. データの取得 (SELECT クエリの実行)
42    // users テーブルから id と name カラムのデータをすべて取得します。
43    $results = $db->query('SELECT id, name FROM users');
44
45    // クエリ実行が成功したか確認
46    if ($results) {
47        echo "クエリ 'SELECT id, name FROM users' を実行しました。\n\n";
48
49        // 5. 結果セットのカラム情報を確認
50        // SQLITE3_INTEGER 定数を使ってカラムの型を判定します。
51        $numColumns = $results->numColumns();
52        echo "取得したカラム数: " . $numColumns . "\n";
53
54        for ($i = 0; $i < $numColumns; $i++) {
55            $columnName = $results->columnName($i); // カラム名を取得
56            $columnType = $results->columnType($i); // カラムの型コードを取得
57
58            echo "  カラム名: '{$columnName}', 型コード: {$columnType}";
59
60            // 取得した型コードが SQLITE3_INTEGER 定数と一致するか確認
61            if ($columnType === SQLITE3_INTEGER) {
62                echo " (これはSQLITE3_INTEGER型です)";
63            }
64            echo "\n";
65        }
66        echo "\n";
67
68        // 6. 取得したデータを表示
69        echo "--- 取得データ一覧 ---\n";
70        // fetchArray() で1行ずつ結果を取得します。
71        // SQLITE3_ASSOC を指定すると、連想配列としてカラム名でデータにアクセスできます。
72        while ($row = $results->fetchArray(SQLITE3_ASSOC)) {
73            print_r($row); // 取得した行のデータを表示
74        }
75        echo "----------------------\n\n";
76
77        // 結果セットのメモリを解放 (必須ではありませんが推奨されます)
78        $results->finalize();
79    } else {
80        // クエリ実行に失敗した場合
81        echo "クエリの実行に失敗しました: " . $db->lastErrorMsg() . "\n";
82    }
83
84    // 7. データベース接続を閉じる
85    $db->close();
86    echo "データベース接続を閉じました。\n";
87}
88
89// 関数を実行して、一連の処理を確認します。
90demonstrateSqliteIntegerTypeCheck();

このPHPサンプルコードは、SQLite3データベースの基本的な操作と、SQLITE3_INTEGER定数を用いたカラムのデータ型判定方法を、システムエンジニアを目指す初心者向けに示しています。

SQLITE3_INTEGERは、PHPのSQLite3拡張機能で定義されている定数の一つで、SQLite3データベースにおける整数型（INTEGER）を表す識別子として使われます。この定数自体に引数はなく、内部的には整数値（int）として定義されています。

サンプルコードでは、まずインメモリデータベースへの接続から始まり、ユーザーテーブルの作成、データの挿入といった基本的なデータベース操作を実行します。次に、挿入したデータをSELECTクエリで取得し、取得した結果セットの各カラム情報に注目します。ここで、SQLite3ResultオブジェクトのcolumnType()メソッドで各カラムの型コードを取得し、その型コードがSQLITE3_INTEGER定数と一致するかどうかを判定することで、カラムが整数型であるかをプログラム的に識別する具体的な方法が示されています。これにより、データベースから得られたデータの型情報を正確に把握し、適切な処理を行うための基礎が理解できます。