# PDOStatement::bindColumn PDOStatement::bindColumn — 綁定一列到一個 PHP 變量(PHP 5 &gt;= 5.1.0, PECL pdo &gt;= 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 ```