PDOStatement::bindParam

PHP PDO 参考手册Manuel de référence PHP PDO

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

PHP PDO 参考手册Manuel de référence PHP PDO

Autres extensions