# PDOStatement::bindParam PDOStatement::bindParam — 綁定一個參數到指定的變量名(PHP 5 &gt;= 5.1.0, PECL pdo &gt;= 0.1.0) ## 說明 ### 語法 ``` bool PDOStatement::bindParam ( mixed $parameter , mixed &$variable [, int $data_type = PDO::PARAM_STR [, int $length [, mixed $driver_options ]]] ) ``` 綁定一個PHP變量到用作預處理的SQL語句中的對應命名占位符或問號占位符。 不同于 PDOStatement::bindValue() ，此變量作為引用被綁定，并只在 PDOStatement::execute() 被調用的時候才取其值。 大多數參數是輸入參數，即，參數以只讀的方式用來建立查詢。一些驅動支持調用存儲過程并作為輸出參數返回數據，一些支持作為輸入/輸出參數，既發送數據又接收更新后的數據。 ## 參數 **parameter** 參數標識符。對于使用命名占位符的預處理語句，應是類似 :name 形式的參數名。對于使用問號占位符的預處理語句，應是以1開始索引的參數位置。 **variable** 綁定到 SQL 語句參數的 PHP 變量名。 **data_type** 使用 PDO::PARAM_* 常量明確地指定參數的類型。要從一個存儲過程中返回一個 INOUT 參數，需要為 data_type 參數使用按位或操作符去設置 PDO::PARAM_INPUT_OUTPUT 位。 **length** 預分配提示。 **driverdata** 數據類型的長度。為表明參數是一個存儲過程的 OUT 參數，必須明確地設置此長度。 **driver_options** ## 返回值 成功時返回 TRUE， 或者在失敗時返回 FALSE。 ## 實例 ### 執行一條使用命名占位符的預處理語句 ``` <?php /* 通過綁定的 PHP 變量執行一條預處理語句 */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < :calories AND colour = :colour'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12); $sth->execute(); ?> ``` ### 執行一條使用問號占位符的預處理語句 ``` <?php /* 通過綁定的 PHP 變量執行一條預處理語句 */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < ? AND colour = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $colour, PDO::PARAM_STR, 12); $sth->execute(); ?> ``` ### 使用 INOUT 參數調用一個存儲過程 ``` <?php /* 使用 INOUT 參數調用一個存儲過程 */ $colour = 'red'; $sth = $dbh->prepare('CALL puree_fruit(?)'); $sth->bindParam(1, $colour, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12); $sth->execute(); print("After pureeing fruit, the colour is: $colour"); ?> ```