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

Copy
1<?php
2
3/**
4 * PDO::FETCH_UNIQUE を使用して、データベースから重複しないデータを取得するサンプル関数。
5 * SQLite インメモリデータベースを使用し、システムエンジニアを目指す初心者にも分かりやすく解説します。
6 */
7function demonstratePdoFetchUnique(): void
8{
9    // SQLite インメモリデータベースへの接続設定
10    // ':memory:' は、データをディスクに保存せず、メモリ上で一時的にデータベースを作成・操作します。
11    $dsn = 'sqlite::memory:';
12
13    try {
14        // PDO (PHP Data Objects) オブジェクトを作成し、データベースに接続します。
15        $pdo = new PDO($dsn);
16
17        // エラーモードを例外に設定することで、データベース操作中にエラーが発生した場合に
18        // PDOException がスローされるようになります。これにより、エラーハンドリングが容易になります。
19        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
20
21        echo "データベース接続に成功しました。\n";
22
23        // 'users' テーブルを作成します。
24        // ID (主キー、自動インクリメント) と名前 (テキスト型、NULL不可) を持ちます。
25        $pdo->exec("
26            CREATE TABLE IF NOT EXISTS users (
27                id INTEGER PRIMARY KEY AUTOINCREMENT,
28                name TEXT NOT NULL
29            );
30        ");
31        echo "テーブル 'users' を作成しました。\n";
32
33        // サンプルデータを挿入します。意図的に重複する名前を含めます。
34        $stmt = $pdo->prepare("INSERT INTO users (name) VALUES (?)");
35        $stmt->execute(['Alice']);
36        $stmt->execute(['Bob']);
37        $stmt->execute(['Alice']); // 重複データ
38        $stmt->execute(['Charlie']);
39        $stmt->execute(['Bob']);   // 重複データ
40        echo "サンプルデータを挿入しました（重複データを含む）。\n";
41
42        echo "\n--- PDO::FETCH_UNIQUE を使用して重複を除外した結果 ---\n";
43
44        // 'users' テーブルから 'name' 列を選択し、名前に基づいて昇順で並べ替えます。
45        $stmt = $pdo->query("SELECT name FROM users ORDER BY name");
46
47        // fetchAll() メソッドに PDO::FETCH_UNIQUE フラグを渡すことで、
48        // 取得される結果から重複する行が自動的に除去されます。
49        // 結果は、各ユニークな値がキーとなる連想配列の形式で返されます。
50        // 注意: PDO::FETCH_UNIQUE は PHP 8 で非推奨となり、PHP 9 で削除される予定です。
51        //       しかし、リファレンス情報が PHP 8 なので、ここではその使用方法を示します。
52        $uniqueNames = $stmt->fetchAll(PDO::FETCH_UNIQUE);
53
54        // 取得したユニークな名前を表示します。
55        foreach ($uniqueNames as $name => $row) {
56            echo " - " . $name . "\n";
57        }
58        echo "\n";
59
60        echo "--- 参考: 通常の fetchAll() で取得した場合 (重複を含む) ---\n";
61        // 重複除去なしの場合と比較するために、再度クエリを実行します。
62        $stmt = $pdo->query("SELECT name FROM users ORDER BY name");
63        // PDO::FETCH_COLUMN を使用すると、指定した列 (ここでは最初の列 'name') の値のみが配列として返されます。
64        $allNames = $stmt->fetchAll(PDO::FETCH_COLUMN);
65        foreach ($allNames as $name) {
66            echo " - " . $name . "\n";
67        }
68
69    } catch (PDOException $e) {
70        // データベース関連のエラーが発生した場合、そのメッセージを表示します。
71        echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
72    } catch (Exception $e) {
73        // その他の予期せぬエラーが発生した場合、そのメッセージを表示します。
74        echo "予期せぬエラーが発生しました: " . $e->getMessage() . "\n";
75    }
76}
77
78// 関数を実行し、サンプルコードの動作を確認します。
79demonstratePdoFetchUnique();

PHPのPDO::FETCH_UNIQUE定数は、データベースから複数のデータをまとめて取得する際（PDO::fetchAll()メソッドを使用する際）に、結果セット内の重複する行を自動的に除去するための特別な指示です。この定数はPDO::fetchAll()の引数として利用され、内部的にはint型の識別値を持っています。その挙動は、取得された結果の各行において、キーとなる列の値が重複している場合に、そのユニークな値を持つ最初の行だけを保持し、後続の同じ値を持つ行を自動的にスキップするというものです。これにより、プログラム側で重複除去のロジックを別途記述する手間が省けます。

サンプルコードでは、まずSQLiteのインメモリデータベースに「Alice」や「Bob」といった重複する名前を含むデータを意図的に挿入しています。その後、$stmt->fetchAll(PDO::FETCH_UNIQUE)と指定してデータを取得することで、重複していた名前が一つにまとめられ、ユニークな名前のリストが効率的に得られる様子を示しています。取得されたデータは連想配列の形式となり、各ユニークな名前が配列のキーとして設定されます。システムエンジニアを目指す上では、このような定数を使ってデータ処理を簡潔にする方法を知っておくことが役立ちます。なお、このPDO::FETCH_UNIQUEはPHP 8で非推奨となり、PHP 9で削除される予定であるため、将来的な利用には注意が必要です。