PDOStatement::bindValue

PHP PDO-Referenzhandbuch

PDOStatement::bindValue — Bindet einen Wert an einen Parameter (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

Beschreibung

Syntax

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

Bindet einen Wert an einen entsprechenden benannten oder Fragezeichen-Platzhalter in der SQL-Anweisung, die zum Vorbereiten der Anweisung verwendet wurde.

Parameters

Parameter
Parameterkennung. Bei einer vorbereiteten Anweisung mit benannten Platzhaltern ist dies ein Parametername der Form :name. Bei einer vorbereiteten Anweisung mit Fragezeichen-Platzhaltern ist dies die 1-indizierte Position des Parameters.

value
Der Wert, der an den Parameter gebunden werden soll

data_type
Gibt den Typ des Parameters explizit mithilfe der PDO::PARAM_*-Konstanten an.

Rückgabewerte

Gibt bei Erfolg TRUE, bei Fehler FALSE zurück.

Beispiele

Eine vorbereitete Anweisung mit benannten Platzhaltern ausführen

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

Eine vorbereitete Anweisung mit Fragezeichen-Platzhaltern ausführen

<?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-Referenzhandbuch