PDOStatement::closeCursor
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.9.0)
PDOStatement::closeCursor — Закриває курсор, переводячи запит у стан готовності до повторного запуску
Опис
public PDOStatement::closeCursor(): bool
PDOStatement::closeCursor() звільняє з'єднання із сервером, даючи можливість запускати інші SQL-запити. Метод залишає запит у стані готовності до повторного запуску.
Цей метод корисний при використанні драйверів баз даних, які не дозволяють запустити PDOStatement, доки попередній об'єкт PDOStatement не вибере всі дані з результуючого набору. Якщо це обмеження поширюється на драйвер, буде викликана помилка порушення послідовності запитів (out-of-sequence error).
PDOStatement::closeCursor() може бути реалізований як додатковий метод конкретного драйвера (що дозволяє досягти максимальної ефективності роботи), або як внутрішній метод PDO, якщо такої функції в драйвері немає. Реалізація внутрішнього методу PDO семантично схожа з наведеною нижче:
Список параметрів
Ця функція не має параметрів.
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Помилки
Видає помилку рівня E_WARNING, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_WARNING
Викидає виняток PDOException, якщо атрибуту PDO::ATTR_ERRMODEустановлено значениеPDO::ERRMODE_EXCEPTION
Приклади
Приклад #1 Приклад використання PDOStatement::closeCursor()****
У наведеному прикладі, об'єкт PDOStatement $stmt повертає кілька рядків, проте програма зчитує лише перший з них, залишаючи об'єкт PDOStatement в стані, коли є ще невибрані рядки. Щоб бути впевненим у тому, що програма буде працювати з усіма драйверами баз даних, автор додав виклик методу PDOStatement::closeCursor() об'єкта $stmt перед тим, як запустити інший запит PDOStatement $otherStmt.
Дивіться також
- PDOStatement::execute() - Запускає підготовлений запит на виконання