【PHP8.x】Pdo\Sqlite::PARAM_BOOL定数の使い方

Copy
1<?php
2
3/**
4 * PDO::PARAM_BOOL を使用して boolean 値をバインドする例を示します。
5 * システムエンジニアを目指す初心者向けに、PDOとSQLite (インメモリ) を使用した
6 * 簡単なデータベース操作と真偽値のバインド方法を説明します。
7 */
8function demonstratePdoBooleanBinding(): void
9{
10    // SQLiteのインメモリデータベースに接続します。
11    // ファイルシステムに影響を与えず、手軽に試すことができます。
12    $dsn = 'sqlite::memory:';
13
14    try {
15        $pdo = new PDO($dsn);
16        // PDOエラー発生時に例外をスローするように設定します。
17        // これにより、エラーを検知しやすくなります。
18        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
19
20        echo "データベースに接続しました。\n";
21
22        // boolean値を格納するためのシンプルなテーブルを作成します。
23        // SQLiteではBOOLEAN型は内部的にINTEGER (0または1) として扱われます。
24        $pdo->exec("CREATE TABLE application_settings (
25            id INTEGER PRIMARY KEY AUTOINCREMENT,
26            is_enabled BOOLEAN NOT NULL
27        )");
28        echo "テーブル 'application_settings' を作成しました。\n";
29
30        // データを挿入するためのプリペアドステートメントを準備します。
31        // プレースホルダ `:enabled_status` を使用します。
32        $stmt = $pdo->prepare("INSERT INTO application_settings (is_enabled) VALUES (:enabled_status)");
33
34        // boolean型の値を定義します。
35        $setting1_enabled = true;
36        $setting2_enabled = false;
37
38        // 最初の設定 (true) をバインドして実行します。
39        // PDO::PARAM_BOOL を指定することで、値がboolean型であることをPDOに明示的に伝えます。
40        $stmt->bindValue(':enabled_status', $setting1_enabled, PDO::PARAM_BOOL);
41        $stmt->execute();
42        echo "真偽値 '{$setting1_enabled}' (true) を挿入しました。\n";
43
44        // 2番目の設定 (false) をバインドして実行します。
45        $stmt->bindValue(':enabled_status', $setting2_enabled, PDO::PARAM_BOOL);
46        $stmt->execute();
47        echo "真偽値 '{$setting2_enabled}' (false) を挿入しました。\n";
48
49        // 挿入されたデータをデータベースから取得し、確認します。
50        echo "\n--- 挿入されたデータ一覧 ---\n";
51        $results = $pdo->query("SELECT id, is_enabled FROM application_settings");
52        foreach ($results as $row) {
53            // SQLiteから取得される0または1のINTEGER値をPHPのbooleanとして表示します。
54            $displayValue = $row['is_enabled'] ? 'true' : 'false';
55            echo "ID: {$row['id']}, is_enabled: {$displayValue}\n";
56        }
57        echo "--------------------------\n";
58
59    } catch (PDOException $e) {
60        // データベース関連のエラーが発生した場合にメッセージを表示します。
61        echo "エラーが発生しました: " . $e->getMessage() . "\n";
62    }
63}
64
65// 関数を実行して、真偽値のバインド処理を確認します。
66demonstratePdoBooleanBinding();

PHPのPDO::PARAM_BOOLは、データベースのプリペアドステートメントに真偽値（boolean）を安全にバインドするために使用する定数です。この定数はPHPのPDO拡張機能に属しており、bindValueメソッドなどの第3引数として指定することで、PHPのtrueやfalseといった真偽値がデータベースの対応する型に適切に変換されることをPDOに明示的に伝えます。定数であるため、引数や戻り値はありません。

提供されたサンプルコードは、このPDO::PARAM_BOOLの具体的な使用例を、システムエンジニアを目指す初心者向けに解説しています。まず、ファイルシステムに影響を与えないSQLiteのインメモリデータベースに接続し、真偽値型の列を持つシンプルなテーブルを作成します。次に、trueとfalseのPHPの真偽値を定義し、それらをプリペアドステートメントのbindValueメソッドを使って、PDO::PARAM_BOOLを指定してデータベースに安全に挿入します。最後に、挿入されたデータがデータベースに正しく格納されていることを確認するために、データを取得して表示しています。

このようにデータの型を明示的に指定することは、データベースが値を正確に解釈し、予期せぬエラーやセキュリティ上の問題を未然に防ぐ上で非常に重要です。