PDOStatement::bindValue

PHP PDO 參考手冊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 參考手冊PHP PDO 參考手冊