(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.9.0)
PDOStatement::closeCursor — 關閉游標,使語句能再次被執(zhí)行。
PDOStatement::closeCursor() 釋放到數(shù)據(jù)庫服務的連接,以便發(fā)出其他 SQL 語句,但使語句處于一個可以被再次執(zhí)行的狀態(tài)。
當上一個執(zhí)行的 PDOStatement 對象仍有未取行時,此方法對那些不支持再執(zhí)行一個 PDOStatement 對象的數(shù)據(jù)庫驅(qū)動非常有用。 如果數(shù)據(jù)庫驅(qū)動受此限制,則可能出現(xiàn)失序錯誤的問題。
PDOStatement::closeCursor() 要么是一個可選驅(qū)動的特有方法(效率最高)來實現(xiàn),要么是在沒有驅(qū)動特定的功能時作為一般的PDO 備用來實現(xiàn)。一般的備用語義上與下面的 PHP 代碼相同:
<?php
do {
while ($stmt->fetch())
;
if (!$stmt->nextRowset())
break;
} while (true);
?>
成功時返回 true
, 或者在失敗時返回 false
。
示例 #1 一個 PDOStatement::closeCursor() 的例子
在下面例子中,$stmt PDOStatement 對象返回多行,但應用程序只取第一行,讓 PDOStatement 對象處于一個有未取行的狀態(tài)。為確保應用程序?qū)λ袛?shù)據(jù)庫驅(qū)動都能正常運行,在執(zhí)行 $otherStmt PDOStatement 對象前,$stmt 調(diào)用一次 PDOStatement::closeCursor() 。
<?php
/* 創(chuàng)建一個 PDOStatement 對象 */
$stmt = $dbh->prepare('SELECT foo FROM bar');
/* 創(chuàng)建第二個 PDOStatement 對象 */
$otherStmt = $dbh->prepare('SELECT foobaz FROM foobar');
/* 執(zhí)行第一條語句 */
$stmt->execute();
/* 從結果集中只取出第一行 */
$stmt->fetch();
/* The following call to closeCursor() may be required by some drivers */
$stmt->closeCursor();
/* 現(xiàn)在可以執(zhí)行第二條語句了 */
$otherStmt->execute();
?>