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

Copy
1<?php
2
3/**
4 * PDO::FETCH_BOTH を使用して、SQLite データベースからデータを取得するサンプルコードです。
5 * FETCH_BOTH は、取得した行を数値添字とカラム名（連想配列）の両方でアクセス可能な配列として返します。
6 * システムエンジニアを目指す初心者の方にも分かりやすいよう、基本的なデータベース操作を含みます。
7 */
8function fetchUserDataWithBothAccess(): void
9{
10    // 1. SQLite インメモリデータベースへの接続
11    // ':memory:' を指定することで、ファイルを作成せずに一時的なデータベースを使用します。
12    // 本番環境ではデータベースファイルのパスを指定します。
13    try {
14        $pdo = new PDO('sqlite::memory:');
15        // エラー発生時に例外をスローするように設定し、デバッグを容易にします。
16        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
17        echo "データベースに接続しました。\n\n";
18    } catch (PDOException $e) {
19        echo "データベース接続エラー: " . $e->getMessage() . "\n";
20        return;
21    }
22
23    // 2. ユーザー情報を保存するためのテーブルを作成します。
24    // IF NOT EXISTS を使用することで、テーブルが既に存在する場合にエラーになるのを防ぎます。
25    $createTableSql = "
26        CREATE TABLE IF NOT EXISTS users (
27            id INTEGER PRIMARY KEY AUTOINCREMENT,
28            name TEXT NOT NULL,
29            email TEXT UNIQUE NOT NULL
30        )
31    ";
32    $pdo->exec($createTableSql);
33    echo "テーブル 'users' を作成しました。\n\n";
34
35    // 3. サンプルデータをテーブルに挿入します。
36    $insertDataSql = "
37        INSERT INTO users (name, email) VALUES
38        ('山田太郎', 'taro.yamada@example.com'),
39        ('鈴木花子', 'hanako.suzuki@example.com')
40    ";
41    $pdo->exec($insertDataSql);
42    echo "サンプルデータを挿入しました。\n\n";
43
44    // 4. PDO::FETCH_BOTH を使用してデータを取得し、表示します。
45    echo "PDO::FETCH_BOTH モードでデータをフェッチします。\n";
46    echo "このモードでは、数値添字とカラム名（連想配列キー）の両方でデータにアクセスできます。\n\n";
47
48    $stmt = $pdo->query("SELECT id, name, email FROM users");
49
50    // while ループで、フェッチされた行がなくなるまでデータを取得します。
51    // fetch() メソッドの引数に PDO::FETCH_BOTH を指定します。
52    while ($row = $stmt->fetch(PDO::FETCH_BOTH)) {
53        echo "--- 取得した行 ---\n";
54        // var_dump は配列の構造と内容を詳細に表示するため、初心者には理解しやすいです。
55        var_dump($row);
56        echo "\n";
57
58        // 数値添字でのアクセス例 (SELECT文のカラムの順序に依存します)
59        echo "数値添字でのアクセス:\n";
60        echo "ID: " . $row[0] . "\n";
61        echo "名前: " . $row[1] . "\n";
62        echo "Eメール: " . $row[2] . "\n";
63        echo "\n";
64
65        // カラム名でのアクセス例
66        echo "カラム名でのアクセス:\n";
67        echo "ID: " . $row['id'] . "\n";
68        echo "名前: " . $row['name'] . "\n";
69        echo "Eメール: " . $row['email'] . "\n";
70        echo "-------------------\n\n";
71    }
72
73    echo "全てのデータフェッチが完了しました。\n";
74}
75
76// 定義した関数を実行します。
77fetchUserDataWithBothAccess();
78
79?>

PHPのPDO::FETCH_BOTHは、データベースからデータを取得する際の「フェッチモード」を指定する定数です。これはPHPのPDO拡張機能の一部であり、PDOStatement::fetch()メソッドの引数として使用されます。この定数自体は引数を取らず、内部的に整数値を返しますが、その値がfetch()メソッドに渡されることで、データ取得時の配列の形式を決定します。

PDO::FETCH_BOTHを指定してデータをフェッチすると、取得したデータベースの1行が、数値添字（例: $row[0], $row[1]） と カラム名（連想配列キー、例: $row['id'], $row['name']） の両方でアクセス可能な配列として返されます。これにより、コードの記述スタイルや要件に応じて柔軟にデータにアクセスできる利点があります。

提供されたサンプルコードでは、まずSQLiteのインメモリデータベースに接続し、usersテーブルを作成後、サンプルデータを挿入しています。その後、SELECT文でデータを取得する際に$stmt->fetch(PDO::FETCH_BOTH)を使用しています。取得された行をvar_dumpで表示したり、数値添字とカラム名の両方を使ってデータにアクセスしたりすることで、PDO::FETCH_BOTHがどのように機能し、どのような形式でデータを返すかを具体的に示しており、データベースからのデータ取得方法の基礎を学ぶ上で非常に分かりやすい例となっています。