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

Copy
1<?php
2
3/**
4 * PDO::FETCH_DEFAULT 定数の使用例と、PDOオブジェクトのデフォルトフェッチモード設定のデモンストレーションを行います。
5 *
6 * この関数は、PHPでPDOを使ってデータベースからデータを取得する際の「フェッチモード」と、
7 * そのデフォルト設定、そして PDO::FETCH_DEFAULT 定数の役割を、システムエンジニアを目指す初心者にも
8 * わかりやすいように簡潔に示します。
9 */
10function demonstratePdoFetchDefault(): void
11{
12    echo "--- PDO::FETCH_DEFAULT デモンストレーション ---" . PHP_EOL . PHP_EOL;
13
14    // 1. SQLiteのインメモリデータベースに接続
15    //    `sqlite::memory:` を使うと、ファイルを作成せずメモリ上でデータベースを操作できます。
16    try {
17        $pdo = new PDO('sqlite::memory:');
18        // エラーモードを例外に設定することで、データベース操作で問題が発生した場合に
19        // エラーを見つけやすくなります。
20        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
21        echo "データベースに接続しました (SQLite インメモリ)." . PHP_EOL;
22    } catch (PDOException $e) {
23        die("データベース接続エラー: " . $e->getMessage());
24    }
25
26    // 2. サンプルのテーブルを作成し、データを挿入
27    try {
28        $pdo->exec("
29            CREATE TABLE IF NOT EXISTS users (
30                id INTEGER PRIMARY KEY,
31                name TEXT NOT NULL,
32                email TEXT NOT NULL UNIQUE
33            );
34        ");
35        $pdo->exec("INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');");
36        $pdo->exec("INSERT INTO users (name, email) VALUES ('Bob', 'bob@example.com');");
37        echo "サンプルテーブルとデータを挿入しました." . PHP_EOL . PHP_EOL;
38    } catch (PDOException $e) {
39        die("データ操作エラー: " . $e->getMessage());
40    }
41
42    // 3. PDOオブジェクトのデフォルトフェッチモードを PDO::FETCH_ASSOC (連想配列) に設定
43    //    PDO::ATTR_DEFAULT_FETCH_MODE は、`fetch()` や `fetchAll()` メソッドで
44    //    フェッチモードを明示的に指定しない場合に適用されるモードを設定します。
45    $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
46    echo "PDOのデフォルトフェッチモードを PDO::FETCH_ASSOC (連想配列) に設定しました." . PHP_EOL . PHP_EOL;
47
48    // 4. データの取得と表示のデモンストレーション
49
50    // a. `fetch()` メソッドに引数を渡さず、デフォルトフェッチモードでデータを取得
51    echo "--- 1. デフォルトフェッチモード (PDO::FETCH_ASSOC) で取得 ---" . PHP_EOL;
52    $stmt = $pdo->query("SELECT id, name, email FROM users WHERE name = 'Alice'");
53    $resultAssocDefault = $stmt->fetch(); // フェッチモードを指定しない
54    echo "結果の型: " . gettype($resultAssocDefault) . PHP_EOL;
55    print_r($resultAssocDefault);
56    echo PHP_EOL;
57
58    // b. 明示的に PDO::FETCH_OBJ (匿名オブジェクト) を指定してデータを取得
59    //    これは、PDOオブジェクトのデフォルト設定を一時的に上書きします。
60    echo "--- 2. 明示的に PDO::FETCH_OBJ (オブジェクト) で取得 ---" . PHP_EOL;
61    $stmt = $pdo->query("SELECT id, name, email FROM users WHERE name = 'Bob'");
62    $resultObj = $stmt->fetch(PDO::FETCH_OBJ); // PDO::FETCH_OBJ を指定
63    echo "結果の型: " . gettype($resultObj) . PHP_EOL;
64    print_r($resultObj);
65    echo PHP_EOL;
66
67    // c. PDO::FETCH_DEFAULT を使用してデータを取得
68    //    PDO::FETCH_DEFAULT を `fetch()` メソッドに渡すと、
69    //    PDOオブジェクトに現在設定されているデフォルトフェッチモード (この時点では PDO::FETCH_ASSOC)
70    //    が適用されます。つまり、上記の `1.` と同じ結果になります。
71    echo "--- 3. PDO::FETCH_DEFAULT を使用して取得 (現在のデフォルト: PDO::FETCH_ASSOC) ---" . PHP_EOL;
72    $stmt = $pdo->query("SELECT id, name, email FROM users WHERE name = 'Alice'");
73    $resultFetchDefault = $stmt->fetch(PDO::FETCH_DEFAULT); // PDO::FETCH_DEFAULT を指定
74    echo "結果の型: " . gettype($resultFetchDefault) . PHP_EOL;
75    print_r($resultFetchDefault);
76    echo PHP_EOL;
77
78    // 5. PDOオブジェクトのデフォルトフェッチモードを PDO::FETCH_OBJ に変更
79    $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_OBJ);
80    echo "PDOのデフォルトフェッチモードを PDO::FETCH_OBJ (オブジェクト) に変更しました." . PHP_EOL . PHP_EOL;
81
82    // d. 再度 PDO::FETCH_DEFAULT を使用してデータを取得 (新しいデフォルト: PDO::FETCH_OBJ)
83    //    今度はオブジェクトとして取得されることがわかります。
84    echo "--- 4. PDO::FETCH_DEFAULT を再度使用して取得 (新しいデフォルト: PDO::FETCH_OBJ) ---" . PHP_EOL;
85    $stmt = $pdo->query("SELECT id, name, email FROM users WHERE name = 'Bob'");
86    $resultFetchDefaultAgain = $stmt->fetch(PDO::FETCH_DEFAULT); // PDO::FETCH_DEFAULT を指定
87    echo "結果の型: " . gettype($resultFetchDefaultAgain) . PHP_EOL;
88    print_r($resultFetchDefaultAgain);
89    echo PHP_EOL;
90
91    echo "--- デモンストレーション終了 ---" . PHP_EOL;
92}
93
94// 関数を実行してデモンストレーションを開始
95demonstratePdoFetchDefault();

PDO::FETCH_DEFAULTは、PHPのPDO拡張機能でデータベースからデータを取得する際のフェッチモードを制御する定数です。この定数は、PDOStatement::fetch()メソッドなどの引数として使用されます。その役割は、現在PDOオブジェクトに設定されている「デフォルトのフェッチモード」を適用することです。PDOオブジェクトのデフォルトフェッチモードは、PDO::setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, ...)のように設定できます。例えば、デフォルトモードを連想配列（PDO::FETCH_ASSOC）に設定していれば、fetch(PDO::FETCH_DEFAULT)と指定することで、結果が連想配列として取得されます。この定数を使うことで、PDOオブジェクトに設定された一貫したフェッチモードを、明示的に再指定することなく利用できます。この定数自体に引数はなく、何らかの値を直接返すような戻り値もありません。