(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 1.0.0)
PDOStatement::bindValue — Asocia un valor a un parámetro
Asocia un valor a un nombre correspondiente o a un punto de interrogación (como parámetro ficticio) en la consulta SQL que se ha utilizado para preparar la consulta.
param
Identificador del parámetro. Para una consulta preparada utilizando los marcadores, esto será un nombre de parámetro de la forma :nombre. Para una consulta preparada utilizando los puntos de interrogación (como parámetro ficticio), esto será un array indexado numéricamente que comienza en la posición 1 del parámetro.
value
El valor a asociar al parámetro.
type
Tipo de datos explícito para el parámetro utilizando las constantes
PDO::PARAM_*
.
Emits an error with level E_WARNING
if the attribute PDO::ATTR_ERRMODE
is set
to PDO::ERRMODE_WARNING
.
Throws a PDOException if the attribute PDO::ATTR_ERRMODE
is set to PDO::ERRMODE_EXCEPTION
.
Ejemplo #1 Ejecutar una consulta preparada con marcadores nombrados
<?php
/* Ejecutar una consulta preparada asociando variables PHP */
$calorias = 150;
$color = 'rojo';
$sth = $dbh->prepare('SELECT nombre, color, calorias
FROM fruta
WHERE calorias < :calorias AND color = :color');
/* Definir el valor de un parámetro utilizando su nombre */
$sth->bindValue('calorias', $calorias, PDO::PARAM_INT);
/* Opcionalmente, los nombres de los parámetros pueden ser prefijados con dos puntos ": " */
$sth->bindValue(':color', $color, PDO::PARAM_STR);
$sth->execute();
?>
Ejemplo #2 Ejecutar una consulta preparada con puntos de interrogación como parámetro ficticio
<?php
/* Ejecutar una consulta preparada asociando variables PHP */
$calorias = 150;
$color = 'rojo';
$sth = $dbh->prepare('SELECT nombre, color, calorias
FROM fruta
WHERE calorias < ? AND color = ?');
$sth->bindValue(1, $calorias, PDO::PARAM_INT);
$sth->bindValue(2, $color, PDO::PARAM_STR);
$sth->execute();
?>