PDOStatement::bindValue

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

PDOStatement::bindValue — Vincula un valor a un parámetro (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Descripción

Sintaxis

bool PDOStatement::bindValue ( mixed $parameter , mixed $value [, int $data_type = PDO::PARAM_STR ] )

Vincula un valor al marcador de posición con nombre o de interrogación correspondiente en la sentencia SQL utilizada para la preparación.


Parámetros

parameter
Identificador del parámetro. Para sentencias preparadas con marcadores de posición con nombre, debe ser un nombre de parámetro de la forma :nombre. Para sentencias preparadas con marcadores de posición de interrogación, debe ser la posición del parámetro indexada a partir de 1.

value
El valor a vincular al parámetro

data_type
Especificar explícitamente el tipo del parámetro utilizando las constantes PDO::PARAM_*.


Valores de retorno

Devuelve TRUE en caso de éxito, o FALSE en caso de error.


Ejemplos

Ejecutar una sentencia preparada utilizando 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->bindValue(':calories', $calories, PDO::PARAM_INT);
$sth->bindValue(':colour', $colour, PDO::PARAM_STR);
$sth->execute();
?>

Ejecutar una sentencia preparada utilizando marcadores de posición de interrogación

<?php
/* 通过绑定的 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < ? AND colour = ?');
$sth->bindValue(1, $calories, PDO::PARAM_INT);
$sth->bindValue(2, $colour, PDO::PARAM_STR);
$sth->execute();
?>

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

Otras extensiones