PDOStatement::bindParam
Справочное руководство по 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");
?>
Другие расширения