PDOStatement::bindParam
PDOStatement::bindParam — Lie un paramètre au nom de variable spécifié (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
Description
Syntaxe
bool PDOStatement::bindParam ( mixed $parameter , mixed &$variable [, int $data_type = PDO::PARAM_STR [, int $length [, mixed $driver_options ]]] )
Lie une variable PHP à l'espace réservé nommé ou au point d'interrogation correspondant dans l'instruction SQL qui a été utilisée pour préparer la requête. Contrairement à PDOStatement::bindValue(), la variable est liée par référence et ne sera évaluée qu'au moment où PDOStatement::execute() est appelée.
La plupart des paramètres sont des paramètres d'entrée, c'est-à-dire que le paramètre est utilisé en lecture seule pour construire la requête. Certains pilotes prennent en charge l'appel de procédures stockées qui renvoient des données sous forme de paramètres de sortie, et certains prennent en charge des paramètres d'entrée/sortie qui envoient des données et reçoivent des données mises à jour.
Parameters
paramètre
Identifiant du paramètre. Pour une requête préparée utilisant des espaces réservés nommés, il s'agira d'un nom de paramètre de la forme :name. Pour une requête préparée utilisant des points d'interrogation comme espaces réservés, il s'agira de la position du paramètre, indexée à partir de 1.
variable
Le nom de la variable PHP à lier au paramètre de l'instruction SQL.
data_type
Spécifie explicitement le type du paramètre à l'aide des constantes PDO::PARAM_*. Pour renvoyer un paramètre INOUT à partir d'une procédure stockée, utilisez l'opérateur OR bit à bit pour définir le bit PDO::PARAM_INPUT_OUTPUT pour le paramètre data_type.
longueur
Indication de pré-allocation.
driverdata
Longueur du type de données. Pour indiquer qu'un paramètre est un paramètre OUT d'une procédure stockée, vous devez définir explicitement cette longueur.
driver_options
Valeurs de retour
Retourne TRUE en cas de succès, ou FALSE en cas d'échec.
Exemples
Exécuter une requête préparée avec des espaces réservés nommés
<?php
/* 通过绑定的 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');
$sth->bindParam(':calories', $calories, PDO::PARAM_INT);
$sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>
Exécuter une requête préparée avec des espaces réservés de type point d'interrogation
<?php
/* 通过绑定的 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->bindParam(1, $calories, PDO::PARAM_INT);
$sth->bindParam(2, $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>
Appeler une procédure stockée avec un paramètre INOUT
<?php
/* 使用 INOUT 参数调用一个存储过程 */
$colour = 'red';
$sth = $dbh->prepare('CALL puree_fruit(?)');
$sth->bindParam(1, $colour, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12);
$sth->execute();
print("After pureeing fruit, the colour is: $colour");
?>
Autres extensions
Manuel de référence PHP PDO