PDOStatement::bindColumn

PHP PDO 参考手册PHP PDO リファレンスマニュアル

PDOStatement::bindColumn — 列を PHP 変数にバインドする (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


説明

構文

bool PDOStatement::bindColumn ( mixed $column , mixed &$param [, int $type [, int $maxlen [, mixed $driverdata ]]] )

特定の変数をクエリの結果セット内の指定された列にバインドします。PDOStatement::fetch() または PDOStatement::fetchAll() を呼び出すたびに、列にバインドされたすべての変数が更新されます。

注意:ステートメントの実行前には PDO の列情報が常に利用できるとは限らないため、移植性の高いアプリケーションでは PDOStatement::execute() の後にこの関数(メソッド)を呼び出すべきです。
ただし、PgSQL ドライバを使用する場合、LOB 列をストリームとしてバインドできるようにするには、アプリケーションは PDOStatement::execute() を呼び出す前にこのメソッドを呼び出す必要があります。そうしないと、ラージオブジェクトの OID が整数として返されます。


パラメータ

column
結果セット内の列番号(1から始まるインデックス)または列名。列名を使用する場合、名前はドライバが返す列名の大文字小文字と一致させる必要があることに注意してください。

param
列にバインドする PHP 変数の名前

type
PDO::PARAM_* 定数で指定するパラメータのデータ型。

maxlen
事前割り当てのヒント。

driverdata
ドライバ固有のオプションパラメータ。


戻り値

成功した場合に TRUE を返し、失敗した場合に FALSE を返します。


例

結果セットの出力を PHP 変数にバインドする

結果セット内の列を PHP 変数にバインドすることは、各行に含まれるデータをアプリケーションですぐに利用できるようにする効果的な方法です。次の例は、PDO がさまざまなオプションとデフォルト値で列をバインドおよび取得する方法を示しています。

<?php
function readData($dbh) {
  $sql = 'SELECT name, colour, calories FROM fruit';
  try {
    $stmt = $dbh->prepare($sql);
    $stmt->execute();

    /*  通过列号绑定  */
    $stmt->bindColumn(1, $name);
    $stmt->bindColumn(2, $colour);
    
    /*  通过列名绑定  */
    $stmt->bindColumn('calories', $cals);

    while ($row = $stmt->fetch(PDO::FETCH_BOUND)) {
      $data = $name . "\t" . $colour . "\t" . $cals . "\n";
      print $data;
    }
  }
  catch (PDOException $e) {
    print $e->getMessage();
  }
}
readData($dbh);
?>

上の例の出力は以下のようになります:

apple   red     150
banana  yellow  175
kiwi    green   75
orange  orange  150
mango   red     200
strawberry      red     25

PHP PDO 参考手册PHP PDO リファレンスマニュアル

その他の拡張モジュール