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

FETCH_ASSOC定数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年01月12日

基本的な使い方

FETCH_ASSOC定数は、PHPのPDO（PHP Data Objects）拡張機能において、データベースから取得した結果セットの行データをどのような形式で受け取るかを指定するための定数です。この定数は、主にPDOStatementオブジェクトのfetch()メソッドやfetchAll()メソッドなどの引数として利用されます。

PDO::FETCH_ASSOCを指定すると、データベースから取得された各行が「カラム名をキーとする連想配列」として返されます。例えば、データベースのテーブルにid、name、emailといったカラムがあった場合、結果セットの各行は['id' => 1, 'name' => '太郎', 'email' => 'taro@example.com']のような形式の配列としてプログラムに渡されます。数値添字の要素は含まれません。

このフェッチスタイルは、取得したデータにカラム名で直接アクセスしたい場合に非常に有用です。どのデータがどのカラムに属しているかがコード上で明確になり、変数の意味が直感的に理解できるため、コードの可読性や保守性が大幅に向上します。

システム開発において、データベースからのデータ取得処理は頻繁に行われますが、PDO::FETCH_ASSOCを使用することで、取得したデータを扱いやすく、より効率的に処理することが可能になります。データベースから取得した情報を意味のある形でアプリケーションに組み込むための基本的ながらも重要な機能を提供する定数です。

構文(syntax)


1<?php
2// $pdoStatementObject は PDOStatement のインスタンスであると仮定します。
3// 例: $pdoStatementObject = $pdo->query('SELECT column1, column2 FROM my_table');
4
5$rowAsAssociativeArray = $pdoStatementObject->fetch(PDO::FETCH_ASSOC);
6?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

PDO::FETCH_ASSOCは、データベースから取得したレコードを連想配列として取得するための定数です。この定数をPDO::Statement::fetch()メソッドやPDO::Statement::fetchAll()メソッドの引数に指定することで、カラム名をキー、その値を値とする形式でデータを取得できます。