PDOStatement::bindParam

PHP PDO 参考手册Справочное руководство по PHP PDO

PDOStatement::bindParam — Привязывает параметр к указанному имени переменной (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Описание

Синтаксис

bool PDOStatement::bindParam ( mixed $parameter , mixed &$variable [, int $data_type = PDO::PARAM_STR [, int $length [, mixed $driver_options ]]] )

Привязывает переменную PHP к соответствующему именованному или вопросительному плейсхолдеру в SQL-запросе, который использовался для подготовки выражения. В отличие от PDOStatement::bindValue(), переменная привязывается как ссылка и будет вычислена только в момент вызова PDOStatement::execute().

Большинство параметров являются входными, то есть параметр используется только для чтения при построении запроса. Некоторые драйверы поддерживают вызов хранимых процедур, возвращающих данные как выходные параметры, а некоторые поддерживают входные/выходные параметры, которые одновременно передают данные и получают обновлённые данные.


Parameters

параметр
Идентификатор параметра. Для подготовленного выражения с именованными плейсхолдерами это будет имя параметра вида :name. Для подготовленного выражения с вопросительными плейсхолдерами это будет позиция параметра с индексом, начинающимся с 1.

variable
Имя переменной PHP, которую нужно привязать к параметру SQL-запроса.

data_type
Явно задаёт тип параметра с помощью констант PDO::PARAM_*. Чтобы вернуть параметр INOUT из хранимой процедуры, используйте побитовый оператор OR, чтобы установить бит PDO::PARAM_INPUT_OUTPUT для параметра data_type.

length
Подсказка для предварительного выделения.

driverdata
Длина типа данных. Чтобы указать, что параметр является OUT-параметром хранимой процедуры, необходимо явно задать эту длину.

driver_options


Возвращаемые значения

Возвращает TRUE при успехе или FALSE при неудаче.


Примеры

Выполнение подготовленного выражения с именованными плейсхолдерами

<?php
/* 通过绑定的 PHP 变量执行一条预处理语句  */
$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);
$sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>

Выполнение подготовленного выражения с вопросительными плейсхолдерами

<?php
/*  通过绑定的 PHP 变量执行一条预处理语句 */
$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, 12);
$sth->execute();
?>

Вызов хранимой процедуры с параметром INOUT

<?php
/* 使用 INOUT 参数调用一个存储过程 */
$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");
?>

PHP PDO 参考手册Справочное руководство по PHP PDO

Другие расширения