PDOStatement::bindParam
PDOStatement::bindParam — 綁定一個參數到指定的變量名(PHP 5 >= 5.1.0, PECL pdo >= 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"); ?>