PDOStatement::closeCursor

PHP PDO 参考手册PHP PDO-Referenzhandbuch

PDOStatement::closeCursor — Schließt den Cursor, sodass die Anweisung erneut ausgeführt werden kann. (PHP 5 >= 5.1.0, PECL pdo >= 0.9.0)


Beschreibung

Syntax

bool PDOStatement::closeCursor ( void )

PDOStatement::closeCursor() gibt die Verbindung zum Datenbankserver frei, sodass andere SQL-Anweisungen abgesetzt werden können, während die Anweisung in einem Zustand belassen wird, der ihre erneute Ausführung ermöglicht.

Wenn das zuvor ausgeführte PDOStatement-Objekt noch nicht abgerufene Zeilen enthält, ist diese Methode für Datenbanktreiber nützlich, die das erneute Ausführen eines PDOStatement-Objekts nicht unterstützen. Wenn der Datenbanktreiber diese Einschränkung aufweist, kann es zu Fehlern aufgrund falscher Reihenfolge kommen.

PDOStatement::closeCursor() ist entweder als treiberspezifische Methode (am effizientesten) oder als generischer PDO-Fallback implementiert, falls keine treiberspezifische Funktionalität verfügbar ist. Der generische Fallback ist semantisch äquivalent zu folgendem PHP-Code:

<?php
do {
    while ($stmt->fetch())
        ;
    if (!$stmt->nextRowset())
        break;
} while (true);
?>

Rückgabewerte

Gibt bei Erfolg TRUE zurück, bei Fehlschlag FALSE.


Beispiele

Ein Beispiel für PDOStatement::closeCursor()

Im folgenden Beispiel gibt das PDOStatement-Objekt $stmt mehrere Zeilen zurück, aber die Anwendung ruft nur die erste Zeile ab, wodurch das PDOStatement-Objekt in einem Zustand mit nicht abgerufenen Zeilen verbleibt. Um sicherzustellen, dass die Anwendung mit allen Datenbanktreibern korrekt funktioniert, ruft $stmt vor der Ausführung des PDOStatement-Objekts $otherStmt einmal PDOStatement::closeCursor() auf.

<?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();
?>

PHP PDO 参考手册PHP PDO-Referenzhandbuch

Andere Erweiterungen