PDOStatement::bindParam

Manuel PHP
Précédent		Suivant

Description

bool PDOStatement::bindParam ( mixed parameter, mixed &variable [, int data_type [, int length]] )

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

PDOStatement::bindParam() lie le paramètre de requête SQL parameter à un nom de variable spécifique. Le paramètre de la requête SQL peut être soit un emplacement nommé, soit une marque de positionnement.

Les marqueurs seront remplacés par la valeur de la variable PHP correspondante lors de l'exécution de la requête. Cela vous permet, par exemple, d'appeler des procédures stockées avec des paramètres d'entrée ou de sortie pour les bases de données supportant cette fonctionnalité.

Pour les variables d'entrées uniquement, vous pouvez passer un tableau de valeurs à la fonction PDOStatement::execute().

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

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

Précédent	Sommaire	Suivant
PDOStatement::bindColumn	Niveau supérieur	PDOStatement::columnCount