8.101 Fonctions PDO
8 Référence des fonctions
Manuel PHP
. Introduction . Installation . Configuration à l'exécution . Drivers PDO . Connexions et gestionnaire de connexion . Transactions et validation automatique (auto-commit) . Requêtes préparées et procédures stockées . Erreurs et gestionnaire des erreurs . Les objets larges (LOBs) . Classes pré-définies . Constantes pré-définies . PDO::beginTransaction . PDO::commit . PDO::__construct . PDO::errorCode . PDO::errorInfo . PDO::exec . PDO::getAttribute . PDO::getAvailableDrivers . PDO::lastInsertId . PDO::prepare . PDO::query . PDO::quote . PDO::rollBack . PDO::setAttribute . PDOStatement::bindColumn ->PDOStatement::bindParam . PDOStatement::bindValue . PDOStatement::closeCursor . PDOStatement::columnCount . PDOStatement::errorCode . PDOStatement::errorInfo . PDOStatement::execute . PDOStatement::fetch . PDOStatement::fetchAll . PDOStatement::fetchColumn . PDOStatement::getAttribute . PDOStatement::getColumnMeta . PDOStatement::nextRowset . PDOStatement::rowCount . PDOStatement::setAttribute . PDOStatement::setFetchMode
|
8.101.27 PDOStatement::bindParam()
Lie un paramètre à un nom de variable spécifique
[ Exemples avec pdostatement_bindparam ] CVS uniquement
bool
PDOStatement::bindParam (
mixed
parameter
,
mixed
variable
,
int
data_type
,
int
length
,
mixed
driver_options
)
Lie une variable PHP à un marquer nommé ou interrogatif correspondant dans une
requête SQL utilisée pour préparer la requête. Contrairement à
PDOStatement::bindValue
, la variable est liée en tant que
référence et ne sera évaluée qu'au moment de l'appel à la fonction
PDOStatement::execute
.
La plupart des paramètres sont des paramètres d'entrées, et sont utilisés
en lecture seul pour construire la requête. Quelques drivers supportent
l'invocation de procédures stockées qui retournent des données en tant
que paramètres de sortie, et quelques autres en tant que paramètres
entrées / sorties qui sont envoyés ensemble et sont mis à jour pour les
recevoir.
-
parameter
-
Identifiant. Pour une requête préparée utilisant
des marqueurs nommés, ce sera le nom du paramètre
sous la forme
:name
. Pour
une requête préparée utilisant les marqueurs interrogatifs,
ce sera la position indexé -1 du paramètre.
-
variable
-
Nom de la variable PHP à lier au paramètre de la requête SQL.
-
data_type
-
Type explicite de données pour le paramètre utilisant la constante
PDO::PARAM_*. Pour retourner un paramètre INOUT depuis une procédure
stockée, utilisez l'opérateur OR pour définir l'octet PDO::PARAM_INPUT_OUTPUT
pour le paramètre
data_type
parameter.
-
length
-
Longueur du type de données. Pour indiquer qu'un
paramètre est un paramètre OUT depuis une procédure stockée,
vous devez explicitement définir la longueur.
-
driver_options
-
| Exécution d'une requête préparée avec des emplacements nommés |
<?php /* Exécution d'une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?>
|
| Exécution d'une requête préparée avec des marques de positionnement |
<?php /* Exécution d'une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?>
|
| Appel une procédure stockée avec un paramètre INOUT |
<?php /* Appel une procédure stockée avec un paramètre INOUT */ $couleur = 'rouge'; $sth = $dbh->prepare('CALL puree_fruit(?)'); $sth->bindParam(1, $couleur, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12); $sth->execute(); print("Après avoir pressé le fruit, la couleur est : $couleur"); ?>
|
|