array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'pdostatement.bindvalue.php', 1 => 'PDOStatement::bindValue', 2 => 'Vincula um valor a um parâmetro', ), 'up' => array ( 0 => 'class.pdostatement.php', 1 => 'PDOStatement', ), 'prev' => array ( 0 => 'pdostatement.bindparam.php', 1 => 'PDOStatement::bindParam', ), 'next' => array ( 0 => 'pdostatement.closecursor.php', 1 => 'PDOStatement::closeCursor', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pdo/pdostatement/bindvalue.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PDOStatement::bindValue

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

PDOStatement::bindValue — Vincula um valor a um parâmetro

Descrição

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

Vincula um valor a um marcador, nomeado ou de ponto de interrogação, na instrução SQL que foi usada para preparar a instrução.

Parâmetros

param

Identificador do parâmetro. Para uma instrução preparada que usa marcadores nomeados, será um nome de parâmetro na forma :name. Para uma instrução preparada que usa marcadores pontos de interrogação, será a posição indexada do parâmetro, iniciando em 1.

value

O valor a ser vinculado ao parâmetro.

type

Tipo de dado explícito para o parâmetro, usando as constantes PDO::PARAM_* .

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Emite um erro de nível E_WARNING se o atributo PDO::ATTR_ERRMODE estiver definido como PDO::ERRMODE_WARNING.

Lança uma exceção PDOException se o atributo PDO::ATTR_ERRMODE estiver definido como PDO::ERRMODE_EXCEPTION.

Exemplos

Exemplo #1 Executando uma instrução preparada com marcadores nomeados

<?php
/* Executando uma instrução preparada vinculando variáveis do PHP */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');

/* Define um valor para o parâmetro usando seu nome */
$sth->bindValue('calories', $calories, PDO::PARAM_INT);
/* Opcionalmente, os nomes de parâmetros podem ser prefixados com dois pontos ":" */
$sth->bindValue(':colour', $colour, PDO::PARAM_STR);
$sth->execute();
?>

Exemplo #2 Executando uma instrução preparada com marcadores de ponto de interrogação

<?php
/* Executando uma instrução preparada vinculando variáveis do 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();
?>

Veja Também