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

PDO::FETCH_NAMED定数は、PHPのPDOクラスに属する定数であり、データベースからSQLクエリの結果セットを取得する際のデータの形式を指定するために使用されます。この定数は、主にPDOStatement::fetch()やPDOStatement::fetchAll()といったメソッドの引数として指定し、どのように結果データを受け取るかを制御します。

PDO::FETCH_NAMEDを指定した場合、結果セットは連想配列として返されます。この配列のキーは、SQLクエリで指定されたカラム名、またはエイリアスが使用され、そのキーに対応する値は、該当するカラムのデータとなります。PDO::FETCH_NAMEDの特に重要な特徴は、SQLクエリの結果に同じカラム名を持つカラムが複数存在する場合にあります。この場合、通常の連想配列（PDO::FETCH_ASSOCなど）では後から取得した値で上書きされてしまいますが、PDO::FETCH_NAMEDでは、同じカラム名に対応する複数の値をすべて格納した「配列」としてそのキーに紐付けられます。

これにより、例えばJOIN句を用いて複数のテーブルから同じ名前のカラムを取得した場合でも、すべてのデータを失うことなく、連想配列の単一キーの下にまとめてアクセスすることが可能になります。システム開発において、データベースからのデータ取得形式を細かく制御したい場合や、同じカラム名を持つ複数のデータを効率的に扱いたい場合に、PDO::FETCH_NAMEDは非常に有用なオプションとなります。

Copy
1<?php
2
3$dsn = 'mysql:host=localhost;dbname=testdb;charset=utf8mb4';
4$username = 'your_username';
5$password = 'your_password';
6
7try {
8    $pdo = new PDO($dsn, $username, $password);
9    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
10
11    // 重複するカラム名 'name' を含むクエリの例
12    $stmt = $pdo->query("SELECT id, name, description, name FROM products LIMIT 1");
13
14    // PDO::FETCH_NAMED を使用して結果をフェッチします。
15    // 同じ名前のカラムが複数ある場合、それらの値は数値キーの配列として格納されます。
16    $row = $stmt->fetch(PDO::FETCH_NAMED);
17
18    print_r($row);
19
20} catch (PDOException $e) {
21    echo "データベースエラー: " . $e->getMessage();
22}
23
24?>

引数なし

引数はありません

int

PDO::FETCH_NAMED は、連想配列（キーにカラム名、値にカラムの値）として結果セットの行をフェッチするための整数定数です。