PDO::préparer

PDO::prepare — Prépare une instruction SQL pour l'exécution et renvoie un objet PDOStatement (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

illustrer

grammaire

 public PDOStatement PDO::prepare ( string $statement [, array $driver_options = array() ] )

Préparez l'instruction SQL à exécuter pour la méthode PDOStatement::execute(). L'instruction SQL peut contenir zéro ou plusieurs marqueurs de paramètre nommés (:name) ou point d'interrogation (?). Les paramètres seront remplacés lors de l'exécution du SQL.

Vous ne pouvez pas inclure à la fois des marqueurs de paramètre nommés (:name) ou de point d'interrogation (?) dans une instruction SQL. Vous ne pouvez choisir qu'un seul de ces styles.

Les paramètres de l'instruction SQL préparée transmettront les paramètres réels lors de l'utilisation de la méthode PDOStatement::execute().

paramètre

L'instruction est une instruction SQL légale.

driver_options Ce tableau contient une ou plusieurs paires clé=>valeur pour définir les propriétés de l'objet PDOStatement. L'utilisation la plus courante consiste à définir la valeur PDO::ATTR_CURSOR sur PDO::CURSOR_SCROLL pour demander un curseur déroulant.

valeur de retour

En cas de succès, PDO::prepare() renvoie un objet PDOStatement. S'il échoue, il renvoie FALSE ou lève une PDOException.

Exemple

Préparer des instructions SQL à l'aide de paramètres nommés (:name)

 <?php/* Passer les valeurs aux instructions préparées via les valeurs du tableau*/$sql = 'SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND color = :colour';$sth = $dbh->prepare( $ sql, array(PDO::ATTR_CURSOR => PDO::CURSOR_FWDONLY));$sth->execute(array(':calories' => 150, ':colour' => 'red'));$red = $sth->fetchAll();$sth->execute(array(':calories' => 175, ':colour' => 'jaune' ));$jaune = $sth->fetchAll();?>

Utilisez les paramètres de point d'interrogation (?) pour préparer les instructions SQL

 <?php/* Transmettre les valeurs aux instructions préparées via les valeurs du tableau*/$sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND color = ?');$sth-> exécuter (array(150, 'red'));$red = $sth->fetchAll();$sth->execute(array(175, 'jaune'));$jaune = $sth->fetchAll();?>