PDOStatement::closeCursor
PDOStatement::closeCursor — Ferme le curseur, permettant ainsi à l'instruction d'être exécutée à nouveau. (PHP 5 >= 5.1.0, PECL pdo >= 0.9.0)
Description
Syntaxe
bool PDOStatement::closeCursor ( void )
PDOStatement::closeCursor() libère la connexion au serveur de base de données afin que d'autres instructions SQL puissent être émises, tout en laissant l'instruction dans un état lui permettant d'être exécutée à nouveau.
Lorsque l'objet PDOStatement précédemment exécuté contient encore des lignes non récupérées, cette méthode est utile pour les pilotes de base de données qui ne prennent pas en charge la réexécution d'un objet PDOStatement. Si le pilote de base de données présente cette limitation, des problèmes d'erreurs de séquence peuvent survenir.
PDOStatement::closeCursor() est implémenté soit comme méthode spécifique au pilote (la plus efficace), soit comme solution de repli générique de PDO si aucune fonctionnalité spécifique au pilote n'est disponible. La solution de repli générique est sémantiquement équivalente au code PHP suivant :
<?php
do {
while ($stmt->fetch())
;
if (!$stmt->nextRowset())
break;
} while (true);
?>
Valeurs de retour
Retourne TRUE en cas de succès, ou FALSE en cas d'échec.
Exemples
Un exemple de PDOStatement::closeCursor()
Dans l'exemple suivant, l'objet PDOStatement $stmt renvoie plusieurs lignes, mais l'application ne récupère que la première ligne, laissant l'objet PDOStatement dans un état avec des lignes non récupérées. Pour garantir que l'application fonctionne correctement avec tous les pilotes de base de données, avant d'exécuter l'objet PDOStatement $otherStmt, $stmt appelle PDOStatement::closeCursor() une fois.
<?php
/* 创建一个 PDOStatement 对象 */
$stmt = $dbh->prepare('SELECT foo FROM bar');
/* 创建第二个 PDOStatement 对象 */
$otherStmt = $dbh->prepare('SELECT foobaz FROM foobar');
/* 执行第一条语句 */
$stmt->execute();
/* 从结果集中只取出第一行 */
$stmt->fetch();
/* The following call to closeCursor() may be required by some drivers */
$stmt->closeCursor();
/* 现在可以执行第二条语句了 */
$otherStmt->execute();
?>
Autres extensions
Manuel de référence PHP PDO