(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDOStatement::bindParam — 綁定一個(gè)參數到指定的變量名
$parameter
,&$variable
,$data_type
= PDO::PARAM_STR,$length
= ?,$driver_options
= ?綁定一個(gè)PHP變量到用作預處理的SQL語(yǔ)句中的對應命名占位符或問(wèn)號占位符。 不同于 PDOStatement::bindValue() ,此變量作為引用被綁定,并只在 PDOStatement::execute() 被調用的時(shí)候才取其值。
大多數參數是輸入參數,即,參數以只讀的方式用來(lái)建立查詢(xún)。一些驅動(dòng)支持調用存儲過(guò)程并作為輸出參數返回數據,一些支持作為輸入/輸出參數,既發(fā)送數據又接收更新后的數據。
parameter
參數標識符。對于使用命名占位符的預處理語(yǔ)句,應是類(lèi)似 :name 形式的參數名。對于使用問(wèn)號占位符的預處理語(yǔ)句,應是以1開(kāi)始索引的參數位置。
variable
綁定到 SQL 語(yǔ)句參數的 PHP 變量名。
data_type
使用 PDO::PARAM_* 常量明確地指定參數的類(lèi)型。要從一個(gè)存儲過(guò)程中返回一個(gè) INOUT 參數,需要為 data_type
參數使用按位或操作符去設置 PDO::PARAM_INPUT_OUTPUT 位。
length
數據類(lèi)型的長(cháng)度。為表明參數是一個(gè)存儲過(guò)程的 OUT 參數,必須明確地設置此長(cháng)度。
driver_options
成功時(shí)返回 true
, 或者在失敗時(shí)返回 false
。
示例 #1 執行一條使用命名占位符的預處理語(yǔ)句
<?php
/* 通過(guò)綁定的 PHP 變量執行一條預處理語(yǔ)句 */
$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();
?>
示例 #2 執行一條使用問(wèn)號占位符的預處理語(yǔ)句
<?php
/* 通過(guò)綁定的 PHP 變量執行一條預處理語(yǔ)句 */
$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();
?>
示例 #3 使用 INOUT 參數調用一個(gè)存儲過(guò)程
<?php
/* 使用 INOUT 參數調用一個(gè)存儲過(guò)程 */
$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");
?>