PDOStatement::bindParam
Manual de referencia de PHP PDO
PDOStatement::bindParam — Vincula un parámetro al nombre de variable especificado (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
Descripción
Sintaxis
bool PDOStatement::bindParam ( mixed $parameter , mixed &$variable [, int $data_type = PDO::PARAM_STR [, int $length [, mixed $driver_options ]]] )
Vincula una variable PHP al marcador de posición con nombre o al marcador de posición de signo de interrogación correspondiente en la sentencia SQL preparada. A diferencia de PDOStatement::bindValue(), esta variable se vincula como referencia y solo se evalúa cuando se llama a PDOStatement::execute().
La mayoría de los parámetros son de entrada, es decir, se utilizan de forma solo lectura para construir la consulta. Algunos controladores admiten llamar a procedimientos almacenados y devolver datos como parámetros de salida, y algunos admiten parámetros de entrada/salida, que envían datos y reciben datos actualizados.
Parámetros
parameter
Identificador del parámetro. Para sentencias preparadas con marcadores de posición con nombre, debe ser un nombre de parámetro similar a :name. Para sentencias preparadas con marcadores de posición de signo de interrogación, debe ser la posición del parámetro indexada comenzando en 1.
variable
El nombre de la variable PHP que se vincula al parámetro de la sentencia SQL.
data_type
Especifica explícitamente el tipo del parámetro utilizando las constantes PDO::PARAM_*. Para devolver un parámetro INOUT desde un procedimiento almacenado, debe usar el operador OR a nivel de bits para el parámetro data_type y establecer el bit PDO::PARAM_INPUT_OUTPUT.
length
Sugerencia de preasignación.
driverdata
La longitud del tipo de datos. Para indicar que un parámetro es un parámetro OUT de un procedimiento almacenado, debe establecer esta longitud explícitamente.
driver_options
Valores de retorno
Devuelve TRUE en caso de éxito, o FALSE en caso de error.
Ejemplos
Ejecutar una sentencia preparada con marcadores de posición con nombre
<?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();
?>
Ejecutar una sentencia preparada con marcadores de posición de signo de interrogación
<?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();
?>
Llamar a un procedimiento almacenado con un parámetro 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");
?>
Otras extensiones