Работа с соединениями OCI8 и Connection Pooling
Модуль OCI8 предоставляет три различных функции для подключения к серверу Oracle. Стандартная функция соединения — это oci_connect() . Она создаёт соединение к базе данных Oracle и возвращает ресурс, который используется при последующих обращениях к БД.
Подключение к серверу Oracle является достаточно дорогостоящей операцией с точки зрения времени, которое требуется для выполнения. Функция oci_pconnect() использует постоянный кеш соединений, которые могут быть повторно использованы различными запросами скриптов. Это означает, что затраты на установку соединения, как правило, происходят только единожды на один процесс PHP (или на потомка Apache).
Если приложение соединяется к серверу Oracle, используя особый набор данных для каждого веб-пользователя, то постоянный кеш соединений, используемый функцией oci_pconnect() будет менее полезным, т.к. количество одновременных пользователей вырастает до того уровня, где он может начать оказывать негативное влияние на общую производительность сервера Oracle из-за поддержания слишком большого количества простаивающих соединений. Если приложение настроено таким образом, то рекомендуется либо настроить его с помощью параметров конфигурации oci8.max_persistent и oci8.persistent_timeout (это даст возможность управления размером кеша постоянных соединений и их время жизни), либо использовать Oracle Database Resident Connection Pooling (в Oracle Database 11g и новее), либо использовать функцию oci_connect() вместо неё.
Вместе oci_connect() и oci_pconnect() используют кеш подключений; если множество вызовов oci_connect() использует одинаковые параметры в данном скрипте, второй и последующие вызовы вернут существующий дескриптор соединения. Кэш, используемый функцией oci_connect() , очищается по завершению выполнения скрипта, или когда соединение неявно закрывается. У функции oci_pconnect() похожее поведение, хотя её кеш обрабатывается отдельно и остаётся действующим между запросами HTTP.
Эта возможность кеширования означает, что два дескриптора не изолированы транзакционно (они на самом деле являются одним и тем же дескриптором, поэтому здесь нет никакой изоляции). Если приложению необходимы два отдельных транзакционно изолированных соединения, то необходимо использовать функцию oci_new_connect() .
Кеш функции oci_pconnect() очищается и закрываются все соединения к БД, когда завершается процесс PHP. Поэтому эффективное использование постоянных соединений требует, чтобы PHP был модулем Apache или использовался с FPM или подобным. Постоянные соединения не будут иметь никаких преимуществ перед oci_connect() , когда PHP используется с CGI или через командную строку.
Функция oci_new_connect() всегда создаёт новое соединение с сервером Oracle, невзирая на то, что другие соединения могут уже существовать. Высоконагруженным веб-приложениям следует избегать использования oci_new_connect() , особенно в самых загруженных частях приложения.
Постоянные соединения могут быть закрыты пользователем, что даёт более полный контроль над использованием ресурсов. Также постоянные соединения могут быть закрыты автоматически, если не осталось переменных PHP указывающих на них, например при завершении выполнения пользовательской функции. Закрытие соединения откатит все не подтверждённые транзакции. Эти изменения в постоянных подключениях делают их поведение аналогичным не постоянным соединениям. Чтобы включить старое поведение, задайте опцию oci8.old_oci_close_semantics значением On.
Автоматическое пересоздание постоянных соединений после перезапуска процессов Apache или FPM, означает, что Oracle Database LOGON рекомендуется только для настройки атрибутов сеанса, а не для запросов на подключение пользователей для отдельных приложений.
Создание пула соединений DRCP
PHP поддерживает постоянный пул соединений Oracle 11g (DRCP). DRCP позволяет более эффективно использовать память СУБД и предоставляет высокую масштабируемость. Изменять код приложения для использования DRCP либо нет необходимости, либо требуются минимальные изменения.
DRCP подходит для приложений, которые подключаются используя несколько схем БД и сохраняют соединения к БД открытыми короткий промежуток времени. Другим приложениям следует использовать доступные по умолчанию Dedicated серверные процессы или использовать Shared сервера.
DRCP приносит пользу всем трём функциям подключения, однако предоставляет самую высокую масштабируемость, когда соединения создаются с помощью функции oci_pconnect() .
Чтобы функциональность DRCP была доступна в OCI8, клиентские библиотеки Oracle, используемые в PHP, и версия сервера баз данных должны быть 11g и новее.
Документация по DRCP находится в нескольких руководствах Oracle. К примеру, смотрите » Конфигурирование пула постоянных соединений базы данных в документации Oracle для информации по использованию. Документ » техническое описание DRCP содержит дополнительную информацию по DRCP.
Для использования DRCP, установите модуль OCI8 и библиотеки Oracle 11g (или новее) и затем выполните следующие действия:
- Как привилегированный администратор БД воспользуйтесь программой наподобие SQL*Plus, чтобы запустить пул соединений в СУБД:
SQL> execute dbms_connection_pool.start_pool;
oci_connect
Returns a connection identifier needed for most other OCI8 operations.
For performance, most applications should use persistent connections with oci_pconnect() instead of oci_connect() . See Connection Handling for general information on connection management and connection pooling.
The second and subsequent calls to oci_connect() with the same parameters will return the connection handle returned from the first call. This means that transactions in one handle are also in the other handles, because they use the same underlying database connection. If two handles need to be transactionally isolated from each other, use oci_new_connect() instead.
Parameters
The password for username .
Contains the Oracle instance to connect to. It can be an » Easy Connect string, or a Connect Name from the tnsnames.ora file, or the name of a local Oracle instance.
If not specified or null , PHP uses environment variables such as TWO_TASK (on Linux) or LOCAL (on Windows) and ORACLE_SID to determine the Oracle instance to connect to.
To use the Easy Connect naming method, PHP must be linked with Oracle 10g or greater Client libraries. The Easy Connect string for Oracle 10g is of the form: [//]host_name[:port][/service_name]. From Oracle 11g, the syntax is: [//]host_name[:port][/service_name][:server_type][/instance_name]. Further options were introduced with Oracle 19c, including timeout and keep-alive settings. Refer to Oracle documentation. Service names can be found by running the Oracle utility lsnrctl status on the database server machine.
The tnsnames.ora file can be in the Oracle Net search path, which includes /your/path/to/instantclient/network/admin , $ORACLE_HOME/network/admin and /etc . Alternatively set TNS_ADMIN so that $TNS_ADMIN/tnsnames.ora is read. Make sure the web daemon has read access to the file.
Determines the character set used by the Oracle Client libraries. The character set does not need to match the character set used by the database. If it doesn’t match, Oracle will do its best to convert data to and from the database character set. Depending on the character sets this may not give usable results. Conversion also adds some time overhead.
If not specified, the Oracle Client libraries determine a character set from the NLS_LANG environment variable.
Passing this parameter can reduce the time taken to connect.
This parameter is available since version PHP 5 (PECL OCI8 1.1) and accepts the following values: OCI_DEFAULT , OCI_SYSOPER and OCI_SYSDBA . If either OCI_SYSOPER or OCI_SYSDBA were specified, this function will try to establish privileged connection using external credentials. Privileged connections are disabled by default. To enable them you need to set oci8.privileged_connect to On .
PHP 5.3 (PECL OCI8 1.3.4) introduced the OCI_CRED_EXT mode value. This tells Oracle to use External or OS authentication, which must be configured in the database. The OCI_CRED_EXT flag can only be used with username of «/» and a empty password. oci8.privileged_connect may be On or Off .
OCI_CRED_EXT may be combined with the OCI_SYSOPER or OCI_SYSDBA modes.
OCI_CRED_EXT is not supported on Windows for security reasons.
Return Values
Returns a connection identifier or false on error.
oci_connect
Возвращает идентификатор соединения, который используется большинством функций данного модуля.
См. Управление соединением для более детальной информации по управлению соединениями.
Начиная с PHP 5.1.2 (PECL OCI8 1.1) функция oci_close() может использоваться для завершения соединения.
Второй и последующие вызовы функции oci_connect() с теми же параметрами вернут идентификатор уже открытого соединения. Это означает, что транзакции используют одно и то же базовое соединение с базой данных. При необходимости разделения транзакций рекомендуется использовать функцию oci_new_connect() .
Список параметров
Содержит экземпляр Oracle для подключения. Это может быть » Easy Connect string, или Connect Name из файла tnsnames.ora , или имя локального экземпляра Oracle.
Если не указано отдельно, PHP использует переменные окружения, такие как TWO_TASK (на Linux) или LOCAL (на Windows) и ORACLE_SID для определения экземпляра Oracle для соединения.
Для использования метода Easy Connect, PHP должен быть слинкован с клиентскими библиотеками версии Oracle 10g или старше. Easy Connect string для Oracle 10g принимает следующую форму: [//]host_name[:port][/service_name]. Начиная с Oracle 11g синтаксис таков: [//]host_name[:port][/service_name][:server_type][/instance_name]. Названия служб могут быть определены с помощью запуска Oracle утилиты lsnrctl status на сервере базы данных.
Файл tnsnames.ora может находиться в поисковом пути Oracle Net, который включает $ORACLE_HOME/network/admin и /etc . В качестве альтернативного варианта можно установить TNS_ADMIN таким образом, чтобы путь $TNS_ADMIN/tnsnames.ora был читаемым. Убедитесь, что веб-сервер имеет доступ к этому файлу.
Определяет кодировку, используемую клиентскими библиотеками Oracle. Данная кодировка не обязательно должна совпадать с кодировкой, используемой в самой базе данных. Если она не совпадает, Oracle сделает все возможное для конвертирования данных из- и в данную кодировку. В зависимости от используемых кодировок это может не всегда давать приемлемые результаты. Преобразование также создает некоторые дополнительные временные затраты.
Если кодировка не указана, клиентские библиотеки Oracle будут определять ее из переменной окружения NLS_LANG .
Передача этого параметра может уменьшить время затрачиваемое на соединение.
Этот параметр доступен начиная с версии PHP 5 (PECL OCI8 1.1) и принимает следующие значения: OCI_DEFAULT , OCI_SYSOPER и OCI_SYSDBA . Если были указаны OCI_SYSOPER или OCI_SYSDBA , данная функция попытается установить привилегированное соединение, используя внешние данные авторизации. По умолчанию привилегированные соединения отключены. Чтобы их включить, необходимо установить oci8.privileged_connect в On.
В версии PHP 5.3 (PECL OCI8 1.3.4) появилось значение OCI_CRED_EXT . Оно указывает Oracle использовать внешнюю аутентификацию или аутентификацию с помощью операционной системы, что должно быть настроено в базе данных. Флаг OCI_CRED_EXT может быть использован только с именем пользователя «/» и пустым паролем. oci8.privileged_connect может принимать значение On или Off.
OCI_CRED_EXT может использоваться совместно с режимами OCI_SYSOPER и OCI_SYSDBA .
OCI_CRED_EXT не поддерживается в Windows по причинам безопасности.
Возвращаемые значения
Возвращает идентификатор соединения или FALSE в случае ошибки.