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

FETCH_BOUND定数は、PHPのPDO拡張機能において、データベースから結果を取得する際のデータフェッチスタイルの一つを表す定数です。この定数は、主にPDOStatementクラスのfetch()やfetchAll()といった結果取得メソッドの引数として指定されます。PDO::FETCH_BOUNDを指定する最大の特徴は、事前にPDOStatement::bindColumn()メソッドを使用して、SQLクエリの結果セットの各カラムをPHPの特定の変数にバインドしておく点にあります。この設定がされた状態でフェッチ操作を実行すると、データベースから取得された各行のデータが、bindColumn()で関連付けられたPHP変数に自動的に格納されます。

例えば、ユーザーのIDと名前を取得するSQLクエリがあった場合、ID用の変数と名前用の変数をそれぞれbindColumn()でバインドしておき、fetch(PDO::FETCH_BOUND)を呼び出すと、これらの変数が各行のデータで自動的に更新されます。これにより、開発者は結果セットの配列からデータを取得する代わりに、定義済みのPHP変数を通じて直接データにアクセスできるようになります。この方法は、特にループ処理で多数の行を扱う場合に、コードを簡潔にし、型安全性を高めるメリットがあります。また、PDO::FETCH_ASSOCのように連想配列で取得するスタイルとは異なり、変数への直接バインドを通じて、より意図が明確でメンテナンスしやすいコードの記述を可能にします。データベースから取得したデータを特定のPHP変数に直接マッピングしたい場合に、このPDO::FETCH_BOUND定数は非常に強力な選択肢となります。

Copy
1<?php
2
3$statement->bindColumn('column_name_1', $variable1);
4$statement->bindColumn(2, $variable2);
5
6if ($statement->fetch(PDO::FETCH_BOUND)) {
7    // $variable1 と $variable2 には、フェッチされた行のデータが自動的に格納されます。
8}
9
10?>

引数なし

引数はありません

int

PDO::FETCH_BOUND は、PDOStatement::fetch() メソッドなどで、結果セットの列をキーとしてではなく、プリペアドステートメントでバインドされた変数に直接割り当てるための整数定数です。