# PDOStatement::closeCursor PDOStatement::closeCursor — 关闭游标，使语句能再次被执行。(PHP 5 &gt;= 5.1.0, PECL pdo &gt;= 0.9.0) ## 说明 ### 语法 ``` bool PDOStatement::closeCursor ( void ) ``` PDOStatement::closeCursor() 释放到数据库服务的连接，以便发出其他 SQL 语句，但使语句处于一个可以被再次执行的状态。 当上一个执行的 PDOStatement 对象仍有未取行时，此方法对那些不支持再执行一个 PDOStatement 对象的数据库驱动非常有用。 如果数据库驱动受此限制，则可能出现失序错误的问题。 PDOStatement::closeCursor() 要么是一个可选驱动的特有方法（效率最高）来实现，要么是在没有驱动特定的功能时作为一般的PDO 备用来实现。一般的备用语义上与下面的 PHP 代码相同： ``` <?php do { while ($stmt->fetch()) ; if (!$stmt->nextRowset()) break; } while (true); ?> ``` ## 返回值 成功时返回 TRUE， 或者在失败时返回 FALSE。 ## 实例 ### 一个 PDOStatement::closeCursor() 的例子 在下面例子中，$stmt PDOStatement 对象返回多行，但应用程序只取第一行，让 PDOStatement 对象处于一个有未取行的状态。为确保应用程序对所有数据库驱动都能正常运行，在执行 $otherStmt PDOStatement 对象前，$stmt 调用一次 PDOStatement::closeCursor() 。 ``` <?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(); ?> ```