PDOStatement::bindColumn
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