PDOStatement::bindValue

PHP PDO參考手冊

PDOStatement::bindValue — 把一個值綁定到一個參數(PHP 5 >= 5.1.0, PECL pdo >= 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();
?>

PHP PDO參考手冊