【PHP8.x】PDO::PARAM_BOOL定数の使い方

Copy
1<?php
2
3/**
4 * データベースにユーザーのアクティブ状態を挿入するサンプル関数。
5 * PDO::PARAM_BOOL を使用して、PHPのboolean値をSQLにバインドする方法を示します。
6 * SQLiteのインメモリデータベースを使用するため、外部ファイルは作成されません。
7 *
8 * @param string $dbPath データベース接続に使用するDSNパス（この例では 'sqlite::memory:' 固定）。
9 */
10function insertUserStatus(string $dbPath): void
11{
12    $pdo = null; // PDOオブジェクトを初期化
13
14    try {
15        // 1. SQLite インメモリデータベースへの接続
16        // 'sqlite::memory:' はメモリ上に一時的なデータベースを作成し、スクリプト終了時に消滅します。
17        // 実際のアプリケーションでは 'sqlite:/path/to/your/database.db' のようにファイルパスを指定します。
18        $pdo = new PDO($dbPath);
19        // エラーモードを例外に設定し、エラーが発生した際にPDOExceptionをスローするようにします。
20        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
21
22        echo "データベースに接続しました。\n";
23
24        // 2. テスト用テーブルの作成
25        // 'is_active' カラムはBOOLEAN型（SQLiteでは内部的にINTEGER型として扱われ、0か1が格納されます）。
26        $pdo->exec("
27            CREATE TABLE IF NOT EXISTS users (
28                id INTEGER PRIMARY KEY AUTOINCREMENT,
29                name TEXT NOT NULL,
30                is_active BOOLEAN NOT NULL
31            );
32        ");
33        echo "テーブル 'users' を作成または確認しました。\n";
34
35        // 3. SQL INSERT ステートメントの準備
36        // プレースホルダ (:name, :isActive) を使用して、後で値を安全にバインドします。
37        $stmt = $pdo->prepare("INSERT INTO users (name, is_active) VALUES (:name, :isActive)");
38
39        // 4. プレースホルダにバインドする変数を宣言
40        // bindParam() は変数の参照を渡すため、事前に変数を定義しておく必要があります。
41        $userName = '';
42        $userIsActive = false; // PHPのboolean型変数
43
44        // 5. プレースホルダへのバインド（bindParamを使用）
45        // 変数 $userName を :name に、PDO::PARAM_STR (文字列型) としてバインドします。
46        $stmt->bindParam(':name', $userName, PDO::PARAM_STR);
47        // 変数 $userIsActive を :isActive に、PDO::PARAM_BOOL (boolean型) としてバインドします。
48        // ここで PDO::PARAM_BOOL を使用することで、PHPのboolean値 (true/false) がSQLの適切なBOOLEAN型 (1/0) に変換されます。
49        $stmt->bindParam(':isActive', $userIsActive, PDO::PARAM_BOOL);
50
51        // 6. データの挿入（true のケース）
52        $userName = 'Alice';
53        $userIsActive = true; // boolean値 true を設定
54        $stmt->execute(); // バインドされた変数の現在の値でステートメントを実行
55        echo "ユーザー 'Alice' (Active: " . ($userIsActive ? 'Yes' : 'No') . ") を挿入しました。\n";
56
57        // 7. データの挿入（false のケース）
58        $userName = 'Bob';
59        $userIsActive = false; // boolean値 false を設定
60        $stmt->execute(); // バインドされた変数の新しい値でステートメントを再度実行
61        echo "ユーザー 'Bob' (Active: " . ($userIsActive ? 'Yes' : 'No') . ") を挿入しました。\n";
62
63        // 8. 挿入されたデータの確認 (オプション)
64        echo "\n--- 挿入されたデータ一覧 ---\n";
65        foreach ($pdo->query("SELECT id, name, is_active FROM users") as $row) {
66            // SQLiteではBOOLEANがINTEGERとして格納されるため、0がfalse、1がtrueとして扱います。
67            echo "ID: {$row['id']}, Name: {$row['name']}, Active: " . ($row['is_active'] ? 'Yes' : 'No') . "\n";
68        }
69
70    } catch (PDOException $e) {
71        // データベース接続やクエリ実行でエラーが発生した場合の処理
72        echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
73    } finally {
74        // データベース接続を閉じる (PDOオブジェクトがスコープを外れると自動的に閉じられますが、明示的に null を代入することも可能です)
75        $pdo = null;
76        echo "\nデータベース接続を閉じました。\n";
77    }
78}
79
80// サンプル関数の実行
81// この例ではインメモリデータベースを使用するため、DSNは 'sqlite::memory:' で固定です。
82insertUserStatus('sqlite::memory:');
83
84?>

このPHPサンプルコードは、データベースに真偽値（boolean）を安全に挿入する方法を示しています。特にPDO::PARAM_BOOL定数の使用方法が核となります。

まず、このコードはSQLiteのインメモリデータベースに接続し、is_activeという真偽値（BOOLEAN型）を格納するカラムを持つusersテーブルを作成します。データベース操作の安全性のため、値が後から変わる可能性のある部分には:isActiveのような「プレースホルダ」を使用し、SQLインジェクション攻撃を防いでいます。

重要なのは、$stmt->bindParam(':isActive', $userIsActive, PDO::PARAM_BOOL); の行です。ここでは、PHPの変数$userIsActiveを:isActiveプレースホルダにバインドする際に、PDO::PARAM_BOOLを指定しています。この定数は、PHPのtrueやfalseといった真偽値を、データベースが理解できる適切な形式（多くのデータベースでは1や0として扱われます）に自動的に変換する役割を持ちます。bindParamメソッドは変数の「参照」を渡すため、$userIsActiveの値が後でtrueやfalseに変わっても、$stmt->execute()の実行時にはその最新の値がデータベースに送られ、正しくデータが挿入されます。

このように、PDO::PARAM_BOOLを使用することで、PHPとデータベース間のデータ型の整合性を簡単に保ち、安全かつ正確なデータ操作を実現できるのです。