oci_close
(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_close — Закриває з'єднання із сервером Oracle
Опис
oci_close(resource $connection): ?bool
Звільняє connection. Відповідне йому з'єднання з базою даних буде закрито за відсутності ресурсів, що його використовують, і якщо воно було отримано з функції oci_connect() або oci_new_connect()
Рекомендується закривати більше не використовувані з'єднання, т.к. це звільняє ресурси бази даних іншим користувачам.
Список параметрів
connection
Ідентифікатор з'єднання Oracle, отриманий із функцій oci_connect() oci_pconnect() або oci_new_connect()
Значення, що повертаються
Повертає null якщо oci8.old_oci_close_semantics включений або true в іншому випадку.
Приклади
Приклад #1 Закриття з'єднання
Супутні з'єднання ресурси мають бути закриті для забезпечення коректного завершення з'єднання з базою даних та звільнення її ресурсів.
Приклад #2 З'єднання бази даних не закривається доти, доки не будуть закриті всі посилання на нього
Внутрішній лічильник посилань (refcount) ідентифікатора з'єднання повинен дорівнювати нулю перед безпосереднім закриттям з'єднання до бази даних.
Приклад #3 Закриття з'єднання, відкритого кілька разів
При повторному використанні облікових даних користувача обидві з'єднання повинні бути закриті перед безпосереднім закриттям з'єднання до бази даних.
Приклад #4 З'єднання закривається при відході змінних в області видимості
Коли всі змінні, що посилаються на з'єднання, йдуть з області видимості та звільняються PHP, відбувається відкат транзакції (якщо необхідно) і з'єднання з базою закривається.
Примітки
Зауваження :
Змінні, залежні від ідентифікатора з'єднань, такі як ідентифікатори виразів, отримані з oci_parse(), повинні бути звільнені до закриття з'єднання з базою даних.
Зауваження :
Функцияoci_close() не закриває з'єднання з базою даних, створеними функцією oci_pconnect()
Дивіться також
- oci_connect() - Встановлює з'єднання з базою даних Oracle
- oci_free_statement() - Звільняє ресурси, які займає курсор або SQL-вираз.