PDOStatement::execute
PDOStatement::execute — Exécute une requête préparée (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
Description
Syntaxe
bool PDOStatement::execute ([ array $input_parameters ] )
Exécute une requête préparée. Si la requête préparée contient des marqueurs de paramètres, vous devez choisir l'une des options suivantes :
AppelezPDOStatement::bindParam()Liez les variables PHP aux marqueurs de paramètres : le cas échéant, passez les valeurs d'entrée et récupérez les valeurs de sortie via les variables liées aux marqueurs de paramètres associés.
ou passez un tableau de valeurs de paramètres en entrée uniquement.
Parameters
input_parameters
Un tableau de valeurs avec autant d'éléments qu'il y a de paramètres liés dans l'instruction SQL exécutée. Toutes les valeurs sont traitées comme PDO::PARAM_STR.
Impossible de lier plusieurs valeurs à un seul paramètre ; par exemple, impossible de lier deux valeurs à un seul paramètre nommé dans une clause IN().
Le nombre de valeurs liées ne peut pas dépasser le nombre spécifié. S'il y a plus de clés dans input_parameters que spécifié dans le SQL préparé par PDO::prepare(), l'instruction échouera et émettra une erreur.
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 variables liées
<?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 un tableau de valeurs d'insertion (paramètres nommés)
<?php
/* 通过传递一个含有插入值的数组执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');
$sth->execute(array(':calories' => $calories, ':colour' => $colour));
?>
Exécuter une requête préparée avec un tableau de valeurs d'insertion (marqueurs de position)
<?php
/* 通过传递一个插入值的数组执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->execute(array($calories, $colour));
?>
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();
?>
Exécuter une requête préparée avec une clause IN en utilisant un tableau
<?php
/* 使用一个数组的值执行一条含有 IN 子句的预处理语句 */
$params = array(1, 21, 63, 171);
/* 创建一个填充了和params相同数量占位符的字符串 */
$place_holders = implode(',', array_fill(0, count($params), '?'));
/*
对于 $params 数组中的每个值,要预处理的语句包含足够的未命名占位符 。
语句被执行时, $params 数组中的值被绑定到预处理语句中的占位符。
这和使用 PDOStatement::bindParam() 不一样,因为它需要一个引用变量。
PDOStatement::execute() 仅作为通过值绑定的替代。
*/
$sth = $dbh->prepare("SELECT id, name FROM contacts WHERE id IN ($place_holders)");
$sth->execute($params);
?>
Autres extensions
Manuel de référence PHP PDO