(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.
paramIdentificador 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.
valueEl valor a asociar al parámetro.
type
Tipo de datos explícito para el parámetro utilizando las constantes
PDO::PARAM_*.
Emite un error de nivel E_WARNING si el atributo PDO::ATTR_ERRMODE está definido
a PDO::ERRMODE_WARNING.
Lanza una excepción PDOException si el atributo PDO::ATTR_ERRMODE está definido
a 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();
?>