pdostatement::bindvalue-凯发官网入口
pdostatement::bindvalue
(php 5 >= 5.1.0, php 7, php 8, pecl pdo >= 1.0.0)
pdostatement::bindvalue — 把一个值绑定到一个参数
说明
public pdostatement::bindvalue(string|int $param
, mixed $value
, int $type
= pdo::param_str): bool
绑定一个值到用作预处理的 sql 语句中的对应命名占位符或问号占位符。
参数
param
参数标识符。对于使用命名占位符的预处理语句,应是类似:name形式的参数名。对于使用问号占位符的预处理语句,应是以1开始索引的参数位置。
value
绑定到参数的值
type
使用
pdo::param_*
常量明确地指定参数的类型。
返回值
成功时返回 true
, 或者在失败时返回 false
。
错误/异常
如果属性 pdo::attr_errmode
设置为 pdo::errmode_warning
,则发出级别为 e_warning
的错误。
如果属性 pdo::attr_errmode
设置为 pdo::errmode_exception
,则抛出 pdoexception。
范例
example #1 执行一条使用命名占位符的预处理语句
/* 通过绑定的 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();
?>
example #2 执行一条使用问号占位符的预处理语句
/* 通过绑定的 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();
?>