PDOStatement::bindValue

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 1.0.0)

PDOStatement::bindValue Asocia un valor a un parámetro

Descripción

public PDOStatement::bindValue(string|int $param, mixed $value, int $type = PDO::PARAM_STR): bool

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.

Parámetros

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_*.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Errores/Excepciones

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.

Ejemplos

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();
?>

Ver también