Requêtes préparées et procédures stockées PHP PDO
De nombreuses bases de données plus matures prennent en charge le concept de requêtes préparées.
Qu'est-ce qu'une requête préparée ? Vous pouvez la considérer comme un modèle compilé du SQL que vous souhaitez exécuter, qui peut être personnalisé avec des paramètres variables. Les requêtes préparées apportent deux avantages majeurs :
- La requête ne doit être analysée (ou prétraitée) qu'une seule fois, mais elle peut être exécutée plusieurs fois avec les mêmes paramètres ou des paramètres différents. Lorsque la requête est préparée, la base de données analyse, compile et optimise le plan d'exécution de la requête. Pour les requêtes complexes, ce processus peut prendre beaucoup de temps. Si la même requête doit être répétée de nombreuses fois avec des paramètres différents, ce processus ralentira considérablement l'application. En utilisant des requêtes préparées, vous pouvez éviter les cycles répétés d'analyse/compilation/optimisation. En bref, les requêtes préparées consomment moins de ressources et s'exécutent donc plus rapidement.
- Les paramètres fournis aux requêtes préparées n'ont pas besoin d'être entourés de guillemets ; le pilote s'en charge automatiquement. Si une application n'utilise que des requêtes préparées, vous pouvez être sûr qu'une injection SQL ne se produira pas. (Toutefois, si d'autres parties de la requête sont construites à partir d'entrées non échappées, il subsiste un risque d'injection SQL.)
Les requêtes préparées sont si utiles que leur seule particularité est que PDO les émulera lorsque le pilote ne les prend pas en charge. Cela garantit que, que la base de données dispose ou non de cette fonctionnalité, l'application peut utiliser le même modèle d'accès aux données.
Effectuer des insertions répétées à l'aide de requêtes préparées
L'exemple suivant exécute une requête d'insertion en substituant les espaces réservés nommés correspondants par name et value.
<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)");
$stmt->bindParam(':name', $name);
$stmt->bindParam(':value', $value);
// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();
// 用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>
Effectuer des insertions répétées à l'aide de requêtes préparées
L'exemple suivant exécute une requête d'insertion en remplaçant les espaces réservés ? par name et value.
<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (?, ?)");
$stmt->bindParam(1, $name);
$stmt->bindParam(2, $value);
// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();
// 用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>
Récupérer des données à l'aide de requêtes préparées
L'exemple suivant récupère des données en fonction des valeurs de clé fournies. L'entrée de l'utilisateur est automatiquement entourée de guillemets, il n'y a donc aucun danger d'attaques par injection SQL.
<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name = ?");
if ($stmt->execute(array($_GET['name']))) {
while ($row = $stmt->fetch()) {
print_r($row);
}
}
?>
Si le pilote de base de données le prend en charge, l'application peut également lier des paramètres de sortie et d'entrée. Les paramètres de sortie sont généralement utilisés pour récupérer des valeurs à partir de procédures stockées. Les paramètres de sortie sont légèrement plus complexes à utiliser que les paramètres d'entrée, car lors de la liaison d'un paramètre de sortie, vous devez connaître la longueur du paramètre donné. Si la valeur liée au paramètre est supérieure à la longueur suggérée, une erreur sera générée.
Appeler des procédures stockées avec des paramètres de sortie
<?php
$stmt = $dbh->prepare("CALL sp_returns_string(?)");
$stmt->bindParam(1, $return_value, PDO::PARAM_STR, 4000);
// 调用存储过程
$stmt->execute();
print "procedure returned $return_value\n";
?>
Vous pouvez également spécifier des paramètres qui ont à la fois des valeurs d'entrée et de sortie, avec une syntaxe similaire à celle des paramètres de sortie. Dans l'exemple suivant, la chaîne "hello" est transmise à la procédure stockée, et lorsque la procédure stockée retourne, hello est remplacée par la valeur renvoyée par la procédure stockée.
Appeler des procédures stockées avec des paramètres d'entrée/sortie
<?php
$stmt = $dbh->prepare("CALL sp_takes_string_returns_string(?)");
$value = 'hello';
$stmt->bindParam(1, $value, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 4000);
// 调用存储过程
$stmt->execute();
print "procedure returned $value\n";
?>
Utilisation non valide d'un espace réservé
<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE '%?%'");
$stmt->execute(array($_GET['name']));
// 占位符必须被用在整个值的位置
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE ?");
$stmt->execute(array("%$_GET[name]%"));
?>
Autres extensions
Manuel de référence PHP PDO