# PDOStatement::bindValue PDOStatement::bindValue — 把一個值綁定到一個參數(PHP 5 &gt;= 5.1.0, PECL pdo &gt;= 0.1.0) ## 說明 ### 語法 ``` bool PDOStatement::bindValue ( mixed $parameter , mixed $value [, int $data_type = PDO::PARAM_STR ] ) ``` 綁定一個值到用作預處理的 SQL 語句中的對應命名占位符或問號占位符。 ## 參數 **parameter** 參數標識符。對于使用命名占位符的預處理語句，應是類似 :name 形式的參數名。對于使用問號占位符的預處理語句，應是以1開始索引的參數位置。 **value** 綁定到參數的值 **data_type** 使用 PDO::PARAM_* 常量明確地指定參數的類型。 ## 返回值 成功時返回 TRUE， 或者在失敗時返回 FALSE。 ## 實例 ### 執行一條使用命名占位符的預處理語句 ``` <?php /* 通過綁定的 PHP 變量執行一條預處理語句 */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < :calories AND colour = :colour'); $sth->bindValue(':calories', $calories, PDO::PARAM_INT); $sth->bindValue(':colour', $colour, PDO::PARAM_STR); $sth->execute(); ?> ``` ### 執行一條使用問號占位符的預處理語句 ``` <?php /* 通過綁定的 PHP 變量執行一條預處理語句 */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < ? AND colour = ?'); $sth->bindValue(1, $calories, PDO::PARAM_INT); $sth->bindValue(2, $colour, PDO::PARAM_STR); $sth->execute(); ?> ```