PHP8 PDOStatement::bindValue

2024-03-24 00:07 更新

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 1.0.0)

PDOStatement::bindValue — 把一個(gè)值綁定到一個(gè)參數(shù)

說明

public PDOStatement::bindValue(string|int $param, mixed $value, int $type = PDO::PARAM_STR): bool

綁定一個(gè)值到用作預(yù)處理的 SQL 語句中的對應(yīng)命名占位符或問號占位符。

參數(shù) 

param

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

value

綁定到參數(shù)的值

type

使用 PDO::PARAM_* 常量明確地指定參數(shù)的類型。

返回值 

成功時(shí)返回 true， 或者在失敗時(shí)返回 false。

錯(cuò)誤／異常 

如果屬性 PDO::ATTR_ERRMODE 設(shè)置為 PDO::ERRMODE_WARNING，則發(fā)出級別為 E_WARNING 的錯(cuò)誤。

如果屬性 PDO::ATTR_ERRMODE 設(shè)置為 PDO::ERRMODE_EXCEPTION，則拋出 PDOException。

示例 

示例 #1 執(zhí)行一條使用命名占位符的預(yù)處理語句

<?php
/* 通過綁定的 PHP 變量執(zhí)行一條預(yù)處理語句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < :calories AND colour = :colour');

/* 使用名字設(shè)置參數(shù)值 */
$sth->bindValue('calories', $calories, PDO::PARAM_INT);
/* 視需要，參數(shù)名也可以以冒號“:”為前綴 */
$sth->bindValue(':colour', $colour, PDO::PARAM_STR);
$sth->execute();
?>

示例 #2 執(zhí)行一條使用問號占位符的預(yù)處理語句

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

參見 

  • PDO::prepare() - 預(yù)處理要執(zhí)行的語句，并返回語句對象
  • PDOStatement::execute() - 執(zhí)行預(yù)處理語句
  • PDOStatement::bindParam() - 綁定一個(gè)參數(shù)到指定的變量名


以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號