PDOStatement::bindParam

PHP PDO 参考手册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");
?>

PHP PDO 参考手册Manual de referencia de PHP PDO

Otras extensiones