PHP8 PDOStatement::bindParam

2024-03-24 00:07 更新

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

PDOStatement::bindParam — 綁定一個(gè)參數(shù)到指定的變量名

說(shuō)明

public PDOStatement::bindParam(
    string|int $param,
    mixed &$var,
    int $type = PDO::PARAM_STR,
    int $maxLength = 0,
    mixed $driverOptions = null
): bool

綁定一個(gè)PHP變量到用作預(yù)處理的SQL語(yǔ)句中的對(duì)應(yīng)命名占位符或問號(hào)占位符。 不同于 PDOStatement::bindValue() ，此變量作為引用被綁定，并只在 PDOStatement::execute() 被調(diào)用的時(shí)候才取其值。

大多數(shù)參數(shù)是輸入?yún)?shù)，即，參數(shù)以只讀的方式用來(lái)建立查詢（但仍然可以根據(jù) type 進(jìn)行轉(zhuǎn)換）。一些驅(qū)動(dòng)支持調(diào)用存儲(chǔ)過程并作為輸出參數(shù)返回?cái)?shù)據(jù)，一些支持作為輸入/輸出參數(shù)，既發(fā)送數(shù)據(jù)又接收更新后的數(shù)據(jù)。

參數(shù) 

param

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

var

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

type

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

maxLength

數(shù)據(jù)類型的長(zhǎng)度。為表明參數(shù)是一個(gè)存儲(chǔ)過程的 OUT 參數(shù)，必須明確地設(shè)置此長(zhǎng)度。 僅當(dāng) type 參數(shù)為 PDO::PARAM_INPUT_OUTPUT 時(shí)才有意義。

driverOptions

返回值 

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

錯(cuò)誤／異常 

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

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

示例 

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

<?php
/* 通過綁定的 PHP 變量執(zhí)行一條預(yù)處理語(yǔ)句  */
$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);
/* 名稱也可以以冒號(hào)“:”為前綴（可選）*/
$sth->bindParam(':colour', $colour, PDO::PARAM_STR);
$sth->execute();
?>

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

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

示例 #3 使用 INOUT 參數(shù)調(diào)用一個(gè)存儲(chǔ)過程

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

參見 

  • PDO::prepare() - 預(yù)處理要執(zhí)行的語(yǔ)句，并返回語(yǔ)句對(duì)象
  • PDOStatement::execute() - 執(zhí)行預(yù)處理語(yǔ)句
  • PDOStatement::bindValue() - 把一個(gè)值綁定到一個(gè)參數(shù)


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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)