PDOStatement::bindParam

PHP PDO 參考手冊

PDOStatement::bindParam — 綁定一個參數(shù)到指定的變量名(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() 被調(diào)用的時候才取其值。

大多數(shù)參數(shù)是輸入?yún)?shù)，即，參數(shù)以只讀的方式用來建立查詢。一些驅(qū)動支持調(diào)用存儲過程并作為輸出參數(shù)返回數(shù)據(jù)，一些支持作為輸入/輸出參數(shù)，既發(fā)送數(shù)據(jù)又接收更新后的數(shù)據(jù)。

參數(shù)

parameter
參數(shù)標識符。對于使用命名占位符的預處理語句，應是類似 :name 形式的參數(shù)名。對于使用問號占位符的預處理語句，應是以1開始索引的參數(shù)位置。

variable
綁定到 SQL 語句參數(shù)的 PHP 變量名。

data_type
使用 PDO::PARAM_* 常量明確地指定參數(shù)的類型。要從一個存儲過程中返回一個 INOUT 參數(shù)，需要為 data_type 參數(shù)使用按位或操作符去設置 PDO::PARAM_INPUT_OUTPUT 位。

length
預分配提示。

driverdata
數(shù)據(jù)類型的長度。為表明參數(shù)是一個存儲過程的 OUT 參數(shù)，必須明確地設置此長度。

driver_options

返回值

成功時返回 TRUE， 或者在失敗時返回 FALSE。

實例

執(zhí)行一條使用命名占位符的預處理語句

<?php
/* 通過綁定的 PHP 變量執(zhí)行一條預處理語句  */
$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();
?>

執(zhí)行一條使用問號占位符的預處理語句

<?php
/*  通過綁定的 PHP 變量執(zhí)行一條預處理語句 */
$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 參數(shù)調(diào)用一個存儲過程

<?php
/* 使用 INOUT 參數(shù)調(diào)用一個存儲過程 */
$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");
?>

PHP PDO 參考手冊